1*54be48b2Stom.\" $OpenBSD: cdboot.8,v 1.5 2006/10/31 11:29:54 tom Exp $ 2338feb3aStom.\" Copyright (c) 2004 Tom Cosgrove 3338feb3aStom.\" Copyright (c) 2003 Matthias Drochner 4338feb3aStom.\" Copyright (c) 1999 Doug White 5338feb3aStom.\" All rights reserved. 6338feb3aStom.\" 7338feb3aStom.\" Redistribution and use in source and binary forms, with or without 8338feb3aStom.\" modification, are permitted provided that the following conditions 9338feb3aStom.\" are met: 10338feb3aStom.\" 1. Redistributions of source code must retain the above copyright 11338feb3aStom.\" notice, this list of conditions and the following disclaimer. 12338feb3aStom.\" 2. Redistributions in binary form must reproduce the above copyright 13338feb3aStom.\" notice, this list of conditions and the following disclaimer in the 14338feb3aStom.\" documentation and/or other materials provided with the distribution. 15338feb3aStom.\" 16338feb3aStom.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 17338feb3aStom.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18338feb3aStom.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19338feb3aStom.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 20338feb3aStom.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21338feb3aStom.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22338feb3aStom.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23338feb3aStom.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24338feb3aStom.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25338feb3aStom.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26338feb3aStom.\" SUCH DAMAGE. 27338feb3aStom.\" 28338feb3aStom.Dd August 21, 2004 29338feb3aStom.Dt CDBOOT 8 amd64 30338feb3aStom.Os 31338feb3aStom.Sh NAME 32338feb3aStom.Nm cdboot 33338feb3aStom.Nd 34338feb3aStomamd64-specific second-stage CD-specific bootstrap 35338feb3aStom.Sh DESCRIPTION 36338feb3aStom.Nm 37338feb3aStomis a modified version of the amd64 second-stage bootstrap program, 38338feb3aStom.Xr boot 8 , 39338feb3aStomconfigured to be run by the 40338feb3aStom.Ox 41338feb3aStomEl Torito CD-ROM boot sector 42338feb3aStom.Pa cdbr . 43338feb3aStom.Nm 44338feb3aStomwill look for an 45338feb3aStom.Pa /etc/boot.conf 46338feb3aStomconfiguration 47338feb3aStomfile on the CD-ROM. 48338feb3aStomIf it finds one, it processes the commands within it. 49338feb3aStom.Pp 50338feb3aStom.Nm 51338feb3aStomthen sits in a loop, 52338feb3aStomprocessing commands given by the user. 53338feb3aStomIt accepts all the commands accepted by 54338feb3aStom.Xr boot 8 . 55338feb3aStom.Pp 56338feb3aStomIf no commands are given for a short time, 57338feb3aStom.Nm 58338feb3aStomwill then attempt to load an 59338feb3aStom.Ox 605c224e93Stomkernel from the CD. 610e8db317StomIt first looks for the install kernel 620e8db317Stom.Pa bsd.rd 630e8db317Stomin the standard amd64 release directory 640e8db317Stom(e.g.\& 650e8db317Stom.Pa /3.6/amd64/bsd.rd ) , 665c224e93Stomthen for 675c224e93Stom.Pa /bsd . 68338feb3aStomIt may be told to boot an alternative kernel, 69338feb3aStomeither by commands in the 70338feb3aStom.Pa boot.conf 71338feb3aStomfile, 72338feb3aStomor by commands typed by the user at the 73338feb3aStom.Ic boot> 74338feb3aStomprompt. 75338feb3aStom.Sh FILES 76338feb3aStom.Bl -tag -width /usr/mdec/cdbootxx -compact 77338feb3aStom.It Pa /usr/mdec/cdboot 78338feb3aStomCD-specific second-stage bootstrap 79338feb3aStom.It Pa /etc/boot.conf 80338feb3aStom.Nm 81338feb3aStomconfiguration file (read from CD) 82338feb3aStom.El 83338feb3aStom.Sh EXAMPLES 84338feb3aStomBoot the install kernel: 85338feb3aStom.Pp 86338feb3aStom.Dl boot> bsd.rd 87338feb3aStom.Sh SEE ALSO 88338feb3aStom.Xr boot 8 , 89*54be48b2Stom.Xr boot_amd64 8 , 90*54be48b2Stom.Xr mkhybrid 8 91338feb3aStom.Rs 92338feb3aStom.%T "El Torito" Bootable CD-ROM Format Specification 93338feb3aStom.%N Version 1.0 94338feb3aStom.%D January 25, 1995 95338feb3aStom.%A Curtis E. Stevens, Phoenix Technologies 96338feb3aStom.%A Stan Merkin, IBM 97338feb3aStom.Re 98338feb3aStom.Sh HISTORY 99338feb3aStomThe 100338feb3aStom.Nm 101338feb3aStomprogram first appeared in 102338feb3aStom.Ox 3.6 . 103*54be48b2Stom.Sh CAVEATS 104*54be48b2StomBy default, many CD creation programs restrict filenames to 105*54be48b2Stomthe MS-DOS 8.3 format. 106*54be48b2StomUnless this is changed, 107*54be48b2Stom.Nm 108*54be48b2Stomwill not be able to read its 109*54be48b2Stom.Xr boot.conf 5 110*54be48b2Stomfile. 111*54be48b2StomFor example, with 112*54be48b2Stom.Xr mkhybrid 8 113*54be48b2Stomthe 114*54be48b2Stom.Fl l 115*54be48b2Stomoption should be specified. 1160e8db317Stom.Sh BUGS 1170e8db317StomThe 1180e8db317Stom.Ic ls 1190a6ba4ecSjmccommand does not work on ISO 9660 (cd9660) filesystems, 1200e8db317Stomwhich are used on most CDs. 121