[src/trunk]: src/share/man/man8/man8.sandpoint New option "ide:".

[phx <phx%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/897e90ef617c
branches:  trunk
changeset: 772960:897e90ef617c
user:      phx <phx%NetBSD.org@localhost>
date:      Sun Jan 22 15:37:23 2012 +0000

description:
New option "ide:".
Describe how to use altboot with a crippled U-Boot/PPCBoot firmware.

diffstat:

 share/man/man8/man8.sandpoint/altboot.8 |  84 +++++++++++++++++++++++++++-----
 1 files changed, 69 insertions(+), 15 deletions(-)

diffs (170 lines):

diff -r 2dab92643e07 -r 897e90ef617c share/man/man8/man8.sandpoint/altboot.8
--- a/share/man/man8/man8.sandpoint/altboot.8   Sun Jan 22 14:15:43 2012 +0000
+++ b/share/man/man8/man8.sandpoint/altboot.8   Sun Jan 22 15:37:23 2012 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: altboot.8,v 1.5 2012/01/02 18:02:00 wiz Exp $
+.\" $NetBSD: altboot.8,v 1.6 2012/01/22 15:37:23 phx Exp $
 .\"
 .\" Copyright (c) 2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 1, 2012
+.Dd January 22, 2012
 .Dt ALTBOOT 8 sandpoint
 .Os
 .Sh NAME
@@ -37,9 +37,7 @@
 kernel from disk or network
 .Sh DESCRIPTION
 .Nm
-is a
-.Nx
-program which works on top of a
+is a standalone program which works on top of a
 .Tn NAS
 product's bootloader.
 It is capable of loading a
@@ -91,8 +89,32 @@
 .Pp
 The invocation syntax is:
 .Pp
-.Dl => go 1000000 Ar opt1 Ar opt2 ... Ar bootname
+.Dl => go 1000000 Ar ide:N Ar opt1 Ar opt2 ... Ar bootname
+.Bl -tag -width xx
+.It Va ide:N
+where
+.Ar N
+is a string of digits, which defines the number of connected drives on each
+PATA channel. This option is useful to avoid the delays, when
+.Nm
+is trying to detect a non-existing drive. Examples:
 .Bl -tag -width xx
+.It ide: Ns Ar 10
+A single master drive on the first channel. Nothing on the second channel.
+.It ide: Ns Ar 22
+A master and slave drive on both channels of the first controller.
+.It ide: Ns Ar 1111
+A master drive on each channel. The first two digits belong to the first
+controller, the last two to the second controller.
+.El
+.Pp
+Unspecified digits will be read as
+.Ar 0 Ns .
+The
+.Ar ide
+option has only a meaning for PATA disks. Omitting it makes it default to
+.Ar ide:10 Ns .
+.Pp
 .It Va optN
 multi, auto, ask, single, ddb, userconf, norm, quiet, verb,
 silent, debug
@@ -101,7 +123,7 @@
 .Nm
 default to multi-user mode boot.
 .Pp
-N.B., the maximum number of the go command argument varies
+N.B., the maximum number of allowed go command arguments varies
 and depends on the
 .Tn U-Boot/PPCBoot
 buildtime configuration.
@@ -117,7 +139,7 @@
 .Dl mem: Ns Ar address
 .Dl net:
 .Pp
-The last one is a synonym of
+The last one is a synonym for
 .Dq nfs .
 .It nfs: Ns Va filename
 issue a
@@ -125,7 +147,7 @@
 request to determine the
 .Tn IP
 address and download
-.Em filename
+.Ar filename
 from the
 .Tn NFS
 server.
@@ -140,7 +162,7 @@
 request to determine
 .Tn IP
 address and download
-.Em filename
+.Ar filename
 from the
 .Tn TFTP
 server.
@@ -154,15 +176,15 @@
 .Tn ELF
 .Nx
 kernel
-.Em filename
+.Ar filename
 from an
 .Tn FFSv2
 or
 .Tn FFSv1
 filesystem.
-.Em N
+.Ar N
 is a number to distinguish the target drive.
-.Em p
+.Ar p
 is a partition specifier.
 When omitted, partition
 .Sq a
@@ -184,7 +206,7 @@
 .Nx
 kernel from any address in memory.
 The
-.Em address
+.Ar address
 argument has to be specified as a hexadecimal number and denotes the
 start address of the
 .Tn ELF
@@ -205,9 +227,41 @@
 => setenv bootdelay 5
 => saveenv
 .Ed
+.Pp
+When
+.Tn U-Boot/PPCBoot
+is lacking important commands like
+.Tn cp
+or
+.Tn go Ns ,
+or is unable to save the enviroment, then there is still the option to
+replace the
+.Tn Linux
+kernel module by
+.Pa altboot.img
+and save it to the same address in flash ROM. In this case you have only
+two options left to pass arguments:
+.Pp
+.Bl -bullet -compact
+.It
+Enter the interactive command line mode, after
+.Nm
+has started. This requires a serial console.
+.It
+Write a fixed command line into flash, replacing the
+.Tn Linux
+initrd image. The command line is a normal
+.Tn ASCII
+file, started by the identifier
+.Em altboot:
+and terminated by any control character between 0 and 31. Example:
+.Dl altboot:silent ide:1111 wd0:netbsd
+.El
 .Sh SEE ALSO
 .Xr dhcpd 8 ,
-.Xr diskless 8
+.Xr diskless 8 ,
+.Xr nfsd 8 ,
+.Xr tftpd 8
 .Sh HISTORY
 The
 .Nx Ns Tn /sandpoint