Update for the new boot system.

This commit is contained in:
minoura 2002-01-15 16:11:21 +00:00
parent 36fef830b3
commit 8c115084b4
1 changed files with 150 additions and 29 deletions

View File

@ -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 @@ floppy disk drive (from 0 to 3) first,
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 @@ which must reside in the battery-backuped SRAM.
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 @@ boot program, xx is disk type
.Xr halt 8 ,
.Xr reboot 8 ,
.Xr shutdown 8
.\" installboot(8) must be written