From 70eaf1d62ac5ddbbd506c70816138080da14b1c9 Mon Sep 17 00:00:00 2001 From: mellon Date: Wed, 18 Jan 1995 06:12:48 +0000 Subject: [PATCH] Fixed formatting and expanded content --- sbin/reboot/reboot_pmax.8 | 91 +++++++++++++++++++++++++++++---------- 1 file changed, 69 insertions(+), 22 deletions(-) diff --git a/sbin/reboot/reboot_pmax.8 b/sbin/reboot/reboot_pmax.8 index 7061495b8485..f400b4b541a0 100644 --- a/sbin/reboot/reboot_pmax.8 +++ b/sbin/reboot/reboot_pmax.8 @@ -34,7 +34,7 @@ .\" SUCH DAMAGE. .\" .\" from: @(#)reboot_sparc.8 5.4 (Berkeley) 7/23/91 -.\" $Id: reboot_pmax.8,v 1.1 1995/01/18 02:01:21 mellon Exp $ +.\" $Id: reboot_pmax.8,v 1.2 1995/01/18 06:12:48 mellon Exp $ .\" .Dd July 23, 1991 .Dt REBOOT 8 @@ -114,25 +114,23 @@ and unless this fails, the system will resume multi-user operations. At power up, all DECstation ROMs consult the .Nm haltaction environment -variable in EEPROM to determine whether or not to autoboot. If this -variable is set to -.Fl h, -the ROM presents a prompt on the console. If -set to -.Fl b, -the ROM attempts to autoboot. +variable in EEPROM to determine whether or not to attempt to boot +automatically. If this +variable is set to \fBh\fR, the ROM prints a prompt on the console and +waits for user commands. If set to \fBb\fR, the ROM attempts to autoboot. .Pp -On the DECstation 2100 and 3100, the autoboot path is stored in the +On the DECstation 2100 and 3100, the path used for automatic booting is +stored in the .Nm bootpath environment variable. The path is made up of a device type specifier (e.g., rz, tz, mop or tftp) followed by -a triplet in the form (x, y, z), followed by a filename to load. +a triplet in the form (x,y,z), followed by a filename to load. .Pp -X is the controller (always 0), y is the SCSI id of the drive to +Within the triplet, x is the controller (always 0), y is the SCSI id of +the drive to boot from or 0 for net boots, and z is the partition to boot from (usually 0 for SCSI devices, always zero for network booting. -Network boots may simply specify () since all three values are -always zero. +For network boots, () may be specified instead of (0,0,0). .Pp The filename is optional for bootp/tftp and mop booting, since in these cases the network protocol can be used to determine which @@ -141,26 +139,61 @@ specified, and when booting off of disk, the filename of a kernel must be specified. Generally, the kernel is named .Nm netbsd. .Pp -For autoboots, the ROM automatically passes a -.Fl -a +An example bootpath setting would be: +.nf +.sp 1 +.ce 1 +setenv bootpath rz(0,1,0)netbsd +.fi +.Pp +For automatic boots, the ROM automatically passes a +.Fl a argument to the boot -loader, indicating an autoboot. If booting is invoked manually, -the -.Fl -a -argument is passed only when the +loader, requesting that +.Tn NetBSD +attempt to come up to multi-user mode. At the boot ROM prompt, +the user may boot +.Tn NetBSD +with either the .Nm auto -command is used. +or the +.Nm boot +command. If the +.Nm auto +command is used, the +.Fl a +argument is passed to the kernel, requesting a multi-user boot; otherwise +the +.Fl s +argument is passed, requesting that +.Tn NetBSD +boot to single user mode. +.Pp +When either the +.Nm boot +or the +.Nm auto +command is issued with no arguments, the kernel specified in the bootpath +environment variable is booted. An alternate kernel may be specified +with the +.Fl f +flag, followed by the path of the kernel to boot, as described above. +For example: +.sp 1 +.ce 1 +boot -f rz(0,4,0)netbsd.new .Pp On TurboChannel machines (all DECstation 5000 models), the boot path is specified in the boot environment variable, along with any arguments to be passed to the kernel. Note that to specify boot arguments (e.g., -.Fl -a -) when setting the +.Fl a) +when setting the .Nm boot environment variable, the filename and arguments must be enclosed in quotes. For example: .nf .sp 1 +.ce 1 setenv boot "3/rz4/netbsd -a" .fi .Pp @@ -182,6 +215,20 @@ disks or tz# for tapes, where # is the SCSI id of the device. For network devices, the option-specific protocol identifier is either mop or tftp. Filename requirements are as for the DECstation 2100 and 3100. .Pp +To start +.Tn NetBSD +from the boot prompt, the +.Nm boot +command must be used. With no arguments, this simply boots the default +kernel with the default arguments as set with +.Nm setenv +.Nm boot. +If no boot environment variable is set or if an alternate kernel is to be +booted, the path of that kernel may be specified after the boot command as +described above, and any arguments may be passed similarly. For example: +.sp 1 +.ce 1 +boot 3/rz4/netbsd.new -a .Sh SEE ALSO .Xr crash 8m , .Xr fsck 8 ,