1994-05-26 06:35:07 +00:00
|
|
|
.\" Copyright (c) 1991, 1993
|
|
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
|
|
.\"
|
|
|
|
.\" This code is derived from software written and contributed
|
|
|
|
.\" to Berkeley by William Jolitz.
|
|
|
|
.\"
|
1995-10-07 12:05:00 +00:00
|
|
|
.\" Almost completely rewritten for FreeBSD 2.1 by Joerg Wunsch.
|
|
|
|
.\"
|
1994-05-26 06:35:07 +00:00
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
.\" are met:
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
|
|
.\" must display the following acknowledgement:
|
|
|
|
.\" This product includes software developed by the University of
|
|
|
|
.\" California, Berkeley and its contributors.
|
|
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
|
|
.\" may be used to endorse or promote products derived from this software
|
|
|
|
.\" without specific prior written permission.
|
|
|
|
.\"
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
.\" SUCH DAMAGE.
|
|
|
|
.\"
|
|
|
|
.\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94
|
|
|
|
.\"
|
1999-01-06 14:19:09 +00:00
|
|
|
.\" $Id: boot_i386.8,v 1.14 1998/09/23 06:54:14 yokota Exp $
|
1995-10-07 12:05:00 +00:00
|
|
|
.\"
|
1994-05-26 06:35:07 +00:00
|
|
|
.Dd April 19, 1994
|
|
|
|
.Dt BOOT 8 i386
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm boot
|
|
|
|
.Nd
|
|
|
|
system bootstrapping procedures
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Sy Power fail and crash recovery.
|
|
|
|
Normally, the system will reboot itself at power-up or after crashes.
|
|
|
|
An automatic consistency check of the file systems will be performed,
|
|
|
|
and unless this fails, the system will resume multi-user operations.
|
|
|
|
.Pp
|
|
|
|
.Sy Cold starts.
|
1995-10-07 12:05:00 +00:00
|
|
|
Most 386
|
1994-05-26 06:35:07 +00:00
|
|
|
.Tn "PC AT"
|
1995-10-07 12:05:00 +00:00
|
|
|
clones attempt to boot the floppy disk drive 0 (otherwise known as
|
|
|
|
drive A:) first, and failing that, attempt to boot the hard disk
|
1997-07-05 02:02:02 +00:00
|
|
|
drive 0 (otherwise known as drive C:,
|
|
|
|
or (confusingly) hard disk drive 1, or drive 0x80 in the BIOS).
|
|
|
|
Some BIOSes let you change this default sequence or may include a CD-ROM
|
|
|
|
drive as a boot device.
|
1999-01-06 14:19:09 +00:00
|
|
|
.Pp
|
|
|
|
By default, a three-stage bootstrap is employed, and control is
|
|
|
|
automatically passed from the boot blocks (bootstrap stages one and
|
|
|
|
two) to a separate third-stage bootstrap program,
|
|
|
|
.Pa /boot/loader .
|
|
|
|
This third stage provides considerably more sophisticated control
|
|
|
|
over the booting process than it is possible to achieve in the boot
|
|
|
|
blocks, which are constrained by occupying limited fixed space on a
|
|
|
|
given disk or slice.
|
|
|
|
.Pp
|
|
|
|
However, it is possible to dispense with the third stage altogether,
|
|
|
|
either by specifying a kernel name in the boot block parameter
|
|
|
|
file,
|
|
|
|
.Pa /boot.config ,
|
|
|
|
or by hitting a key during a brief pause (while one of the characters
|
|
|
|
.Dv - ,
|
|
|
|
.Dv \e ,
|
|
|
|
.Dv \&| ,
|
|
|
|
or
|
|
|
|
.Dv /
|
|
|
|
is displayed) before
|
|
|
|
.Pa /boot/loader
|
|
|
|
is invoked. Booting will also be attempted at stage two, if the
|
|
|
|
third stage cannot be loaded.
|
|
|
|
.Pp
|
|
|
|
The remainder of this subsection deals only with the boot blocks.
|
|
|
|
At present, documentation of the third stage is chiefly
|
|
|
|
available though online help in the
|
|
|
|
.Pa /boot/loader
|
|
|
|
program itself.
|
|
|
|
.Pp
|
1997-07-05 02:02:02 +00:00
|
|
|
After the boot blocks have been loaded,
|
|
|
|
you should see a prompt similar to the following:
|
|
|
|
.Bd -literal
|
1999-01-06 14:19:09 +00:00
|
|
|
>> FreeBSD/i386 BOOT
|
|
|
|
Default: 0:wd(0,a)/kernel
|
1997-07-05 02:02:02 +00:00
|
|
|
|
|
|
|
boot:
|
|
|
|
.Ed
|
|
|
|
.Pp
|
|
|
|
(You may see some tips printed on the screen too.)
|
|
|
|
.Pp
|
|
|
|
The automatic boot will attempt to load
|
1995-10-07 12:05:00 +00:00
|
|
|
.Pa /kernel
|
|
|
|
from partition
|
|
|
|
.Ql a
|
|
|
|
of either the floppy or the hard disk.
|
|
|
|
This boot may be aborted by typing any character on the keyboard
|
|
|
|
at the
|
1997-07-05 02:02:02 +00:00
|
|
|
.Ql boot:
|
1995-10-07 12:05:00 +00:00
|
|
|
prompt. At this time, the following input will be accepted:
|
1997-07-05 02:02:02 +00:00
|
|
|
.Bl -tag -width 10x
|
1995-10-07 12:05:00 +00:00
|
|
|
.It \&?
|
|
|
|
Give a short listing of the files in the root directory of the default
|
1999-01-06 14:19:09 +00:00
|
|
|
boot device, as a hint about available boot files. (A
|
|
|
|
.Dv \&?
|
|
|
|
may also be specified as the last segment of a path, in which case
|
|
|
|
the listing will be of the relevant subdirectory.)
|
1998-09-23 06:54:14 +00:00
|
|
|
.It Op bios_drive:interface(unit,part) Op filename Op Fl aCcDdghPrsv
|
1995-10-07 12:05:00 +00:00
|
|
|
Specify boot file and flags.
|
1997-07-05 02:02:02 +00:00
|
|
|
.Bl -tag -width 10x -compact
|
|
|
|
.It bios_drive
|
|
|
|
The drive number as recognized by the BIOS.
|
|
|
|
0 for the first drive, 1 for the second drive, etc.
|
|
|
|
.It interface
|
|
|
|
The type of controller to boot from. Note that the controller is required
|
1995-10-07 12:05:00 +00:00
|
|
|
to have BIOS support since the BIOS services are used to load the
|
|
|
|
boot file image.
|
1994-05-26 06:35:07 +00:00
|
|
|
.Pp
|
1997-07-05 02:02:02 +00:00
|
|
|
The supported interfaces are:
|
|
|
|
.Bl -tag -width "wdXX" -compact
|
1995-10-07 12:05:00 +00:00
|
|
|
.It wd
|
|
|
|
ST506, IDE, ESDI, RLL disks on a WD100[2367] or lookalike
|
|
|
|
controller
|
|
|
|
.It fd
|
|
|
|
5 1/4" or 3 1/2" High density floppies
|
1998-09-23 06:54:14 +00:00
|
|
|
.It da
|
1995-10-07 12:05:00 +00:00
|
|
|
SCSI disk on any supported SCSI controller
|
1997-07-05 02:02:02 +00:00
|
|
|
.\".It cd
|
|
|
|
.\"boot from CDROM
|
1995-10-07 12:05:00 +00:00
|
|
|
.El
|
|
|
|
.It unit
|
1997-07-05 02:02:02 +00:00
|
|
|
The unit number of the drive on the interface being used.
|
|
|
|
0 for the first drive, 1 for the second drive, etc.
|
1995-10-07 12:05:00 +00:00
|
|
|
.It part
|
|
|
|
The partition letter inside the BSD portion of the disk. See
|
1998-07-15 06:51:38 +00:00
|
|
|
.Xr disklabel 8 .
|
1995-10-07 12:05:00 +00:00
|
|
|
By convention, only partition
|
|
|
|
.Ql a
|
|
|
|
contains a bootable image. If sliced disks are used
|
|
|
|
.Pq Dq fdisk partitions ,
|
1999-01-06 14:19:09 +00:00
|
|
|
any slice can be booted from, with the default being the active slice
|
|
|
|
or, otherwise, the first slice.
|
1997-07-05 02:02:02 +00:00
|
|
|
.It filename
|
|
|
|
The pathname of the file to boot (relative to the root directory
|
|
|
|
on the specified partition). Defaults to
|
1999-01-06 14:19:09 +00:00
|
|
|
.Pa /kernel .
|
1995-10-07 12:05:00 +00:00
|
|
|
Symbolic links are not supported (hard links are).
|
1998-09-23 06:54:14 +00:00
|
|
|
.It Fl acCdDghPrsv
|
1995-10-07 12:05:00 +00:00
|
|
|
Boot flags:
|
1997-07-05 02:02:02 +00:00
|
|
|
.Bl -tag -width "-CXX" -compact
|
1995-10-07 12:05:00 +00:00
|
|
|
.It Fl a
|
1997-07-05 02:02:02 +00:00
|
|
|
during kernel initialization,
|
|
|
|
ask for the device to mount as as the root file system.
|
|
|
|
.It Fl C
|
|
|
|
boot from CDROM.
|
1995-10-07 12:05:00 +00:00
|
|
|
.It Fl c
|
|
|
|
run UserConfig to modify hardware parameters for the loaded
|
1998-02-10 00:17:44 +00:00
|
|
|
kernel. If the kernel was built with the USERCONFIG_BOOT option,
|
|
|
|
remain in UserConfig regardless of any
|
|
|
|
.Ic quit
|
|
|
|
commands present in the script.
|
1997-07-05 02:02:02 +00:00
|
|
|
.It Fl D
|
|
|
|
toggle single and dual console configurations. In the single
|
|
|
|
configuration the console will be either the internal display
|
|
|
|
or the serial port, depending on the state of the
|
|
|
|
.Fl h
|
|
|
|
option below. In the dual console configuration,
|
|
|
|
both the internal display and the serial port will become the console
|
|
|
|
at the same time, regardless of the state of the
|
|
|
|
.Fl h
|
|
|
|
option. However, the dual console configuration takes effect only during
|
|
|
|
the boot prompt. Once the kernel is loaded, the console specified
|
|
|
|
by the
|
|
|
|
.Fl h
|
|
|
|
option becomes the only console.
|
1995-10-07 12:05:00 +00:00
|
|
|
.It Fl d
|
|
|
|
enter the DDB kernel debugger
|
|
|
|
.Pq see Xr ddb 4
|
1998-03-23 06:36:57 +00:00
|
|
|
as early as possible in kernel initialization.
|
1997-07-05 02:02:02 +00:00
|
|
|
.It Fl g
|
|
|
|
use the GDB remote debugging protocol.
|
1995-10-07 12:05:00 +00:00
|
|
|
.It Fl h
|
1997-07-05 02:02:02 +00:00
|
|
|
toggle internal and serial consoles. You can use this to switch
|
|
|
|
console devices. For instance, if you boot from the internal console,
|
|
|
|
you can use the
|
|
|
|
.Fl h
|
|
|
|
option to force the kernel to use the serial port as its
|
|
|
|
console device. Alternatively, if you boot from the serial port,
|
|
|
|
you can use this option to force the kernel to use the internal display
|
1998-07-09 06:24:21 +00:00
|
|
|
as the console instead. This option has no effect if the kernel was
|
|
|
|
compiled with
|
|
|
|
.Em options COMCONSOLE .
|
1997-07-05 02:02:02 +00:00
|
|
|
.It Fl P
|
|
|
|
probe the keyboard. If no keyboard is found, the
|
|
|
|
.Fl D
|
|
|
|
and
|
|
|
|
.Fl h
|
|
|
|
options are automatically set.
|
1995-10-07 12:05:00 +00:00
|
|
|
.It Fl r
|
1997-07-05 02:02:02 +00:00
|
|
|
use the statically configured default for the device containing the
|
|
|
|
root file system
|
|
|
|
.Pq see Xr config 8 .
|
|
|
|
Normally, the root file system is on the device
|
|
|
|
that the kernel was loaded from.
|
1995-10-07 12:05:00 +00:00
|
|
|
.It Fl s
|
|
|
|
boot into single-user mode; if the console is marked as
|
|
|
|
.Dq insecure
|
|
|
|
.Pq see Xr ttys 5 ,
|
1998-07-15 06:51:38 +00:00
|
|
|
the root password must be entered.
|
1995-10-07 12:05:00 +00:00
|
|
|
.It Fl v
|
1997-07-05 02:02:02 +00:00
|
|
|
be verbose during device probing (and later).
|
1995-10-07 12:05:00 +00:00
|
|
|
.El
|
|
|
|
.El
|
|
|
|
.El
|
1997-07-05 02:02:02 +00:00
|
|
|
.Pp
|
|
|
|
You may put a BIOS drive number, a controller type, a unit number,
|
|
|
|
a partition, a kernel file name and the
|
|
|
|
.Fl D,
|
|
|
|
.Fl h
|
|
|
|
or
|
|
|
|
.Fl P
|
|
|
|
options in
|
|
|
|
.Pa /boot.config
|
|
|
|
to set defaults. Write them in one line just as you type at the
|
|
|
|
.Ql boot:
|
|
|
|
prompt.
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh FILES
|
1997-07-05 02:02:02 +00:00
|
|
|
.Bl -tag -width /kernel.old.config -compact
|
|
|
|
.It Pa /boot.config
|
1999-01-06 14:19:09 +00:00
|
|
|
parameters for the boot blocks (optional)
|
1997-07-05 02:02:02 +00:00
|
|
|
.It Pa /boot.help
|
1999-01-06 14:19:09 +00:00
|
|
|
help messages (optional)
|
|
|
|
.It Pa /boot/loader
|
|
|
|
third-stage bootstrap
|
1994-08-05 09:14:37 +00:00
|
|
|
.It Pa /kernel
|
1997-07-05 02:02:02 +00:00
|
|
|
default kernel
|
|
|
|
.It Pa /kernel.old
|
|
|
|
typical non-default kernel (optional)
|
1994-05-26 06:35:07 +00:00
|
|
|
.El
|
|
|
|
.Sh SEE ALSO
|
1995-10-07 12:05:00 +00:00
|
|
|
.Xr ddb 4 ,
|
|
|
|
.Xr ttys 5 ,
|
1997-07-05 02:02:02 +00:00
|
|
|
.Xr config 8 ,
|
1997-01-13 00:25:51 +00:00
|
|
|
.Xr disklabel 8 ,
|
1994-05-26 06:35:07 +00:00
|
|
|
.Xr halt 8 ,
|
|
|
|
.Xr reboot 8 ,
|
1997-01-13 00:25:51 +00:00
|
|
|
.Xr shutdown 8
|
1994-05-26 06:35:07 +00:00
|
|
|
.Sh BUGS
|
|
|
|
The disklabel format used by this version of
|
|
|
|
.Bx
|
|
|
|
is quite
|
|
|
|
different from that of other architectures.
|
1995-10-07 12:05:00 +00:00
|
|
|
.Pp
|
1999-01-06 14:19:09 +00:00
|
|
|
Some features are, as yet, undocumented.
|