Annotation of sys/arch/i386/stand/cdboot/cdboot.8, Revision 1.1.1.1
1.1 nbrk 1: .\" $OpenBSD: cdboot.8,v 1.7 2007/05/31 19:20:03 jmc Exp $
2: .\" Copyright (c) 2004 Tom Cosgrove
3: .\" Copyright (c) 2003 Matthias Drochner
4: .\" Copyright (c) 1999 Doug White
5: .\" All rights reserved.
6: .\"
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
15: .\"
16: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26: .\" SUCH DAMAGE.
27: .\"
28: .Dd $Mdocdate: May 31 2007 $
29: .Dt CDBOOT 8 i386
30: .Os
31: .Sh NAME
32: .Nm cdboot
33: .Nd
34: i386-specific second-stage CD-specific bootstrap
35: .Sh DESCRIPTION
36: .Nm
37: is a modified version of the i386 second-stage bootstrap program,
38: .Xr boot 8 ,
39: configured to be run by the
40: .Ox
41: El Torito CD-ROM boot sector
42: .Pa cdbr .
43: .Nm
44: will look for an
45: .Pa /etc/boot.conf
46: configuration
47: file on the CD-ROM.
48: If it finds one, it processes the commands within it.
49: .Pa boot.conf
50: processing can be skipped by holding down either Control key as
51: .Nm
52: starts.
53: .Pp
54: .Nm
55: then sits in a loop,
56: processing commands given by the user.
57: It accepts all the commands accepted by
58: .Xr boot 8 .
59: .Pp
60: If no commands are given for a short time,
61: .Nm
62: will then attempt to load an
63: .Ox
64: kernel from the CD.
65: It first looks for the install kernel
66: .Pa bsd.rd
67: in the standard i386 release directory
68: (e.g.\&
69: .Pa /3.6/i386/bsd.rd ) ,
70: then for
71: .Pa /bsd .
72: It may be told to boot an alternative kernel,
73: either by commands in the
74: .Pa boot.conf
75: file,
76: or by commands typed by the user at the
77: .Ic boot>
78: prompt.
79: .Sh FILES
80: .Bl -tag -width /usr/mdec/cdbootxx -compact
81: .It Pa /usr/mdec/cdboot
82: CD-specific second-stage bootstrap
83: .It Pa /etc/boot.conf
84: .Nm
85: configuration file (read from CD)
86: .El
87: .Sh EXAMPLES
88: Boot the install kernel:
89: .Pp
90: .Dl boot> bsd.rd
91: .Sh SEE ALSO
92: .Xr boot 8 ,
93: .Xr boot_i386 8 ,
94: .Xr mkhybrid 8
95: .Rs
96: .%T "El Torito" Bootable CD-ROM Format Specification
97: .%N Version 1.0
98: .%D January 25, 1995
99: .%A Curtis E. Stevens, Phoenix Technologies
100: .%A Stan Merkin, IBM
101: .Re
102: .Sh HISTORY
103: The
104: .Nm
105: program first appeared in
106: .Ox 3.6 .
107: .Sh CAVEATS
108: By default, many CD creation programs restrict filenames to
109: the MS-DOS 8.3 format.
110: Unless this is changed,
111: .Nm
112: will not be able to read its
113: .Xr boot.conf 5
114: file.
115: For example, with
116: .Xr mkhybrid 8
117: the
118: .Fl l
119: option should be specified.
120: .Sh BUGS
121: The
122: .Ic ls
123: command does not work on ISO 9660 (cd9660) filesystems,
124: which are used on most CDs.
CVSweb