diff options
Diffstat (limited to 'static/netbsd/man8/man8.sparc64/boot.8')
| -rw-r--r-- | static/netbsd/man8/man8.sparc64/boot.8 | 264 |
1 files changed, 264 insertions, 0 deletions
diff --git a/static/netbsd/man8/man8.sparc64/boot.8 b/static/netbsd/man8/man8.sparc64/boot.8 new file mode 100644 index 00000000..31a534f9 --- /dev/null +++ b/static/netbsd/man8/man8.sparc64/boot.8 @@ -0,0 +1,264 @@ +.\" $NetBSD: boot.8,v 1.18 2014/10/27 16:18:38 wiz Exp $ +.\" +.\" Copyright (c) 1992, 1993 +.\" The Regents of the University of California. 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. +.\" 3. 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_sparc.8 8.2 (Berkeley) 4/19/94 +.\" +.Dd November 9, 2008 +.Dt BOOT 8 sparc64 +.Os +.Sh NAME +.Nm boot , +.Nm ofwboot +.Nd system bootstrapping procedures +.Sh SYNOPSIS +.Nm boot +.Op Fl adqsv +.Oo +.Ar -- +.Aq Ar boot string +.Oc +.Sh DESCRIPTION +.Tn Sun +.Tn UltraSPARC +systems support booting from locally attached storage media +.Pq e.g. hard disk, Tn CD-ROM , +and booting over +.Tn Ethernet +networks using +.Tn BOOTP . +.Ss 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 +as described in +.Xr fsck 8 , +and unless this fails, the system will resume multi-user operations. +.Ss Cold starts +The +.Tn Sun +Open Firmware performs a Power On Self Test +.Pq Tn POST , +and then will boot an operating system according to +configuration in Open Firmware environment variables. +.Ss Boot program options +.Bl -tag -width xxx +.It Fl a +Prompt for the root file system device, the system crash dump +device, and the path to +.Xr init 8 . +.It Fl d +Bring the system up in debug mode. +Here it waits for a kernel debugger connect; see +.Xr gdb 1 . +.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 +.Pp +Any extra flags or arguments, or the +.Aq Ar boot string +after the -- separator are passed to the boot PROM. +Other flags are currently ignored. +.Pp +At any time you can halt the running system and get back to the Open Firmware. +If the console is the +.Tn Sun +framebuffer and keyboard, +press the +.Sq STOP +and +.Sq A +keys at the same time on the keyboard. +On older models of +.Tn Sun +keyboards, the +.Sq STOP +key is labeled +.Sq L1 . +.Pp +If the console is a serial port the same is +achieved by sending a +.Sq BREAK . +.Pp +If you do this accidentally, you can continue whatever was in progress +with the +.Ic go +command. +.Sh BOOT DEVICES +Since machines vary greatly in the way their devices are connected, +there are aliases defined by the firmware. +You can either use the fully qualified +Open Firmware path of a device node, or the alias. +.Pp +The secondary boot loader, +.Nm ofwboot , +takes +.Nm +commands virtually the same as Open Firmware. +Thus, the following examples apply equally to +.Nm ofwboot +as well as Open Firmware. +.Pp +A typical list of usable boot devices (extracted from the output of +the Open Firmware command +.Ic devalias ) +is: +.Bd -literal -offset indent +net /sbus/SUNW,hme@e,8c00000 +disk /sbus/SUNW,fas@e,8800000/sd@0,0 +cdrom /sbus/SUNW,fas@e,8800000/sd@6,0:f +disk6 /sbus/SUNW,fas@e,8800000/sd@6,0 +disk5 /sbus/SUNW,fas@e,8800000/sd@5,0 +disk4 /sbus/SUNW,fas@e,8800000/sd@4,0 +disk3 /sbus/SUNW,fas@e,8800000/sd@3,0 +disk2 /sbus/SUNW,fas@e,8800000/sd@2,0 +disk1 /sbus/SUNW,fas@e,8800000/sd@1,0 +disk0 /sbus/SUNW,fas@e,8800000/sd@0,0 +.Ed +.Pp +If a device specification includes a partition letter (for example +.Em cdrom +in above list), that partition is used by default, otherwise the first (a) +partition is used. +If booting from the net device, there is no partition involved. +.Pp +The boot device is an optional first part of the boot string, if no device +is specified the default device is used (see below). +.Sh FIRMWARE ENVIRONMENT VARIABLES +All Open Firmware environment variables can be printed with the +.Ic printenv +command and changed with the +.Ic setenv +command. +The boot process relevant variables and their suggested value for +booting +.Nx +are: +.Bd -literal -offset indent +boot-command boot +auto-boot? true +boot-file +boot-device disk +diag-switch? false +.Ed +.Pp +Of course you may select any other boot device, +if you do not want to boot from the device aliased to +.Em disk , +see the discussion on devices above. +.Sh FILES +.Bl -tag -width /usr/mdec/ofwboot.netxx -compact +.It Pa /netbsd +system code +.It Pa /ofwboot +system bootstrap +.It Pa /usr/mdec/ofwboot.net +alternate bootstrap when booting from the network, see +.Xr diskless 8 +for details. +.El +.Sh EXAMPLES +Boot from +.Tn CD-ROM : +.Pp +.Bd -literal -offset indent +boot cdrom +.Ed +.Pp +Note that some multi-architecture CDs are not able to use the +default sparc64 partition for +.Tn CD-ROMs +.Pq f , +so they may require an explicit partition letter, for example +.Bd -literal -offset indent +boot cdrom:c +.Ed +.Pp +When using external +.Tn SCSI +.Tn CD-ROM +drives it is important to know two things: the +.Tn Sun +firmware expects the +.Tn SCSI +ID to be six, and the drive must support 512-byte block reads, +in addition to the standard 2048-byte reads. +.Pp +Use +.Bd -literal -offset indent +boot net -sd +.Ed +.Pp +to boot single user from network and break into the kernel debugger as +soon as possible. +.Pp +Use +.Bd -literal -offset indent +boot net tftp:netbsd -a +.Ed +.Pp +to boot a kernel named netbsd obtained via tftp and have it ask for +root file system, swap partition and init location once it is up. +.Pp +During installation from a different operating system +.Bd -literal -offset indent +boot disk:b +.Ed +.Pp +is used to boot a +.Dq miniroot +file system from the swap partition. +.Sh SEE ALSO +.Xr disklabel 8 , +.Xr diskless 8 , +.Xr fsck 8 , +.Xr halt 8 , +.Xr init 8 , +.Xr installboot 8 , +.Xr rc 8 , +.Xr shutdown 8 , +.Xr sparc/boot 8 , +.Xr syslogd 8 +.Sh STANDARDS +.Tn Sun +developed its firmware and promoted it to become +.St -ieee1275-94 . +.Pp +.Lk http://www.openfirmware.org/1275/ "IEEE 1275 Open Firmware" +.Sh BUGS +.Nx +provides no way to boot +.Tn UltraSPARC +systems from floppy disks. +This is unlikely to change, due to very low demand for this feature. +.Pp +The OBP on Ultra 1 and Ultra 2 machines can only boot from the first +4Gb of the disk. |