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.