-.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
+.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
. ds PI \(*p
. ds L" ``
. ds R" ''
+. ds C`
+. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
-.ie \nF \{\
-. de IX
-. tm Index:\\$1\t\\n%\t"\\$2"
+.\"
+.\" Avoid warning from groff about undefined register 'F'.
+.de IX
..
-. nr % 0
-. rr F
-.\}
-.el \{\
-. de IX
+.nr rF 0
+.if \n(.g .if rF .nr rF 1
+.if (\n(rF:(\n(.g==0)) \{
+. if \nF \{
+. de IX
+. tm Index:\\$1\t\\n%\t"\\$2"
..
+. if !\nF==2 \{
+. nr % 0
+. nr F 2
+. \}
+. \}
.\}
+.rr rF
.\" ========================================================================
.\"
.IX Title "LILO 8"
-.TH LILO 8 "2013-05-01" "23.3" "lilo documentation"
+.TH LILO 8 "2015-11-22" "24.2" "lilo documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.IP "\fB\-A\fR \fImaster-device [N]\fR" 4
.IX Item "-A master-device [N]"
Used with a single argument, inquire of active partition on device \fImaster-device\fR;
-e.g. \fI/dev/sda\fR. With N==0: deactivate all partitions on the device. With N in
+e.g. \fI/dev/sda\fR. With N==0: deactivate all partitions on the device. With N in
the range [1..n]: activate the specified partition and deactivate all others.
Normally, only primary partitions [1..4] may be activated, but if the 'Extended
-Master Boot Loader' is present on the Master Boot Record (\s-1MBR\s0) of the device
+Master Boot Loader' is present on the Master Boot Record (\s-1MBR\s0) of the device
(see the \-M option), any partition may be made active. Whether the actual \s-1OS\s0
-in the partition will boot from an extended partition depends on the characteristics
-of the \s-1OS\s0. \s-1LILO\s0 boot records for Linux may be booted from an extended partition.
+in the partition will boot from a logical partition depends on the characteristics
+of the \s-1OS. LILO\s0 boot records for Linux may be booted from a logical partition.
.IP "\fB\-b\fR \fIbootdev\fR" 4
.IX Item "-b bootdev"
Set the boot device where the boot loader will be installed. For example
\&\fI\*(L"\-b /dev/sda\*(R"\fR set the Master Boot Record (\s-1MBR\s0) on the first disk as boot
-device. \fI\*(L"\-b /dev/sdb5\*(R"\fR set the first extended partition on the second disk
+device. \fI\*(L"\-b /dev/sdb5\*(R"\fR set the first logical partition on the second disk
as boot device.
.IP "\fB\-B\fR \fIbitmap-file\fR" 4
.IX Item "-B bitmap-file"
.IP "\fB\-g\fR" 4
.IX Item "-g"
Generate 'cylinder/head/sector' (\s-1CHS\s0 geometric) disk addresses. Limited to cylinders
-up to 1023. Forces compatibility with very old versions of \s-1LILO\s0 \fI(obsolete switch)\fR.
+up to 1023. Forces compatibility with very old versions of \s-1LILO \s0\fI(obsolete switch)\fR.
.IP "\fB\-H\fR" 4
.IX Item "-H"
Override fatal halt if a \s-1RAID\s0 array does not have all disks active.
Install a Master Boot Record on the device specified as master-device, selecting
the Standard or Extended Master Boot Loader per option. The primary partition
table on master-device is undisturbed. If no valid Volume-ID (serial number) is
-present, then generate one and write it to the \s-1MBR\s0. If \fImbr\fR is set, the
+present, then generate one and write it to the \s-1MBR.\s0 If \fImbr\fR is set, 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 \fIext\fR is set,
-the search for an active partition will include extended partitions as well.
+the search for an active partition will include logical partitions as well.
The presence of the Extended Master Boot Loader on the Master Boot Record
(\s-1MBR\s0 = sector 0) of a disk affects the operation of the \fI\-A\fR option.
.IP "\fB\-p\fR" 4
once-only command. It is typically used in reboot scripts, just before calling
\&'shutdown \-r'. Used without any arguments, it will cancel a \fIlock\fR\-ed or
\&\fIfallback\fR command line.
+.Sp
+This Command line starts with image identifier (as shown during map file update),
+then space, then kernel parameters. The kernel parameters are appended to kernel
+command line constructed routinely. In either case, it there were parameters
+or not, such one-time command will be treated by loaders code, as if it is set
+at 'boot:' prompt. This could lead to 'password:' prompt at boot time. Be warned!
+Refer to \fI\fIlilo.conf\fI\|(5)\fR for details.
.IP "\fB\-s\fR \fIsave-file\fR" 4
.IX Item "-s save-file"
When lilo writes a new boot sector, it preserves the former contents of the boot
.IX Item "-X"
Reserved for \s-1LILO\s0 internal use. May produce different output for different \s-1LILO\s0
versions. The line beginning \*(L"CFLAGS=\*(R" will contain the compiler options used to
-generate this version of \s-1LILO\s0.
+generate this version of \s-1LILO.\s0
.IP "\fB\-z\fR" 4
.IX Item "-z"
-When used with the '\-M' switch, clears the Volume-ID. Usually used in the
+When used with the '\-M' switch, clears the Volume-ID. Usually used in the
following sequence to generate a new Volume-ID:
.Sp
.Vb 2
-\& lilo \-z \-M /dev/hda
-\& lilo \-M /dev/hda
+\& lilo \-z \-M /dev/sda
+\& lilo \-M /dev/sda
.Ve
.IP "\fB\-Z\fR \fIoption\fR" 4
.IX Item "-Z option"
Tells the boot installer whether special precautions need to be taken because
-the \s-1BIOS\s0 fails to pass the correct device code in \s-1DL\s0 (\-Z0). Or may specify
+the \s-1BIOS\s0 fails to pass the correct device code in \s-1DL \s0(\-Z0). Or may specify
that the \s-1BIOS\s0 always gets \s-1DL\s0 right (\-Z1). Corresponds to, and overrides, the
configuration file option 'bios\-passes\-dl='.
.SH "CONFIG OPTIONS"
.SH "BOOT OPTIONS"
.IX Header "BOOT OPTIONS"
The options described here may be specified at boot time on the command line
-when a kernel image is booted. These options are processed by \s-1LILO\s0, and are
+when a kernel image is booted. These options are processed by \s-1LILO,\s0 and are
removed from the command line before it is passed to the kernel, unless otherwise
noted.
.IP "\fBlock\fR" 4
\& Loading...............
\& BIOS data check
.Ve
-.IP "\fBvga=[\s-1ASK\s0,EXT,EXTENDED,NORMAL,###,0x###]\fR" 4
+.IP "\fBvga=[\s-1ASK,EXT,EXTENDED,NORMAL\s0,###,0x###]\fR" 4
.IX Item "vga=[ASK,EXT,EXTENDED,NORMAL,###,0x###]"
Allows overriding the default video mode upon kernel startup.
.SH "BOOT ERRORS"
.IX Header "BOOT ERRORS"
The boot process takes place in two stages. The first stage loader is a single
-sector, and is loaded by the \s-1BIOS\s0 or by the loader in the \s-1MBR\s0. It loads the
+sector, and is loaded by the \s-1BIOS\s0 or by the loader in the \s-1MBR.\s0 It loads the
multi-sector second stage loader, but is very space limited. When the first
stage loader gets 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
\& FF sense operation failed
.Ve
.PP
-Error code 40 is generated by the \s-1BIOS\s0, or by \s-1LILO\s0 during the conversion of a
+Error code 40 is generated by the \s-1BIOS,\s0 or by \s-1LILO\s0 during the conversion 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 may also be generated.
Errors 99 and 9A usually mean the map file ('\-m' or 'map=') is not readable,
likely because \s-1LILO\s0 was not re-run after some system change, or there is a
geometry mismatch between what \s-1LILO\s0 used (lilo \-v3 to display) and what is
-actually being used by the \s-1BIOS\s0 (one of the lilo diagnostic disks, available
+actually being used by the \s-1BIOS \s0(one of the lilo diagnostic disks, available
in the source distribution, may be needed to diagnose this problem).
.PP
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 \*(L"Descriptor Table\*(R" \- the list of kernels/others to boot \- it will print
-the letter \*(L"O\*(R", to form the full word \*(L"\s-1LILO\s0\*(R", in uppercase.
+the letter \*(L"O\*(R", to form the full word \*(L"\s-1LILO\*(R",\s0 in uppercase.
.PP
All second stage loader error messages are English text and try to pinpoint,
more or less successfully, the point of failure.
.Vb 3
\& Copyright (C) 1992\-1998 Werner Almesberger
\& Copyright (C) 1999\-2007 John Coffman
-\& Copyright (C) 2009\-2013 Joachim Wiedorn
+\& Copyright (C) 2009\-2014 Joachim Wiedorn
.Ve
.PP
-Redistribution and use in source and binary forms, with or without
-modification, are permitted under the terms of the \s-1BSD\s0 license found in
+Redistribution and use in source and binary forms, with or without
+modification, are permitted under the terms of the \s-1BSD\s0 license found in
the \s-1COPYING\s0 file.
.SH "AUTHOR"
.IX Header "AUTHOR"
.Ve
.PP
This manual page was written by Werner Almesberger and Joachim Wiedorn
-<ad_debian at joonet.de>.
+<joodevel at joonet.de>.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBlilo.conf\fR(5),
-\&\fBliloconfig\fR(8),
+\&\fBliloconfig\fR(8),
\&\fBlilo-uuid-diskid\fR(8),
-\&\fBmkrescue\fR(8),
+\&\fBmkrescue\fR(8),
\&\fBfdisk\fR(8),
\&\fBmkinitrd\fR(8)
projects / rrq / maintain_lilo.git / blobdiff