Provided by: open-infrastructure-system-build_20161101-lts2-2_all bug

NAME

       lb config - Create config directory

SYNOPSIS

       lb config [live-build options]

       lb config
            [--apt-ftp-proxy URL]
            [--apt-http-proxy URL]
            [--apt-indices true|false]
            [--apt-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]
            [--binary-filesystem fat16|fat32|ext2|ext3|ext4]
            [--bootappend-install PARAMETER|"PARAMETERS"]
            [--bootappend-live PARAMETER|"PARAMETERS"]
            [--bootloader grub|grub2|syslinux]
            [--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-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-updates URL]
            [--parent-mirror-chroot-backports URL]
            [--parent-mirror-binary URL]
            [--parent-mirror-binary-security URL]
            [--parent-mirror-binary-updates URL]
            [--parent-mirror-binary-backports URL]
            [--parent-mirror-debian-installer URL]
            [--mirror-bootstrap URL]
            [--mirror-chroot URL]
            [--mirror-chroot-security URL]
            [--mirror-chroot-updates URL]
            [--mirror-chroot-backports URL]
            [--mirror-binary URL]
            [--mirror-binary-security URL]
            [--mirror-binary-updates URL]
            [--mirror-binary-backports URL]
            [--mirror-debian-installer URL]
            [--mode debian|progress-linux|ubuntu]
            [--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]
            [--quiet]
            [--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]
            [--tasksel apt|tasksel]
            [--templates PATH]
            [--hdd-size MB]
            [--updates true|false]
            [--backports true|false]
            [--verbose]
            [--win32-loader true|false]

DESCRIPTION

       lb config is a high-level command (porcelain) of live-build(7), the live systems 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 wheezy 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-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.

       --apt-pipeline DEPTH
           sets the depth of the apt 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.

       --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 true.

       -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  possible  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|grub2|syslinux
           defines  which  bootloader  is  being  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.

       --cache true|false
           defines  globally  if any cache should be used at all. Different caches can be controlled 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  consumption  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-boot's 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 whether live-build should use the tools from within the chroot to build the binary  image  or
           not  by using and including the host system's 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 and grub, and the auxiliary
           tools such as dosfstools, xorriso, squashfs-tools and others) do not exactly match what is present at
           build-time in the target distribution. Never do disable this option unless you are exactly 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 chosen, 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  but  noninteractive,  which  is  the  default, makes your build asking questions during the
           build.

       --debconf-priority low|medium|high|critical
           defines what value the debconf priority should be 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 chosen, 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/*  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 "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", where  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 'Live
           Systems project; http:/live-systems.org/; 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 Journaling 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-686-pae).  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-updates URL
           sets the location of the debian updates 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://httpredir.debian.org/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://security.debian.org/' is used.

       --parent-mirror-binary-updates URL
           sets  the  location  of  the debian updates 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-updates URL
           sets the location of the debian updates 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-updates URL
           sets  the  location  of  the  derivatives updates 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|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 /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.

       --quiet
           reduces the verbosity of messages output by lb build.

       --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.

       --tasksel apt|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.

       --updates true|false
           defines if debian updates 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.

       --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/*
           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  Live  Systems  project  can  be  found on the homepage at
       <http://live-systems.org/> and in the manual at <http://live-systems.org/manual/>.

BUGS

       Bugs can be reported by submitting a bugreport for the live-build package in the Bug Tracking  System  at
       <http://bugs.debian.org/>   or  by  writing  a  mail  to  the  Live  Systems  mailing  list  at  <debian-
       live@lists.debian.org>.

AUTHOR

       live-build was written by Daniel Baumann <mail@daniel-baumann.ch>.

20160601                                           2016-07-28                                      LIVE-BUILD(1)