feat: Added NetBSD man pages

3 files changed, 904 insertions, 0 deletions

diff --git a/static/netbsd/man8/man8.macppc/Makefile b/static/netbsd/man8/man8.macppc/Makefile
new file mode 100644
index 00000000..5b657add
--- /dev/null
+++ b/static/netbsd/man8/man8.macppc/Makefile
@@ -0,0 +1,4 @@
+MAN = $(wildcard *.8)
+
+include ../../../mandoc.mk
+
diff --git a/static/netbsd/man8/man8.macppc/boot.8 b/static/netbsd/man8/man8.macppc/boot.8
new file mode 100644
index 00000000..cfccf501
--- /dev/null
+++ b/static/netbsd/man8/man8.macppc/boot.8
@@ -0,0 +1,410 @@
+.\" $NetBSD: boot.8,v 1.9 2024/09/07 19:13:29 rillig 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.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 February 17, 2017
+.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 macppc/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 https://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 https://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 macppc/ofwboot 8 .
+.It Ev boot-file
+Kernel location.
+Value depends on a variety of factors.
+See
+.Xr macppc/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 macppc/ofwboot 8
+and
+.Lk https://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
+.Pp
+When
+.Xr macppc/ofwboot 8
+is started, it prints something like the following:
+.Bd -unfilled -offset indent
+ >> NetBSD/macppc OpenFirmware Boot, Revision 1.7
+ >> (autobuild@tgm.daemon.org, Thu Feb  6 17:50:27 UTC 2003)
+.Ed
+.Pp
+When
+.Xr macppc/ofwboot 8
+is loading the kernel, it prints something like the following:
+.Bd -unfilled -offset indent
+ 4395364+254568 [220144+193803]=0x4d477c
+  start=0x100000
+.Ed
+.Pp
+When the
+.Nx
+kernel has started it prints a banner similar to the following:
+.Bd -literal -offset indent
+ Copyright (c) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
+     The NetBSD Foundation, Inc.  All rights reserved.
+ Copyright (c) 1982, 1986, 1989, 1991, 1993
+     The Regents of the University of California.  All rights reserved.
+
+ NetBSD 1.6ZC (GENERIC) #0: Tue Sep 30 13:09:10 UTC 2003
+        autobuild@tgm.NetBSD.org:/autobuild/HEAD/macppc/OBJ/autobuild/HEAD/src/sys/arch/macppc/compile/GENERIC
+.Ed
+.Ss "After bootstrap"
+Once the
+.Nx Ns Tn /macppc
+kernel is booted normally
+it initializes itself and proceeds to start the system.
+An automatic consistency check of the file systems takes place,
+and unless this fails, the system comes up to multi-user operation.
+.Pp
+The proper way to shut the system down is with the
+.Xr shutdown 8
+command.
+.Pp
+If the system crashes, it will enter the kernel debugger,
+.Xr ddb 4 ,
+if it is configured in the kernel.
+If the crash occurred during initialization and the debugger is
+not present or is exited, the kernel will halt the system.
+.Pp
+If the crash occurred during normal operation and the debugger
+is not present or is exited, the system will attempt a dump to the
+configured dump device (which will be automatically recovered with
+.Xr savecore 8
+during the next bootstrap cycle), and after the dump is complete (successful
+or not) the kernel will attempt a reboot.
+.Sh FILES
+.Bl -tag -width /usr/mdec/bootxx_cd9660 -compact
+.It Pa /boot
+.Nx
+secondary bootstrap program (Open Firmware 1.x and 2.x)
+.It Pa /netbsd
+default
+.Nx
+system kernel
+.It Pa /usr/mdec/bootxx
+.Nx
+primary bootstrap program (Open Firmware 1.x and 2.x) a.k.a.
+.Dq "partition zero"
+bootloader
+.It Pa /usr/mdec/ofwboot
+.Nx
+secondary bootstrap program (Open Firmware 1.x and 2.x)
+.It Pa /usr/mdec/ofwboot.xcf
+primary bootstrap for netboot and
+.Dq cd9660
+.Pq Tn ISO 9660 ,
+.Dq MS-DOS ,
+.Dq HFS ,
+and
+.Dq HFS+
+file systems.
+.El
+.Sh SEE ALSO
+.Xr ddb 4 ,
+.Xr intro 4 ,
+.Xr diskless 8 ,
+.Xr halt 8 ,
+.Xr init 8 ,
+.Xr installboot 8 ,
+.Xr macppc/ofwboot 8 ,
+.Xr rc 8 ,
+.Xr reboot 8 ,
+.Xr savecore 8 ,
+.Xr shutdown 8
+.Pp
+.Lk https://www.NetBSD.org/ports/macppc/faq.html
+.br
+.Lk https://www.NetBSD.org/docs/network/netboot/
+.Sh STANDARDS
+.St -ieee1275-94
+.Lk http://playground.sun.com/1275/home.html
+.Sh BUGS
+The device names used by
+.Nx Ns Tn /macppc
+and Open Firmware often have no relation to each other.
+.Pp
+Apple Computer's Open Firmware implementation is easily confused.
+It is best to reboot your computer
+after a failed boot attempt,
+.Ic halt ,
+or
+.Ic "shutdown -h" .
+Use the Open Firmware
+.Ic reset-all
+command.
+.Pp
+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
+included with every release of
+.Nx .
diff --git a/static/netbsd/man8/man8.macppc/ofwboot.8 b/static/netbsd/man8/man8.macppc/ofwboot.8
new file mode 100644
index 00000000..5e9c3651
--- /dev/null
+++ b/static/netbsd/man8/man8.macppc/ofwboot.8
@@ -0,0 +1,490 @@
+.\"	$NetBSD: ofwboot.8,v 1.18 2024/06/09 05:42:59 tsutsui Exp $
+.\"
+.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Makoto Fujiwara, Thomas Klausner, and Michael Wolfson.
+.\"
+.\" 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.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``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 FOUNDATION OR CONTRIBUTORS
+.\" 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 9, 2024
+.Dt OFWBOOT 8 macppc
+.Os
+.Sh NAME
+.Nm ofwboot ,
+.Nm ofwboot.elf ,
+.Nm ofwboot.xcf
+.Nd Open Firmware boot command
+.Sh SYNOPSIS
+.Nm ofwboot
+.Sh DESCRIPTION
+Open Firmware is a FORTH-like command interpreter started by the BootROM after
+the power-on self test (POST).
+This command interpreter allows the user flexibility in choosing how their
+machine boots an operating system.
+.Nx
+uses Open Firmware to initialize
+many of the devices in a system and uses it to load the primary bootloader,
+.Nm ofwboot .
+.Pp
+The information in this man page should only serve as a guideline for users.
+.Tn Apple
+has made many revisions to Open Firmware, and the earlier versions
+had many problems and inconsistencies.
+You may find that a boot command that works on one model will not work
+on another.
+.Pp
+In this man page, only one Open Firmware command will be described,
+.Ic boot ,
+because it is used to pass arguments to
+.Nm ofwboot .
+The Open Firmware
+.Ic boot
+command takes up to three arguments:
+.Bd -literal -offset indent
+.Ic boot Oo Ar boot-device Oo Ar boot-file Oc Oc Op Ar options
+.Ed
+.Pp
+where
+.Pp
+.Bl -tag -width ".Ar boot-device" -offset indent -compact
+.It Ar boot-device
+primary bootloader location
+.It Ar boot-file
+kernel location
+.It Ar options
+flags passed to the kernel (see below)
+.El
+.Ss boot-device
+The first argument,
+.Ar boot-device ,
+actually designates the primary bootloader location and its name in the
+form:
+.Bd -literal -offset indent
+.Sm off
+.Ar device Ic \&: Oo Ar partition-num Oc Op \&, \e Ar bootloader-filename
+.Sm on
+.Ed
+.Pp
+A typical example, from a PowerBook (FireWire), is
+.Pp
+.Dl /pci@f2000000/mac-io@17/ata-4@1f000/@0:9,\eofwboot.xcf
+.Pp
+Note that colon
+.Pq Ql \&:
+delimits the device to the left, and comma
+.Pq Ql \&,
+separates the bootloader filename from the first part.
+For Open Firmware versions before 3, the primary bootloader is installed
+in partition
+.Dq zero ,
+and it is not necessary to specify the
+.Ar bootloader-filename .
+For Open Firmware version 3, you must specify the bootloader filename.
+.Pp
+Open Firmware stores aliases to common devices in
+.Tn NVRAM .
+In the example the above,
+.Pa /pci@f2000000/mac-io@17/ata-4@1f000/@0
+is the path on a PowerBook
+(FireWire) to the built-in
+.Tn ATA Ns /100
+hard drive.
+Use the
+.Ic devalias
+command in Open Firmware to print out a list of common device names on a
+particular model.
+The
+.Ar boot-device
+above could then be simplified to:
+.Pp
+.Dl hd:9,\eofwboot.xcf
+.Pp
+.Ar bootloader-filename
+is usually
+.Nm ofwboot.xcf .
+See also the
+.Sx FILES
+section for further discussion.
+.Pp
+If
+.Ar boot-device
+is omitted from the
+.Ic boot
+command, the Open Firmware variable
+.Ev boot-device
+is used.
+.Ss boot-file
+It may be necessary to specify the
+.Ar boot-file
+if Open Firmware does not know where to find the kernel.
+The default is to load the file named
+.Pa netbsd
+on partition
+.Dq Pa a
+from the device used to load the primary bootloader.
+.Pp
+For systems with
+Open Firmware versions less than 3 which are set up using
+.Ic sysinst ,
+the
+.Ar boot-file
+argument is not necessary.
+Systems with Open Firmware version 3 may need to specify the
+.Ar boot-file .
+.Pp
+The syntax is similar to the
+.Ar boot-device
+argument:
+.Bd -literal -offset indent
+.Sm off
+.Oo Ar boot-file-device Ic \&: Ar partition-num\^ Ic \&/ Oc Op Ar kernel-name
+.Sm on
+.Ed
+.Pp
+This is a little different, since a kernel-name may be specified without
+listing a
+.Ar boot-file-device
+and
+.Ar partition-num .
+Additionally, a
+.Ar boot-file-device
+and
+.Ar partition-num
+may need to be specified, while using the default
+.Ar kernel-name .
+.Pp
+If no
+.Ar kernel-name
+is specified, the primary bootloader will try to find kernels named either
+.Pa netbsd
+or
+.Pa netbsd.gz
+on the boot-device or (if specified) boot-file-device.
+.Ss options
+Possible options are:
+.Bl -tag -width Fl
+.It Fl a
+ask for the boot device
+.It Fl s
+single-user mode boot
+.It Fl d
+debug mode
+.It Cm exit
+exit to Open Firmware after processing arguments
+.El
+.Sh ENVIRONMENT
+If set, the following Open Firmware variables will be used to determine which
+.Ar boot-device
+and
+.Ar boot-file
+Open Firmware should use when booting a system.
+If the user specifies arguments on the command line, these values
+are overridden.
+.Bl -tag -width Ev
+.It Ev boot-device
+used as the first argument
+.It Ev boot-file
+used as the second argument
+.It Ev auto-boot?
+setting this variable to
+.Ic false
+will present the user with an Open Firmware command prompt after power-on
+reset.
+A value of
+.Ic true
+will automatically boot the system using the variables
+.Ev boot-device
+and
+.Ev boot-file .
+(This is not really related to the boot command, but is included for
+completeness.)
+.El
+.Pp
+To restore these variables to their default values, use the
+.Ic set-default
+Open Firmware command:
+.Pp
+.Dl set-default boot-device
+.Sh FILES
+The three files
+.Nm ofwboot ,
+.Nm ofwboot.elf ,
+and
+.Nm ofwboot.xcf
+are the same program, in different executable formats.
+.Bl -tag -width ".Pa ofwboot.xcf"
+.
+.It Pa ofwboot
+.Nm
+is installed via
+.Xr installboot 8
+on systems with Open Firmware versions less than 3.
+It is not necessary to specify this file name on the Open Firmware
+.Ic boot
+command, as it is stored in a special location in the
+.Nx
+partition that is marked
+.Dq bootable
+in the Apple partition map entry.
+The bootable partition can be specified as partition
+.Dq zero .
+For example, the following command might be used to boot from a SCSI device
+with ID 2:
+.Ic "0 >boot scsi-int/sd@2:0" .
+.
+.It Pa ofwboot.xcf
+.Nm ofwboot.xcf
+is in XCOFF format.
+This file is used on all Open Firmware 3 systems, and on Open Firmware
+systems prior to 3 when the bootloader is not installed in partition
+.Dq zero ,
+such as from an ISO-9660 format CD-ROM.
+.
+.It Pa ofwboot.elf
+.Nm ofwboot.elf
+is in
+.Xr elf 5
+format and only functions on systems with Open Firmware version 3.
+To avoid confusion, all users should be using
+.Nm ofwboot.xcf ,
+as
+.Nm ofwboot.elf
+offers no additional functionality.
+It is only included for historical reasons.
+.
+.It Pa boot.fs
+This 1.44 MB disk image contains everything necessary to boot and install
+.Nx .
+It includes the partition
+.Dq zero
+bootloader
+.Nm ( ofwboot ) ,
+an INSTALL kernel (with limited device drivers), and the
+.Ic sysinst
+utility in a RAM disk.
+Since Open Firmware does not care what media
+files are loaded from, only whether they are supported and in the correct
+format, this disk image may be placed on media other than floppy disks, such
+as hard drives or Zip disks.
+Use
+.Xr dd 1
+on Unix, or
+.Ic DiskCopy
+on MacOS 9.1 or later, or
+.Ic suntar
+on any MacOS version to copy this image onto the media.
+.
+.It Pa netbsd
+production kernel, using the GENERIC set of devices which supports almost all
+hardware available for this platform.
+.
+.It Pa netbsd_GENERIC_MD.gz
+GENERIC kernel (the same as
+.Ar netbsd ) ,
+with RAM disk and
+.Ic sysinst
+included.
+.
+.It Pa NetBSD-{RELEASE}-macppc.iso
+bootable CD-ROM image for all supported systems.
+Usually located at
+.Pa https://cdn.NetBSD.org/pub/NetBSD/images/{RELEASE}/
+.El
+.Sh EXAMPLES
+.Pp
+In the following examples
+.Ql "0\~>\~"
+is the Open Firmware prompt.
+.Bl -item
+.
+.It
+Boot the default installation into single user mode.
+.Dl 0 > boot -s
+.
+.It
+Boot an Open Firmware 3 system, with
+.Ar netbsd
+installed on partition
+.Dq Pa a :
+.Dl 0 > boot hd:,\eofwboot.xcf
+.
+.It
+Boot the kernel named
+.Pa netbsd.new
+from partition
+.Dq Pa a
+of the hard disk into
+.Xr ddb 4
+using
+.Tn ELF
+version of
+.Nm
+from the USB flash drive:
+.Dl 0 > boot usb0/disk:,\eofwboot.elf hd/netbsd.new -d
+or
+.Dl 0 > boot usb1/disk:,\eofwboot.elf hd/netbsd.new -d
+Note: You can check which usb device name should be used by
+.Dq Ic devalias
+and
+.Dq Ic dev usb0 ls
+commands etc.
+.
+.It
+Boot from bootable CD-ROM of
+.Nx
+release with Open Firmware 3 or higher:
+.Dl 0 > boot cd:,\eofwboot.xcf
+.
+.It
+Boot from bootable CD-ROM (internal SCSI, id=3) of
+.Nx
+release with Open Firmware versions prior to 3:
+.Dl 0 > boot scsi/sd@3:0
+.
+.It
+Boot from a USB flash drive containing a bootable CD-ROM ISO image of
+.Nx
+release with Open Firmware 3 or higher:
+.Dl 0 > boot usb0/disk@1:3,\eofwboot.xcf
+or
+.Dl 0 > boot usb1/disk@1:3,\eofwboot.xcf
+Note: The partition number
+.Dq Pa 3
+is an ISO9660/HFS hybrid partition specified by the Apple partition map
+in the macppc CD ISO image of
+.Nx
+release.
+.
+.It
+Boot from floppy disk:
+.Dl 0 > boot fd:0
+.
+.It
+Boot from network, with bootps,
+.Xr bootptab 5 ,
+.Xr tftpd 8 ,
+and
+.Xr nfsd 8
+server available:
+.Dl 0 > boot enet:0
+.
+.It
+Boot from network, but use internal root partition of second drive:
+.Dl 0 > boot enet:0 ultra1:0
+.
+.It
+Boot MacOS, looking for the first available bootable disk:
+.Dl 0 > boot hd:,\e\e:tbxi
+.
+.It
+Boot MacOS X residing on partition 10:
+.Dl 0 > boot hd:10,\e\e:tbxi
+.
+.El
+.Sh ERRORS
+.Bd -unfilled
+DEFAULT CATCH!, code=FF00300 at %SRR0: FF80AD38 %SRR1: 00001070
+.Ed
+Could be
+.Dq device not found
+or I/O errors on the device.
+The numbers are just for example.
+If the error is caused by I/O errors (especially on CD boot),
+retrying the same command after restarting Open Firmware by
+.Ic reset-all
+command might help.
+.Bd -unfilled
+CLAIM failed
+.Ed
+Open Firmware got errors on memory allocation ops etc.
+This could also happen by buggy Open Firmware implementation, or improper
+.Ev real-base
+variable settings.
+.Bd -unfilled
+Can't LOAD from this device
+.Ed
+Open Firmware found the device, but it is not supported by
+.Ic load .
+.Bd -unfilled
+0 > boot yy:0/netbsd
+RESETing to change Configuration!
+.Ed
+.Ar yy:0
+doesn't exist, so Open Firmware ignores the string and uses the
+default parameters to boot MacOS; the MacOS boot routine then clears
+some of the Open Firmware variables.
+.Bd -unfilled
+0 > boot ata/ata-disk@0:9 specified partition is not bootable
+ ok
+.Ed
+As it says.
+.Bd -unfilled
+0 > boot ata/ata-disk@0:0
+>> NetBSD/macppc OpenFirmware Boot, Revision 1.3
+>> (root@nazuha, Fri Jun  8 22:21:55 JST 2001)
+no active package3337696/
+.Ed
+and hangs: See the real-base part in the FAQ.
+.Pp
+Note: It is recommended to restart Open Firmware by
+.Ic reset-all
+command if you get these Open Firmware errors,
+to avoid further unexpected random errors.
+.Sh SEE ALSO
+.Xr installboot 8
+.Pp
+.Pa INSTALL.html
+.Pp
+.Lk https://www.NetBSD.org/ports/macppc/faq.html "NetBSD/macppc Frequently Asked Questions"
+.Pp
+.Lk https://www.NetBSD.org/ports/macppc/partitioning.html "NetBSD/macppc Partitioning HOW-TO"
+.Pp
+.Lk https://www.NetBSD.org/ports/macppc/models.html "NetBSD/macppc Model Support"
+.Pp
+.Lk https://www.NetBSD.org/docs/network/netboot/ "Diskless NetBSD HOW-TO"
+.Sh STANDARDS
+.St -ieee1275-94
+.Sh BUGS
+.Nm
+can only boot from devices recognized by Open Firmware.
+.Pp
+Early PowerMacintosh systems (particularly the 7500) seem to have problems
+with netbooting.
+Adding an arp entry at the tftp server with
+.Pp
+.Dl arp -s booting-host-name its-ethernet-address
+.Pp
+may resolve this problem (see
+.Xr arp 8 ) .
+.Pp
+Once boot failed,
+.Bd -literal -offset indent
+0 > boot CLAIM failed
+ ok
+.Ed
+.Pp
+successive boots may not be possible.
+You need to type
+.Ic reset-all
+or power-cycle to re-initialize Open Firmware.