(BSD System Compatibility)

reboot(3bsd)

reboot -- reboot system or halt processor

Synopsis

   /usr/ucb/cc [flag . . . ] file . . .
   
   #include <sys/reboot.h>
   

   reboot(int howto, [char *bootargs]);

Description

reboot reboots the system, and is invoked automatically in the event of unrecoverable system failures. howto is a mask of options passed to the bootstrap program. The system call interface permits only RB_HALT or RB_AUTOBOOT to be passed to the reboot program; the other flags are used in scripts stored on the console storage media, or used in manual bootstrap procedures. When none of these options (for instance RB_AUTOBOOT) is given, the system is rebooted from file /stand/unix. An automatic consistency check of the disks is then normally performed.

The bits of howto that are used are:

RB_HALT: the processor is simply halted; no reboot takes place. RB_HALT should be used with caution.
RB_ASKNAME: Interpreted by the bootstrap program itself, causing it to inquire as to what file should be booted. Normally, the system is booted from the file /stand/unix without asking.

Return values

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

EPERM: The caller is not the super-user.

Files

/stand/unix

References

crash(1M), halt(1Mbsd), init(1M), intro(1), reboot(1Mbsd)

Notices

Any other howto argument causes /stand/unix to boot.

Only the super-user may reboot a machine.