1.\" $NetBSD: boot.8,v 1.25 2004/01/02 15:19:47 wiz Exp $ 2.\" 3.\" Copyright (c) 1992, 1993 4.\" The Regents of the University of California. All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. Neither the name of the University nor the names of its contributors 15.\" may be used to endorse or promote products derived from this software 16.\" without specific prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 22.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28.\" SUCH DAMAGE. 29.\" 30.\" @(#)boot_sparc.8 8.2 (Berkeley) 4/19/94 31.\" 32.Dd January 2, 2004 33.Dt BOOT 8 sparc 34.Os 35.Sh NAME 36.Nm boot 37.Nd 38system bootstrapping procedures 39.Sh SYNOPSIS 40.Nm boot 41.Op Fl adqsv 42.Oo 43.Ar -- 44.Aq Ar boot string 45.Oc 46.Sh DESCRIPTION 47.Ss Power fail and crash recovery 48Normally, the system will reboot itself at power-up or after crashes. 49An automatic consistency check of the file systems will be performed 50as described in 51.Xr fsck 8 , 52and unless this fails, the system will resume multi-user operations. 53.Ss Cold starts 54The 55.Nx 56boot 57.Pa netbsd 58from partition a of the boot device, 59which must currently be an 60.Dq sd 61disk. 62.Ss Boot program options 63.Bl -tag -width xxx 64.It Fl a 65Prompt for the root file system device, the system crash dump 66device, and the path to 67.Xr init 8 . 68.It Fl d 69Bring the system up in debug mode. 70Here it waits for a kernel debugger connect; see 71.Xr gdb 1 . 72.It Fl C 73Boot kernel in compat mode. 74Starting with revision 1.14 75.Pq introduced on 2003/03/01 , 76the sparc boot program loads the 77.Nx 78kernel at its linked virtual address. 79This feature requires a kernel built after 2003/02/21 80.Pq corresponding to kernel version 1.6Q . 81To load older kernels, the 82.Fl C 83option must be used, which loads the kernel at physical address 840x4000. 85The size of a kernel loaded in this way is limited to approximately 863MB. 87.It Fl q 88Boot the system in quiet mode. 89.It Fl s 90Bring the system up in single-user mode. 91.It Fl v 92Boot the system in verbose mode. 93.El 94.Pp 95Any extra flags or arguments, or the 96.Aq Ar boot string 97after the -- separator are passed to the boot PROM. 98Other flags are currently ignored. 99.Pp 100The SPARC boot ROM comes in two flavours: an 101.Dq old-style 102ROM is used in sun4 machines, while a 103.Dq new-style 104ROM can be found on sun4c and sun4m models. 105The 106.Dq new-style 107SPARC boot ROM is a full-featured Forth system with emacs key bindings. 108It can be put in 109.Dq old-style 110user-interface compatibility mode (in which case it shows a simple 111.Sq \*[Gt] 112prompt), but this is essentially useless. 113However, by default the ROM runs in old-mode; to enter new-mode type 114.Sq n . 115The ROM then shows a Forth-style 116.Dq ok 117prompt. 118It is recommended to have the ROM always start in its native 119.Dq new-style 120mode. 121Utter the following incantation in new-mode to force the ROM to always start 122in new-mode. 123.Pp 124.Pa \ ok 125setenv sunmon-compat? false 126.Pp 127The ROM will normally load the kernel from 128.Dq sd(0,0,0)vmunix . 129To change the default so that 130.Nx 131will be loaded from somewhere else, type the following 132.Pp 133.Pa \ ok 134setenv boot-from sd(0,0,0)netbsd 135.Pp 136At any time you can break back to the ROM by pressing the 137.Sq L1 138and 139.Sq a 140keys at the same time (if the console is a serial port the same is 141achieved by sending a 142.Sq break ) . 143If you do this accidentally you can continue whatever was in progress 144by typing 145.Sq go . 146.Sh FILES 147.Bl -tag -width /netbsdxx -compact 148.It Pa /netbsd 149system code 150.It Pa /boot 151system bootstrap 152.El 153.Sh SEE ALSO 154.\" .Xr crash 8 , 155.Xr disklabel 8 , 156.Xr fsck 8 , 157.Xr halt 8 , 158.Xr init 8 , 159.Xr installboot 8 , 160.Xr rc 8 , 161.Xr shutdown 8 , 162.Xr syslogd 8 163