[src/netbsd-2-0]: src/share/man/man8/man8.macppc Make it clear that it's Appl...

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

details:   https://anonhg.NetBSD.org/src/rev/b73b5d88f332
branches:  netbsd-2-0
changeset: 560125:b73b5d88f332
user:      fair <fair%NetBSD.org@localhost>
date:      Mon Mar 29 02:20:52 2004 +0000

description:
Make it clear that it's Apple Computer's OF implementation that
has issues, not OF iself.

New sentence, new line. Macroize some things. Bump date.

This should close PR 21372

diffstat:

 share/man/man8/man8.macppc/boot.8 |  417 ++++++++++++++++++++++++++++++++++++++
 1 files changed, 417 insertions(+), 0 deletions(-)

diffs (truncated from 421 to 300 lines):

diff -r d4f7aa640133 -r b73b5d88f332 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 Mar 29 02:20:52 2004 +0000
@@ -0,0 +1,417 @@
+.\" $NetBSD: boot.8,v 1.4.2.2 2004/03/29 02:20:52 fair 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 March 28, 2004
+.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 ,
+.Pq if it exists .
+Otherwise, it tries to load (in the following order):
+.Pa netbsd , netbsd.gz ,
+or
+.Pa netbsd.macppc
+on the
+.Dq a
+partition of the same device that had the bootloader.
+.Ss "Open Firmware Commands"
+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.
+.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
+.Po
+.Tn ADB
+keyboard,
+.Tn USB
+keyboard, or serial port
+.Pc .
+.Bl -tag -width ttya
+.It Ar kbd
+.Tn ADB
+keyboard on models with
+.Tn ADB ,
+.Tn USB
+keyboard on models with
+.Tn 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"
+When Open Firmware loads the primary bootloader, it will print something
+like the following:
+.Bd -unfilled -offset indent
+ loading XCOFF
+ tsize=CC50 dsize=14AC bsize=2668 entry=640000
+ SECTIONS:
+ .text    00640000 00640000 0000CC50 000000E0
+ .data    0064D000 0064D000 000014AC 0000CD30
+ .bss     0064E4B0 0064E4B0 00002668 00000000
+ loading .text, done..
+ loading .data, done..
+ clearing .bss, done..
+.Ed