reboot(3C) Standard C Library Functions reboot(3C)NAMEreboot - reboot system or halt processor
SYNOPSIS
#include <sys/reboot.h>
int reboot(int howto, char *bootargs);
DESCRIPTION
The reboot() function reboots the system. The howto argument specifies
the behavior of the system while rebooting and is a mask constructed by
a bitwise-inclusive-OR of flags from the following list:
RB_AUTOBOOT The machine is rebooted from the root filesystem on the
default boot device. This is the default behavior. See
boot(1M) and kernel(1M).
RB_HALT The processor is simply halted; no reboot takes place.
This option should be used with caution.
RB_ASKNAME Interpreted by the bootstrap program and kernel, caus‐
ing the user to be asked for pathnames during the boot‐
strap.
RB_DUMP The system is forced to panic immediately without any
further processing and a crash dump is written to the
dump device (see dumpadm(1M)) before rebooting.
Any other howto argument causes the kernel file to boot.
The interpretation of the bootargs argument is platform-dependent.
RETURN VALUES
Upon successful completion, reboot() never returns. Otherwise, −1 is
returned and errno is set to indicate the error.
ERRORS
The reboot() function will fail if:
EPERM The {PRIV_SYS_CONFIG} privilege is not asserted in the effec‐
tive set of the calling process.
SEE ALSOintro(1M), boot(1M), dumpadm(1M), halt(1M), init(1M), kernel(1M),
reboot(1M), uadmin(2)SunOS 5.10 22 Mar 2004 reboot(3C)
