Return to cdboot.8 CVS log

Up to [local] / sys / arch / amd64 / stand / cdboot

Annotation of sys/arch/amd64/stand/cdboot/cdboot.8, Revision 1.1.1.1

1.1       nbrk        1: .\"    $OpenBSD: cdboot.8,v 1.7 2007/05/31 19:20:02 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 amd64
                     30: .Os
                     31: .Sh NAME
                     32: .Nm cdboot
                     33: .Nd
                     34: amd64-specific second-stage CD-specific bootstrap
                     35: .Sh DESCRIPTION
                     36: .Nm
                     37: is a modified version of the amd64 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 amd64 release directory
                     68: (e.g.\&
                     69: .Pa /3.6/amd64/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_amd64 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.