unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-3.1)
Page:
Section:
Apropos / Subsearch:
optional field

INSTALL-MBR(8)           Linux Administrator's Manual           INSTALL-MBR(8)



NAME
       install-mbr - install a Master Boot Record manager

SYNOPSIS
       install-mbr <target>  [--force]  [--install <path>]  [--keep]  [--list]
        [--no-act]  [--offset <offset>]  [--y2kbug[=utc|=local]]    [--parame-
       ters  <path>]    [--reset]  [--table <path>]  [--verbose]  [--version]
       [--help]  [--drive <drive>]  [--enable <options>]  [--interrupt <keys>]
        [--partition <parition>]  [--timeout <timeout>]

DESCRIPTION
       install-mbr  installs  and configures a Master Boot Record manager on a
       device.  The behaviour of the boot manager is determined by the options
       given  on the command line.  <target> is the path specifying the device
       (or file) that the boot manager should be installed onto.

OPTIONS
   Installation options
       These options change the way the installation program operates.

       --force, -f
              This option currently overrides a check to make sure the  speci-
              fied target is valid.

       --install <path>, -I <path>
              This option may be used to install code other than that which is
              built in to install-mbr.  It is mainly useful for  testing,  but
              may be used to install older versions of the MBR.

       --keep, -k
              This  option  instructs  the  installer to modify the parameters
              stored in the MBR without updating the code.

       --list, -l
              This option may be used to view the parameters  being  installed
              in  the MBR.  It implies the --no-act and --keep flags unless an
              option other than --offset, --verbose or --list is given.   This
              allows the contents of the MBR to be examined.

       --no-act, -n
              This  option  ensures  that the target is not modified, as it is
              opened in read-only mode.

       --offset <offset>, -o <offset>
              This option may be used to install the MBR somewhere other  than
              the  start  of  the  target.  The offset specifies the number of
              bytes from the start of the target at which the  MBR  should  be
              installed.  For example, an offset of 128 may be used for DOSEMU
              disk images.

       --y2kbug[=utc|=local|=off], -y[u|l|-]
              This option specifies the status of the Y2K bug  fix  parameter.
              When  set,  an alternative MBR is installed that fixes a Y2K bug
              in some BIOSes that causes them to always boot  up  the  machine
              with  the  year ranging from 94 to 99.  This MBR stores the cur-
              rent month and year and sets the year based  on  this  when  the
              computer  is  booted.   It also increases the year automatically
              when the current month is lower than the month of the last boot.
              The  initial  year and month are set based on the current system
              time converted to UTC or the local  time  as  specified  by  the
              argument.  If the argument is not specified, the default is read
              from /etc/default/rcS.  Due to space limitations,  the  alterna-
              tive  version  of  the  MBR  does not display the word MBR as it
              boots.  If the argument is =off or - the Y2K  bug  fix  is  dis-
              abled.   WARNING:  The Y2K bug fix will work fine until you want
              to set the date backwards.  When you do want  to  do  this,  you
              will need to reinstall the MBR.  You cannot just set the date in
              the BIOS (since the whole point of this option is that the  year
              provided by the BIOS is ignored).

       --parameters <path>, -P <path>
              This  option may be used to copy parameters from somewhere other
              than the target.  The path specifies a location where a  version
              of  this  MBR  has  been  installed and parameters are read from
              there.  It could be used to copy parameters  from  one  disk  to
              another disk.

       --reset, -r
              This  option  is  used to reset the boot parameters to the state
              found in the code  being  installed  (or  code  which  would  be
              installed if --keep were not specified).

       --table <path>, -T <path>
              The master boot record currently uses the partition table in the
              sector which contains it to locate boot sectors (This  behaviour
              may  change  with  future versions of the MBR, in which case the
              option may be withdrawn).  The --table option is used to copy  a
              partition  table  from  another location to the target location.
              Any data stored on the target disk may be lost (as the partition
              table  is  overwritten),  so  this  option  should  be used with
              extreme caution.  As the partition table is copied, any  changes
              made  to the original partition table will not be noticed.  This
              option is only provided to make installation to floppy easy.

       --verbose, -v
              When invoked with this option,  install-mbr  will  display  some
              information about what it is doing.

       --version, -V
              This  option will cause install-mbr to display it's version num-
              ber and exit.

       --help, -h
              This option will cause install-mbr to display a help message and
              exit.

   Parameter options
       These  options  change  the  parameters  stored  within the Master Boot
       Record.

       --drive <drive>, -d <drive>
              This option instructs the MBR to boot a  drive  other  than  the
              first  hard disk.  It may be specified in decimal or hexadecimal
              if prefixed with 0x.  Hard disks are numbered starting from  128
              (0x80).

       --enable <option>, -e <option>
              This  option  sets  the list of boot sectors which may be loaded
              (or advanced mode).  A boot sector may be loaded from one of the
              first  4 partitions of the disk, or from the first floppy drive.
              Use --enable +<spec> to  add  a  boot  sector  to  the  list  or
              --enable  -<spec>  to  remove  a boot sector from the list.  Use
              --enable =<spec> to set the list to <spec>.  <spec> may contain:

              1, 2, 3, 4
                          The specified partition number.

              F           The first floppy disk.

              A           Advanced mode (not a boot sector).

       --interrupt <mode>, -i <mode>
              This option sets the list of events which will cause the MBR  to
              display  it's  prompt.   Use  -i +<event> to add an event to the
              list or -i -<event> to remove an event from the list.  Values of
              <event> are:

              s      A shift or control key is pressed.

              k      A non shift-like key is pressed

              a      The prompt is always displayed.

              n      Never display the prompt (unless an error occurs).

       -p <partn>, --partition <partn>
              This specifies the default boot sector to load.  Valid values of
              <partn> are:

              1, 2, 3, 4
                     The specified partition number.

              F      The first floppy disk.

              D      The partition marked with the bootable flag in the parti-
                     tion table.

       -t <timeout>, --timeout <timeout>
              This  option  changes  the  time  which the MBR waits for before
              booting the default partition to the  value  specified  in  1/18
              seconds  (approx).  The maximum timeout that can be specified is
              65534 which is about an hour.

