MirOS Manual: installboot(8)

INSTALLBOOT(8)        BSD System Manager's Manual (i386)        INSTALLBOOT(8)

NAME

     installboot - installs a bootstrap on an FFS disk or partition

SYNOPSIS

     installboot [-Anv] [-s sectors-per-track] [-h tracks-per-cyl] [-P
                 partition-type] boot bootxx disk

DESCRIPTION

     installboot is used to install a "first-stage" boot program into the boot
     area of an FFS disk partition, and initialize the table of block numbers
     the PBR programme uses to load the second-stage boot program.

     The options are as follows:

     -A        Tell bootxx to use automatic geometry detection.

     -n        Do not actually write anything on the disk.

     -v        Be verbose, printing out the LBA addresses that are to be
               stored in bootxx along with lots of other information.

     -s sectors-per-track
               Used to specify the sectors-per-track value if the drive has
               sector translation activated, and installboot is unable to
               determine the translated geometry. If not specified, this de-
               faults to d_nsectors from the disklabel. If not specified, this
               defaults to the value retrieved from the BIOS at boot time,
               available via sysctl(8). If not available, automatic geometry
               detection is used. Valid are values from 1 to 63, inclusive.

     -h tracks-per-cyl
               Used to specify the tracks-per-cylinder value if the drive has
               sector translation activated, and installboot is unable to
               determine the translated geometry. If not specified, this de-
               faults to d_ntracks from the disklabel. If not specified, this
               defaults to the value retrieved from the BIOS at boot time,
               available via sysctl(8). If not available, automatic geometry
               detection is used. Valid are values from 1 to 256, inclusive.

     -P partition-type
               Use the partition-type value in decimal (on MirOS also sede-
               cimal or octal values are allowed, provided they are prefixed
               with 0x or 0, respectively) as user-specified partition type to
               search before the standard 0x27 and the fallback 0xA6, 0xA9 and
               0xA5 types.

     The arguments are:

     boot      The name of the second-stage boot program in the mounted file
               system where the first-stage boot program is to be installed.
               This should be a full pathname.

     bootxx    The name of the prototype file for the first stage boot pro-
               gram, usually /usr/mdec/bootxx.

     disk      The name of the disk containing the partition in which the
               second-stage boot program resides and the first-stage boot pro-
               gram is to be installed. This can either be specified in short
               form (i.e., 'sd0' or 'wd0'), or as the explicit raw device
               node, such as /dev/rsd0c or /dev/rwd0c.

               Note that you must be in single-user mode or have your kernel
               in insecure mode (see the sysctl(8) kern.securelevel variable
               or /etc/rc.securelevel) to enable access to the raw partition
               of a mounted disk.

               The 'c' partition is always used to represent the "entire" disk
               on i386.

EXAMPLES

     The typical use is

           # cp /usr/mdec/boot /boot
           # /usr/mdec/installboot -v -n /boot /usr/mdec/bootxx wd0

     And if the information supplied looks right, run the above without the -n
     flag. If you are upgrading an old system, you may need to preface the
     above steps with some more steps... and do the following:

           boot the floppy.fs filesystem floppy
           # fsck /dev/rsd0a
           # mount /dev/sd0a /mnt
           # cp /usr/mdec/boot /mnt/boot
           # /usr/mdec/installboot -v /mnt/boot /usr/mdec/bootxx sd0

     If you need to find the BIOS geometry of the disk for -s and -h you can
     use the boot block command:

           boot> machine diskinfo

     Make a CD-ROM bootable for i386 (both as CD and as HD/CF/USB):

          getextent_cd9660 -f cdrom10.iso boot | \
              mksh /usr/mdec/bootxx.sh -S 2 | \
              dd of=cdrom10.iso conv=notrunc
          getextent_cd9660 -f cdrom10.iso boot | \
              mksh /usr/mdec/bootxx.sh -B 11 | \
              dd of=cdrom10.iso conv=notrunc bs=2048 \
              seek=$(getextent_cd9660 -f cdrom10.iso -b '$BootImage$')

SEE ALSO

     boot(8), disklabel(8), fdisk(8), init(8)

HISTORY

     The -A option is supported by bootxx 0AA8 and up.

BUGS

     The disklabel d_type field must be set to a value of "4.2FFS".

     You cannot run installboot for a drive/partition other than the one you
     want the /boot to be loaded from.

MirOS BSD #10-current         November 22, 2009                              1

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.