Package: live-helper Severity: wishlist Version: 1.0.5-1 Tags: +patch thanks Hi, Please include the provided file (or something like it) containing most of the possible vars as reference to be used with lh_config --conffile option. Each part is documented following live-helper manpage. Thanks in advance. -- Dario Minnucci (midget) <debian@midworld.net> Phone: +34 902021030 | Fax: +34 902024417 | Support: +34 807450000 Key fingerprint = 62FF F60F CE79 9CE4 EBA8 523F FC84 1B2D 82C8 B711
#!/bin/sh
# conffile.template - Provides a configuration template to be used with
# lh_config --conffile option
# Copyright (C) 2009 Dario Minnucci (midget) <debian@midworld.net>
#
# conffile.template comes with ABSOLUTELY NO WARRANTY; for details see COPYING.
# This is free software, and you are welcome to redistribute it
# under certain conditions; see COPYING for details.
###############################################################################
# config/common
###############################################################################
# --apt apt|aptitude
# defines if apt-get or aptitude is used to install packages when building the image. When building etch
# images, this defaults to aptitude. Every other distribution defaults to apt.
LH_APT="apt"
# --apt-ftp-proxy URL
# sets the ftp proxy to be used by apt. By default, this is empty but if the host has the environment variable
# ftp_proxy set, apt-ftp-proxy gets automatically set to the value of ftp_proxy.
#LH_APT_FTP_PROXY="ftp://user:pass@host:port";
# --apt-http-proxy URL
# sets the http proxy to be used by apt. By default, this is empty but if the host has the environment variable
# http_proxy set, apt-http-proxy gets automatically set to the value of http_proxy.
#LH_APT_HTTP_PROXY="http://user:pass@host:port";
# --apt-pdiffs enabled|disabled
# defines whetever apt should use incremental package indices feature or not. This is enabled by default.
LH_APT_PDIFFS="enable"
# --apt-options OPTION|
# defines the default options that will be appended to every apt call that is made inside chroot during the
# building of the image. By default, this is set to --yes to allow non-interactive installation of packages.
APT_OPTIONS="--yes"
# --aptitude-options OPTION|"OPTIONS"
# defines the default options that will be appended to every aptitude call that is made inside chroot during
# building of the image. By default, this is set to --assume-yes to allow non-interactive installation of pack-
# ages.
LH_APTITUDE_OPTIONS="--assume-yes"
# --apt-pipeline FIXME
# FIXME
#LH_APT_PIPELINE=""
# --apt-recommends enabled|disabled
# defines if apt should install recommended packages automatically. By default, this is enable in the debian
# mode and disabled in emdebian mode.
LH_APT_RECOMMENDS="disabled"
# --apt-secure enabled|disabled
# defines if apt should check repository signatures. This is enabled by default.
LH_APT_SECURE="enabled"
# --bootstrap cdebootstrap|cdebootstrap-static|debootstrap|copy
# defines which program is used to bootstrap the debian chroot, default is debootstrap. Note that if you set
# the bootstrap program to copy, then your host system is copied. This can be usefull if you want to con-
# vert/clone your existing host system into a live system, however, make sure you do have enough free space as
# this can, depending on your host system, get quite big.
LH_BOOTSTRAP="debootstrap"
# --cache enabled|disabled
# defines globally if any cache should be used at all. Different caches can be controled through the their own
# options.
LH_CACHE="enabled"
# --cache-indices enabled|disabled
# defines if downloaded package indices and lists should be cached which is disabled by default. Enabling it
# would allow to rebuild an image completely offline, however, you would not get updates anymore then.
LH_CACHE_INDICES="disabled"
# --cache-packages enabled|disabled
# defines if downloaded packages files should be cached which is enabled by default. Disabling it does save
# space consumtion in your build directory, but remember that you will cause much unnecessary traffic if you do
# a couple of rebuilds. In general you should always leave it enabled, however, in some particular rare build
# setups, it can be faster to refetch packages from the local network mirror rather than to utilize the local
# disk.
LH_CACHE_PACKAGES="enabled"
# --cache-stages enabled|disabled|STAGE|"STAGES"
# sets which stages should be cached. By default set to bootstrap. As an exception to the normal stage names,
# also rootfs can be used here which does only cache the generated root filesystem in filesys-
# tem.{dir,ext*,squashfs}. This is usefull during development if you want to rebuild the binary stage but not
# regenerate the root filesystem all the time.
LH_CACHE_STAGES="bootstrap"
# --debconf-frontend dialog|editor|noninteractive|readline
# defines what value the debconf frontend should be set to inside the chroot. Note that setting it to anything
# by noninteractive, which is the default, makes your build asking questions during the build.
LH_DEBCONF_FRONTEND="noninteractive"
# --debconf-nowarnings enabled|disabled
# defines if warnings of debconf should be displayed or not. Warnings from debconf are generally very rare and
# by default, we skipp them, if any, in order to keep the build process entirely non interactive.
LH_DEBCONF_NOWARNINGS="enabled"
# --debconf-priority low|medium|high|critical
# defines what value the debconf priority shoul dbe set to inside the chroot. By default, it is set to criti-
# cal, which means that almost none questions are displayed. Note that this only has an effect if you use any
# debconf frontend different from noninteractive.
LH_DEBCONF_PRIORITY="critical"
# --initramfs auto|live-initramfs|casper
# sets the name of package that contains the live system specific initramfs modification. By default, auto is
# used, which means that at build time of the image rather than on configuration time, the value will be
# expanded to casper when building etch systems and to live-initramfs for all other systems.
LH_INITRAMFS="auto"
# --fdisk fdisk|fdisk.dist
# sets the filename of the fdisk binary from the host system that should be used. This is autodetected and does
# generally not need any customization.
#LH_FDISK=""
# --losetup losetup|losetup.orig
# sets the filename of the losetup binary from the host system that should be used. This is autodetected and
# does generally not need any customization.
#LH_LOSETUP=""
# --mode debian|emdebian
# defines a global mode to load project specific defaults. By default this is set to debian.
LH_MODE="debian"
# --root-command sudo
# controls if live-helper should use sudo internally to build the live image. Note that this is not well tested
# and that you should, when relaying on sudo, call the individual live-helper command with sudo itself.
LH_ROOT_COMMAND="sudo"
# --use-fakeroot enabled|disabled
# FIXME
LH_USE_FAKEROOT="disabled"
# --tasksel aptitude|tasksel
# selects which program is used to install tasks. By default, this is set to tasksel.
LH_TASKSEL="tasksel"
# --includes PATH
# sets the path to the includes that live-helper is going to use, e.g. additional minimal documentation that
# you want to have on all live systems. By default, this is set to /usr/share/live-helper/includes/.
#LH_INCLUDES="/usr/share/live-helper/includes/"
# --templates PATH
# sets the path to the templates that live-helper is going to use, e.g. for bootloaders. By default, this is
# set to /usr/share/live-helper/templates/.
#LH_TEMPLATES="/usr/share/live-helper/templates/"
###############################################################################
# config/bootstrap
###############################################################################
# -a|--architecture ARCHITECTURE
# defines the architecture of the to be build image. By default, this is set to the host architecture. Note
# that you cannot crossbuild for another architecture if your host system is not able to execute binaries for
# the target architecture natively. For example, building amd64 images on i386 and vice versa is possile if you
# have a 64bit capable i386 processor and the right kernel. But building powerpc images on an i386 system is
# not possible.
LH_ARCHITECTURE="i386"
# --bootstrap-config FILE
# sets a custom configuration file for the boostrap programm of choice and is empty by default. Refere to the
# documentation of debootstrap or cdebootstrap for more information about that. When the bootstrap program is
# set to copy, this has no effect.
#LH_BOOTSTRAP_CONFIG=""
# -f|--bootstrap-flavour minimal|standard
# defines if the bootstrap program should bootstrap the standard system (all packages of priority required and
# important, which is the default) or a minimal system (only packages of priority required, plus apt).
#LH_BOOTSTRAP_FLAVOUR="standard"
# --bootstrap-keyring PACKAGE
# sets the archive keyring package to be used. Default is debian-archive-keyring.
#LH_BOOTSTRAP_KEYRING="debian-archive-keyring"
# -d|--distribution CODENAME
# defines the distribution of the resulting live system.
LH_DISTRIBUTION="lenny"
# -m|--mirror-bootstrap URL
# sets the location of the debian package mirror that should be used to bootstrap from.
LH_MIRROR_BOOTSTRAP="http://ftp.us.debian.org/debian/";
# --mirror-chroot URL
# sets the location of the debian package mirror that will be used to fetch the packages in order to build the
# live system. By default, this points to http://ftp.us.debian.org/debian/ which may not be a good default if
# you live outside the U.S.
LH_MIRROR_CHROOT="http://ftp.us.debian.org/debian/";
# --mirror-chroot-security URL
# sets the location of the debian security package mirror that will be used to fetch the packages in order to
# build the live system. By default, this points to http://security.debian.org/debian/.
LH_MIRROR_CHROOT_SECURITY="http://security.debian.org/debian/";
# --mirror-binary URL
# sets the location of the debian package mirror that should end up configured in the final image and which is
# the one a user would see and use. This has not necessarily to be the same that is used to build the image,
# e.g. if you use a local mirror but want to have an official mirror in the image. By default, the same value
# that is used for --mirror-chroot is used here unless specified different.
LH_MIRROR_BINARY="http://ftp.us.debian.org/debian/";
# --mirror-binary-security URL
# sets the location of the debian security package mirror that should end up configuered in the final image. By
# default, the same value that is used for --mirror-chroot-security is used here unless specified different.
LH_MIRROR_BINARY_SECURITY="http://security.debian.org/debian/";
# --categories)
LH_CATEGORIES="main"
###############################################################################
# config/chroot
###############################################################################
# --chroot-filesystem ext2|ext3|squashfs|plain|jffs2
# defines which filesystem type should be used for the root filesystem image. If you use plain, then no
# filesystem image is created and the root filesystem content is copied on the binary image filesystem as flat
# files. Depending on what binary filesystem you have choosen, it may not be possible to build with a plain
# root filesystem, e.g. fat16/fat32 and plain don't work as linux does not support to run on them.
#LH_CHROOT_FILESYSTEM="squashfs"
# --virtual-root-filesystem ext3
# defines what filesystem to format the root filesystem when building virtual-hdd images.
#LH_VIRTUAL_ROOT_FILESYSTEM=""
# --union-filesystem aufs|unionfs
# defines whetever to use UnionFS or Aufs as stackable unification filesystem. When building etch images, this
# defaults to unionfs, everywhere else to aufs.
#LH_UNION_FILESYSTEM="aufs"
# --virtual-root-size MB
# defines what size the virtual-hdd image should be. Note that although the default is set to 10000 (= 10GB),
# it will not need 10GB space on your harddisk as the files are created as sparse files.
#LH_VIRTUAL_ROOT_SIZE="10000"
# --exposed-root enabled|disabled
# FIXME
#LH_EXPOSED_ROOT="disabled"
# --hooks FILE
# defines which hooks available in /usr/share/live-helper/examples/hooks should be activated. Normally, there
# are no hooks executed. Make sure you know and understood the hook before you enable it.
#LH_HOOKS=""
# --interactive shell
# defines if after the chroot stage and before the beginning of the binary stage, a interactive shell login
# should be spawned in the chroot in order to allow you to do manual customizations. Once you close the shell
# with logout or exit, the build will continue as usual. Note that it's strongly discouraged to use this for
# anything else than testing. Modifications that should be present in all builds of a live system should be
# properly made through hooks. Everything else destroys the beauty of being able to completely automatise the
# build process and making it non interactive. By default, this is of course disabled.
#LH_INTERACTIVE="disabled"
# --keyring-packages PACKAGE|
# sets the keyring package or additional keyring packages. By default this is set to debian-archive-keyring.
LH_KEYRING_PACKAGES="debian-archive-keyring"
# -l|--language LANGUAGE
# sets the language of a live system by installing l10n related packages and enables generation of the correct
# locales through automatically setting the right boot parameters. -l|--language)
LH_LANGUAGE="en"
# -k|--linux-flavours FLAVOUR|
# sets the kernel flavours to be installed. Note that in case you specify more than that the first will be con-
# figured the default kernel that gets bootet.
#LH_LINUX_FLAVOURS="486 686"
# --linux-packages
# sets the internal name of the kernel packges naming scheme. If you use debian kernel packges, you will not
# have to adjust it. If you decide to use custom kernel packages that do not follow the debian naming scheme,
# remember to set this option to the stub of the packages only (for debian this is linux-image-2.6), so that
# STUB-FLAVOUR results in a valid package name (for debian e.g. linux-image-2.6-486). Preferably you use the
# meta package name, if any, for the stub, so that your configuration is ABI independent. Also don't forget
# that you have to include stubs of the binary modules packages for unionfs or aufs, and squashfs if you built
# them out-of-tree.
#LH_LINUX_PACKAGES="linux-image-2.6 ${LH_UNION_FILESYSTEM}-modules-2.6 squashfs-modules-2.6"
# --packages PACKAGE|"PACKAGES"
# defines one or more packages to be installed in the live system. This is a quick and convenient place to add
# a few packages when building an image (limited by the max length of shell). Packages that should be perma-
# nently installed should be put into a local packages list.
LH_PACKAGES=""
# -p|--packages-lists FILE
# defines which lists available in /usr/share/live-helper/lists should be used. By default, this is set to
# standard. Note that in case you have local packages lists, you also need to list them here. Putting them into
# config/chroot_local-packageslists is not enough.
#LH_PACKAGES_LISTS="standard"
# --tasks TASK
# defines one or more package tasks to be installed in the live system. This is a quick and convenient way to
# get a reasonable default selection of packages suitable for most users when building an image, but it results
# in quite big images. If you want to have finer grained package selections, local packages lists should be
# used instead.
#LH_TASKS=""
# --security enabled|disabled
# defines if the security repositories specified in the security mirror options should be used or not.
#LH_SECURITY="enabled"
# --symlinks enabled|disabled
# defines if the symlink hack should be enabled or disabled. The symlink hack converts all absolute symlinks to
# relative ones. By default this is disabled and in general there is no need or gain to enable it. If you are
# in a special situation that requires this, you will know.
#LH_SYMLINKS="disabled"
# --sysvinit enabled|disabled
# defines it the sysvinit hack should be enabled or disabled. The sysvinit hack disables all non-essential ser-
# vices from starting up at bootup in order to reduce overall boottime. By default this is disabled and in gen-
# eral there you don't want to enable it.
#LH_SYSVINIT="disabled"
###############################################################################
# config/binary
###############################################################################
# --binary-filesystem fat16|fat32|ext2
# defines the filesystem to be used in the image type. This only has an effect if the selected binary image
# type does allow to choose a filesystem. For example, when selection iso the resulting CD/DVD has always the
# filesystem ISO9660. When building usb-hdd images for usb sticks, this is active. Note that it defaults to
# fat16 on all architectures except sparc where it defaults to ext2. Also note that if you choose fat16 and
# your resulting binary image gets bigger than 2GB, the binary filesystem automatically gets switched to fat32.
LH_BINARY_FILESYSTEM="fat16"
# -b|--binary-images iso|net|tar|usb-hdd
# defines the image type to build. By default this is set to iso to build CD/DVD images.
LH_BINARY_IMAGES="iso"
# --binary-indices enabled|disabled|none
# defines if the resulting images should have binary indices or not and defaults to enabled. If set to none, no
# indices are included at all.
LH_BINARY_INDICES="enabled"
# --bootappend-live PARAMETER|"PARAMETERS"
# sets boot parameters specific to debian-live. A complete list of boot parameters can be found, for etch, in
# the manpage of casper, for all other distributions in the manpage of live-initramfs. On the images, a list of
# all parameters (without comments) is included in the /parameters.txt.
#LH_BOOTAPPEND_LIVE=""
# --bootappend-install PARAMETER|"PARAMETERS"
# sets boot parameters specific to debian-installer, if included.
#LH_BOOTAPPEND_INSTALL=""
# --bootloader grub|syslinux|yaboot
# defines which bootloader is beeing used in the generated image. This has only an effect if the selected
# binary image type does allow to choose the bootloader. For example, if you build a iso, always syslinux (or
# more precise, isolinux) is being used. Also note that some combinations of binary images types and bootload-
# ers may be possible but live-helper does not support them yet. lh_config will fail to create such a not yet
# supported configuration and give a explanation about it. For usb-hdd images on amd64 and i386, the default is
# syslinux. yaboot is only used on powerpc.
LH_BOOTLOADER="syslinux"
# --checksums enabled|disabled
# defines if the binary image should contain a file called md5sums.txt that lists all files on the image
# together with their md5 checksums. This in turn can be used by live-initramfs' built-in integrity-check to
# verify the medium if specified at boot prompt. In general, this should not be disabled and is an important
# feature of live system released to the public. However, during development of very big images it can save
# some time by not calculating the checksums.
LH_CHECKSUMS="enabled"
# --chroot-build enabled|disabled
# defines whetever live-helper should use the tools from within the chroot to build the binary image or not by
# using and including the host systems tools. This is a very dangerous option, using the tools of the host sys-
# tem can lead to tainted and even non-bootable images if the host systems version of the required tools
# (mainly these are the bootloaders such as syslinux, grub and yaboot, and the auxilliary tools such as dosfs-
# tools, genisoimage, squashfs-tools and others) do not exactely match what is present at build-time in the
# target distribution. Never do disable this option unless you are exactely sure what you are doing and have
# completely understood its consequences.
LH_CHROOT_BUILD="enabled"
# --debian-installer enabled|cdrom|netinst|netboot|businesscard|live|disabled
# defines which type, if any, of the debian-installer should be included in the resulting binary image. By
# default, no installer is included. All available flavours except live are the identical configurations used
# on the installer media produced by regular debian-cd. When live is choosen, the live-installer udeb is
# included so that debian-installer will behave different than usual - instead of installing the debian system
# from packages from the medium or the network, it installs the live system to the disk.
LH_DEBIAN_INSTALLER="enabled"
# --debian-installer-distribution daily|CODENAME
# defines the distribution where the debian-installer files should be taken out from. Normally, this should be
# set to the same distribution as the live system. However, some times, one wants to use a newer or even daily
# built installer.
LH_DEBIAN_INSTALLER_DISTRIBUTION="daily"
# --debian-installer-preseedfile FILE|URL
# sets the filename or URL for an optionally used and included preseeding file for debian-installer.
#LH_DEBIAN_INSTALLER_PRESEEDFILE=""
# -e|--encryption disabled|aes128|aes192|aes256
# defines if the root filesystem should be encrypted or not. By default, this is disabled.
LH_ENCRYPTION="disabled"
# --grub-splash FILE
# defines the name of an optional to be included splash screen graphic for the grub bootloader.
#LH_GRUB_SPLASH=""
# --hostname NAME
# sets the hostname of the live system.
LH_HOSTNAME="debian-live"
# --iso-application NAME
# sets the APPLICATION field in the header of a resulting CD/DVD image and defaults to "Debian Live" in debian
# mode, and to "Emdebian Live" in emdebian mode.
LH_ISO_APPLICATION="Debian Live"
# --iso-preparer NAME
# sets the PREPARER field in the header of a resulting CD/DVD image. By default this is set to "live-helper
# VERSION; http://packages.qa.debian.org/live-helper";, whereas VERSION is exanded to the version of live-helper
# that was used to build the image.
LH_ISO_PREPARER="live-helper"
# --iso-publisher NAME
# sets the PUBLISHED field in the header of a resulting CD/DVD image. By default, this is set to 'Debian Live
# project; http://debian-live.alioth.debian.org/; debian-live@lists.debian.org'. Remember to change this to the
# appropriate values at latest when you distributing custom and unofficial images.
LH_ISO_PUBLISHER="Debian Live project; http://debian-live.alioth.debian.org/; debian-live@lists.debian.org"
# --iso-volume NAME
# sets the VOLUME field in the header of a resulting CD/DVD and defaults to 'Debian Live (DATE)' in debian
# mode, and 'Emdebian Live (DATE)' in emdebian mode, whereas DATE is expanded with the current date and time of
# the generation.
LH_ISO_VOLUME="Debian Live `date +%Y%m%d%T`"
# --jffs2-eraseblock SIZE
# FIXME
#LH_JFFS2_ERASEBLOCK=""
# --memtest memtest86+|memtest86|none
# defines if memtest, memtest86+ or no memory tester at all should be included as secondary bootloader configu-
# ration. This is only available on amd64 and i386 and defaults to memtest86+.
LH_MEMTEST="memtest86+"
# --net-root-filesystem nfs|cfs
# defines the filesystem that will be configured in the bootloader configuration for your netboot image. This
# defaults to nfs.
#LH_NET_ROOT_FILESYSTEM="nfs"
# --net-root-mountoptions OPTIONS
# sets additional options for mounting the root filesystem in netboot images and is by default empty.
#LH_NET_ROOT_MOUNTOPTIONS=""
# --net-root-path PATH
# sets the file path that will be configured in the bootloader configuration for your netboot image. This
# defaults to /srv/debian-live in debian mode and to /srv/emebian-live when being in emdebian mode.
#LH_NET_ROOT_PATH="/srv/debian-live"
# --net-root-server IP|HOSTNAME
# sets the IP or hostname that will be configured in the bootloader configuration for the root filesystem of
# your netboot image. This defaults to 192.168.1.1.
#LH_NET_ROOT_SERVER="192.168.1.1"
# --net-cow-filesystem nfs|cfs
# defines the filesystem type for the copy-on-write layer and defaults to nfs.
#LH_NET_COW_FILESYSTEM="nfs"
# --net-cow-mountoptions OPTIONS
# sets additional options for mounting the copy-on-write layer in netboot images and is by default empty.
#LH_NET_COW_MOUNTOPTIONS=""
# --net-cow-path PATH
# defines the path to client writable filesystem. Anywhere that client_mac_address is specified in the path
# live-initramfs will substitute the MAC address of the client delimited with hyphens.
# Example:
# /export/hosts/client_mac_address
# /export/hosts/00-16-D3-33-92-E8
#LH_NET_COW_PATH=""
# --net-cow-server IP|HOSTNAME
# sets the IP or hostname that will be configured in the bootloader configuration for the copy-on-write
# filesystem of your netboot image and is by default empty.
#LH_NET_COW_SERVER=""
# --net-tarball bzip2|gzip|tar|none
# defines the format of the netboot image. Choosing tar results in a not compressed tarball, bzip2 and gzip in
# a bzip2 resp. gzip compressed tarball. Choosing none leads to no tarball at all, the plain binary directory
# is considered the output in this case. Default is gzip.
#LH_NET_TARBALL="gzip"
# --syslinux-splash FILE
# defines the file of the syslinux splash graphic that should be used instead of the default one.
#LH_SYSLINUX_SPLASH=""
# --syslinux-timeout SECONDS
# defines the timeout the syslinux bootloader should wait for input from the user at the bootprompt prior boot-
# ing the default kernel. This defaults to 0 which means it will wait forever.
LH_SYSLINUX_TIMEOUT="0"
# --syslinux-menu enabled|disabled
# defines if syslinux should be make use of the vgamenu capabilities or not.
#LH_SYSLINUX_MENU="enabled"
# --username NAME
# sets the name of the account of the default user in the live system.
LH_USERNAME="user"
# --win32-loader enabled|disabled
# defines if win32-loader should be included in the binary image or not.
#LH_WIN32_LOADER=""
###############################################################################
# config/source
###############################################################################
# --source enabled|disabled
# defines if a corresponding source image to the binary image should be build. By default this is disabled
# because most people do not require this and would require to download quite a few source packages. However,
# once you start distributing your live image, you should make sure you build it with a source image alongside.
#LH_SOURCE="disabled"
# -s|--source-images iso|net|tar|usb-hdd
# defines the image type for the source image. Default is tar.
LH_SOURCE_IMAGES="tar"
###############################################################################
# other
###############################################################################
# --breakpoints) enabled|disabled
#_BREAKPOINTS="enabled"
# --color) enabled|disabled
_COLOR="enabled"
# --debug) enabled|disabled
_DEBUG="enabled"
# --force) enabled|disabled
#_FORCE="disabled"
# --ignore-system-defaults)
# --quiet)
#_QUIET="enabled"
# --verbose)
_VERBOSE="enabled"
Attachment:
signature.asc
Description: OpenPGP digital signature