[src/trunk]: src Add new macppc boot(8) man page. Fixes PR port-macppc/21372.

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

details:   https://anonhg.NetBSD.org/src/rev/e59bcd1d86c6
branches:  trunk
changeset: 553693:e59bcd1d86c6
user:      mbw <mbw%NetBSD.org@localhost>
date:      Mon Oct 20 09:07:44 2003 +0000

description:
Add new macppc boot(8) man page.  Fixes PR port-macppc/21372.

diffstat:

 distrib/sets/lists/man/mi           |    4 +-
 share/man/man8/man8.macppc/Makefile |    4 +-
 share/man/man8/man8.macppc/boot.8   |  391 ++++++++++++++++++++++++++++++++++++
 3 files changed, 396 insertions(+), 3 deletions(-)

diffs (truncated from 432 to 300 lines):

diff -r 8efec03e99b1 -r e59bcd1d86c6 distrib/sets/lists/man/mi
--- a/distrib/sets/lists/man/mi Mon Oct 20 08:25:36 2003 +0000
+++ b/distrib/sets/lists/man/mi Mon Oct 20 09:07:44 2003 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.619 2003/10/19 09:12:32 wiz Exp $
+# $NetBSD: mi,v 1.620 2003/10/20 09:07:44 mbw Exp $
 ./usr/share/info/am-utils.info                 man-amd-info
 ./usr/share/info/as.info                       man-computil-info
 ./usr/share/info/awk.info                      man-util-info
@@ -1549,6 +1549,7 @@
 ./usr/share/man/cat8/mac68k/boot.0             man-sys-catman
 ./usr/share/man/cat8/mac68k/makedev.0          man-sysutil-catman
 ./usr/share/man/cat8/macppc/MAKEDEV.0          man-sysutil-catman
+./usr/share/man/cat8/macppc/boot.0             man-sys-catman
 ./usr/share/man/cat8/macppc/makedev.0          man-sysutil-catman
 ./usr/share/man/cat8/macppc/ofwboot.0          man-sysutil-catman
 ./usr/share/man/cat8/macppc/ofwboot.elf.0      man-sysutil-catman
@@ -3398,6 +3399,7 @@
 ./usr/share/man/man8/mac68k/boot.8             man-sys-man
 ./usr/share/man/man8/mac68k/makedev.8          man-sysutil-man
 ./usr/share/man/man8/macppc/MAKEDEV.8          man-sysutil-man
+./usr/share/man/man8/macppc/boot.8             man-sys-man
 ./usr/share/man/man8/macppc/makedev.8          man-sysutil-man
 ./usr/share/man/man8/macppc/ofwboot.8          man-sysutil-man
 ./usr/share/man/man8/macppc/ofwboot.elf.8      man-sysutil-man
diff -r 8efec03e99b1 -r e59bcd1d86c6 share/man/man8/man8.macppc/Makefile
--- a/share/man/man8/man8.macppc/Makefile       Mon Oct 20 08:25:36 2003 +0000
+++ b/share/man/man8/man8.macppc/Makefile       Mon Oct 20 09:07:44 2003 +0000
@@ -1,6 +1,6 @@
-#      $NetBSD: Makefile,v 1.3 2001/08/18 00:00:34 wiz Exp $
+#      $NetBSD: Makefile,v 1.4 2003/10/20 09:07:44 mbw Exp $
 
-MAN=   MAKEDEV.8 ofwboot.8
+MAN=   MAKEDEV.8 boot.8 ofwboot.8
 MLINKS=        MAKEDEV.8 makedev.8
 MLINKS+=       ofwboot.8 ofwboot.elf.8 ofwboot.8 ofwboot.xcf.8
 MANSUBDIR=/macppc
