| @@ -1,936 +1,936 @@ | | | @@ -1,936 +1,936 @@ |
1 | .\" $NetBSD: installboot.8,v 1.85 2012/03/10 18:42:18 dsl Exp $ | | 1 | .\" $NetBSD: installboot.8,v 1.86 2012/03/10 19:38:16 wiz Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 2002-2012 The NetBSD Foundation, Inc. | | 3 | .\" Copyright (c) 2002-2012 The NetBSD Foundation, Inc. |
4 | .\" All rights reserved. | | 4 | .\" All rights reserved. |
5 | .\" | | 5 | .\" |
6 | .\" This code is derived from software contributed to The NetBSD Foundation | | 6 | .\" This code is derived from software contributed to The NetBSD Foundation |
7 | .\" by Luke Mewburn of Wasabi Systems. | | 7 | .\" by Luke Mewburn of Wasabi Systems. |
8 | .\" | | 8 | .\" |
9 | .\" Redistribution and use in source and binary forms, with or without | | 9 | .\" Redistribution and use in source and binary forms, with or without |
10 | .\" modification, are permitted provided that the following conditions | | 10 | .\" modification, are permitted provided that the following conditions |
11 | .\" are met: | | 11 | .\" are met: |
12 | .\" 1. Redistributions of source code must retain the above copyright | | 12 | .\" 1. Redistributions of source code must retain the above copyright |
13 | .\" notice, this list of conditions and the following disclaimer. | | 13 | .\" notice, this list of conditions and the following disclaimer. |
14 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 14 | .\" 2. Redistributions in binary form must reproduce the above copyright |
15 | .\" notice, this list of conditions and the following disclaimer in the | | 15 | .\" notice, this list of conditions and the following disclaimer in the |
16 | .\" documentation and/or other materials provided with the distribution. | | 16 | .\" documentation and/or other materials provided with the distribution. |
17 | .\" | | 17 | .\" |
18 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS | | 18 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS |
19 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED | | 19 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED |
20 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR | | 20 | .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
21 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS | | 21 | .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS |
22 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR | | 22 | .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR |
23 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF | | 23 | .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
24 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | | 24 | .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
25 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN | | 25 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN |
26 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | | 26 | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) |
27 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | | 27 | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
28 | .\" POSSIBILITY OF SUCH DAMAGE. | | 28 | .\" POSSIBILITY OF SUCH DAMAGE. |
29 | .\" | | 29 | .\" |
30 | .Dd March 10, 2012 | | 30 | .Dd March 10, 2012 |
31 | .Dt INSTALLBOOT 8 | | 31 | .Dt INSTALLBOOT 8 |
32 | .Os | | 32 | .Os |
33 | .Sh NAME | | 33 | .Sh NAME |
34 | .Nm installboot | | 34 | .Nm installboot |
35 | .Nd install disk bootstrap software | | 35 | .Nd install disk bootstrap software |
36 | . | | 36 | . |
37 | .Sh SYNOPSIS | | 37 | .Sh SYNOPSIS |
38 | .Nm | | 38 | .Nm |
39 | .Op Fl fnv | | 39 | .Op Fl fnv |
40 | .Op Fl B Ar s2bno | | 40 | .Op Fl B Ar s2bno |
41 | .Op Fl b Ar s1bno | | 41 | .Op Fl b Ar s1bno |
42 | .Op Fl m Ar machine | | 42 | .Op Fl m Ar machine |
43 | .Op Fl o Ar options | | 43 | .Op Fl o Ar options |
44 | .Op Fl t Ar fstype | | 44 | .Op Fl t Ar fstype |
45 | .Ar filesystem | | 45 | .Ar filesystem |
46 | .Ar primary | | 46 | .Ar primary |
47 | .Op Ar secondary | | 47 | .Op Ar secondary |
48 | .Nm | | 48 | .Nm |
49 | .Fl c | | 49 | .Fl c |
50 | .Op Fl fnv | | 50 | .Op Fl fnv |
51 | .Op Fl m Ar machine | | 51 | .Op Fl m Ar machine |
52 | .Op Fl o Ar options | | 52 | .Op Fl o Ar options |
53 | .Op Fl t Ar fstype | | 53 | .Op Fl t Ar fstype |
54 | .Ar filesystem | | 54 | .Ar filesystem |
55 | .Nm | | 55 | .Nm |
56 | .Fl e | | 56 | .Fl e |
57 | .Op Fl fnv | | 57 | .Op Fl fnv |
58 | .Op Fl m Ar machine | | 58 | .Op Fl m Ar machine |
59 | .Op Fl o Ar options | | 59 | .Op Fl o Ar options |
60 | .Ar bootstrap | | 60 | .Ar bootstrap |
61 | . | | 61 | . |
62 | .Sh DESCRIPTION | | 62 | .Sh DESCRIPTION |
63 | The | | 63 | The |
64 | .Nm | | 64 | .Nm |
65 | utility installs and removes | | 65 | utility installs and removes |
66 | .Nx | | 66 | .Nx |
67 | disk bootstrap software into a file system. | | 67 | disk bootstrap software into a file system. |
68 | .Nm | | 68 | .Nm |
69 | can install | | 69 | can install |
70 | .Ar primary | | 70 | .Ar primary |
71 | into | | 71 | into |
72 | .Ar filesystem , | | 72 | .Ar filesystem , |
73 | or disable an existing bootstrap in | | 73 | or disable an existing bootstrap in |
74 | .Ar filesystem . | | 74 | .Ar filesystem . |
75 | .Pp | | 75 | .Pp |
76 | On some architectures the options of an existing installed bootstrap, | | 76 | On some architectures the options of an existing installed bootstrap, |
77 | or those of a bootstrap file can be changed. | | 77 | or those of a bootstrap file can be changed. |
78 | Installing a new primary bootstrap will reset those options to default | | 78 | Installing a new primary bootstrap will reset those options to default |
79 | values. | | 79 | values. |
80 | .Pp | | 80 | .Pp |
81 | Generally, | | 81 | Generally, |
82 | .Nx | | 82 | .Nx |
83 | disk bootstrap software consists of two parts: a | | 83 | disk bootstrap software consists of two parts: a |
84 | .Dq primary | | 84 | .Dq primary |
85 | bootstrap program usually written into the disklabel area of the | | 85 | bootstrap program usually written into the disklabel area of the |
86 | file system by | | 86 | file system by |
87 | .Nm , | | 87 | .Nm , |
88 | and a | | 88 | and a |
89 | .Dq secondary | | 89 | .Dq secondary |
90 | bootstrap program that usually resides as an ordinary file in the file system. | | 90 | bootstrap program that usually resides as an ordinary file in the file system. |
91 | .Pp | | 91 | .Pp |
92 | When booting, the primary bootstrap program is loaded and invoked by | | 92 | When booting, the primary bootstrap program is loaded and invoked by |
93 | the machine's PROM or BIOS. | | 93 | the machine's PROM or BIOS. |
94 | After receiving control of the system it loads and runs the secondary | | 94 | After receiving control of the system it loads and runs the secondary |
95 | bootstrap program, which in turn loads and runs the kernel. | | 95 | bootstrap program, which in turn loads and runs the kernel. |
96 | The secondary bootstrap may allow control over various boot parameters | | 96 | The secondary bootstrap may allow control over various boot parameters |
97 | passed to the kernel. | | 97 | passed to the kernel. |
98 | .Pp | | 98 | .Pp |
99 | Perform the following steps to make a file system bootable: | | 99 | Perform the following steps to make a file system bootable: |
100 | .Bl -enum | | 100 | .Bl -enum |
101 | .It | | 101 | .It |
102 | Copy the secondary bootstrap (usually | | 102 | Copy the secondary bootstrap (usually |
103 | .Pa /usr/mdec/boot. Ns Sy MACHINE | | 103 | .Pa /usr/mdec/boot. Ns Sy MACHINE |
104 | or | | 104 | or |
105 | .Pa /usr/mdec/boot ) | | 105 | .Pa /usr/mdec/boot ) |
106 | to the root directory of the target file system. | | 106 | to the root directory of the target file system. |
107 | .Pp | | 107 | .Pp |
108 | . | | 108 | . |
109 | .It | | 109 | .It |
110 | Use | | 110 | Use |
111 | .Nm | | 111 | .Nm |
112 | to install the primary bootstrap program | | 112 | to install the primary bootstrap program |
113 | (usually | | 113 | (usually |
114 | .Pa /usr/mdec/bootxx_ Ns Sy FSTYPE ) | | 114 | .Pa /usr/mdec/bootxx_ Ns Sy FSTYPE ) |
115 | into | | 115 | into |
116 | .Ar filesystem . | | 116 | .Ar filesystem . |
117 | .Pp | | 117 | .Pp |
118 | The following platforms do not require this step if the primary bootstrap | | 118 | The following platforms do not require this step if the primary bootstrap |
119 | already exists and the secondary bootstrap file is just being updated: | | 119 | already exists and the secondary bootstrap file is just being updated: |
120 | .Sy alpha , | | 120 | .Sy alpha , |
121 | .Sy amd64 , | | 121 | .Sy amd64 , |
122 | .Sy amiga , | | 122 | .Sy amiga , |
123 | .Sy i386 , | | 123 | .Sy i386 , |
124 | .Sy pmax , | | 124 | .Sy pmax , |
125 | .Sy sparc64 , | | 125 | .Sy sparc64 , |
126 | and | | 126 | and |
127 | .Sy vax . | | 127 | .Sy vax . |
128 | .Pp | | 128 | .Pp |
129 | The following platform does not require the first step since a | | 129 | The following platform does not require the first step since a |
130 | single bootstrap file is used. | | 130 | single bootstrap file is used. |
131 | The single bootstrap is installed like the primary bootstrap on | | 131 | The single bootstrap is installed like the primary bootstrap on |
132 | other platforms: | | 132 | other platforms: |
133 | .Sy next68k . | | 133 | .Sy next68k . |
134 | .Pp | | 134 | .Pp |
135 | .El | | 135 | .El |
136 | .Pp | | 136 | .Pp |
137 | The options and arguments recognized by | | 137 | The options and arguments recognized by |
138 | .Nm | | 138 | .Nm |
139 | are as follows: | | 139 | are as follows: |
140 | . | | 140 | . |
141 | .Bl -tag -width "optionsxxx" | | 141 | .Bl -tag -width "optionsxxx" |
142 | . | | 142 | . |
143 | .It Fl B Ar s2bno | | 143 | .It Fl B Ar s2bno |
144 | When hard-coding the blocks of | | 144 | When hard-coding the blocks of |
145 | .Ar secondary | | 145 | .Ar secondary |
146 | into | | 146 | into |
147 | .Ar primary , | | 147 | .Ar primary , |
148 | start from block | | 148 | start from block |
149 | .Ar s2bno | | 149 | .Ar s2bno |
150 | instead of trying to determine the block numbers occupied by | | 150 | instead of trying to determine the block numbers occupied by |
151 | .Ar secondary | | 151 | .Ar secondary |
152 | by examining | | 152 | by examining |
153 | .Ar filesystem . | | 153 | .Ar filesystem . |
154 | If this option is supplied, | | 154 | If this option is supplied, |
155 | .Ar secondary | | 155 | .Ar secondary |
156 | should refer to an actual secondary bootstrap (rather than the | | 156 | should refer to an actual secondary bootstrap (rather than the |
157 | file name of the one present in | | 157 | file name of the one present in |
158 | .Ar filesystem ) | | 158 | .Ar filesystem ) |
159 | so that its size can be determined. | | 159 | so that its size can be determined. |
160 | . | | 160 | . |
161 | .It Fl b Ar s1bno | | 161 | .It Fl b Ar s1bno |
162 | Install | | 162 | Install |
163 | .Ar primary | | 163 | .Ar primary |
164 | at block number | | 164 | at block number |
165 | .Ar s1bno | | 165 | .Ar s1bno |
166 | instead of the default location for the machine and file system type. | | 166 | instead of the default location for the machine and file system type. |
167 | .Sy [ alpha , | | 167 | .Sy [ alpha , |
168 | .Sy i386/amd64 (bootxx_fat16 only) , | | 168 | .Sy i386/amd64 (bootxx_fat16 only) , |
169 | .Sy pmax , | | 169 | .Sy pmax , |
170 | .Sy vax ] | | 170 | .Sy vax ] |
171 | . | | 171 | . |
172 | .It Fl c | | 172 | .It Fl c |
173 | Clear (remove) any existing bootstrap instead of installing one. | | 173 | Clear (remove) any existing bootstrap instead of installing one. |
174 | . | | 174 | . |
175 | .It Fl e | | 175 | .It Fl e |
176 | Edit the options of an existing bootstrap. | | 176 | Edit the options of an existing bootstrap. |
177 | This can be use to change the options in bootxx_xxxfs files, | | 177 | This can be use to change the options in bootxx_xxxfs files, |
178 | raw disk partitions, and the | | 178 | raw disk partitions, and the |
179 | .Pa pxeboot_ia32.bin | | 179 | .Pa pxeboot_ia32.bin |
180 | file. | | 180 | file. |
181 | With | | 181 | With |
182 | .Fl v | | 182 | .Fl v |
183 | and without | | 183 | and without |
184 | .Fl o , | | 184 | .Fl o , |
185 | show the current options. | | 185 | show the current options. |
186 | .Sy [ amd64 , i386 ] | | 186 | .Sy [ amd64 , i386 ] |
187 | . | | 187 | . |
188 | .It Fl f | | 188 | .It Fl f |
189 | Forces | | 189 | Forces |
190 | .Nm | | 190 | .Nm |
191 | to ignore some errors. | | 191 | to ignore some errors. |
192 | . | | 192 | . |
193 | .It Fl m Ar machine | | 193 | .It Fl m Ar machine |
194 | Use | | 194 | Use |
195 | .Ar machine | | 195 | .Ar machine |
196 | as the target machine type. | | 196 | as the target machine type. |
197 | The default machine is determined from | | 197 | The default machine is determined from |
198 | .Xr uname 3 | | 198 | .Xr uname 3 |
199 | and then | | 199 | and then |
200 | .Ev MACHINE . | | 200 | .Ev MACHINE . |
201 | The following machines are currently supported by | | 201 | The following machines are currently supported by |
202 | .Nm : | | 202 | .Nm : |
203 | .Bd -ragged -offset indent | | 203 | .Bd -ragged -offset indent |
204 | .Sy alpha , | | 204 | .Sy alpha , |
205 | .Sy amd64 , | | 205 | .Sy amd64 , |
206 | .Sy amiga , | | 206 | .Sy amiga , |
207 | .Sy ews4800mips , | | 207 | .Sy ews4800mips , |
208 | .Sy hp300 , | | 208 | .Sy hp300 , |
209 | .Sy hp700 , | | 209 | .Sy hp700 , |
210 | .Sy i386 , | | 210 | .Sy i386 , |
211 | .Sy landisk , | | 211 | .Sy landisk , |
212 | .Sy macppc , | | 212 | .Sy macppc , |
213 | .Sy news68k , | | 213 | .Sy news68k , |
214 | .Sy newsmips , | | 214 | .Sy newsmips , |
215 | .Sy next68k , | | 215 | .Sy next68k , |
216 | .Sy pmax , | | 216 | .Sy pmax , |
217 | .Sy sparc , | | 217 | .Sy sparc , |
218 | .Sy sparc64 , | | 218 | .Sy sparc64 , |
219 | .Sy sun2 , | | 219 | .Sy sun2 , |
220 | .Sy sun3 , | | 220 | .Sy sun3 , |
221 | .Sy vax , | | 221 | .Sy vax , |
222 | .Sy x68k | | 222 | .Sy x68k |
223 | .Ed | | 223 | .Ed |
224 | . | | 224 | . |
225 | . | | 225 | . |
226 | .It Fl n | | 226 | .It Fl n |
227 | Do not write to | | 227 | Do not write to |
228 | .Ar filesystem . | | 228 | .Ar filesystem . |
229 | . | | 229 | . |
230 | .It Fl o Ar options | | 230 | .It Fl o Ar options |
231 | Machine specific | | 231 | Machine specific |
232 | .Nm | | 232 | .Nm |
233 | options, comma separated. | | 233 | options, comma separated. |
234 | .Pp | | 234 | .Pp |
235 | Supported options are (with the machines for they are valid in brackets): | | 235 | Supported options are (with the machines for they are valid in brackets): |
236 | . | | 236 | . |
237 | .Bl -tag -offset indent -width alphasum | | 237 | .Bl -tag -offset indent -width alphasum |
238 | . | | 238 | . |
239 | .It Sy alphasum | | 239 | .It Sy alphasum |
240 | .Sy [ alpha ] | | 240 | .Sy [ alpha ] |
241 | Recalculate and restore the Alpha checksum. | | 241 | Recalculate and restore the Alpha checksum. |
242 | This is the default for | | 242 | This is the default for |
243 | .Nx Ns Tn /alpha . | | 243 | .Nx Ns Tn /alpha . |
244 | . | | 244 | . |
245 | .It Sy append | | 245 | .It Sy append |
246 | .Sy [ alpha , | | 246 | .Sy [ alpha , |
247 | .Sy pmax , | | 247 | .Sy pmax , |
248 | .Sy vax ] | | 248 | .Sy vax ] |
249 | Append | | 249 | Append |
250 | .Ar primary | | 250 | .Ar primary |
251 | to the end of | | 251 | to the end of |
252 | .Ar filesystem , | | 252 | .Ar filesystem , |
253 | which must be a regular file in this case. | | 253 | which must be a regular file in this case. |
254 | . | | 254 | . |
255 | .It Sy bootconf | | 255 | .It Sy bootconf |
256 | .Sy [ amd64 , | | 256 | .Sy [ amd64 , |
257 | .Sy i386 ] | | 257 | .Sy i386 ] |
258 | (Don't) read a | | 258 | (Don't) read a |
259 | .Dq boot.cfg | | 259 | .Dq boot.cfg |
260 | file. | | 260 | file. |
261 | . | | 261 | . |
262 | .It Sy command=\*[Lt]boot command\*[Gt] | | 262 | .It Sy command=\*[Lt]boot command\*[Gt] |
263 | .Sy [ amiga ] | | 263 | .Sy [ amiga ] |
264 | Modify the default boot command line. | | 264 | Modify the default boot command line. |
265 | . | | 265 | . |
266 | .It Sy console=\*[Lt]console name\*[Gt] | | 266 | .It Sy console=\*[Lt]console name\*[Gt] |
267 | .Sy [ amd64 , | | 267 | .Sy [ amd64 , |
268 | .Sy i386 ] | | 268 | .Sy i386 ] |
269 | Set the console device, \*[Lt]console name\*[Gt] must be one of: | | 269 | Set the console device, \*[Lt]console name\*[Gt] must be one of: |
270 | pc, com0, com1, com2, com3, com0kbd, com1kbd, com2kbd or com3kbd. | | 270 | pc, com0, com1, com2, com3, com0kbd, com1kbd, com2kbd or com3kbd. |
271 | . | | 271 | . |
272 | .It Sy ioaddr=\*[Lt]ioaddr\*[Gt] | | 272 | .It Sy ioaddr=\*[Lt]ioaddr\*[Gt] |
273 | .Sy [ amd64 , | | 273 | .Sy [ amd64 , |
274 | .Sy i386 ] | | 274 | .Sy i386 ] |
275 | Set the IO address to be used for the console serial port. | | 275 | Set the IO address to be used for the console serial port. |
276 | Defaults to the IO address used by the system BIOS for the specified port. | | 276 | Defaults to the IO address used by the system BIOS for the specified port. |
277 | . | | 277 | . |
278 | .It Sy keymap=\*[Lt]keymap\*[Gt] | | 278 | .It Sy keymap=\*[Lt]keymap\*[Gt] |
279 | .Sy [ amd64 , | | 279 | .Sy [ amd64 , |
280 | .Sy i386 ] | | 280 | .Sy i386 ] |
281 | Set a boot time keyboard translation map. | | 281 | Set a boot time keyboard translation map. |
282 | Each character in \*[Lt]keymap\*[Gt] will be replaced by the one following it. | | 282 | Each character in \*[Lt]keymap\*[Gt] will be replaced by the one following it. |
283 | For example, an argument of | | 283 | For example, an argument of |
284 | .Dq zyz | | 284 | .Dq zyz |
285 | would swap the lowercase letters | | 285 | would swap the lowercase letters |
286 | .Sq y | | 286 | .Sq y |
287 | and | | 287 | and |
288 | .Sq z . | | 288 | .Sq z . |
289 | . | | 289 | . |
290 | .It Sy modules | | 290 | .It Sy modules |
291 | .Sy [ amd64 , | | 291 | .Sy [ amd64 , |
292 | .Sy i386 ] | | 292 | .Sy i386 ] |
293 | (Don't) load kernel modules. | | 293 | (Don't) load kernel modules. |
294 | . | | 294 | . |
295 | .It Sy password=\*[Lt]password\*[Gt] | | 295 | .It Sy password=\*[Lt]password\*[Gt] |
296 | .Sy [ amd64 , | | 296 | .Sy [ amd64 , |
297 | .Sy i386 ] | | 297 | .Sy i386 ] |
298 | Set the password which must be entered before the boot menu can be accessed. | | 298 | Set the password which must be entered before the boot menu can be accessed. |
299 | . | | 299 | . |
300 | .It Sy resetvideo | | 300 | .It Sy resetvideo |
301 | .Sy [ amd64 , | | 301 | .Sy [ amd64 , |
302 | .Sy i386 ] | | 302 | .Sy i386 ] |
303 | Reset the video before booting. | | 303 | Reset the video before booting. |
304 | . | | 304 | . |
305 | .It Sy speed=\*[Lt]baud rate\*[Gt] | | 305 | .It Sy speed=\*[Lt]baud rate\*[Gt] |
306 | .Sy [ amd64 , | | 306 | .Sy [ amd64 , |
307 | .Sy i386 ] | | 307 | .Sy i386 ] |
308 | Set the baud rate for the serial console. | | 308 | Set the baud rate for the serial console. |
309 | If a value of zero is specified, then the current baud rate (set by the | | 309 | If a value of zero is specified, then the current baud rate (set by the |
310 | BIOS) will be used. | | 310 | BIOS) will be used. |
311 | . | | 311 | . |
312 | .It Sy sunsum | | 312 | .It Sy sunsum |
313 | .Sy [ alpha , | | 313 | .Sy [ alpha , |
314 | .Sy pmax , | | 314 | .Sy pmax , |
315 | .Sy vax ] | | 315 | .Sy vax ] |
316 | Recalculate and restore the Sun and | | 316 | Recalculate and restore the Sun and |
317 | .Nx Ns Tn /sparc | | 317 | .Nx Ns Tn /sparc |
318 | compatible checksum. | | 318 | compatible checksum. |
319 | .Em Note : | | 319 | .Em Note : |
320 | The existing | | 320 | The existing |
321 | .Nx Ns Tn /sparc | | 321 | .Nx Ns Tn /sparc |
322 | disklabel should use no more than 4 partitions. | | 322 | disklabel should use no more than 4 partitions. |
323 | . | | 323 | . |
324 | .It Sy timeout=\*[Lt]seconds\*[Gt] | | 324 | .It Sy timeout=\*[Lt]seconds\*[Gt] |
325 | .Sy [ amd64 , | | 325 | .Sy [ amd64 , |
326 | .Sy i386 ] | | 326 | .Sy i386 ] |
327 | Set the timeout before the automatic boot begins to the given number of seconds. | | 327 | Set the timeout before the automatic boot begins to the given number of seconds. |
328 | .El | | 328 | .El |
329 | . | | 329 | . |
330 | .It Fl t Ar fstype | | 330 | .It Fl t Ar fstype |
331 | Use | | 331 | Use |
332 | .Ar fstype | | 332 | .Ar fstype |
333 | as the type of | | 333 | as the type of |
334 | .Ar filesystem . | | 334 | .Ar filesystem . |
335 | The default operation is to attempt to auto-detect this setting. | | 335 | The default operation is to attempt to auto-detect this setting. |
336 | The following file system types are currently supported by | | 336 | The following file system types are currently supported by |
337 | .Nm : | | 337 | .Nm : |
338 | . | | 338 | . |
339 | .Bl -tag -offset indent -width raid | | 339 | .Bl -tag -offset indent -width raid |
340 | . | | 340 | . |
341 | .It Sy ffs | | 341 | .It Sy ffs |
342 | .Bx | | 342 | .Bx |
343 | Fast File System. | | 343 | Fast File System. |
344 | . | | 344 | . |
345 | .It Sy raid | | 345 | .It Sy raid |
346 | Mirrored RAIDframe File System. | | 346 | Mirrored RAIDframe File System. |
347 | . | | 347 | . |
348 | .It Sy raw | | 348 | .It Sy raw |
349 | .Sq Raw | | 349 | .Sq Raw |
350 | image. | | 350 | image. |
351 | Note: if a platform needs to hard-code the block offset of the secondary | | 351 | Note: if a platform needs to hard-code the block offset of the secondary |
352 | bootstrap, it cannot be searched for on this file system type, and must | | 352 | bootstrap, it cannot be searched for on this file system type, and must |
353 | be provided with | | 353 | be provided with |
354 | .Fl B Ar s2bno . | | 354 | .Fl B Ar s2bno . |
355 | .El | | 355 | .El |
356 | . | | 356 | . |
357 | .It Fl v | | 357 | .It Fl v |
358 | Verbose operation. | | 358 | Verbose operation. |
359 | . | | 359 | . |
360 | .It Ar filesystem | | 360 | .It Ar filesystem |
361 | The path name of the device or file system image that | | 361 | The path name of the device or file system image that |
362 | .Nm | | 362 | .Nm |
363 | is to operate on. | | 363 | is to operate on. |
364 | It is not necessary for | | 364 | It is not necessary for |
365 | .Ar filesystem | | 365 | .Ar filesystem |
366 | to be a currently mounted file system. | | 366 | to be a currently mounted file system. |
367 | . | | 367 | . |
368 | .It Ar primary | | 368 | .It Ar primary |
369 | The path name of the | | 369 | The path name of the |
370 | .Dq primary | | 370 | .Dq primary |
371 | boot block to install. | | 371 | boot block to install. |
372 | The path name must refer to a file in a file system that is currently | | 372 | The path name must refer to a file in a file system that is currently |
373 | mounted. | | 373 | mounted. |
374 | . | | 374 | . |
375 | .It Ar secondary | | 375 | .It Ar secondary |
376 | The path name of the | | 376 | The path name of the |
377 | .Dq secondary | | 377 | .Dq secondary |
378 | boot block, relative to the root of | | 378 | boot block, relative to the root of |
379 | the file system in the device or image specified by the | | 379 | the file system in the device or image specified by the |
380 | .Ar filesystem | | 380 | .Ar filesystem |
381 | argument. | | 381 | argument. |
382 | Note that this may refer to a file in a file system that is not mounted. | | 382 | Note that this may refer to a file in a file system that is not mounted. |
383 | Most systems require | | 383 | Most systems require |
384 | .Ar secondary | | 384 | .Ar secondary |
385 | to be in the | | 385 | to be in the |
386 | .Dq root | | 386 | .Dq root |
387 | directory of the file system, so the leading | | 387 | directory of the file system, so the leading |
388 | .Dq Pa / | | 388 | .Dq Pa / |
389 | is not necessary on | | 389 | is not necessary on |
390 | .Ar secondary . | | 390 | .Ar secondary . |
391 | .Pp | | 391 | .Pp |
392 | Only certain combinations of | | 392 | Only certain combinations of |
393 | platform | | 393 | platform |
394 | .Pq Fl m Ar machine | | 394 | .Pq Fl m Ar machine |
395 | and file system type | | 395 | and file system type |
396 | .Pq Fl t Ar fstype | | 396 | .Pq Fl t Ar fstype |
397 | require that the name of the secondary bootstrap is | | 397 | require that the name of the secondary bootstrap is |
398 | supplied as | | 398 | supplied as |
399 | .Ar secondary , | | 399 | .Ar secondary , |
400 | so that information such as the disk block numbers occupied | | 400 | so that information such as the disk block numbers occupied |
401 | by the secondary bootstrap can be stored in the primary bootstrap. | | 401 | by the secondary bootstrap can be stored in the primary bootstrap. |
402 | These are: | | 402 | These are: |
403 | .Bl -column "Platform" "File systems" -offset indent | | 403 | .Bl -column "Platform" "File systems" -offset indent |
404 | .It Sy "Platform" Ta Sy "File systems" | | 404 | .It Sy "Platform" Ta Sy "File systems" |
405 | .It macppc Ta ffs, raw | | 405 | .It macppc Ta ffs, raw |
406 | .It news68k Ta ffs, raw | | 406 | .It news68k Ta ffs, raw |
407 | .It newsmips Ta ffs, raw | | 407 | .It newsmips Ta ffs, raw |
408 | .It sparc Ta ffs, raid, raw | | 408 | .It sparc Ta ffs, raid, raw |
409 | .It sun2 Ta ffs, raw | | 409 | .It sun2 Ta ffs, raw |
410 | .It sun3 Ta ffs, raw | | 410 | .It sun3 Ta ffs, raw |
411 | .El | | 411 | .El |
412 | .El | | 412 | .El |
413 | .Pp | | 413 | .Pp |
414 | .Nm | | 414 | .Nm |
415 | exits 0 on success, and \*[Gt]0 if an error occurs. | | 415 | exits 0 on success, and \*[Gt]0 if an error occurs. |
416 | . | | 416 | . |
417 | .Sh ENVIRONMENT | | 417 | .Sh ENVIRONMENT |
418 | .Nm | | 418 | .Nm |
419 | uses the following environment variables: | | 419 | uses the following environment variables: |
420 | . | | 420 | . |
421 | .Bl -tag -width "MACHINE" | | 421 | .Bl -tag -width "MACHINE" |
422 | . | | 422 | . |
423 | .It Ev MACHINE | | 423 | .It Ev MACHINE |
424 | Default value for | | 424 | Default value for |
425 | .Ar machine , | | 425 | .Ar machine , |
426 | overriding the result from | | 426 | overriding the result from |
427 | .Xr uname 3 . | | 427 | .Xr uname 3 . |
428 | . | | 428 | . |
429 | .El | | 429 | .El |
430 | . | | 430 | . |
431 | .Sh FILES | | 431 | .Sh FILES |
432 | Most | | 432 | Most |
433 | .Nx | | 433 | .Nx |
434 | ports will contain variations of the following files: | | 434 | ports will contain variations of the following files: |
435 | .Pp | | 435 | .Pp |
436 | .Bl -tag -width /usr/mdec/bootxx_ustarfs | | 436 | .Bl -tag -width /usr/mdec/bootxx_ustarfs |
437 | . | | 437 | . |
438 | .It Pa /usr/mdec/bootxx_ Ns Sy FSTYPE | | 438 | .It Pa /usr/mdec/bootxx_ Ns Sy FSTYPE |
439 | Primary bootstrap for file system type | | 439 | Primary bootstrap for file system type |
440 | .Sy FSTYPE . | | 440 | .Sy FSTYPE . |
441 | Installed into the bootstrap area of the file system by | | 441 | Installed into the bootstrap area of the file system by |
442 | .Nm . | | 442 | .Nm . |
443 | . | | 443 | . |
444 | .It Pa /usr/mdec/bootxx_fat16 | | 444 | .It Pa /usr/mdec/bootxx_fat16 |
445 | Primary bootstrap for | | 445 | Primary bootstrap for |
446 | .Tn MS-DOS | | 446 | .Tn MS-DOS |
447 | .Sy FAT16 | | 447 | .Sy FAT16 |
448 | file systems. | | 448 | file systems. |
449 | This differs from | | 449 | This differs from |
450 | .Nm bootxx_msdos | | 450 | .Nm bootxx_msdos |
451 | in that it doesn't require the filesystem to have been initialised with | | 451 | in that it doesn't require the filesystem to have been initialised with |
452 | any | | 452 | any |
453 | .Ql reserved sectors . | | 453 | .Ql reserved sectors . |
454 | It also uses the information in the | | 454 | It also uses the information in the |
455 | .Ql Boot Parameter Block | | 455 | .Ql Boot Parameter Block |
456 | to get the media and filesytem properties. | | 456 | to get the media and filesytem properties. |
457 | The | | 457 | The |
458 | .Ql hidden sectors | | 458 | .Ql hidden sectors |
459 | field of the BPB must the offset of the partition in the disk. | | 459 | field of the BPB must be the offset of the partition in the disk. |
460 | This can be set using the | | 460 | This can be set using the |
461 | .Fl b Ar s1bno | | 461 | .Fl b Ar s1bno |
462 | option. | | 462 | option. |
463 | . | | 463 | . |
464 | .It Pa /usr/mdec/bootxx_ffsv1 | | 464 | .It Pa /usr/mdec/bootxx_ffsv1 |
465 | Primary bootstrap for | | 465 | Primary bootstrap for |
466 | .Sy FFSv1 | | 466 | .Sy FFSv1 |
467 | file systems | | 467 | file systems |
468 | (the | | 468 | (the |
469 | .Ql traditional | | 469 | .Ql traditional |
470 | file system prior to | | 470 | file system prior to |
471 | .Nx 6.0 ) . | | 471 | .Nx 6.0 ) . |
472 | Use | | 472 | Use |
473 | .Xr dumpfs 8 | | 473 | .Xr dumpfs 8 |
474 | to confirm the file system format is | | 474 | to confirm the file system format is |
475 | .Sy FFSv1 . | | 475 | .Sy FFSv1 . |
476 | . | | 476 | . |
477 | .It Pa /usr/mdec/bootxx_ffsv2 | | 477 | .It Pa /usr/mdec/bootxx_ffsv2 |
478 | Primary bootstrap for | | 478 | Primary bootstrap for |
479 | .Sy FFSv2 | | 479 | .Sy FFSv2 |
480 | file systems (the default file system for some platforms as of | | 480 | file systems (the default file system for some platforms as of |
481 | .Nx 6.0 ) . | | 481 | .Nx 6.0 ) . |
482 | Use | | 482 | Use |
483 | .Xr dumpfs 8 | | 483 | .Xr dumpfs 8 |
484 | to confirm the file system format is | | 484 | to confirm the file system format is |
485 | .Sy FFSv2 . | | 485 | .Sy FFSv2 . |
486 | . | | 486 | . |
487 | .It Pa /usr/mdec/bootxx_lfsv1 | | 487 | .It Pa /usr/mdec/bootxx_lfsv1 |
488 | Primary bootstrap for | | 488 | Primary bootstrap for |
489 | .Sy LFSv1 | | 489 | .Sy LFSv1 |
490 | file systems. | | 490 | file systems. |
491 | . | | 491 | . |
492 | .It Pa /usr/mdec/bootxx_lfsv2 | | 492 | .It Pa /usr/mdec/bootxx_lfsv2 |
493 | Primary bootstrap for | | 493 | Primary bootstrap for |
494 | .Sy LFSv2 | | 494 | .Sy LFSv2 |
495 | file systems | | 495 | file systems |
496 | (the default LFS version). | | 496 | (the default LFS version). |
497 | . | | 497 | . |
498 | .It Pa /usr/mdec/bootxx_msdos | | 498 | .It Pa /usr/mdec/bootxx_msdos |
499 | Primary bootstrap for | | 499 | Primary bootstrap for |
500 | .Tn MS-DOS | | 500 | .Tn MS-DOS |
501 | .Sy FAT | | 501 | .Sy FAT |
502 | file systems. | | 502 | file systems. |
503 | . | | 503 | . |
504 | .It Pa /usr/mdec/bootxx_ustarfs | | 504 | .It Pa /usr/mdec/bootxx_ustarfs |
505 | Primary bootstrap for | | 505 | Primary bootstrap for |
506 | .Sy TARFS | | 506 | .Sy TARFS |
507 | boot images. | | 507 | boot images. |
508 | This is used by various install media. | | 508 | This is used by various install media. |
509 | . | | 509 | . |
510 | .It Pa /usr/mdec/boot. Ns Sy MACHINE | | 510 | .It Pa /usr/mdec/boot. Ns Sy MACHINE |
511 | Secondary bootstrap for machine type | | 511 | Secondary bootstrap for machine type |
512 | .Sy MACHINE . | | 512 | .Sy MACHINE . |
513 | This should be installed into the file system before | | 513 | This should be installed into the file system before |
514 | .Nm | | 514 | .Nm |
515 | is run. | | 515 | is run. |
516 | . | | 516 | . |
517 | .It Pa /usr/mdec/boot | | 517 | .It Pa /usr/mdec/boot |
518 | Synonym for | | 518 | Synonym for |
519 | .Pa /usr/mdec/boot. Ns Sy MACHINE | | 519 | .Pa /usr/mdec/boot. Ns Sy MACHINE |
520 | . | | 520 | . |
521 | .It Pa /boot. Ns Sy MACHINE | | 521 | .It Pa /boot. Ns Sy MACHINE |
522 | Installed copy of secondary bootstrap for machine type | | 522 | Installed copy of secondary bootstrap for machine type |
523 | .Sy MACHINE . | | 523 | .Sy MACHINE . |
524 | . | | 524 | . |
525 | .It Pa /boot | | 525 | .It Pa /boot |
526 | Installed copy of secondary bootstrap. | | 526 | Installed copy of secondary bootstrap. |
527 | Searched for by the primary bootstrap if | | 527 | Searched for by the primary bootstrap if |
528 | .Pa /boot. Ns Sy MACHINE | | 528 | .Pa /boot. Ns Sy MACHINE |
529 | is not found. | | 529 | is not found. |
530 | . | | 530 | . |
531 | .El | | 531 | .El |
532 | . | | 532 | . |
533 | .Ss Nx Ns Tn /hp700 files | | 533 | .Ss Nx Ns Tn /hp700 files |
534 | . | | 534 | . |
535 | .Bl -tag -width /usr/mdec/bootxx_ustarfs | | 535 | .Bl -tag -width /usr/mdec/bootxx_ustarfs |
536 | . | | 536 | . |
537 | .It Pa /usr/mdec/xxboot | | 537 | .It Pa /usr/mdec/xxboot |
538 | .Nx Ns Tn /hp700 | | 538 | .Nx Ns Tn /hp700 |
539 | primary bootstrap for | | 539 | primary bootstrap for |
540 | .Sy FFSv1 , | | 540 | .Sy FFSv1 , |
541 | .Sy FFSv2 , | | 541 | .Sy FFSv2 , |
542 | .Sy LFSv1 , | | 542 | .Sy LFSv1 , |
543 | and | | 543 | and |
544 | .Sy LFSv2 . | | 544 | .Sy LFSv2 . |
545 | .It Pa /usr/mdec/cdboot | | 545 | .It Pa /usr/mdec/cdboot |
546 | .Nx Ns Tn /hp700 | | 546 | .Nx Ns Tn /hp700 |
547 | primary bootstrap for ISO 9660 file system. | | 547 | primary bootstrap for ISO 9660 file system. |
548 | .It Pa /usr/mdec/sdboot | | 548 | .It Pa /usr/mdec/sdboot |
549 | Synonym for | | 549 | Synonym for |
550 | .Pa /usr/mdec/xxboot | | 550 | .Pa /usr/mdec/xxboot |
551 | . | | 551 | . |
552 | .El | | 552 | .El |
553 | . | | 553 | . |
554 | .Ss Nx Ns Tn /macppc files | | 554 | .Ss Nx Ns Tn /macppc files |
555 | . | | 555 | . |
556 | .Bl -tag -width /usr/mdec/bootxx_ustarfs | | 556 | .Bl -tag -width /usr/mdec/bootxx_ustarfs |
557 | . | | 557 | . |
558 | .It Pa /usr/mdec/bootxx | | 558 | .It Pa /usr/mdec/bootxx |
559 | .Nx Ns Tn /macppc | | 559 | .Nx Ns Tn /macppc |
560 | primary bootstrap. | | 560 | primary bootstrap. |
561 | . | | 561 | . |
562 | .It Pa /usr/mdec/ofwboot | | 562 | .It Pa /usr/mdec/ofwboot |
563 | .Nx Ns Tn /macppc | | 563 | .Nx Ns Tn /macppc |
564 | secondary bootstrap. | | 564 | secondary bootstrap. |
565 | . | | 565 | . |
566 | .It Pa /ofwboot | | 566 | .It Pa /ofwboot |
567 | Installed copy of | | 567 | Installed copy of |
568 | .Nx Ns Tn /macppc | | 568 | .Nx Ns Tn /macppc |
569 | secondary bootstrap. | | 569 | secondary bootstrap. |
570 | . | | 570 | . |
571 | .El | | 571 | .El |
572 | . | | 572 | . |
573 | .Ss Nx Ns Tn /next68k files | | 573 | .Ss Nx Ns Tn /next68k files |
574 | . | | 574 | . |
575 | .Bl -tag -width /usr/mdec/bootxx_ustarfs | | 575 | .Bl -tag -width /usr/mdec/bootxx_ustarfs |
576 | . | | 576 | . |
577 | .It Pa /usr/mdec/boot | | 577 | .It Pa /usr/mdec/boot |
578 | .Nx Ns Tn /next68k | | 578 | .Nx Ns Tn /next68k |
579 | bootstrap. | | 579 | bootstrap. |
580 | . | | 580 | . |
581 | .El | | 581 | .El |
582 | . | | 582 | . |
583 | .Ss Nx Ns Tn /sparc64 files | | 583 | .Ss Nx Ns Tn /sparc64 files |
584 | . | | 584 | . |
585 | .Bl -tag -width /usr/mdec/bootxx_ustarfs | | 585 | .Bl -tag -width /usr/mdec/bootxx_ustarfs |
586 | . | | 586 | . |
587 | .It Pa /usr/mdec/bootblk | | 587 | .It Pa /usr/mdec/bootblk |
588 | .Nx Ns Tn /sparc64 | | 588 | .Nx Ns Tn /sparc64 |
589 | primary bootstrap. | | 589 | primary bootstrap. |
590 | . | | 590 | . |
591 | .It Pa /usr/mdec/ofwboot | | 591 | .It Pa /usr/mdec/ofwboot |
592 | .Nx Ns Tn /sparc64 | | 592 | .Nx Ns Tn /sparc64 |
593 | secondary bootstrap. | | 593 | secondary bootstrap. |
594 | . | | 594 | . |
595 | .It Pa /ofwboot | | 595 | .It Pa /ofwboot |
596 | Installed copy of | | 596 | Installed copy of |
597 | .Nx Ns Tn /sparc64 | | 597 | .Nx Ns Tn /sparc64 |
598 | secondary bootstrap. | | 598 | secondary bootstrap. |
599 | . | | 599 | . |
600 | .El | | 600 | .El |
601 | . | | 601 | . |
602 | .Sh EXAMPLES | | 602 | .Sh EXAMPLES |
603 | . | | 603 | . |
604 | .Ss common | | 604 | .Ss common |
605 | Verbosely install the Berkeley Fast File System primary bootstrap on to disk | | 605 | Verbosely install the Berkeley Fast File System primary bootstrap on to disk |
606 | .Sq sd0 : | | 606 | .Sq sd0 : |
607 | .Dl Ic installboot -v /dev/rsd0c /usr/mdec/bootxx_ffs | | 607 | .Dl Ic installboot -v /dev/rsd0c /usr/mdec/bootxx_ffs |
608 | Note: the | | 608 | Note: the |
609 | .Dq whole disk | | 609 | .Dq whole disk |
610 | partition (c on some ports, d on others) is used here, since the a partition | | 610 | partition (c on some ports, d on others) is used here, since the a partition |
611 | probably is already opened (mounted as | | 611 | probably is already opened (mounted as |
612 | .Pa / ) , | | 612 | .Pa / ) , |
613 | so | | 613 | so |
614 | .Nm | | 614 | .Nm |
615 | would not be able to access it. | | 615 | would not be able to access it. |
616 | .Pp | | 616 | .Pp |
617 | Remove the primary bootstrap from disk | | 617 | Remove the primary bootstrap from disk |
618 | .Sq sd1 : | | 618 | .Sq sd1 : |
619 | .Dl Ic installboot -c /dev/rsd1c | | 619 | .Dl Ic installboot -c /dev/rsd1c |
620 | . | | 620 | . |
621 | .Ss Nx Ns Tn /amiga | | 621 | .Ss Nx Ns Tn /amiga |
622 | Modify the command line to change the default from "netbsd -ASn2" to | | 622 | Modify the command line to change the default from "netbsd -ASn2" to |
623 | "netbsd -S": | | 623 | "netbsd -S": |
624 | .Dl Ic installboot -m amiga -o command="netbsd -S" /dev/rsd0a /usr/mdec/bootxx_ffs | | 624 | .Dl Ic installboot -m amiga -o command="netbsd -S" /dev/rsd0a /usr/mdec/bootxx_ffs |
625 | . | | 625 | . |
626 | .Ss Nx Ns Tn /ews4800mips | | 626 | .Ss Nx Ns Tn /ews4800mips |
627 | Install the System V Boot File System primary bootstrap on to disk | | 627 | Install the System V Boot File System primary bootstrap on to disk |
628 | .Sq sd0 , | | 628 | .Sq sd0 , |
629 | with the secondary bootstrap | | 629 | with the secondary bootstrap |
630 | .Sq Pa /boot | | 630 | .Sq Pa /boot |
631 | already present in the SysVBFS partition on the disk: | | 631 | already present in the SysVBFS partition on the disk: |
632 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx_bfs | | 632 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx_bfs |
633 | . | | 633 | . |
634 | .Ss Nx Ns Tn /i386 and Nx Ns Tn /amd64 | | 634 | .Ss Nx Ns Tn /i386 and Nx Ns Tn /amd64 |
635 | Install new boot blocks on an existing | | 635 | Install new boot blocks on an existing |
636 | .Sy FFSv2 | | 636 | .Sy FFSv2 |
637 | mounted root file system on | | 637 | mounted root file system on |
638 | .Sq wd0 , | | 638 | .Sq wd0 , |
639 | setting the timeout to five seconds, after copying a new secondary | | 639 | setting the timeout to five seconds, after copying a new secondary |
640 | bootstrap: | | 640 | bootstrap: |
641 | .Dl Ic cp /usr/mdec/boot /boot | | 641 | .Dl Ic cp /usr/mdec/boot /boot |
642 | .Dl Ic installboot -v -o timeout=5 /dev/rwd0a /usr/mdec/bootxx_ffsv2 | | 642 | .Dl Ic installboot -v -o timeout=5 /dev/rwd0a /usr/mdec/bootxx_ffsv2 |
643 | .Bd -ragged -offset indent-two -compact | | 643 | .Bd -ragged -offset indent-two -compact |
644 | .Em Note : | | 644 | .Em Note : |
645 | Pre | | 645 | Pre |
646 | .Nx 6.0 | | 646 | .Nx 6.0 |
647 | systems used | | 647 | systems used |
648 | .Sy FFSv1 | | 648 | .Sy FFSv1 |
649 | file systems on these platforms; double check with | | 649 | file systems on these platforms; double check with |
650 | .Xr dumpfs 8 | | 650 | .Xr dumpfs 8 |
651 | to be sure to use the correct secondary bootstrap. | | 651 | to be sure to use the correct secondary bootstrap. |
652 | .Ed | | 652 | .Ed |
653 | .Pp | | 653 | .Pp |
654 | Create a bootable CD-ROM with an ISO 9660 | | 654 | Create a bootable CD-ROM with an ISO 9660 |
655 | file system for an i386 system with a serial console: | | 655 | file system for an i386 system with a serial console: |
656 | .Dl Ic mkdir cdrom | | 656 | .Dl Ic mkdir cdrom |
657 | .Dl Ic cp sys/arch/i386/compile/mykernel/netbsd cdrom/netbsd | | 657 | .Dl Ic cp sys/arch/i386/compile/mykernel/netbsd cdrom/netbsd |
658 | .Dl Ic cp /usr/mdec/boot cdrom/boot | | 658 | .Dl Ic cp /usr/mdec/boot cdrom/boot |
659 | .Dl Ic cp /usr/mdec/bootxx_cd9660 bootxx | | 659 | .Dl Ic cp /usr/mdec/bootxx_cd9660 bootxx |
660 | .Dl Ic installboot -o console=com0,speed=19200 -m i386 -e bootxx | | 660 | .Dl Ic installboot -o console=com0,speed=19200 -m i386 -e bootxx |
661 | .Dl Ic makefs -t cd9660 -o 'bootimage=i386;bootxx,no-emul-boot' boot.iso \ | | 661 | .Dl Ic makefs -t cd9660 -o 'bootimage=i386;bootxx,no-emul-boot' boot.iso \ |
662 | cdrom | | 662 | cdrom |
663 | . | | 663 | . |
664 | .Pp | | 664 | .Pp |
665 | Create a bootable floppy disk with an FFSv1 | | 665 | Create a bootable floppy disk with an FFSv1 |
666 | file system for a small custom kernel (note: bigger kernels needing | | 666 | file system for a small custom kernel (note: bigger kernels needing |
667 | multiple disks are handled with the ustarfs file system): | | 667 | multiple disks are handled with the ustarfs file system): |
668 | .Dl Ic newfs -s 1440k /dev/rfd0a | | 668 | .Dl Ic newfs -s 1440k /dev/rfd0a |
669 | .Bd -ragged -offset indent-two -compact | | 669 | .Bd -ragged -offset indent-two -compact |
670 | .Em Note : | | 670 | .Em Note : |
671 | Ignore the warnings that | | 671 | Ignore the warnings that |
672 | .Xr newfs 8 | | 672 | .Xr newfs 8 |
673 | displays; it can not write a disklabel, | | 673 | displays; it can not write a disklabel, |
674 | which is not a problem for a floppy disk. | | 674 | which is not a problem for a floppy disk. |
675 | .Ed | | 675 | .Ed |
676 | .Dl Ic mount /dev/fd0a /mnt | | 676 | .Dl Ic mount /dev/fd0a /mnt |
677 | .Dl Ic cp /usr/mdec/boot /mnt/boot | | 677 | .Dl Ic cp /usr/mdec/boot /mnt/boot |
678 | .Dl Ic gzip -9 \*[Lt] sys/arch/i386/compile/mykernel/netbsd \*[Gt] /mnt/netbsd.gz | | 678 | .Dl Ic gzip -9 \*[Lt] sys/arch/i386/compile/mykernel/netbsd \*[Gt] /mnt/netbsd.gz |
679 | .Dl Ic umount /mnt | | 679 | .Dl Ic umount /mnt |
680 | .Dl Ic installboot -v /dev/rfd0a /usr/mdec/bootxx_ffsv1 | | 680 | .Dl Ic installboot -v /dev/rfd0a /usr/mdec/bootxx_ffsv1 |
681 | . | | 681 | . |
682 | .Pp | | 682 | .Pp |
683 | Create a bootable FAT file system on | | 683 | Create a bootable FAT file system on |
684 | .Sq wd1a , | | 684 | .Sq wd1a , |
685 | which should have the same offset and size as a FAT primary partition | | 685 | which should have the same offset and size as a FAT primary partition |
686 | in the Master Boot Record (MBR): | | 686 | in the Master Boot Record (MBR): |
687 | .Dl Ic newfs_msdos -r 16 /dev/rwd1a | | 687 | .Dl Ic newfs_msdos -r 16 /dev/rwd1a |
688 | .Bd -ragged -offset indent-two -compact | | 688 | .Bd -ragged -offset indent-two -compact |
689 | .Em Notes : | | 689 | .Em Notes : |
690 | The | | 690 | The |
691 | .Fl r Ar 16 | | 691 | .Fl r Ar 16 |
692 | is to reserve space for the primary bootstrap. | | 692 | is to reserve space for the primary bootstrap. |
693 | .Xr newfs_msdos 8 | | 693 | .Xr newfs_msdos 8 |
694 | will display an | | 694 | will display an |
695 | .Dq MBR type | | 695 | .Dq MBR type |
696 | such as | | 696 | such as |
697 | .Ql 1 , | | 697 | .Ql 1 , |
698 | .Ql 4 , | | 698 | .Ql 4 , |
699 | or | | 699 | or |
700 | .Ql 6 ; | | 700 | .Ql 6 ; |
701 | the MBR partition type of the appropriate primary partition should be | | 701 | the MBR partition type of the appropriate primary partition should be |
702 | changed to this value. | | 702 | changed to this value. |
703 | .Ed | | 703 | .Ed |
704 | .Dl Ic mount -t msdos /dev/wd1a /mnt | | 704 | .Dl Ic mount -t msdos /dev/wd1a /mnt |
705 | .Dl Ic cp /usr/mdec/boot /mnt/boot | | 705 | .Dl Ic cp /usr/mdec/boot /mnt/boot |
706 | .Dl Ic cp path/to/kernel /mnt/netbsd | | 706 | .Dl Ic cp path/to/kernel /mnt/netbsd |
707 | .Dl Ic umount /mnt | | 707 | .Dl Ic umount /mnt |
708 | .Dl Ic installboot -t raw /dev/rwd1a /usr/mdec/bootxx_msdos | | 708 | .Dl Ic installboot -t raw /dev/rwd1a /usr/mdec/bootxx_msdos |
709 | .Pp | | 709 | .Pp |
710 | Make the existing FAT16 filesystem on | | 710 | Make the existing FAT16 filesystem on |
711 | .Sq sd0e | | 711 | .Sq sd0e |
712 | bootable. | | 712 | bootable. |
713 | This can be used to make USB memory bootable provided it has 512 byte | | 713 | This can be used to make USB memory bootable provided it has 512 byte |
714 | sectors and that the manufacturer correctly initialised the file system. | | 714 | sectors and that the manufacturer correctly initialised the file system. |
715 | .Dl Ic mount -t msdos /dev/sd0e /mnt | | 715 | .Dl Ic mount -t msdos /dev/sd0e /mnt |
716 | .Dl Ic cp /usr/mdec/boot /mnt/boot | | 716 | .Dl Ic cp /usr/mdec/boot /mnt/boot |
717 | .Dl Ic cp path/to/kernel /mnt/netbsd | | 717 | .Dl Ic cp path/to/kernel /mnt/netbsd |
718 | .Dl Ic umount /mnt | | 718 | .Dl Ic umount /mnt |
719 | .Dl Ic installboot /dev/rsd0e /usr/mdec/bootxx_fat16 | | 719 | .Dl Ic installboot /dev/rsd0e /usr/mdec/bootxx_fat16 |
720 | It may also be necessary to use | | 720 | It may also be necessary to use |
721 | .Nm fdisk | | 721 | .Nm fdisk |
722 | to make the device itself bootable. | | 722 | to make the device itself bootable. |
723 | . | | 723 | . |
724 | .Pp | | 724 | .Pp |
725 | Switch the existing installed bootstrap to use a serial console without | | 725 | Switch the existing installed bootstrap to use a serial console without |
726 | reinstalling or altering other options such as timeout. | | 726 | reinstalling or altering other options such as timeout. |
727 | .Dl Ic installboot -e -o console=com0 /dev/rwd0a | | 727 | .Dl Ic installboot -e -o console=com0 /dev/rwd0a |
728 | .Ss Nx Ns Tn /macppc | | 728 | .Ss Nx Ns Tn /macppc |
729 | Note the | | 729 | Note the |
730 | .Nm | | 730 | .Nm |
731 | utility is only required for macppc machines with OpenFirmware version 2 | | 731 | utility is only required for macppc machines with OpenFirmware version 2 |
732 | to boot. | | 732 | to boot. |
733 | OpenFirmware 3 cannot load bootblocks specified in the Apple partition | | 733 | OpenFirmware 3 cannot load bootblocks specified in the Apple partition |
734 | map. | | 734 | map. |
735 | .Pp | | 735 | .Pp |
736 | Install the Berkeley Fast File System primary bootstrap on to disk | | 736 | Install the Berkeley Fast File System primary bootstrap on to disk |
737 | .Sq wd0 : | | 737 | .Sq wd0 : |
738 | .Dl Ic installboot /dev/rwd0c /usr/mdec/bootxx /ofwboot | | 738 | .Dl Ic installboot /dev/rwd0c /usr/mdec/bootxx /ofwboot |
739 | .Pp | | 739 | .Pp |
740 | The secondary | | 740 | The secondary |
741 | .Nx Ns Tn /macppc | | 741 | .Nx Ns Tn /macppc |
742 | bootstrap is located in | | 742 | bootstrap is located in |
743 | .Pa /usr/mdec/ofwboot . | | 743 | .Pa /usr/mdec/ofwboot . |
744 | .Pp | | 744 | .Pp |
745 | The primary bootstrap requires the raw | | 745 | The primary bootstrap requires the raw |
746 | .Pa ofwboot | | 746 | .Pa ofwboot |
747 | for the secondary bootstrap, not | | 747 | for the secondary bootstrap, not |
748 | .Pa ofwboot.xcf , | | 748 | .Pa ofwboot.xcf , |
749 | which is used for the OpenFirmware to load kernels. | | 749 | which is used for the OpenFirmware to load kernels. |
750 | .Ss Nx Ns Tn /next68k | | 750 | .Ss Nx Ns Tn /next68k |
751 | Install the bootstrap on to disk | | 751 | Install the bootstrap on to disk |
752 | .Sq sd0 : | | 752 | .Sq sd0 : |
753 | .Dl Ic installboot /dev/rsd0c /usr/mdec/boot | | 753 | .Dl Ic installboot /dev/rsd0c /usr/mdec/boot |
754 | .Pp | | 754 | .Pp |
755 | . | | 755 | . |
756 | .Ss Nx Ns Tn /pmax | | 756 | .Ss Nx Ns Tn /pmax |
757 | Install the Berkeley Fast File System primary bootstrap on to disk | | 757 | Install the Berkeley Fast File System primary bootstrap on to disk |
758 | .Sq sd0 : | | 758 | .Sq sd0 : |
759 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx_ffs | | 759 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx_ffs |
760 | .Pp | | 760 | .Pp |
761 | .Nx Ns Tn /pmax | | 761 | .Nx Ns Tn /pmax |
762 | requires that this file system starts at block 0 of the disk. | | 762 | requires that this file system starts at block 0 of the disk. |
763 | .Pp | | 763 | .Pp |
764 | Install the ISO 9660 primary bootstrap in the file | | 764 | Install the ISO 9660 primary bootstrap in the file |
765 | .Pa /tmp/cd-image : | | 765 | .Pa /tmp/cd-image : |
766 | .Dl Ic installboot -m pmax /tmp/cd-image /usr/mdec/bootxx_cd9660 | | 766 | .Dl Ic installboot -m pmax /tmp/cd-image /usr/mdec/bootxx_cd9660 |
767 | .Pp | | 767 | .Pp |
768 | Make an ISO 9660 filesystem in the file | | 768 | Make an ISO 9660 filesystem in the file |
769 | .Pa /tmp/cd-image | | 769 | .Pa /tmp/cd-image |
770 | and install the ISO 9660 primary bootstrap in the filesystem, where the | | 770 | and install the ISO 9660 primary bootstrap in the filesystem, where the |
771 | source directory for the ISO 9660 filesystem contains a kernel, the | | 771 | source directory for the ISO 9660 filesystem contains a kernel, the |
772 | primary bootstrap | | 772 | primary bootstrap |
773 | .Pa bootxx_cd9660 | | 773 | .Pa bootxx_cd9660 |
774 | and the secondary bootstrap | | 774 | and the secondary bootstrap |
775 | .Pa boot.pmax : | | 775 | .Pa boot.pmax : |
776 | .Dl Ic mkisofs -o /tmp/cd-image -a -l -v iso-source-dir | | 776 | .Dl Ic mkisofs -o /tmp/cd-image -a -l -v iso-source-dir |
777 | .Dl ... | | 777 | .Dl ... |
778 | .Dl 48 51 iso-source-dir/bootxx_cd9660 | | 778 | .Dl 48 51 iso-source-dir/bootxx_cd9660 |
779 | .Dl ... | | 779 | .Dl ... |
780 | .Dl Ic installboot -b `expr 48 \e* 4` /tmp/cd-image /usr/mdec/bootxx_cd9660 | | 780 | .Dl Ic installboot -b `expr 48 \e* 4` /tmp/cd-image /usr/mdec/bootxx_cd9660 |
781 | . | | 781 | . |
782 | .Ss Nx Ns Tn /sparc | | 782 | .Ss Nx Ns Tn /sparc |
783 | Install the Berkeley Fast File System primary bootstrap on to disk | | 783 | Install the Berkeley Fast File System primary bootstrap on to disk |
784 | .Sq sd0 , | | 784 | .Sq sd0 , |
785 | with the secondary bootstrap | | 785 | with the secondary bootstrap |
786 | .Sq Pa /boot | | 786 | .Sq Pa /boot |
787 | already present: | | 787 | already present: |
788 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx /boot | | 788 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx /boot |
789 | . | | 789 | . |
790 | .Ss Nx Ns Tn /sparc64 | | 790 | .Ss Nx Ns Tn /sparc64 |
791 | Install the primary bootstrap on to disk | | 791 | Install the primary bootstrap on to disk |
792 | .Sq sd0 : | | 792 | .Sq sd0 : |
793 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootblk | | 793 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootblk |
794 | .Pp | | 794 | .Pp |
795 | The secondary | | 795 | The secondary |
796 | .Nx Ns Tn /sparc64 | | 796 | .Nx Ns Tn /sparc64 |
797 | bootstrap is located in | | 797 | bootstrap is located in |
798 | .Pa /usr/mdec/ofwboot . | | 798 | .Pa /usr/mdec/ofwboot . |
799 | . | | 799 | . |
800 | .Ss Nx Ns Tn /sun2 and Nx Ns Tn /sun3 | | 800 | .Ss Nx Ns Tn /sun2 and Nx Ns Tn /sun3 |
801 | Install the Berkeley Fast File System primary bootstrap on to disk | | 801 | Install the Berkeley Fast File System primary bootstrap on to disk |
802 | .Sq sd0 , | | 802 | .Sq sd0 , |
803 | with the secondary bootstrap | | 803 | with the secondary bootstrap |
804 | .Sq Pa /boot | | 804 | .Sq Pa /boot |
805 | already present: | | 805 | already present: |
806 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx /boot | | 806 | .Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx /boot |
807 | . | | 807 | . |
808 | .Sh SEE ALSO | | 808 | .Sh SEE ALSO |
809 | .Xr uname 3 , | | 809 | .Xr uname 3 , |
810 | .Xr boot 8 , | | 810 | .Xr boot 8 , |
811 | .Xr disklabel 8 , | | 811 | .Xr disklabel 8 , |
812 | .Xr dumpfs 8 , | | 812 | .Xr dumpfs 8 , |
813 | .Xr fdisk 8 , | | 813 | .Xr fdisk 8 , |
814 | .Xr pxeboot 8 | | 814 | .Xr pxeboot 8 |
815 | . | | 815 | . |
816 | .Sh HISTORY | | 816 | .Sh HISTORY |
817 | This implementation of | | 817 | This implementation of |
818 | .Nm | | 818 | .Nm |
819 | appeared in | | 819 | appeared in |
820 | .Nx 1.6 . | | 820 | .Nx 1.6 . |
821 | . | | 821 | . |
822 | .Sh AUTHORS | | 822 | .Sh AUTHORS |
823 | The machine independent portion of this implementation of | | 823 | The machine independent portion of this implementation of |
824 | .Nm | | 824 | .Nm |
825 | was written by Luke Mewburn. | | 825 | was written by Luke Mewburn. |
826 | The following people contributed to the various machine dependent | | 826 | The following people contributed to the various machine dependent |
827 | back-ends: | | 827 | back-ends: |
828 | Simon Burge (pmax), | | 828 | Simon Burge (pmax), |
829 | Chris Demetriou (alpha), | | 829 | Chris Demetriou (alpha), |
830 | Matthew Fredette (sun2, sun3), | | 830 | Matthew Fredette (sun2, sun3), |
831 | Matthew Green (sparc64), | | 831 | Matthew Green (sparc64), |
832 | Ross Harvey (alpha), | | 832 | Ross Harvey (alpha), |
833 | Michael Hitch (amiga), | | 833 | Michael Hitch (amiga), |
834 | Paul Kranenburg (sparc), | | 834 | Paul Kranenburg (sparc), |
835 | David Laight (i386), | | 835 | David Laight (i386), |
836 | Christian Limpach (next68k), | | 836 | Christian Limpach (next68k), |
837 | Luke Mewburn (macppc), | | 837 | Luke Mewburn (macppc), |
838 | Matt Thomas (vax), | | 838 | Matt Thomas (vax), |
839 | Izumi Tsutsui (news68k, newsmips), | | 839 | Izumi Tsutsui (news68k, newsmips), |
840 | and | | 840 | and |
841 | UCHIYAMA Yasushi (ews4800mips). | | 841 | UCHIYAMA Yasushi (ews4800mips). |
842 | . | | 842 | . |
843 | .Sh BUGS | | 843 | .Sh BUGS |
844 | There are not currently primary bootstraps to support all file systems | | 844 | There are not currently primary bootstraps to support all file systems |
845 | types which are capable of being the root file system. | | 845 | types which are capable of being the root file system. |
846 | .Pp | | 846 | .Pp |
847 | If a disk has been converted from | | 847 | If a disk has been converted from |
848 | .Sy FFS | | 848 | .Sy FFS |
849 | to | | 849 | to |
850 | .Sy RAID | | 850 | .Sy RAID |
851 | without the contents of the disk erased, then the original | | 851 | without the contents of the disk erased, then the original |
852 | .Sy FFS | | 852 | .Sy FFS |
853 | installation may be auto-detected instead of the | | 853 | installation may be auto-detected instead of the |
854 | .Sy RAID | | 854 | .Sy RAID |
855 | installation. | | 855 | installation. |
856 | In this case, the | | 856 | In this case, the |
857 | .Fl t Ar raid | | 857 | .Fl t Ar raid |
858 | option must be provided. | | 858 | option must be provided. |
859 | . | | 859 | . |
860 | .Ss Nx Ns Tn /alpha | | 860 | .Ss Nx Ns Tn /alpha |
861 | The | | 861 | The |
862 | .Nx Ns Tn /alpha | | 862 | .Nx Ns Tn /alpha |
863 | primary bootstrap program can only load the secondary bootstrap program | | 863 | primary bootstrap program can only load the secondary bootstrap program |
864 | from file systems starting at the beginning (block 0) of disks. | | 864 | from file systems starting at the beginning (block 0) of disks. |
865 | Similarly, the secondary bootstrap program can only load kernels from | | 865 | Similarly, the secondary bootstrap program can only load kernels from |
866 | file systems starting at the beginning of disks. | | 866 | file systems starting at the beginning of disks. |
867 | .Pp | | 867 | .Pp |
868 | The size of primary bootstrap programs is restricted to 7.5KB, even | | 868 | The size of primary bootstrap programs is restricted to 7.5KB, even |
869 | though some file systems (e.g., ISO 9660) are able to accommodate larger | | 869 | though some file systems (e.g., ISO 9660) are able to accommodate larger |
870 | ones. | | 870 | ones. |
871 | . | | 871 | . |
872 | .Ss Nx Ns Tn /hp300 | | 872 | .Ss Nx Ns Tn /hp300 |
873 | The disk must have a boot partition large enough to hold the bootstrap code. | | 873 | The disk must have a boot partition large enough to hold the bootstrap code. |
874 | Currently the primary bootstrap must be a LIF format file. | | 874 | Currently the primary bootstrap must be a LIF format file. |
875 | . | | 875 | . |
876 | .Ss Nx Ns Tn /i386 and Nx Ns Tn /amd64 | | 876 | .Ss Nx Ns Tn /i386 and Nx Ns Tn /amd64 |
877 | The bootstrap must be installed in the | | 877 | The bootstrap must be installed in the |
878 | .Nx | | 878 | .Nx |
879 | partition that starts at the beginning of the mbr partition. | | 879 | partition that starts at the beginning of the mbr partition. |
880 | If that is a valid filesystem and contains the | | 880 | If that is a valid filesystem and contains the |
881 | .Pa /boot | | 881 | .Pa /boot |
882 | program then it will be used as the root filesystem, otherwise the | | 882 | program then it will be used as the root filesystem, otherwise the |
883 | .Sq a | | 883 | .Sq a |
884 | partition will be booted. | | 884 | partition will be booted. |
885 | .Pp | | 885 | .Pp |
886 | The size of primary bootstrap programs is restricted to 8KB, even | | 886 | The size of primary bootstrap programs is restricted to 8KB, even |
887 | though some file systems (e.g., ISO 9660) are able to accommodate larger | | 887 | though some file systems (e.g., ISO 9660) are able to accommodate larger |
888 | ones. | | 888 | ones. |
889 | . | | 889 | . |
890 | .Ss Nx Ns Tn /macppc | | 890 | .Ss Nx Ns Tn /macppc |
891 | Due to restrictions in | | 891 | Due to restrictions in |
892 | .Nm | | 892 | .Nm |
893 | and the secondary bootstrap implementation, file systems where kernels exist | | 893 | and the secondary bootstrap implementation, file systems where kernels exist |
894 | must start at the beginning of disks. | | 894 | must start at the beginning of disks. |
895 | .Pp | | 895 | .Pp |
896 | Currently, | | 896 | Currently, |
897 | .Nm | | 897 | .Nm |
898 | doesn't recognize an existing Apple partition map on the disk | | 898 | doesn't recognize an existing Apple partition map on the disk |
899 | and always writes a faked map to make disks bootable. | | 899 | and always writes a faked map to make disks bootable. |
900 | .Pp | | 900 | .Pp |
901 | The | | 901 | The |
902 | .Nx Ns Tn /macppc | | 902 | .Nx Ns Tn /macppc |
903 | bootstrap program can't load kernels from | | 903 | bootstrap program can't load kernels from |
904 | .Sy FFSv2 | | 904 | .Sy FFSv2 |
905 | partitions. | | 905 | partitions. |
906 | .Ss Nx Ns Tn /next68k | | 906 | .Ss Nx Ns Tn /next68k |
907 | The size of bootstrap programs is restricted to the free space before | | 907 | The size of bootstrap programs is restricted to the free space before |
908 | the file system at the beginning of the disk minus 8KB. | | 908 | the file system at the beginning of the disk minus 8KB. |
909 | . | | 909 | . |
910 | .Ss Nx Ns Tn /pmax | | 910 | .Ss Nx Ns Tn /pmax |
911 | The | | 911 | The |
912 | .Nx Ns Tn /pmax | | 912 | .Nx Ns Tn /pmax |
913 | secondary bootstrap program can only load kernels from file | | 913 | secondary bootstrap program can only load kernels from file |
914 | systems starting at the beginning of disks. | | 914 | systems starting at the beginning of disks. |
915 | .Pp | | 915 | .Pp |
916 | The size of primary bootstrap programs is restricted to 7.5KB, even | | 916 | The size of primary bootstrap programs is restricted to 7.5KB, even |
917 | though some file systems (e.g., ISO 9660) are able to accommodate larger | | 917 | though some file systems (e.g., ISO 9660) are able to accommodate larger |
918 | ones. | | 918 | ones. |
919 | . | | 919 | . |
920 | .Ss Nx Ns Tn /sun2 and Nx Ns Tn /sun3 | | 920 | .Ss Nx Ns Tn /sun2 and Nx Ns Tn /sun3 |
921 | The | | 921 | The |
922 | .Nx Ns Tn /sun2 | | 922 | .Nx Ns Tn /sun2 |
923 | and | | 923 | and |
924 | .Nx Ns Tn /sun3 | | 924 | .Nx Ns Tn /sun3 |
925 | secondary bootstrap program can only load kernels from file | | 925 | secondary bootstrap program can only load kernels from file |
926 | systems starting at the beginning of disks. | | 926 | systems starting at the beginning of disks. |
927 | . | | 927 | . |
928 | .Ss Nx Ns Tn /vax | | 928 | .Ss Nx Ns Tn /vax |
929 | The | | 929 | The |
930 | .Nx Ns Tn /vax | | 930 | .Nx Ns Tn /vax |
931 | secondary bootstrap program can only load kernels from file systems | | 931 | secondary bootstrap program can only load kernels from file systems |
932 | starting at the beginning of disks. | | 932 | starting at the beginning of disks. |
933 | .Pp | | 933 | .Pp |
934 | The size of primary bootstrap programs is restricted to 7.5KB, even | | 934 | The size of primary bootstrap programs is restricted to 7.5KB, even |
935 | though some file systems (e.g., ISO 9660) are able to accommodate larger | | 935 | though some file systems (e.g., ISO 9660) are able to accommodate larger |
936 | ones. | | 936 | ones. |