Return to reboot.2 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man2

Annotation of cci/usr/src/man/man2/reboot.2, revision 1.1.1.1

1.1       root        1: .TH REBOOT 2 "18 July 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: reboot \- reboot system or halt processor
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B #include <sys/reboot.h>
                      8: .PP
                      9: .B reboot(howto)
                     10: .B int howto;
                     11: .fi
                     12: .SH DESCRIPTION
                     13: .I Reboot
                     14: reboots the system, and is invoked automatically
                     15: in the event of unrecoverable system failures.
                     16: .I Howto
                     17: is a mask of options passed to the bootstrap program.
                     18: The system call interface permits only RB_HALT or RB_AUTOBOOT
                     19: to be passed to the reboot program; the other flags
                     20: are used in scripts stored on the console storage media, or used
                     21: in manual bootstrap procedures.
                     22: When none of these options (e.g. RB_AUTOBOOT) is given, the system is rebooted
                     23: from file \*(lqvmunix\*(rq in the root file system of unit 0
                     24: of a disk chosen in a processor specific way.
                     25: An automatic consistency check of the disks is then normally performed.
                     26: .PP
                     27: The bits of
                     28: .I howto
                     29: are:
                     30: .TP
                     31: RB_HALT
                     32: the processor is simply halted; no reboot takes place.
                     33: RB_HALT should be used with caution.
                     34: .TP
                     35: RB_ASKNAME
                     36: Interpreted by the bootstrap program itself, causing it to
                     37: inquire as to what file should be booted.  Normally, the system is
                     38: booted from the file \*(lqxx(0,0)vmunix\*(rq without asking.
                     39: .TP
                     40: RB_SINGLE
                     41: Normally, the reboot procedure involves an automatic disk consistency
                     42: check and then multi-user operations.  RB_SINGLE prevents the consistency
                     43: check, rather simply booting the system with a single-user shell on
                     44: the console.
                     45: RB_SINGLE is interpreted by the
                     46: .IR init (8)
                     47: program in the newly booted system.
                     48: This switch is not available from the system call interface.
                     49: .PP
                     50: Only the super-user may
                     51: .I reboot
                     52: a machine.
                     53: .SH "RETURN VALUES"
                     54: If successful, this call never returns.  Otherwise, a \-1
                     55: is returned and an error is returned in the global variable
                     56: .IR errno .
                     57: .SH ERRORS
                     58: .TP 15
                     59: [EPERM]
                     60: The caller is not the super-user.
                     61: .SH "SEE ALSO"
                     62: crash(8), halt(8), init(8), reboot(8)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.