>Number:         34496
>Category:       port-macppc
>Synopsis:       installboot(8) man page update for macppc
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    port-macppc-maintainer
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Sep 08 18:30:00 +0000 2006
>Originator:     Izumi Tsutsui
>Release:        NetBSD 4.99.1
>Organization:
>Environment:
System: NetBSD 4.99.1
Architecture: all
Machine: all
>Description:
Current installboot.8 man page lacks some macppc specfic info
and it might frustrate some users.

>How-To-Repeat:
man installboot

>Fix:
Here is a dumb draft:

Index: installboot.8
===================================================================
RCS file: /cvsroot/src/usr.sbin/installboot/installboot.8,v
retrieving revision 1.56
diff -u -r1.56 installboot.8
--- installboot.8	3 Sep 2006 00:24:35 -0000	1.56
+++ installboot.8	8 Sep 2006 15:38:18 -0000
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 2, 2006
+.Dd September 8, 2006
 .Dt INSTALLBOOT 8
 .Os
 .Sh NAME
@@ -471,6 +471,25 @@
 .
 .El
 .
+.Ss Nx Ns Tn /macppc files
+.
+.Bl -tag -width /usr/mdec/bootxx_ustarfs
+.
+.It Pa /usr/mdec/bootxx
+.Nx Ns Tn /macppc
+primary bootstrap.
+.
+.It Pa /usr/mdec/ofwboot
+.Nx Ns Tn /macppc
+secondary bootstrap.
+.
+.It Pa /ofwboot
+Installed copy of
+.Nx Ns Tn /macppc
+secondary bootstrap.
+.
+.El
+.
 .Ss Nx Ns Tn /next68k files
 .
 .Bl -tag -width /usr/mdec/bootxx_ustarfs
@@ -598,6 +617,26 @@
 for the primary bootstrap to function correctly.
 .Ed
 .
+.Ss Nx Ns Tn /macppc
+Note the
+.Nm
+utility is only required for macppc machines with OpenFirmware version 2
+to boot. OpenFirmware 3 can only load bootloader from HFS partitions.
+.Pp
+Install the Berkeley Fast File System primary bootstrap on to disk
+.Sq wd0 :
+.Dl Ic installboot /dev/rwd0c /usr/mdec/bootxx /ofwboot
+.Pp
+The secondary
+.Nx Ns Tn /macppc
+bootstrap is located in
+.Pa /usr/mdec/ofwboot .
+.Pp
+The primary bootstrap requires raw
+.Pa ofwboot
+for the secondary bootstrap, not
+.Pa ofwboot.xcf ,
+which is used for the OpenFirmware to load kernels.
 .Ss Nx Ns Tn /next68k
 Install the bootstrap on to disk
 .Sq sd0 :
@@ -734,6 +773,22 @@
 though some file systems (e.g., ISO 9660) are able to accommodate larger
 ones.
 .
+.Ss Nx Ns Tn /macppc
+Due to restriction of current
+.Nm
+and secondary bootstrap implementation, file system where kernels exist
+must start at the beginning of disks.
+.Pp
+Current
+.Nm
+doesn't recognize existing Apple partition map on the disk
+and always overwrites a faked map to make disks bootable.
+.Pp
+The
+.Nx Ns Tn /macppc
+bootstrap program can't load kernels from
+.Sy FFSv2
+partitions.
 .Ss Nx Ns Tn /next68k
 The size of bootstrap programs is restricted to the free space before
 the file system at the beginning of the disk minus 8KB.


(maybe we also have to update INSTALL note)
---
Izumi Tsutsui