summaryrefslogtreecommitdiff
path: root/manpages/de/lb_config.de.1
diff options
context:
space:
mode:
authorBen Armstrong <synrg@debian.org>2010-12-06 12:16:36 +0100
committerDaniel Baumann <daniel@debian.org>2011-03-09 19:20:38 +0100
commit6cb261cf4ff55b369346d2d5a655720931f28ff3 (patch)
tree051ca64dd30a224121fa501014094c344c7f48a2 /manpages/de/lb_config.de.1
parent4a97d539c911e92d07af9f716ae86f357e92ca3d (diff)
downloadvyos-live-build-6cb261cf4ff55b369346d2d5a655720931f28ff3.tar.gz
vyos-live-build-6cb261cf4ff55b369346d2d5a655720931f28ff3.zip
Updating lb config --help and man page.
Diffstat (limited to 'manpages/de/lb_config.de.1')
-rw-r--r--manpages/de/lb_config.de.1136
1 files changed, 96 insertions, 40 deletions
diff --git a/manpages/de/lb_config.de.1 b/manpages/de/lb_config.de.1
index 1dedd0466..224371881 100644
--- a/manpages/de/lb_config.de.1
+++ b/manpages/de/lb_config.de.1
@@ -3,7 +3,7 @@
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH LIVE\-BUILD 1 2010\-12\-05 3.0~a8 "Debian Live Project"
+.TH LIVE\-BUILD 1 2010\-12\-06 3.0~a8 "Debian Live Project"
.SH NAME
\fBlb config\fP \- Create config directory
@@ -14,7 +14,7 @@
.\" FIXME
\fBlb config\fP
.br
-\fB [\-\-apt\fP apt|aptitude]
+ [\fB\-\-apt\fP apt|aptitude]
.br
[\fB\-\-apt\-ftp\-proxy\fP \fIURL\fP]
.br
@@ -68,9 +68,9 @@
.br
[\fB\-\-chroot\-filesystem\fP ext2|ext3|squashfs|plain|jffs2]
.br
- [\fB\-\-clean]\fP
+ [\fB\-\-clean\fP]
.br
-\fB [\-c|\-\-conffile\fP \fIFILE\fP]
+ [\-c|\fB\-\-conffile\fP \fIFILE\fP]
.br
[\fB\-\-debconf\-frontend\fP dialog|editor|noninteractive|readline]
.br
@@ -86,14 +86,18 @@
.br
[\fB\-\-debian\-installer\-gui\fP true|false]
.br
+ [\fB\-\-debug\fP]
+.br
[\-d|\fB\-\-distribution\fP \fICODENAME\fP]
.br
- [\-\-\fBdump\fP]
+ [\fB\-\-dump\fP]
.br
[\-e|\fB\-\-encryption\fP false|aes128|aes192|aes256]
.br
[\fB\-\-fdisk\fP fdisk|fdisk.dist]
.br
+ [\fB\-\-force\fP]
+.br
[\fB\-\-grub\-splash\fP \fIFILE\fP]
.br
[\fB\-\-gzip\-options\fP \fIOPTION\fP|"\fIOPTIONS\fP"]
@@ -110,6 +114,8 @@
.br
[\fB\-\-interactive\fP shell]
.br
+ [\fB\-\-isohybrid\-options\fP \fIOPTION\fP|"\fIOPTIONS\fP"]
+.br
[\fB\-\-iso\-application\fP \fINAME\fP]
.br
[\fB\-\-iso\-preparer\fP \fINAME\fP]
@@ -134,13 +140,21 @@
.br
[\-m|\fB\-\-mirror\-bootstrap\fP \fIURL\fP]
.br
+ [\fB\-\-mirror\-chroot\fP \fIURL\fP]
+.br
+ [\fB\-\-mirror\-chroot\-security\fP \fIURL\fP]
+.br
+ [\fB\-\-mirror\-chroot\-volatile\fP \fIURL\fP]
+.br
+ [\fB\-\-mirror\-chroot\-backports\fP \fIURL\fP]
+.br
[\fB\-\-mirror\-binary\fP \fIURL\fP]
.br
[\fB\-\-mirror\-binary\-security\fP \fIURL\fP]
.br
- [\fB\-\-mirror\-chroot\fP \fIURL\fP]
+ [\fB\-\-mirror\-binary\-volatile\fP \fIURL\fP]
.br
- [\fB\-\-mirror\-chroot\-security\fP \fIURL\fP]
+ [\fB\-\-mirror\-binary\-backports\fP \fIURL\fP]
.br
[\fB\-\-mirror\-debian\-installer\fP \fIURL\fP]
.br
@@ -168,7 +182,9 @@
.br
[\fB\-\-packages\fP \fIPACKAGE\fP|\fI"PACKAGES"\fP]
.br
- [\fB\-r, \-\-repositories \fP\fIREPOSITORY\fP|\fI"REPOSITORIES"\fP]
+ [\fB\-\-quiet\fP]
+.br
+ [\-r|\fB\-\-repositories \fP\fIREPOSITORY\fP|\fI"REPOSITORIES"\fP]
.br
[\fB\-\-root\-command\fP sudo]
.br
@@ -196,14 +212,18 @@
.br
[\fB\-\-templates\fP \fIPATH\fP]
.br
- [\fB\-\-virtual\-root\-filesystem\fP ext3]
-.br
[\fB\-\-virtual\-root\-size \fP\fIMB\fP]
.br
+ [\fB\-\-volatile\fP true|false]
+.br
+ [\fB\-\-backports\fP true|false]
+.br
[\fB\-\-exposed\-root\fP true|false]
.br
[\fB\-\-username\fP \fINAME\fP]
.br
+ [\fB\-\-verbose\fP]
+.br
.\" FIXME
[\fB\-\-win32\-loader true|false]\fP
@@ -238,8 +258,7 @@ live\-build options.
.\" FIXME
.IP "\fB\-\-apt\fP apt|aptitude" 4
defines if apt\-get or aptitude is used to install packages when building the
-image. When building etch images, this defaults to aptitude. Every other
-distribution defaults to apt.
+image. The default is apt.
.IP "\fB\-\-apt\-ftp\-proxy\fP \fIURL\fP" 4
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
@@ -283,8 +302,10 @@ 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.
.IP "\-b|\fB\-\-binary\-images\fP iso|iso\-hybrid|net|tar|usb\-hdd" 4
-defines the image type to build. By default this is set to iso to build
-CD/DVD images, for squeeze and newer it defaults to iso\-hybrid.
+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 legacy lenny and non\-syslinux images, it defaults to
+iso.
.IP "\fB\-\-binary\-filesystem\fP fat16|fat32|ext2" 4
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
@@ -414,9 +435,11 @@ for debian\-installer.
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.
+.IP \fB\-\-debug\fP 4
+turn on debugging informational messages.
.IP "\-d|\fB\-\-distribution\fP \fICODENAME\fP" 4
defines the distribution of the resulting live system.
-.IP \-\-\fBdump\fP 4
+.IP \fB\-\-dump\fP 4
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
@@ -427,6 +450,10 @@ is false.
.IP "\fB\-\-fdisk\fP fdisk|fdisk.dist" 4
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.
+.IP \fB\-\-force\fP 4
+forces re\-execution of already run stages. Use only if you know what you are
+doing. It is generally safer to use \fBlb clean\fP to clean up before
+re\-executing \fBlb build\fP.
.IP "\fB\-\-grub\-splash\fP \fIFILE\fP" 4
defines the name of an optional to be included splash screen graphic for the
grub bootloader.
@@ -454,10 +481,9 @@ systems. By default, this is set to /usr/share/live/build/includes/.
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 etch systems or ubuntu systems, to live\-initramfs for
-all other systems up to squeeze, and to live\-boot for wheezy and
-newer. Using 'none' is usefull if the resulting system image should not be a
-live image (experimental).
+casper when building ubuntu systems, to live\-initramfs for legacy lenny, and
+to live\-boot for squeeze and newer. Using 'none' is useful if the resulting
+system image should not be a live image (experimental).
.IP "\fB\-\-interactive\fP shell" 4
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
@@ -468,6 +494,8 @@ 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.
+.IP "\fB\-\-isohybrid\-options\fP \fIOPTION\fP|\(dq\fIOPTIONS\fP\(dq" 4
+defines options to pass to isohybrid.
.IP "\fB\-\-iso\-application\fP \fINAME\fP" 4
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
@@ -527,7 +555,24 @@ as secondary bootloader configuration. This is only available on amd64 and
i386 and defaults to memtest86+.
.IP "\-m|\fB\-\-mirror\-bootstrap\fP \fIURL\fP" 4
sets the location of the debian package mirror that should be used to
-bootstrap from.
+bootstrap from. This defaults to http://ftp.de.debian.org/debian/ which may
+not be a good default if you live outside of Europe.
+.IP "\fB\-\-mirror\-chroot\fP \fIURL\fP" 4
+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 \-\-mirror\-bootstrap.
+.IP "\fB\-\-mirror\-chroot\-security\fP \fIURL\fP" 4
+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/.
+.IP "\fB\-\-mirror\-chroot\-volatile\fP \fIURL\fP" 4
+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 \-\-mirror\-chroot.
+.IP "\fB\-\-mirror\-chroot\-backports\fP \fIURL\fP" 4
+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/.
.IP "\fB\-\-mirror\-binary\fP \fIURL\fP" 4
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
@@ -536,21 +581,20 @@ use a local mirror but want to have an official mirror in the image. By
default, 'http://cdn.debian.net/debian/' is used.
.IP "\fB\-\-mirror\-binary\-security\fP \fIURL\fP" 4
sets the location of the debian security package mirror that should end up
-configuered in the final image. By default,
+configured in the final image. By default,
\&'http://cdn.debian.net/debian\-security/' is used.
-.IP "\fB\-\-mirror\-chroot\fP \fIURL\fP" 4
-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 points to
-http://ftp.de.debian.org/debian/ which may not be a good default if you live
-outside the U.S.
-.IP "\fB\-\-mirror\-chroot\-security\fP \fIURL\fP" 4
-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/.
+.IP "\fB\-\-mirror\-binary\-volatile\fP \fIURL\fP" 4
+sets the location of the debian volatile package mirror that should end up
+configured in the final image. By default, the value of \-\-mirror\-binary is
+used.
+.IP "\fB\-\-mirror\-binary\-backports\fP \fIURL\fP" 4
+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.
.IP "\fB\-\-mirror\-debian\-installer\fP \fIURL\fP" 4
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.
+the live system, i.e. the value of \-\-mirror\-bootstrap.
.IP "\fB\-\-mode\fP debian|emdebian|ubuntu" 4
defines a global mode to load project specific defaults. By default this is
set to debian.
@@ -605,7 +649,9 @@ defines one or more packages to be installed in the live system. This is a
quick and convenient place to add a few packages when building an image
(limited by the max length of shell). Packages that should be permanently
installed should be put into a local packages list.
-.IP "\fB\-r, \-\-repositories\fP \fIREPOSITORY\fP|\(dq\fIREPOSITORIES\fP\(dq" 4
+.IP \fB\-\-quiet\fP 4
+reduces the verbosity of messages output by \fBlb build\fP.
+.IP "\-r|\fB\-\-repositories\fP \fIREPOSITORY\fP|\(dq\fIREPOSITORIES\fP\(dq" 4
enables one of available third\-party repository configurations in
/usr/share/live/build/repositories.
.IP "\fB\-\-root\-command\fP sudo" 4
@@ -659,31 +705,41 @@ local package lists should be used instead.
.IP "\fB\-\-templates\fP \fIPATH\fP" 4
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/.
-.IP "\fB\-\-virtual\-root\-filesystem\fP ext3" 4
-defines what filesystem to format the root filesystem when building
-virtual\-hdd images.
.IP "\fB\-\-virtual\-root\-size\fP MB" 4
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.
+.IP "\fB\-\-volatile\fP true|false" 4
+defines if debian volatile package archives should be included in the image
+or not.
+.IP "\fB\-\-backports\fP true|false" 4
+defines if debian backports package archives should be included in the image
+or not.
.IP "\fB\-\-exposed\-root\fP true|false" 4
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.
.IP "\fB\-\-username\fP \fINAME\fP" 4
sets the name of the account of the default user in the live system.
+.IP \fB\-\-verbose\fP 4
+increases the verbosity of messages output by \fBlb build\fP.
.IP "\fB\-\-win32\-loader true|false\fP" 4
.\" FIXME
defines if win32\-loader should be included in the binary image or not.
.SH ENVIRONMENT
.\" FIXME
-.\" FIXME
-All command line switches can also be specified through the corresponding
-environment variable. Environment variables are name LB_FOO, means,
-e.g. \-\-apt\-ftp\-proxy becomes LB_APT_FTP_PROXY. However, this generally
-should not be used.
+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. \fB\-\-apt\-ftp\-proxy\fP becomes
+LB_APT_FTP_PROXY (the exception being internal options such as
+\fB\-\-debug\fP). For options passed to another program, as in APT_OPTIONS or
+GZIP_OPTIONS, no LB_ prefix is used.
+
+.\" FIXME
.SH FILES
.\" FIXME
.IP \fBauto/config\fP 4