LILO(8) LILO(8)
NAME
lilo(5,8) - install boot loader
SYNOPSIS
Main function:
/sbin/lilo(5,8) - install boot loader
Auxiliary uses:
/sbin/lilo(5,8) -A - activate/show active partition
/sbin/lilo(5,8) -E - edit header or update(7,n) a bitmap file(1,n)
/sbin/lilo(5,8) -I - inquire path name of current kernel
/sbin/lilo(5,8) -M - write(1,2) a Master Boot Loader on a device
/sbin/lilo(5,8) -q - query map
/sbin/lilo(5,8) -R - set(7,n,1 builtins) default command line for next reboot
/sbin/lilo(5,8) -T - tell more about specified topic
/sbin/lilo(5,8) {-u|-U} - uninstall LILO boot loader
DESCRIPTION
lilo(5,8) installs a boot loader that will be activated the next time(1,2,n) you
boot your system. The default configuration file(1,n) /etc/lilo.conf (see
'man(1,5,7) lilo.conf') will contain most options, but many, including those
which override the configuration file(1,n), may be specified on the command
line.
-A master-device [ N ]
Used with a single argument, inquire of active partition on
device master-device; e.g., /dev/hda. With N==0, deactivate all
partitions on the device. With N in(1,8) the range [1..n], activate
the specified partition and deactivate all others. Normally,
only primary partitions [1..4] may be activated, but if(3,n) the
Extended Master Boot Loader is present on the Master Boot Record
of the device (see the -M option), any partition may be made
active. Whether the actual OS in(1,8) the partition will boot from
an extended partition depends on the characteristics of the OS.
LILO boot records for Linux may be booted from an extended par-
tition.
-b bootdev
Specify the boot device; i.e., where the boot loader will be
installed. "-b /dev/hda" specifies the Master Boot Record; "-b
/dev/sdb5" specifies the first extended partition on the second
SCSI disk.
-B bitmap-file
Specify a bitmap file(1,n) for the boot-time graphics screen, prefer-
ably one already pre-processed with the 'lilo(5,8) -E' command.
-c Enable map compaction. This will merge(1,8) read(2,n,1 builtins) requests from adja-
cent sectors. Speeds up the booting (especially from floppy).
-C config-file
lilo(5,8) Specify an alternate pathname for the configuration file.
This option overrides the use of the default configuration file(1,n),
/etc/lilo.conf.
-d delay
Specifies the delay time(1,2,n) in(1,8) tenths of a second (20 = 2 sec)
before automatically booting the first image. Gives you time(1,2,n) to
interrupt the automatic boot process with Shift, Alt, Ctrl,
ScrollLock, or CapsLock. If interrupted, the `boot:' prompt is
displayed. This switch(1,n) is overriden by the appearance of prompt
in(1,8) the configuration file.
-D label
Use the kernel with the given label, instead of the first one in(1,8)
the list, as the default kernel to boot.
-E filename.ext
If .ext is .bmp, then take the file(1,n) to be a bitmap graphic file(1,n)
for use in(1,8) the "bitmap=" configuration file(1,n) directive. Enter an
interactive editor to create or update(7,n) the color/placement
information in(1,8) the bitmap file(1,n) LILO header. (see 'bmp-colors',
'bmp-table', and 'bmp-timer' on the man(1,5,7) page for
'lilo.conf(5)'.)
If .ext is .dat, then take the file(1,n) to be a configuration file(1,n)
which specifies bitmap graphic parameters, which are transferred
into the LILO header in(1,8) the bitmap file(1,n) of the same name.
When a .bmp file(1,n) is modified using a graphics editor (e.g.,
GIMP), the LILO header will be lost. It can be restored using
the .dat file(1,n), which is used as a text-based backup for the LILO
header information.
-f disk-tab
Specify disk geometry parameter file. (The default is /etc/disk-
tab.)
-F Override boot sector check for filesystems (e.g., swap, XFS,
...) which might be destroyed by the installation of the LILO
boot sector on the first sector of the partition. These
filesystems use the first sector as a superblock.
Compare with "-P ignore", which bypasses certain partition table
checks.
-g Generate cylinder/head/sector (geometric) disk addresses. Lim-
ited to cylinders up to 1023. Forces compatibility with older
versions of LILO.
-i boot-loader
Specify a file(1,n) to be used as the new boot loader. (The default
is /boot/boot.b.)
-I label [D|a|i|k|r|R]
label is taken to be the name of an image specified in(1,8) the con-
figuration file. This command will print the path name of the
corresponding kernel file(1,n), keytable file(1,n), initial ramdisk file(1,n),
root specification, or "append=" string(3,n) ("i", "k", "r", "R", or
"a" option). The "D" option ignores the label parameter, and
prints the default "image=" label, or first "image=" label if(3,n) no
default image is specified.
-l Generate 24-bit linear sector addresses instead of cylin-
der/head/sector addresses.
-L Generate 32-bit Logical Block Addresses instead of cylin-
der/head/sector addresses, allowing access(2,5) to all partitions on
disks with more than 1024 cylinders.
-m map-file
Use specified map file(1,n) instead of the default.
-M master-device [mbr|ext]
Install a Master Boot Record on the device specified as master-
device, selecting the Standard or Extended Master Boot Loader
per the option. The primary partition table on master-device is
undisturbed. If no valid Volume-ID (serial number) is present,
then generate one and write(1,2) it to the MBR. If mbr is specified,
the Standard Master Boot Loader will search partitions 1-4 for
an active flag, and boot the flagged partition. Only one active
flag is allowed. If ext is specified, the search for an active
partition will include extended partitions as well. The pres-
ence of the Extended Master Boot Loader on the Master Boot
Record (MBR = sector 0) of a disk affects the operation of the
-A option.
-p Require interactive entry of all passwords specified as "" in(1,8)
the configuration file.
-P {fix|ignore|<global-option>}
Fix or ignore `corrupt' partition tables, i.e., partition tables
with linear and cylinder/head/sector addresses that do not cor-
respond. Always try -P ignore first, as -P fix will re-write
the partition table, possibly destroying all partitions on the
disk.
-P ignore is also used to bypass the partition table check for
partition types within the partition table which might not allow
the installation of a LILO boot sector. Compare with the "-F"
flag, which overrides the check of the actual boot sector.
-P <global-option> allows the passing of any global option which
may appear in(1,8) the global section (top) of the configuration file(1,n)
(/etc/lilo.conf). For instance, -P nowarn will pass the
"nowarn" option, just as though "nowarn" appeared in(1,8) the config-
uration file(1,n) (same as the "-w" switch(1,n)). Similarly, -P time-
out=50 will add or override the "timeout(1,3x,3x cbreak)=" line in(1,8) the configu-
ration file. Note that the general -P switch(1,n) actually dupli-
cates a number of command line option switches. However, it is
not strictly the same as some switches whick cause an override
of other options; e.g., "-g" (-P geometric), "-L" (-P lba32).
-q List the currently mapped files. lilo(5,8) maintains a file(1,n), by
default /boot/map, containing the name and location of the ker-
nel(s) to boot. This option will list the names therein. Use
with -v for more detailed information about the installed boot
loader.
-r root-directory
Before doing anything else, do a chroot(1,2) to the indicated direc-
tory. The new root directory must contain a /dev directory, and
may need a /boot directory. It may also need an /etc/lilo.conf
file.
-R command line
This option sets the default command for the boot loader the
next time(1,2,n) it executes. The boot loader will then erase this
line: this is a once-only command. It is typically used in(1,8)
reboot scripts, just before calling `shutdown(2,8) -r'. Used without
any arguments, it will cancel a lock-ed or fallback command
line.
-s save-file
When lilo(5,8) writes a new boot sector, it preserves the former con-
tents of the sector in(1,8) a file(1,n), named(5,8) by default /boot/boot.NNNN,
where NNNN is the hexadecimal representation of the major and
minor device numbers of the drive/partition. This option speci-
fies the backup save file(1,n) in(1,8) one of three ways: a save directory
(default is '/boot') using the default filename 'boot.NNNN' in(1,8)
the specified directory; a pathname template to which '.NNNN' is
appended (default would be '/boot/boot'); or the full pathname
of the file(1,n), which must include the correct '.NNNN' suffix. When
used with the -u option, the full file(1,n) pathname must be speci-
fied.
-S save-file
Normally, lilo(5,8) will not overwrite an existing boot sector save
file. This options says that overwriting is to be forced. As
with -s, the specification may be of a save directory, pathname
template, or full pathname (which includes the '.NNNN' suffix.)
-t Test only. Do not really write(1,2) a new boot sector or map file.
Use together with -v to find out what lilo(5,8) is about to do.
-T option
Print out system information, some of it extracted from the sys-
tem bios. This is more convenient than booting the LILO diag-
nostic floppy on problem systems. option may be any one of the
following:
help - print a list of available diagnostics
ChRul - list the partition types subject to
Change-Rules
EBDA - list Extended BIOS Data Area information
geom=<drive> list drive geometry for bios drive;
e.g., geom=0x80
geom - list drive geometry for all drives
table=<drive> list the primary partition table;
e.g., table=/dev/sda
video - list graphic modes available to boot
loader
-u [device-name]
Uninstall lilo(5,8) by copying the saved boot sector back. The '-s'
and '-C' switches may be used with this option. The device-name
is optional. A time-stamp is checked.
-U [device-name]
Idem, but do not check the time-stamp.
-v Increase verbosity. Giving one to five -v options will make lilo(5,8)
more verbose, or use, -v n (n=1..5) to set(7,n,1 builtins) verbosity level 'n'.
-V Print version(1,3,5) number.
-w Used as -w or -w-, suppress warning messages. Used as -w+,
override nowarn in(1,8) the configuration file(1,n), and show warning mes-
sages.
-x option
For RAID installations only. The option may be any of the key-
words none, auto(5,8), mbr, mbr-only, or a comma separated list of
additional boot devices (no spaces allowed in(1,8) the list).
-X Reserved for LILO internal use. May produce different output
for different LILO versions. The line beginning "CFLAGS=" will
contain the compiler options used to generate this version(1,3,5) of
LILO.
-z When used with the -M switch(1,n), clears the Volume-ID. Usually
used in(1,8) the following sequence to generate a new Volume-ID:
lilo(5,8) -z -M /dev/hda
lilo(5,8) -M /dev/hda
-Z option
Tells the boot installer whether special precautions need to be
taken because the BIOS fails to pass the correct device code in(1,8)
DL (-Z0). Or may specify that the BIOS always gets(3,n) DL right
(-Z1). Corresponds to, and overrides, the configuration file(1,n)
option 'bios-passes-dl='.
The above command line options correspond to the key words in(1,8) the con-
fig(1,5) file(1,n) indicated below.
-b bootdev boot=bootdev
-B file.bmp bitmap=file.bmp
-c compact
-d dsec delay=dsec
-D label default=label
-i boot-loader install=boot-loader
-f file(1,n) disktab=file(1,n)
-g geometric
-l linear
-L lba32
-m mapfile map=mapfile
-P fix fix-table
-P ignore ignore-table
-s file(1,n) backup=file(1,n)
-S file(1,n) force-backup=file(1,n)
-v [N] verbose=N
-w nowarn
-x option raid-extra-boot=option
-Z option bios-passes-dl=option
BOOT OPTIONS
The options described here may be specified at on the command line when
a kernel image is booted. These options are processed by LILO, and are
removed from the command line passed to the kernel, unless otherwise
noted.
lock Locks the command line, as though 'lock' had been specified in(1,8)
'lilo.conf.'
mem=###[,K,M,G]
Specifies the maximum memory in(1,8) the system in(1,8) bytes, kilobytes,
megabytes, or gigabytes. This option is not removed from the
command line, and is always passed to the kernel.
nobd Suppresses the BIOS data check. This option is reserved for use
with non-IBM-compliant BIOS's which hang with the lines:
Loading...............
BIOS data check
vga=[ASK,EXT,EXTENDED,NORMAL]
Allows overriding the default video mode upon kernel startup.
BOOT ERRORS
The boot process takes place in(1,8) two stages. The first stage loader is
a single sector, and is loaded by the BIOS or by the loader in(1,8) the MBR.
It loads the multi-sector second stage loader, but is very space lim-
ited. When the first stage loader gets(3,n) control, it types the letter
"L"; when it is ready to transfer control to the second stage loader it
types the letter "I". If any error(8,n) occurs, like a disk read(2,n,1 builtins) error(8,n), it
will put out a hexadecimil error(8,n) code, and then it will re-try the
operation. All hex error(8,n) codes are BIOS return values, except for the
lilo-generated 40, 99 and 9A. A partial list of error(8,n) codes follows:
00 no error(8,n)
01 invalid disk command
02 address mark not found
03 disk write-protected
04 sector not found
06 floppy disk removed
08 DMA overrun
0A bad sector flag
0B bad track flag
20 controller failure
40 seek failure (BIOS)
40 cylinder>1023 (LILO)
99 invalid second stage index sector (LILO)
9A no second stage loader signature (LILO)
AA drive not ready
FF sense operation failed
Error code 40 is generated by the BIOS, or by LILO during the conver-
sion of a linear (24-bit) disk address to a geometric (C:H:S) address.
On older systems which do not support lba32 (32-bit) addressing, this
error(8,n) may also be generated. Errors 99 and 9A usually mean the map
file(1,n) (-m or map=) is not readable, likely because LILO was not re-run
after some system change, or there is a geometry mis-match between what
LILO used (lilo(5,8) -v3 to display) and what is actually being used by the
BIOS (one of the lilo(5,8) diagnostic disks, available in(1,8) the source distri-
bution, may be needed to diagnose this problem).
When the second stage loader has received control from the first stage,
it prints the letter "L", and when it has initialized itself, including
verifying the "Descriptor Table" - the list of kernels/others to boot -
it will print the letter "O", to form the full word "LILO", in(1,8) upper-
case.
All second stage loader error(8,n) messages are English text, and try to
pinpoint, more or less(1,3) successfully, the point of failure.
INCOMPATIBILITIES
lilo(5,8) is known to have problems with the reiserfs introduced with the
2.2.x kernels, unless the file(1,n) system is mounted with the 'notail'
option. This incompatibilty has been resolved with reiserfs 3.6.18 and
lilo(5,8) 21.6. reiser4 introduced with the 2.5.x kernels requires lilo(5,8)
22.5.2 or later.
Beginning with version(1,3,5) 22.0, RAID installations write(1,2) the boot record
to the RAID partition. Conditional writing of MBRs may occur to aid in(1,8)
making the RAID set(7,n,1 builtins) bootable in(1,8) a recovery situation, but all default
actions may be overridden. Action similar to previous versions is
achieved using the `-x mbr-only' switch.
BUGS
Configuration file(1,n) options `backup' and `force-backup' should specify a
backup directory or backup file(1,n) pathname template on all RAID installa-
tions. Use of an explicit filename may not allow mulitple backup files
to be created correctly. It is best to use the default mechanism, as it
works correctly in(1,8) all cases.
SEE ALSO
fdisk(8),