Return to installboot.8 CVS log

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

Annotation of sys/arch/i386/stand/installboot/installboot.8, Revision 1.1.1.1

1.1       nbrk        1: .\"    $OpenBSD: installboot.8,v 1.28 2007/05/31 19:20:03 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 i386
                     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 i386.
                     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 .