.\"	$FabBSD$
.\"	$OpenBSD: boot_macppc.8,v 1.18 2007/05/31 19:19:59 jmc 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. 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_macppc.8
.\"
.Dd $Mdocdate: May 31 2007 $
.Dt BOOT_MACPPC 8 macppc
.Os
.Sh NAME
.Nm boot_macppc
.Nd macppc system bootstrapping procedures
.Sh DESCRIPTION
.Ss System startup
When powered on, after a panic, or if the system is rebooted via
.Xr reboot 8
or
.Xr shutdown 8 ,
the
.Tn Open Firmware
will proceed to its initialization, and will boot an operating system
if the
.Em auto-boot?\&
variable is set to
.Dq true ,
or will wait for interactive commands otherwise.
.Ss Boot process description
The Apple Open Firmware will normally load the kernel from the device and
filename as instructed by the
.Em boot-device
and
.Em boot-file
variables.
If the
.Em boot-file
variable is empty, the FabBSD bootloader will look for a kernel named
.Pa bsd ,
unless a different filename has been specified in the boot command.
To reset this variable to its default, empty, value, type the following:
.Pp
.Em \	ok
set-default
.Em boot-device
.Pp
The FabBSD bootstrap program is named
.Dq ofwboot .
It can be installed either in a HFS partition or in a
MSDOS partition on the disk.
If MBR partitioning is chosen for
the disk, the bootstrap program will be installed automatically during the
FabBSD installation procedure.
For HFS shared disks, the
.Pa ofwboot
file must be installed manually.
The ofwboot program can be loaded from any Open Firmware recognized
disk or network device.
.Ss Boot process options
If invoked manually without parameters, or if the specified kernel could
not be loaded, the FabBSD bootloader will let the user enter a boot device,
kernel filename and boot options.
.Pp
If the special line
.Ic exit
is entered, the bootloader will attempt to restart the machine.
.Pp
The file specification used is of the form:
.Dl promdev:partition/filename options
where:
.Dq promdev
is an optional
.Tn Open Firmware
device name (such as
.Dq hd
or
.Dq ide )
and
.Dq partition
is an optional disk partition number.
Normal line editing characters can be used when typing the file
specification.
.Pp
The following options are recognized:
.Bl -tag -width "-XXX" -offset indent -compact
.Pp
.It Fl a
Prompt for the root filesystem and swap devices after the devices have
been configured.
.It Fl c
Enter the
.Dq User Kernel Config
mode upon startup
.Pq see Xr boot_config 8 .
.It Fl d
Enter the debugger,
.Xr ddb 4 ,
as soon as the kernel console has been initialized.
.It Fl s
Boot the system single-user.
The system will be booted multi-user unless this option is specified.
.El
.Ss Abnormal system termination
In case of system crashes, the kernel will usually enter the kernel
debugger,
.Xr ddb 4 ,
unless it is not present in the kernel, or it is disabled via the
.Em ddb.panic
sysctl.
Upon leaving ddb, or if ddb was not entered, the kernel will halt the system
if it was still in device configuration phase, or attempt a dump to the
configured dump device, if possible.
The crash dump will then be recovered by
.Xr savecore 8
during the next multi-user boot cycle.
It is also possible to force other behaviours from ddb.
.Ss Accessing the PROM
The prom can only be accessed during system reset, or at power-up.
To enter Open Firmware, press and hold
.Dq Cntrl
.Dq Cmd
.Dq o
.Dq f
as the machine resets until it enters the Open Firmware debugger.
.Pp
On an Xserve using serial console the System Identifier button is used to
enter Open Firmware instead of the keyboard.
To enter Open Firmware, hold down the System Identifier button while pressing
the Power button.
When the upper LED bank begins lighting up in sequence, repeatedly press
the System Identifier button until the seventh LED from the right is
highlighted in the lower bank.
Now hold the System Identifier button for two seconds, until all the top
row LEDs light up.
.Sh FILES
.Bl -tag -width /usr/mdec/ofwboot -compact
.It Pa /bsd
default system kernel
.It Pa /bsd.rd
standalone installation kernel, suitable for disaster recovery
.It Pa /usr/mdec/ofwboot
system bootstrap (usually installed on a stand-alone FAT partition or an
.Tn Apple
HFS partition, to be readable by Open Firmware)
.El
.Sh SEE ALSO
.Xr ddb 4 ,
.Xr boot_config 8 ,
.Xr halt 8 ,
.Xr init 8 ,
.Xr reboot 8 ,
.Xr savecore 8 ,
.Xr shutdown 8