From 07c1fe57f74a08e6deeedb7b3314f968ae4fb82c Mon Sep 17 00:00:00 2001 From: fair Date: Mon, 29 Mar 2004 02:20:51 +0000 Subject: [PATCH] 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 --- share/man/man8/man8.macppc/boot.8 | 75 +++++++++++++++++++++---------- 1 file changed, 51 insertions(+), 24 deletions(-) diff --git a/share/man/man8/man8.macppc/boot.8 b/share/man/man8/man8.macppc/boot.8 index ccd6d7636b3e..c6178ea0425b 100644 --- a/share/man/man8/man8.macppc/boot.8 +++ b/share/man/man8/man8.macppc/boot.8 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.3 2003/11/14 17:18:18 keihan Exp $ +.\" $NetBSD: boot.8,v 1.4 2004/03/29 02:20:51 fair Exp $ .\" .\" Copyright (c) 2003 The NetBSD Foundation, Inc. .\" All rights reserved. @@ -34,7 +34,7 @@ .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\" -.Dd June 21, 2003 +.Dd March 28, 2004 .Dt BOOT 8 macppc .Os .Sh NAME @@ -49,10 +49,12 @@ as described in 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 +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 +prompt or attempt to boot an operating system. +Depending on the contents of the .Sq Ev use-nvramrc? , .Sq Ev boot-command , @@ -73,7 +75,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): +.Pq if it exists . +Otherwise, it tries to load (in the following order): .Pa netbsd , netbsd.gz , or .Pa netbsd.macppc @@ -107,13 +110,15 @@ Reset the system, and proceed as specified by the .Sq Ev use-nvramrc? and .Sq Ev auto-boot? -variables. If +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 +variable. +If .Sq Ev auto-boot? is set to .Sq Ev true , @@ -122,7 +127,8 @@ the system will attempt to use the values stored in .Sq Ev boot-device , and .Sq Ev boot-file -to boot the system. If +to boot the system. +If .Sq Ev auto-boot? is set to .Sq Ev false , @@ -204,45 +210,64 @@ All other Open Firmware versions should use .Li 600000 . .Pp .It Ev boot-command -The command to use for booting. Typically, the default of +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 +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 +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). +What type of console input device +.Po +.Tn ADB +keyboard, +.Tn USB +keyboard, or serial port +.Pc . .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 +.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 +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 +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 +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 +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 @@ -351,6 +376,7 @@ file systems. .El .Sh SEE ALSO .Xr ddb 4 , +.Xr intro 4 , .Xr diskless 8 , .Xr halt 8 , .Xr init 8 , @@ -372,7 +398,8 @@ The device names used by .Nx Ns Tn /macppc and Open Firmware often have no relation to each other. .Pp -Open Firmware is easily confused. It is best to reboot your computer +Apple Computer's Open Firmware implementation is easily confused. +It is best to reboot your computer after a failed boot attempt, .Ic halt , or @@ -381,8 +408,8 @@ Use the Open Firmware .Ic reset-all command. .Pp -Open Firmware is notoriously bad. Thorough instructions for installing -and booting +Apple Computer's Open Firmware implementation is notoriously bad. +Thorough instructions for installing and booting .Nx are in the install notes .Pq Pa INSTALL.html