.TH REBOOT 2
.UC
.SH NAME
reboot \- reboot system or halt processor
.SH SYNOPSIS
.nf
.B #include <sys/types.h>
.br
.B #include <sys/reboot.h>
.PP
.B reboot(howto, dev)
.B int howto;
.B dev_t dev;
.fi
.SH DESCRIPTION
.I Reboot
is used to cause a system reboot, and is invoked automatically
in the event of unrecoverable system failures.
.I Howto
is a mask of options passed to the bootstrap program.
When none of these options is given, the system is rebooted
from file \*(lqunix\*(rq in the file system specified by
.I dev.
Currently, this option is ignored, and the device used is
the current root file system.
An automatic consistency check of the disks is then normally performed.
.PP
The bits of
.I howto
are, in the order interpreted:
.TP
RB_NOSYNC
No sync (see
.IR sync (2))
is to be done.
.TP
RB_DUMP
A dump of memory is produced on the system's dump device, normally
in swap space, as if the system had done a panic.
.TP
RB_HALT
The processor is simply halted; no reboot takes place.
This should be used with caution.
.TP
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)unix\*(rq without asking, where
\fIxx\fP corresponds to the root file system device.
.TP
RB_SINGLE
Normally, the reboot procedure involves an automatic disk consistency
check and then multi-user operations.  This prevents the consistency
check, rather simply booting the system with a single-user shell on
the console.
This switch is interpreted by the
.IR init (8)
program in the newly booted system.
.TP
RB_NOFSCK
The normal file system consistency check is omitted after the reboot.
This is used for a fast reboot on a quiet system with no possibility
of file system problems.
.SH ERRORS
.I Reboot
will fail if:
.TP 20
[EPERM]
The process's effective user ID is not the super-user.
.SH "SEE ALSO"
crash(8), init(8), reboot(8)
.SH BUGS
The device specification is not implemented yet.