reboot(3C)

NAME

     reboot - 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  argu-
     ment  specifies  the  behavior of the system while rebooting
     and is a mask constructed by a bitwise-inclusive-OR of flags
     from the following list:

     RE_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
           bootstrap.

     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.   Other-
     wise, -1 is returned and errno is set to indicate the error.

ERRORS

     The reboot() function will fail if:

     EPERM The caller is not the super-user.

USAGE

     Only the super-user may reboot() a machine.

SEE ALSO

     intro(1M),  boot(1M),   dumpadm(1M),   halt(1M),   init(1M),
     kernel(1M), reboot(1M), uadmin(2)