diff -r 8efec03e99b1 -r e59bcd1d86c6 share/man/man8/man8.macppc/boot.8
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man8/man8.macppc/boot.8 Mon Oct 20 09:07:44 2003 +0000
@@ -0,0 +1,391 @@
+.\" $NetBSD: boot.8,v 1.1 2003/10/20 09:07:44 mbw Exp $
+.\"
+.\" Copyright (c) 2003 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Michael Wolfson and Erik E. Fair.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"          This product includes software developed for the
+.\"          NetBSD Project.  See http://www.netbsd.org/ for
+.\"          information about NetBSD.
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.\"
+.Dd June 21, 2003
+.Dt BOOT 8 macppc
+.Os
+.Sh NAME
+.Nm boot
+.Nd Macppc system bootstrapping procedures
+.Sh DESCRIPTION
+.Ss Power fail and crash recovery
+Normally, the system will reboot itself at power-up or after crashes.
+An automatic consistency check of the file systems will be performed
+as described in
+.Xr fsck 8 ,
+and unless this fails, the system will resume multi-user operations.
+.Ss Cold starts
+The boot ROM performs a Power On Self Test (POST) then loads Open 
+Firmware.  Depending on the Open Firmware variable
+.Sq Ev auto-boot? 
+it will either stop at the Open Firmware 
+prompt or attempt to boot an operating system.  Depending on the contents 
+of the
+.Sq Ev use-nvramrc? ,
+.Sq Ev boot-command ,
+.Sq Ev boot-device ,
+and
+.Sq Ev boot-file 
+Open Firmware variables, it will attempt to boot 
+.Tn MacOS ,
+.Tn "MacOS X" ,
+or
+.Nx .
+.Pp
+To boot
+.Nx ,
+Open Firmware loads the bootloader
+.Xr ofwboot 8
+from the specified
+.Sq Ev boot-device .
+The bootloader then loads the kernel from the
+.Sq Ev boot-file ,
+(if it exists).  Otherwise, it tries to load (in the following order):
+.Pa netbsd , netbsd.gz , No or Pa netbsd.macppc
+on the 
+.Dq a
+partition of the same device that had the bootloader.
+.Pp
+.Ss "Open Firmware Commands"
+.Pp
+An essential but incomplete list of Open Firmware commands follows.
+A more thorough list is contained in the FAQ.
+.Lk http://www.NetBSD.org/Ports/macppc/faq.html#ofw-use
+.Pp
+.Ic boot
+.Op Ar boot-device Op Ar boot-file
+.Op Ar options
+.Pp
+Boot an operating system.
+The default arguments for this command are taken from the Open Firmware
+environment variables:
+.Bl -tag -width boot-device -compact
+.It Ar boot-device
+primary bootloader location
+.It Ar boot-file
+kernel location
+.It Ar options
+flags passed to the kernel
+.El
+.Pp
+.Ic reset-all
+.Pp
+Reset the system, and proceed as specified by the
+.Sq Ev use-nvramrc?
+and
+.Sq Ev auto-boot?
+variables.  If
+.Sq Ev use-nvramrc?
+is set to
+.Sq Ev true ,
+then the system will attempt to execute the commands stored in the
+.Sq Ev nvramrc
+variable.  If
+.Sq Ev auto-boot?
+is set to
+.Sq Ev true ,
+the system will attempt to use the values stored in
+.Sq Ev boot-command ,
+.Sq Ev boot-device ,
+and
+.Sq Ev boot-file
+to boot the system.  If
+.Sq Ev auto-boot?
+is set to
+.Sq Ev false ,
+the system will halt at the Open Firmware prompt.
+.Pp
+.Ic shut-down
+.Pp
+Power off the system.
+.Pp
+.Ic setenv Ar variable Ar value
+.Pp
+Set an Open Firmware variable, e.g.,
+.Bd -literal -offset indent
+setenv auto-boot? false
+setenv boot-device hd:,\eofwboot.xcf
+setenv boot-file netbsd-GENERIC.gz
+.Ed
+.Pp
+.Ic set-default Ar variable
+.Pp
+Set an Open Firmware variable to its default value.
+.Pp
+.Ic printenv Op Ar variable
+.Pp
+Show Open Firmware variables and values.
+.Pp
+.Ic eject fd
+.Pp
+Eject floppy disk on systems with on-board floppy drives.
+.Pp
+.Ic mac-boot
+.Pp
+Attempt to boot
+.Tn MacOS
+on an Open Firmware 3 system.
+.Pp
+.Ic bye
+.Pp
+Attempt to boot
+.Tn MacOS
+on an Open Firmware 1.0.5, 2.0.x, or 2.4 system.
+.Pp
+.Ss "Open Firmware Variables"
+An essential but incomplete list of Open Firmware variables follows.
+A more thorough list is contained in the FAQ.
+.Lk http://www.NetBSD.org/Ports/macppc/faq.html#ofw-variables
+.Bl -tag -width "ew*0_protocols"
+.It Ev auto-boot?
+What Open Firmware will do at system startup or reset:
+.Bl -tag -width false
+.It Ar true
+automatically bootstrap an operating system using values from the
+.Sq Ev boot-command ,
+.Sq Ev boot-device ,
+and
+.Sq Ev boot-file
+variables.
+.It Ar false
+stop at the Open Firmware prompt.
+.El
+.Pp
+.It Ev use-nvramrc?
+If 
+.Sq Ev true
+runs commands in variable 
+.Sq Ev nvramrc .
+.Pp
+.It Ev real-base
+Kernel memory location. 
+.Em "Do not modify this value on Open Firmware 3 systems \(em you may"
+.Em "damage your computer" .
+All other Open Firmware versions should use
+.Li F00000 .
+.Pp
+.It Ev load-base
+Bootloader memory location. 
+.Em "Do not modify this value on Open Firmware 3 systems \(em you may"
+.Em "damage your computer" .
+All other Open Firmware versions should use
+.Li 600000 .
+.Pp
+.It Ev boot-command
+The command to use for booting.  Typically, the default of
+.Sq Ev boot
+is used.
+.Pp
+.It Ev boot-device
+Device from which to load primary bootloader.  Value depends on a variety
+of factors.  See 
+.Xr ofwboot 8 .
+.It Ev boot-file
+Kernel location.  Value depends on a variety of factors.  See
+.Xr ofwboot 8 .
+.Pp
+.It Ev input-device
+What type of console input device (ADB keyboard, USB keyboard, or serial 
+port).
+.Bl -tag -width ttya
+.It Ar kbd
+ADB keyboard on models with ADB, USB keyboard on models with USB, and 
+built-in keyboard on laptops.  This is the default on some Open Firmware 
+2.0.x machines and all Open Firmware 2.4 and 3 machines.
+.It Ar ttya
+.Sq Modem
+serial port on machines with serial ports.  Properties are 38400 bps, 8 
+bits, no parity, 1 stop bit, no handshaking.  This is the default on all 
+Open Firmware 1.0.5 systems and some Open Firmware 2.0.x systems.
+.It Ar ttyb
+.Sq Printer
+serial port on machines with serial ports.  Properties are the same as the
+.Sq Modem
+port.
+.It Ar scca
+Serial port on Xserve models.  Properties are 57600 bps, 8 bits, no 
+parity, 1 stop bit, no handshaking.
+.El
+.Pp
+.It output-device
+What type of console output device (On-board video, AGP video, PCI video, 
+built-in LCD, or serial console). 
+Value depends on a variety of factors.  See
+.Xr ofwboot 8
+and
+.Lk http://www.NetBSD.org/Ports/macppc/faq.html#ofw-input-output-devices
+.Pp
+.It nvramrc
+If 
+.Sq Ev use-nvramrc? 
+is set to true, these 
+.Tn FORTH
+commands will be run when the computer is reset
+.Pp
+.El
+.Ss "Normal Operation"