ce1b31a3709ed6506d1f4811924e38afce797642
[rrq/maintain_lilo.git] / man / liloconfig.pod
1 =for header
2 manpage:  LILOCONFIG
3 section:  8
4 title:    liloconfig documentation
5 version:  24.1
6 datum:    2014-10-13
7
8 =encoding utf8
9
10 =head1 NAME
11
12 liloconfig - create new lilo.conf file (with diskid and uuid)
13
14 =head1 SYNOPSIS
15
16 B<liloconfig> [B<-h>] [B<-v>] [B<-f>] [B<-u>] [B<lilo.conf>]
17
18 =head1 DESCRIPTION
19
20 liloconfig is an simple program for creating a new lilo.conf file.
21 After creating the new configuration file you must execute '/sbin/lilo'.
22
23 liloconfig use the lilo.example.conf file as template. In the final
24 lilo.conf file you find many useful comments for custom changes.
25
26 Please pay attention about error messages if liloconfig cannot find
27 any images (/boot/vmlinuz*) oder image symlinks (/vmlinuz, /vmlinu.old).
28 Then you need to search for images by ourself and make some changes
29 in the '/etc/lilo.conf' file. Otherwise no bootloader can be installed
30 with '/sbin/lilo'.
31
32 =head1 OPTIONS
33
34 =over 4
35
36 =item B<-h>
37
38 Print a brief help.
39
40 =item B<-v>
41
42 Print verbose messages.
43
44 =item B<-f>
45
46 Force overriding existing lilo.conf.
47
48 =item B<-u>
49
50 Force overriding/update of boot line in lilo.conf.
51
52 =back
53
54 =head1 EXAMPLES
55
56 Lines in the configuration file /etc/lilo.conf:
57
58   ### LILO global section ###
59
60   #large-memory
61   lba32
62   boot = /dev/sda
63   #root = /dev/sda1
64   root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44"
65   map = /boot/map
66   install = menu
67   menu-scheme = Wb:Yr:Wb:Wb
68   prompt
69   timeout = 100
70   vga = normal
71   #default = Linux
72
73   ### LILO per-image section ###
74
75   #boot = /dev/sda
76   boot = /dev/disk/by-id/ata-SAMSUNG_SV1604N_S01FJ10X999999
77
78   image = /boot/vmlinuz-3.12-trunk-686
79       label = "Linux"
80       #root = /dev/sda1
81       #root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44"
82       read-only
83   #   restricted
84   #   alias = 1
85   #   optional
86       initrd = /boot/initrd.img-3.12-trunk-686
87
88   image = /boot/vmlinuz-3.2.0-4-686
89       label = "Linux Old"
90       #root = /dev/sda1
91       #root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44"
92       read-only
93   #   restricted
94   #   alias = 2
95   #   optional
96       initrd = /boot/initrd.img-3.2.0-4-686
97
98 =head1 COPYRIGHT and LICENSE
99
100 Copyright (C) 2011-2014 Joachim Wiedorn
101
102 This script is free software; you can redistribute it and/or modify
103 it under the terms of the GNU General Public License as published by 
104 the Free Software Foundation; either version 2 of the License, or 
105 (at your option) any later version.
106
107 =head1 AUTHOR
108
109 B<lilconfig> was written by Joachim Wiedorn.
110
111 This manual page was written by Joachim Wiedorn <joodevel at joonet.de>.
112
113 =head1 SEE ALSO
114
115 B<lilo>(8), B<update-lilo>(8), B<lilo-uuid-diskid>(8)
116
117 =cut