NetBSD Problem Report #34496

From tsutsui@ceres.dti.ne.jp  Fri Sep  8 18:25:01 2006
Return-Path: <tsutsui@ceres.dti.ne.jp>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by narn.NetBSD.org (Postfix) with ESMTP id 6670D63B8E9
	for <gnats-bugs@gnats.NetBSD.org>; Fri,  8 Sep 2006 18:25:01 +0000 (UTC)
Message-Id: <200609081717.k88HHGjP029718@mirage.ceres.dti.ne.jp>
Date: Sat, 9 Sep 2006 02:17:16 +0900 (JST)
From: tsutsui@ceres.dti.ne.jp
Reply-To: tsutsui@ceres.dti.ne.jp
To: gnats-bugs@NetBSD.org
Cc: tsutsui@ceres.dti.ne.jp
Subject: installboot(8) man page update for macppc
X-Send-Pr-Version: 3.95

>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:          closed
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Fri Sep 08 18:30:00 +0000 2006
>Closed-Date:    Sat Nov 25 17:29:26 +0000 2006
>Last-Modified:  Sat Nov 25 17:29:26 +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

>Release-Note:

>Audit-Trail:
From: Izumi Tsutsui <tsutsui@netbsd.org>
To: gnats-bugs@NetBSD.org
Cc: 
Subject: PR/34496 CVS commit: src/usr.sbin/installboot
Date: Sat, 25 Nov 2006 15:12:02 +0000 (UTC)

 Module Name:	src
 Committed By:	tsutsui
 Date:		Sat Nov 25 15:12:02 UTC 2006

 Modified Files:
 	src/usr.sbin/installboot: installboot.8

 Log Message:
 Add some macppc specific description. Closes PR port-macppc/34496 by myself.


 To generate a diff of this commit:
 cvs rdiff -r1.58 -r1.59 src/usr.sbin/installboot/installboot.8

 Please note that diffs are not public domain; they are subject to the
 copyright notices on the relevant files.

State-Changed-From-To: open->closed
State-Changed-By: elad@netbsd.org
State-Changed-When: Sat, 25 Nov 2006 17:29:26 +0000
State-Changed-Why:
tsutsui@ fixed it


>Unformatted:

NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.51 2026/08/10 02:28:17 riastradh Exp $
$NetBSD: gnats_config.sh,v 1.10 2026/05/13 22:00:09 riastradh Exp $
Copyright © 1994-2026 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.