Penguin
Blame: lilo.conf(5)
EditPageHistoryDiffInfoLikePages
Annotated edit history of lilo.conf(5) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 LILO.CONF
2 !!!LILO.CONF
3 NAME
4 DESCRIPTION
5 GLOBAL OPTIONS
6 PER-IMAGE SECTION
7 KERNEL OPTIONS (image=)
8 ALTERNATE SYSTEM (other=)
9 COMMON OPTIONS (image=
10 SEE ALSO
11 ----
12 !!NAME
13
14
15 lilo.conf - configuration file for lilo
16 !!DESCRIPTION
17
18
19 This file, by default ''/etc/lilo.conf'', is read by the
20 boot loader installer 'lilo' (see lilo(8)).
21
22
23 It might look as follows:
24
2 LinuxLarry 25 boot=/dev/hda
26 prompt
27 timeout=150
28 lba32
29 compact
30 vga=normal
31 root=/dev/hda1
32 read-only
33 menu-title=
1 perry 34
35
36 This configuration file specifies that lilo uses the Master
37 Boot Record on /dev/hda. (For a discussion of the various
38 ways to use lilo, and the interaction with other operating
39 systems, see user.tex from the lilo
40 documentation.)
41
42
43 When booting, the boot loader will issue its ''boot:''
44 prompt and wait for you to enter the label of the kernel
45 (and any options) which you wish to boot. At any time you
46 may hit [[Tab] to see a list of kernel/other labels.
47 Alternately, if the __boot-menu.b__ boot loader is
48 installed, a menu of boot options will be presented for your
49 selection. The title of this menu is overridden with the
50 menu title specification in this configuration file. If you
51 enter nothing, then the default kernel image, the first
52 mentioned, (/boot/zImage-1.5.99) will be booted after a
53 timeout of 15 seconds (150 deciseconds). There can be up to
54 16 images mentioned in lilo.conf.
55
56
57 As can be seen above, a configuration file starts with a
58 number of global options (the top 9 lines in the example),
59 followed by descriptions of the options for the various
60 images. An option in an image description will override a
61 global option.
62
63
64 Comment lines may appear anywhere, and begin with the
65 !!GLOBAL OPTIONS
66
67
68 There are many possible keywords. The description below is
69 almost literally from user.tex (just slightly
70 abbreviated).
71
72
73 __backup=__''''
74
75
76 Copy the original boot sector to ''backup-file'' (which
77 may also be a device, e.g. ''/dev/null'') instead of
78 ''/boot/boot.NNNN''.
79
80
81 __bitmap=__''''
82
83
84 Specifies use of a 640x480x16 bitmap file as the background
85 on which a boot menu is displayed. May not be used if
86 'message=' is specified. Requires that 'install=' specify a
87 boot-loader which is capable of displaying the bitmap; i.e.,
88 ''boot-bmp.b''.
89
90
91 __bmp-colors=__''''
92
93
94 Specifies the decimal values of the colors to be used for
95 the menu display on a 'bitmap=' background. The list
96 consists of 6 entries, 3 for normal text followed by 3 for
97 highlighted text. The order of each triple is: foreground
98 color, background color, shadow color. If background color
99 is not specified,
100
101
102 __bmp-table=__''''
103
104
105 Specifies the location and layout of the menu table.
106
107
108 __bmp-timer=__''''
109
110
111 Optional specification of the 'timeout=' countdown timer.
112 must'' be specified.
113
114
115 __boot=__''''
116
117
118 Sets the name of the device (e.g. a hard disk partition)
119 that contains the boot sector. If this keyword is omitted,
120 the boot sector is read from (and possibly written to) the
121 device that is currently mounted as root. A raid
122 installation is initiated by specifying a RAID1 device as
123 the boot device; e.g.,
124
125
126 __change-rules__
127
128
129 Defines boot-time changes to partition type numbers
130 (`hiding').
131
2 LinuxLarry 132 change-rules
133 reset
134 type=DOS12
135 normal=1
136 hidden=0x11
137 type=DOS16_small
138 normal=4
139 hidden=0x14
140 type=DOS16_big
141 normal=0x06
142 hidden=0x16
1 perry 143
144 The above excerpt from a configuration file specifies that all default ''change-rules'' are removed (''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 ''
145
146
147 __compact__
148
149
150 Tries to merge read requests for adjacent sectors into a
151 single read request. This drastically reduces load time and
152 keeps the map smaller. Using `compact' is especially
153 recommended when booting from a floppy disk.
154
155
156 __default=__''''
157
158
159 Uses the specified image as the default boot image. If
160 `default' is omitted, the image appearing first in the
161 configuration file is used.
162
163
164 __delay=__''''
165
166
167 Specifies the number of tenths of a second the boot loader
168 should wait before automatically booting a locked command
169 line, a command line pre-stored by
170 boot:__ prompt will be be issued, and no
171 automatic boot will take place. The setting of CAPS LOCK or
172 SCROLL LOCK, or any of the keys ALT, CTRL, or SHIFT, when
173 held down, are taken as interrupts.
174
175
176 This action is modified by specifying `prompt' (see
177 below).
178
179
180 __disk=__''''
181
182
183 Defines non-standard parameters for the specified disk. See
184 section
185
2 LinuxLarry 186 disk=/dev/sda
187 bios=0x80
188 disk=/dev/hda
189 bios=0x81
1 perry 190
191 would say that your SCSI disk is the first BIOS disk, and your (primary master) IDE disk is the second BIOS disk.
192
193
194 __disktab=__''''
195
196
197 Specifies the name of the disk parameter table. The map
198 installer looks for ''/etc/disktab'' if `disktab' is
199 omitted. The use of disktabs is discouraged.
200
201
202 __fix-table__
203
204
205 This allows lilo to adjust 3D addresses in partition tables.
206 Each partition entry contains a 3D (sector/head/cylinder)
207 and a linear address of the first and the last sector of the
208 partition. If a partition is not track-aligned and if
209 certain other operating systems (e.g. PC/MS-DOS or OS/2) are
210 using the same disk, they may change the 3D address. lilo
211 can store its boot sector only on partitions where both
212 address types correspond. lilo re-adjusts incorrect 3D start
213 addresses if `fix-table' is set.
214
215
216 WARNING: This does not guarantee that other operating
217 systems may not attempt to reset the address later. It is
218 also possible that this change has other, unexpected
219 side-effects. The correct fix is to re-partition the drive
220 with a program that does align partitions to tracks. Also,
221 with some disks (e.g. some large EIDE disks with address
222 translation enabled), under some circumstances, it may even
223 be unavoidable to have conflicting partition table
224 entries.
225
226
227 __force-backup=__''''
228
229
230 Like `backup', but overwrite an old backup copy if it
231 exists.
232
233
234 __geometric__
235
236
237 Force disk addressing which is compatible with older
238 versions of LILO. Geometric addressing uses
239 sector/head/cylinder addresses, and is limited to disk
240 cylinders up to 1023. If inaccessible cylinders are
241 referenced, diagnostics will be issued at boot-install time,
242 rather than boot-time. With a newer BIOS, use of 'lba32' is
243 recommended.
244
245
246 __ignore-table__
247
248
249 tells lilo to ignore corrupt partition tables.
250
251
252 __install=__''''
253
254
255 Install the specified file as the new boot loader. Starting
256 with version 21.5, two boot loaders are available:
257 ''boot-text.b'' and ''boot-menu.b'', with
258 ''boot.b'' a symbolic link to the latter. Both boot
259 loaders allow the entry of kernel command line options in
260 exactly the same fashion. Both also have full serial line
261 support (see __serial=__ below), although no menu
262 capabilities are available on the serial terminal. The
263 former is available for strict compatibility with previous
264 versions of LILO. If `install' is omitted,
265 ''/boot/boot.b'' is used as the default.
266
267
268 __lba32__
269
270
271 Generate 32-bit Logical Block Addresses instead of
272 sector/head/cylinder addresses. If the BIOS supports packet
273 addressing, then packet calls will be used to access the
274 disk. This allows booting from any partition on disks with
275 more than 1024 cylinders. If the BIOS does not support
276 packet addressing, then 'lba32' addresses are translated to
277 sector/head/cylinder ('geometric'), just as for 'linear'.
278 All floppy disk references are retained in C:H:S form. Use
279 of 'lba32' is recommended on all post-1998 systems.
280 Beginning with LILO version 22, 'lba32' is the default disk
281 addressing scheme.
282
283
284 __linear__
285
286
287 Generate 24-bit linear sector addresses instead of
288 sector/head/cylinder (geometric) addresses. Linear addresses
289 are translated at run time to geometric addresses, and are
290 limited to cylinders
291 /sbin/lilo'' may generate references to
292 inaccessible disk cylinders. 'lba32' avoids many of these
293 pitfalls with its use of packet addressing, but requires a
294 recent BIOS.
295
296
297 __lock__
298
299
300 Enables automatic recording of boot command lines as the
301 defaults for the following boots. This way, lilo
302
303
304 __mandatory__
305
306
307 The per-image password option `mandatory' (see below)
308 applies to all images.
309
310
311 __map=__''''
312
313
314 Specifies the location of the map file. If `map' is omitted,
315 the file ''/boot/map'' is used.
316
317
318 __menu-title=__''''
319
320
321 Specifies the title line (up to 37 characters) for the boot
322 menu. This title replaces the default
323 boot-menu.b'' is not
324 installed as the boot loader (see ''install='' option),
325 then this line has no effect.
326
327
328 __menu-scheme=__''''
329
330
331 The default color scheme of the boot menu may be overridden
332 on VGA displays using this option. (The color scheme of MDA
333 displays is fixed.) The general ''color-scheme'' string
334 is of the form:
335
336
337
338 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 blac__K__, __B__lue, __G__reen, __C__yan, __R__ed, __M__agenta, __Y__ellow, and __W__hite: upper case for intense (fg only), lower case for dim. Legal color-scheme strings would be
339
340
341 menu-scheme=Wm intense white on magenta
342 menu-scheme=wr:bw:wr:Yr the LILO default
343 menu-scheme=Yk:kw bright yellow on black
344 If ''boot-menu.b'' is not installed as the boot loader, then this line has no effect.
345
346
347 __message=__''''
348
349
350 specifies a file containing a message that is displayed
351 before the boot prompt. No message is displayed while
352 waiting for a shifting key after printing
353 boot-menu.b'' boot
354 loader is installed. The size of the message file is limited
355 to 65535 bytes. The map file has to be rebuilt if the
356 message file is changed or moved. 'message=' and 'bitmap='
357 are mutually exclusive.
358
359
360 __nowarn__
361
362
363 Disables warnings about possible future
364 dangers.
365
366
367 __optional__
368
369
370 The per-image option `optional' (see below) applies to all
371 images.
372
373
374 __password=__''''
375
376
377 The per-image option `password=...' (see below) applies to
378 all images. This option may prevent unattended booting, if
379 the default image is `password=' protected at the default
380 level `mandatory', which is a level higher than
381 `restricted'.
382
383
384 __prompt__
385
386
387 Automatic booting (see `delay' above) will not take place
388 unless a locked or pre-stored (
389 boot:'' prompt and wait for user input before
390 proceeding (see ''timeout'' below). Unattended default
391 image reboots are impossible if `prompt' is set and
392 `timeout' is not, or the default image is password protected
393 at a higher level than `restricted'.
394
395
396 __raid-extra-boot=__''''
397
398
399 This option only has meaning for RAID1 installations. The
400 none'', ''auto'',
401 ''mbr-only'', or a comma-separated list of devices; e.g.,
402 ''auto'',
403 meaning, automatically generate auxilary boot records as
404 needed on SKEWED raid sets. ''none'' means suppress
405 generation of all auxiliary boot records. ''mbr-only''
406 suppresses generation of boot records on the raid device,
407 and forces compatibility with versions of LILO earlier than
408 version 22.0 by writing boot records to all Master Boot
409 Records (MBRs) of all disks in the raid set. Use of an
410 explicit list of devices, forces writing of auxiliary boot
411 records only on those devices enumerated, in addition to the
412 boot record on the RAID1 device. Since the version 22 RAID1
413 codes will never automatically write a boot record on the
414 MBR of device 0x80, if such a boot record is desired, this
415 is the way to have it written.
416
417
418 __restricted__
419
420
421 The per-image password option `restricted' (see below)
422 applies to all images.
423
424
425 __serial=__''''
426
427
428 enables control from a serial line. The specified serial
429 port is initialized and the boot loader is accepting input
430 from it and from the PC's keyboard. Sending a break on the
431 serial line corresponds to pressing a shift key on the
432 console in order to get the boot loader's attention. All
433 boot images should be password-protected if the serial
434 access is less secure than access to the console, e.g. if
435 the line is connected to a modem. The parameter string has
436 the following syntax:
437
438
439
440
441
442
443
444
445
446
447
448 If `serial' is set, the value of `delay' is automatically
449 raised to 20.
450
451
452 Example:
453
454
455 __single-key__
456
457
458 This option specifies that boot images or 'other's are to be
459 selected and launched with a single keystroke. Selection is
460 based upon the first character of each name, which must be
461 unique. This option should not be used with the menu or
462 bitmap user interface (
463
464
465 __suppress-boot-time-BIOS-data__
466
467
468 This global option suppresses the boot-time real mode
469 collection of BIOS data on systems which hang on certain
470 BIOS calls. It is equivalent to using the boot-time switch
471 'nobd'.
472
473
474 This option defeats the disk volume recognition and BIOS
475 device code detection features of LILO on systems with more
476 than one disk. Thus the use of this option will produce a
477 strong cautionary message, which cannot be
478 suppressed.
479
480
481 __timeout=__''''
482
483
484 sets a timeout (in tenths of a second) for keyboard input at
485 the ''boot:'' prompt.
486 ''
487
488
489 __verbose=__''''
490
491
492 Turns on lots of progress reporting. Higher numbers give
493 more verbose output. If -v is additionally specified on the
494 lilo command line, the level is increased accordingly. The
495 maximum verbosity level is 5.
496
497
498 Additionally, the kernel configuration parameters
499 __append__, __ramdisk__, __read-only__,
500 __read-write__, __root__ and __vga__ can be set in
501 the global options section. They are used as defaults if
502 they aren't specified in the configuration sections of the
503 respective kernel images.
504 !!PER-IMAGE SECTION
505
506
507 A per-image section starts with either a line
508
509
510 __ image=__''
511 ''to indicate a file or device containing the boot image of a Linux kernel, or a line
512
513
514 __ other=__''
515 ''to indicate an arbitrary system to boot.
516
517
518 In the former case, if an __image__ line specifies
519 booting from a device, then one has to indicate the range of
520 sectors to be mapped using
521
522
523 __ range=__''
524 ''__ range=__''
525 ''__ range=__''
526 ''In the third case, 'nsec=1' is assumed.
527 !!KERNEL OPTIONS (image=)
528
529
530 If the booted image is a Linux kernel, then one may pass
531 command line parameters to this kernel.
532
533
534 __append=__''''
535
536
537 Appends the options specified to the parameter line passed
538 to the kernel. This is typically used to specify parameters
539 of hardware that can't be entirely auto-detected or for
540 which probing may be dangerous. Multiple kernel parameters
541 are separated by a blank space, and the string must be
542 enclosed in double quotes. Append may be used only once per
543
544
545 append=
546
547
548 __initrd=__''''
549
550
551 Specifies the initial ramdisk image to be loaded with the
552 kernel. The image will contain modules needed at boot time,
553 such as network and scsi drivers. See man pages for
554 ''mkinitrd(8)''.
555
556
557 __literal=__''''
558
559
560 Like `append', but removes all other options (e.g. setting
561 of the root device). Because vital options can be removed
562 unintentionally with `literal', this option cannot be set in
563 the global options section.
564
565
566 __ramdisk=__''''
567
568
569 This specifies the size (e.g.,
570
571
572 __read-only__
573
574
575 This specifies that the root file system should be mounted
576 read-only. It may be specified as a global option.
577 Typically, the system startup procedure re-mounts the root
578 file system read-write later (e.g. after fsck'ing
579 it).
580
581
582 __read-write__
583
584
585 This specifies that the root file system should be mounted
586 read-write. It may be specified as a global
587 option.
588
589
590 __root=__''''
591
592
593 This specifies the device that should be mounted as root. It
594 may be specified as a global option. If the special name
595 __current__ is used, the root device is set to the device
596 on which the root file system is currently mounted. If the
597 root has been changed with -r , the respective device is
598 used. If the variable `root' is omitted, the root device
599 setting contained in the kernel image is used. (And that is
600 set at compile time using the ROOT_DEV variable in the
601 kernel Makefile, and can later be changed with the rdev(8)
602 program.)
603
604
605 __vga=__''''
606
607
608 This specifies the VGA text mode that should be selected
609 when booting. It may be specified as a global option. The
610 following values are recognized (case is
611 ignored):
612
613
614 __normal__: select normal 80x25 text mode.
615
616
617 __extended__ (or __ext__): select 80x50 text
618 mode.
619
620
621 __ask__: stop and ask for user input (at boot
622 time).
623
624
625 vga=ask'' and pressing
626 [[Enter].
627
628
629 If this variable is omitted, the VGA mode setting contained
630 in the kernel image is used. (And that is set at compile
631 time using the SVGA_MODE variable in the kernel Makefile,
632 and can later be changed with the rdev(8)
633 program.)
634 !!ALTERNATE SYSTEM (other=)
635
636
637 Used to load systems other than Linux. The `other =
638
639
640 __loader=__''''
641
642
643 This specifies the chain loader that should be used. It may
644 also be specified as a global option. By default
645 ''/boot/chain.b'' is used. This chain loader passes
646 partition and drive information in the boot sector it loads
647 only to DOS on FAT12 or FAT16, Windows on FAT16 or FAT32, or
648 OS/2 on FAT16 or HPFS. The alternate chain loader,
649 ''/boot/os2_d.b'' passes partition and drive information
650 unconditionally, and uses a format suitalble for OS/2 and
651 DOS (see ''table='' below).
652
653
654 __table=__''''
655
656
657 This specifies the device that contains the partition table.
658 The boot loader will pass default partition information to
659 the booted operating system if this variable is omitted.
660 (Some operating systems have other means to determine from
661 which partition they have been booted. E.g., MS-DOS usually
662 stores the geometry of the boot disk or partition in its
663 boot sector.) Note that /sbin/lilo must be re-run if a
664 partition table mapped referenced with `table' is
665 modified.
666
667
668 __table=__''''
669
670
671 This is a special case for the ''os2_d.b'' chain loader.
672 It specifies the DOS drive letter for the partition that
673 will be booted. This is ''mandatory'' when booting OS/2
674 installed on an extended partition. The drive letter may be
675 specified with or without a trailing colon.
676
677
678 __change__
679
680
681 This keyword starts a section which describes how primary
682 partition IDs are changed, and how primary partitions are
683 activated and deactivated. If __change__ is omitted,
684 change rules are generated as though the ''automatic''
685 keyword were specified. The keyword __change__ alone,
686 without any rules following, will suppress automatic
687 change-rules. For example,
688
2 LinuxLarry 689 other=/dev/hda2
690 label=dos
691 table=/dev/hda
692 change
693 automatic
694 partition=/dev/hda1
695 set=DOS12_hidden
696 deactivate
697 partition=/dev/hda2
698 set=DOS16_big_normal
699 activate
700
701 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 confict with default change rules, so the ''set='' lines above may be redundant. Also see ''change-rules'' above.
1 perry 702
2 LinuxLarry 703 (A list of ''set='' parameters for common file systems would be very helpful)
1 perry 704
705
706 __map-drive=__''''
707
708
709 Maps BIOS calls for the specified drive to the device code
710 specified on the next line as __to=__
711 __
712
713
714 map-drive=0x80
2 LinuxLarry 715 to=0x81
716 map-drive=0x81
717 to=0x80
1 perry 718
719
720 __unsafe__
721
722
723 Do not access the boot sector at map creation time. This
724 disables some sanity checks, including a partition table
725 check. If the boot sector is on a fixed-format floppy disk
726 device, using UNSAFE avoids the need to put a readable disk
727 into the drive when running the map installer. `unsafe' and
728 `table' are mutually incompatible.
2 LinuxLarry 729 !!COMMON OPTIONS (''either'' image= ''or'' other=)
1 perry 730
731
732 In both the __image=__ and __other=__ cases, the
733 following options apply.
734
735
736 __label=__''''
737
738
739 The boot loader uses the main file name (without its path)
740 of each image specification to identify that image. A
741 different name can be used by setting the variable
742 `label'.
743
744
745 __alias=__''''
746
747
748 A second name for the same entry can be used by specifying
749 an alias.
750
751
752 __lock__
753
754
755 (See above.)
756
757
758 __optional__
759
760
761 Omit the image if it is not available at map creation time.
762 It may be specified as a global option. This is useful to
763 specify test kernels that are not always
764 present.
765
766
767 __password=__''''
768
769
770 Protect the `image=' or `other=' with a password (or
771 passphrase). It may be specified as a global option. The
772 interpretation of the `password=' setting is modified by the
773 words `mandatory', `restricted', and `bypass' (see
774 below).
775 The password may be specified in the config-file (less
776 secure) or entered at the time the boot loader is installed.
777 To request interactive entry of the password, it should be
778 specified: __password=__. Passwords entered
779 interactively are not required to be entered again if the
780 boot installer is re-run. They are cached, in hashed form,
781 in a companion file to the config-file, default name:
782 __/etc/lilo.conf.crc__. If the config-file is updated, a
783 warning message will be issued telling you to re-run ''lilo
784 -p'' to force re-creation of the password cache
785 file.
786
787
788 __mandatory__
789
790
791 A password is required to boot this image. This is the
792 default. May be used on a single `image=' or `other=' to
793 override a different global setting.
794
795
796 __restricted__
797
798
799 A password is only required to boot the image if kernel
800 parameters are specified on the command line (e.g.
801 'single'). May be used on a single `image=' or `other=' to
802 override a different global setting.
803
804
805 __bypass__
806
807
808 No password is required to boot this image. Used to indicate
809 that the global password does not apply to this `image=' or
810 `other='.
811 !!SEE ALSO
812
813
814 lilo(8), mkinitrd(8), mkrescue(8), rdev(8).
815
816
817 The lilo distribution comes with very extensive
818 documentation of which the above is an extract. (lilo
819 22.1)
820 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

PHP Warning

lib/blame.php:177: Warning: Invalid argument supplied for foreach() (...repeated 2 times)