X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=manpages%2Fen%2Flive-boot.7;h=ed66ad725d8aae9da61aed6eacd44fbe24d99582;hb=d0610b388dde7a4368580b60c690d72fb3f72637;hp=4cfcc948c41640a520270b892aea72a513fd884c;hpb=1c4b879455daf67dd0f873c753f3f963d63f1c8b;p=live-boot-grml.git diff --git a/manpages/en/live-boot.7 b/manpages/en/live-boot.7 index 4cfcc94..ed66ad7 100644 --- a/manpages/en/live-boot.7 +++ b/manpages/en/live-boot.7 @@ -1,4 +1,4 @@ -.TH LIVE\-BOOT 7 2011\-11\-04 3.0~a22-1 "Debian Live Project" +.TH LIVE\-BOOT 7 2012\-04\-08 3.0~a26-1 "Debian Live Project" .SH NAME \fBlive\-boot\fR \- System Boot Scripts @@ -23,7 +23,7 @@ To configure the live\-boot parameters used by default in a live image, see the In addition, there are some more boot parameters to influence the behaviour, see below. .SS Configuration Files -\fBlive\-boot\fR 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/). +\fBlive\-boot\fR 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/*.conf), or on the live media (live/boot.conf, live/boot.d/*.conf). .SH OPTIONS \fBlive\-boot\fR currently features the following parameters. @@ -107,7 +107,7 @@ This parameters allows to set a custom ramdisk size (it's the '\-o size' option .IP "\fBswapon\fR" 4 This parameter enables usage of local swap partitions. .IP "\fBpersistent\fR" 4 -live\-boot will probe filesystems for persistent media. These can either be the filesystems themselves, if labeled correctly, or image/archive files, if named correctly. Overlays are labeled/named either "live\-rw" or "home\-rw" and will be mounted on / or /home, respectively; snapshots are labeled/named either "live\-sn" or "home\-sn" and will be extracted into / or /home, respectively (see live\-snapshot(1) for more information). Overlays are mounted before snapshots are extracted, and for both overlays and snapshots, "live\-*" are handled before "home\-*". Overlay image files and snapshot archive files have extensions which determines their filesystem or archive type, e.g. "live\-rw.ext3" and "\home\-sn.squashfs". +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\fR(5)); snapshots are labeled/named either "live\-sn" or "home\-sn" and will be extracted into / or /home, respectively (see \fIlive\-snapshot\fR(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\fR=\fITYPE1\fR,\fITYPE2\fR ... \fITYPEn\fR" 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\fR={\fIremovable\fR|\fIremovable\-usb\fR}" 4 @@ -116,14 +116,12 @@ If you specify the keyword 'removable', live\-boot will try to find persistent a 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\fR=\fIPATH\fR" 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\fR" 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\fR=\fITYPE1\fR,\fITYPE2\fR ... \fITYPEn\fR" 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\fR=\fISUFFIX\fR" 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\fR|\fBfile\fR}=\fIFILE\fR" 4 -A path to a file present on the rootfs could be used to preseed debconf database. -.IP "\fBpackage/question\fR=\fIVALUE\fR" 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\fR" 4 This option causes live\-boot to reboot without attempting to eject the media and without asking the user to remove the boot media. .IP "\fBshowmounts\fR" 4 @@ -152,13 +150,16 @@ This saves expensive writes and speeds up operations on volatile data such as we .SH FILES .IP "\fB/etc/live/boot.conf\fR" 4 -.IP "\fB/etc/live/boot.d/\fR" 4 +.IP "\fB/etc/live/boot.d/*.conf\fR" 4 .IP "\fBlive/boot.conf\fR" 4 -.IP "\fBlive/boot.d/\fR" 4 +.IP "\fBlive/boot.d/*.conf\fR" 4 +.IP "\fBlive.persist\fR" 4 .SH SEE ALSO \fIlive\-snapshot\fR(1) .PP +\fIlive.persist\fR(5) +.PP \fIlive\-build\fR(7) .PP \fIlive\-config\fR(7)