Sun Jan 22 16:41:42 2012 UTC ()
New sentence, new line. Avoid unnecessary macros.


(wiz)
diff -r1.6 -r1.7 src/share/man/man8/man8.sandpoint/altboot.8
cvs diff -r1.6 -r1.7 src/share/man/man8/man8.sandpoint/altboot.8 (expand / switch to unified diff)

--- src/share/man/man8/man8.sandpoint/altboot.8 2012/01/22 15:37:23 1.6
+++ src/share/man/man8/man8.sandpoint/altboot.8 2012/01/22 16:41:42 1.7
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: altboot.8,v 1.6 2012/01/22 15:37:23 phx Exp $ 1.\" $NetBSD: altboot.8,v 1.7 2012/01/22 16:41:42 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2011 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2011 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 Tohru Nishimura. 7.\" by Tohru Nishimura.
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
@@ -85,67 +85,72 @@ is instructed to copy the program to RAM @@ -85,67 +85,72 @@ is instructed to copy the program to RAM
85.Pp 85.Pp
86Here 0xfffe'0000 is the flash address where 86Here 0xfffe'0000 is the flash address where
87.Nm 87.Nm
88is stored while 0x0100'0000 is the RAM address to copy to. 88is stored while 0x0100'0000 is the RAM address to copy to.
89.Pp 89.Pp
90The invocation syntax is: 90The invocation syntax is:
91.Pp 91.Pp
92.Dl => go 1000000 Ar ide:N Ar opt1 Ar opt2 ... Ar bootname 92.Dl => go 1000000 Ar ide:N Ar opt1 Ar opt2 ... Ar bootname
93.Bl -tag -width xx 93.Bl -tag -width xx
94.It Va ide:N 94.It Va ide:N
95where 95where
96.Ar N 96.Ar N
97is a string of digits, which defines the number of connected drives on each 97is a string of digits, which defines the number of connected drives on each
98PATA channel. This option is useful to avoid the delays, when 98PATA channel.
 99This option is useful to avoid the delays, when
99.Nm 100.Nm
100is trying to detect a non-existing drive. Examples: 101is trying to detect a non-existing drive.
 102Examples:
101.Bl -tag -width xx 103.Bl -tag -width xx
102.It ide: Ns Ar 10 104.It ide: Ns Ar 10
103A single master drive on the first channel. Nothing on the second channel. 105A single master drive on the first channel.
 106Nothing on the second channel.
104.It ide: Ns Ar 22 107.It ide: Ns Ar 22
105A master and slave drive on both channels of the first controller. 108A master and slave drive on both channels of the first controller.
106.It ide: Ns Ar 1111 109.It ide: Ns Ar 1111
107A master drive on each channel. The first two digits belong to the first 110A master drive on each channel.
 111The first two digits belong to the first
108controller, the last two to the second controller. 112controller, the last two to the second controller.
109.El 113.El
110.Pp 114.Pp
111Unspecified digits will be read as 115Unspecified digits will be read as
112.Ar 0 Ns . 116.Ar 0 .
113The 117The
114.Ar ide 118.Ar ide
115option has only a meaning for PATA disks. Omitting it makes it default to 119option has only a meaning for PATA disks.
116.Ar ide:10 Ns . 120Omitting it makes it default to
 121.Ar ide:10 .
