X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=manpages%2Fde%2Flive-boot.de.7;h=124da93bf3708f4ca3d28dbcaabd89ee84411f49;hb=599bb4e4402769547c1a3134402013941cb5fa12;hp=3268b42bf0d2f1c609252fb715111358993d0a6c;hpb=b5678340476350707c088253fe5ceee2dccda096;p=live-boot-grml.git diff --git a/manpages/de/live-boot.de.7 b/manpages/de/live-boot.de.7 index 3268b42..124da93 100644 --- a/manpages/de/live-boot.de.7 +++ b/manpages/de/live-boot.de.7 @@ -3,7 +3,7 @@ .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* -.TH LIVE\-BOOT 7 2012\-04\-08 3.0~a26\-1 "Debian Live Project" +.TH LIVE\-BOOT 7 2012\-05\-24 3.0~a27\-1 "Debian Live Project" .SH NAME \fBlive\-boot\fP \- System Boot Scripts @@ -48,10 +48,10 @@ files. Those files can be placed either in the root filesystem itself .\" FIXME \fBlive\-boot\fP currently features the following parameters. .IP \fBaccess\fP=\fIACCESS\fP 4 -Set the accessibility level for physically or visually impared users. ACCESS -must be one of v1, v2, v3, m1, or m2. v1=lesser visual impairment, -v2=moderate visual impairment, v3=blindness, m1=minor motor difficulties, -m2=moderate motor difficulties. +Set the accessibility level for physically or visually impaired +users. ACCESS must be one of v1, v2, v3, m1, or m2. v1=lesser visual +impairment, v2=moderate visual impairment, v3=blindness, m1=minor motor +difficulties, m2=moderate motor difficulties. .IP \fBconsole\fP=\fITTY,SPEED\fP 4 Set the default console to be used with the "live\-getty" option. Example: "console=ttyS0,115200" @@ -71,7 +71,7 @@ correctly because it does not require networking afterwards and the system operates faster once booted because it does not require to contact the server anymore. .br -Due to current limitations in busyboxs wget and DNS resolution, an URL can +Due to current limitations in busybox's wget and DNS resolution, an URL can not contain a hostname but an IP only. .br Not working: http://example.com/path/to/your_filesystem.squashfs @@ -95,6 +95,10 @@ Target Lun 0 Path=,Type=fileio,IOMode=ro # If you want to boot multiple machines you might want to look at tuning some parameters like # Wthreads or MaxConnections +.IP \fBfindiso\fP=\fI/PATH/TO/IMAGE\fP 4 +Look for the specified ISO file on all disks where it usually looks for the +\&.squashfs file (so you don't have to know the device name as in +fromiso=....). .IP \fBfromiso\fP=\fI/PATH/TO/IMAGE\fP 4 Allows to use a filesystem from within an iso image that's available on live\-media. @@ -157,9 +161,9 @@ This parameter disables the default disabling of filesystem checks in /etc/fstab. If you have static filesystems on your harddisk and you want them to be checked at boot time, use this parameter, otherwise they are skipped. -.IP \fBnopersistent\fP 4 -disables the "persistent" feature, useful if the bootloader (like syslinux) -has been installed with persistent enabled. +.IP \fBnopersistence\fP 4 +disables the "persistence" feature, useful if the bootloader (like syslinux) +has been installed with persistence enabled. .IP \fBnoprompt\fP 4 Do not prompt to eject the CD or remove the USB flash drive on reboot. .IP \fBnoprompt\fP=\fITYPE\fP 4 @@ -172,53 +176,54 @@ 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 4 -live\-boot will probe devices for persistent media. These can be partitions +.IP \fBpersistence\fP 4 +live\-boot will probe devices for persistence 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 +completely customized (see \fIlive\-persistence.conf\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 "\fBpersistence\-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 +when probing devices for persistence 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 +.IP \fBpersistence\-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 +persistence 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 "\fBpersistence\-method\fP=\fITYPE1\fP,\fITYPE2\fP ... \fITYPEn\fP" 4 +This option determines which types of persistence 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 +.IP \fBpersistence\-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, +.IP \fBpersistence\-read\-only\fP 4 +Filesystem changes are not saved back to persistence 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 +.IP "\fBpersistence\-storage\fP=\fITYPE1\fP,\fITYPE2\fP ... \fITYPEn\fP" 4 +This option determines which types of persistence storage to consider when +probing for persistence 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 +.IP \fBpersistence\-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 +use for the above mentioned persistence 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. +persistence storage choices. .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. @@ -276,12 +281,12 @@ directory with a tmpfs on the original path. .IP \fB/etc/live/boot.d/*.conf\fP 4 .IP \fBlive/boot.conf\fP 4 .IP \fBlive/boot.d/*.conf\fP 4 -.IP \fBlive.persist\fP 4 +.IP \fBlive\-persistence.conf\fP 4 .SH "SEE ALSO" \fIlive\-snapshot\fP(1) .PP -\fIlive.persist\fP(5) +\fIlive\-persistence.conf\fP(5) .PP \fIlive\-build\fP(7) .PP