REBOOT(3C) Standard C Library Functions 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 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(8) and
kernel(8).
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,
causing 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(8)) 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
effective set of the calling process.
SEE ALSO
uadmin(2),
Intro(8),
boot(8),
dumpadm(8),
halt(8),
init(8),
kernel(8),
reboot(8) March 22, 2004 REBOOT(3C)
