1.\"	$OpenBSD: boot_sparc64.8,v 1.9 2004/12/27 16:41:15 miod 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 April 19, 1994
33.Dt BOOT_SPARC64 8 sparc64
34.Os
35.Sh NAME
36.Nm boot_sparc64
37.Nd sparc64 system bootstrapping procedures
38.Sh DESCRIPTION
39.Ss System starts
40When powered on, after a panic, or if the system is rebooted via
41.Xr reboot 8
42or
43.Xr shutdown 8 ,
44the PROM will proceed to its initialization, and will boot an operating
45system if autoboot is enabled.
46.Ss Boot process description
47System boot blocks are installed near the start of the boot disk
48using the procedure described in
49.Xr installboot 8 .
50The boot program attempts to load the kernel from the selected
51boot device,
52which must currently be an
53.Tn SCSI
54.Pq Dq sd
55or IDE
56.Pq Dq wd
57disk drive, or a cdrom
58.Pq Dq cd ,
59or an
60.Tn SCSI
61tape drive
62.Pq Dq st .
63.Pp
64The UltraSPARC
65.Tn Open Firmware
66will normally look for a bootloader on the device specified by the
67.Em boot-device
68variable.
69The
70.Ox
71bootloader will then look for a kernel named
72.Pa bsd
73by default, unless the
74.Em boot-file
75variable is set, or a different filename has been specified
76in the boot command.
77To reset this variable to its default, empty, value, type the following:
78.Pp
79.Em \	ok
80set-default
81.Em boot-file
82.Pp
83Autoboot is enabled by setting the
84.Em auto-boot?\&
85variable to
86.Dq true ,
87and is the factory default.
88.Ss Boot process options
89The following options are recognized:
90.Bl -tag -width "-XXX" -offset indent -compact
91.Pp
92.It Fl a
93Prompt for the root filesystem and swap devices after the devices have
94been configured.
95.It Fl c
96Enter the
97.Dq User Kernel Configuration
98mode upon startup
99.Pq see Xr boot_config 8 .
100.It Fl d
101Enter the debugger,
102.Xr ddb 4 ,
103as soon as the kernel console has been initialized.
104.It Fl s
105Boot the system single-user.
106The system will be booted multi-user unless this option is specified.
107.El
108.Ss Accessing the PROM during runtime
109If the
110.Xr sysctl 8
111variable
112.Em ddb.console
113is enabled, at any time you can break back to the ROM by pressing the
114.Dq L1
115and
116.Dq a
117keys at the same time (if the console is a serial port the same is
118achieved by sending a
119.Dq break ) ,
120and entering
121.Ic machine prom
122at the prompt.
123If you do this accidentally you can continue whatever was in progress
124by typing
125.Ic go
126at the PROM prompt, and then
127.Ic cont
128to return to the system.
129.Sh FILES
130.Bl -tag -width /usr/mdec/ofwboot.net -compact
131.It Pa /bsd
132default system kernel
133.It Pa /bsd.rd
134standalone installation kernel, suitable for disaster recovery
135.It Pa /usr/mdec/bootblk
136primary bootstrap for
137.Dq ffs
138file system
139.It Pa /usr/mdec/ofwboot
140secondary bootstrap (usually also installed as
141.Pa /ofwboot )
142.It Pa /usr/mdec/ofwboot.net
143network bootstrap
144.El
145.Sh SEE ALSO
146.Xr ddb 4 ,
147.Xr boot_config 8 ,
148.Xr halt 8 ,
149.Xr init 8 ,
150.Xr installboot 8 ,
151.Xr reboot 8 ,
152.Xr savecore 8 ,
153.Xr shutdown 8
154