[src/netbsd-1-6]: src/usr.sbin/installboot pull up revisions 1.20-1.22 (reque...

[lukem <lukem%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f5d1638b9160
branches:  netbsd-1-6
changeset: 528320:f5d1638b9160
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sun Jun 30 12:55:49 2002 +0000

description:
pull up revisions 1.20-1.22 (requested by lukem in ticket #410):
    revision 1.22
        Mdoc nit.
    revision 1.21
        - be consistent with formatting, and use FSTYPE instead of <fs>
        - remove sparc and sun[23] BUGS that aren't relevant in this version
    revision 1.20
        update to reflect current state of reality for alpha, pmax, sparc,
        sparc64, sun2, sun3 and vax.
        clean up examples.
        include bugs/caveats from the (now removed) arch installboot man pages.

diffstat:

 usr.sbin/installboot/installboot.8 |  105 +++++++++++++++++++++++++++---------
 1 files changed, 77 insertions(+), 28 deletions(-)

diffs (192 lines):

diff -r a8a66261be90 -r f5d1638b9160 usr.sbin/installboot/installboot.8
--- a/usr.sbin/installboot/installboot.8        Sun Jun 30 08:14:49 2002 +0000
+++ b/usr.sbin/installboot/installboot.8        Sun Jun 30 12:55:49 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: installboot.8,v 1.18 2002/05/20 20:24:49 wiz Exp $
+.\"    $NetBSD: installboot.8,v 1.18.2.1 2002/06/30 12:55:49 lukem Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -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 May 21, 2002
+.Dd June 30, 2002
 .Dt INSTALLBOOT 8
 .Os
 .Sh NAME
@@ -132,23 +132,18 @@
 .Bl -enum
 .It
 Copy the secondary bootstrap (usually
-.Pa /usr/mdec/boot. Ns Sy MACHINE )
+.Pa /usr/mdec/boot. Ns Sy MACHINE
+or
+.Pa /usr/mdec/boot )
 to the root directory of the target file system.
 .Pp
-.Nx Ns Tn /pmax
-requires that this file system starts at block 0 of the disk.
-.Pp
-The secondary
-.Nx Ns Tn /sparc64
-bootstrap is located in
-.Pa /usr/mdec/ofwboot .
 .
 .It
 Use
 .Nm
 to install the primary bootstrap program
 (usually
-.Pa /usr/mdec/bootxx. Ns Sy <fs> )
+.Pa /usr/mdec/bootxx_ Ns Sy FSTYPE )
 into
 .Ar filesystem .
 .Pp
@@ -160,10 +155,6 @@
 and
 .Sy vax .
 .Pp
-The primary
-.Nx Ns Tn /sparc64
-bootstrap is located in
-.Pa /usr/mdec/bootblk .
 .El
 .Pp
 The options recognized by
@@ -319,9 +310,9 @@
 .Pp
 .Bl -tag -width /usr/mdec/boot.$MACHINE
 .
-.It Pa /usr/mdec/bootxx_ Ns Sy <fs>
+.It Pa /usr/mdec/bootxx_ Ns Sy FSTYPE
 Primary bootstrap for file system type
-.Sy <fs> .
+.Sy FSTYPE .
 Installed into the bootstrap area of the file system by
 .Nm "" .
 .
@@ -364,14 +355,23 @@
 .El
 .
 .Sh EXAMPLES
-.Ss NetBSD/pmax examples
-Install the Berkeley Fast File System primary bootstrap on to disk
+.
+.Ss common
+Verbosely install the Berkeley Fast File System primary bootstrap on to disk
 .Sq sd0 :
-.D1 Ic installboot /dev/rsd0c /usr/mdec/bootxx_ffs
+.Dl Ic installboot -v /dev/rsd0c /usr/mdec/bootxx_ffs
 .Pp
 Remove the primary bootstrap from disk
 .Sq sd1 :
-.Dl Ic installboot -c /dev/swd1c
+.Dl Ic installboot -c /dev/rsd1c
+.
+.Ss NetBSD/pmax
+Install the Berkeley Fast File System primary bootstrap on to disk
+.Sq sd0 :
+.Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx_ffs
+.Pp
+.Nx Ns Tn /pmax
+requires that this file system starts at block 0 of the disk.
 .Pp
 Install the ISO 9660 primary bootstrap in the file
 .Pa /tmp/cd-image :
@@ -382,6 +382,7 @@
 and install the ISO 9660 primary bootstrap in the filesystem, where the
 source directory for the ISO 9660 filesystem contains a kernel, the
 primary bootstrap
+.Pp
 .Pa bootxx_cd9660
 and the secondary bootstrap
 .Pa boot.pmax :
@@ -391,19 +392,36 @@
 .Dl ...
 .Dl Ic installboot -b `expr 48 \e* 4` /tmp/cd-image /usr/mdec/bootxx_cd9660
 .
-.Ss NetBSD/sun2 examples
-Verbosely install the Berkeley Fast File System primary bootstrap on to
-disk
+.Ss NetBSD/sparc
+Install the Berkeley Fast File System primary bootstrap on to disk
 .Sq sd0 ,
 with the secondary bootstrap
 .Sq Pa /boot
 already present:
-.D1 Ic installboot -v /dev/rsd0c /usr/mdec/bootxx_ffs /boot
+.Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx /boot
+.
+.Ss NetBSD/sparc64
+Install the Berkeley Fast File System primary bootstrap on to disk
+.Sq wd0 :
+.Dl Ic installboot /dev/rwd0c /usr/mdec/bootblk
+.Pp
+The secondary
+.Nx Ns Tn /sparc64
+bootstrap is located in
+.Pa /usr/mdec/ofwboot .
+.
+.Ss NetBSD/sun2 and NetBSD/sun3
+Install the Berkeley Fast File System primary bootstrap on to disk
+.Sq sd0 ,
+with the secondary bootstrap
+.Sq Pa /boot
+already present:
+.Dl Ic installboot /dev/rsd0c /usr/mdec/bootxx /boot
+.
 .Sh SEE ALSO
 .Xr uname 3 ,
 .Xr boot 8 ,
-.Xr disklabel 8 ,
-.Xr init 8
+.Xr disklabel 8
 .
 .Sh HISTORY
 This implementation of
@@ -431,7 +449,20 @@
 .Sh BUGS
 There are not currently primary bootstraps to support all file systems
 types which are capable of being the root file system.
-.Ss NetBSD/pmax bugs
+.
+.Ss NetBSD/alpha
+The
+.Nx Ns Tn /alpha
+primary bootstrap program can only load the secondary bootstrap program
+from file systems starting at the beginning (block 0) of disks.
+Similarly, the secondary bootstrap program can only load kernels from
+file systems starting at the beginning of disks.
+.Pp
+The size of primary bootstrap programs is restricted to 7.5KB, even
+though some file systems (e.g. ISO 9660) are able to accommodate larger
+ones.
+.
+.Ss NetBSD/pmax
 The
 .Nx Ns Tn /pmax
 secondary bootstrap program can only load kernels from file
@@ -440,3 +471,21 @@
 The size of primary bootstrap programs is restricted to 7.5KB, even
 though some file systems (e.g. ISO 9660) are able to accommodate larger
 ones.
+.
+.Ss NetBSD/sun2 and NetBSD/sun3
+The
+.Nx Ns Tn /sun2
+and
+.Nx Ns Tn /sun3
+secondary bootstrap program can only load kernels from file
+systems starting at the beginning of disks.
+.
+.Ss NetBSD/vax
+The
+.Nx Ns Tn /vax
+secondary bootstrap program can only load kernels from file systems
+starting at the beginning of disks.
+.Pp
+The size of primary bootstrap programs is restricted to 7.5KB, even
+though some file systems (e.g. ISO 9660) are able to accommodate larger
+ones.