117.Pp 122.Pp
118.It Va optN 123.It Va optN
119multi, auto, ask, single, ddb, userconf, norm, quiet, verb, 124multi, auto, ask, single, ddb, userconf, norm, quiet, verb,
120silent, debug 125silent, debug
121.Pp 126.Pp
122Omitting optN makes 127Omitting optN makes
123.Nm 128.Nm
124default to multi-user mode boot. 129default to multi-user mode boot.
125.Pp 130.Pp
126N.B., the maximum number of allowed go command arguments varies 131N.B., the maximum number of allowed go command arguments varies
127and depends on the 132and depends on the
128.Tn U-Boot/PPCBoot 133.Tn U-Boot/PPCBoot
129buildtime configuration. 134buildtime configuration.
130.It Va bootname 135.It Va bootname
131One of the following: 136One of the following:
132.Pp 137.Pp
133.Dl nfs: Ns Ar filename 138.Dl nfs: Ns Ar filename
134.Dl nfs: 139.Dl nfs:
135.Dl tftp: Ns Ar filename 140.Dl tftp: Ns Ar filename
136.Dl tftp: 141.Dl tftp:
137.Dl wd Ns Ar Np Ns : Ns Ar filename 142.Dl wd Ns Ar Np : Ns Ar filename
138.Dl wd Ns Ar Np Ns : 143.Dl wd Ns Ar Np :
139.Dl mem: Ns Ar address 144.Dl mem: Ns Ar address
140.Dl net: 145.Dl net:
141.Pp 146.Pp
142The last one is a synonym for 147The last one is a synonym for
143.Dq nfs . 148.Dq nfs .
144.It nfs: Ns Va filename 149.It nfs: Ns Va filename
145issue a 150issue a
146.Tn DHCP 151.Tn DHCP
147request to determine the 152request to determine the
148.Tn IP 153.Tn IP
149address and download 154address and download
150.Ar filename 155.Ar filename
151from the 156from the
@@ -223,48 +228,51 @@ Note that a backslashed @@ -223,48 +228,51 @@ Note that a backslashed
223.Sq \&; 228.Sq \&;
224is necessary to enter the script correctly. 229is necessary to enter the script correctly.
225.Bd -literal -offset indent 230.Bd -literal -offset indent
226=> setenv bootcmd cp.b fffe0000 1000000 20000\e; go 1000000 wd0: 231=> setenv bootcmd cp.b fffe0000 1000000 20000\e; go 1000000 wd0:
227=> setenv bootdelay 5 232=> setenv bootdelay 5
228=> saveenv 233=> saveenv
229.Ed 234.Ed
230.Pp 235.Pp
231When 236When
232.Tn U-Boot/PPCBoot 237.Tn U-Boot/PPCBoot
233is lacking important commands like 238is lacking important commands like
234.Tn cp 239.Tn cp
235or 240or
236.Tn go Ns , 241.Tn go ,
237or is unable to save the enviroment, then there is still the option to 242or is unable to save the enviroment, then there is still the option to
238replace the 243replace the
239.Tn Linux 244.Tn Linux
240kernel module by 245kernel module by
241.Pa altboot.img 246.Pa altboot.img
242and save it to the same address in flash ROM. In this case you have only 247and save it to the same address in flash ROM.
243two options left to pass arguments: 248In this case you have only two options left to pass arguments:
244.Pp 249.Pp
245.Bl -bullet -compact 250.Bl -bullet -compact
246.It 251.It
247Enter the interactive command line mode, after 252Enter the interactive command line mode, after
248.Nm 253.Nm
249has started. This requires a serial console. 254has started.
 255This requires a serial console.
250.It 256.It
251Write a fixed command line into flash, replacing the 257Write a fixed command line into flash, replacing the
252.Tn Linux 258.Tn Linux
253initrd image. The command line is a normal 259initrd image.
 260The command line is a normal
254.Tn ASCII 261.Tn ASCII
255file, started by the identifier 262file, started by the identifier
256.Em altboot: 263.Em altboot:
257and terminated by any control character between 0 and 31. Example: 264and terminated by any control character between 0 and 31.
 265Example:
258.Dl altboot:silent ide:1111 wd0:netbsd 266.Dl altboot:silent ide:1111 wd0:netbsd
259.El 267.El
260.Sh SEE ALSO 268.Sh SEE ALSO
261.Xr dhcpd 8 , 269.Xr dhcpd 8 ,
262.Xr diskless 8 , 270.Xr diskless 8 ,
263.Xr nfsd 8 , 271.Xr nfsd 8 ,
264.Xr tftpd 8 272.Xr tftpd 8
265.Sh HISTORY 273.Sh HISTORY
266The 274The
267.Nx Ns Tn /sandpoint 275.Nx Ns Tn /sandpoint
268.Nm 276.Nm
269first appeared in 277first appeared in
270.Nx 6.0 . 278.Nx 6.0 .