Return to installboot.8 CVS log

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

Annotation of sys/arch/amd64/stand/installboot/installboot.8, Revision 1.1

1.1     ! nbrk        1: .\"    $OpenBSD: installboot.8,v 1.3 2007/05/31 19:20:02 jmc Exp $
        !             2: .\"
        !             3: .\" Copyright (c) 1997 Michael Shalayeff
        !             4: .\" All rights reserved.
        !             5: .\"
        !             6: .\" Redistribution and use in source and binary forms, with or without
        !             7: .\" modification, are permitted provided that the following conditions
        !             8: .\" are met:
        !             9: .\" 1. Redistributions of source code must retain the above copyright
        !            10: .\"    notice, this list of conditions and the following disclaimer.
        !            11: .\" 2. Redistributions in binary form must reproduce the above copyright
        !            12: .\"    notice, this list of conditions and the following disclaimer in the
        !            13: .\"    documentation and/or other materials provided with the distribution.
        !            14: .\"
        !            15: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
        !            16: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
        !            17: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        !            18: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
        !            19: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        !            20: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
        !            21: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
        !            22: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
        !            23: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
        !            24: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        !            25: .\" SUCH DAMAGE.
        !            26: .\"
        !            27: .\"
        !            28: .Dd $Mdocdate: May 31 2007 $
        !            29: .Dt INSTALLBOOT 8 amd64
        !            30: .Os
        !            31: .Sh NAME
        !            32: .Nm installboot
        !            33: .Nd installs a bootstrap on an FFS disk or partition
        !            34: .Sh SYNOPSIS
        !            35: .Nm installboot
        !            36: .Op Fl nv
        !            37: .Ar boot
        !            38: .Ar biosboot
        !            39: .Ar disk
        !            40: .Sh DESCRIPTION
        !            41: .Nm
        !            42: is used to install a
        !            43: .Dq first-stage
        !            44: boot program into the boot area of an FFS disk partition.
        !            45: It inserts the block number and offset of the inode of
        !            46: the second-stage boot program
        !            47: .Xr boot 8
        !            48: so that the
        !            49: .Xr biosboot 8
        !            50: program can load it.
        !            51: Various filesystem parameters are also patched into the boot block.
        !            52: .Pp
        !            53: The options are as follows:
        !            54: .Bl -tag -width flag_opt
        !            55: .It Fl n
        !            56: Do not actually write anything on the disk.
        !            57: .It Fl v
        !            58: Be verbose, printing out the data that are stored in
        !            59: .Ar biosboot
        !            60: along with lots of other information.
        !            61: .El
        !            62: .Pp
        !            63: The arguments are:
        !            64: .Bl -tag -width biosboot
        !            65: .It Ar boot
        !            66: The name of the second-stage boot program in the mounted file system
        !            67: where the first-stage boot program is to be installed.
        !            68: This should be a full pathname.
        !            69: .It Ar biosboot
        !            70: The name of the prototype file for the first stage boot program,
        !            71: usually
        !            72: .Pa /usr/mdec/biosboot .
        !            73: .It Ar disk
        !            74: The name of the disk containing the partition in which the second-stage
        !            75: boot program resides and the first-stage boot program is to be installed.
        !            76: This can either be specified in short form (e.g.,
        !            77: .Sq sd0
        !            78: or
        !            79: .Sq wd0 ) ,
        !            80: or as the explicit device node, such as
        !            81: .Pa /dev/rsd0c
        !            82: or
        !            83: .Pa /dev/rwd0c .
        !            84: .Pp
        !            85: Note that you must be in single-user mode or have your kernel in
        !            86: insecure mode (see the
        !            87: .Xr sysctl 8
        !            88: .Va kern.securelevel
        !            89: variable or
        !            90: .Pa /etc/rc.securelevel )
        !            91: to enable access to the raw partition of a mounted disk.
        !            92: .Pp
        !            93: The
        !            94: .Sq c
        !            95: partition is always used to represent the
        !            96: .Dq entire
        !            97: disk on amd64.
        !            98: .El
        !            99: .Sh EXAMPLES
        !           100: The typical use is
        !           101: .Bd -literal -offset indent
        !           102: # cp /usr/mdec/boot /boot
        !           103: # /usr/mdec/installboot -n -v /boot /usr/mdec/biosboot sd0
        !           104: .Ed
        !           105: .Pp
        !           106: And if the information supplied looks right, run the above without the
        !           107: .Fl n
        !           108: flag.
        !           109: If you are upgrading an old system, you may need to perform
        !           110: some additional steps first.
        !           111: For example:
        !           112: .Bd -literal -offset indent
        !           113: boot the floppy.fs filesystem floppy
        !           114: # fsck /dev/rsd0a
        !           115: # mount /dev/sd0a /mnt
        !           116: # cp /usr/mdec/boot /mnt/boot
        !           117: # /usr/mdec/installboot -v /mnt/boot /usr/mdec/biosboot sd0
        !           118: .Ed
        !           119: .Sh SEE ALSO
        !           120: .Xr biosboot 8 ,
        !           121: .Xr boot 8 ,
        !           122: .Xr disklabel 8 ,
        !           123: .Xr fdisk 8 ,
        !           124: .Xr init 8
        !           125: .Sh CAVEATS
        !           126: The disklabel
        !           127: .Va d_type
        !           128: field must be set to a value other than
        !           129: .Dq unknown .
        !           130: .Pp
        !           131: .Pa /boot
        !           132: must be on the drive/partition specified by
        !           133: .Pa disk ;
        !           134: you cannot perform cross-device
        !           135: .Nm Ns s .