Module Name: src
Committed By: tsutsui
Date: Sun Jun 9 05:42:59 UTC 2024
Modified Files:
src/share/man/man8/man8.macppc: ofwboot.8
Log Message:
Update misc ofwboot(8) descriptions.
- add examples how to boot USB flash containing bootable CD ISO
- also add notes how to check a device path of USB flash
- no need to specify a name of "netbsd.macppc" because ofwboot(8)
searches "netbsd", "netbsd.gz", and "netbsd.macppc" by default
- describe about partition "zero" required on booting via raw ofwboot
- no need to specify boot-file (i.e. ofwboot.xcf) on booting from CD
on Open Firmware 1 or 2 machines that use the partition "zero" method
- remove leftover of ancient release number of NetBSD "1.5"
- add "CLAIM failed" case in ERROR section
- add notes that it's recommended to restart Open Firmware by
"reset-all" command if got any Open Firmware errors
- add links to "NetBSD/macppc Partitioning HOW-TO" and
"NetBSD/macppc Model Support" in the SEE ALSO section
- use https for links also use https://cdn.NetBSD.org/ instead of
obsolete ftp:
- avoid newlines in boot-device and boot-file argument descriptions
- consistently use "\" in the boot-file paths
- consistently use "CD-ROM" rather than "CDROM"
- remove an obsolete commented out block
- bump date
To generate a diff of this commit:
cvs rdiff -u -r1.17 -r1.18 src/share/man/man8/man8.macppc/ofwboot.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.macppc/ofwboot.8
diff -u src/share/man/man8/man8.macppc/ofwboot.8:1.17 src/share/man/man8/man8.macppc/ofwboot.8:1.18
--- src/share/man/man8/man8.macppc/ofwboot.8:1.17 Sat Mar 2 00:03:20 2024
+++ src/share/man/man8/man8.macppc/ofwboot.8 Sun Jun 9 05:42:59 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: ofwboot.8,v 1.17 2024/03/02 00:03:20 uwe Exp $
+.\" $NetBSD: ofwboot.8,v 1.18 2024/06/09 05:42:59 tsutsui Exp $
.\"
.\" Copyright (c) 2001 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 March 1, 2024
+.Dd June 9, 2024
.Dt OFWBOOT 8 macppc
.Os
.Sh NAME
@@ -82,14 +82,13 @@ actually designates the primary bootload
form:
.Bd -literal -offset indent
.Sm off
-.Ar device Ic \&: Op Ar partition-num
-.Ic \&, Op Ar bootloader-filename
+.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,ofwboot.xcf
+.Dl /pci@f2000000/mac-io@17/ata-4@1f000/@0:9,\eofwboot.xcf
.Pp
Note that colon
.Pq Ql \&:
@@ -119,7 +118,7 @@ The
.Ar boot-device
above could then be simplified to:
.Pp
-.Dl hd:9,ofwboot.xcf
+.Dl hd:9,\eofwboot.xcf
.Pp
.Ar bootloader-filename
is usually
@@ -159,8 +158,7 @@ The syntax is similar to the
argument:
.Bd -literal -offset indent
.Sm off
-.Op Ar boot-file-device Ic \&: Ar partition-num\^ Ic \&/
-.Op Ar kernel-name
+.Oo Ar boot-file-device Ic \&: Ar partition-num\^ Ic \&/ Oc Op Ar kernel-name
.Sm on
.Ed
.Pp
@@ -242,8 +240,14 @@ are the same program, in different execu
is installed via
.Xr installboot 8
on systems with Open Firmware versions less than 3.
-It is not necessary to specify this file name, as it is stored in a special
-location on the disk, partition
+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:
@@ -303,9 +307,9 @@ with RAM disk and
included.
.
.It Pa NetBSD-{RELEASE}-macppc.iso
-bootable CDROM image for all supported systems.
+bootable CD-ROM image for all supported systems.
Usually located at
-.Pa ftp://ftp.NetBSD.org/pub/NetBSD/images/{RELEASE}/NetBSD-{RELEASE}-macppc.iso
+.Pa https://cdn.NetBSD.org/pub/NetBSD/images/{RELEASE}/
.El
.Sh EXAMPLES
.Pp
@@ -323,7 +327,7 @@ Boot an Open Firmware 3 system, with
.Ar netbsd
installed on partition
.Dq Pa a :
-.Dl 0 > boot hd:,ofwboot.xcf
+.Dl 0 > boot hd:,\eofwboot.xcf
.
.It
Boot the kernel named
@@ -338,16 +342,39 @@ 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 CDROM with Open Firmware 3 or higher:
-.Dl 0 > boot cd:,\eofwboot.xcf netbsd.macppc
+Boot from bootable CD-ROM of
+.Nx
+release with Open Firmware 3 or higher:
+.Dl 0 > boot cd:,\eofwboot.xcf
.
.It
-Boot from bootable CDROM (internal SCSI, id=3) of
-.Nx 1.5
+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,OFWBOOT.XCF NETBSD.MACPPC
+.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:
@@ -383,6 +410,17 @@ 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
@@ -408,22 +446,23 @@ As it says.
no active package3337696/
.Ed
and hangs: See the real-base part in the FAQ.
-.\" .Bd -unfilled
-.\" 0 > boot yy
-.\" >> NetBSD/macppc OpenFirmware Boot, Revision 1.3
-.\" >> (root@nazuha, Fri Jun 8 22:21:55 JST 2001)
-.\" no active packageopen yy: Device not configured
-.\" open ata/ata-disk@0/yy: Device not configured
-.\" Boot:
-.\" .Ed
+.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 http://www.NetBSD.org/ports/macppc/faq.html "NetBSD/macppc Frequently Asked Questions"
+.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 http://www.NetBSD.org/docs/network/netboot/ "Diskless NetBSD HOW-TO"
+.Lk https://www.NetBSD.org/docs/network/netboot/ "Diskless NetBSD HOW-TO"
.Sh STANDARDS
.St -ieee1275-94
.Sh BUGS
