reboot.2 (2010 09)

r
reboot(2) reboot(2)
NAME
reboot - boot the system
SYNOPSIS
#include <sys/reboot.h>
int reboot (int howto);
DESCRIPTION
reboot() causes the system to reboot. howto is a mask of reboot options (see
<sys/reboot.h>
),
specified as follows:
RB_AUTOBOOT A file system 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 file system is performed unless
the
RB_NOSYNC flag is set. RB_HALT
should be used with caution.
RB_RECONFIG On systems with cellular architecture, all cells in the partition are rebooted in
order to reconfigure the stable complex configuration data. On systems with
non-cellular architecture, the default is
RB_AUTOBOOT. A sync of the file sys-
tem is performed unless the
RB_NOSYNC flag is set.
RB_NORECONFIGBOOT
Shut down the system firmware to a "ready to reconfigure" state and do not
reboot. This option can be used only in combination with
RB_RECONFIG.
RB_NOSYNC A sync of the file system is not performed.
Unless the
RB_NOSYNC flag has been specified, reboot (2) unmounts all mounted file systems and marks
them clean so that it will not be necessary to run fsck (1M) on these file systems when the system reboots.
Only users with appropriate privileges can reboot a machine.
RETURN VALUE
If successful, this call never returns. Otherwise, a −1 is returned and
errno is set to indicate the error.
ERRORS
reboot() fails if this condition is encountered:
[EPERM] The effective user ID of the caller is not a user with appropriate privileges.
DEPENDENCIES
The default file and device for RB_AUTOBOOT is /stand/vmunix
on the current root device.
AUTHOR
reboot() was developed by HP and the University of California, Berkeley.
SEE ALSO
reboot(1M), privileges(5).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1