340 lines
8.8 KiB
Groff
340 lines
8.8 KiB
Groff
.\" $NetBSD: boot.8,v 1.2 2004/08/12 14:43:33 wiz Exp $
|
|
.\"
|
|
.\" $OpenBSD: boot_hppa.8,v 1.11 2004/05/25 22:27:44 jmc Exp $
|
|
.\"
|
|
.\" Copyright (c) 2002, Miodrag Vallat.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" 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.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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.
|
|
.\"
|
|
.Dd July 27, 2004
|
|
.Dt BOOT 8 hp700
|
|
.Os
|
|
.Sh NAME
|
|
.Nm boot
|
|
.Nd hp700 system bootstrapping procedures
|
|
.Sh DESCRIPTION
|
|
.Ss System starts
|
|
When powered on, after a panic, or if the system is rebooted via
|
|
.Xr reboot 8
|
|
or
|
|
.Xr shutdown 8 ,
|
|
the hp700 firmware
|
|
.Pq Dq PDC
|
|
will proceed to its initialization, and will boot an operating system
|
|
if autoboot is enabled.
|
|
.\"
|
|
.Ss Boot process description
|
|
System boot blocks are provided as a
|
|
.Dq LIF
|
|
.Pq Logical Interchange Format
|
|
archive, either on a disk device, or via the network, using the
|
|
.Em bootp
|
|
or
|
|
.Em rboot
|
|
protocols, depending on the PDC version.
|
|
.\" A small
|
|
.\" .Xr mkboot 8
|
|
.\" utility
|
|
.\" is provided for combining primary boot and a number
|
|
.\" of images (OS kernels or standalone binaries)
|
|
.\" into one
|
|
.\" .Dq LIF
|
|
.\" volume suitable for booting.
|
|
.Ss PDC concepts
|
|
If autoboot is enabled, the PDC will attempt to boot from the specified
|
|
.Dq boot path
|
|
value.
|
|
If no
|
|
.Dq boot path
|
|
has been specified, the PDC will then scan for bootable devices and
|
|
boot from the first found, after a few seconds allowing the user to
|
|
interrupt the boot process.
|
|
If autoboot is disabled, the PDC will enter interactive mode, after an
|
|
optional device scan.
|
|
In all cases, it is possible to enter interactive mode by holding the
|
|
escape key during the selftests, or when prompted to do so to abort
|
|
the current operation, unless the PDC has been configured in
|
|
.Dq secure mode .
|
|
.\"
|
|
.Ss ISL interaction
|
|
.Dq ISL
|
|
stands for
|
|
.Dq Initial System Loader
|
|
and is the
|
|
.Nm
|
|
program in
|
|
.Nx .
|
|
On all versions of the PDC except for the 712 and 725 models the
|
|
.Dq boot
|
|
command (see below) will be followed by the question:
|
|
.Dq Interact with IPL (Y, N, or Cancel)?\*[Gt]
|
|
where a positive answer will invoke an interactive prompt in the
|
|
.Nm
|
|
program later and negative will thus suppress it.
|
|
A cancellation will abort the boot process.
|
|
.Pp
|
|
On the 712 and 725 models firmware an additional
|
|
.Dq isl
|
|
argument should be given to the
|
|
.Dq boot
|
|
command to invoke the
|
|
.Nm
|
|
interactive prompt.
|
|
The default behaviour is a non-interactive boot process.
|
|
.\"
|
|
.Ss Old PDC operation
|
|
This version is used on the following models:
|
|
705, 7x0, 715/33/50/75, 725/50/75, 735, 755.
|
|
There are two levels of interactive commands in this version.
|
|
The first level is a short menu:
|
|
.Bd -literal -offset indent
|
|
b) Boot from specified device
|
|
s) Search for bootable device
|
|
a) Enter Boot Administration mode
|
|
x) Exit and continue boot sequence
|
|
|
|
Select from menu:
|
|
.Ed
|
|
.Pp
|
|
which provides the following commands:
|
|
.Bl -tag -width "XXX" -offset indent -compact
|
|
.Pp
|
|
.It Cm b
|
|
boot from a device found during the scan,
|
|
either with its short
|
|
.Dq P#
|
|
form, or a complete name specification.
|
|
For example, to boot from the
|
|
.Tn SCSI
|
|
disk with id 6 off the built-in (first) controller,
|
|
one would enter
|
|
.Ic b Ar scsi.6.0 .
|
|
.It Cm s
|
|
rescan for bootable devices.
|
|
.It Cm a
|
|
enter the second part of interactive mode.
|
|
.It Cm x
|
|
resume an interrupted boot sequence.
|
|
.El
|
|
.Pp
|
|
The
|
|
.Dq Boot Administration
|
|
mode, recognizable with its
|
|
.Em BOOT_ADMIN\*[Gt]
|
|
prompt, controls the various boot options.
|
|
The complete list of commands depends on the machine and PDC version.
|
|
The following list only mentions commands impacting the boot process.
|
|
.Bl -tag -width AUTOSELECT -offset indent
|
|
.It AUTOSELECT
|
|
Displays or changes the autoboot setting.
|
|
If autoselect is set to
|
|
.Dq on ,
|
|
the PDC will always attempt to boot the first bootable device found in
|
|
this order:
|
|
.Bl -enum -offset indent -compact
|
|
.It
|
|
Boot device
|
|
.Em path
|
|
setting.
|
|
.It
|
|
.Tn SCSI
|
|
devices connected to the built-in
|
|
.Tn SCSI
|
|
controller,
|
|
the highest ID numbers being preferred.
|
|
.It
|
|
Network
|
|
.Em rboot
|
|
server (see also
|
|
.Xr rbootd 8 ) .
|
|
.It
|
|
Other
|
|
.Tn SCSI
|
|
devices connected to secondary controllers,
|
|
the highest ID numbers being preferred.
|
|
.El
|
|
If the
|
|
.Em primary path
|
|
setting defines a bootable device, no device scan will occur.
|
|
.It BOOT
|
|
Boots off the specified device.
|
|
It is similar to the
|
|
.Ic b
|
|
command from the short menu above.
|
|
The
|
|
.Dq primary
|
|
and
|
|
.Dq alternate
|
|
path settings may be booted with
|
|
.Ic boot Ar pri
|
|
and
|
|
.Ic boot Ar alt
|
|
respectively.
|
|
.It PATH
|
|
Displays or changes the boot and console devices.
|
|
The boot device is defined as the
|
|
.Dq primary
|
|
path, and another setting may be stored as the
|
|
.Dq alternate
|
|
path for rescue purposes.
|
|
For example, to define the primary boot path to the
|
|
.Tn SCSI
|
|
disk with ID 5 connected to the built-in controller, one would enter
|
|
.Ic path primary Ar scsi.5
|
|
.Pp
|
|
When invoked without parameters,
|
|
.Ic path
|
|
will list the various path settings.
|
|
.El
|
|
.\"
|
|
.Ss Modern PDC operation
|
|
Machines equipped with 7100LC, 7200, or 7300LC CPU types are
|
|
usually blessed with a different kind of PDC.
|
|
There is only one interactive mode, with a
|
|
.Em BOOT_ADMIN\*[Gt]
|
|
prompt, which provides both boot settings and commands.
|
|
The complete list of commands depends on the machine and PDC version.
|
|
The following list only mentions commands impacting the boot process.
|
|
.Bl -tag -width auto\ search -offset indent
|
|
.It Ic auto boot
|
|
Displays or changes the autoboot setting.
|
|
If
|
|
.Ic auto boot
|
|
is set to
|
|
.Dq on ,
|
|
the PDC will always attempt to boot.
|
|
The booted device chosen will depend on the
|
|
.Ic auto search
|
|
setting.
|
|
.It Ic auto search
|
|
Displays or changes the device scan setting.
|
|
If
|
|
.Ic auto search
|
|
is set to
|
|
.Dq on ,
|
|
the PDC will attempt to boot the first bootable device found in
|
|
this order:
|
|
.Bl -enum -offset indent -compact
|
|
.It
|
|
Boot device
|
|
.Em path
|
|
setting.
|
|
.It
|
|
.Tn SCSI
|
|
devices connected to the built-in
|
|
.Tn SCSI
|
|
controller,
|
|
the highest ID numbers being preferred.
|
|
.It
|
|
Network
|
|
.Em bootp
|
|
server (see also
|
|
.Xr dhcpd 8 ) .
|
|
.It
|
|
Other
|
|
.Tn SCSI
|
|
devices connected to secondary controllers,
|
|
the highest ID numbers being preferred.
|
|
.El
|
|
If
|
|
.Ic auto search
|
|
is set to
|
|
.Dq off
|
|
and the primary boot path points to a bootable device,
|
|
no device scan will occur.
|
|
.Pp
|
|
Note that setting
|
|
.Ic auto search
|
|
to
|
|
.Dq on
|
|
will force autoboot, regardless of the
|
|
.Ic auto boot
|
|
value.
|
|
.It Ic boot
|
|
Boots off the specified device.
|
|
The
|
|
.Dq primary
|
|
and
|
|
.Dq alternate
|
|
path settings may be booted with
|
|
.Ic boot Ar pri
|
|
and
|
|
.Ic boot Ar alt
|
|
respectively.
|
|
.It Ic path
|
|
Displays or changes the boot and console devices.
|
|
The boot device is defined as the
|
|
.Dq primary
|
|
path, and another setting may be stored as the
|
|
.Dq alternate
|
|
path for rescue purposes.
|
|
For example, to define the primary boot path to the
|
|
.Tn SCSI
|
|
disk with ID 5 connected to the built-in controller, one would enter
|
|
.Ic path pri Ar scsi.5 .
|
|
.Pp
|
|
When invoked without parameters,
|
|
.Ic path
|
|
will list the various path settings.
|
|
.El
|
|
.\"
|
|
.Ss Abnormal system termination
|
|
If the system crashes, it will enter the kernel debugger,
|
|
.Xr ddb 4 ,
|
|
if it is configured in the kernel.
|
|
If the crash occurred during
|
|
initialization and the debugger is not present or is exited, the
|
|
kernel will halt the system.
|
|
If the crash occurred during normal operation and the debugger
|
|
is not present or is exited, the system will attempt a dump to the
|
|
configured dump device (which will be automatically recovered with
|
|
.Xr savecore 8
|
|
during the next multi-user boot cycle), and after the dump is complete
|
|
(successful or not) the kernel will attempt a reboot.
|
|
.Sh FILES
|
|
.Bl -tag -width /usr/mdec/xxbootxx -compact
|
|
.It Pa boot.lif
|
|
network bootstrap and kernel combined image
|
|
.It Pa /netbsd
|
|
default
|
|
.Nx
|
|
system kernel
|
|
.It Pa /usr/mdec/xxboot
|
|
primary bootstrap for
|
|
.Dq ffs
|
|
file system
|
|
.It Pa /usr/mdec/boot
|
|
system bootstrap (usually also installed as
|
|
.Pa /boot )
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr ddb 4 ,
|
|
.Xr dhcpd 8 ,
|
|
.Xr halt 8 ,
|
|
.Xr init 8 ,
|
|
.Xr installboot 8 ,
|
|
.Xr rbootd 8 ,
|
|
.Xr reboot 8 ,
|
|
.Xr savecore 8 ,
|
|
.Xr shutdown 8
|