Mention that sparc and sparc64 have UKC.

Also, try to do a better job at describing how the different prom
versions find the bootloader and the kernel filename.

2 files changed, 68 insertions, 19 deletions

diff --git a/share/man/man8/man8.sparc/boot_sparc.8 b/share/man/man8/man8.sparc/boot_sparc.8
index 1386714d8fc..048bb1226c6 100644
--- a/share/man/man8/man8.sparc/boot_sparc.8
+++ b/share/man/man8/man8.sparc/boot_sparc.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: boot_sparc.8,v 1.3 2001/10/04 23:36:41 miod Exp $
+.\"	$OpenBSD: boot_sparc.8,v 1.4 2001/10/14 21:02:18 miod Exp $
 .\"	$NetBSD: boot_sparc.8,v 1.4 1995/04/25 11:37:25 pk Exp $
 .\"
 .\" Copyright (c) 1992, 1993
@@ -53,13 +53,14 @@ and unless this fails, the system will resume multi-user operations.
 System boot blocks are installed near the start of the boot disk
 using the procedure described in
 .Xr installboot 8 .
-The boot program attempts to load
-.Pa bsd
-from partition
+The boot program attempts to load the kernel from partition
 .Dq a
 of the boot device,
 which must currently be an
-.Dq sd
+.Dq sd ,
+.Dq xd
+or
+.Dq xy
 disk.
 .Pp
 The
@@ -69,6 +70,12 @@ The
 .Fl a
 flag instructs the system to prompt for the location of the root filesystem
 and the primary swap partition.
+The
+.Fl c
+flag instructs the system to enter the
+.Dq User Kernel Config
+mode upon startup (see
+.Xr boot_config 8 ).
 Other flags are currently ignored.
 .Pp
 The SPARC boot ROM comes in two flavours: an
@@ -101,21 +108,56 @@ incantation in new-mode to force the ROM to always start in new-mode:
 .Pp
 .Em \	ok
 setenv sunmon-compat? false
+.Ss Old-style PROM operation
+By default, the old ROM will poll for boot devices, unless the eeprom settings
+are set to specify a particular boot device.
+The
+.Ox
+bootloader will then look for a kernel named
+.Dq bsd
+by default, unless a different filename has been specified in the boot
+command.
+.Pp
+Refer to the
+.Dq PROM User's Manual
+for more information.
+.Ss OpenBoot PROM version 1 operation
+Older OpenBOOT PROM, as well as hybrid (dual-mode) versions operating in
+compatibility mode (with the variable
+.Dq version2?
+set to false) will look for a bootloader and kernel filename as specified
+by the
+.Dq boot-from
+variable.
+To change the default so that
+.Ox
+will be loaded, type the following:
 .Pp
-The ROM will normally load the kernel from
-.Dq sd(0,0,0)vmunix ,
-except on the sun4 machines, where it will look for
-.Dq sd(0,0,0)bsd .
-The OpenBSD bootloader will look for a kernel named
+.Em \	ok
+setenv boot-from sd(0,0,0)bsd
+.Pp
+Replace
+.Dq sd(0,0,0)
+with the appropriate boot device if necessary.
+.Ss OpenBoot PROM version 2 operation
+Version 2 OpenBOOT PROM will look for a bootloader on the device specified
+by the
+.Dq boot-device
+variable.
+The
+.Ox
+bootloader will then look for a kernel named
 .Dq bsd
-by default, unless (on sun4c or sun4m only) the
+by default, unless the
 .Dq boot-file
-environment variable is set.
+environment variable is set, or a different filename has been specified
+in the boot command.
 To reset this variable to its default, empty, value, type the following:
 .Pp
 .Em \	ok
 set-default boot-file
 .Pp
+.Ss Accessing the PROM during runtime
 If the
 .Xr sysctl 8
 variable
@@ -138,6 +180,7 @@ system code
 system bootstrap
 .El
 .Sh SEE ALSO
+.Xr boot_config 8 ,
 .Xr crash 8 ,
 .Xr disklabel 8 ,
 .Xr fsck 8 ,
diff --git a/share/man/man8/man8.sparc64/boot_sparc64.8 b/share/man/man8/man8.sparc64/boot_sparc64.8
index d351599ec97..2712ba9cca2 100644
--- a/share/man/man8/man8.sparc64/boot_sparc64.8
+++ b/share/man/man8/man8.sparc64/boot_sparc64.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: boot_sparc64.8,v 1.1 2001/10/05 07:52:20 miod Exp $
+.\"	$OpenBSD: boot_sparc64.8,v 1.2 2001/10/14 21:02:25 miod Exp $
 .\"
 .\" Copyright (c) 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -52,9 +52,7 @@ and unless this fails, the system will resume multi-user operations.
 System boot blocks are installed near the start of the boot disk
 using the procedure described in
 .Xr installboot 8 .
-The boot program attempts to load
-.Pa bsd
-from partition
+The boot program attempts to load the kernel from partition
 .Dq a
 of the boot device,
 which must currently be an
@@ -70,9 +68,15 @@ The
 .Fl a
 flag instructs the system to prompt for the location of the root filesystem
 and the primary swap partition.
+The
+.Fl c
+flag instructs the system to enter the
+.Dq User Kernel Config
+mode upon startup (see
+.Xr boot_config 8 ).
 Other flags are currently ignored.
 .Pp
-The ULTRAsparc OpenFirmware will normally load the kernel from the device and
+The UltraSPARC OpenFirmware will normally load the kernel from the device and
 filename as instructed by the
 .Dq boot-device
 and
@@ -83,12 +87,13 @@ If the
 variable is empty, the
 .Ox
 bootloader will look for a kernel named
-.Dq bsd .
+.Dq bsd ,
+unless a different filename has been specified in the boot command.
 To reset this variable to its default, empty, value, type the following:
 .Pp
 .Em \	ok
 set-default boot-file
-.Pp
+.Ss Accessing the PROM during runtime
 If the
 .Xr sysctl 8
 variable
@@ -111,6 +116,7 @@ system code
 system bootstrap
 .El
 .Sh SEE ALSO
+.Xr boot_config 8 ,
 .Xr crash 8 ,
 .Xr disklabel 8 ,
 .Xr fsck 8 ,