xref: /openbsd/sys/arch/amd64/stand/cdboot/cdboot.8 (revision 338feb3a)
1*338feb3aStom.\"	$OpenBSD: cdboot.8,v 1.1 2004/08/21 18:53:38 tom Exp $
2*338feb3aStom.\" Copyright (c) 2004 Tom Cosgrove
3*338feb3aStom.\" Copyright (c) 2003 Matthias Drochner
4*338feb3aStom.\" Copyright (c) 1999 Doug White
5*338feb3aStom.\" All rights reserved.
6*338feb3aStom.\"
7*338feb3aStom.\" Redistribution and use in source and binary forms, with or without
8*338feb3aStom.\" modification, are permitted provided that the following conditions
9*338feb3aStom.\" are met:
10*338feb3aStom.\" 1. Redistributions of source code must retain the above copyright
11*338feb3aStom.\"    notice, this list of conditions and the following disclaimer.
12*338feb3aStom.\" 2. Redistributions in binary form must reproduce the above copyright
13*338feb3aStom.\"    notice, this list of conditions and the following disclaimer in the
14*338feb3aStom.\"    documentation and/or other materials provided with the distribution.
15*338feb3aStom.\"
16*338feb3aStom.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17*338feb3aStom.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18*338feb3aStom.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19*338feb3aStom.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20*338feb3aStom.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21*338feb3aStom.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22*338feb3aStom.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23*338feb3aStom.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24*338feb3aStom.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25*338feb3aStom.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26*338feb3aStom.\" SUCH DAMAGE.
27*338feb3aStom.\"
28*338feb3aStom.Dd August 21, 2004
29*338feb3aStom.Dt CDBOOT 8 amd64
30*338feb3aStom.Os
31*338feb3aStom.Sh NAME
32*338feb3aStom.Nm cdboot
33*338feb3aStom.Nd
34*338feb3aStomamd64-specific second-stage CD-specific bootstrap
35*338feb3aStom.Sh DESCRIPTION
36*338feb3aStom.Nm
37*338feb3aStomis a modified version of the amd64 second-stage bootstrap program,
38*338feb3aStom.Xr boot 8 ,
39*338feb3aStomconfigured to be run by the
40*338feb3aStom.Ox
41*338feb3aStomEl Torito CD-ROM boot sector
42*338feb3aStom.Pa cdbr .
43*338feb3aStom.Nm
44*338feb3aStomwill look for an
45*338feb3aStom.Pa /etc/boot.conf
46*338feb3aStomconfiguration
47*338feb3aStomfile on the CD-ROM.
48*338feb3aStomIf it finds one, it processes the commands within it.
49*338feb3aStom.Pp
50*338feb3aStom.Nm
51*338feb3aStomthen sits in a loop,
52*338feb3aStomprocessing commands given by the user.
53*338feb3aStomIt accepts all the commands accepted by
54*338feb3aStom.Xr boot 8 .
55*338feb3aStom.Pp
56*338feb3aStomIf no commands are given for a short time,
57*338feb3aStom.Nm
58*338feb3aStomwill then attempt to load an
59*338feb3aStom.Ox
60*338feb3aStomkernel
61*338feb3aStom.Pa /bsd
62*338feb3aStomfrom the CD.
63*338feb3aStomIt may be told to boot an alternative kernel,
64*338feb3aStomeither by commands in the
65*338feb3aStom.Pa boot.conf
66*338feb3aStomfile,
67*338feb3aStomor by commands typed by the user at the
68*338feb3aStom.Ic boot>
69*338feb3aStomprompt.
70*338feb3aStom.Sh FILES
71*338feb3aStom.Bl -tag -width /usr/mdec/cdbootxx -compact
72*338feb3aStom.It Pa /usr/mdec/cdboot
73*338feb3aStomCD-specific second-stage bootstrap
74*338feb3aStom.It Pa /etc/boot.conf
75*338feb3aStom.Nm
76*338feb3aStomconfiguration file (read from CD)
77*338feb3aStom.El
78*338feb3aStom.Sh EXAMPLES
79*338feb3aStomBoot the install kernel:
80*338feb3aStom.Pp
81*338feb3aStom.Dl boot> bsd.rd
82*338feb3aStom.Sh SEE ALSO
83*338feb3aStom.Xr boot 8 ,
84*338feb3aStom.Xr boot_amd64 8
85*338feb3aStom.Rs
86*338feb3aStom.%T "El Torito" Bootable CD-ROM Format Specification
87*338feb3aStom.%N Version 1.0
88*338feb3aStom.%D January 25, 1995
89*338feb3aStom.%A Curtis E. Stevens, Phoenix Technologies
90*338feb3aStom.%A Stan Merkin, IBM
91*338feb3aStom.Re
92*338feb3aStom.Sh HISTORY
93*338feb3aStomThe
94*338feb3aStom.Nm
95*338feb3aStomprogram first appeared in
96*338feb3aStom.Ox 3.6 .
97