xref: /netbsd-src/share/man/man8/man8.mvme68k/boot.8 (revision 01869ca4d24a86379a68731bf9706a9f0820fe4e)
1.\"	$NetBSD: boot.8,v 1.9 2017/07/03 21:31:00 wiz 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 8, 2003
33.Dt BOOT 8 mvme68k
34.Os
35.Sh NAME
36.Nm boot
37.Nd
38system bootstrapping procedures
39.\" .Sh SYNOPSIS
40.\" .Nm reboot
41.\" .Op Fl n
42.\" .Op Fl q
43.\" .Oo
44.\" .Ar -- <boot string>
45.\" .Oc
46.Sh DESCRIPTION
47.Ss Power fail and crash recovery
48Normally, the system will reboot itself at power-up or after crashes.
49An automatic consistency check of the file systems will be performed
50as described in
51.Xr fsck 8 .
52and unless this fails, the system will resume multi-user operations.
53.Ss Cold starts from disk
54The disk-boot program
55.Pa ( /usr/mdec/bootsd )
56will attempt to load
57.Pa netbsd
58from partition A of the boot device,
59which must currently be an
60.Dq sd
61disk.
62.Ss Cold starts from tape
63The tape-boot program
64.Pa ( /usr/mdec/bootst )
65will attempt to load
66.Pa netbsd
67from a SCSI tape drive.
68.Ss Cold starts over a network
69The network boot program
70.Pa ( /usr/mdec/netboot )
71will load
72.Pa netbsd
73from the NFS root as determined by the procedure described in
74.Xr diskless 8 .
75Note that the MVME147 is unable to boot directly from the
76network without the help of a small bootloader program
77.Pa ( /usr/mdec/sboot ) .
78.Ss Boot program options
79.Bl -tag -width xxx
80.It Fl a
81Prompt for the root file system device, the system crash dump
82device, and the path to
83.Xr init 8 .
84.It Fl d
85Bring the system up in debug mode.
86Here it waits for a kernel debugger connect; see
87.Xr ddb 4 .
88.It Fl q
89Boot the system in quiet mode.
90.It Fl s
91Bring the system up in single-user mode.
92.It Fl v
93Boot the system in verbose mode.
94.El
95.Pp
96Any extra flags or arguments, or the
97.Ar <boot string>
98after the -- separator are passed to the boot PROM.
99Other flags are currently ignored.
100.Pp
101At any time you can break to the kernel debugger
102.Xr ddb 4
103(assuming
104.Sy options DDB
105was specified in the kernel configuration file)
106by sending a serial line BREAK character.
107If you do this accidentally you can continue whatever was in progress
108by typing
109.Sq c
110followed by the return key.
111.Sh FILES
112.Bl -tag -width /usr/mdec/installboot -compact
113.It Pa /netbsd
114system code
115.It Pa /usr/mdec/bootxx
116first-level boot block for disks
117.It Pa /usr/mdec/stboot
118first-level boot block for tapes
119.It Pa /usr/mdec/bootsd
120second-level boot block for UFS disks
121.It Pa /usr/mdec/bootst
122second-level boot block for tapes
123.It Pa /usr/mdec/netboot
124boot program for NFS (diskless) boot
125.It Pa /usr/mdec/sboot
126network bootstrap program for MVME147
127.It Pa /usr/mdec/installboot
128program to install bootxx on a disk
129.El
130.Sh SEE ALSO
131.Xr disklabel 8 ,
132.Xr fsck 8 ,
133.Xr halt 8 ,
134.Xr init 8 ,
135.Xr rc 8 ,
136.Xr shutdown 8 ,
137.Xr syslogd 8
138