1.\" $OpenBSD: boot_sparc64.8,v 1.18 2022/09/05 10:29:28 kn 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: September 5 2022 $ 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 47The sparc64 boot process is split into two parts: a small first-stage bootblock 48that is written into the superblock area of a partition 49.Po 50and hence is limited in size to SBSIZE - DEV_BSIZE bytes 51.Pc , 52and a second-stage boot program that resides in the filesystem proper. 53The first-stage bootblock is loaded into memory by the PROM. 54After it receives control, it loads the second-stage boot program 55.Sy ofwboot 56from the filesystem. 57The second-stage boot program uses the device driver interface to 58the PROM and the stand-alone filesystem code in 59.Pa libsa.a 60to locate and load the kernel. 61The first-stage bootblock and second-stage boot program can be found in 62.Pa /usr/mdec/bootblk 63and 64.Pa /usr/mdec/ofwboot 65respectively. 66The second-stage boot program commonly resides in the root directory as 67.Pa /ofwboot . 68.Pp 69The boot program attempts to load the kernel from the selected 70boot device, which must currently be an SCSI 71.Pq Pa sd 72or IDE 73.Pq Pa wd 74disk drive, or a CD-ROM 75.Pq Pa cd , 76or an SCSI tape drive 77.Pq Pa st . 78.Pp 79The UltraSPARC Open Firmware 80will normally look for a bootloader on the device specified by the 81.Va boot-device 82variable. 83The 84.Ox 85bootloader will then look for a kernel named 86.Pa bsd 87by default, unless the 88.Va boot-file 89variable contains a filename, or a different filename has been specified 90in the boot command. 91To reset this variable to its default, empty, value, type the following: 92.Pp 93.D1 Sy ok Li set-default boot-file 94.Pp 95Autoboot is enabled by setting the 96.Va auto-boot?\& 97variable to 98.Dq true , 99and is the factory default. 100.Ss Boot process options 101The following options are recognized: 102.Pp 103.Bl -tag -width "-XXX" -offset indent -compact 104.It Fl a 105Prompt for the root filesystem and swap devices after the devices have 106been configured. 107.It Fl c 108Enter the 109.Dq User Kernel Configuration 110mode upon startup 111.Pq see Xr boot_config 8 . 112.It Fl d 113Enter the debugger, 114.Xr ddb 4 , 115as soon as the kernel console has been initialized. 116.It Fl s 117Boot the system single-user. 118The system will be booted multi-user unless this option is specified. 119.El 120.Ss Accessing the PROM during runtime 121If the 122.Xr sysctl 8 123variable 124.Va ddb.console 125is enabled, at any time you can break back to the ROM by pressing the 126.Sq L1 127.Pq also known as the Dq stop key 128and 129.Sq a 130keys at the same time (if the console is a serial port the same is 131achieved by sending a 132.Dq break ) , 133and entering 134.Ic machine prom 135at the prompt. 136If you do this accidentally you can continue whatever was in progress 137by typing 138.Ic go 139at the PROM prompt, and then 140.Ic cont 141to return to the system. 142.Sh FILES 143.Bl -tag -width /usr/mdec/ofwboot.net -compact 144.It Pa /bsd 145default system kernel 146.It Pa /bsd.rd 147standalone installation kernel, suitable for disaster recovery 148.It Pa /usr/mdec/bootblk 149primary bootstrap for 150.Dq ffs 151file system 152.It Pa /usr/mdec/ofwboot 153secondary bootstrap (usually also installed as 154.Pa /ofwboot ) 155.It Pa /usr/mdec/ofwboot.net 156network bootstrap 157.It Pa /usr/mdec/ofwbootfd 158floppy disk bootstrap 159.El 160.Sh SEE ALSO 161.Xr ddb 4 , 162.Xr softraid 4 , 163.Xr boot_config 8 , 164.Xr halt 8 , 165.Xr init 8 , 166.Xr installboot 8 , 167.Xr reboot 8 , 168.Xr savecore 8 , 169.Xr shutdown 8 170