EXAMPLES
       install-mbr /dev/fd0 -T /dev/hda

       Install the default MBR image on /dev/fd0, taking the  partition  table
       from /dev/hda.

       install-mbr -kr /dev/hda

       Reset the parameters on /dev/hda without installing any new code.

       install-mbr -I my-mbr -T /dev/hda -P my-parameters /dev/fd0

       Install  to /dev/fd0, taking code from my-mbr, partition table from and
       parameters from my-parameters.

       install-mbr -l -o 128 hdimage

       List the parameters stored at offset 128 in hdimage (may  be  a  DOSEMU
       image).

       install-mbr -d 0x81 -T /dev/hdb /dev/fd0

       Install  on  /dev/fd0 to boot from BIOS drive 129 (0x81) with partition
       table copied from /dev/hdb.

       install-mbr -e 13 /dev/hda

       install-mbr -e 2 -e =13 /dev/hda

       install-mbr -e1 -e3 /dev/hda

       Enable booting from partitions 1 and 3 on  /dev/hda.   Other  locations
       are disabled.

       install-mbr -e +f-a -i sk /dev/hda

       Enabled booting from the floppy drive, and disable advanced mode.  Dis-
       play the prompt if any shift, control or non shift-like key is pressed.
       Other settings are untouched.

DIAGNOSTICS
       Cannot handle MBR version n (backwards compatible to n)

              This  error  means  that  the  version  of  MBR  which  is being
              installed is not known about by this installer.  Such files can-
              not have their parameters read or written.  If such a newer ver-
              sion is installed,  it  can  be  downgraded  by  specifying  the
              --reset option (without specifying --keep).

SEE ALSO
       lilo(8)

BUGS
       The operation of --list may be confusing.

AUTHOR
       install-mbr   was  written  for  the  Debian  project  by  Neil  Turton
       <neiltATchiark.uk>.



Linux                            10 March 2001                  INSTALL-MBR(8)