xref: /netbsd/share/man/man8/man8.alpha/boot.8 (revision bf9ec67e)
1.\" $NetBSD: boot.8,v 1.5 2001/11/25 23:44:14 wiz Exp $
2.\"
3.\" Copyright (c) 1999 Christopher G. Demetriou
4.\" 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. All advertising materials mentioning features or use of this software
15.\"    must display the following acknowledgement:
16.\"          This product includes software developed for the
17.\"          NetBSD Project.  See http://www.netbsd.org/ for
18.\"          information about NetBSD.
19.\" 4. The name of the author may not be used to endorse or promote products
20.\"    derived from this software without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
23.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
24.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
26.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
27.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
31.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32.\"
33.\" <<Id: LICENSE,v 1.2 2000/06/14 15:57:33 cgd Exp>>
34.\"
35.\"
36.\" Copyright (c) 1990, 1991 The Regents of the University of California.
37.\" All rights reserved.
38.\"
39.\" This code is derived from software contributed to Berkeley by
40.\" the Systems Programming Group of the University of Utah Computer
41.\" Science Department.
42.\"
43.\" Redistribution and use in source and binary forms, with or without
44.\" modification, are permitted provided that the following conditions
45.\" are met:
46.\" 1. Redistributions of source code must retain the above copyright
47.\"    notice, this list of conditions and the following disclaimer.
48.\" 2. Redistributions in binary form must reproduce the above copyright
49.\"    notice, this list of conditions and the following disclaimer in the
50.\"    documentation and/or other materials provided with the distribution.
51.\" 3. All advertising materials mentioning features or use of this software
52.\"    must display the following acknowledgement:
53.\"     This product includes software developed by the University of
54.\"     California, Berkeley and its contributors.
55.\" 4. Neither the name of the University nor the names of its contributors
56.\"    may be used to endorse or promote products derived from this software
57.\"    without specific prior written permission.
58.\"
59.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
60.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
61.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
62.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
63.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
64.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
65.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
66.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
67.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
68.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
69.\" SUCH DAMAGE.
70.\"
71.\"     @(#)boot_hp300.8        8.2 (Berkeley) 4/19/94
72.\"
73.Dd April 5, 1999
74.Dt BOOT 8 alpha
75.Os
76.Sh NAME
77.Nm boot
78.Nd Alpha system bootstrapping procedures
79.Sh DESCRIPTION
80When the
81.Nx Ns Tn /alpha
82kernel is booted normally
83it initializes itself and proceeds to start the system.  An automatic
84consistency check of the file systems takes place, and unless this
85fails, the system comes up to multi-user operation.  The proper way
86to shut the system down is with the
87.Xr shutdown 8
88command.
89.Pp
90If the system crashes, it will enter the kernel debugger,
91.Xr ddb 4 ,
92if it is configured in the kernel.
93If the crash occurred during
94initialization and the debugger is not present or is exited, the
95kernel will halt the system.
96If the crash occurred during normal operation and the debugger
97is not present or is exited, the system will attempt a dump to the
98configured dump device (which will be automatically recovered with
99.Xr savecore 8
100during the next boot cycle), and after the dump is complete (successful
101or not) the kernel will attempt a reboot.
102.\" XXX .Pp
103.\" XXX .Ss Use of SRM Console
104.\" XXX .Pp
105.\" XXX console is used to bootstrap system
106.\" XXX .Pp
107.\" XXX boot flags, boot file
108.\" XXX .Pp
109.\" XXX console device names
110.\" XXX .Pp
111.\" XXX .Ss Console Behavior at Power-on, Halt, and Reboot
112.\" XXX .Pp
113.\" XXX auto_action variable
114.\" XXX .Pp
115.\" XXX .Ss System Bootstrapping Procedure
116.\" XXX .Pp
117.\" XXX boot environment
118.\" XXX .Pp
119.\" XXX primary/secondary vs. unified bootstrap
120.Sh FILES
121.Bl -tag -width /usr/mdec/bootxx_cd9660 -compact
122.It Pa /netbsd
123default system kernel
124.It Pa /usr/mdec/bootxx_cd9660
125primary bootstrap for
126.Dq cd9660
127(ISO 9660) file system
128.It Pa /usr/mdec/bootxx_ffs
129primary bootstrap for
130.Dq ffs
131file system
132(Berkeley Fast File System)
133.It Pa /usr/mdec/boot
134secondary bootstrap
135.It Pa /usr/mdec/netboot
136network bootstrap
137.It Pa /usr/mdec/ustarboot
138.Dq ustar
139disk and tape bootstrap
140.It Pa /boot
141secondary bootstrap (installed)
142.El
143.Sh SEE ALSO
144.Xr ddb 4 ,
145.Xr installboot 8 ,
146.Xr mkbootimage 8 ,
147.Xr savecore 8 ,
148.Xr setnetbootinfo 8 ,
149.Xr shutdown 8
150.Rs
151.%T "Alpha Architecture Reference Manual Third Edition"
152.%Q "Alpha Architecture Committee"
153.%I "Digital Press"
154.%D 1998
155.Re
156.Sh BUGS
157The device names used by
158.Nx Ns Tn /alpha
159and the
160.Tn SRM Console
161often have no relation to each other.
162