xref: /netbsd-src/share/man/man8/man8.prep/boot.8 (revision 8b0f9554ff8762542c4defc4f70e1eb76fb508fa)
1.\" $NetBSD: boot.8,v 1.2 2006/03/23 19:54:43 wiz Exp $
2.\" Copyright (c) 2006 The NetBSD Foundation, Inc.
3.\" All rights reserved.
4.\"
5.\" This code is derived from software contributed to The NetBSD Foundation
6.\" by Tim Rightnour
7.\"
8.\" Redistribution and use in source and binary forms, with or without
9.\" modification, are permitted provided that the following conditions
10.\" are met:
11.\" 1. Redistributions of source code must retain the above copyright
12.\"    notice, this list of conditions and the following disclaimer.
13.\" 2. Redistributions in binary form must reproduce the above copyright
14.\"    notice, this list of conditions and the following disclaimer in the
15.\"    documentation and/or other materials provided with the distribution.
16.\" 3. All advertising materials mentioning features or use of this software
17.\"    must display the following acknowledgement:
18.\"        This product includes software developed by the NetBSD
19.\"        Foundation, Inc. and its contributors.
20.\" 4. Neither the name of The NetBSD Foundation nor the names of its
21.\"    contributors may be used to endorse or promote products derived
22.\"    from this software without specific prior written permission.
23.\"
24.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
25.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
26.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
27.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
28.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34.\" POSSIBILITY OF SUCH DAMAGE.
35.\"
36.Dd March 23, 2006
37.Dt BOOT 8 prep
38.Os
39.Sh NAME
40.Nm boot
41.Nd system bootstrapping procedures
42.Sh SYNOPSIS
43.Nm boot
44.Sh DESCRIPTION
45.Ss Power fail and crash recovery
46Normally, the system will reboot itself at power-up or after crashes.
47An automatic consistency check of the file systems will be performed
48as described in
49.Xr fsck 8 ,
50and unless this fails, the system will resume multi-user operations.
51.Ss Cold starts
52The prep architecture does not allow the direct booting of a kernel
53from the hard drive.
54Instead it requires a complete boot image to be loaded.
55This boot image contains a
56.Nx
57kernel, which will then provide access to the devices on the machine.
58The image can be placed on any device that the firmware considers
59a bootable device.
60Usually this is either a SCSI disk, tape, CD-ROM, or floppy drive.
61.Ss Boot program options
62The prep architecture and bootloader does not support any option
63parsing at the boot prompt.
64.Ss Boot partition
65The prep port requires a special boot partition on the primary boot
66device in order to load the kernel.
67This partition consists of a PC-style i386 partition label, a small
68bootloader, and a kernel image.
69The prep firmware looks for a partition of type 0x41 (65) and
70expects the bootloader, immediately followed by the kernel, to be
71there.
72The
73.Xr mkbootimage 8
74command needs to be used to generate this image.
75.Sh FILES
76.Bl -tag -width /usr/mdec/boot_com0xx -compact
77.It Pa /netbsd
78system code
79.It Pa /usr/mdec/boot
80system bootstrap
81.It Pa /usr/mdec/boot_com0
82system bootstrap with serial console
83.El
84.Sh SEE ALSO
85.Xr disklabel 8 ,
86.Xr fsck 8 ,
87.Xr halt 8 ,
88.Xr init 8 ,
89.Xr installboot 8 ,
90.Xr mkbootimage 8 ,
91.Xr rc 8 ,
92.Xr shutdown 8 ,
93.Xr syslogd 8
94