Provided by: lilo_23.2-2_amd64 bug

NAME

       lilo.conf - configuration file for lilo

DESCRIPTION

       This  file,  by  default  /etc/lilo.conf, is read by the boot loader installer 'lilo' (see
       lilo(8)).

       It might look as follows:

              # /etc/lilo.conf
              #
              #  global options:
              boot=/dev/hda
              prompt
              timeout=150
              lba32
              compact
              vga=normal
              root=/dev/hda1
              read-only
              menu-title=" John's Computer "
              #
              ### bootable kernel images ###
              image=/boot/vmlinuz-2.6.29-1-i386
                   label=try
                   initrd=/boot/initrd.img-2.6.29-1-i386
              image=/boot/vmlinuz-2.4.33-1-i386
                   label=2.4.33
              image=/tamu/vmlinuz
                   label=tamu
                   initrd=/tamu/initrd.img
                   root=/dev/hdb2
                   vga=ask
              #
              ### other operating systems ###
              other=/dev/hda3
                   label=PCDOS
                   boot-as=0x80    # must be C:
              other=/dev/hdb1
                   label=WinXP
                   boot-as=0x80    # must be C:
              other=/dev/hdb5
                   label=oldDOS
                   loader=chain
                   table=/dev/hdb5

       This configuration file specifies that lilo uses the Master Boot Record on /dev/hda.  (For
       a  discussion  of  the  various ways to use lilo, and the interaction with other operating
       systems, see user.pdf from the lilo documentation.)

       When booting, the boot loader will issue its boot: prompt and wait for you  to  enter  the
       label  of  the  kernel  (and  any options) which you wish to boot. At any time you may hit
       [Tab] to see a list of kernel/other labels.  Alternately,  if  the  menu  boot  loader  is
       installed, a menu of boot options will be presented for your selection.  The title of this
       menu is overridden with the menu title specification in this configuration file.   If  you
       enter  nothing,  then  the  default  kernel  image,  the  first mentioned, (in the example
       /boot/vmlinuz-2.6.29-1-i386)  will  be  booted  after  a  timeout  of  15   seconds   (150
       deciseconds).  There  may  be at least 16 images mentioned in lilo.conf. (The exact number
       depends upon compilation options.)

       As can be seen above, a configuration file starts with a number of global options (the top
       9  lines  in the example), followed by descriptions of the options for the various images.
       An option in an image description will override a global option.

       Comment lines may appear anywhere, and begin with the "#" character.

