[src/trunk]: src/share/man/man8/man8.x68k Update for the new boot system.

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

details:   https://anonhg.NetBSD.org/src/rev/b3002d5b7ad2
branches:  trunk
changeset: 520752:b3002d5b7ad2
user:      minoura <minoura%NetBSD.org@localhost>
date:      Tue Jan 15 16:11:21 2002 +0000

description:
Update for the new boot system.

diffstat:

 share/man/man8/man8.x68k/boot.8 |  179 +++++++++++++++++++++++++++++++++------
 1 files changed, 150 insertions(+), 29 deletions(-)

diffs (220 lines):

diff -r 1c8d71cd784b -r b3002d5b7ad2 share/man/man8/man8.x68k/boot.8
--- a/share/man/man8/man8.x68k/boot.8   Tue Jan 15 15:18:11 2002 +0000
+++ b/share/man/man8/man8.x68k/boot.8   Tue Jan 15 16:11:21 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: boot.8,v 1.5 2001/04/12 13:36:54 wiz Exp $
+.\"    $NetBSD: boot.8,v 1.6 2002/01/15 16:11:21 minoura Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -31,9 +31,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"    @(#)boot_x68k.8 8.2 (Berkeley) 4/19/94
+.\"    @(#)boot_i386.8 8.2 (Berkeley) 4/19/94
 .\"
-.Dd June 16, 1996
+.Dd Jan 15, 2002
 .Dt BOOT 8 x68k
 .Os
 .Sh NAME
@@ -54,35 +54,149 @@
 and then attempt to boot from hard disk (SASI or SCSI).
 On the
 .Nx Ns Tn /x68k Ns ,
-booting from partition A of SCSI disks (sd?a)
+booting from SCSI disks (sd??)
 and 2HD floppy disks (fd?a, fd?c) is currently supported.
 .Pp
-First, the initial program loader of IOCS ROM or SCSI disk
-(or equivalent) reads
-.Pa boot
-program at the top of the disk,
-and then the boot program loads the
+.Ss Bootstrappinging from a floppy
+When the floppy disk is selected as the boot device, the initial
+program loader of the IOCS (firmware) reads
+.Pa fdboot_ufs
+program at the top of the disk, and then the fdboot_ufs program loads the
+.Pa /boot
+program from the FFS or LFS filesystem.  Normally, the
+.Pa /boot
+program then loads the
 .Nx
 kernel
 .Pa /netbsd
-which is in the same partition of the disk.
-If you press
-.Pa [SHIFT]
-key when booting, the boot program enables you to change
-boot flag
-.Dv RB_SINGLE
-with the
-.Pa [SHIFT]
-key, and to choose which kernel
-to be used with arrow keys.
-If the LED of
-.Pa [HIRAGANA]
-key is turned on, the boot program adds
-.Dv RB_KDB
-flag and tries to boot the system in debug mode; see
-.Xr ddb 4
-for details.
+from the same floppy.  In addition, the
+.Pa /boot
+program has abilities to uncompress gzip'ed kernel, to read
+the kernel from other disks of other filesystems etc (see below).
+.Pp
+For floppy disks, fdboot_ustar is also provided to read a large
+kernel which does not fit with a single floppy.
+.Ss Bootstrapping from a SCSI hard disk
+When a SCSI hard disk is selected as the boot device, the initial
+program loader on the SCSI host adapter's ROM reads the
+operationg system-independent IPL menu program at the top of the disk.
+IPL menu program recognizes the partition table, and selects the partition
+to read the operating system kernel.  During this phase, when the
+HELP key on the keyboard is pressed, the IPL menu program displays
+the partition menu of that disk to prompt the user to select the boot
+partition (although the
+.Nx
+implementation of the IPL menu,
+.Pa /usr/mdec/mboot ,
+does not have this functionallity).
+.Pp
+Next, the IPL menu reads the OS-dependent boot program from the
+top of the selected partition.  For
+.Nx
+FFS/LFS filesystem
+.Pa sdboot_ufs
+program is used.  The
+.Pa sdboot_ufs
+program then loads the
+.Pa /boot
+program from that partition.
+.Ss Normal Operation
+Once running, a banner similar to the following will appear:
+.Bd -unfilled -offset indent
+NetBSD Multi-boot, Revision 1.1
+(user@buildhost, builddate)
+Press return to boot now, any other key for boot menu
+booting sd0a:netbsd - starting in 5
+.Ed
 .Pp
+After a countdown, the system image listed will be loaded. (In the
+above example, it will be
+.Dq Li sd0a:netbsd
+which is the file
+.Nm netbsd
+on partition
+.Dq a
+of the
+.Nx
+SCSI hard disk of ID 0.
+Pressing a key within the time limit will enter interactive mode.
+.Ss Interactive mode
+In interactive mode, the boot loader will present a prompt, allowing
+input of these commands:
+.Bl -tag -width 04n -offset 04n
+.It Xo Ic boot
+.Op Va device : Ns
+.Op Va filename
+.Op Fl adqsv
+.Xc
+The default
+.Va device
+will be set to the disk that the boot loader was
+loaded from.
+To boot from an alternate disk, the full name of the device should
+be given at the prompt.
+.Va device
+is of the form
+.Xo Va xd
+.Op Va N Ns Op Va x
+.Xc
+where
+.Va xd
+is the device from which to boot,
+.Va N
+is the unit number, and
+.Va x
+is the partition letter.
+.Pp
+The following list of supported devices may vary from installation to
+installation:
+.Pp
+.Bl -hang -compact
+.It sd
+SCSI disks on a controller recognized by the IOCS. The
+unit number is the SCSI ID.
+.It fd
+Floppy drives as numbered by the IOCS.
+.El
+.Pp
+The default
+.Va filename
+is
+.Pa netbsd ;
+if the boot loader fails to successfully
+open that image, it then tries
+.Pa netbsd.gz
+(expected to be a kernel image compressed by gzip).
+Alternate system images can be loaded by just specifying the name of the image.
+.Pp
+Options are:
+.Bl -tag -width xxx
+.It Fl a
+Prompt for the location of the root filesystem and the system crash
+dump device.
+.It Fl d
+Bring the system up in debug mode.  Here it waits for a kernel
+debugger connect; see
+.Xr ddb 4 .
+.It Fl q
+Boot the system in quiet mode.
+.It Fl s
+Bring the system up in single-user mode.
+.It Fl v
+Boot the system in verbose mode.
+.El
+.It Ic help
+Print an overview about commands and arguments.
+.It Ic ls Op Pa path
+Print a directory listing of
+.Pa path ,
+containing inode number, filename and file type.
+.Pa path
+can contain a device specification.
+.It Ic halt
+Reboot the system.
+.El
+.Ss Model-specific notes
 Note for X68030+MC68030 systems:
 Nothing special to be attended to; you can boot
 .Nx
@@ -104,11 +218,17 @@
 Note for X68000/Jupiter-X(68040/060 accelerator by FTZ-net) systems:
 The system must be in 040/060 processor mode.
 .Sh FILES
-.Bl -tag -width /usr/mdec/xxbootxx -compact
+.Bl -tag -width /usr/mdec/xxboot_ufs -compact
 .It Pa /netbsd
 system code
-.It Pa /usr/mdec/xxboot
-boot program, xx is disk type
+.It Pa /netbsd.gz
+gzip-compressed system code
+.It Pa /usr/mdec/xxboot_ufs
+boot block (read by installboot), xx is disktype
+.It Pa /usr/mdec/boot
+source of /boot (can be just copied to the root directory)
+.It Pa /boot
+main part of the boot program
 .El
 .Sh SEE ALSO
 .Xr reboot 2 ,
@@ -116,3 +236,4 @@
 .Xr halt 8 ,
 .Xr reboot 8 ,
 .Xr shutdown 8
+.\" installboot(8) must be written