Provided by: live-build_3.0~a24-1ubuntu32_all bug

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]
            [-a|--architectures ARCHITECTURE]
            [-b|--binary-images iso|iso-hybrid|net|tar|usb-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]
            [--build-with-chroot true|false]
            [--chroot-filesystem ext2|ext3|ext4|squashfs|plain|jffs2]
            [--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]
            [--force]
            [--grub-splash FILE]
            [--gzip-options OPTION|"OPTIONS"]
            [--hooks FILE]
            [--hostname NAME]
            [--ignore-system-defaults]
            [--includes PATH]
            [--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"]
            [-l|--language LANGUAGE]
            [-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]
            [--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"]
            [--security true|false]
            [--source true|false]
            [-s|--source-images iso|net|tar|usb-hdd]
            [--syslinux-splash FILE]
            [--syslinux-timeout SECONDS]
            [--syslinux-menu true|false]
            [--tasksel apt|aptitude|tasksel]
            [--templates PATH]
            [--virtual-root-size MB]
            [--volatile true|false]
            [--backports true|false]
            [--exposed-root true|false]
            [--username NAME]
            [--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 but if  the  host  has
           the  environment  variable  ftp_proxy set, apt-ftp-proxy gets automatically set to the
           value of ftp_proxy.

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

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

       -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|net|tar|usb-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 usb-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
           usb-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,  for  etch,  in  the  manpage of casper, for all other distributions in the
           manpage of live-boot and live-config. On the images, a list of all parameters (without
           comments) is included in the /parameters.txt.

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

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

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

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

       --hostname NAME
           sets the hostname of the live system.

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

       --includes PATH|none
           sets the path to the includes that live-build 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/build/includes/. Choose none to disable inclusion of documentation.

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

       -l|--language LANGUAGE
           sets the language of a live system by installing l10n  related  packages.  It  doesn't
           enable  generation  of  the correct locales through setting the right boot parameters,
           those need to be done through the bootappend-live parameter.

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

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

       --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|net|tar|usb-hdd
           defines the image type for the source image. Default is tar.

       --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-splash FILE
           defines  the  file  of  the syslinux splash graphic that should be used instead of the
           default one.

       --syslinux-timeout SECONDS
           defines the timeout the syslinux bootloader should wait for input from the user at the
           bootprompt  prior  booting  the default kernel. This defaults to 0 which means it will
           wait forever.

       --syslinux-menu true|false
           defines if syslinux should be make use of the vgamenu capabilities or not.

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

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

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

       --username NAME
           sets the name of the account of the default user in the live system.

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

       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.