Annotation of sys/arch/i386/stand/cdboot/cdboot.8, Revision 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