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     ! 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.