GLOBAL OPTIONS

       There are many possible keywords. The description below is almost literally from  user.pdf
       (just slightly abbreviated).

       backup=<backup-file>
              Specifies  the location where a copy of any modified boot sector will be saved in a
              file. 'backup=' may specify this location in one of three ways: a  directory  where
              the  default  backup  file 'boot.NNNN' will be created; a file pathname template to
              which the '.NNNN' suffix will be added; or  the  full  file  pathname,  which  must
              include  the  correct  '.NNNN'  suffix.  All RAID installations should use only the
              first two alternatives, as multiple backups may be created.  The '.NNNN' suffix  is
              the  hexadecimal representation of the major and minor device numbers of the device
              or partition. If this option is not specified, the  default  name  of  boot  sector
              backups  is  '/boot/boot.NNNN'.  If  a backup already exists, it will be preserved,
              rather than overwritten.  C.f., force-backup= below.

       bios-passes-dl=<option>
              The option is indicated as yes, no, or unknown.   If  not  specified,  a  value  of
              "unknown"  is  assumed,  unless  additional  information  is  available to the boot
              installer. When "no" is specified, it indicates that the BIOS is known not to  pass
              the  current  boot  device  code  to  the boot loader in the DL register.  Its only
              function at this point is experimental, as certain RAID installations  may  benefit
              from  knowing  that  the  BIOS  is  100%  reliable.   Its  use should be considered
              experimental.

              This option may be specified on the command line with the '-Z' switch: yes=1, no=0.

       bitmap=<bitmap-file>
              Specifies use of a 640x480x16 (VGA BIOS) or 640x480x256 (VGA/VESA BIOS) bitmap file
              as the background on which a boot menu is displayed.  May not be used if 'message='
              is specified.  Use of this option will select a bitmap-capable boot loader,  unless
              overridden with "install=" (see below).

              When a bitmap file is specified as a background screen during the boot process, the
              color selection and layout of the text which overlays the  graphic  image  must  be
              specified in one of two ways.

              One  way  is the use of header information in the bitmap image (*.bmp) file: From a
              text file with all the information about 'bmp-colors', 'bmp-table' and  'bmp-timer'
              options together with the 'bitmap' option are stored in the special LILO  header of
              the bitmap image file by the lilo -E  command.  Another  way  works  without  these
              special header information: All the information about 'bmp-colors', 'bmp-table' and
              'bmp-timer'  options  together  with  the  'bitmap'  option  are  stored   in   the
              configuration  file.   Any  use of the 'bmp-' options within the configuration file
              overrides the options stored in the bitmap file header. If lilo cannot find any  of
              the 'bmp-' options, then default values are used.

       bmp-colors=<fg>,<bg>,<sh>,<hfg>,<hbg>,<hsh>
              Specifies  the  decimal  values  of the colors to be used for the menu display on a
              'bitmap=' background.  The list consists of 6 entries, 3 for normal  text  followed
              by  3  for  highlighted  text.   The  order  of  each  triple is: foreground color,
              background  color,  shadow  color.   If  background   color   is   not   specified,
              "transparent"  is  assumed.   If  shadow  color  is  not  specified, then "none" is
              assumed.  The list entries are separated by commas, with no spaces.

       bmp-retain
              Option applies to all 'image=' and 'other=' sections.  (See COMMON OPTIONS, below.)

       bmp-table=<x>,<y>,<ncol>,<nrow>,<xsep>,<spill>
              Specifies the location and layout of the menu table.  <x>,<y> specify the  starting
              x- and y-position of the upper left corner of the table in character coordinates: x
              in [1..80], y in [1..30]. <ncol> is the number of columns in the menu  (1..5);  and
              <nrow>  is the number of rows (entries) in each column.  If more than one column is
              specified, then <xsep> is the number of  character  columns  between  the  leftmost
              characters  in  each  column: (18..40), and <spill> is the number of entries in one
              column which must be filled before entries spill into the next column. <spill> must
              be  .le. <nrow>. If pixel addressing is used, instead of character addressing, then
              any of <x>, <y>, or <xsep> may be specified with a 'p' suffix on the decimal value.

       bmp-timer=<x>,<y>,<fg>,<bg>,<sh>
              Optional specification of the 'timeout=' countdown timer.   <x>,<y>  specifies  the
              character  (or  pixel)  coordinate  of  the location of the timer the same as 'bmp-
              table=' above; and the color triple specifies the character  color  attributes  the
              same  as  'bmp-colors=' above, with the exception that the background color must be
              specified.  If used to override the timer specification in a bitmap file, then  the
              form  'bmp-timer  =  none'  is  acceptable.   This  will  disable the timer display
              entirely.

       boot=<boot-device>
              Sets the name of the device (e.g. hard disk or partition) that  contains  the  boot
              sector  and where the new boot sector should be written to. Notice: The boot-device
              should be the device with the currently mounted root partition.

              A raid installation is initiated by specifying a RAID1 device as the  boot  device;
              e.g., "boot=/dev/md0".

              On  newer  systems  you  need  an unique ID for the boot device. If the boot sector
              should write to a partition you can use its UUID in the same manner is for the root
              options.

              If  your  boot  device  is a hard disk you need a special ID, which is supported by
              udev. You find the right ID in the directory /dev/disks/by-id, i. e.:

                  boot = /dev/disk/by-id/ata-SAMSUNG_SV1604N_S01FJ10X999999

       change-rules
              Defines boot-time changes to partition type numbers (`hiding').

              change-rules
                 reset
                 type=DOS12
                    normal=1
                    hidden=0x11
                 type=DOS16_small
                    normal=4
                    hidden=0x14
                 type=DOS16_big
                    normal=0x06
                    hidden=0x16

              The above excerpt from a configuration file specifies that all default change-rules
              are  removed  ("reset"),  and  the  change-rules  for  three  partition  types  are
              specified.  Without the reset, the three types specified would have been  added  to
              the  existing  default  change-rules.   Normally, the default rules are sufficient.
              The strings which define the partition types are used  in  a  change  section  (see
              below),  with the suffixes "_normal" or "_hidden" appended.  See section "Partition
              type change rules" of user.pdf for more details.

       compact
              Tries to merge read requests for adjacent sectors into a single read request.  This
              drastically  reduces  load  time and keeps the map file smaller. Using `compact' is
              especially recommended when booting using a map file on a floppy disk.

       default=<name>
              Uses the specified image as the default boot image. If `default'  is  omitted,  the
              image appearing first in the configuration file is used. See also, vmdefault below.

       delay=<tsecs>
              Specifies  the  number  of  tenths  of  a second the boot loader should wait before
              automatically booting a locked command line, a command  line  pre-stored  by  "lilo
              -R",  or  the  default  `image='  or  `other='.  When `delay' is non-zero, the boot
              loader will wait for an interrupt for the specified interval. If  an  interrupt  is
              received,  or  is  already  waiting,  the  boot:  prompt  will be be issued, and no
              automatic boot will take place. The setting of CAPS LOCK or SCROLL LOCK, or any  of
              the keys ALT, CTRL, or SHIFT, when held down, are taken as interrupts.

              This action is modified by specifying `prompt' (see below).

       disk=<device-name>
              Defines  non-standard  parameters  for  the  specified  disk.   See  section  "Disk
              geometry" of user.pdf for details.  For versions of LILO prior to 22.5, the `bios='
              parameter  is quite useful for specifying how the BIOS has assigned device codes to
              your disks.  For example,

                     disk=/dev/sda
                          bios=0x80
                     disk=/dev/hda
                          bios=0x81
                     disk=/dev/sdb
                          inaccessible

              would say that your SCSI disk is the first BIOS disk  (0x80),  that  your  (primary
              master)  IDE  disk  is  the second BIOS disk (0x81), and that your second SCSI disk
              (perhaps a USB device) receives no device code, and is  therefore  inaccessible  at
              boot time.

              NOTE:  Use  of  the  'bios=' option is largely obsolete beginning with LILO version
              22.5, as the boot loader now identifies disks by 32-bit Volume-ID, and defers  BIOS
              device code determination until boot time.

              Other options include the specification of disk geometry; e.g.,

                     disk=/dev/fd0
                          sectors=18
                          heads=2
                          cylinders=80

              probably  only useful for floppy disks and loopback devices, because for hard disks
              the lba32 disk addressing option ignores disk geometry.

              Developers who have implemented a disk driver for a new block storage  device  will
              have  to  indicate to LILO the maximum number of partitions on the device.  This is
              in addition to making all of the necessary entries for the  device  in  the  "/dev"
              directory (with 'mknod').  The maximum number of partitions must be one of 63 (like
              an IDE disk), 31 (uncommon), 15 (like SCSI disks -- most common value), or 7  (like
              one array controller). An example specification would be:

                   disk=/dev/userd0
                        max-partitions=15

              In  cases  where  there  is  no  kernel partition information available, such as on
              loopback  devices,  the  'disk='  specification  may   include   paritition   start
              information; viz.,

                     disk=/dev/loop0
                          bios=0x80              # use this BIOS code
                          max-partitions=7       # declare partitionable
                          paritition=/dev/loop1
                               start=63          # offset from sector 0
                          paritition=/dev/loop2
                               start=102400      # offset from sector 0

       disktab=<disktab-file>
              Specifies  the  name  of  the  disk  parameter  table.  The map installer looks for
              /etc/disktab if `disktab' is omitted. The use of disktabs is discouraged.

       el-torito-bootable-CD
              Flag second stage loader to terminate disk emulation when booting from an El Torito
              Bootable CD. This option is used by the mkrescue utility when the "--iso" switch is
              specified.

       fix-table
              This allows lilo to adjust 3D addresses in partition tables. Each  partition  entry
              contains a 3D (cylinder/head/sector) and a linear address of the first and the last
              sector of the partition. If a partition is not track-aligned and if  certain  other
              operating  systems (e.g. PC/MS-DOS) are using the same disk, they may change the 3D
              address. lilo can store its boot sector only on partitions where both address types
              correspond. lilo re-adjusts incorrect 3D start addresses if `fix-table' is set.

              WARNING:  This  does  not guarantee that other operating systems may not attempt to
              reset the address later. It is also possible that this change has other, unexpected
              side-effects. The correct fix is to re-partition the drive with a program that does
              align partitions to tracks. Also, with some disks (e.g. some large EIDE disks  with
              address  translation enabled), under some circumstances, it may even be unavoidable
              to have conflicting partition table entries.

       force-backup=<backup-file>
              Operation is identical  to  backup=  above,  except  an  existing  backup  file  is
              unconditionally overwritten if it exists.

       geometric
              Force  disk  addressing which is compatible with older versions of LILO.  Geometric
              addressing uses cylinder/head/sector addresses, and is limited to disk cylinders up
              to  1023.   If inaccessible cylinders are referenced, diagnostics will be issued at
              boot-install time, rather than boot-time.  With a newer BIOS,  use  of  'lba32'  is
              recommended.

       ignore-table
              tells lilo to ignore corrupt partition tables.

       install=<user-interface>
              Selects  the  user interface which will be seen at boot time.  One of the following
              three options may be specified:  text, menu, or bmp. The traditional LILO interface
              is  `text';  but  `menu' is now the default, unless the configuration file contains
              the `bitmap='  specification.   The  text  interface  is  strictly  a  command-line
              interface  as  though  the  console  were a dumb terminal.  The menu interface is a
              text-based screen of the boot choices, with the option to enter additional  command
              line  parameters.   And  the  bmp  interface  is a menu presented against a graphic
              screen, specified as a 640x480 BitMaP file of 16 or 256 colors.  (See the 'lilo -E'
              switch for editing options).

              (Prior  to  LILO version 22.3, `install=' specified the user interface as a file in
              the `/boot' directory.)

       large-memory
              Normally any initial ramdisk (initrd) loaded with a kernel is  loaded  as  high  in
              memory  as  possible,  but  never  above 15Mb.  This is due to a BIOS limitation on
              older systems.  On newer systems, this option enables using memory above  15Mb  (up
              to a kernel imposed limit, around 768Mb) for passing the initrd to the kernel.  The
              presence of this option merely indicates that your system does  not  have  the  old
              BIOS limitation.

              This  switch  (or its absence) is not passed to the kernel, and does not in any way
              affect the  amount  of  physical  memory  which  it  will  use.   (See  the  kernel
              documentation  for the kernel command line parameter "mem=" for limiting the memory
              used by the kernel.)

       lba32  Generate 32-bit Logical Block Addresses instead of cylinder/head/sector  addresses.
              If  the  BIOS  supports packet addressing, then packet calls will be used to access
              the disk. This allows booting from any partition  on  disks  with  more  than  1024
              cylinders.   If the BIOS does not support packet addressing, then 'lba32' addresses
              are translated to cylinder/head/sector ('geometric'), just as  for  'linear'.   All
              floppy  disk  references are retained in C:H:S form.  Use of 'lba32' is recommended
              on all post-1998 systems.  Beginning with LILO version 22, 'lba32' is  the  default
              disk addressing scheme.

       linear Generate 24-bit linear sector addresses instead of cylinder/head/sector (geometric)
              addresses. Linear addresses are translated at run time to geometric addresses,  and
              are  limited to cylinders <= 1023. When using `linear' with large disks, /sbin/lilo
              may generate references to inaccessible disk  cylinders.  'lba32'  avoids  many  of
              these  pitfalls  with  its  use  of  packet  addressing, but requires a recent BIOS
              (post-1998).  The 'linear' option is considered obsolete, and its use  is  strongly
              discouraged.

       lock   Enables automatic recording of boot command lines as the defaults for the following
              boots. This way, lilo "locks" on a choice until it is manually overridden.

       mandatory
              The per-image password option `mandatory' (see below) applies to all images.

       map=<map-file>
              Specifies the location of the map file. If `map' is omitted, the file /boot/map  is
              used.

              On  machines  with  a  pre-1998 BIOS, the EDD bios extensions which are required to
              support "lba32" disk sector addressing may not be present. In this case, the  boot-
              loader  will  fall  back  automatically  to  "geometric" addressing; this fall back
              situation, or the specific use of "geometric" or "linear" addressing, will  require
              the  map file to be located within the first 1024 cylinders of the disk drive. This
              BIOS limitation is not present on post-1998 systems,  most  of  which  support  the
              newer EDD disk BIOS calls.

       menu-title=<title-string>
              Specifies  the  title  line  (up  to  37  characters) for the boot menu. This title
              replaces the default "LILO Boot Menu" title string. If menu is not installed as the
              boot loader (see install= option), then this line has no effect.

       menu-scheme=<color-scheme>
              The  default  color scheme of the boot menu may be overridden on VGA displays using
              this option. (The color scheme of MDA displays is fixed.)  The general color-scheme
              string is of the form:

                   <text>:<highlight>:<border>:<title>

              where  each  entry  is  two  characters  which  specify  a  foreground  color and a
              background color. Only the first entry is required. The default  highlight  is  the
              reverse  of  the  text  color; and the default border and title colors are the text
              color.  Colors are specified using the characters kbgcrmyw, for blacK, Blue, Green,
              Cyan, Red, Magenta, Yellow, and White: upper case for intense (fg only), lower case
              for dim.  Legal color-scheme strings would be

                  menu-scheme=Wm     intense white on magenta
                  menu-scheme=wr:bw:wr:Yr    the LILO default
                  menu-scheme=Yk:kw    bright yellow on black

              If menu is not installed as the boot loader, then this line has no effect.

       message=<message-file>
              specifies a file containing a message that is displayed before the boot prompt.  No
              message  is  displayed  while waiting for a shifting key after printing "LILO ". In
              the message, the  FF  character  ([Ctrl  L])  clears  the  local  screen.  This  is
              undesirable  when  the menu boot loader is installed.  The size of the message file
              is limited to 65535 bytes. The map file has to be rebuilt if the  message  file  is
              changed or moved.  'message=' and 'bitmap=' are mutually exclusive.

       nodevcache
              (22.8)  Disables  pre-loading of the internal device cache. May be needed for Linux
              distributions which use non-standard device  naming  conventions;  e.g.,  when  the
              first IDE disk is not `/dev/hda'.

       nokbdefault=<name>
              (22.7.2)  The  named  descriptor is taken to be the default boot image if no IBM-PC
              keyboard is present. If no  serial  interface  ("serial=")  is  in  use,  then  any
              "prompt"  keyword  and  "timeout" value are bypassed, and default booting occurs as
              specified by "delay=".  The keyboard detection codes cannot detect the presence  or
              absence of a newer USB keyboard.

       noraid Disables  the automatic marking of disk volumes which are components of RAID arrays
              as  inaccessible.   This  allows  the  user  to  edit  the  disk=  /   inaccessible
              declarations  into  the  configuration  file  himself.   Without such declarations,
              duplicate Volume IDs will be overwritten, leading to confusing situations at  boot-
              time,  and  possible  failure  to  boot.   The use of this keyword is generally not
              necessary.

       nowarn Disables warnings about possible future dangers.

       optional
              The per-image option `optional' (see below) applies to all images.

       password=<password>
              The per-image option `password=...' (see below) applies to all images. This  option
              may  prevent  unattended  booting, if the default image is `password=' protected at
              the default level `mandatory', which is a level higher than `restricted'.

       prompt Automatic booting (see `delay' above) will not take place unless a locked  or  pre-
              stored ("lilo -R") command line is present. Instead, the boot loader will issue the
              boot: prompt and wait  for  user  input  before  proceeding  (see  timeout  below).
              Unattended default image reboots are impossible if `prompt' is set and `timeout' is
              not,  or  the  default  image  is  password  protected  at  a  higher  level   than
              `restricted'.

       raid-extra-boot=<option>
              This  option  only  has  meaning  for  RAID1  installations.   The  <option> may be
              specified as none, auto, mbr, mbr-only, or a comma-separated list of devices; e.g.,
              "/dev/hda,/dev/hdc6".  Starting with LILO version 22.0, the boot record is normally
              written to the first sector of the RAID1 partition.   On  PARALLEL  raid  sets,  no
              other  boot records are needed.  The default action is auto, meaning, automatically
              generate auxiliary boot records as needed on SKEWED raid sets.  none means suppress
              generation of all auxiliary boot records.  mbr-only suppresses generation of a boot
              record on the raid device, and forces compatibility with versions of  LILO  earlier
              than  version 22.0 by writing boot records to all Master Boot Records (MBRs) of all
              disks which have partitions in the raid set. mbr is like mbr-only except  the  boot
              record  on  the  RAID  partition  is  not  suppressed.   Use of an explicit list of
              devices, forces writing of auxiliary boot records only on those devices enumerated,
              in  addition  to  the  boot  record on the RAID1 device. Since the version 22 RAID1
              codes will never automatically write a boot record on the MBR of  device  0x80,  if
              such  a  boot  record is desired, this is one way to have it written. Use of mbr is
              the other way to force writing to the MBR of device 0x80.

       restricted
              The per-image password option `restricted' (see below) applies to all images.

       serial=<parameters>
              enables control from a serial line. The specified serial port  is  initialized  and
              the  boot  loader  is accepting input from it and from the PC's keyboard. Sending a
              break on the serial line corresponds to pressing a shift  key  on  the  console  in
              order  to  get  the  boot  loader's attention.  All boot images should be password-
              protected if the serial access is less secure than access to the console,  e.g.  if
              the line is connected to a modem. The parameter string has the following syntax:

                  <port>[,<bps>[<parity>[<bits>]]]

              <port>:   the  number  of  the serial port, zero-based. 0 corresponds to COM1 alias
              /dev/ttyS0, etc. All four ports can be used (if present).

              <bps>:  the baud rate of the serial port. The following baud rates  are  supported:
              110, 150, 300, 600, 1200, 2400(default), 4800, 9600, plus the extended rates 19200,
              38400, and 57600(56000).  115200 is allowed, but may not work with  all  COMx  port
              hardware.

              <parity>:  the parity used on the serial line. The boot loader ignores input parity
              and strips the 8th bit. The following (upper or lower case) characters are used  to
              describe  the  parity:   "n"  for  no  parity,  "e" for even parity and "o" for odd
              parity.

              <bits>:  the number of bits in a character.  Only  7  and  8  bits  are  supported.
              Default is 8 if parity is "none", 7 if parity is "even" or "odd".

              If `serial' is set, the value of `delay' is automatically raised to 20.

              Example: "serial=0,2400n8" initializes COM1 with the default parameters.

       single-key
              This  option specifies that boot images or 'other's are to be selected and launched
              with a single keystroke.  Selection is based upon the first character of each name,
              which  must be unique.  This option should not be used with the menu or bitmap user
              interface ("install=").

       static-BIOS-codes
              Causes the operation of the boot installer and boot loader to  bypass  the  use  of
              Volume-ID  information,  and  to  revert to a mode of operation of versions of LILO
              from 22.4 backward.  With Volume-ID booting (22.5 and later),  the  BIOS  codes  of
              disks  are  determined  at  boot time, not install time; hence they may be switched
              around, either by adding or removing disk(s) from the hardware configuration, or by
              using a BIOS menu to select the boot device.

              With  the  use  of  this option, BIOS codes of disks MUST be correctly specified at
              install time; either guessed correctly by LILO (which often fails on mixed IDE/SCSI
              systems),  or  explicitly specified with 'disk=/dev/XXX bios=0xYY' statements.  The
              use of this option precludes any activity which may switch around  the  BIOS  codes
              assigned to particular disk devices, as noted above.

              In general, this option should never be used, except as a bug workaround.

       suppress-boot-time-BIOS-data
              This  global  option  suppresses the boot-time real mode collection of BIOS data on
              systems which hang on certain BIOS calls.  It is equivalent to using the  boot-time
              switch 'nobd'.

              This  option  defeats  the  disk  volume recognition and BIOS device code detection
              features of LILO on systems with more than one disk. Thus the use  of  this  option
              will produce a strong cautionary message, which cannot be suppressed.

       timeout=<tsecs>
              sets  a  timeout  (in  tenths  of a second) for keyboard input at the boot: prompt.
              "timeout" only has meaning if "prompt" is mentioned.  If no key is pressed for  the
              specified  time,  the default image is automatically booted. The default timeout is
              infinite.

       unattended
              (22.6) Alters the operation of the "timeout" parameter in a manner which is  useful
              on  noisy  serial  lines.   Each  typed (or noise) character restarts the "timeout"
              timer and a timeout  will  always  boot  the  default  descriptor,  even  if  noise
              characters have appeared on the input line.

       verbose=<number>
              Turns  on  lots  of progress reporting. Higher numbers give more verbose output. If
              -v  is additionally specified on the lilo command  line,  the  level  is  increased
              accordingly. The maximum verbosity level is 5.

       vmdefault=<name>
              The  named boot image is used as the default boot if booting in "virtual" mode with
              a virtual monitor, such as VMware(tm).  Thus a real mode boot and  a  virtual  mode
              boot can be made to have different default boot images.

       Additionally,  the kernel configuration parameters append, ramdisk, read-only, read-write,
       root and vga can be set in the global options section. They are used as defaults  if  they
       aren't specified in the configuration sections of the respective kernel images.

PER-IMAGE SECTION

       A per-image section starts with either a line

           image=<pathname>

       to indicate a file or device containing the boot image of a Linux kernel, or a line

           other=<device>

       to indicate an arbitrary system to boot.

       In  the  former  case,  if  an image line specifies booting from a device, then one has to
       indicate the range of sectors to be mapped using

           range=<start>-<end>
           range=<start>+<nsec>
           range=<sector>

       In the third case, 'nsec=1' is assumed.

KERNEL OPTIONS (image=)

       If the booted image is a Linux kernel, then one may pass command line parameters  to  this
       kernel.

       addappend=<string>
              The  kernel  parameters of this string are concatenated to the parameter(s) from an
              append= option (see below).  The string of addappend must be enclosed within double
              quotes.  Usually, the previous append= will set parameters common to all kernels by
              appearing in the global section of the configuration file and  addappend=  will  be
              used to add local parameter(s) to an individual image.  The addappend option may be
              used only once per "image=" section.

              If the string is a very long line, this line can be divided in more lines using "\"
              as last character of a line, e.g.

                  addappend="noapic acpi=off pci=usepirqmask \
                          pnpbios=off pnpacpi=off noisapnp"

       append=<string>
              Appends  the options specified to the parameter line passed to the kernel.  This is
              typically used to specify hardware parameters that can't be entirely  auto-detected
              or  for which probing may be dangerous. Multiple kernel parameters are separated by
              a blank space, and the string must be enclosed in double quotes.  A  local  append=
              appearing  withing  an image= section overrides any global append= appearing in the
              global section of the configuration file.  The append option may be used only  once
              per "image=" section. To concatenate parameter strings, use "addappend=". Example:

                   append="mem=96M hd=576,64,32 console=ttyS1,9600"

              If the string is a very long line, this line can be divided in more lines using "\"
              as last character of a line. See example of addappend option.

       initrd=<name>
              Specifies the initial ramdisk image to be loaded with the kernel.  The  image  will
              contain  modules  needed  at  boot  time, such as network and scsi drivers. See man
              pages for mkinitrd(8).

       literal=<string>
              Like `append', but removes all other options (e.g. setting  of  the  root  device).
              'literal'  overrides  all  'append' and 'addappend' options.  Because vital options
              can be removed unintentionally with `literal', this option cannot  be  set  in  the
              global options section.

       ramdisk=<size>
              This  specifies  the size (e.g., "4096k") of the optional RAM disk. A value of zero
              indicates that no RAM disk should be created. If this variable is omitted, the  RAM
              disk size configured into the boot image is used.

       read-only
              This  specifies  that  the root file system should be mounted read-only.  It may be
              specified as a global option.  Typically, the system  startup  procedure  re-mounts
              the root file system read-write later (e.g. after fsck'ing it).

       read-write
              This  specifies  that the root file system should be mounted read-write.  It may be
              specified as a global option.

       root=<root-device>
              This specifies the device that should be mounted as root.  It may be specified as a
              global  option.  If the special name current is used, the root device is set to the
              device on which the root file system is currently mounted. If  the  root  has  been
              changed  with   -r  ,  the  respective  device  is  used. If the variable `root' is
              omitted, the root device setting contained in the running  kernel  image  is  used.
              Warning: This can induce to an unbootable system!

              The  root  filesystem  may  also be specified by a LABEL= or UUID= directive, as in
              '/etc/fstab'.  In this case, the argument to root= must be  enclosed  in  quotation
              marks, to avoid a syntax error on the second equal sign, e.g.:

                   root="LABEL=MyDisk"
                   root="UUID=5472fd8e-9089-4256-bcaa-ceab4f01a439"

              Note:    The   command   line  root=  parameter  passed  to  the  kernel  will  be:
              'root=LABEL=MyDisk'; i.e., without the quotation marks. If the root=  parameter  is
              passed  from  the  boot time boot: prompt, no quotes are used.  The quotes are only
              there to satisfy the requirements of the boot-installer  parser,  which  treats  an
              equal  sign  as  an operator.  The kernel command line parser is very much simpler,
              and must not see any quotation marks.  Simply stated, only use the quotation  marks
              within /etc/lilo.conf.

       vga=<mode>
              This  specifies  the VGA text mode that should be selected when booting.  It may be
              specified as a global  option.   The  following  values  are  recognized  (case  is
              ignored):

              normal: select normal 80x25 text mode.

              extended (or ext): select 80x50 text mode.

              ask: stop and ask for user input (at boot time).

              <number>:  use the corresponding text mode (can specify the number in decimal or in
              hex with the usual '0x' convention).  A list of available modes can be obtained  by
              booting with vga=ask and pressing [Enter].

              If  this variable is omitted, the VGA mode setting contained in the kernel image is
              used. (And that is set at compile time using the SVGA_MODE variable in  the  kernel
              Makefile, and can later be changed with the rdev(8) program.)

ALTERNATE SYSTEM (other=)

       Used to load systems other than Linux. The `other = <device>' specifies the boot sector of
       an alternate system  contained  on  a  device  or  disk  partition;  e.g.,  DOS  on,  say,
       `/dev/hda2',  or  a floppy on `/dev/fd0'.  In the case of booting another system there are
       these options:

       loader=<chain-loader>
              This specifies the chain loader that should be used.  It may also be specified as a
              global  option.   By default chain is used.  This chain loader passes partition and
              drive information in the boot sector it loads  only  to  DOS  on  FAT12  or  FAT16,
              Windows on FAT16 or FAT32. (see also table=<letter> below).

       table=<device>
              This  specifies the device that contains the partition table.  The boot loader will
              pass default partition information to the booted operating system if this  variable
              is  omitted.  (Some  operating  systems  have  other  means to determine from which
              partition they have been booted.  E.g., MS-DOS usually stores the geometry  of  the
              boot disk or partition in its boot sector.)  Note that /sbin/lilo must be re-run if
              a partition table mapped referenced with `table' is modified.

       table=<drive-letter>
              This option is obsolete. It were used in the special case with the  obsolete  os2_d
              chain loader.

       change This  keyword  starts  a  section  which  describes  how  primary partition IDs are
              changed, and how primary partitions are activated and deactivated.   If  change  is
              omitted, change rules are generated as though the automatic keyword were specified.
              The keyword change alone, without any  rules  following,  will  suppress  automatic
              change-rules.  For example,

                 other=/dev/hda2
                    label=dos
                    table=/dev/hda
                    change
                      automatic
                      partition=/dev/hda1
                         set=DOS12_hidden
                         deactivate
                      partition=/dev/hda2
                         set=DOS16_big_normal
                         activate

              specifies  that  when primary partition /dev/hda2 is booted, automatic change-rules
              will be in effect; plus, partition 1, a DOS12 partition, will be  set  hidden,  and
              deactivated.   In  addition,  partition  2,  will  be  set  normal,  and activated.
              Activation sets the boot-flag in the partition table.  The  automatic  keyword  may
              conflict with default change rules, so the set= lines above may be redundant.

       boot-as=<bios>
              This  option  (LILO  version  22.5.1)  indicates the BIOS device code which must be
              assigned to the specified drive in order for the "other=" operating system to boot.
              If the chain loader detects that another BIOS device code is assigned to this disk,
              then it will dynamically swap the assigned device code with  the  specified  device
              code.

              This  option  is easier to specify than "map-drive=" and more general than "master-
              boot" in  that  any  device  code  may  be  specified.   Unlike  "map-drive=",  the
              determination  whether to swap device codes is made at boot time, not install time.
              This is advantageous on systems where the BIOS presents a boot menu of devices, and
              will  map  disks  to  devices  in  different  ways,  depending  upon  the BIOS boot
              selection.

              This option may be specified as a global option, in which case it  applies  to  all
              "other="  sections  unless overridden with a specific "master-boot" option.  If one
              of "boot-as=" or "master-boot" is specified as a global option,  it  is  better  to
              specify  "master-boot"  as  the global option, as it will not interfere with floppy
              disk BIOS device codes; "boot-as=" is then used  as  a  local  option  to  override
              "master-boot" as necessary.

       master-boot
              This  flag  (LILO  version 22.5) indicates a DOS/Windows or other system which will
              only boot from BIOS device 0x80, the "C:" drive, or BIOS device 0,  the  A:  drive.
              When this flag is specified, if this drive is not assigned device code 0x80 or 0 by
              the BIOS, then the chain loader will dynamically  swap  the  device  code  actually
              assigned  with device code 0x80 or 0 to make this drive appear to be the first hard
              or floppy drive, "C:" or "A:".

              This flag is easier to use than "map-drive=" (see  below),  and  is  preferred,  if
              simple  forcing  of  device  code  0x80  is  all  that is required. It is also more
              general, in that the necessity to swap BIOS device codes is determined  dynamically
              at  boot-time, not at boot install-time, as with "map-drive=".  It is slightly more
              powerful than "boot-as=", in that the device code which is assigned, 0 or 0x80,  is
              determined dynamically.

              This  option  may  be specified as a global option, in which case it applies to all
              "other=" sections unless overridden with a specific "boot-as=" option.

       map-drive=<num>
              Maps BIOS calls for the specified drive to the device code specified  on  the  next
              line  as  to=<num>.   This mapping is useful for booting operating systems, such as
              DOS, from the second hard drive.  The following, swaps the C: and D: drives,

                 map-drive=0x80
                    to=0x81
                 map-drive=0x81
                    to=0x80

              This option is largely  rendered  obsolete  by  "boot-as=",  introduced  with  LILO
              version 22.5.

       unsafe Do  not  access  the  boot  sector  at map creation time. This disables some sanity
              checks, including a partition table check. If the boot sector is on a  fixed-format
              floppy  disk  device,  using UNSAFE avoids the need to put a readable disk into the
              drive when running the map installer. If the boot sector is on a  hard  drive,  the
              BIOS  device  code  of  the  drive  will  have  to  be  specified  explicitly  with
              "disk=/dev/XXXX bios=0x8X inaccessible" in the configuration  file.   `unsafe'  and
              `table' (explicit or implicit) are mutually incompatible.

COMMON DESCRIPTOR OPTIONS (image= & other=)

       In both the image= and other= cases, the following options apply.

       bypass No  password  is  required  to  boot  this  image. Used to indicate that the global
              password does not apply to this `image=' or `other='.  See 'password=' below.

       label=<name>
              The boot loader  uses  the  main  file  name  (without  its  path)  of  each  image
              specification  to identify that image.  A different name can be used by setting the
              variable `label'.

       alias=<name>
              A second name for the same entry can be used by specifying an alias.

       bmp-retain
              The bitmap graphic (install=bmp) is retained when control is passed to  the  loaded
              kernel image, or other= bootloader; i.e., the screen is not blanked to alphanumeric
              mode before starting the kernel.  This  feature  is  considered  EXPERIMENTAL,  for
              those users working with startup splash screens.

       fallback=<command-line>
              Specifies  a string that is stored as the default command line if the current image
              is booted. This is useful when experimenting with kernels which  may  crash  before
              allowing interaction with the system. If using the fallback option, the next reboot
              (e.g.  triggered by a manual reset or by a watchdog timer) will  load  a  different
              (supposedly  stable)  kernel.  The command line stored by the fallback mechanism is
              cleared by removing or changing the default command line with the -R option,  which
              should be a part of the boot startup scripts.

       lock   (See above.)

       optional
              Omit the image if it is not available at map creation time.  It may be specified as
              a global option.  This is useful to  specify  test  kernels  that  are  not  always
              present.

       password=<password>
              Protect  the  `image='  or  `other='  with  a  password (or passphrase).  It may be
              specified as a global option.  The interpretation of  the  `password='  setting  is
              modified by the words `mandatory', `restricted', and `bypass' (see below).
              The  password  may  be specified in the config-file (less secure) or entered at the
              time the boot loader is installed. To request interactive entry of the password, it
              should be specified: password="".  Passwords entered interactively are not required
              to be entered again if the boot installer is re-run. They  are  cached,  in  hashed
              form,  in a companion file to the config-file, default name: /etc/lilo.conf.crc. If
              the config-file is updated, a warning message will be issued telling you to  re-run
              lilo -p to force re-creation of the password cache file.

       mandatory
              A  password  is  required to boot this image. This is the default. May be used on a
              single `image=' or `other=' to override a different global setting.

       nokbdisable
              (22.7.2) The specified descriptor is not bootable if the  IBM-PC  keyboard  is  not
              present.   This  option  is really only useful if the "serial=" boot terminal is in
              use.  With no  keyboard  (and  no  serial  terminal)  attached,  selecting  a  boot
              descriptor other than the default is impossible.  See nokbdefault above.

       restricted
              A password is only required to boot the image if kernel parameters are specified on
              the command line (e.g. 'single').  May be used on a single `image=' or `other='  to
              override a different global setting.

       vmwarn If  booting  under  a virtual monitor such as VMware(tm), the image with this label
              will cause a cautionary warning to be issued at boot time,  and  user  intervention
              will be required to continue or to abort the boot process.

       vmdisable
              If booting under a virtual monitor, the image with this label will not be displayed
              as a boot option.  The image is only bootable in real mode.  See vmdefault above.

SEE ALSO

       lilo(8), mkinitrd(8), mknod(1), mkrescue(8), rdev(8).

                                            April 2011                               LILO.CONF(5)