[src/trunk]: src/share/man/man8/man8.sparc correct sparc64 bootblk/ofwboot pa...

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

details:   https://anonhg.NetBSD.org/src/rev/e5a83c8319f2
branches:  trunk
changeset: 518081:e5a83c8319f2
user:      mrg <mrg%NetBSD.org@localhost>
date:      Sat Nov 24 01:44:55 2001 +0000

description:
correct sparc64 bootblk/ofwboot pathnames (PR#14701), note ofwboot.net,
clarify sparc example is for sparc and add a sparc64 example, and
finally, add a FILES section describing all the sparc* bootblock files.

diffstat:

 share/man/man8/man8.sparc/installboot.8 |  36 ++++++++++++++++++++++++++++----
 1 files changed, 31 insertions(+), 5 deletions(-)

diffs (80 lines):

diff -r b54514f5a50f -r e5a83c8319f2 share/man/man8/man8.sparc/installboot.8
--- a/share/man/man8/man8.sparc/installboot.8   Sat Nov 24 01:43:20 2001 +0000
+++ b/share/man/man8/man8.sparc/installboot.8   Sat Nov 24 01:44:55 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: installboot.8,v 1.9 2001/09/05 23:53:24 wiz Exp $
+.\"    $NetBSD: installboot.8,v 1.10 2001/11/24 01:44:55 mrg Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -83,11 +83,15 @@
 as
 .Pa /boot .
 For UltraSPARC machines, these files live in
-.Pa /usr/mdec/bootblk.sparc64
+.Pa /usr/mdec/bootblk
 and
-.Pa /usr/mdec/ofwboot.sparc64
+.Pa /usr/mdec/ofwboot
 respectively, and the second-stage program resides in the root directly as
 .Pa /ofwboot .
+The
+.Pa /usr/mdec/ofwboot.net
+file includes netboot support and currently must be used to boot a kernel
+over the network.
 The utility
 .Pa /usr/mdec/binstall
 can be used to properly copy the a second-stage bootprogram to its
@@ -145,6 +149,7 @@
 .Ar boot
 is mounted.
 .El
+.Pp
 The arguments for the UltraSPARC are:
 .Bl -tag -width bootblk
 .It Ar bootblk
@@ -155,14 +160,18 @@
 .El
 .Sh EXAMPLES
 The following command will install the first-stage bootblocks in the
-root filesystem
+root filesystem of a SPARC
 .Pq assumed to be mounted on Dq sd0a
 using the file
 .Pa /boot
 as the second-level boot program:
 .Bd -literal -offset indent
-installboot /boot /usr/mdec/bootxx /dev/rsd0a
+/usr/mdec/installboot /boot /usr/mdec/bootxx /dev/rsd0a
 .Ed
+.Pp
+The following command will perform the same, but for an UltraSPARC machine.
+.Bd -literal -offset indent
+/usr/mdec/installboot /boot /usr/mdec/bootxx /dev/rsd0a
 .Sh BUGS
 .Nm
 requires simultaneous access to the mounted file system and
@@ -174,6 +183,23 @@
 .Nm installboot
 only works in single-user mode
 .Pq or insecure mode - see Xr init 8 .
+.Sh FILES
+.Bl -tag -width /usr/mdec/installboot -compact
+.It Pa /usr/mdec/installboot
+program to install first-stage boot blocks
+.It Pa /usr/mdec/binstall
+front-end script to installing boot blocks
+.It Pa /usr/mdec/bootxx
+SPARC first-stage boot block
+.It Pa /usr/mdec/bootblk
+UltraSPARC first-stage boot block
+.It Pa /usr/mdec/boot
+SPARC second-stage boot block
+.It Pa /usr/mdec/ofwboot
+UltraSPARC second-stage boot block
+.It Pa /usr/mdec/ofwboot.net
+UltraSPARC second-stage network boot block
+.El
 .Sh SEE ALSO
 .Xr disklabel 8 ,
 .Xr init 8