Home | History | Annotate | Line # | Download | only in man8.sparc64
boot.8 revision 1.3
 $NetBSD: boot.8,v 1.3 2003/05/01 02:11:01 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. 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_sparc.8 8.2 (Berkeley) 4/19/94

.Dd April 30, 2003 .Dt BOOT 8 sparc64 .Os .Sh NAME .Nm boot .Nd system bootstrapping procedures .Sh SYNOPSIS .Nm boot .Op Fl adqsv .Oo .Ar -- .Aq Ar boot string .Oc .Sh DESCRIPTION .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 .Nx boot

a netbsd from the default boot device, configured via OpenFirmware environment variables. See below for details. .Ss Boot program options l -tag -width xxx t Fl a Prompt for the root file system device, the system crash dump device, and the path to .Xr init 8 . t Fl d Bring the system up in debug mode. Here it waits for a kernel debugger connect; see .Xr gdb 1 . t Fl q Boot the system in quiet mode. t Fl s Bring the system up in single-user mode. t Fl v Boot the system in verbose mode. .El

p 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.

p At any time you can break back to the ROM by pressing the .Sq STOP (labeled .Sq L1 on older keyboard types) and .Sq a keys at the same time (if the console is a serial port the same is achieved by sending a .Sq break ) . If you do this accidentally you can continue whatever was in progress by typing .Sq go . .Sh BOOT DEVICES Since machines vary in the way their devices are connected greatly, there are aliases defined by the firmware. You can either use the full qualified OpenFirmware path of a device node, or the alias.

p A typical list of usable boot devices (extracted from the output of the OpenFirmware command c devalias ) is: d -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

p If a device specification includes a partition letter (for example cdrom in above list) this partition is used by default, otherwise the first (a) partition is used. If booting from the net device, there is no partition involved.

p 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 OpenFirmware environment variables can be printed with the c printenv command and changed with c setenv . The boot process relevant variables and their suggested value for booting .Nx are: d -literal -offset indent boot-command boot auto-boot? true boot-file boot-device disk diag-switch? false .Ed

p 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 l -tag -width /netbsdxx -compact t Pa /netbsd system code t Pa /boot system bootstrap .El .Sh EXAMPLES d -literal -offset indent boot cdrom .Ed Boot from CDROM. Note that some multi-arch CDs are not able to use the default sparc64 partition for CDROMs (f), so they may require an explicit partition letter, for example d -literal -offset indent boot cdrom:c .Ed Another example: d -literal -offset indent boot net -sd .Ed to boot single user from network and break into the kernel debugger as soon as possible. .Sh SEE ALSO .Xr disklabel 8 , .Xr fsck 8 , .Xr halt 8 , .Xr init 8 , .Xr installboot 8 , .Xr rc 8 , .Xr shutdown 8 , .Xr syslogd 8 , .St - IEEE 1275 Open Firmware ,

a http://playground.sun.com/1275