1*424a8f4bSjmc.\" $OpenBSD: cdboot.8,v 1.10 2016/03/30 06:58:06 jmc 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.\" 28*424a8f4bSjmc.Dd $Mdocdate: March 30 2016 $ 29338feb3aStom.Dt CDBOOT 8 amd64 30338feb3aStom.Os 31338feb3aStom.Sh NAME 32338feb3aStom.Nm cdboot 33e34c0550Sschwarze.Nd amd64-specific second-stage CD-specific bootstrap 34338feb3aStom.Sh DESCRIPTION 35338feb3aStom.Nm 36338feb3aStomis a modified version of the amd64 second-stage bootstrap program, 37338feb3aStom.Xr boot 8 , 38338feb3aStomconfigured to be run by the 39338feb3aStom.Ox 40338feb3aStomEl Torito CD-ROM boot sector 41338feb3aStom.Pa cdbr . 42338feb3aStom.Nm 43338feb3aStomwill look for an 44338feb3aStom.Pa /etc/boot.conf 45338feb3aStomconfiguration 46338feb3aStomfile on the CD-ROM. 47338feb3aStomIf it finds one, it processes the commands within it. 485b12e470Sderaadt.Pa boot.conf 495b12e470Sderaadtprocessing can be skipped by holding down either Control key as 505b12e470Sderaadt.Nm 515b12e470Sderaadtstarts. 52338feb3aStom.Pp 53338feb3aStom.Nm 54338feb3aStomthen sits in a loop, 55338feb3aStomprocessing commands given by the user. 56338feb3aStomIt accepts all the commands accepted by 57338feb3aStom.Xr boot 8 . 58338feb3aStom.Pp 59338feb3aStomIf no commands are given for a short time, 60338feb3aStom.Nm 61338feb3aStomwill then attempt to load an 62338feb3aStom.Ox 635c224e93Stomkernel from the CD. 640e8db317StomIt first looks for the install kernel 650e8db317Stom.Pa bsd.rd 660e8db317Stomin the standard amd64 release directory 670e8db317Stom(e.g.\& 680e8db317Stom.Pa /3.6/amd64/bsd.rd ) , 695c224e93Stomthen for 705c224e93Stom.Pa /bsd . 71338feb3aStomIt may be told to boot an alternative kernel, 72338feb3aStomeither by commands in the 73338feb3aStom.Pa boot.conf 74338feb3aStomfile, 75338feb3aStomor by commands typed by the user at the 76338feb3aStom.Ic boot> 77338feb3aStomprompt. 78338feb3aStom.Sh FILES 79338feb3aStom.Bl -tag -width /usr/mdec/cdbootxx -compact 80338feb3aStom.It Pa /usr/mdec/cdboot 81338feb3aStomCD-specific second-stage bootstrap 82338feb3aStom.It Pa /etc/boot.conf 83338feb3aStom.Nm 84338feb3aStomconfiguration file (read from CD) 85338feb3aStom.El 86338feb3aStom.Sh EXAMPLES 87338feb3aStomBoot the install kernel: 88338feb3aStom.Pp 89338feb3aStom.Dl boot> bsd.rd 90338feb3aStom.Sh SEE ALSO 91338feb3aStom.Xr boot 8 , 9254be48b2Stom.Xr boot_amd64 8 , 9354be48b2Stom.Xr mkhybrid 8 9476e97d17Sjmc.Sh STANDARDS 95338feb3aStom.Rs 9676e97d17Sjmc.%A Curtis E. Stevens 9776e97d17Sjmc.%A Stan Merkin 98338feb3aStom.%D January 25, 1995 9976e97d17Sjmc.%N Version 1.0 10076e97d17Sjmc.%T "El Torito Bootable CD-ROM Format Specification" 101338feb3aStom.Re 102338feb3aStom.Sh HISTORY 103338feb3aStomThe 104338feb3aStom.Nm 105338feb3aStomprogram first appeared in 106338feb3aStom.Ox 3.6 . 10754be48b2Stom.Sh CAVEATS 10854be48b2StomBy default, many CD creation programs restrict filenames to 10954be48b2Stomthe MS-DOS 8.3 format. 11054be48b2StomUnless this is changed, 11154be48b2Stom.Nm 11254be48b2Stomwill not be able to read its 113*424a8f4bSjmc.Xr boot.conf 8 11454be48b2Stomfile. 11554be48b2StomFor example, with 11654be48b2Stom.Xr mkhybrid 8 11754be48b2Stomthe 11854be48b2Stom.Fl l 11954be48b2Stomoption should be specified. 1200e8db317Stom.Sh BUGS 1210e8db317StomThe 1220e8db317Stom.Ic ls 1230a6ba4ecSjmccommand does not work on ISO 9660 (cd9660) filesystems, 1240e8db317Stomwhich are used on most CDs. 125