Manual pages › BSD C library (3B)
reboot(3B)
reboot system or halt processor
From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.
Also by this name: reboot(1B), BSD versions of commands
NAME
reboot - reboot system or halt processor
SYNOPSIS
cc [ flag... ] file ... -lucb #include <sys/reboot.h> reboot(howto, [ bootargs ] ) 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 VALUE
If successful, this call never returns. Otherwise, a -1 is returned and an error is returned in the global variable errno.
ERRORS
EPERM The caller is not the super-user.
FILES
/vmunix
SEE ALSO
halt(1M) init(1M) reboot(1M) intro(1M), crash(1M) in the System Administrator's Reference Manual.
NOTES
Any other howto argument causes /stand/unix to boot. Only the super-user may reboot a machine.