REBOOT(2) — HP-UX

Series 200, 300, 800 Only

NAME

reboot − boot the system

SYNOPSIS

#include <sys/reboot.h>
int reboot (howto, device_file, filename)
int howto; char *device_file; char *filename;

DESCRIPTION

Reboot causes the system to be rebooted. Howto is a mask of reboot options (see <sys/reboot.h>). Only RB_HALT, RB_AUTOBOOT, RB_NOSYNC, RB_NEWDEVICE, and RB_NEWFILE are recognized options.

The howto options are:

RB_AUTOBOOT
A filesystem sync is performed (unless RB_NOSYNC is set) and the processor is rebooted from the default device and file.

RB_HALT
The processor is simply halted. A sync of the filesystem will be done unless the RB_NOSYNC flag is set. RB_HALT should be used with caution.

RB_NOSYNC
A sync of the filesystem is not to be performed.

RB_NEWDEVICE
The device_file argument to the system call is to be used as the filename of the device from which to reboot.

RB_NEWFILE
The filename argument to the system call is to be used as the name of the file to be rebooted.

Device_file specifies the device from which the reboot is to take place. Device_file must be a block or character special file name and is used only if the RB_NEWDEVICE option is set.

Filename specifies the name of the file to be rebooted (only used if the RB_NEWFILE option is set). This file will be loaded into memory by the bootstrap and control passed to it.

Only the super-user may reboot a machine.

ERRORS

Reboot will fail if the following is true:

[EPERM] The effective user id of the caller is not super-user.

HARDWARE DEPENDENCIES

Series 300
Filename must be one of the files listed by the boot rom at power up.

The default device and file for RB_AUTOBOOT are those from which the system was previously booted.

Series 800
The RB_NEWDEVICE and RB_NEWFILE options and the device_file and filename parameters are ignored.

The default file and device for RB_AUTOBOOT are /hp-ux on the current root device.

RETURN VALUE

If successful, this call never returns. Otherwise, a −1 is returned and an error is returned in the global variable errno.

AUTHOR

Reboot was developed by HP, and the University of California, Berkeley.

Museum

Related Articles