From ef359ff158d4f6ed2b5f6bf66a37659e6216c3bd Mon Sep 17 00:00:00 2001 From: Miod Vallat Date: Sun, 14 Oct 2001 21:02:26 +0000 Subject: 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. --- share/man/man8/man8.sparc/boot_sparc.8 | 67 ++++++++++++++++++++++++------ share/man/man8/man8.sparc64/boot_sparc64.8 | 20 +++++---- 2 files changed, 68 insertions(+), 19 deletions(-) (limited to 'share/man') 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 , -- cgit v1.2.3