Add new manpage for new liloconfig
[rrq/maintain_lilo.git] / debian / manpages / liloconfig.pod
1 =for header
2 manpage:  LILOCONFIG
3 section:  8
4 title:    liloconfig documentation
5 version:  23.1
6 datum:    2011-03-20
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<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 =head1 OPTIONS
27
28 =over 4
29
30 =item B<-h>
31
32 Print a brief help.
33
34 =item B<-v>
35
36 Print verbose messages.
37
38 =item B<-f>
39
40 Force overriding existing lilo.conf.
41
42 =back
43
44 =head1 EXAMPLES
45
46 Lines in the configuration file /etc/lilo.conf:
47
48   ### LILO global section ###
49
50   #large-memory
51   lba32
52   boot = /dev/sda
53   map = /boot/map
54   install = menu
55   menu-scheme = Wb:Yr:Wb:Wb
56   prompt
57   timeout = 100
58   vga = normal
59   #default = Linux
60
61   ### LILO per-image section ###
62
63   #boot = /dev/sda
64   boot = /dev/disk/by-id/ata-SAMSUNG_SV1604N_S01FJ10X999999
65
66   image = /boot/vmlinuz-2.6.32-5book-686
67       label = "Linux"
68       #root = /dev/sda1
69       root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44"
70       read-only
71   #   restricted
72   #   alias = 1
73   #   optional
74       initrd = /boot/initrd.img-2.6.32-5book-686
75
76   image = /boot/vmlinuz-2.6.32-5-686
77       label = "Linux Old"
78       #root = /dev/sda1
79       root = "UUID=18843936-00f9-4df0-a373-000d05a5dd44"
80       read-only
81   #   restricted
82   #   alias = 2
83   #   optional
84       initrd = /boot/initrd.img-2.6.32-5-686
85
86 =head1 COPYRIGHT and LICENSE
87
88 Copyright (C) 2011 Joachim Wiedorn
89
90 This script is free software; you can redistribute it and/or modify
91 it under the terms of the GNU General Public License as published by 
92 the Free Software Foundation; either version 2 of the License, or 
93 (at your option) any later version.
94
95 On Debian systems, the complete text of the GNU General Public
96 License version 2 can be found in `/usr/share/common-licenses/GPL-2'.
97
98 =head1 AUTHOR
99
100 B<lilconfig> was written by Joachim Wiedorn.
101
102 This manual page was written by Joachim Wiedorn <ad_debian at joonet.de>
103 for the Debian project (and may be used by others).
104
105 =head1 SEE ALSO
106
107 B<lilo>(8), B<update-lilo>(8), B<lilo-uuid-diskid>(8)
108
109 =cut