REBOOT(2) | System Calls Manual | REBOOT(2) |
reboot
— reboot
system or halt processor
#include
<unistd.h>
#include <sys/reboot.h>
int
reboot
(int
howto);
reboot
() reboots the system. Only the
superuser may reboot a machine on demand. However, a reboot is invoked
automatically in the event of unrecoverable system failures.
howto is a mask of options; the system call
interface allows the following options, defined in the include file
<sys/reboot.h>
, to be passed
to the new kernel or the new bootstrap and init programs.
RB_AUTOBOOT
RB_ASKNAME
RB_DUMP
RB_HALT
RB_POWERDOWN
RB_HALT
, and if the
system hardware supports the function, the system will be powered
off.RB_USERREQ
reboot
() is
called during startup (before the system has finished autoconfiguration),
even if RB_HALT
is not specified. This is because
panic(9)s during startup will probably
just repeat on the next boot. Use of this option implies that the user has
requested the action specified (for example, using the
ddb(4) boot reboot
command), so the system will reboot if a halt is not explicitly
requested.RB_KDB
reboot
() call. See
ddb(4) for more information.RB_NOSYNC
RB_SINGLE
RB_SINGLE
prevents this, booting the system with a single-user shell on the console.
RB_SINGLE
is actually interpreted by the
init(8) program in the newly booted
system.
When no options are given (i.e.,
RB_AUTOBOOT
is used), the system is rebooted
from file /bsd in the root file system of unit 0
of a disk chosen in a processor specific way. An automatic consistency
check of the disks is normally performed (see
fsck(8)).
RB_TIMEBAD
If successful, this call never returns. Otherwise, a -1 is returned and an error is returned in the global variable errno.
EPERM
]ddb(4), crash(8), halt(8), init(8), reboot(8), savecore(8), boot(9), panic(9)
The reboot
() system call finally appeared
in 4.0BSD.
Not all platforms support all possible arguments.
April 15, 2017 | OpenBSD-current |