trusty (8) extlinux-update.8.gz

NAME

       extlinux-update - program to generate EXTLINUX's configuration files

SYNOPSIS

       extlinux-update

DESCRIPTION

       extlinux-update  is  a  tool  used  to  generate the configuration files used by the EXTLINUX bootloader.
       Options can be configured in /etc/default/extlinux.

OPTIONS

       EXTLINUX_UPDATE="true|false"
           This variable  specifies  if  extlinux-update  is  allowed  to  modify  the  configuration  files  in
           /boot/extlinux. Values are either 'true' or 'false', default is 'true'.

       EXTLINUX_ALTERNATIVES="default recovery"
           This   variable  specifies  which  entries  extlinux-update  is  populating.  Values  are  'default',
           'recovery', 'live', default is 'default recovery'.

       EXTLINUX_DEFAULT="l0"
           This variable specifies the default entry to boot. The name of an entry  consists  of  two  or  three
           characters.  Linux kernel images start with the letter 'l', followed by an integer started by '0' for
           the first kernel version (which is numerically the highest one in case kernel images of more than one
           linux  version are installed) and, optionally, the mode (r for rescue mode, l for live mode). Memdisk
           entries start with the letter 'm', followed by an integer, no optional modes available.  The  default
           is 'l0'.

       EXTLINUX_ENTRIES="all"
           This  variables specifies how many kernel versions should be used to populate the boot configuration.
           Value is an integer starting with 1, or 'all' to populate for all kernels, default is 'all'.

       EXTLINUX_MEMDISK="true|false"
           This variable specifies if ISO (*.iso) and HDD  (*.img)  images  should  be  added  to  the  EXTLINUX
           configuration so that they can be booted through memdisk, default is 'true'.

       EXTLINUX_MEMDISK_DIRECTORY="/boot|DIRECTORY"
           This  variable specifies where to look for images to be added to the EXTLINUXs memdisk configuration,
           default is '/boot'.

       EXTLINUX_OS_PROBER="true|false"
           This variable specifies if other operating systems detected by  os-prober  should  be  added  to  the
           EXTLINUX configuration so that they can be booted via chainloading, default is 'true'.

       EXTLINUX_MENU_LABEL="Debian GNU/Linux, kernel"
           This  variable  specifies  the  text  that  is  used  as  a description in the boot menu. Value is an
           arbitrary string. If lsb_release is installed, the distributors id is  automatically  determined.  If
           lsb_release is not available, it defaults to 'Debian GNU/Linux, kernel'.

       EXTLINUX_PARAMETERS="ro quiet"
           This  variable  specifies additional boot parameters that are appended to each kernel entry. Value is
           an arbitrary string, default is 'ro quiet' (except for recovery entries, where quiet is avoided).

       EXTLINUX_ROOT="root=DEVICE"
           This variable specifies the root partition. It is automatically extracted from  /etc/fstab.  EXTLINUX
           supports both devices and UUIDs.

       EXTLINUX_THEME="debian"
           This  variable specifies the theme that should be used, e.g. to display a graphical boot menu. Values
           are either the name of an EXTLINUX theme installed in /usr/share/syslinux/themes, or the full path to
           the  theme.  If  no  theme should be used, the value 'none' can be used. If no theme is specified and
           themes are not disabled through 'none', and if /usr/share/syslinux/themes/debian is  available,  then
           it  defaults to that, otherwise the default is empty and no theme is used. For more information about
           how to install the themes package, see /usr/share/doc/extlinux/README.Debian.

       EXTLINUX_TIMEOUT="50" 4
           This variable specifies the time that EXTLINUX should wait for user input during boot. Values are  in
           decisecond  greater  than  0  (e.g.  '10'  for  a 1 second timeout), 0 specifies to wait forever. The
           default is 50.

FILES

       /etc/default/extlinux

HOMEPAGE

       More information about EXTLINUX and the syslinux project can be found at <http://syslinux.zytor.com/>.

AUTHOR

       EXTLINUX was written by  H. Peter Anvin <hpa@zytor.com>.

       extlinux-update and this manual page was written by Daniel Baumann <mail@daniel-baumann.ch>fR>.