[src/trunk]: src/usr.sbin/installboot document what uses the optional seconda...

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

details:   https://anonhg.NetBSD.org/src/rev/196e8be8d762
branches:  trunk
changeset: 526562:196e8be8d762
user:      lukem <lukem%NetBSD.org@localhost>
date:      Mon May 06 02:30:28 2002 +0000

description:
document what uses the optional secondary arg.  add sun2 example

diffstat:

 usr.sbin/installboot/installboot.8 |  43 ++++++++++++++++++++++++++++++-------
 1 files changed, 35 insertions(+), 8 deletions(-)

diffs (88 lines):

diff -r 6aa1abbd1b02 -r 196e8be8d762 usr.sbin/installboot/installboot.8
--- a/usr.sbin/installboot/installboot.8        Mon May 06 02:12:30 2002 +0000
+++ b/usr.sbin/installboot/installboot.8        Mon May 06 02:30:28 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: installboot.8,v 1.11 2002/04/30 14:45:12 lukem Exp $
+.\"    $NetBSD: installboot.8,v 1.12 2002/05/06 02:30:28 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 April 23, 2002
+.Dd May 6, 2002
 .Dt INSTALLBOOT 8
 .Os
 .Sh NAME
@@ -105,6 +105,21 @@
 The secondary bootstrap may allow control over various boot parameters
 passed to the kernel.
 .Pp
+Some platform
+.Pq Fl m Ar machine
+and file system type
+.Pq Fl t Ar fstype
+combinations require that the name of the secondary bootstrap is
+supplied as
+.Ar secondary ,
+so that information such as the disk block numbers occupied
+by the secondary bootstrap can be stored in the primary bootstrap.
+These are:
+.Bl -column "Platform" "File systems" -offset indent
+.It Sy "Platform" Ta Sy "File systems"
+.It sun2 Ta ffs
+.El
+.Pp
 Perform the following steps to make a file system bootable:
 .Bl -enum
 .It
@@ -129,11 +144,13 @@
 into
 .Ar filesystem .
 .Pp
-.Nx Ns Tn /pmax
+The following platforms do not require this step if the primary bootstrap
+already exists and the secondary bootstrap file is just being updated:
+.Em alpha ,
+.Em pmax ,
+.Em sparc64 ,
 and
-.Nx Ns Tn /sparc64
-do not require this step if the primary bootstrap already exists
-and the secondary bootstrap file is just being updated.
+.Em vax .
 .Pp
 The primary
 .Nx Ns Tn /sparc64
@@ -310,10 +327,12 @@
 .
 .Sh EXAMPLES
 .Ss NetBSD/pmax examples
-Install the Berkeley Fast File System primary bootstrap on to disk sd0:
+Install the Berkeley Fast File System primary bootstrap on to disk
+.Sq sd0 :
 .D1 Ic installboot /dev/rsd0c /usr/mdec/bootxx_ffs
 .Pp
-Remove the primary bootstrap from disk sd1:
+Remove the primary bootstrap from disk
+.Sq sd1 :
 .Dl Ic installboot -c /dev/swd1c
 .Pp
 Install the ISO 9660 primary bootstrap in the file
@@ -334,6 +353,14 @@
 .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
+.Sq sd0 ,
+with the secondary bootstrap
+.Sq Pa /boot
+already present:
+.D1 Ic installboot -v /dev/rsd0c /usr/mdec/bootxx_ffs /boot
 .Sh SEE ALSO
 .Xr uname 3 ,
 .Xr boot 8 ,