X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=manpages%2Fde%2Flive-boot.de.7;h=ad922e51b4424c513b726f0a19f68391e45d1be8;hb=d0610b388dde7a4368580b60c690d72fb3f72637;hp=a73d1eaf9986059cca0c1bf689d8720a2c90c6bd;hpb=29b9619df52491cab5ef2b9783396b9150534e38;p=live-boot-grml.git diff --git a/manpages/de/live-boot.de.7 b/manpages/de/live-boot.de.7 index a73d1ea..ad922e5 100644 --- a/manpages/de/live-boot.de.7 +++ b/manpages/de/live-boot.de.7 @@ -3,14 +3,14 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH LIVE\-BOOT 7 11.06.2011 3.0~a18 "Debian Live Projekt" +.TH LIVE\-BOOT 7 2012\-04\-08 3.0~a26\-1 "Debian Live Project" .SH NAME -\fBlive\-boot\fP \- System Boot Skripte +\fBlive\-boot\fP \- System Boot Scripts -.SH BESCHREIBUNG -\fBlive\-config\fP enthaelt die Skripte welche ein Debian Live System waehrend -des Startvorganes (early userspace) konfigurieren. +.SH DESCRIPTION +\fBlive\-boot\fP contains the scripts that configure a Debian Live system during +the boot process (early userspace). .PP .\" FIXME live\-boot is a hook for the initramfs\-tools, used to generate a initramfs @@ -24,24 +24,27 @@ directory where a root filesystems (often a compressed filesystem image like squashfs) is stored. If found, it will create a writable environment, using aufs, for Debian like systems to boot from. -.SH KONFIGURATION -\fBlive\-boot\fP kann durch Boot Parameter oder durch Konfigurationsdateien -konfiguriert werden. +.SH CONFIGURATION +\fBlive\-boot\fP can be configured through a boot parameter or a configuration +file. +.PP +To configure the live\-boot parameters used by default in a live image, see +the \-\-bootappend\-live option in the \fIlb_config\fP(1) manual page. -.SS "Kernel Parameter" -\fBlive\-boot\fP ist nur dann aktiv, wenn 'boot=live' als Kernel Parameter -benutzt wird. +.SS "Kernel Parameters" +\fBlive\-boot\fP is only activated if 'boot=live' was used as a kernel +parameter. .PP In addition, there are some more boot parameters to influence the behaviour, see below. -.SS Konfigurationsdateien +.SS "Configuration Files" \fBlive\-boot\fP can be configured (but not activated) through configuration files. Those files can be placed either in the root filesystem itself -(/etc/live/boot.conf, /etc/live/boot.d/), or on the live media -(live/boot.conf, live/boot.d/). +(/etc/live/boot.conf, /etc/live/boot.d/*.conf), or on the live media +(live/boot.conf, live/boot.d/*.conf). -.SH OPTIONEN +.SH OPTIONS .\" FIXME \fBlive\-boot\fP currently features the following parameters. .IP \fBaccess\fP=\fIACCESS\fP 4 @@ -169,38 +172,53 @@ default of mount applies (currently 50% of available RAM). Note that this option has no currently no effect when booting with toram. .IP \fBswapon\fP 4 This parameter enables usage of local swap partitions. -.IP \fBpersistent\fP[={nofiles|cryptsetup}] 4 -live\-boot will look for persistent and snapshot partitions or files labeled -"live\-rw", "home\-rw", and files called "live\-sn*", "home\-sn*" and will try -to, in order: mount as /cow the first, mount the second in /home, and just -copy the contents of the latter in appropriate locations -(snapshots). Snapshots will be tried to be updated on reboot/shutdown. Look -at live\-snapshot(1) for more informations. -.br -If "nofiles" is specified, only filesystems with matching labels will be -searched; no filesystems will be traversed looking for archives or image -files. This results in shorter boot times. -.br -If "cryptsetup" is specified, filesystems stored on Luks\-encrypted devices -will be considered as well as others when searching for a persistence -filesystem; the user will be prompted for any needed decryption passphrase. +.IP \fBpersistent\fP 4 +live\-boot will probe devices for persistent media. These can be partitions +(with the correct GPT name), filesystems (with the correct label) or +image/archive files (with the correct file name). Overlays are labeled/named +either "full\-ov", which will be mounted on /, or "custom\-ov", which can be +completely customized (see \fIlive.persist\fP(5)); snapshots are labeled/named +either "live\-sn" or "home\-sn" and will be extracted into / or /home, +respectively (see \fIlive\-snapshot\fP(1) for more information). The order these +are handled are: full\-ov, custom\-ov, live\-sn, home\-sn. Overlay image files +and snapshot archive files have extensions which determines their filesystem +or archive type, e.g. "custom\-ov.ext4" and "\home\-sn.squashfs". +.IP "\fBpersistent\-encryption\fP=\fITYPE1\fP,\fITYPE2\fP ... \fITYPEn\fP" 4 +This option determines which types of encryption that we allow to be used +when probing devices for persistent media. If "none" is in the list, we +allow unencrypted media; if "luks" is in the list, we allow LUKS\-encrypted +media. Whenever a device containing encrypted media is probed the user will +be prompted for the passphrase. The default value is "none". +.IP \fBpersistent\-media\fP={\fIremovable\fP|\fIremovable\-usb\fP} 4 +If you specify the keyword 'removable', live\-boot will try to find +persistent and snapshot partitions on removable media only. Note that if you +want to further restrict the media to usb mass storage only, you can use the +\&'removable\-usb' keyword. +.IP "\fBpersistent\-method\fP=\fITYPE1\fP,\fITYPE2\fP ... \fITYPEn\fP" 4 +This option determines which types of persistent media we allow. If +"overlay" is in the list, we consider overlays (i.e. "live\-rw" and +"home\-rw"); if "snapshot" is in the list, we consider snapshots +(i.e. "live\-sn" and "home\-sn"). The default is "overlay,snapshot". .IP \fBpersistent\-path\fP=\fIPATH\fP 4 live\-boot will look for persistency files in the root directory of a partition, with this parameter, the path can be configured so that you can have multiple directories on the same partition to store persistency files. +.IP \fBpersistent\-read\-only\fP 4 +Filesystem changes are not saved back to persistent media. In particular, +overlays and netboot NFS mounts are mounted read\-only, and snapshots are not +resynced on shutdown. +.IP "\fBpersistent\-storage\fP=\fITYPE1\fP,\fITYPE2\fP ... \fITYPEn\fP" 4 +This option determines which types of persistent storage to consider when +probing for persistent media. If "filesystem" is in the list, filesystems +with matching labels will be used; if "file" is in the list, all filesystems +will be probed for archives and image files with matching filenames. The +default is "file,filesystem". .IP \fBpersistent\-subtext\fP=\fISUFFIX\fP 4 Add a suffix when searching for the image filenames or partition labels to use for the above mentioned persistent feature, the SUFFIX will be added after a dash (e.g.: "live\-sn" would transform to "live\-sn\-SUFFIX"). This is handy to test multiple live\-boot based live\-systems with different persistent storage choices. -.IP {\fBpreseed/file\fP|\fBfile\fP}=\fIFILE\fP 4 -A path to a file present on the rootfs could be used to preseed debconf -database. -.IP \fBpackage/question\fP=\fIVALUE\fP 4 -All debian installed packages could be preseeded from command\-line that way, -beware of blanks spaces, they will interfere with parsing, use a preseed -file in this case. .IP \fBquickreboot\fP 4 This option causes live\-boot to reboot without attempting to eject the media and without asking the user to remove the boot media. @@ -253,15 +271,18 @@ as web caches and temporary files (like e.g. /tmp and .mozilla) which are regenerated each time. This is achieved by bind mounting each listed directory with a tmpfs on the original path. -.SH DATEIEN +.SH FILES .IP \fB/etc/live/boot.conf\fP 4 -.IP \fB/etc/live/boot.d/\fP 4 +.IP \fB/etc/live/boot.d/*.conf\fP 4 .IP \fBlive/boot.conf\fP 4 -.IP \fBlive/boot.d/\fP 4 +.IP \fBlive/boot.d/*.conf\fP 4 +.IP \fBlive.persist\fP 4 -.SH "SIEHE AUCH" +.SH "SEE ALSO" \fIlive\-snapshot\fP(1) .PP +\fIlive.persist\fP(5) +.PP \fIlive\-build\fP(7) .PP \fIlive\-config\fP(7) @@ -269,17 +290,16 @@ directory with a tmpfs on the original path. \fIlive\-tools\fP(7) .SH HOMEPAGE -Weitere Informationen ueber live\-boot und das Debian Live Projekt koennen -auf der Homepage unter <\fIhttp://live.debian.net/\fP> und im Handbuch -unter <\fIhttp://live.debian.net/manual/\fP> gefunden werden. +More information about live\-boot 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 FEHLER -Fehler koennen durch Einreichen eines Fehlerberichtes fuer das live\-boot -Paket im Debian Bug Tracking System unter -<\fIhttp://bugs.debian.org/\fP> oder durch Senden einer E\-Mail an die -Debian Live Mailing Liste unter <\fIdebian\-live@lists.debian.org\fP> -(englischsprachig) mitgeteilt werden. +.SH BUGS +Bugs can be reported by submitting a bugreport for the live\-boot 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 AUTOR -live\-boot wurde von Daniel Baumann <\fIdaniel@debian.org\fP> fuer das -Debian Projekt geschrieben. +.SH AUTHOR +live\-boot was written by Daniel Baumann <\fIdaniel@debian.org\fP> for +the Debian project.