New upstream release with many bugfixes
[rrq/maintain_lilo.git] / man / liloconfig.8
1 .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings.  \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 .    ds -- \(*W-
28 .    ds PI pi
29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
31 .    ds L" ""
32 .    ds R" ""
33 .    ds C` ""
34 .    ds C' ""
35 'br\}
36 .el\{\
37 .    ds -- \|\(em\|
38 .    ds PI \(*p
39 .    ds L" ``
40 .    ds R" ''
41 'br\}
42 .\"
43 .\" Escape single quotes in literal strings from groff's Unicode transform.
44 .ie \n(.g .ds Aq \(aq
45 .el       .ds Aq '
46 .\"
47 .\" If the F register is turned on, we'll generate index entries on stderr for
48 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
49 .\" entries marked with X<> in POD.  Of course, you'll have to process the
50 .\" output yourself in some meaningful fashion.
51 .ie \nF \{\
52 .    de IX
53 .    tm Index:\\$1\t\\n%\t"\\$2"
54 ..
55 .    nr % 0
56 .    rr F
57 .\}
58 .el \{\
59 .    de IX
60 ..
61 .\}
62 .\" ========================================================================
63 .\"
64 .IX Title "LILOCONFIG 8"
65 .TH LILOCONFIG 8 "2014-10-13" "24.1" "liloconfig documentation"
66 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
67 .\" way too many mistakes in technical documents.
68 .if n .ad l
69 .nh
70 .SH "NAME"
71 liloconfig \- create new lilo.conf file (with diskid and uuid)
72 .SH "SYNOPSIS"
73 .IX Header "SYNOPSIS"
74 \&\fBliloconfig\fR [\fB\-h\fR] [\fB\-v\fR] [\fB\-f\fR] [\fB\-u\fR] [\fBlilo.conf\fR]
75 .SH "DESCRIPTION"
76 .IX Header "DESCRIPTION"
77 liloconfig is an simple program for creating a new lilo.conf file.
78 After creating the new configuration file you must execute '/sbin/lilo'.
79 .PP
80 liloconfig use the lilo.example.conf file as template. In the final
81 lilo.conf file you find many useful comments for custom changes.
82 .PP
83 Please pay attention about error messages if liloconfig cannot find
84 any images (/boot/vmlinuz*) oder image symlinks (/vmlinuz, /vmlinu.old).
85 Then you need to search for images by ourself and make some changes
86 in the '/etc/lilo.conf' file. Otherwise no bootloader can be installed
87 with '/sbin/lilo'.
88 .SH "OPTIONS"
89 .IX Header "OPTIONS"
90 .IP "\fB\-h\fR" 4
91 .IX Item "-h"
92 Print a brief help.
93 .IP "\fB\-v\fR" 4
94 .IX Item "-v"
95 Print verbose messages.
96 .IP "\fB\-f\fR" 4
97 .IX Item "-f"
98 Force overriding existing lilo.conf.
99 .IP "\fB\-u\fR" 4
100 .IX Item "-u"
101 Force overriding/update of boot line in lilo.conf.
102 .SH "EXAMPLES"
103 .IX Header "EXAMPLES"
104 Lines in the configuration file /etc/lilo.conf:
105 .PP
106 .Vb 1
107 \&  ### LILO global section ###
108 \&
109 \&  #large\-memory
110 \&  lba32
111 \&  boot = /dev/sda
112 \&  #root = /dev/sda1
113 \&  root = "UUID=18843936\-00f9\-4df0\-a373\-000d05a5dd44"
114 \&  map = /boot/map
115 \&  install = menu
116 \&  menu\-scheme = Wb:Yr:Wb:Wb
117 \&  prompt
118 \&  timeout = 100
119 \&  vga = normal
120 \&  #default = Linux
121 \&
122 \&  ### LILO per\-image section ###
123 \&
124 \&  #boot = /dev/sda
125 \&  boot = /dev/disk/by\-id/ata\-SAMSUNG_SV1604N_S01FJ10X999999
126 \&
127 \&  image = /boot/vmlinuz\-3.12\-trunk\-686
128 \&      label = "Linux"
129 \&      #root = /dev/sda1
130 \&      #root = "UUID=18843936\-00f9\-4df0\-a373\-000d05a5dd44"
131 \&      read\-only
132 \&  #   restricted
133 \&  #   alias = 1
134 \&  #   optional
135 \&      initrd = /boot/initrd.img\-3.12\-trunk\-686
136 \&
137 \&  image = /boot/vmlinuz\-3.2.0\-4\-686
138 \&      label = "Linux Old"
139 \&      #root = /dev/sda1
140 \&      #root = "UUID=18843936\-00f9\-4df0\-a373\-000d05a5dd44"
141 \&      read\-only
142 \&  #   restricted
143 \&  #   alias = 2
144 \&  #   optional
145 \&      initrd = /boot/initrd.img\-3.2.0\-4\-686
146 .Ve
147 .SH "COPYRIGHT and LICENSE"
148 .IX Header "COPYRIGHT and LICENSE"
149 Copyright (C) 2011\-2014 Joachim Wiedorn
150 .PP
151 This script is free software; you can redistribute it and/or modify
152 it under the terms of the \s-1GNU\s0 General Public License as published by 
153 the Free Software Foundation; either version 2 of the License, or 
154 (at your option) any later version.
155 .SH "AUTHOR"
156 .IX Header "AUTHOR"
157 \&\fBlilconfig\fR was written by Joachim Wiedorn.
158 .PP
159 This manual page was written by Joachim Wiedorn <joodevel at joonet.de>.
160 .SH "SEE ALSO"
161 .IX Header "SEE ALSO"
162 \&\fBlilo\fR(8), \fBupdate-lilo\fR(8), \fBlilo-uuid-diskid\fR(8)