| blob | 07541371334042586cfd60ef147ddff0cdb2d3b6 |
1 .\" $NetBSD: boot.8,v 1.2 2004/08/12 14:43:33 wiz Exp $
2 .\"
3 .\" $OpenBSD: boot_hppa.8,v 1.11 2004/05/25 22:27:44 jmc Exp $
4 .\"
5 .\" Copyright (c) 2002, Miodrag Vallat.
6 .\" All rights reserved.
7 .\"
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 .\"
17 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 .\" SUCH DAMAGE.
28 .\"
29 .Dd July 27, 2004
30 .Dt BOOT 8 hp700
31 .Os
32 .Sh NAME
33 .Nm boot
34 .Nd hp700 system bootstrapping procedures
35 .Sh DESCRIPTION
36 .Ss System starts
37 When powered on, after a panic, or if the system is rebooted via
38 .Xr reboot 8
39 or
40 .Xr shutdown 8 ,
41 the hp700 firmware
42 .Pq Dq PDC
43 will proceed to its initialization, and will boot an operating system
44 if autoboot is enabled.
45 .\"
46 .Ss Boot process description
47 System boot blocks are provided as a
48 .Dq LIF
49 .Pq Logical Interchange Format
50 archive, either on a disk device, or via the network, using the
51 .Em bootp
52 or
53 .Em rboot
54 protocols, depending on the PDC version.
55 .\" A small
56 .\" .Xr mkboot 8
57 .\" utility
58 .\" is provided for combining primary boot and a number
59 .\" of images (OS kernels or standalone binaries)
60 .\" into one
61 .\" .Dq LIF
62 .\" volume suitable for booting.
63 .Ss PDC concepts
64 If autoboot is enabled, the PDC will attempt to boot from the specified
65 .Dq boot path
66 value.
67 If no
68 .Dq boot path
69 has been specified, the PDC will then scan for bootable devices and
70 boot from the first found, after a few seconds allowing the user to
71 interrupt the boot process.
72 If autoboot is disabled, the PDC will enter interactive mode, after an
73 optional device scan.
74 In all cases, it is possible to enter interactive mode by holding the
75 escape key during the selftests, or when prompted to do so to abort
76 the current operation, unless the PDC has been configured in
77 .Dq secure mode .
78 .\"
79 .Ss ISL interaction
80 .Dq ISL
81 stands for
82 .Dq Initial System Loader
83 and is the
84 .Nm
85 program in
86 .Nx .
87 On all versions of the PDC except for the 712 and 725 models the
88 .Dq boot
89 command (see below) will be followed by the question:
90 .Dq Interact with IPL (Y, N, or Cancel)?\*[Gt]
91 where a positive answer will invoke an interactive prompt in the
92 .Nm
93 program later and negative will thus suppress it.
94 A cancellation will abort the boot process.
95 .Pp
96 On the 712 and 725 models firmware an additional
97 .Dq isl
98 argument should be given to the
99 .Dq boot
100 command to invoke the
101 .Nm
102 interactive prompt.
103 The default behaviour is a non-interactive boot process.
104 .\"
105 .Ss Old PDC operation
106 This version is used on the following models:
107 705, 7x0, 715/33/50/75, 725/50/75, 735, 755.
108 There are two levels of interactive commands in this version.
109 The first level is a short menu:
110 .Bd -literal -offset indent
111 b) Boot from specified device
112 s) Search for bootable device
113 a) Enter Boot Administration mode
114 x) Exit and continue boot sequence
116 Select from menu:
117 .Ed
118 .Pp
119 which provides the following commands:
120 .Pp
121 .Bl -tag -width "XXX" -offset indent -compact
122 .It Cm b
123 boot from a device found during the scan,
124 either with its short
125 .Dq P#
126 form, or a complete name specification.
127 For example, to boot from the
128 .Tn SCSI
129 disk with id 6 off the built-in (first) controller,
130 one would enter
131 .Ic b Ar scsi.6.0 .
132 .It Cm s
133 rescan for bootable devices.
134 .It Cm a
135 enter the second part of interactive mode.
136 .It Cm x
137 resume an interrupted boot sequence.
138 .El
139 .Pp
140 The
141 .Dq Boot Administration
142 mode, recognizable with its
143 .Em BOOT_ADMIN\*[Gt]
144 prompt, controls the various boot options.
145 The complete list of commands depends on the machine and PDC version.
146 The following list only mentions commands impacting the boot process.
147 .Bl -tag -width AUTOSELECT -offset indent
148 .It AUTOSELECT
149 Displays or changes the autoboot setting.
150 If autoselect is set to
151 .Dq on ,
152 the PDC will always attempt to boot the first bootable device found in
153 this order:
154 .Bl -enum -offset indent -compact
155 .It
156 Boot device
157 .Em path
158 setting.
159 .It
160 .Tn SCSI
161 devices connected to the built-in
162 .Tn SCSI
163 controller,
164 the highest ID numbers being preferred.
165 .It
166 Network
167 .Em rboot
168 server (see also
169 .Xr rbootd 8 ) .
170 .It
171 Other
172 .Tn SCSI
173 devices connected to secondary controllers,
174 the highest ID numbers being preferred.
175 .El
176 If the
177 .Em primary path
178 setting defines a bootable device, no device scan will occur.
179 .It BOOT
180 Boots off the specified device.
181 It is similar to the
182 .Ic b
183 command from the short menu above.
184 The
185 .Dq primary
186 and
187 .Dq alternate
188 path settings may be booted with
189 .Ic boot Ar pri
190 and
191 .Ic boot Ar alt
192 respectively.
193 .It PATH
194 Displays or changes the boot and console devices.
195 The boot device is defined as the
196 .Dq primary
197 path, and another setting may be stored as the
198 .Dq alternate
199 path for rescue purposes.
200 For example, to define the primary boot path to the
201 .Tn SCSI
202 disk with ID 5 connected to the built-in controller, one would enter
203 .Ic path primary Ar scsi.5
204 .Pp
205 When invoked without parameters,
206 .Ic path
207 will list the various path settings.
208 .El
209 .\"
210 .Ss Modern PDC operation
211 Machines equipped with 7100LC, 7200, or 7300LC CPU types are
212 usually blessed with a different kind of PDC.
213 There is only one interactive mode, with a
214 .Em BOOT_ADMIN\*[Gt]
215 prompt, which provides both boot settings and commands.
216 The complete list of commands depends on the machine and PDC version.
217 The following list only mentions commands impacting the boot process.
218 .Bl -tag -width auto\ search -offset indent
219 .It Ic auto boot
220 Displays or changes the autoboot setting.
221 If
222 .Ic auto boot
223 is set to
224 .Dq on ,
225 the PDC will always attempt to boot.
226 The booted device chosen will depend on the
227 .Ic auto search
228 setting.
229 .It Ic auto search
230 Displays or changes the device scan setting.
231 If
232 .Ic auto search
233 is set to
234 .Dq on ,
235 the PDC will attempt to boot the first bootable device found in
236 this order:
237 .Bl -enum -offset indent -compact
238 .It
239 Boot device
240 .Em path
241 setting.
242 .It
243 .Tn SCSI
244 devices connected to the built-in
245 .Tn SCSI
246 controller,
247 the highest ID numbers being preferred.
248 .It
249 Network
250 .Em bootp
251 server (see also
252 .Xr dhcpd 8 ) .
253 .It
254 Other
255 .Tn SCSI
256 devices connected to secondary controllers,
257 the highest ID numbers being preferred.
258 .El
259 If
260 .Ic auto search
261 is set to
262 .Dq off
263 and the primary boot path points to a bootable device,
264 no device scan will occur.
265 .Pp
266 Note that setting
267 .Ic auto search
268 to
269 .Dq on
270 will force autoboot, regardless of the
271 .Ic auto boot
272 value.
273 .It Ic boot
274 Boots off the specified device.
275 The
276 .Dq primary
277 and
278 .Dq alternate
279 path settings may be booted with
280 .Ic boot Ar pri
281 and
282 .Ic boot Ar alt
283 respectively.
284 .It Ic path
285 Displays or changes the boot and console devices.
286 The boot device is defined as the
287 .Dq primary
288 path, and another setting may be stored as the
289 .Dq alternate
290 path for rescue purposes.
291 For example, to define the primary boot path to the
292 .Tn SCSI
293 disk with ID 5 connected to the built-in controller, one would enter
294 .Ic path pri Ar scsi.5 .
295 .Pp
296 When invoked without parameters,
297 .Ic path
298 will list the various path settings.
299 .El
300 .\"
301 .Ss Abnormal system termination
302 If the system crashes, it will enter the kernel debugger,
303 .Xr ddb 4 ,
304 if it is configured in the kernel.
305 If the crash occurred during
306 initialization and the debugger is not present or is exited, the
307 kernel will halt the system.
308 If the crash occurred during normal operation and the debugger
309 is not present or is exited, the system will attempt a dump to the
310 configured dump device (which will be automatically recovered with
311 .Xr savecore 8
312 during the next multi-user boot cycle), and after the dump is complete
313 (successful or not) the kernel will attempt a reboot.
314 .Sh FILES
315 .Bl -tag -width /usr/mdec/xxbootxx -compact
316 .It Pa boot.lif
317 network bootstrap and kernel combined image
318 .It Pa /netbsd
319 default
320 .Nx
321 system kernel
322 .It Pa /usr/mdec/xxboot
323 primary bootstrap for
324 .Dq ffs
325 file system
326 .It Pa /usr/mdec/boot
327 system bootstrap (usually also installed as
328 .Pa /boot )
329 .El
330 .Sh SEE ALSO
331 .Xr ddb 4 ,
332 .Xr dhcpd 8 ,
333 .Xr halt 8 ,
334 .Xr init 8 ,
335 .Xr installboot 8 ,
336 .Xr rbootd 8 ,
337 .Xr reboot 8 ,
338 .Xr savecore 8 ,
339 .Xr shutdown 8