diff options
Diffstat (limited to 'system-build/manpages')
| -rw-r--r-- | system-build/manpages/lb.1 | 34 | ||||
| -rw-r--r-- | system-build/manpages/lb_binary.1 | 32 | ||||
| -rw-r--r-- | system-build/manpages/lb_bootstrap.1 | 32 | ||||
| -rw-r--r-- | system-build/manpages/lb_build.1 | 34 | ||||
| -rw-r--r-- | system-build/manpages/lb_chroot.1 | 32 | ||||
| -rw-r--r-- | system-build/manpages/lb_clean.1 | 55 | ||||
| -rw-r--r-- | system-build/manpages/lb_config.1 | 477 | ||||
| -rw-r--r-- | system-build/manpages/lb_source.1 | 32 | ||||
| -rw-r--r-- | system-build/manpages/live-build.7 | 231 |
9 files changed, 959 insertions, 0 deletions
diff --git a/system-build/manpages/lb.1 b/system-build/manpages/lb.1 new file mode 100644 index 0000000..4bc54ee --- /dev/null +++ b/system-build/manpages/lb.1 @@ -0,0 +1,34 @@ +.TH LIVE\-BUILD 1 2016\-07\-28 20160601 "Live Systems Project" + +.SH NAME +\fBlb\fR \- wrapper for live\-build programs + +.SH SYNOPSIS +\fBlb\fR COMMAND [COMMAND_OPTIONS] +.PP +\fBlb\fR [\fIlive\-build\ options\fR] + +.SH DESCRIPTION +\fBlb\fR is a high\-level command (porcelain) of \fIlive\-build\fR(7), the live systems tool suite. +.PP +.\" FIXME + +.SH OPTIONS +\fBlb\fR has no specific options but understands all generic live\-build options. See \fIlive\-build\fR(7) for a complete list of all generic live\-build options. + +.SH FILES +.IP "\fBnone\fR" 4 + +.SH SEE ALSO +\fIlive\-build\fR(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Live Systems project can be found on the homepage at <\fIhttp://live-systems.org/\fR> and in the manual at <\fIhttp://live-systems.org/manual/\fR>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in the Bug Tracking System at <\fIhttp://bugs.debian.org/\fR> or by writing a mail to the Live Systems mailing list at <\fIdebian-live@lists.debian.org\fR>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>. diff --git a/system-build/manpages/lb_binary.1 b/system-build/manpages/lb_binary.1 new file mode 100644 index 0000000..0d07ace --- /dev/null +++ b/system-build/manpages/lb_binary.1 @@ -0,0 +1,32 @@ +.TH LIVE\-BUILD 1 2016\-07\-28 20160601 "Live Systems Project" + +.SH NAME +\fBlb binary\fR \- Complete the binary stage + +.SH SYNOPSIS +\fBlb binary\fR [\fIlive\-build options\fR] + +.SH DESCRIPTION +\fBlb binary\fR is a high\-level command (porcelain) of \fIlive\-build\fR(7), the live systems tool suite. +.PP +\fBlb binary\fR calls all necessary live\-build programs in the correct order to complete the binary stage. + +.SH OPTIONS +\fBlb binary\fR has no specific options but understands all generic live\-build options. See \fIlive\-build\fR(7) for a complete list of all generic live\-build options. + +.SH FILES +.IP "\fBnone\fR" 4 + +.SH SEE ALSO +\fIlive\-build\fR(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Live Systems project can be found on the homepage at <\fIhttp://live-systems.org/\fR> and in the manual at <\fIhttp://live-systems.org/manual/\fR>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in the Bug Tracking System at <\fIhttp://bugs.debian.org/\fR> or by writing a mail to the Live Systems mailing list at <\fIdebian-live@lists.debian.org\fR>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>. diff --git a/system-build/manpages/lb_bootstrap.1 b/system-build/manpages/lb_bootstrap.1 new file mode 100644 index 0000000..64bfb75 --- /dev/null +++ b/system-build/manpages/lb_bootstrap.1 @@ -0,0 +1,32 @@ +.TH LIVE\-BUILD 1 2016\-07\-28 20160601 "Live Systems Project" + +.SH NAME +\fBlb bootstrap\fR \- Complete the bootstrap stage + +.SH SYNOPSIS +\fBlb bootstrap\fR [\fIlive\-build options\fR] + +.SH DESCRIPTION +\fBlb bootstrap\fR is a high\-level command (porcelain) of \fIlive\-build\fR(7), the live systems tool suite. +.PP +\fBlb bootstrap\fR calls all necessary live\-build programs in the correct order to complete the bootstrap stage. + +.SH OPTIONS +\fBlb bootstrap\fR has no specific options but understands all generic live\-build options. See \fIlive\-build\fR(7) for a complete list of all generic live\-build options. + +.SH FILES +.IP "\fBnone\fR" 4 + +.SH SEE ALSO +\fIlive\-build\fR(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Live Systems project can be found on the homepage at <\fIhttp://live-systems.org/\fR> and in the manual at <\fIhttp://live-systems.org/manual/\fR>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in the Bug Tracking System at <\fIhttp://bugs.debian.org/\fR> or by writing a mail to the Live Systems mailing list at <\fIdebian-live@lists.debian.org\fR>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>. diff --git a/system-build/manpages/lb_build.1 b/system-build/manpages/lb_build.1 new file mode 100644 index 0000000..4253787 --- /dev/null +++ b/system-build/manpages/lb_build.1 @@ -0,0 +1,34 @@ +.TH LIVE\-BUILD 1 2016\-07\-28 20160601 "Live Systems Project" + +.SH NAME +\fBlb build\fR \- Complete the bootstrap, chroot, binary, and source stages + +.SH SYNOPSIS +\fBlb build\fR [\fIlive\-build options\fR] + +.SH DESCRIPTION +\fBlb build\fR is a high\-level command (porcelain) of \fIlive\-build\fR(7), the live systems tool suite. +.PP +\fBlb build\fR calls all necessary live\-build programs in the correct order to complete the bootstrap, chroot, binary, and source stages. + +.SH OPTIONS +\fBlb build\fR has no specific options but understands all generic live\-build options. See \fIlive\-build\fR(7) for a complete list of all generic live\-build options. + +.SH FILES +.\" FIXME +.IP "\fBauto/build\fR" 4 +.\" FIXME + +.SH SEE ALSO +\fIlive\-build\fR(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Live Systems project can be found on the homepage at <\fIhttp://live-systems.org/\fR> and in the manual at <\fIhttp://live-systems.org/manual/\fR>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in the Bug Tracking System at <\fIhttp://bugs.debian.org/\fR> or by writing a mail to the Live Systems mailing list at <\fIdebian-live@lists.debian.org\fR>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>. diff --git a/system-build/manpages/lb_chroot.1 b/system-build/manpages/lb_chroot.1 new file mode 100644 index 0000000..a921e87 --- /dev/null +++ b/system-build/manpages/lb_chroot.1 @@ -0,0 +1,32 @@ +.TH LIVE\-BUILD 1 2016\-07\-28 20160601 "Live Systems Project" + +.SH NAME +\fBlb chroot\fR \- Complete the chroot stage + +.SH SYNOPSIS +\fBlb chroot\fR [\fIlive\-build options\fR] + +.SH DESCRIPTION +\fBlb chroot\fR is a high\-level command (porcelain) of \fIlive\-build\fR(7), the live systems tool suite. +.PP +\fBlb chroot\fR calls all necessary live\-build programs in the correct order to complete the chroot stage. + +.SH OPTIONS +\fBlb chroot\fR has no specific options but understands all generic live\-build options. See \fIlive\-build\fR(7) for a complete list of all generic live\-build options. + +.SH FILES +.IP "\fBnone\fR" 4 + +.SH SEE ALSO +\fIlive\-build\fR(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Live Systems project can be found on the homepage at <\fIhttp://live-systems.org/\fR> and in the manual at <\fIhttp://live-systems.org/manual/\fR>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in the Bug Tracking System at <\fIhttp://bugs.debian.org/\fR> or by writing a mail to the Live Systems mailing list at <\fIdebian-live@lists.debian.org\fR>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>. diff --git a/system-build/manpages/lb_clean.1 b/system-build/manpages/lb_clean.1 new file mode 100644 index 0000000..adadafa --- /dev/null +++ b/system-build/manpages/lb_clean.1 @@ -0,0 +1,55 @@ +.TH LIVE\-BUILD 1 2016\-07\-28 20160601 "Live Systems Project" + +.SH NAME +\fBlb clean\fR \- Clean build directory + +.SH SYNOPSIS +\fBlb clean\fR [\fIlive\-build options\fR] + +.SH DESCRIPTION +\fBlb clean\fR is a high\-level command (porcelain) of \fIlive\-build\fR(7), the live systems tool suite. +.PP +.\" FIXME +\fBlb clean\fR 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. +.\" FIXME + +.SH OPTIONS +In addition to its specific options \fBlb clean\fR understands all generic live\-build options. See \fIlive\-build\fR(7) for a complete list of all generic live\-build options. +.PP +.\" FIXME +.IP "\fB\-\-all\fR" 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\fR" 4 +removes the cache directories. +.IP "\fB\-\-chroot\fR" 4 +unmounts and removes the chroot directory. +.IP "\fB\-\-binary\fR" 4 +removes all binary related caches, files, directories, and stages files. +.IP "\fB\-\-purge\fR" 4 +removes everything, including all caches. The config directory is kept. +.IP "\fB\-\-remove\fR" 4 +removes everything, including package cache but not stage cache. The config directory is kept. +.IP "\fB\-\-stage\fR" 4 +removes all stage files. +.IP "\fB\-\-source\fR" 4 +removes all source related caches, files, directories, and stage files. +.\" FIXME + +.SH FILES +.\" FIXME +.IP "\fBauto/clean\fR" 4 +.\" FIXME + +.SH SEE ALSO +\fIlive\-build\fR(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Live Systems project can be found on the homepage at <\fIhttp://live-systems.org/\fR> and in the manual at <\fIhttp://live-systems.org/manual/\fR>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in the Bug Tracking System at <\fIhttp://bugs.debian.org/\fR> or by writing a mail to the Live Systems mailing list at <\fIdebian-live@lists.debian.org\fR>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>. diff --git a/system-build/manpages/lb_config.1 b/system-build/manpages/lb_config.1 new file mode 100644 index 0000000..956d8ef --- /dev/null +++ b/system-build/manpages/lb_config.1 @@ -0,0 +1,477 @@ +.TH LIVE\-BUILD 1 2016\-07\-28 20160601 "Live Systems Project" + +.SH NAME +\fBlb config\fR \- Create config directory + +.SH SYNOPSIS +\fBlb config\fR [\fIlive\-build options\fR] +.PP +.\" FIXME +\fBlb config\fR +.br + [\fB\-\-apt\-ftp\-proxy\fR \fIURL\fR] +.br + [\fB\-\-apt\-http\-proxy\fR \fIURL\fR] +.br + [\fB\-\-apt\-indices\fR true|false] +.br + [\fB\-\-apt\-options\fR \fIOPTION\fR|"\fIOPTIONS\fR"] +.br + [\fB\-\-apt\-pipeline\fR \fIDEPTH\fR] +.br + [\fB\-\-apt\-recommends\fR true|false] +.br + [\fB\-\-apt\-secure\fR true|false] +.br + [\fB\-\-apt\-source\-archives\fR true|false] +.br + [\-a|\fB\-\-architectures\fR \fIARCHITECTURE\fR] +.br + [\-b|\fB\-\-binary\-images\fR iso|iso\-hybrid|netboot|tar|hdd] +.br + [\fB\-\-binary\-filesystem\fR fat16|fat32|ext2|ext3|ext4] +.br + [\fB\-\-bootappend\-install\fR \fIPARAMETER\fR|\fI"PARAMETERS"\fR] +.br + [\fB\-\-bootappend\-live\fR \fIPARAMETER\fR|\fI"PARAMETERS"\fR] +.br + [\fB\-\-bootloader\fR grub|grub2|syslinux] +.br + [\fB\-\-cache\fR true|false] +.br + [\fB\-\-cache\-indices\fR true|false] +.br + [\fB\-\-cache\-packages\fR true|false] +.br + [\fB\-\-cache\-stages\fR \fISTAGE\fR|\fI"STAGES"\fR] +.br + [\fB\-\-checksums\fR md5|sha1|sha256|none] +.br + [\fB\-\-compression\fR bzip2|gzip|lzip|none] +.br + [\fB\-\-config\fR \fIGIT_URL::GIT_ID\fR] +.br + [\fB\-\-build\-with\-chroot\fR true|false] +.br + [\fB\-\-chroot\-filesystem\fR ext2|ext3|ext4|squashfs|jffs2|none] +.br + [\fB\-\-clean\fR] +.br + [\-c|\fB\-\-conffile\fR \fIFILE\fR] +.br + [\fB\-\-debconf\-frontend\fR dialog|editor|noninteractive|readline] +.br + [\fB\-\-debconf\-priority\fR low|medium|high|critical] +.br + [\fB\-\-debian\-installer\fR true|cdrom|netinst|netboot|businesscard|live|false] +.br + [\fB\-\-debian\-installer\-distribution\fR daily|\fICODENAME\fR] +.br + [\fB\-\-debian\-installer\-preseedfile\fR \fIFILE\fR|\fIURL\fR] +.br + [\fB\-\-debian\-installer\-gui\fR true|false] +.br + [\fB\-\-debug\fR] +.br + [\-d|\fB\-\-distribution\fR \fICODENAME\fR] +.br + [\fB\-\-parent\-distribution\fR \fICODENAME\fR] +.br + [\fB\-\-parent\-debian\-installer\-distribution\fR \fICODENAME\fR] +.br + [\fB\-\-dump\fR] +.br + [\fB\-\-fdisk\fR fdisk|fdisk.dist] +.br + [\fB\-\-firmware\-binary true|false\fR] +.br + [\fB\-\-firmware\-chroot true|false\fR] +.br + [\fB\-\-force\fR] +.br + [\fB\-\-grub\-splash\fR \fIFILE\fR] +.br + [\fB\-\-gzip\-options\fR \fIOPTION\fR|"\fIOPTIONS\fR"] +.br + [\fB\-\-hooks\fR \fIFILE\fR] +.br + [\fB\-\-ignore\-system\-defaults\fR] +.br + [\fB\-\-initramfs\fR auto|none|live\-boot|casper] +.br + [\fB\-\-initramfs\-compression\fR bzip2|gzip|lzma] +.br + [\fB\-\-initsystem\fR sysvinit|runit|systemd|upstart|none] +.br + [\fB\-\-interactive\fR shell] +.br + [\fB\-\-isohybrid\-options\fR \fIOPTION\fR|"\fIOPTIONS\fR"] +.br + [\fB\-\-iso\-application\fR \fINAME\fR] +.br + [\fB\-\-iso\-preparer\fR \fINAME\fR] +.br + [\fB\-\-iso\-publisher\fR \fINAME\fR] +.br + [\fB\-\-iso\-volume\fR \fINAME\fR] +.br + [\fB\-\-jffs2\-eraseblock\fR \fISIZE\fR] +.br + [\fB\-\-keyring\-packages\fR \fIPACKAGE\fI|\fI"PACKAGES"\fR] +.br + [\-k|\fB\-\-linux\-flavours\fR \fIFLAVOUR\fR|\fI"FLAVOURS"\fR] +.br + [\fB\-\-linux\-packages\fR \fI"PACKAGES"\fR] +.br + [\fB\-\-losetup\fR losetup|losetup.orig] +.br + [\fB\-\-memtest\fR memtest86+|memtest86|none] +.br + [\-m|\fB\-\-parent\-mirror\-bootstrap\fR \fIURL\fR] +.br + [\fB\-\-parent\-mirror\-chroot\fR \fIURL\fR] +.br + [\fB\-\-parent\-mirror\-chroot\-security\fR \fIURL\fR] +.br + [\fB\-\-parent\-mirror\-chroot\-updates\fR \fIURL\fR] +.br + [\fB\-\-parent\-mirror\-chroot\-backports\fR \fIURL\fR] +.br + [\fB\-\-parent\-mirror\-binary\fR \fIURL\fR] +.br + [\fB\-\-parent\-mirror\-binary\-security\fR \fIURL\fR] +.br + [\fB\-\-parent\-mirror\-binary\-updates\fR \fIURL\fR] +.br + [\fB\-\-parent\-mirror\-binary\-backports\fR \fIURL\fR] +.br + [\fB\-\-parent\-mirror\-debian\-installer\fR \fIURL\fR] +.br + [\fB\-\-mirror\-bootstrap\fR \fIURL\fR] +.br + [\fB\-\-mirror\-chroot\fR \fIURL\fR] +.br + [\fB\-\-mirror\-chroot\-security\fR \fIURL\fR] +.br + [\fB\-\-mirror\-chroot\-updates\fR \fIURL\fR] +.br + [\fB\-\-mirror\-chroot\-backports\fR \fIURL\fR] +.br + [\fB\-\-mirror\-binary\fR \fIURL\fR] +.br + [\fB\-\-mirror\-binary\-security\fR \fIURL\fR] +.br + [\fB\-\-mirror\-binary\-updates\fR \fIURL\fR] +.br + [\fB\-\-mirror\-binary\-backports\fR \fIURL\fR] +.br + [\fB\-\-mirror\-debian\-installer\fR \fIURL\fR] +.br + [\fB\-\-mode\fR debian|progress-linux|ubuntu] +.br + [\fB\-\-system\fR live|normal] +.br + [\fB\-\-net\-root\-filesystem\fR nfs|cfs] +.br + [\fB\-\-net\-root\-mountoptions\fR \fIOPTIONS\fR] +.br + [\fB\-\-net\-root\-path\fR \fIPATH\fR] +.br + [\fB\-\-net\-root\-server\fR \fIIP\fR|\fIHOSTNAME\fR] +.br + [\fB\-\-net\-cow\-filesystem\fR nfs|cfs] +.br + [\fB\-\-net\-cow\-mountoptions\fR \fIOPTIONS\fR] +.br + [\fB\-\-net\-cow\-path\fR \fIPATH\fR] +.br + [\fB\-\-net\-cow\-server\fR \fIIP\fR|\fIHOSTNAME\fR] +.br + [\fB\-\-net\-tarball\fR true|false] +.br + [\fB\-\-quiet\fR] +.br + [\fB\-\-archive\-areas\fR \fIARCHIVE_AREA\fR|\fI"ARCHIVE_AREAS"\fR] +.br + [\fB\-\-parent\-archive\-areas\fR \fIPARENT_ARCHIVE_AREA\fR|\fI"PARENT_ARCHIVE_AREAS"\fR] +.br + [\fB\-\-security\fR true|false] +.br + [\fB\-\-source\fR true|false] +.br + [\-s|\fB\-\-source\-images\fR iso|netboot|tar|hdd] +.br + [\fB\-\-tasksel\fR apt|tasksel] +.br + [\fB\-\-templates\fR \fIPATH\fR] +.br + [\fB\-\-hdd\-size \fIMB\fR] +.br + [\fB\-\-updates\fR true|false] +.br + [\fB\-\-backports\fR true|false] +.br + [\fB\-\-verbose\fR] +.br + [\fB\-\-win32\-loader true|false] +.\" FIXME + +.SH DESCRIPTION +\fBlb config\fR is a high\-level command (porcelain) of \fIlive\-build\fR(7), the live systems tool suite. +.PP +.\" 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 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 +In addition to its specific options \fBlb config\fR understands all generic live\-build options. See \fIlive\-build\fR(7) for a complete list of all generic live\-build options. +.PP +.\" FIXME +.IP "\fB\-\-apt\-ftp\-proxy\fR \fIURL\fR" 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\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|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\-\-apt\-pipeline\fR \fIDEPTH\fR" 4 +sets the depth of the apt 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\fR true|false" 4 +defines if apt should install recommended packages automatically. By default, this is true. +.IP "\fB\-\-apt\-secure\fR true|false" 4 +defines if apt should check repository signatures. This is true by default. +.IP "\fB\-\-apt\-source\-archives\fR true|false" 4 +defines if deb-src entries should be included in the resulting live image or not, defaults to true. +.IP "\-a|\fB\-\-architectures\fR \fIARCHITECTURE\fR" 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 possible 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\fR 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\fR 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\fR \fIPARAMETER\fR|""\fIPARAMETERS\fR""" 4 +sets boot parameters specific to debian\-installer, if included. +.IP "\fB\-\-bootappend\-live\fR \fIPARAMETER\fR|""\fIPARAMETERS\fR""" 4 +sets boot parameters specific to debian\-live. A complete list of boot parameters can be found in the \fIlive\-boot\fR(7) and \fIlive\-config\fR(7) manual pages. +.IP "\fB\-\-bootloader\fR grub|grub2|syslinux" 4 +defines which bootloader is being 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\fR 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. +.IP "\fB\-\-cache\fR true|false" 4 +defines globally if any cache should be used at all. Different caches can be controlled through the their own options. +.IP "\fB\-\-cache\-indices\fR 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\fR true|false" 4 +defines if downloaded packages files should be cached which is true by default. Disabling it does save space consumption 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\fR true|false|\fISTAGE\fR|""\fISTAGES\fR""" 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\fR 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\-boot's 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\fR bzip2|gzip|lzip|none" 4 +defines the compression program to be used to compress tarballs. Defaults to gzip. +.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 whether live\-build should use the tools from within the chroot to build the binary image or not by using and including the host system's 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 and grub, and the auxiliary tools such as dosfstools, xorriso, squashfs-tools and others) do not \fBexactly\fR match what is present at build-time in the target distribution. Never do disable this option unless you are \fBexactly\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 chosen, 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 +minimizes config directory by automatically removing unused and thus empty subdirectories. +.IP "\-c|\fB\-\-conffile\fR \fIFILE\fR" 4 +using a user specified alternative configuration file in addition to the normally used one in the config directory. +.IP "\fB\-\-debconf\-frontend\fR dialog|editor|noninteractive|readline" 4 +defines what value the debconf frontend should be set to inside the chroot. Note that setting it to anything but noninteractive, which is the default, makes your build asking questions during the build. +.IP "\fB\-\-debconf\-priority\fR low|medium|high|critical" 4 +defines what value the debconf priority should be 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\fR 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 chosen, 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\fR daily|\fICODENAME\fR" 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\fR \fIFILE\fR|\fIURL\fR" 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\fR 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\fR" 4 +turn on debugging informational messages. +.IP "\-d|\fB\-\-distribution\fR \fICODENAME\fR" 4 +defines the distribution of the resulting live system. +.IP "\-d|\fB\-\-parent\-distribution\fR \fICODENAME\fR" 4 +defines the parent distribution for derivatives of the resulting live system. +.IP "\-d|\fB\-\-parent\-debian\-installer\-distribution\fR \fICODENAME\fR" 4 +defines the parent debian\-installer distribution for derivatives of the resulting live system. +.IP "\fB\-\-dump\fR" 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\fR 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\fR" 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\fR to clean up before re\-executing \fBlb build\fR. +.IP "\fB\-\-grub\-splash\fR \fIFILE\fR" 4 +defines the name of an optional to be included splash screen graphic for the grub bootloader. +.IP "\fB\-\-gzip\-options\fR \fIOPTION\fR|""\fIOPTIONS\fR""" 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\fR \fIFILE\fR" 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\fR" 4 +\fBlb config\fR by default reads system defaults from \fI/etc/live/build.conf\fR and \fI/etc/live/build/*\fR 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\fR 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\fR bzip2|gzip|lzma] +defines the compression program to be used to compress the initramfs. Defaults to gzip. +.IP "\fB\-\-interactive\fR 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\fR \fIOPTION\fR|""\fIOPTIONS\fR""" 4 +defines options to pass to isohybrid. +.IP "\fB\-\-iso\-application\fR \fINAME\fR" 4 +sets the APPLICATION field in the header of a resulting CD/DVD image and defaults to "Debian Live" in debian mode, and "Ubuntu Live" in ubuntu mode. +.IP "\fB\-\-iso\-preparer\fR \fINAME\fR" 4 +sets the PREPARER field in the header of a resulting CD/DVD image. By default this is set to "live\-build \fIVERSION\fR; http://packages.qa.debian.org/live\-build", where VERSION is expanded to the version of live\-build that was used to build the image. +.IP "\fB\-\-iso\-publisher\fR \fINAME\fR" 4 +sets the PUBLISHED field in the header of a resulting CD/DVD image. By default, this is set to 'Live Systems project; http:/live-systems.org/; 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\fR \fINAME\fR" 4 +sets the VOLUME field in the header of a resulting CD/DVD and defaults to '(\fIMODE\fR) (\fIDISTRIBUTION\fR) (\fIDATE\fR)' 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\fR \fISIZE\fR" 4 +sets the eraseblock size for a JFFS2 (Second Journaling 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\fR \fIPACKAGE\fI|""\fIPACKAGES\fR""" 4 +sets the keyring package or additional keyring packages. By default this is set to debian\-archive\-keyring. +.IP "\-k|\fB\-\-linux\-flavours\fR \fIFLAVOUR\fR|""\fIFLAVOURS\fR""" 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\fR ""\fIPACKAGES\fR""" 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\fR-\fIFLAVOUR\fR results in a valid package name (for debian e.g. linux\-image\-686\-pae). 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\fR 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\fR 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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://httpredir.debian.org/debian/' is used. +.IP "\fB\-\-parent\-mirror\-binary\-security\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 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\fR \fIURL\fR" 4 +sets the location of the derivatives security package mirror that should end up configured in the final image. +.IP "\fB\-\-mirror\-binary\-updates\fR \fIURL\fR" 4 +sets the location of the derivatives updates package mirror that should end up configured in the final image. +.IP "\fB\-\-mirror\-binary\-backports\fR \fIURL\fR" 4 +sets the location of the derivatives backports package mirror that should end up configured in the final image. +.IP "\fB\-\-mirror\-debian\-installer\fR \fIURL\fR" 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\fR debian|progress|ubuntu" 4 +defines a global mode to load project specific defaults. By default this is set to debian. +.IP "\fB\-\-system\fR live|normal" 4 +defines if the resulting system image should a live system or a normal, non-live system. +.IP "\fB\-\-net\-root\-filesystem\fR 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\fR \fIOPTIONS\fR" 4 +sets additional options for mounting the root filesystem in netboot images and is by default empty. +.IP "\fB\-\-net\-root\-path\fR \fIPATH\fR" 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 /srv/ubuntu-live when in ubuntu mode. +.IP "\fB\-\-net\-root\-server\fR \fIIP\fR|\fIHOSTNAME\fR" 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\fR nfs|cfs" 4 +defines the filesystem type for the copy\-on\-write layer and defaults to nfs. +.IP "\fB\-\-net\-cow\-mountoptions\fR \fIOPTIONS\fR" 4 +sets additional options for mounting the copy\-on\-write layer in netboot images and is by default empty. +.IP "\fB\-\-net\-cow\-path\fR \fIPATH\fR" 4 +defines the path to client writable filesystem. Anywhere that \fIclient_mac_address\fR 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\fR \fIIP\fR|\fIHOSTNAME\fR" 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\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 "\fB\-\-quiet\fR" 4 +reduces the verbosity of messages output by \fBlb build\fR. +.IP "\fB\-\-archive\-areas\fR \fIARCHIVE_AREA\fR|""\fIARCHIVE_AREAS\fR""" 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\fR \fIPARENT_ARCHIVE_AREA\fR|""\fIPARENT_ARCHIVE_AREAS\fR""" 4 +defines the archive areas for derivatives of the resulting live system. +.IP "\fB\-\-security\fR true|false" 4 +defines if the security repositories specified in the security mirror options should be used or not. +.IP "\fB\-\-source\fR 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\fR iso|netboot|tar|hdd" 4 +defines the image type for the source image. Default is tar. +.IP "\fB\-\-firmware\-binary\fR 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\fR 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\fR \fIPATH\fR" 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\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\-\-tasksel\fR apt|tasksel" 4 +selects which program is used to install tasks. By default, this is set to tasksel. +.IP "\fB\-\-templates\fR \fIPATH\fR" 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\fR 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\fR true|false" 4 +defines if debian updates package archives should be included in the image or not. +.IP "\fB\-\-backports\fR true|false" 4 +defines if debian backports package archives should be included in the image or not. +.IP "\fB\-\-verbose\fR" 4 +increases the verbosity of messages output by \fBlb build\fR. +.IP "\fB\-\-win32\-loader true|false" 4 +defines if win32\-loader should be included in the binary image or not. +.\" FIXME + +.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\fR becomes LB_APT_FTP_PROXY (the exception being internal options such as \fB\-\-debug\fR). 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\fR" 4 +.IP "\fB/etc/live/build.conf, /etc/live/build/*\fR" 4 +An optional, global configuration file for \fBlb config\fR 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\fR option. +.\" FIXME + +.SH SEE ALSO +\fIlive\-build\fR(7) +.PP +\fIlive\-boot\fR(7) +.PP +\fIlive\-config\fR(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Live Systems project can be found on the homepage at <\fIhttp://live-systems.org/\fR> and in the manual at <\fIhttp://live-systems.org/manual/\fR>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in the Bug Tracking System at <\fIhttp://bugs.debian.org/\fR> or by writing a mail to the Live Systems mailing list at <\fIdebian-live@lists.debian.org\fR>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>. diff --git a/system-build/manpages/lb_source.1 b/system-build/manpages/lb_source.1 new file mode 100644 index 0000000..f9d05f9 --- /dev/null +++ b/system-build/manpages/lb_source.1 @@ -0,0 +1,32 @@ +.TH LIVE\-BUILD 1 2016\-07\-28 20160601 "Live Systems Project" + +.SH NAME +\fBlb source\fR \- Complete the source stage + +.SH SYNOPSIS +\fBlb source\fR [\fIlive\-build options\fR] + +.SH DESCRIPTION +\fBlb source\fR is a high\-level command (porcelain) of \fIlive\-build\fR(7), the live systems tool suite. +.PP +\fBlb source\fR calls all necessary live\-build programs in the correct order to complete the source stage. + +.SH OPTIONS +\fBlb source\fR has no specific options but understands all generic live\-build options. See \fIlive\-build\fR(7) for a complete list of all generic live\-build options. + +.SH FILES +.IP "\fBnone\fR" 4 + +.SH SEE ALSO +\fIlive\-build\fR(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Live Systems project can be found on the homepage at <\fIhttp://live-systems.org/\fR> and in the manual at <\fIhttp://live-systems.org/manual/\fR>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in the Bug Tracking System at <\fIhttp://bugs.debian.org/\fR> or by writing a mail to the Live Systems mailing list at <\fIdebian-live@lists.debian.org\fR>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>. diff --git a/system-build/manpages/live-build.7 b/system-build/manpages/live-build.7 new file mode 100644 index 0000000..1734143 --- /dev/null +++ b/system-build/manpages/live-build.7 @@ -0,0 +1,231 @@ +.TH LIVE\-BUILD 7 2016\-07\-28 20160601 "Live Systems Project" + +.SH NAME +\fBlive\-build\fR \- the live systems tool suite + +.SH SYNOPSIS +.\" FIXME +\fBlb \fR\fICOMMAND\fR [\fB\-h|\-\-help\fR] [\fB\-u|\-\-usage\fR] [\fB\-v|\-\-version\fR] [\fB\-\-breakpoints\fR] [\fB\-\-conffile\fR] [\fB\-\-debug\fR] [\fB\-\-force\fR] [\fB\-\-quiet\fR] [\fB\-\-verbose\fR] +.\" FIXME + +.SH DESCRIPTION +.\" FIXME +live\-build is a set of scripts to build 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\fR is a name of a live\-build command (see below). +.PP +More documentation about how to use live\-build is available in the individual manpages for each helper and in the manual at <\fIhttp://live-systems.org/manual/\fR>. +.\" FIXME + +.SH OPTIONS +.\" FIXME +.SS Shared live\-build options +The following command line options are supported by all live\-build programs. +.IP "\fB-h, \-\-help\fR" 4 +display help and exit. +.IP "\fB-u, \-\-usage\fR" 4 +show usage and exit. +.IP "\fB-v, \-\-version\fR" 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\fR" 4 +run with breakpoints. +.IP "\fB\-\-conffile\fR" 4 +use custom configuration file. +.IP "\fB\-\-debug\fR" 4 +show debug information. +.IP "\fB\-\-force\fR" 4 +force helper execution, even if stage file exists. +.IP "\fB\-\-quiet\fR" 4 +be quiet. +.IP "\fB\-\-verbose\fR" 4 +be verbose. +.\" FIXME + +.SH LIVE\-BUILD COMMANDS +.\" FIXME +We divide live\-build into high level ("porcelain") commands and low level ("plumbing") commands. +.PP +Here is the complete list of all available live\-build commands. See their man +pages for additional documentation. +.\" FIXME + +.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\fR(1)" 4 +create configuration for live\-build +.IP "\fBlb_bootstrap\fR(1)" 4 +create the first stage by bootstrapping a basic debian system +.IP "\fBlb_chroot\fR(1)" 4 +create the second stage by customizing the chroot +.IP "\fBlb_binary\fR(1)" 4 +create the third stage by generating a binary image +.IP "\fBlb_source\fR(1)" 4 +create the optional fourth stage by generating a source image +.IP "\fBlb_clean\fR(1)" 4 +clean up system build directories +.SS Ancillary Commands +.IP "\fBlb\fR(1)" 4 +generic live\-build wrapper +.IP "\fBlb_build\fR(1)" 4 +alias for all stages +.IP "\fBlb_local\fR(1)" 4 +helper for using a local live\-build +.IP "\fBlb_testroot\fR(1)" 4 +ensure that a system is built as root +.\" FIXME + +.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\fR(1)" 4 +cache bootstrap stage +.IP "\fBlb_bootstrap_debootstrap\fR(1)" 4 +bootstrap a Debian system with debootstrap(8) +.SS Chroot commands +.IP "\fBlb_chroot_apt\fR(1)" 4 +manage /etc/apt/apt.conf +.IP "\fBlb_chroot_cache\fR(1)" 4 +cache chroot stage +.IP "\fBlb_chroot_debianchroot\fR(1)" 4 +manage /etc/debian_chroot +.IP "\fBlb_chroot_devpts\fR(1)" 4 +mount /dev/pts +.IP "\fBlb_chroot_dpkg\fR(1)" 4 +manage /sbin/dpkg +.IP "\fBlb_chroot_hacks\fR(1)" 4 +execute hacks in chroot +.IP "\fBlb_chroot_hostname\fR(1)" 4 +manage /bin/hostname +.IP "\fBlb_chroot_hosts\fR(1)" 4 +manage /etc/hosts +.IP "\fBlb_chroot_install\-packages\fR(1)" 4 +install queued packages into chroot +.IP "\fBlb_chroot_interactive\fR(1)" 4 +make build interactive +.IP "\fBlb_chroot_linux\-image\fR(1)" 4 +manage /etc/kernel\-img.conf +.IP "\fBlb_chroot_hooks\fR(1)" 4 +execute local hooks in chroot +.IP "\fBlb_chroot_local\-includes\fR(1)" 4 +copy local files into chroot +.IP "\fBlb_chroot_packages\fR(1)" 4 +queue install of packages into chroot +.IP "\fBlb_chroot_local\-patches\fR(1)" 4 +apply local patches against chroot +.IP "\fBlb_chroot_local\-preseed\fR(1)" 4 +use debconf local preseeding file +.IP "\fBlb_chroot_packagelists\fR(1)" 4 +queue install of package lists into chroot +.IP "\fBlb_chroot_proc\fR(1)" 4 +mount /proc +.IP "\fBlb_chroot_resolv\fR(1)" 4 +manage /etc/resolv.conf +.IP "\fBlb_chroot_selinuxfs\fR(1)" 4 +mount /selinux +.IP "\fBlb_chroot_archives\fR(1)" 4 +manage /etc/apt/sources.list +.IP "\fBlb_chroot_sysfs\fR(1)" 4 +mount /sys +.IP "\fBlb_chroot_sysv\-rc\fR(1)" 4 +manage /usr/sbin/policy\-rc.d +.IP "\fBlb_chroot_task\-lists\fR(1)" 4 +install task lists into chroot +.SS Binary commands +.IP "\fBlb_binary_chroot\fR(1)" 4 +copy chroot into chroot +.IP "\fBlb_binary_debian\-installer\fR(1)" 4 +install debian\-installer into binary +.IP "\fBlb_binary_disk\fR(1)" 4 +install disk information into binary +.IP "\fBlb_binary_grub\fR(1)" 4 +installs grub into binary +.IP "\fBlb_binary_grub2\fR(1)" 4 +installs grub2 into binary +.IP "\fBlb_binary_includes\fR(1)" 4 +copy files into binary +.IP "\fBlb_binary_iso\fR(1)" 4 +build iso binary image +.IP "\fBlb_binary_linux\-image\fR(1)" 4 +install linux\-image into binary +.IP "\fBlb_binary_local\-hooks\fR(1)" 4 +execute local hooks in binary +.IP "\fBlb_binary_local\-includes\fR(1)" 4 +copy files into binary +.IP "\fBlb_binary_local\-packagelists\fR(1)" 4 +install local package lists into binary +.IP "\fBlb_binary_manifest\fR(1)" 4 +create manifest +.IP "\fBlb_binary_checksums\fR(1)" 4 +create binary checksums (md5, sha1, and/or sha256) +.IP "\fBlb_binary_memtest\fR(1)" 4 +installs a memtest into binary +.IP "\fBlb_binary_net\fR(1)" 4 +build netboot binary image +.IP "\fBlb_binary_rootfs\fR(1)" 4 +build rootfs image +.IP "\fBlb_binary_syslinux\fR(1)" 4 +installs syslinux into binary +.IP "\fBlb_binary_tar\fR(1)" 4 +build harddisk binary image +.IP "\fBlb_binary_hdd\fR(1)" 4 +build binary hdd image +.IP "\fBlb_binary_win32\-loader\fR(1)" 4 +installs win32\-loader into binary +.SS Source commands +.IP "\fBlb_source_debian\fR(1)" 4 +download sources +.IP "\fBlb_source_debian\-live\fR(1)" 4 +copy debian\-live config into source +.IP "\fBlb_source_disk\fR(1)" 4 +install disk information into source +.IP "\fBlb_source_iso\fR(1)" 4 +build iso source image +.IP "\fBlb_source_checksums\fR(1)" 4 +create source checksums (md5, sha1, and/or sha256) +.IP "\fBlb_source_net\fR(1)" 4 +build source net image +.IP "\fBlb_source_tar\fR(1)" 4 +build source tarball +.IP "\fBlb_source_hdd\fR(1)" 4 +build source hdd image +.\" FIXME + +.SH CONFIG FILES +.\" FIXME +Many live\-build commands make use of files in the \fIconfig/\fR directory to control what they do. Besides the common \fIconfig/common\fR, 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 +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. +.\" FIXME + +.SH FILES +.IP "\fB/etc/live/build.conf\fR" 4 +.IP "\fB/etc/live/build/*\fR" 4 + +.SH SEE ALSO +\fIlive\-boot\fR(7) +.PP +\fIlive\-config\fR(7) +.PP +This program is a part of live\-build. + +.SH HOMEPAGE +More information about live\-build and the Live Systems project can be found on the homepage at <\fIhttp://live-systems.org/\fR> and in the manual at <\fIhttp://live-systems.org/manual/\fR>. + +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-build package in the Bug Tracking System at <\fIhttp://bugs.debian.org/\fR> or by writing a mail to the Live Systems mailing list at <\fIdebian-live@lists.debian.org\fR>. + +.SH AUTHOR +live\-build was written by Daniel Baumann <\fImail@daniel-baumann.ch\fR>. |