Subject: Re: ofwboot man page 2nd draft
To: Henry B. Hotz <hotz@jpl.nasa.gov>
From: Michael Wolfson <mw@costello.cnf.cornell.edu>
List: port-macppc
Date: 11/04/2000 00:05:43
At 5:56 PM -0800 11/3/00, Henry B. Hotz wrote:

:)I don't think bootpath and bootargs are supported in OF 1.0.5 so I
:)don't understand where they might come from.  Can anyone comment?

Actually, they do. 'boot scsi-int/sd@3:0,OFWBOOT.XCF fd' and 'boot
scsi-int/sd@3:0,OFWBOOT.XCF /bandit/gc/swim3' actually load ofwboot.xcf
from the CD and the kernel from the floppy.

:)SYNOPSIS
:)	boot {promdev[@addr][:part],}ofwboot.xcf exit
:)	boot {promdev[@addr][:part],}ofwboot.xcf -{a|s|d}[a|s|d...]
:)	boot {promdev[@addr][:part],}ofwboot.xcf
:)		[[promdev[{:|,}partition]]/]filename[ a|s|d...]

Don't forget
	boot {promdev[@addr][:part],}
where in some cases you don't need a filename (such as if you're booting
from a `partition zero' bootloader which knows to use ofwboot.xcf.  Of
course specifying ofwboot.xcf doesn't affect it at all, but it's not
strictly necessary.

:)	ofwboot is the primary boot loader for the Macintosh PowerPC
:)port of NetBSD.  It depends on Open Firmware for it's I/O to read the
:)NetBSD kernel.  If promdev is a SCSI disk then addr is the SCSI id.
                                                                  ^^
ID.

:)If the command line options are missing or invalid it will read Open
:)Firmware environment variables to get its options as described under
:)ENVIRONMENT.  If it still can't load a file then the -a option is
:)forced.

"Note, the default environment variables are to boot MacOS".

:)	In addition a filename can be given followed by the above
:)option letters without the `-' flag.  It can be a full path for some
:)versions of Open Firmware on some filesystem types.  It can be
:)preceded by an Open Firmware device path including unit number.  The
:)partition number will be deleted on Open Firmware versions 1 and 2,
:)and will be forced to zero on Open Firmware 3 or greater.

The last part isn't clear.  Partition numbers do matter in all versions of
OF.  Many typical uses are partition zero (for `partition zero' bootloaders
(floppy, HD for OF 1 and 2) and ISO CD-ROMs).

:)	Open Firmware environment variables can be displayed with
:)printenv (no arguments) and set with setenv (same as under csh) from
:)the Open Firmware command line.  Booting MacOS or booting with
:)cmd-opt-P-R held down resets them to their default values.

AFAIK:  Booting MacOS on OF 3 machines changes nothing.  On OF 2 machines
only affects real-base.  On OF 1 machines resets all to default values.

Someone correct me if I'm wrong.

So far so good, thanks for working on this!

  -- MW