diff options
author | Daniel Baumann <mail@daniel-baumann.ch> | 2014-08-27 23:57:58 +0200 |
---|---|---|
committer | Daniel Baumann <mail@daniel-baumann.ch> | 2014-08-28 01:01:31 +0200 |
commit | c1d85328f8e8735a26f78227f986eec1f83431d9 (patch) | |
tree | be2566f066d97f967d544e9015ecb87bc2f43d8e /manpages/de/live-build.de.7 | |
parent | bc50443cf043616c7087f383e11bf85cd233c54e (diff) | |
download | vyos-live-build-c1d85328f8e8735a26f78227f986eec1f83431d9.tar.gz vyos-live-build-c1d85328f8e8735a26f78227f986eec1f83431d9.zip |
Restoring old manpages since we're back to the non-python implementation (Closes: #745134).
Diffstat (limited to 'manpages/de/live-build.de.7')
-rw-r--r-- | manpages/de/live-build.de.7 | 286 |
1 files changed, 286 insertions, 0 deletions
diff --git a/manpages/de/live-build.de.7 b/manpages/de/live-build.de.7 new file mode 100644 index 000000000..a48d9b251 --- /dev/null +++ b/manpages/de/live-build.de.7 @@ -0,0 +1,286 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BUILD 7 2014\-08\-28 4.0~alpha39\-1 "Live Systems Project" + +.SH NAME +\fBlive\-build\fP \- the live systems 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 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\-systems.org/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_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 +.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 Live Systems project can be found +on the homepage at <\fIhttp://live\-systems.org/\fP> and in the manual +at <\fIhttp://live\-systems.org/manual/\fP>. + +.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/\fP> or by +writing a mail to the Live Systems mailing list at +<\fIdebian\-live@lists.debian.org\fP>. + +.SH AUTHOR +live\-build was written by Daniel Baumann +<\fImail@daniel\-baumann.ch\fP>. |