reboot(2)reboot(2)NAMEreboot - Reboot or halt the system
SYNOPSIS
#include <sys/reboot.h>
int reboot(
int howto );
PARAMETERS
Specifies a mask of options.
DESCRIPTION
The reboot() function restarts the system. The default startup is auto‐
matic and brings up /vmunix in the normal, nonmaintenance mode. In an
application, the calling process must have superuser privilege to use
this function. However, a reboot is invoked automatically in the event
of unrecoverable system failures.
The following flags, defined in the <sys/reboot.h> header file, may be
passed to the kernel bootstrap process by applications. These flags are
supplied as values to the howto parameter. The default, causing the
system to reboot in its usual fashion. Dump kernel memory before
rebooting; see savecore(8) for more information. The processor is sim‐
ply halted; no reboot takes place. The disks are not sync'ed before
the processor is halted or rebooted. Normally, the disks are sync'ed
before the processor is halted or rebooted. See sync(8) for more infor‐
mation.
Caution
Because the disks are not sync'ed when you specify the RB_NOSYNC
option, loss of data may result from using it.
If no flags are specified (equivalent to RB_AUTOBOOT), the system is
rebooted from file vmunix in the root file system.
RB_* flags that are defined in the <sys/reboot.h> header file and not
listed in this reference page are reserved for internal use only.
RETURN VALUES
If successful, this call does not return. Otherwise, -1 is returned
and errno is set to indicate the error.
ERRORS
If the reboot() function fails, errno may be set to the following
value: The calling process does not have appropriate privilege.
SEE ALSO
Commands: crashdc(8), halt(8), reboot(8), savecore(8), sync(8)
Functions: sync(2)reboot(2)