Copyright (c) 1980 The Regents of the University of California. All rights reserved. %sccs.include.redist.man% @(#)reboot.2 6.3 (Berkeley) 06/23/90 REBOOT 2 ""
C 4 NAME
reboot - reboot system or halt processor
SYNOPSIS
#include <sys/reboot.h>
reboot(howto) int howto;
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 (e.g. RB_AUTOBOOT) is given, the system is rebooted
from file \*(lqvmunix\*(rq 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 then normally performed.
The bits of
howto 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 \*(lqxx(0,0)vmunix\*(rq without asking.
RB_SINGLE
Normally, the reboot procedure involves an automatic disk consistency
check and then multi-user operations. RB_SINGLE prevents the consistency
check, rather simply booting the system with a single-user shell on
the console.
RB_SINGLE is interpreted by the
init (8) program in the newly booted system.
This switch is not available from the system call interface.
Only the super-user may
reboot a machine.
"RETURN VALUES"
If successful, this call never returns. Otherwise, a -1
is returned and an error is returned in the global variable
errno . ERRORS
15
[EPERM]
The caller is not the super-user.
"SEE ALSO"
crash(8), halt(8), init(8), reboot(8)
BUGS
The notion of ``console medium'', among other things,
is specific to the VAX.