CVS commit: src/share/man/man8/man8.sandpoint
Module Name:src Committed By: phx Date: Thu Nov 29 10:44:37 UTC 2012 Modified Files: src/share/man/man8/man8.sandpoint: altboot.8 Log Message: Mention Realtek driver bugs in the BUGS section. To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man8/man8.sandpoint/altboot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.sandpoint/altboot.8 diff -u src/share/man/man8/man8.sandpoint/altboot.8:1.7 src/share/man/man8/man8.sandpoint/altboot.8:1.8 --- src/share/man/man8/man8.sandpoint/altboot.8:1.7 Sun Jan 22 16:41:42 2012 +++ src/share/man/man8/man8.sandpoint/altboot.8 Thu Nov 29 10:44:37 2012 @@ -1,4 +1,4 @@ -.\ $NetBSD: altboot.8,v 1.7 2012/01/22 16:41:42 wiz Exp $ +.\ $NetBSD: altboot.8,v 1.8 2012/11/29 10:44:37 phx Exp $ .\ .\ Copyright (c) 2011 The NetBSD Foundation, Inc. .\ All rights reserved. @@ -276,3 +276,7 @@ The .Nm first appeared in .Nx 6.0 . +.Sh BUGS +The Realtek Gigabit Ethernet driver does not work correctly at 1000 Mbps. +Another known problem of this driver is that it runs into a timeout after +a coldstart. The system has to be rebooted at least once to make it work.
CVS commit: src/share/man/man8/man8.sandpoint
Module Name:src Committed By: wiz Date: Thu Nov 29 11:34:33 UTC 2012 Modified Files: src/share/man/man8/man8.sandpoint: altboot.8 Log Message: New sentence, new line. Bump date for previous. To generate a diff of this commit: cvs rdiff -u -r1.8 -r1.9 src/share/man/man8/man8.sandpoint/altboot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.sandpoint/altboot.8 diff -u src/share/man/man8/man8.sandpoint/altboot.8:1.8 src/share/man/man8/man8.sandpoint/altboot.8:1.9 --- src/share/man/man8/man8.sandpoint/altboot.8:1.8 Thu Nov 29 10:44:37 2012 +++ src/share/man/man8/man8.sandpoint/altboot.8 Thu Nov 29 11:34:33 2012 @@ -1,4 +1,4 @@ -.\ $NetBSD: altboot.8,v 1.8 2012/11/29 10:44:37 phx Exp $ +.\ $NetBSD: altboot.8,v 1.9 2012/11/29 11:34:33 wiz 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 22, 2012 +.Dd November 29, 2012 .Dt ALTBOOT 8 sandpoint .Os .Sh NAME @@ -279,4 +279,5 @@ first appeared in .Sh BUGS The Realtek Gigabit Ethernet driver does not work correctly at 1000 Mbps. Another known problem of this driver is that it runs into a timeout after -a coldstart. The system has to be rebooted at least once to make it work. +a coldstart. +The system has to be rebooted at least once to make it work.
CVS commit: src/share/man/man8/man8.sandpoint
Module Name:src Committed By: phx Date: Sun Jan 22 15:37:23 UTC 2012 Modified Files: src/share/man/man8/man8.sandpoint: altboot.8 Log Message: New option ide:. Describe how to use altboot with a crippled U-Boot/PPCBoot firmware. To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man8/man8.sandpoint/altboot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.sandpoint/altboot.8 diff -u src/share/man/man8/man8.sandpoint/altboot.8:1.5 src/share/man/man8/man8.sandpoint/altboot.8:1.6 --- src/share/man/man8/man8.sandpoint/altboot.8:1.5 Mon Jan 2 18:02:00 2012 +++ src/share/man/man8/man8.sandpoint/altboot.8 Sun Jan 22 15:37:23 2012 @@ -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 @@ is stored while 0x0100' is the RAM a .Pp The invocation syntax is: .Pp -.Dl = go 100 Ar opt1 Ar opt2 ... Ar bootname +.Dl = go 100 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 +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 @@ Omitting optN makes .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 @@ One of the following: .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 @@ issue a request to determine the .Tn IP address and download -.Em filename +.Ar filename from the .Tn NFS server. @@ -140,7 +162,7 @@ issue a request to determine .Tn IP address and download -.Em filename +.Ar filename from the .Tn TFTP server. @@ -154,15 +176,15 @@ load the .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 @@ boots the .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 @@ is necessary to enter the script correct = 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: 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
CVS commit: src/share/man/man8/man8.sandpoint
Module Name:src Committed By: wiz Date: Sun Jan 22 16:41:42 UTC 2012 Modified Files: src/share/man/man8/man8.sandpoint: altboot.8 Log Message: New sentence, new line. Avoid unnecessary macros. To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/share/man/man8/man8.sandpoint/altboot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.sandpoint/altboot.8 diff -u src/share/man/man8/man8.sandpoint/altboot.8:1.6 src/share/man/man8/man8.sandpoint/altboot.8:1.7 --- src/share/man/man8/man8.sandpoint/altboot.8:1.6 Sun Jan 22 15:37:23 2012 +++ src/share/man/man8/man8.sandpoint/altboot.8 Sun Jan 22 16:41:42 2012 @@ -1,4 +1,4 @@ -.\ $NetBSD: altboot.8,v 1.6 2012/01/22 15:37:23 phx Exp $ +.\ $NetBSD: altboot.8,v 1.7 2012/01/22 16:41:42 wiz Exp $ .\ .\ Copyright (c) 2011 The NetBSD Foundation, Inc. .\ All rights reserved. @@ -95,25 +95,30 @@ The invocation syntax is: 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 +PATA channel. +This option is useful to avoid the delays, when .Nm -is trying to detect a non-existing drive. Examples: +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. +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 -A master drive on each channel. The first two digits belong to the first +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 . +.Ar 0 . The .Ar ide -option has only a meaning for PATA disks. Omitting it makes it default to -.Ar ide:10 Ns . +option has only a meaning for PATA disks. +Omitting it makes it default to +.Ar ide:10 . .Pp .It Va optN multi, auto, ask, single, ddb, userconf, norm, quiet, verb, @@ -134,8 +139,8 @@ One of the following: .Dl nfs: .Dl tftp: Ns Ar filename .Dl tftp: -.Dl wd Ns Ar Np Ns : Ns Ar filename -.Dl wd Ns Ar Np Ns : +.Dl wd Ns Ar Np : Ns Ar filename +.Dl wd Ns Ar Np : .Dl mem: Ns Ar address .Dl net: .Pp @@ -233,28 +238,31 @@ When is lacking important commands like .Tn cp or -.Tn go Ns , +.Tn go , 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: +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. +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 +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: +and terminated by any control character between 0 and 31. +Example: .Dl altboot:silent ide: wd0:netbsd .El .Sh SEE ALSO
CVS commit: src/share/man/man8/man8.sandpoint
Module Name:src Committed By: wiz Date: Mon Jan 2 18:02:00 UTC 2012 Modified Files: src/share/man/man8/man8.sandpoint: altboot.8 Log Message: New sentence, new line. Bump date for previous. To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/share/man/man8/man8.sandpoint/altboot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.sandpoint/altboot.8 diff -u src/share/man/man8/man8.sandpoint/altboot.8:1.4 src/share/man/man8/man8.sandpoint/altboot.8:1.5 --- src/share/man/man8/man8.sandpoint/altboot.8:1.4 Sun Jan 1 14:48:40 2012 +++ src/share/man/man8/man8.sandpoint/altboot.8 Mon Jan 2 18:02:00 2012 @@ -1,4 +1,4 @@ -.\ $NetBSD: altboot.8,v 1.4 2012/01/01 14:48:40 phx Exp $ +.\ $NetBSD: altboot.8,v 1.5 2012/01/02 18:02:00 wiz 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 26, 2011 +.Dd January 1, 2012 .Dt ALTBOOT 8 sandpoint .Os .Sh NAME @@ -182,7 +182,8 @@ kernel. boots the .Tn ELF .Nx -kernel from any address in memory. The +kernel from any address in memory. +The .Em address argument has to be specified as a hexadecimal number and denotes the start address of the
CVS commit: src/share/man/man8/man8.sandpoint
Module Name:src Committed By: phx Date: Sun Jan 1 14:48:40 UTC 2012 Modified Files: src/share/man/man8/man8.sandpoint: altboot.8 Log Message: Add the description for the mem:address bootname. To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/share/man/man8/man8.sandpoint/altboot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.sandpoint/altboot.8 diff -u src/share/man/man8/man8.sandpoint/altboot.8:1.3 src/share/man/man8/man8.sandpoint/altboot.8:1.4 --- src/share/man/man8/man8.sandpoint/altboot.8:1.3 Thu Jan 27 11:33:43 2011 +++ src/share/man/man8/man8.sandpoint/altboot.8 Sun Jan 1 14:48:40 2012 @@ -1,4 +1,4 @@ -.\ $NetBSD: altboot.8,v 1.3 2011/01/27 11:33:43 nisimura Exp $ +.\ $NetBSD: altboot.8,v 1.4 2012/01/01 14:48:40 phx Exp $ .\ .\ Copyright (c) 2011 The NetBSD Foundation, Inc. .\ All rights reserved. @@ -114,6 +114,7 @@ One of the following: .Dl tftp: .Dl wd Ns Ar Np Ns : Ns Ar filename .Dl wd Ns Ar Np Ns : +.Dl mem: Ns Ar address .Dl net: .Pp The last one is a synonym of @@ -177,6 +178,16 @@ for booting the .Tn ELF .Nx kernel. +.It mem: Ns Va address +boots the +.Tn ELF +.Nx +kernel from any address in memory. The +.Em address +argument has to be specified as a hexadecimal number and denotes the +start address of the +.Tn ELF +image in memory. .El .Pp .Tn U-Boot/PPCBoot
CVS commit: src/share/man/man8/man8.sandpoint
Module Name:src Committed By: wiz Date: Thu Jan 27 09:52:13 UTC 2011 Modified Files: src/share/man/man8/man8.sandpoint: altboot.8 Log Message: New sentence, new line; full month name in Dd; add RCS Id. To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man8/man8.sandpoint/altboot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.sandpoint/altboot.8 diff -u src/share/man/man8/man8.sandpoint/altboot.8:1.1 src/share/man/man8/man8.sandpoint/altboot.8:1.2 --- src/share/man/man8/man8.sandpoint/altboot.8:1.1 Wed Jan 26 11:25:51 2011 +++ src/share/man/man8/man8.sandpoint/altboot.8 Thu Jan 27 09:52:13 2011 @@ -1,4 +1,5 @@ -.Dd Jan 26, 2011 +.\ $NetBSD: altboot.8,v 1.2 2011/01/27 09:52:13 wiz Exp $ +.Dd January 26, 2011 .Dt ALTBOOT 8 sandpoint .Os .Sh NAME @@ -12,7 +13,8 @@ .Nx program which works on top of a .Tn NAS -product's bootloader. It is capable of loading a +product's bootloader. +It is capable of loading a .Nx kernel from an .Tn IDE @@ -24,9 +26,9 @@ .Tn TFTP protocol. .Nm -can be stored in flash ROM. Typically you will first copy it from -flash into RAM and then invoke it there to boot -the +can be stored in flash ROM. +Typically you will first copy it from flash into RAM and then invoke +it there to boot the .Nx kernel. .Pp @@ -35,20 +37,21 @@ .Tn U-Boot/PPCBoot bootloaders used by .Tn NAS -products. With an appropriate boot command line, -saved in the environment, +products. +With an appropriate boot command line, saved in the environment, .Nm can load and start a .Nx -kernel without manual intervention. The original +kernel without manual intervention. +The original .Tn U-Boot/PPCBoot bootloaders remain useful and altboot works as a functional extension of them. .Sh EXAMPLES .Nm occupies less than 128KB in volume and can be stored to any vacant -space of the system's flash. It is made to run at RAM address offset -0x0100'. +space of the system's flash. +It is made to run at RAM address offset 0x0100'. .Tn U-Boot/PPCboot is instructed to copy the program to RAM in this way: .Pp @@ -64,11 +67,11 @@ .Bl -tag -width xx .It Va optN multi, auto, ask, single, ddb, userconf, norm, quiet, verb, -silient, debug +silent, debug .Pp Omitting optN makes .Nm -default to multi-user mode boot. +default to multi-user mode boot. .Pp N.B., the maximum number of the go command argument varies and depends on the @@ -126,12 +129,13 @@ from an .Tn FFSv2 or -.Tn FFSv1 +.Tn FFSv1 filesystem. .Em N is a number to distinguish the target drive. .Em p -is a partition specifier. When omitted, partition +is a partition specifier. +When omitted, partition .Sq a is assumed. .Dq wd0a @@ -152,7 +156,8 @@ The following is a procedure to setup the system for starting .Nx after a 5 second delay, allowing the user to break into interactive -mode. Note that a backslashed +mode. +Note that a backslashed .Sq \; is necessary to enter the script correctly. .Bd -literal -offset indent
