xref: /openbsd-src/share/man/man8/man8.sparc64/boot_sparc64.8 (revision 2b0358df1d88d06ef4139321dd05bd5e05d91eaf)
1.\"	$OpenBSD: boot_sparc64.8,v 1.12 2007/05/31 19:20:00 jmc 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 $Mdocdate: May 31 2007 $
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 CD-ROM
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
115.Pq also known as the Dq stop key
116and
117.Dq a
118keys at the same time (if the console is a serial port the same is
119achieved by sending a
120.Dq break ) ,
121and entering
122.Ic machine prom
123at the prompt.
124If you do this accidentally you can continue whatever was in progress
125by typing
126.Ic go
127at the PROM prompt, and then
128.Ic cont
129to return to the system.
130.Sh FILES
131.Bl -tag -width /usr/mdec/ofwboot.net -compact
132.It Pa /bsd
133default system kernel
134.It Pa /bsd.rd
135standalone installation kernel, suitable for disaster recovery
136.It Pa /usr/mdec/bootblk
137primary bootstrap for
138.Dq ffs
139file system
140.It Pa /usr/mdec/ofwboot
141secondary bootstrap (usually also installed as
142.Pa /ofwboot )
143.It Pa /usr/mdec/ofwboot.net
144network bootstrap
145.El
146.Sh SEE ALSO
147.Xr ddb 4 ,
148.Xr boot_config 8 ,
149.Xr halt 8 ,
150.Xr init 8 ,
151.Xr installboot 8 ,
152.Xr reboot 8 ,
153.Xr savecore 8 ,
154.Xr shutdown 8
155