Provided by: live-build_3.0~a57-1ubuntu25.6_all 
NAME
lb config - Create config directory
SYNOPSIS
lb config [live-build options]
lb config
[--apt apt|aptitude]
[--apt-ftp-proxy URL]
[--apt-http-proxy URL]
[--apt-indices true|false|none]
[--apt-options OPTION|"OPTIONS"]
[--aptitude-options OPTION|"OPTIONS"]
[--apt-pipeline DEPTH]
[--apt-recommends true|false]
[--apt-secure true|false]
[--apt-source-archives true|false]
[-a|--architectures ARCHITECTURE]
[-b|--binary-images iso|iso-hybrid|netboot|tar|hdd|virtual-hdd]
[--binary-filesystem fat16|fat32|ext2|ext3|ext4]
[--bootappend-install PARAMETER|"PARAMETERS"]
[--bootappend-live PARAMETER|"PARAMETERS"]
[--bootloader grub|syslinux|yaboot]
[--bootstrap cdebootstrap|cdebootstrap-static|debootstrap|copy]
[-f|--bootstrap-flavour minimal|standard]
[--bootstrap-keyring PACKAGE]
[--cache true|false]
[--cache-indices true|false]
[--cache-packages true|false]
[--cache-stages STAGE|"STAGES"]
[--checksums md5|sha1|sha256|none]
[--compression bzip2|gzip|lzip|none]
[--config GIT_URL::GIT_ID]
[--build-with-chroot true|false]
[--chroot-filesystem ext2|ext3|ext4|squashfs|jffs2|none]
[--clean]
[-c|--conffile FILE]
[--debconf-frontend dialog|editor|noninteractive|readline]
[--debconf-nowarnings true|false]
[--debconf-priority low|medium|high|critical]
[--debian-installer true|cdrom|netinst|netboot|businesscard|live|false]
[--debian-installer-distribution daily|CODENAME]
[--debian-installer-preseedfile FILE|URL]
[--debian-installer-gui true|false]
[--debug]
[-d|--distribution CODENAME]
[--parent-distribution CODENAME]
[--parent-debian-installer-distribution CODENAME]
[--dump]
[--fdisk fdisk|fdisk.dist]
[--firmware-binary true|false]
[--firmware-chroot true|false]
[--force]
[--grub-splash FILE]
[--gzip-options OPTION|"OPTIONS"]
[--hooks FILE]
[--ignore-system-defaults]
[--initramfs auto|none|live-boot|casper]
[--initramfs-compression bzip2|gzip|lzma]
[--initsystem sysvinit|runit|systemd|upstart|none]
[--interactive shell]
[--isohybrid-options OPTION|"OPTIONS"]
[--iso-application NAME]
[--iso-preparer NAME]
[--iso-publisher NAME]
[--iso-volume NAME]
[--jffs2-eraseblock SIZE]
[--keyring-packages PACKAGE|"PACKAGES"]
[-k|--linux-flavours FLAVOUR|"FLAVOURS"]
[--linux-packages "PACKAGES"]
[--losetup losetup|losetup.orig]
[--memtest memtest86+|memtest86|none]
[-m|--parent-mirror-bootstrap URL]
[--parent-mirror-chroot URL]
[--parent-mirror-chroot-security URL]
[--parent-mirror-chroot-volatile URL]
[--parent-mirror-chroot-backports URL]
[--parent-mirror-binary URL]
[--parent-mirror-binary-security URL]
[--parent-mirror-binary-volatile URL]
[--parent-mirror-binary-backports URL]
[--parent-mirror-debian-installer URL]
[--mirror-bootstrap URL]
[--mirror-chroot URL]
[--mirror-chroot-security URL]
[--mirror-chroot-volatile URL]
[--mirror-chroot-backports URL]
[--mirror-binary URL]
[--mirror-binary-security URL]
[--mirror-binary-volatile URL]
[--mirror-binary-backports URL]
[--mirror-debian-installer URL]
[--mode debian|emdebian|progress|ubuntu|kubuntu]
[--system live|normal]
[--net-root-filesystem nfs|cfs]
[--net-root-mountoptions OPTIONS]
[--net-root-path PATH]
[--net-root-server IP|HOSTNAME]
[--net-cow-filesystem nfs|cfs]
[--net-cow-mountoptions OPTIONS]
[--net-cow-path PATH]
[--net-cow-server IP|HOSTNAME]
[--net-tarball true|false]
[-p|--package-lists LIST|"LISTS"]
[--quiet]
[--root-command sudo]
[--use-fakeroot true|false]
[--archives ARCHIVE|"ARCHIVES"]
[--archive-areas ARCHIVE_AREA|"ARCHIVE_AREAS"]
[--parent-archive-areas PARENT_ARCHIVE_AREA|"PARENT_ARCHIVE_AREAS"]
[--security true|false]
[--source true|false]
[-s|--source-images iso|netboot|tar|hdd]
[--syslinux-theme THEME_SUFFIX]
[--tasksel apt|aptitude|tasksel]
[--templates PATH]
[--hdd-size MB]
[--volatile true|false]
[--backports true|false]
[--exposed-root true|false]
[--verbose]
[--win32-loader true|false]
DESCRIPTION
lb config is a high-level command (porcelain) of live-build(7), the Debian Live tool
suite.
lb config populates the configuration directory for live-build. By default, this directory
is named 'config' and is created in the current directory where lb config was executed.
Note: Currently lb config tries to be smart and sets defaults for some options depending
on the setting of other options (e.g. which linux packages to be used depending on if a
squeeze system gets build or not). This means that when generating a new configuration,
you should call lb config only once with all options specified. Calling it several times
with only a subset of the options each can result in non working configurations. This is
also caused by the fact that lb config called with one option only changes that option,
and leaves everything else as is unless its not defined. However, lb config does warn
about know impossible or likely impossible combinations that would lead to non working
live systems. If unsure, remove config/{binary,bootstrap,chroot,common,source} and call lb
config again.
OPTIONS
In addition to its specific options lb config understands all generic live-build options.
See live-build(7) for a complete list of all generic live-build options.
--apt apt|aptitude
defines if apt-get or aptitude is used to install packages when building the image.
The default is apt.
--apt-ftp-proxy URL
sets the ftp proxy to be used by apt. By default, this is empty. Note that this
variable is only for the proxy that gets used by apt internally within the chroot, it
is not used for anything else.
--apt-http-proxy URL
sets the http proxy to be used by apt. By default, this is empty. Note that this
variable is only for the proxy that gets used by apt internally within the chroot, it
is not used for anything else.
--apt-indices true|false|none
defines if the resulting images should have apt indices or not and defaults to true.
If set to none, no indices are included at all.
--apt-options OPTION|"OPTIONS"
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.
--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 packages.
--apt-pipeline DEPTH
sets the depth of the apt/aptitude pipeline. In cases where the remote server is not
RFC conforming or buggy (such as Squid 2.0.2) this option can be a value from 0 to 5
indicating how many outstanding requests APT should send. A value of zero MUST be
specified if the remote host does not properly linger on TCP connections - otherwise
data corruption will occur. Hosts which require this are in violation of RFC 2068. By
default, live-build does not set this option.
--apt-recommends true|false
defines if apt should install recommended packages automatically. By default, this is
true except in emdebian mode.
--apt-secure true|false
defines if apt should check repository signatures. This is true by default.
--apt-source-archives true|false
defines if deb-src entries should be included in the resulting live image or not,
defaults to on.
-a|--architectures 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.
-b|--binary-images iso|iso-hybrid|netboot|tar|hdd
defines the image type to build. By default, for images using syslinux this is set to
iso-hybrid to build CD/DVD images that may also be used like hdd images, for
non-syslinux images, it defaults to iso.
--binary-filesystem fat16|fat32|ext2|ext3|ext4
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
hdd images for usb sticks, this is active. Note that it defaults to fat16 on all
architectures except sparc where it defaults to ext4. Also note that if you choose
fat16 and your resulting binary image gets bigger than 2GB, the binary filesystem
automatically gets switched to fat32.
--bootappend-install PARAMETER|"PARAMETERS"
sets boot parameters specific to debian-installer, if included.
--bootappend-live PARAMETER|"PARAMETERS"
sets boot parameters specific to debian-live. A complete list of boot parameters can
be found in the live-boot(7) and live-config(7) manual pages.
--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 bootloaders may be
possible but live-build does not support them yet. lb config will fail to create such
a not yet supported configuration and give a explanation about it. For hdd images on
amd64 and i386, the default is syslinux. yaboot is only used on powerpc.
--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 useful if you want to convert/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.
-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).
--bootstrap-keyring PACKAGE
sets the archive keyring package to be used. Default is debian-archive-keyring.
--cache true|false
defines globally if any cache should be used at all. Different caches can be controled
through the their own options.
--cache-indices true|false
defines if downloaded package indices and lists should be cached which is false by
default. Enabling it would allow to rebuild an image completely offline, however, you
would not get updates anymore then.
--cache-packages true|false
defines if downloaded packages files should be cached which is true 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 true, 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.
--cache-stages true|false|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 filesystem.{dir,ext*,squashfs}. This is useful during
development if you want to rebuild the binary stage but not regenerate the root
filesystem all the time.
--checksums md5|sha1|sha256|none
defines if the binary image should contain a file called md5sums.txt, sha1sums.txt
and/or sha256sums.txt. These lists all files on the image together with their
checksums. This in turn can be used by live-boots built-in integrity-check to verify
the medium if specified at boot prompt. In general, this should not be false 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.
--compression bzip2|gzip|lzip|none
defines the compression program to be used to compress tarballs. Defaults to gzip.
--config GIT_URL::GIT_ID
allows to bootstrap a config tree from a git repositories, optionally appended by a
Git Id (branch, commit, tag, etc.).
--build-with-chroot true|false
defines whetever live-build 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 system 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
dosfstools, 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.
--chroot-filesystem ext2|ext3|ext4|squashfs|jffs2|none
defines which filesystem type should be used for the root filesystem image. If you use
none, 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 such a plain root filesystem, e.g.
fat16/fat32 will not work as linux does not support to run directly on them.
--clean
minimizes config directory by automatically removing unused and thus empty
subdirectories.
-c|--conffile FILE
using a user specified alternative configuration file in addition to the normally used
one in the config directory.
--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.
--debconf-nowarnings true|false
defines if warnings of debconf should be displayed or not. Warnings from debconf are
generally very rare and by default, we skip them, if any, in order to keep the build
process entirely non interactive.
--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 critical, which means that almost no questions are displayed.
Note that this only has an effect if you use any debconf frontend different from
noninteractive.
--debian-installer true|cdrom|netinst|netboot|businesscard|live|false
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.
--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.
--debian-installer-preseedfile FILE|URL
sets the filename or URL for an optionally used and included preseeding file for
debian-installer. If config/binary_debian-installer/preseed.cfg exists, it will be
used by default.
--debian-installer-gui true|false
defines if the debian-installer graphical GTK interface should be true or not. In
Debian mode and for most versions of Ubuntu, this option is true, whereas otherwise
false, by default.
--debug
turn on debugging informational messages.
-d|--distribution CODENAME
defines the distribution of the resulting live system.
-d|--parent-distribution CODENAME
defines the parent distribution for derivatives of the resulting live system.
-d|--parent-debian-installer-distribution CODENAME
defines the parent debian-installer distribution for derivatives of the resulting live
system.
--dump
prepares a report of the currently present live system configuration and the version
of live-build used. This is useful to provide if you submit bug reports, we do get all
informations required for us to locate and replicate an error.
--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.
--force
forces re-execution of already run stages. Use only if you know what you are doing. It
is generally safer to use lb clean to clean up before re-executing lb build.
--grub-splash FILE
defines the name of an optional to be included splash screen graphic for the grub
bootloader.
--gzip-options OPTION|"OPTIONS"
defines the default options that will be appended to (almost) every gzip call during
the building of the image. By default, this is set to --best to use highest (but
slowest) compression. Dynamically, if the host system supports it, also --rsyncable is
added.
--hooks FILE
defines which hooks available in /usr/share/live/build/examples/hooks should be
activated. Normally, there are no hooks executed. Make sure you know and understood
the hook before you enable it.
--ignore-system-defaults
lb config by default reads system defaults from /etc/live/build.conf and
/etc/live/build.d when generating a new live system config directory. This is useful
if you want to set global settings, such as mirror locations, and don't want to
specify them all of the time.
--initramfs auto|none|live-boot|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
ubuntu systems, to live-boot for all other systems. Using 'none' is useful if the
resulting system image should not be a live image (experimental).
--initramfs-compression bzip2|gzip|lzma]
defines the compression program to be used to compress the initramfs. Defaults to
gzip.
--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 false.
--isohybrid-options OPTION|"OPTIONS"
defines options to pass to isohybrid.
--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, and "Ubuntu
Live" in ubuntu mode.
--iso-preparer NAME
sets the PREPARER field in the header of a resulting CD/DVD image. By default this is
set to "live-build VERSION; http://packages.qa.debian.org/live-build", whereas VERSION
is expanded to the version of live-build that was used to build the image.
--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:/live.debian.net/; debian-live@lists.debian.org'.
Remember to change this to the appropriate values at latest when you distributing
custom and unofficial images.
--iso-volume NAME
sets the VOLUME field in the header of a resulting CD/DVD and defaults to '(MODE)
(DISTRIBUTION) (DATE)' whereas MODE is expanded to the name of the mode in use,
DISTRIBUTION the distribution name, and DATE with the current date and time of the
generation.
--jffs2-eraseblock SIZE
sets the eraseblock size for a JFFS2 (Second Journalling Flash File System)
filesystem. The default is 64 KiB. If you use an erase block size different than the
erase block size of the target MTD device, JFFS2 may not perform optimally. If the
SIZE specified is below 4096, the units are assumed to be KiB.
--keyring-packages PACKAGE|"PACKAGES"
sets the keyring package or additional keyring packages. By default this is set to
debian-archive-keyring.
-k|--linux-flavours FLAVOUR|"FLAVOURS"
sets the kernel flavours to be installed. Note that in case you specify more than that
the first will be configured the default kernel that gets booted.
--linux-packages "PACKAGES"
sets the internal name of the kernel packages naming scheme. If you use debian kernel
packages, 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.
--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.
--memtest memtest86+|memtest86|none
defines if memtest, memtest86+ or no memory tester at all should be included as
secondary bootloader configuration. This is only available on amd64 and i386 and
defaults to memtest86+.
-m|--parent-mirror-bootstrap URL
sets the location of the debian package mirror that should be used to bootstrap from.
This defaults to http://ftp.de.debian.org/debian/ which may not be a good default if
you live outside of Europe.
--parent-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 is set to the value of
--parent-mirror-bootstrap.
--parent-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/.
--parent-mirror-chroot-volatile URL
sets the location of the debian volatile package mirror that will be used to fetch
packages in order to build the live system. By default, this is set to the value of
--parent-mirror-chroot.
--parent-mirror-chroot-backports URL
sets the location of the debian backports package mirror that will be used to fetch
packages in order to build the live system. By default, this points to
http://backports.debian.org/debian-backports/.
--parent-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, 'http://cdn.debian.net/debian/'
is used.
--parent-mirror-binary-security URL
sets the location of the debian security package mirror that should end up configured
in the final image. By default, 'http://cdn.debian.net/debian-security/' is used.
--parent-mirror-binary-volatile URL
sets the location of the debian volatile package mirror that should end up configured
in the final image. By default, the value of --parent-mirror-binary is used.
--parent-mirror-binary-backports URL
sets the location of the debian backports package mirror that should end up configured
in the final image. By default, 'http://backports.debian.org/debian-backports/' is
used.
--parent-mirror-debian-installer URL
sets the location of the mirror that will be used to fetch the debian installer
images. By default, this points to the same mirror used to build the live system, i.e.
the value of --parent-mirror-bootstrap.
--mirror-bootstrap URL
sets the location of the debian package mirror that should be used to bootstrap the
derivative from. This defaults to http://ftp.de.debian.org/debian/ which may not be a
good default if you live outside of Europe.
--mirror-chroot URL
sets the location of the debian package mirror that will be used to fetch the packages
of the derivative in order to build the live system. By default, this is set to the
value of --mirror-bootstrap.
--mirror-chroot-security URL
sets the location of the debian security package mirror that will be used to fetch the
packages of the derivative in order to build the live system. By default, this points
to http://security.debian.org/debian/.
--mirror-chroot-volatile URL
sets the location of the debian volatile package mirror that will be used to fetch
packages of the derivative in order to build the live system. By default, this is set
to the value of --mirror-chroot.
--mirror-chroot-backports URL
sets the location of the debian backports package mirror that will be used to fetch
packages of the derivative in order to build the live system. By default, this points
to http://backports.debian.org/debian-backports/.
--mirror-binary URL
sets the location of the derivative 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.
--mirror-binary-security URL
sets the location of the derivatives security package mirror that should end up
configured in the final image.
--mirror-binary-volatile URL
sets the location of the derivatives volatile package mirror that should end up
configured in the final image.
--mirror-binary-backports URL
sets the location of the derivatives backports package mirror that should end up
configured in the final image.
--mirror-debian-installer URL
sets the location of the mirror that will be used to fetch the debian installer images
of the derivative. By default, this points to the same mirror used to build the live
system, i.e. the value of --mirror-bootstrap.
--mode debian|emdebian|progress|ubuntu
defines a global mode to load project specific defaults. By default this is set to
debian.
--system live|normal
defines if the resulting system image should a live system or a normal, non-live
system.
--net-root-filesystem nfs|cfs
defines the filesystem that will be configured in the bootloader configuration for
your netboot image. This defaults to nfs.
--net-root-mountoptions OPTIONS
sets additional options for mounting the root filesystem in netboot images and is by
default empty.
--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, and /srv/ubuntu-live when in ubuntu mode.
--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.
--net-cow-filesystem nfs|cfs
defines the filesystem type for the copy-on-write layer and defaults to nfs.
--net-cow-mountoptions OPTIONS
sets additional options for mounting the copy-on-write layer in netboot images and is
by default empty.
--net-cow-path PATH
defines the path to client writable filesystem. Anywhere that client_mac_address is
specified in the path live-boot 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
--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.
--net-tarball true|false
defines if a compressed tarball should be created. Disabling this options leads to no
tarball at all, the plain binary directory is considered the output in this case.
Default is true.
-p|--package-lists LIST|"LISTS"
defines which lists available in /usr/share/live/build/package-lists should be used.
By default, this is set to standard. Note that in case you have local package lists,
you don't need to list them here. Putting them into config/package-lists is enough
(the filename needs to have the .list suffix though).
--quiet
reduces the verbosity of messages output by lb build.
--archives ARCHIVE|"ARCHIVES"
enables one of available third-party archive configurations in
/usr/share/live/build/archives.
--root-command sudo
controls if live-build should use sudo internally to build the live image. Note that
this is not well tested and that you should, when relying on sudo, call the individual
live-build command with sudo itself.
--use-fakeroot true|false
controls if live-build should utilize fakeroot and fakechroot to try and avoid
requiring root privillages where possible. By default, this option is false.
--archive-areas ARCHIVE_AREA|"ARCHIVE_AREAS"
defines which package archive areas of a debian packages archive should be used for
configured debian package mirrors. By default, this is set to main. Remember to check
the licenses of each packages with respect to their redistributability in your
juristiction when enabling contrib or non-free with this mechanism.
--parent-archive-areas PARENT_ARCHIVE_AREA|"PARENT_ARCHIVE_AREAS"
defines the archive areas for derivatives of the resulting live system.
--security true|false
defines if the security repositories specified in the security mirror options should
be used or not.
--source true|false
defines if a corresponding source image to the binary image should be build. By
default this is false 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.
-s|--source-images iso|netboot|tar|hdd
defines the image type for the source image. Default is tar.
--firmware-binary true|false
defines if firmware packages should be automatically included into the binary pool for
debian-installer. Note that only firmware packages available within the configured
archive areas are included, e.g. an image with packages from main only will not
automatically include firmware from non-free. This option does not interfere with
explicitly listed packages in binary package lists.
--firmware-chroot true|false
defines if firmware packages should be automatically included into the live image.
Note that only firmware packages available within the configured archive areas are
included, e.g. an image with packages from main only will not automatically include
firmware from non-free. This option does not interfere with explicitly listed packages
in chroot package lists.
--swap-file-path PATH
defines the path to a swap file to create in the binary image. Default is not to
create a swap file.
--swap-file-size MB
defines what size in megabytes the swap file should be, if one is to be created.
Default is 512MB.
--syslinux-theme THEME_SUFFIX
defines the syslinux theme to use. The theme suffix is the name of a directory in
/usr/share/syslinux/themes/ provided by a package named syslinux-theme- plus the
suffix. In debian mode, this defaults to debian-squeeze.
--tasksel apt|aptitude|tasksel
selects which program is used to install tasks. By default, this is set to tasksel.
--templates PATH
sets the path to the templates that live-build is going to use, e.g. for bootloaders.
By default, this is set to /usr/share/live/build/templates/.
--hdd-size MB
defines what size the 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.
--volatile true|false
defines if debian volatile package archives should be included in the image or not.
--backports true|false
defines if debian backports package archives should be included in the image or not.
--exposed-root true|false
defines whether to expose the root filesystem as read only and not covered by the
union filesystem. This has useful implications for certain speciality setups such as
LTSP. By default, this option is false.
--verbose
increases the verbosity of messages output by lb build.
--win32-loader true|false
defines if win32-loader should be included in the binary image or not.
ENVIRONMENT
Currently, command line switches can also be specified through the corresponding
environment variable. However, this generally should not be relied upon, as it is an
implementation detail that is subject to change in future releases. For options applying
directly to live-build, environment variables are named LB_FOO, meaning, e.g.
--apt-ftp-proxy becomes LB_APT_FTP_PROXY (the exception being internal options such as
--debug). For options passed to another program, as in APT_OPTIONS or GZIP_OPTIONS, no LB_
prefix is used.
FILES
auto/config
/etc/live/build.conf, /etc/live/build.d
An optional, global configuration file for lb config variables. It is useful to
specify a few system wide defaults, like LB_PARENT_MIRROR_BOOTSTRAP. This feature can
be false by specifying the --ignore-system-defaults option.
SEE ALSO
live-build(7)
live-boot(7)
live-config(7)
This program is a part of live-build.
HOMEPAGE
More information about live-build and the Debian Live project can be found on the homepage
at <http://live.debian.net/> and in the manual at <http://live.debian.net/manual/>.
BUGS
Bugs can be reported by submitting a bugreport for the live-build package in the Debian
Bug Tracking System at <http://bugs.debian.org/> or by writing a mail to the Debian Live
mailing list at <debian-live@lists.debian.org>.
AUTHOR
live-build was written by Daniel Baumann <daniel@debian.org> for the Debian project.