Commit | Line | Data |
---|---|---|
70567b1c | 1 | .\" Copyright (c) 1990, 1991 The Regents of the University of California. |
86e54a38 KB |
2 | .\" All rights reserved. |
3 | .\" | |
4 | .\" This code is derived from software contributed to Berkeley by | |
5 | .\" the Systems Programming Group of the University of Utah Computer | |
70567b1c | 6 | .\" Science Department. |
86e54a38 | 7 | .\" |
af359dea C |
8 | .\" Redistribution and use in source and binary forms, with or without |
9 | .\" modification, are permitted provided that the following conditions | |
10 | .\" are met: | |
11 | .\" 1. Redistributions of source code must retain the above copyright | |
12 | .\" notice, this list of conditions and the following disclaimer. | |
13 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
14 | .\" notice, this list of conditions and the following disclaimer in the | |
15 | .\" documentation and/or other materials provided with the distribution. | |
16 | .\" 3. All advertising materials mentioning features or use of this software | |
17 | .\" must display the following acknowledgement: | |
18 | .\" This product includes software developed by the University of | |
19 | .\" California, Berkeley and its contributors. | |
20 | .\" 4. Neither the name of the University nor the names of its contributors | |
21 | .\" may be used to endorse or promote products derived from this software | |
22 | .\" without specific prior written permission. | |
86e54a38 | 23 | .\" |
af359dea C |
24 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND |
25 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
26 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
27 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
28 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
29 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
30 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
31 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
32 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
33 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
34 | .\" SUCH DAMAGE. | |
86e54a38 | 35 | .\" |
af359dea | 36 | .\" @(#)reboot_hp300.8 5.4 (Berkeley) 7/23/91 |
86e54a38 | 37 | .\" |
af359dea | 38 | .Dd July 23, 1991 |
70567b1c | 39 | .Dt REBOOT 8 |
af359dea | 40 | .Os |
70567b1c CL |
41 | .Sh NAME |
42 | .Nm reboot | |
43 | .Nd | |
44 | .Tn UNIX | |
45 | bootstrapping procedures | |
46 | .Sh SYNOPSIS | |
47 | .Nm reboot | |
48 | .Op Fl d | |
49 | .Op Fl n | |
50 | .Op Fl q | |
51 | .Op Fl s | |
52 | .Sh DESCRIPTION | |
53 | .Tn UNIX | |
54 | is started by placing it at the beginning of physical memory | |
86e54a38 KB |
55 | and transferring to the entry point. |
56 | Since the system is not reenterable, | |
57 | it is necessary to read it in from disk or tape | |
58 | each time it is to be bootstrapped. | |
70567b1c CL |
59 | .Pp |
60 | .Sy Rebooting a running system . | |
61 | When a | |
62 | .Tn UNIX | |
63 | is running and a reboot is desired, | |
64 | .Xr shutdown 8 | |
86e54a38 KB |
65 | is normally used. |
66 | If there are no users then | |
70567b1c | 67 | .Nm reboot |
86e54a38 KB |
68 | can be used. |
69 | Reboot causes the disks to be synced and allows the system | |
70 | to perform other shutdown activities such as resynchronizing | |
71 | hardware time-of-day clocks. | |
72 | A multi-user reboot (as described below) is then initiated. | |
73 | This causes a system to be | |
74 | booted and an automatic disk check to be performed. If all this succeeds | |
75 | without incident, the system is then brought up for many users. | |
70567b1c | 76 | .Pp |
86e54a38 | 77 | Options to reboot are: |
70567b1c CL |
78 | .Bl -tag -width Ds |
79 | .\" .It Fl d | |
80 | .\" option forces a memory dump to the swap area (see | |
81 | .\" .Xr crash 8 ) | |
82 | .\" before rebooting. | |
83 | .\" This can be used if the system is in a funny state that you would | |
84 | .\" like to ``snapshot'' and analyze later. | |
85 | .It Fl n | |
86e54a38 KB |
86 | option avoids the sync. It can be used if a disk or the processor |
87 | is on fire. | |
70567b1c | 88 | .It Fl q |
86e54a38 KB |
89 | reboots quickly and ungracefully, without shutting down running |
90 | processes first. | |
70567b1c CL |
91 | .\" .It Fl s |
92 | .\" option reboots to single user mode. | |
93 | .El | |
94 | .Pp | |
95 | .Nm Reboot | |
86e54a38 | 96 | normally logs the reboot using |
70567b1c | 97 | .Xr syslog 8 |
86e54a38 | 98 | and places a shutdown record in the login accounting file (see |
70567b1c | 99 | .Xr utmp 5 . |
86e54a38 | 100 | These actions are inhibited if the |
70567b1c | 101 | .Fl n |
86e54a38 | 102 | or |
70567b1c | 103 | .Fl q |
86e54a38 | 104 | options are present. |
70567b1c CL |
105 | .Pp |
106 | .Sy Power fail and crash recovery. | |
86e54a38 KB |
107 | Normally, the system will reboot itself at power-up or after crashes. |
108 | An automatic consistency check of the file systems will be performed, | |
109 | and unless this fails, the system will resume multi-user operations. | |
70567b1c CL |
110 | .Pp |
111 | .Sy Cold starts. | |
86e54a38 | 112 | On an HP300, the boot procedure uses the boot rom to load a boot program |
70567b1c CL |
113 | from an |
114 | .Tn LIF | |
115 | format directory at the beginning of an attached disk. | |
116 | The | |
117 | .Pa /usr/mdec | |
118 | directory contains a disk boot program | |
119 | .Pa bootrd | |
86e54a38 | 120 | which should be placed in a new pack automatically by |
70567b1c | 121 | .Xr newfs 8 |
86e54a38 | 122 | when the ``a'' partition file system on the pack is created. |
70567b1c | 123 | .Pp |
86e54a38 | 124 | This |
70567b1c | 125 | .Em boot |
86e54a38 KB |
126 | program |
127 | finds the corresponding file on the given device | |
70567b1c | 128 | .Pf ( Ar vmunix |
86e54a38 KB |
129 | by default), |
130 | loads that file into memory, | |
131 | and starts the program at the entry address specified in the program header. | |
70567b1c | 132 | .Pp |
86e54a38 KB |
133 | The boot program can be interrupted by typing `^C' (ctrl-C). |
134 | This will force the boot program to interactively prompt for a system to boot. | |
135 | If not interrupted, it will boot from the device from which the boot | |
136 | program itself was loaded. | |
70567b1c | 137 | .Pp |
86e54a38 | 138 | The file specifications used for an interactive boot are of the form: |
70567b1c CL |
139 | .Pp |
140 | .Dl device(unit,minor) | |
141 | .Pp | |
86e54a38 | 142 | where |
70567b1c | 143 | .Ar device |
86e54a38 | 144 | is the type of the device to be searched, |
70567b1c | 145 | .Ar unit |
86e54a38 KB |
146 | is 8 * the hpib number plus the unit number of the disk or tape, |
147 | and | |
70567b1c | 148 | .Ar minor |
86e54a38 KB |
149 | is the disk partition or tape file number. |
150 | Normal line editing characters can be used when typing the file specification. | |
151 | Currently, ``rd'' is the only valid | |
70567b1c | 152 | .Ar device |
86e54a38 | 153 | specifier. |
70567b1c | 154 | .Pp |
86e54a38 KB |
155 | For example, |
156 | to boot from the `a' file system of unit 0 on HP-IB 2, | |
70567b1c CL |
157 | type |
158 | .Ql rd(16,0)vmunix | |
86e54a38 KB |
159 | to the boot prompt. |
160 | For tapes, the minor device number gives a file offset. | |
70567b1c | 161 | .Pp |
86e54a38 | 162 | In an emergency, the bootstrap methods described in the paper |
70567b1c | 163 | .%T Installing 4.3bsd on the HP300 |
86e54a38 | 164 | can be used to boot from a distribution tape. |
70567b1c CL |
165 | .Sh FILES |
166 | .Bl -tag -width /usr/mdec/installboot -compact | |
167 | .It Pa /vmunix | |
168 | system code | |
169 | .It Pa /usr/mdec/bootrd | |
170 | .Tn LIF | |
171 | format boot block | |
172 | .It Pa /usr/mdec/installboot | |
173 | program to install boot blocks | |
174 | .El | |
175 | .Sh SEE ALSO | |
176 | .Xr crash 8m , | |
177 | .Xr fsck 8 , | |
178 | .Xr halt 8 , | |
179 | .Xr init 8 , | |
180 | .Xr newfs 8 , | |
181 | .Xr rc 8 , | |
182 | .Xr shutdown 8 , | |
183 | .Xr syslogd 8 | |
184 | .Sh HISTORY | |
185 | The | |
186 | .Nm | |
af359dea C |
187 | command is |
188 | .Ud . |