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 system 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.
Printable version
