diff options
Diffstat (limited to 'manpages/en/lb_config.1')
-rw-r--r-- | manpages/en/lb_config.1 | 24 |
1 files changed, 17 insertions, 7 deletions
diff --git a/manpages/en/lb_config.1 b/manpages/en/lb_config.1 index b3f0cdb4e..fbf7baa77 100644 --- a/manpages/en/lb_config.1 +++ b/manpages/en/lb_config.1 @@ -1,4 +1,4 @@ -.TH LIVE\-BUILD 1 2013\-04\-30 3.0.5-1 "Debian Live Project" +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1-1 "Debian Live Project" .SH NAME \fBlb config\fR \- Create config directory @@ -15,7 +15,7 @@ .br [\fB\-\-apt\-http\-proxy\fR \fIURL\fR] .br - [\fB\-\-apt\-indices\fR true|false] + [\fB\-\-apt\-indices\fR true|false|none] .br [\fB\-\-apt\-options\fR \fIOPTION\fR|"\fIOPTIONS\fR"] .br @@ -173,7 +173,7 @@ .br [\fB\-\-mirror\-debian\-installer\fR \fIURL\fR] .br - [\fB\-\-mode\fR debian|emdebian|progress-linux|ubuntu] + [\fB\-\-mode\fR debian|emdebian|progress-linux|ubuntu|kubuntu] .br [\fB\-\-system\fR live|normal] .br @@ -195,6 +195,8 @@ .br [\fB\-\-net\-tarball\fR true|false] .br + [\-p|\fB\-\-package\-lists\fR \fILIST\fR|\fI"LISTS"\fR] +.br [\fB\-\-quiet\fR] .br [\fB\-\-root-command\fR sudo] @@ -213,6 +215,8 @@ .br [\-s|\fB\-\-source\-images\fR iso|netboot|tar|hdd] .br + [\fB\-\-syslinux\-theme\fR \fITHEME_SUFFIX\fR] +.br [\fB\-\-tasksel\fR apt|aptitude|tasksel] .br [\fB\-\-templates\fR \fIPATH\fR] @@ -236,7 +240,7 @@ .\" FIXME \fBlb config\fR populates the configuration directory for live\-build. By default, this directory is named 'config' and is created in the current directory where \fBlb config\fR was executed. .PP -Note: Currently \fBlb config\fR 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 \fBlb config\fR 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 \fBlb config\fR called with one option only changes that option, and leaves everything else as is unless its not defined. However, \fBlb config\fR 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 \fBlb config\fR again. +Note: Currently \fBlb config\fR 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 \fBlb config\fR 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 \fBlb config\fR called with one option only changes that option, and leaves everything else as is unless its not defined. However, \fBlb config\fR 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 \fBlb config\fR again. .\" FIXME .SH OPTIONS @@ -249,8 +253,8 @@ defines if apt\-get or aptitude is used to install packages when building the im 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. .IP "\fB\-\-apt\-http\-proxy\fR \fIURL\fR" 4 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. -.IP "\fB\-\-apt\-indices\fR true|false" 4 -defines if the resulting images should have apt indices or not and defaults to true. +.IP "\fB\-\-apt\-indices\fR true|false|none" 4 +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. .IP "\fB\-\-apt\-options\fR \fIOPTION\fR|""\fIOPTIONS\fR""" 4 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. .IP "\fB\-\-aptitude\-options\fR \fIOPTION\fR|""\fIOPTIONS\fR""" 4 @@ -292,7 +296,7 @@ defines the compression program to be used to compress tarballs. Defaults to gzi .IP "\fB\-\-config\fR \fIGIT_URL\fR::\fIGIT_ID\fR" 4 allows to bootstrap a config tree from a git repositories, optionally appended by a Git Id (branch, commit, tag, etc.). .IP "\fB\-\-build\-with\-chroot\fR true|false" 4 -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, xorriso, squashfs-tools and others) do not \fBexactely\fR match what is present at build-time in the target distribution. Never do disable this option unless you are \fBexactely\fR sure what you are doing and have \fBcompletely\fI understood its consequences. +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 \fBexactely\fR match what is present at build-time in the target distribution. Never do disable this option unless you are \fBexactely\fR sure what you are doing and have \fBcompletely\fI understood its consequences. .IP "\fB\-\-chroot\-filesystem\fR ext2|ext3|ext4|squashfs|jffs2|none" 4 defines which filesystem type should be used for the root filesystem image. If you use none, then no filesystem image is created and the root filesystem content is copied on the binary image filesystem as flat files. Depending on what binary filesystem you have choosen, it may not be possible to build with such a plain root filesystem, e.g. fat16/fat32 will not work as linux does not support to run directly on them. .IP "\fB\-\-clean\fR" 4 @@ -430,6 +434,10 @@ Example: 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. .IP "\fB\-\-net\-tarball\fR true|false" 4 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. +.IP "\-p|\fB\-\-package\-lists\fR \fILIST\fR|""\fILISTS\fR""" 4 +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). +.IP "\fB\-\-quiet\fR" 4 +reduces the verbosity of messages output by \fBlb build\fR. .IP "\fB\-\-archives\fR \fIARCHIVE\fR|""\fIARCHIVES\fR""" 4 enables one of available third-party archive configurations in /usr/share/live/build/archives. .IP "\fB\-\-root-command\fR sudo" 4 @@ -454,6 +462,8 @@ defines if firmware packages should be automatically included into the live imag defines the path to a swap file to create in the binary image. Default is not to create a swap file. .IP "\fB\-\-swap\-file\-size\fR \fIMB\fR" 4 defines what size in megabytes the swap file should be, if one is to be created. Default is 512MB. +.IP "\fB\-\-syslinux\-theme\fR \fITHEME_SUFFIX\fR" 4 +defines the syslinux theme to use. The theme suffix is the name of a directory in /usr/share/syslinux/themes/ provided by a package named syslinux\-theme\- plus the suffix. In debian mode, this defaults to debian\-wheezy. .IP "\fB\-\-tasksel\fR apt|aptitude|tasksel" 4 selects which program is used to install tasks. By default, this is set to tasksel. .IP "\fB\-\-templates\fR \fIPATH\fR" 4 |