diff options
author | Daniel Baumann <mail@daniel-baumann.ch> | 2013-05-06 14:48:46 +0200 |
---|---|---|
committer | Daniel Baumann <mail@daniel-baumann.ch> | 2013-05-06 14:48:46 +0200 |
commit | d1047e809a90daa0e88329efc0db21931be0b919 (patch) | |
tree | 5dc92aaaeb4d15dcad4796935b90a9675be93ad5 /manpages/de | |
parent | 160d6bade79bf58a1c0d1842dc9b55ec178ec303 (diff) | |
download | vyos-live-build-d1047e809a90daa0e88329efc0db21931be0b919.tar.gz vyos-live-build-d1047e809a90daa0e88329efc0db21931be0b919.zip |
Adding debian version 4.0~a1-1.debian/4.0_a1-1
Diffstat (limited to 'manpages/de')
-rw-r--r-- | manpages/de/lb.de.1 | 48 | ||||
-rw-r--r-- | manpages/de/lb_binary.de.1 | 47 | ||||
-rw-r--r-- | manpages/de/lb_bootstrap.de.1 | 47 | ||||
-rw-r--r-- | manpages/de/lb_build.de.1 | 49 | ||||
-rw-r--r-- | manpages/de/lb_chroot.de.1 | 47 | ||||
-rw-r--r-- | manpages/de/lb_clean.de.1 | 73 | ||||
-rw-r--r-- | manpages/de/lb_config.de.1 | 807 | ||||
-rw-r--r-- | manpages/de/lb_source.de.1 | 47 | ||||
-rw-r--r-- | manpages/de/lb_testroot.de.1 | 53 | ||||
-rw-r--r-- | manpages/de/live-build.de.7 | 290 |
10 files changed, 1508 insertions, 0 deletions
diff --git a/manpages/de/lb.de.1 b/manpages/de/lb.de.1 new file mode 100644 index 000000000..354346696 --- /dev/null +++ b/manpages/de/lb.de.1 @@ -0,0 +1,48 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlb\fP \- wrapper for live\-build programs + +.SH SYNOPSIS +\fBlb\fP COMMAND [COMMAND_OPTIONS] +.PP +\fBlb\fP [\fIlive\-build\ options\fP] + +.SH DESCRIPTION +\fBlb\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the Debian +Live tool suite. +.PP + +.\" FIXME +.SH OPTIONS +\fBlb\fP has no specific options but understands all generic live\-build +options. See \fIlive\-build\fP(7) for a complete list of all generic live\-build +options. + +.SH FILES +.IP \fBnone\fP 4 + +.SH "SEE ALSO" +\fIlive\-build\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. diff --git a/manpages/de/lb_binary.de.1 b/manpages/de/lb_binary.de.1 new file mode 100644 index 000000000..394354e62 --- /dev/null +++ b/manpages/de/lb_binary.de.1 @@ -0,0 +1,47 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlb binary\fP \- Complete the binary stage + +.SH SYNOPSIS +\fBlb binary\fP [\fIlive\-build options\fP] + +.SH DESCRIPTION +\fBlb binary\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the +Debian Live tool suite. +.PP +\fBlb binary\fP calls all necessary live\-build programs in the correct order to +complete the binary stage. + +.SH OPTIONS +\fBlb binary\fP has no specific options but understands all generic live\-build +options. See \fIlive\-build\fP(7) for a complete list of all generic live\-build +options. + +.SH FILES +.IP \fBnone\fP 4 + +.SH "SEE ALSO" +\fIlive\-build\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. diff --git a/manpages/de/lb_bootstrap.de.1 b/manpages/de/lb_bootstrap.de.1 new file mode 100644 index 000000000..220b07b26 --- /dev/null +++ b/manpages/de/lb_bootstrap.de.1 @@ -0,0 +1,47 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlb bootstrap\fP \- Complete the bootstrap stage + +.SH SYNOPSIS +\fBlb bootstrap\fP [\fIlive\-build options\fP] + +.SH DESCRIPTION +\fBlb bootstrap\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the +Debian Live tool suite. +.PP +\fBlb bootstrap\fP calls all necessary live\-build programs in the correct order +to complete the bootstrap stage. + +.SH OPTIONS +\fBlb bootstrap\fP has no specific options but understands all generic +live\-build options. See \fIlive\-build\fP(7) for a complete list of all generic +live\-build options. + +.SH FILES +.IP \fBnone\fP 4 + +.SH "SEE ALSO" +\fIlive\-build\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. diff --git a/manpages/de/lb_build.de.1 b/manpages/de/lb_build.de.1 new file mode 100644 index 000000000..cdc2d5e15 --- /dev/null +++ b/manpages/de/lb_build.de.1 @@ -0,0 +1,49 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlb build\fP \- Complete the bootstrap, chroot, binary, and source stages + +.SH SYNOPSIS +\fBlb build\fP [\fIlive\-build options\fP] + +.SH DESCRIPTION +\fBlb build\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the +Debian Live tool suite. +.PP +\fBlb build\fP calls all necessary live\-build programs in the correct order to +complete the bootstrap, chroot, binary, and source stages. + +.SH OPTIONS +\fBlb build\fP has no specific options but understands all generic live\-build +options. See \fIlive\-build\fP(7) for a complete list of all generic live\-build +options. + +.SH FILES +.\" FIXME +.IP \fBauto/build\fP 4 + +.\" FIXME +.SH "SEE ALSO" +\fIlive\-build\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. diff --git a/manpages/de/lb_chroot.de.1 b/manpages/de/lb_chroot.de.1 new file mode 100644 index 000000000..2512eccc2 --- /dev/null +++ b/manpages/de/lb_chroot.de.1 @@ -0,0 +1,47 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlb chroot\fP \- Complete the chroot stage + +.SH SYNOPSIS +\fBlb chroot\fP [\fIlive\-build options\fP] + +.SH DESCRIPTION +\fBlb chroot\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the +Debian Live tool suite. +.PP +\fBlb chroot\fP calls all necessary live\-build programs in the correct order to +complete the chroot stage. + +.SH OPTIONS +\fBlb chroot\fP has no specific options but understands all generic live\-build +options. See \fIlive\-build\fP(7) for a complete list of all generic live\-build +options. + +.SH FILES +.IP \fBnone\fP 4 + +.SH "SEE ALSO" +\fIlive\-build\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. diff --git a/manpages/de/lb_clean.de.1 b/manpages/de/lb_clean.de.1 new file mode 100644 index 000000000..ccc142b45 --- /dev/null +++ b/manpages/de/lb_clean.de.1 @@ -0,0 +1,73 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlb clean\fP \- Clean build directory + +.SH SYNOPSIS +\fBlb clean\fP [\fIlive\-build options\fP] + +.SH DESCRIPTION +\fBlb clean\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the +Debian Live tool suite. +.PP +.\" FIXME +.\" FIXME +\fBlb clean\fP is responsible for cleaning up after a system is built. It +removes the build directories, and removes some other files including stage +files, and any detritus left behind by other live\-build commands. + +.SH OPTIONS +In addition to its specific options \fBlb clean\fP understands all generic +live\-build options. See \fIlive\-build\fP(7) for a complete list of all generic +live\-build options. +.PP +.\" FIXME +.IP \fB\-\-all\fP 4 +removes chroot, binary, stage, and source. The cache directory is kept. This +is the default operation and will be performed if no argument is given. +.IP \fB\-\-cache\fP 4 +removes the cache directories. +.IP \fB\-\-chroot\fP 4 +unmounts and removes the chroot directory. +.IP \fB\-\-binary\fP 4 +removes all binary related caches, files, directories, and stages files. +.IP \fB\-\-purge\fP 4 +removes everything, including all caches. The config directory is kept. +.IP \fB\-\-remove\fP 4 +removes everything, including package cache but not stage cache. The config +directory is kept. +.IP \fB\-\-stage\fP 4 +removes all stage files. +.IP \fB\-\-source\fP 4 +.\" FIXME +removes all source related caches, files, directories, and stage files. + +.SH FILES +.\" FIXME +.IP \fBauto/clean\fP 4 + +.\" FIXME +.SH "SEE ALSO" +\fIlive\-build\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. diff --git a/manpages/de/lb_config.de.1 b/manpages/de/lb_config.de.1 new file mode 100644 index 000000000..44bdeb7c2 --- /dev/null +++ b/manpages/de/lb_config.de.1 @@ -0,0 +1,807 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlb config\fP \- Create config directory + +.SH SYNOPSIS +\fBlb config\fP [\fIlive\-build options\fP] +.PP +.\" FIXME +\fBlb config\fP +.br + [\fB\-\-apt\fP apt|aptitude] +.br + [\fB\-\-apt\-ftp\-proxy\fP \fIURL\fP] +.br + [\fB\-\-apt\-http\-proxy\fP \fIURL\fP] +.br + [\fB\-\-apt\-indices\fP true|false|none] +.br + [\fB\-\-apt\-options\fP \fIOPTION\fP|"\fIOPTIONS\fP"] +.br + [\fB\-\-aptitude\-options\fP \fIOPTION\fP|"\fIOPTIONS\fP"] +.br + [\fB\-\-apt\-pipeline\fP \fIDEPTH\fP] +.br + [\fB\-\-apt\-recommends\fP true|false] +.br + [\fB\-\-apt\-secure\fP true|false] +.br + [\fB\-\-apt\-source\-archives\fP true|false] +.br + [\-a|\fB\-\-architectures\fP \fIARCHITECTURE\fP] +.br + [\-b|\fB\-\-binary\-images\fP iso|iso\-hybrid|netboot|tar|hdd] +.br + [\fB\-\-binary\-filesystem\fP fat16|fat32|ext2|ext3|ext4] +.br + [\fB\-\-bootappend\-install\fP \fIPARAMETER\fP|\fI"PARAMETERS"\fP] +.br + [\fB\-\-bootappend\-live\fP \fIPARAMETER\fP|\fI"PARAMETERS"\fP] +.br + [\fB\-\-bootloader\fP grub|syslinux|yaboot] +.br + [\fB\-\-bootstrap\fP cdebootstrap|cdebootstrap\-static|debootstrap] +.br + [\fB\-\-cache\fP true|false] +.br + [\fB\-\-cache\-indices\fP true|false] +.br + [\fB\-\-cache\-packages\fP true|false] +.br + [\fB\-\-cache\-stages\fP \fISTAGE\fP|\fI"STAGES"\fP] +.br + [\fB\-\-checksums\fP md5|sha1|sha256|none] +.br + [\fB\-\-compression\fP bzip2|gzip|lzip|none] +.br + [\fB\-\-config\fP \fIGIT_URL::GIT_ID\fP] +.br + [\fB\-\-build\-with\-chroot\fP true|false] +.br + [\fB\-\-chroot\-filesystem\fP ext2|ext3|ext4|squashfs|jffs2|none] +.br + [\fB\-\-clean\fP] +.br + [\-c|\fB\-\-conffile\fP \fIFILE\fP] +.br + [\fB\-\-debconf\-frontend\fP dialog|editor|noninteractive|readline] +.br + [\fB\-\-debconf\-priority\fP low|medium|high|critical] +.br + [\fB\-\-debian\-installer\fP true|cdrom|netinst|netboot|businesscard|live|false] +.br + [\fB\-\-debian\-installer\-distribution\fP daily|\fICODENAME\fP] +.br + [\fB\-\-debian\-installer\-preseedfile\fP \fIFILE\fP|\fIURL\fP] +.br + [\fB\-\-debian\-installer\-gui\fP true|false] +.br + [\fB\-\-debug\fP] +.br + [\-d|\fB\-\-distribution\fP \fICODENAME\fP] +.br + [\fB\-\-parent\-distribution\fP \fICODENAME\fP] +.br + [\fB\-\-parent\-debian\-installer\-distribution\fP \fICODENAME\fP] +.br + [\fB\-\-dump\fP] +.br + [\fB\-\-fdisk\fP fdisk|fdisk.dist] +.br + [\fB\-\-firmware\-binary true|false\fP] +.br + [\fB\-\-firmware\-chroot true|false\fP] +.br + [\fB\-\-force\fP] +.br + [\fB\-\-grub\-splash\fP \fIFILE\fP] +.br + [\fB\-\-gzip\-options\fP \fIOPTION\fP|"\fIOPTIONS\fP"] +.br + [\fB\-\-hooks\fP \fIFILE\fP] +.br + [\fB\-\-ignore\-system\-defaults\fP] +.br + [\fB\-\-initramfs\fP auto|none|live\-boot|casper] +.br + [\fB\-\-initramfs\-compression\fP bzip2|gzip|lzma] +.br + [\fB\-\-initsystem\fP sysvinit|runit|systemd|upstart|none] +.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] +.br + [\fB\-\-iso\-publisher\fP \fINAME\fP] +.br + [\fB\-\-iso\-volume\fP \fINAME\fP] +.br + [\fB\-\-jffs2\-eraseblock\fP \fISIZE\fP] +.br + [\fB\-\-keyring\-packages\fP \fIPACKAGE|"PACKAGES"\fP] +.br + [\-k|\fB\-\-linux\-flavours\fP \fIFLAVOUR\fP|\fI"FLAVOURS"\fP] +.br + [\fB\-\-linux\-packages\fP \fI"PACKAGES"\fP] +.br + [\fB\-\-losetup\fP losetup|losetup.orig] +.br + [\fB\-\-memtest\fP memtest86+|memtest86|none] +.br + [\-m|\fB\-\-parent\-mirror\-bootstrap\fP \fIURL\fP] +.br + [\fB\-\-parent\-mirror\-chroot\fP \fIURL\fP] +.br + [\fB\-\-parent\-mirror\-chroot\-security\fP \fIURL\fP] +.br + [\fB\-\-parent\-mirror\-chroot\-updates\fP \fIURL\fP] +.br + [\fB\-\-parent\-mirror\-chroot\-backports\fP \fIURL\fP] +.br + [\fB\-\-parent\-mirror\-binary\fP \fIURL\fP] +.br + [\fB\-\-parent\-mirror\-binary\-security\fP \fIURL\fP] +.br + [\fB\-\-parent\-mirror\-binary\-updates\fP \fIURL\fP] +.br + [\fB\-\-parent\-mirror\-binary\-backports\fP \fIURL\fP] +.br + [\fB\-\-parent\-mirror\-debian\-installer\fP \fIURL\fP] +.br + [\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\-updates\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\-binary\-updates\fP \fIURL\fP] +.br + [\fB\-\-mirror\-binary\-backports\fP \fIURL\fP] +.br + [\fB\-\-mirror\-debian\-installer\fP \fIURL\fP] +.br + [\fB\-\-mode\fP debian|emdebian|progress\-linux|ubuntu|kubuntu] +.br + [\fB\-\-system\fP live|normal] +.br + [\fB\-\-net\-root\-filesystem\fP nfs|cfs] +.br + [\fB\-\-net\-root\-mountoptions\fP \fIOPTIONS\fP] +.br + [\fB\-\-net\-root\-path\fP \fIPATH\fP] +.br + [\fB\-\-net\-root\-server\fP \fIIP\fP|\fIHOSTNAME\fP] +.br + [\fB\-\-net\-cow\-filesystem\fP nfs|cfs] +.br + [\fB\-\-net\-cow\-mountoptions\fP \fIOPTIONS\fP] +.br + [\fB\-\-net\-cow\-path\fP \fIPATH\fP] +.br + [\fB\-\-net\-cow\-server\fP \fIIP\fP|\fIHOSTNAME\fP] +.br + [\fB\-\-net\-tarball\fP true|false] +.br + [\-p|\fB\-\-package\-lists\fP \fILIST\fP|\fI"LISTS"\fP] +.br + [\fB\-\-quiet\fP] +.br + [\fB\-\-root\-command\fP sudo] +.br + [\fB\-\-use\-fakeroot\fP true|false] +.br + [\fB\-\-archives\fP \fIARCHIVE\fP|\fI"ARCHIVES"\fP] +.br + [\fB\-\-archive\-areas\fP \fIARCHIVE_AREA\fP|\fI"ARCHIVE_AREAS"\fP] +.br + [\fB\-\-parent\-archive\-areas\fP +\fIPARENT_ARCHIVE_AREA\fP|\fI"PARENT_ARCHIVE_AREAS"\fP] +.br + [\fB\-\-security\fP true|false] +.br + [\fB\-\-source\fP true|false] +.br + [\-s|\fB\-\-source\-images\fP iso|netboot|tar|hdd] +.br + [\fB\-\-syslinux\-theme\fP \fITHEME_SUFFIX\fP] +.br + [\fB\-\-tasksel\fP apt|aptitude|tasksel] +.br + [\fB\-\-templates\fP \fIPATH\fP] +.br + [\fB\-\-hdd\-size \fP\fIMB\fP] +.br + [\fB\-\-updates\fP true|false] +.br + [\fB\-\-backports\fP true|false] +.br + [\fB\-\-exposed\-root\fP true|false] +.br + [\fB\-\-verbose\fP] +.br +.\" FIXME + [\fB\-\-win32\-loader true|false]\fP + +.SH DESCRIPTION +\fBlb config\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the +Debian Live tool suite. +.PP +.\" FIXME +\fBlb config\fP populates the configuration directory for live\-build. By +default, this directory is named 'config' and is created in the current +directory where \fBlb config\fP was executed. +.PP +.\" FIXME +Note: Currently \fBlb config\fP 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\fP 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\fP called with one option only changes +that option, and leaves everything else as is unless its not +defined. However, \fBlb config\fP 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\fP again. + +.SH OPTIONS +In addition to its specific options \fBlb config\fP understands all generic +live\-build options. See \fIlive\-build\fP(7) for a complete list of all generic +live\-build options. +.PP +.\" FIXME +.IP "\fB\-\-apt\fP apt|aptitude" 4 +defines if apt\-get or aptitude is used to install packages when building the +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. 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\fP \fIURL\fP" 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\fP 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\fP \fIOPTION\fP|\(dq\fIOPTIONS\fP\(dq" 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\fP \fIOPTION\fP|\(dq\fIOPTIONS\fP\(dq" 4 +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. +.IP "\fB\-\-apt\-pipeline\fP \fIDEPTH\fP" 4 +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. +.IP "\fB\-\-apt\-recommends\fP true|false" 4 +defines if apt should install recommended packages automatically. By +default, this is true except in emdebian mode. +.IP "\fB\-\-apt\-secure\fP true|false" 4 +defines if apt should check repository signatures. This is true by default. +.IP "\fB\-\-apt\-source\-archives\fP true|false" 4 +defines if deb\-src entries should be included in the resulting live image or +not, defaults to on. +.IP "\-a|\fB\-\-architectures\fP \fIARCHITECTURE\fP" 4 +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. +.IP "\-b|\fB\-\-binary\-images\fP iso|iso\-hybrid|netboot|tar|hdd" 4 +defines the image type to build. By default, for images using syslinux this +is set to iso\-hybrid to build CD/DVD images that may also be used like hdd +images, for non\-syslinux images, it defaults to iso. +.IP "\fB\-\-binary\-filesystem\fP fat16|fat32|ext2|ext3|ext4" 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 +example, when selection iso the resulting CD/DVD has always the filesystem +ISO9660. When building hdd images for usb sticks, this is active. Note that +it defaults to fat16 on all architectures except sparc where it defaults to +ext4. Also note that if you choose fat16 and your resulting binary image +gets bigger than 2GB, the binary filesystem automatically gets switched to +fat32. +.IP "\fB\-\-bootappend\-install\fP \fIPARAMETER\fP|\(dq\fIPARAMETERS\fP\(dq" 4 +sets boot parameters specific to debian\-installer, if included. +.IP "\fB\-\-bootappend\-live\fP \fIPARAMETER\fP|\(dq\fIPARAMETERS\fP\(dq" 4 +sets boot parameters specific to debian\-live. A complete list of boot +parameters can be found in the \fIlive\-boot\fP(7) and \fIlive\-config\fP(7) manual +pages. +.IP "\fB\-\-bootloader\fP grub|syslinux|yaboot" 4 +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. \fBlb config\fP will fail to create such a not yet supported +configuration and give a explanation about it. For hdd images on amd64 and +i386, the default is syslinux. yaboot is only used on powerpc. +.IP "\fB\-\-bootstrap\fP cdebootstrap|cdebootstrap\-static|debootstrap" 4 +defines which program is used to bootstrap the debian chroot, default is +debootstrap. +.IP "\fB\-\-cache\fP true|false" 4 +defines globally if any cache should be used at all. Different caches can be +controled through the their own options. +.IP "\fB\-\-cache\-indices\fP true|false" 4 +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. +.IP "\fB\-\-cache\-packages\fP true|false" 4 +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. +.IP "\fB\-\-cache\-stages\fP true|false|\fISTAGE\fP|\(dq\fISTAGES\fP\(dq" 4 +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. +.IP "\fB\-\-checksums\fP md5|sha1|sha256|none" 4 +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. +.IP "\fB\-\-compression\fP bzip2|gzip|lzip|none" 4 +defines the compression program to be used to compress tarballs. Defaults to +gzip. +.IP "\fB\-\-config\fP \fIGIT_URL\fP::\fIGIT_ID\fP" 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\fP 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, genisoimage, +squashfs\-tools and others) do not \fBexactely\fP match what is present at +build\-time in the target distribution. Never do disable this option unless +you are \fBexactely\fP sure what you are doing and have \fBcompletely\fP\fI +understood its consequences.\fP +.IP "\fB\-\-chroot\-filesystem\fP 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\fP 4 +minimizes config directory by automatically removing unused and thus empty +subdirectories. +.IP "\-c|\fB\-\-conffile\fP \fIFILE\fP" 4 +using a user specified alternative configuration file in addition to the +normally used one in the config directory. +.IP "\fB\-\-debconf\-frontend\fP dialog|editor|noninteractive|readline" 4 +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. +.IP "\fB\-\-debconf\-priority\fP low|medium|high|critical" 4 +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. +.IP "\fB\-\-debian\-installer\fP true|cdrom|netinst|netboot|businesscard|live|false" 4 +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. +.IP "\fB\-\-debian\-installer\-distribution\fP daily|\fICODENAME\fP" 4 +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. +.IP "\fB\-\-debian\-installer\-preseedfile\fP \fIFILE\fP|\fIURL\fP" 4 +sets the filename or URL for an optionally used and included preseeding file +for debian\-installer. If config/binary_debian\-installer/preseed.cfg exists, +it will be used by default. +.IP "\fB\-\-debian\-installer\-gui\fP true|false" 4 +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 "\-d|\fB\-\-parent\-distribution\fP \fICODENAME\fP" 4 +defines the parent distribution for derivatives of the resulting live +system. +.IP "\-d|\fB\-\-parent\-debian\-installer\-distribution\fP \fICODENAME\fP" 4 +defines the parent debian\-installer distribution for derivatives of the +resulting live system. +.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 +an error. +.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. +.IP "\fB\-\-gzip\-options\fP \fIOPTION\fP|\(dq\fIOPTIONS\fP\(dq" 4 +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. +.IP "\fB\-\-hooks\fP \fIFILE\fP" 4 +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. +.IP \fB\-\-ignore\-system\-defaults\fP 4 +\fBlb config\fP by default reads system defaults from \fI/etc/live/build.conf\fP +and \fI/etc/live/build/*\fP 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. +.IP "\fB\-\-initramfs\fP auto|none|live\-boot|casper" 4 +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). +.IP "\fB\-\-initramfs\-compression\fP bzip2|gzip|lzma]" +defines the compression program to be used to compress the +initramfs. Defaults to gzip. +.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 +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. +.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 +mode, and "Ubuntu Live" in ubuntu mode. +.IP "\fB\-\-iso\-preparer\fP \fINAME\fP" 4 +sets the PREPARER field in the header of a resulting CD/DVD image. By +default this is set to "live\-build \fIVERSION\fP; +http://packages.qa.debian.org/live\-build", whereas VERSION is expanded to +the version of live\-build that was used to build the image. +.IP "\fB\-\-iso\-publisher\fP \fINAME\fP" 4 +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. +.IP "\fB\-\-iso\-volume\fP \fINAME\fP" 4 +sets the VOLUME field in the header of a resulting CD/DVD and defaults to +\&'(\fIMODE\fP) (\fIDISTRIBUTION\fP) (\fIDATE\fP)' 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. +.IP "\fB\-\-jffs2\-eraseblock\fP \fISIZE\fP" 4 +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. +.IP "\fB\-\-keyring\-packages\fP \fIPACKAGE|\(dqPACKAGES\fP\(dq" 4 +sets the keyring package or additional keyring packages. By default this is +set to debian\-archive\-keyring. +.IP "\-k|\fB\-\-linux\-flavours\fP \fIFLAVOUR\fP|\(dq\fIFLAVOURS\fP\(dq" 4 +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. +.IP "\fB\-\-linux\-packages\fP \(dq\fIPACKAGES\fP\(dq" 4 +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 \fISTUB\fP\-\fIFLAVOUR\fP 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. +.IP "\fB\-\-losetup\fP losetup|losetup.orig" 4 +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. +.IP "\fB\-\-memtest\fP memtest86+|memtest86|none" 4 +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+. +.IP "\-m|\fB\-\-parent\-mirror\-bootstrap\fP \fIURL\fP" 4 +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. +.IP "\fB\-\-parent\-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 \-\-parent\-mirror\-bootstrap. +.IP "\fB\-\-parent\-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\-\-parent\-mirror\-chroot\-updates\fP \fIURL\fP" 4 +sets the location of the debian updates package mirror that will be used to +fetch packages in order to build the live system. By default, this is set to +the value of \-\-parent\-mirror\-chroot. +.IP "\fB\-\-parent\-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\-\-parent\-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 +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://http.debian.net/debian/' is used. +.IP "\fB\-\-parent\-mirror\-binary\-security\fP \fIURL\fP" 4 +sets the location of the debian security package mirror that should end up +configured in the final image. By default, 'http://security.debian.org/' is +used. +.IP "\fB\-\-parent\-mirror\-binary\-updates\fP \fIURL\fP" 4 +sets the location of the debian updates package mirror that should end up +configured in the final image. By default, the value of +\-\-parent\-mirror\-binary is used. +.IP "\fB\-\-parent\-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\-\-parent\-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, i.e. the value of \-\-parent\-mirror\-bootstrap. +.IP "\fB\-\-mirror\-bootstrap\fP \fIURL\fP" 4 +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. +.IP "\fB\-\-mirror\-chroot\fP \fIURL\fP" 4 +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. +.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 of the derivative in order to build the live system. By +default, this points to http://security.debian.org/debian/. +.IP "\fB\-\-mirror\-chroot\-updates\fP \fIURL\fP" 4 +sets the location of the debian updates package mirror that will be used to +fetch packages of the derivative in order to build the live system. By +default, this is set to the value of \-\-mirror\-chroot. +.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 of the derivative 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 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. +.IP "\fB\-\-mirror\-binary\-security\fP \fIURL\fP" 4 +sets the location of the derivatives security package mirror that should end +up configured in the final image. +.IP "\fB\-\-mirror\-binary\-updates\fP \fIURL\fP" 4 +sets the location of the derivatives updates package mirror that should end +up configured in the final image. +.IP "\fB\-\-mirror\-binary\-backports\fP \fIURL\fP" 4 +sets the location of the derivatives backports package mirror that should +end up configured in the final image. +.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 of the derivative. By default, this points to the same +mirror used to build the live system, i.e. the value of \-\-mirror\-bootstrap. +.IP "\fB\-\-mode\fP debian|emdebian|progress|ubuntu" 4 +defines a global mode to load project specific defaults. By default this is +set to debian. +.IP "\fB\-\-system\fP live|normal" 4 +defines if the resulting system image should a live system or a normal, +non\-live system. +.IP "\fB\-\-net\-root\-filesystem\fP nfs|cfs" 4 +defines the filesystem that will be configured in the bootloader +configuration for your netboot image. This defaults to nfs. +.IP "\fB\-\-net\-root\-mountoptions\fP \fIOPTIONS\fP" 4 +sets additional options for mounting the root filesystem in netboot images +and is by default empty. +.IP "\fB\-\-net\-root\-path\fP \fIPATH\fP" 4 +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. +.IP "\fB\-\-net\-root\-server\fP \fIIP\fP|\fIHOSTNAME\fP" 4 +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. +.IP "\fB\-\-net\-cow\-filesystem\fP nfs|cfs" 4 +defines the filesystem type for the copy\-on\-write layer and defaults to nfs. +.IP "\fB\-\-net\-cow\-mountoptions\fP \fIOPTIONS\fP" 4 +sets additional options for mounting the copy\-on\-write layer in netboot +images and is by default empty. +.IP "\fB\-\-net\-cow\-path\fP \fIPATH\fP" 4 +defines the path to client writable filesystem. Anywhere that +\fIclient_mac_address\fP is specified in the path live\-boot will substitute the +MAC address of the client delimited with hyphens. +.PP +.IP "" 4 +Example: +.br +/export/hosts/client_mac_address +.br +/export/hosts/00\-16\-D3\-33\-92\-E8 +.IP "\fB\-\-net\-cow\-server\fP \fIIP\fP|\fIHOSTNAME\fP" 4 +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\fP 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\fP \fILIST\fP|\(dq\fILISTS\fP\(dq" 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\fP 4 +reduces the verbosity of messages output by \fBlb build\fP. +.IP "\fB\-\-archives\fP \fIARCHIVE\fP|\(dq\fIARCHIVES\fP\(dq" 4 +enables one of available third\-party archive configurations in +/usr/share/live/build/archives. +.IP "\fB\-\-root\-command\fP sudo" 4 +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. +.IP "\fB\-\-use\-fakeroot\fP true|false" 4 +controls if live\-build should utilize fakeroot and fakechroot to try and +avoid requiring root privillages where possible. By default, this option is +false. +.IP "\fB\-\-archive\-areas\fP \fIARCHIVE_AREA\fP|\(dq\fIARCHIVE_AREAS\fP\(dq" 4 +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. +.IP "\fB\-\-parent\-archive\-areas\fP \fIPARENT_ARCHIVE_AREA\fP|\(dq\fIPARENT_ARCHIVE_AREAS\fP\(dq" 4 +defines the archive areas for derivatives of the resulting live system. +.IP "\fB\-\-security\fP true|false" 4 +defines if the security repositories specified in the security mirror +options should be used or not. +.IP "\fB\-\-source\fP true|false" 4 +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. +.IP "\-s|\fB\-\-source\-images\fP iso|netboot|tar|hdd" 4 +defines the image type for the source image. Default is tar. +.IP "\fB\-\-firmware\-binary\fP true|false" 4 +defines if firmware packages should be automatically included into the +binary pool for debian\-installer. Note that only firmware packages available +within the configured archive areas are included, e.g. an image with +packages from main only will not automatically include firmware from +non\-free. This option does not interfere with explicitly listed packages in +binary package lists. +.IP "\fB\-\-firmware\-chroot\fP true|false" 4 +defines if firmware packages should be automatically included into the live +image. Note that only firmware packages available within the configured +archive areas are included, e.g. an image with packages from main only will +not automatically include firmware from non\-free. This option does not +interfere with explicitly listed packages in chroot package lists. +.IP "\fB\-\-swap\-file\-path\fP \fIPATH\fP" 4 +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\fP \fIMB\fP" 4 +defines what size in megabytes the swap file should be, if one is to be +created. Default is 512MB. +.IP "\fB\-\-syslinux\-theme\fP \fITHEME_SUFFIX\fP" 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\fP apt|aptitude|tasksel" 4 +selects which program is used to install tasks. By default, this is set to +tasksel. +.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\-\-hdd\-size\fP MB" 4 +defines what size the hdd image should be. Note that although the default is +set to 10000 (= 10GB), it will not need 10GB space on your harddisk as the +files are created as sparse files. +.IP "\fB\-\-updates\fP true|false" 4 +defines if debian updates 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\-\-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 +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 +.IP "\fB/etc/live/build.conf, /etc/live/build/*\fP" 4 +.\" FIXME +An optional, global configuration file for \fBlb config\fP variables. It is +useful to specify a few system wide defaults, like +LB_PARENT_MIRROR_BOOTSTRAP. This feature can be false by specifying the +\fB\-\-ignore\-system\-defaults\fP option. + +.SH "SEE ALSO" +\fIlive\-build\fP(7) +.PP +\fIlive\-boot\fP(7) +.PP +\fIlive\-config\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. diff --git a/manpages/de/lb_source.de.1 b/manpages/de/lb_source.de.1 new file mode 100644 index 000000000..2d9f1f685 --- /dev/null +++ b/manpages/de/lb_source.de.1 @@ -0,0 +1,47 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlb source\fP \- Complete the source stage + +.SH SYNOPSIS +\fBlb source\fP [\fIlive\-build options\fP] + +.SH DESCRIPTION +\fBlb source\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the +Debian Live tool suite. +.PP +\fBlb source\fP calls all necessary live\-build programs in the correct order to +complete the source stage. + +.SH OPTIONS +\fBlb source\fP has no specific options but understands all generic live\-build +options. See \fIlive\-build\fP(7) for a complete list of all generic live\-build +options. + +.SH FILES +.IP \fBnone\fP 4 + +.SH "SEE ALSO" +\fIlive\-build\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. diff --git a/manpages/de/lb_testroot.de.1 b/manpages/de/lb_testroot.de.1 new file mode 100644 index 000000000..f0d8733c8 --- /dev/null +++ b/manpages/de/lb_testroot.de.1 @@ -0,0 +1,53 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 1 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlb testroot\fP \- Ensure that a system is built as root + +.SH SYNOPSIS +\fBlb testroot\fP [\fIlive\-build options\fP] + +.SH DESCRIPTION +\fBlb testroot\fP is a high\-level command (porcelain) of \fIlive\-build\fP(7), the +Debian Live tool suite. +.PP +.\" FIXME +\fBlb testroot\fP simply checks to see if you are root. If not, it exits with +an error. Debian Live images must currently be built as real root. +.PP +.\" FIXME +Note: Support for using \fIfakeroot\fP(1) and \fIsudo\fP(8) internally in +live\-build itself is still experimental, however, calling a helper yourself +with sudo is safe. + +.SH OPTIONS +\fBlb testroot\fP has no specific options but understands all generic +live\-build options. See \fIlive\-build\fP(7) for a complete list of all generic +live\-build options. + +.SH FILES +.IP \fBnone\fP 4 + +.SH "SEE ALSO" +\fIlive\-build\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. diff --git a/manpages/de/live-build.de.7 b/manpages/de/live-build.de.7 new file mode 100644 index 000000000..b7b21782d --- /dev/null +++ b/manpages/de/live-build.de.7 @@ -0,0 +1,290 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 7 2012\-11\-30 4.0~a1\-1 "Debian Live Project" + +.SH NAME +\fBlive\-build\fP \- the Debian Live tool suite + +.SH SYNOPSIS +.\" FIXME +.\" FIXME +\fBlb \fP\fICOMMAND\fP [\fB\-h|\-\-help\fP] [\fB\-u|\-\-usage\fP] [\fB\-v|\-\-version\fP] +[\fB\-\-breakpoints\fP] [\fB\-\-conffile\fP] [\fB\-\-debug\fP] [\fB\-\-force\fP] [\fB\-\-quiet\fP] +[\fB\-\-verbose\fP] + +.SH DESCRIPTION +.\" FIXME +live\-build is a set of scripts to build Debian Live system images. The idea +behind live\-build is a tool suite that uses a configuration directory to +completely automate and customize all aspects of building a Live image. +.PP +The \fICOMMAND\fP is a name of a live\-build command (see below). +.PP +.\" FIXME +More documentation about how to use live\-build is available in the +individual manpages for each helper and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH OPTIONS +.\" FIXME +.SS "Shared live\-build options" +The following command line options are supported by all live\-build programs. +.IP "\fB\-h, \-\-help\fP" 4 +display help and exit. +.IP "\fB\-u, \-\-usage\fP" 4 +show usage and exit. +.IP "\fB\-v, \-\-version\fP" 4 +output version information and exit. +.SS "Common live\-build options" +The following command line options are supported by most live\-build +programs. See the man page of each program for a complete explanation of +what each option does. +.IP \fB\-\-breakpoints\fP 4 +run with breakpoints. +.IP \fB\-\-conffile\fP 4 +use custom configuration file. +.IP \fB\-\-debug\fP 4 +show debug information. +.IP \fB\-\-force\fP 4 +force helper execution, even if stage file exists. +.IP \fB\-\-quiet\fP 4 +be quiet. +.IP \fB\-\-verbose\fP 4 +.\" FIXME +be verbose. + +.SH "LIVE\-BUILD COMMANDS" +.\" FIXME +We divide live\-build into high level ("porcelain") commands and low level +("plumbing") commands. +.PP +.\" FIXME +Here is the complete list of all available live\-build commands. See their +man pages for additional documentation. + +.SH "HIGH\-LEVEL COMMANDS (PORCELAIN)" +.\" FIXME +We separate the porcelain commands into the main commands and some ancillary +user utilities. +.SS "Main porcelain commands" +.IP \fBlb_config\fP(1) 4 +create configuration for live\-build +.IP \fBlb_bootstrap\fP(1) 4 +create the first stage by bootstrapping a basic debian system +.IP \fBlb_chroot\fP(1) 4 +create the second stage by customizing the chroot +.IP \fBlb_binary\fP(1) 4 +create the third stage by generating a binary image +.IP \fBlb_source\fP(1) 4 +create the optional fourth stage by generating a source image +.IP \fBlb_clean\fP(1) 4 +clean up system build directories +.SS "Ancillary Commands" +.IP \fBlb\fP(1) 4 +generic live\-build wrapper +.IP \fBlb_build\fP(1) 4 +alias for all stages +.IP \fBlb_local\fP(1) 4 +helper for using a local live\-build +.IP \fBlb_testroot\fP(1) 4 +.\" FIXME +ensure that a system is built as root + +.SH "LOW\-LEVEL COMMANDS (PLUMBING)" +.\" FIXME +The actual work of live\-build is implemented in the low\-level commands, +called plumbing. They are not supposed to be used by end users, they should +stick with porcelains as they ensure that all the different plumbing +commands are executed in the right order. However, if you intend to reuse +live\-build commands in your own scripts, then the plumbings might be of +interest for you. +.PP +Note that the interface (set of options and the semantics) to these +low\-level commands are meant to be a lot more stable than Porcelain level +commands. The interface to Porcelain commands on the other hand are subject +to change in order to improve the end user experience. +.SS "Bootstrap commands" +.IP \fBlb_bootstrap_cache\fP(1) 4 +cache bootstrap stage +.IP \fBlb_bootstrap_cdebootstrap\fP(1) 4 +bootstrap a Debian system with cdebootstrap(1) +.IP \fBlb_bootstrap_debootstrap\fP(1) 4 +bootstrap a Debian system with debootstrap(8) +.SS "Chroot commands" +.IP \fBlb_chroot_apt\fP(1) 4 +manage /etc/apt/apt.conf +.IP \fBlb_chroot_cache\fP(1) 4 +cache chroot stage +.IP \fBlb_chroot_debianchroot\fP(1) 4 +manage /etc/debian_chroot +.IP \fBlb_chroot_devpts\fP(1) 4 +mount /dev/pts +.IP \fBlb_chroot_dpkg\fP(1) 4 +manage /sbin/dpkg +.IP \fBlb_chroot_hacks\fP(1) 4 +execute hacks in chroot +.IP \fBlb_chroot_hostname\fP(1) 4 +manage /bin/hostname +.IP \fBlb_chroot_hosts\fP(1) 4 +manage /etc/hosts +.IP \fBlb_chroot_install\-packages\fP(1) 4 +install queued packages into chroot +.IP \fBlb_chroot_interactive\fP(1) 4 +make build interactive +.IP \fBlb_chroot_linux\-image\fP(1) 4 +manage /etc/kernel\-img.conf +.IP \fBlb_chroot_hooks\fP(1) 4 +execute local hooks in chroot +.IP \fBlb_chroot_local\-includes\fP(1) 4 +copy local files into chroot +.IP \fBlb_chroot_packages\fP(1) 4 +queue install of packages into chroot +.IP \fBlb_chroot_local\-patches\fP(1) 4 +apply local patches against chroot +.IP \fBlb_chroot_local\-preseed\fP(1) 4 +use debconf local preseeding file +.IP \fBlb_chroot_packagelists\fP(1) 4 +queue install of package lists into chroot +.IP \fBlb_chroot_proc\fP(1) 4 +mount /proc +.IP \fBlb_chroot_resolv\fP(1) 4 +manage /etc/resolv.conf +.IP \fBlb_chroot_selinuxfs\fP(1) 4 +mount /selinux +.IP \fBlb_chroot_archives\fP(1) 4 +manage /etc/apt/sources.list +.IP \fBlb_chroot_sysfs\fP(1) 4 +mount /sys +.IP \fBlb_chroot_sysv\-rc\fP(1) 4 +manage /usr/sbin/policy\-rc.d +.IP \fBlb_chroot_task\-lists\fP(1) 4 +install task lists into chroot +.SS "Binary commands" +.IP \fBlb_binary_chroot\fP(1) 4 +copy chroot into chroot +.IP \fBlb_binary_debian\-installer\fP(1) 4 +install debian\-installer into binary +.IP \fBlb_binary_disk\fP(1) 4 +install disk information into binary +.IP \fBlb_binary_grub\fP(1) 4 +installs grub into binary +.IP \fBlb_binary_grub2\fP(1) 4 +installs grub2 into binary +.IP \fBlb_binary_includes\fP(1) 4 +copy files into binary +.IP \fBlb_binary_iso\fP(1) 4 +build iso binary image +.IP \fBlb_binary_linux\-image\fP(1) 4 +install linux\-image into binary +.IP \fBlb_binary_local\-hooks\fP(1) 4 +execute local hooks in binary +.IP \fBlb_binary_local\-includes\fP(1) 4 +copy files into binary +.IP \fBlb_binary_local\-packagelists\fP(1) 4 +install local package lists into binary +.IP \fBlb_binary_manifest\fP(1) 4 +create manifest +.IP \fBlb_binary_checksums\fP(1) 4 +create binary checksums (md5, sha1, and/or sha256) +.IP \fBlb_binary_memtest\fP(1) 4 +installs a memtest into binary +.IP \fBlb_binary_net\fP(1) 4 +build netboot binary image +.IP \fBlb_binary_rootfs\fP(1) 4 +build rootfs image +.IP \fBlb_binary_silo\fP(1) 4 +installs silo into binary +.IP \fBlb_binary_syslinux\fP(1) 4 +installs syslinux into binary +.IP \fBlb_binary_tar\fP(1) 4 +build harddisk binary image +.IP \fBlb_binary_hdd\fP(1) 4 +build binary hdd image +.IP \fBlb_binary_win32\-loader\fP(1) 4 +installs win32\-loader into binary +.IP \fBlb_binary_yaboot\fP(1) 4 +installs yaboot into binary +.SS "Source commands" +.IP \fBlb_source_debian\fP(1) 4 +download sources +.IP \fBlb_source_debian\-live\fP(1) 4 +copy debian\-live config into source +.IP \fBlb_source_disk\fP(1) 4 +install disk information into source +.IP \fBlb_source_iso\fP(1) 4 +build iso source image +.IP \fBlb_source_checksums\fP(1) 4 +create source checksums (md5, sha1, and/or sha256) +.IP \fBlb_source_net\fP(1) 4 +build source net image +.IP \fBlb_source_tar\fP(1) 4 +build source tarball +.IP \fBlb_source_hdd\fP(1) 4 +.\" FIXME +build source hdd image + +.SH "CONFIG FILES" +.\" FIXME +Many live\-build commands make use of files in the \fIconfig/\fP directory to +control what they do. Besides the common \fIconfig/common\fP, which is used by +all live\-build commands, some additional files can be used to configure the +behavior of specific live\-build commands. These files are typically named +config/stage or config/stage_helper (where "stage" of course, is replaced +with the name of the stage that they belong to, and "helper" with the name +of the helper). +.PP +For example, lb_bootstrap_debootstrap uses files named config/bootstrap and +config/bootstrap_debootstrap to read the options it will use. See the man +pages of individual commands for details about the names and formats of the +files they use. Generally, these files contain variables with values +assigned, one variable per line. Some programs in live\-build use pairs of +values or slightly more complicated variable assignments. +.PP +Note that live\-build will respect environment variables which are present in +the context of the shell it is running. If variables can be read from config +files, then they override environment variables, and if command line options +are used, they override values from config files. If no value for a given +variable can be found and thus is unset, live\-build will automatically set +it to the default value. +.PP +In some rare cases, you may want to have different versions of these files +for different architectures or distributions. If files named +config/stage.arch or config/stage_helper.arch, and config/stage.dist or +config/stage_helper.dist exist, where "arch" is the same as the output of +"dpkg \-\-print\-architecture" and "dist" is the same as the codename of the +target distribution, then they will be used in preference to other, more +general files. +.PP +.\" FIXME +All config files are shell scripts which are sourced by a live\-build +program. That means they have to follow the normal shell syntax. You can +also put comments in these files; lines beginning with "#" are ignored. + +.SH FILES +.IP \fB/etc/live/build.conf\fP 4 +.IP \fB/etc/live/build/*\fP 4 + +.SH "SEE ALSO" +\fIlive\-boot\fP(7) +.PP +\fIlive\-config\fP(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Debian Live project can be found +on the homepage at <\fIhttp://live.debian.net/\fP> and in the manual at +<\fIhttp://live.debian.net/manual/\fP>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in +the Debian Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by +writing a mail to the Debian Live mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project. |