BSD 4_3_Tahoe development
[unix-history] / usr / man / cat2 / reboot.0
CommitLineData
2cf6fecc
C
1
2
3
4REBOOT(2) UNIX Programmer's Manual REBOOT(2)
5
6
7
8N\bNA\bAM\bME\bE
9 reboot - reboot system or halt processor
10
11S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
12 #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<s\bsy\bys\bs/\b/r\bre\beb\bbo\boo\bot\bt.\b.h\bh>\b>
13
14 r\bre\beb\bbo\boo\bot\bt(\b(h\bho\bow\bwt\bto\bo)\b)
15 i\bin\bnt\bt h\bho\bow\bwt\bto\bo;\b;
16
17D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
18 _\bR_\be_\bb_\bo_\bo_\bt reboots the system, and is invoked automatically in
19 the event of unrecoverable system failures. _\bH_\bo_\bw_\bt_\bo is a mask
20 of options passed to the bootstrap program. The system call
21 interface permits only RB_HALT or RB_AUTOBOOT to be passed
22 to the reboot program; the other flags are used in scripts
23 stored on the console storage media, or used in manual
24 bootstrap procedures. When none of these options (e.g.
25 RB_AUTOBOOT) is given, the system is rebooted from file
26 "vmunix" in the root file system of unit 0 of a disk chosen
27 in a processor specific way. An automatic consistency check
28 of the disks is then normally performed.
29
30 The bits of _\bh_\bo_\bw_\bt_\bo are:
31
32 RB_HALT
33 the processor is simply halted; no reboot takes place.
34 RB_HALT should be used with caution.
35
36 RB_ASKNAME
37 Interpreted by the bootstrap program itself, causing it
38 to inquire as to what file should be booted. Normally,
39 the system is booted from the file "xx(0,0)vmunix"
40 without asking.
41
42 RB_SINGLE
43 Normally, the reboot procedure involves an automatic
44 disk consistency check and then multi-user operations.
45 RB_SINGLE prevents the consistency check, rather simply
46 booting the system with a single-user shell on the con-
47 sole. RB_SINGLE is interpreted by the _\bi_\bn_\bi_\bt(8) program
48 in the newly booted system. This switch is not avail-
49 able from the system call interface.
50
51 Only the super-user may _\br_\be_\bb_\bo_\bo_\bt a machine.
52
53R\bRE\bET\bTU\bUR\bRN\bN V\bVA\bAL\bLU\bUE\bES\bS
54 If successful, this call never returns. Otherwise, a -1 is
55 returned and an error is returned in the global variable
56 _\be_\br_\br_\bn_\bo.
57
58E\bER\bRR\bRO\bOR\bRS\bS
59 [EPERM] The caller is not the super-user.
60
61
62
63Printed 7/9/88 May 9, 1985 1
64
65
66
67
68
69
70REBOOT(2) UNIX Programmer's Manual REBOOT(2)
71
72
73
74S\bSE\bEE\bE A\bAL\bLS\bSO\bO
75 crash(8), halt(8), init(8), reboot(8)
76
77B\bBU\bUG\bGS\bS
78 The notion of ``console medium'', among other things, is
79 specific to the VAX.
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129Printed 7/9/88 May 9, 1985 2
130
131
132