Add externs to avoid multiple definitions, and then add missing definitions.
[rrq/maintain_lilo.git] / man / liloconfig.pod
1 =for header
2 manpage:  LILOCONFIG
3 section:  8
4 title:    liloconfig documentation
5 version:  24.2
6 datum:    2015-11-22
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   boot = /dev/disk/by-id/ata-SAMSUNG_SV1604N_S01FJ10X999999
64   #root = /dev/sda1
65   root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44"
66   map = /boot/map
67   install = menu
68   menu-scheme = Wb:Yr:Wb:Wb
69   prompt
70   timeout = 100
71   vga = normal
72   #password = 
73   #default = Linux
74
75   ### LILO per-image section ###
76
77   image = /boot/vmlinuz-3.17-trunk-686
78       label = "Linux"
79       #root = /dev/sda1
80       #root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44"
81       read-only
82   #   restricted
83   #   alias = 1
84   #   optional
85       initrd = /boot/initrd.img-3.17-trunk-686
86
87   image = /boot/vmlinuz-3.14-trunk-686
88       label = "Linux Old"
89       #root = /dev/sda1
90       #root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44"
91       read-only
92   #   restricted
93   #   alias = 2
94   #   optional
95       initrd = /boot/initrd.img-3.14-trunk-686
96
97 =head1 COPYRIGHT and LICENSE
98
99 Copyright (C) 2011-2015 Joachim Wiedorn
100
101 This script is free software; you can redistribute it and/or modify
102 it under the terms of the GNU General Public License as published by 
103 the Free Software Foundation; either version 2 of the License, or 
104 (at your option) any later version.
105
106 =head1 AUTHOR
107
108 B<liloconfig> was written by Joachim Wiedorn.
109
110 This manual page was written by Joachim Wiedorn <joodevel at joonet.de>.
111
112 =head1 SEE ALSO
113
114 B<lilo>(8), B<update-lilo>(8), B<lilo-uuid-diskid>(8)
115
116 =cut