Update all patches
[rrq/maintain_lilo.git] / debian / manpages / liloconfig.8
index 731aba92ad6b929ff1d47fd9728f787de0b2ecba..5ccceb72f913187018ed858053c578329952d3f6 100644 (file)
-'\" t
-.\" This page is not actually based on the original LILO docs,
-.\" but I'm using the same COPYING conditions:
+.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
 .\"
-.\" This manual page is:
-.\"  Copyright 1999 Peter Maydell <pmaydell@chiark.greenend.org.uk>
-.\" All rights reserved.
+.\" Standard preamble:
+.\" ========================================================================
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Vb \" Begin verbatim text
+.ft CW
+.nf
+.ne \\$1
+..
+.de Ve \" End verbatim text
+.ft R
+.fi
+..
+.\" Set up some character translations and predefined strings.  \*(-- will
+.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
+.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
+.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
+.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
+.\" nothing in troff, for use with C<>.
+.tr \(*W-
+.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
+.ie n \{\
+.    ds -- \(*W-
+.    ds PI pi
+.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
+.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
+.    ds L" ""
+.    ds R" ""
+.    ds C` ""
+.    ds C' ""
+'br\}
+.el\{\
+.    ds -- \|\(em\|
+.    ds PI \(*p
+.    ds L" ``
+.    ds R" ''
+'br\}
 .\"
-.\" Redistribution and use in source and binary forms of parts of or the
-.\" whole original or derived work are permitted provided that the
-.\" original work is properly attributed to the author. The name of the
-.\" author may not be used to endorse or promote products derived from
-.\" this software without specific prior written permission. This work
-.\" is provided "as is" and without any express or implied warranties.
+.\" Escape single quotes in literal strings from groff's Unicode transform.
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
 .\"
-.TH LILOCONFIG 8 "September 1999"
-.SH NAME
-liloconfig \- interactive configure script for lilo
-.SH SYNOPSIS
-.B liloconfig
-.SH DESCRIPTION
-.LP
-.B liloconfig
-is an interactive program which will ask you a series of questions
-and write a
-.B lilo.conf(5)
-configuration file for you. It will also set up the Master Boot Record
-(MBR) so that Linux will boot from hard disk.
-It is normally run automatically whenever you upgrade the
-.B lilo(8)
-Debian package.
-
-The configuration file generated by
-.B liloconfig
-is intended for common installations; if your setup is complicated
-or unusual you should consider writing your own customised
-.B lilo.conf.
-To do this you should refer to the comprehensive
-.B lilo
-documentation, which can be found in
-/usr/share/doc/lilo/ on Debian systems.
-
-If you have already written your own
-.B lilo.conf
-then the script will ask you if you wish to keep it, in which case
-it will check it for options which are incompatible with the current
-version of
-.B lilo
-and run
-.B lilo
-to install the boot block.
-
-If you have no
-.B lilo.conf
-or choose to overwrite it,
-.B liloconfig
-will perform three operations to ensure that the Linux system will
-boot from the hard disk:
-install LILO in the Linux partition's boot record, install a
-simple MBR, and mark the Linux partition as the active partition.
-You will be prompted prior to each of these operations, so you
-can skip them and perform them manually later on.
-
-The automatically generated
-.B lilo.conf
-contains helpful comments, so it might well be a good place to start
-even if you wish to roll your own configuration file.
-
-.SH AUTHOR
-Bruce Perens <bruce@Pixar.com>,
-.br
-Bernd Eckenfels <ecki@debian.org>
-.br
-and Vincent Renardias <vincent@ldsol.com>.
-
-Peter Maydell (pmaydell@chiark.greenend.org.uk) wrote this manual page.
-.SH SEE ALSO
-.BR lilo (8),
-.BR lilo.conf (5)
-
-.B lilo
-comes with extensive documentation; this can be found in
-/usr/share/doc/lilo/ on Debian systems.
+.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
+.\" entries marked with X<> in POD.  Of course, you'll have to process the
+.\" output yourself in some meaningful fashion.
+.ie \nF \{\
+.    de IX
+.    tm Index:\\$1\t\\n%\t"\\$2"
+..
+.    nr % 0
+.    rr F
+.\}
+.el \{\
+.    de IX
+..
+.\}
+.\" ========================================================================
+.\"
+.IX Title "LILOCONFIG 8"
+.TH LILOCONFIG 8 "2011-03-20" "23.1" "liloconfig documentation"
+.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
+.\" way too many mistakes in technical documents.
+.if n .ad l
+.nh
+.SH "NAME"
+liloconfig \- create new lilo.conf file (with diskid and uuid)
+.SH "SYNOPSIS"
+.IX Header "SYNOPSIS"
+\&\fBliloconfig\fR [\fB\-h\fR] [\fB\-v\fR] [\fB\-f\fR] [\fBlilo.conf\fR]
+.SH "DESCRIPTION"
+.IX Header "DESCRIPTION"
+liloconfig is an simple program for creating a new lilo.conf file.
+After creating the new configuration file you must execute '/sbin/lilo'.
+.PP
+liloconfig use the lilo.example.conf file as template. In the final
+lilo.conf file you find many useful comments for custom changes.
+.SH "OPTIONS"
+.IX Header "OPTIONS"
+.IP "\fB\-h\fR" 4
+.IX Item "-h"
+Print a brief help.
+.IP "\fB\-v\fR" 4
+.IX Item "-v"
+Print verbose messages.
+.IP "\fB\-f\fR" 4
+.IX Item "-f"
+Force overriding existing lilo.conf.
+.SH "EXAMPLES"
+.IX Header "EXAMPLES"
+Lines in the configuration file /etc/lilo.conf:
+.PP
+.Vb 1
+\&  ### LILO global section ###
+\&
+\&  #large\-memory
+\&  lba32
+\&  boot = /dev/sda
+\&  map = /boot/map
+\&  install = menu
+\&  menu\-scheme = Wb:Yr:Wb:Wb
+\&  prompt
+\&  timeout = 100
+\&  vga = normal
+\&  #default = Linux
+\&
+\&  ### LILO per\-image section ###
+\&
+\&  #boot = /dev/sda
+\&  boot = /dev/disk/by\-id/ata\-SAMSUNG_SV1604N_S01FJ10X999999
+\&
+\&  image = /boot/vmlinuz\-2.6.32\-5book\-686
+\&      label = "Linux"
+\&      #root = /dev/sda1
+\&      root = "UUID=18843936\-00f9\-4df0\-a373\-000d05a5dd44"
+\&      read\-only
+\&  #   restricted
+\&  #   alias = 1
+\&  #   optional
+\&      initrd = /boot/initrd.img\-2.6.32\-5book\-686
+\&
+\&  image = /boot/vmlinuz\-2.6.32\-5\-686
+\&      label = "Linux Old"
+\&      #root = /dev/sda1
+\&      root = "UUID=18843936\-00f9\-4df0\-a373\-000d05a5dd44"
+\&      read\-only
+\&  #   restricted
+\&  #   alias = 2
+\&  #   optional
+\&      initrd = /boot/initrd.img\-2.6.32\-5\-686
+.Ve
+.SH "COPYRIGHT and LICENSE"
+.IX Header "COPYRIGHT and LICENSE"
+Copyright (C) 2011 Joachim Wiedorn
+.PP
+This script is free software; you can redistribute it and/or modify
+it under the terms of the \s-1GNU\s0 General Public License as published by 
+the Free Software Foundation; either version 2 of the License, or 
+(at your option) any later version.
+.PP
+On Debian systems, the complete text of the \s-1GNU\s0 General Public
+License version 2 can be found in `/usr/share/common\-licenses/GPL\-2'.
+.SH "AUTHOR"
+.IX Header "AUTHOR"
+\&\fBlilconfig\fR was written by Joachim Wiedorn.
+.PP
+This manual page was written by Joachim Wiedorn <ad_debian at joonet.de>
+for the Debian project (and may be used by others).
+.SH "SEE ALSO"
+.IX Header "SEE ALSO"
+\&\fBlilo\fR(8), \fBupdate-lilo\fR(8), \fBlilo-uuid-diskid\fR(8)