X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=manpages%2Fde%2Flive-boot.de.7;h=5a8fb86fdabf3e0abd16e01113ce5f90a685011d;hb=9c9a90ef6364a1b6ada490a6f7fac67570778b47;hp=9bc588e15af4960842a4bc8d3fed0d7fbd4fa018;hpb=e66f79476042794195978ee641aa7ea0d9ca6e0a;p=live-boot-grml.git diff --git a/manpages/de/live-boot.de.7 b/manpages/de/live-boot.de.7 index 9bc588e..5a8fb86 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 24.05.2010 2.0~a1 "Debian Live Projekt" +.TH LIVE\-BOOT 7 24.12.2010 2.0.14 "Debian Live Projekt" .SH NAME \fBlive\-boot\fP \- System Boot Skripte @@ -38,8 +38,8 @@ see below. .SS Konfigurationsdateien \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.conf.d/), or on the live media -(live/boot.conf, live/boot.conf.d/). +(/etc/live/boot.conf, /etc/live/boot.d/), or on the live media +(live/boot.conf, live/boot.d/). .SH OPTIONEN .\" FIXME @@ -54,10 +54,22 @@ Set the default console to be used with the "live\-getty" option. Example: "console=ttyS0,115200" .IP \fBdebug\fP 4 Makes initramfs boot process more verbose. +.br +Use: debug=1 +.br +Without setting debug to a value the messages may not be shown. .IP \fBfetch\fP=\fIURL\fP 4 -Another form of netboot by downloading a squashfs image from a given url, -copying to ram and booting it. Due to current limitations in busyboxs wget -and DNS resolution, an URL can not contain a hostname but an IP only. +.IP \fBhttpfs\fP=\fIURL\fP 4 +Another form of netboot by downloading a squashfs image from a given url. +The fetch method copies the image to ram and the httpfs method uses fuse and +httpfs2 to mount the image in place. Copying to ram requires more memory and +might take a long time for large images. However, it is more likely to work +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 +not contain a hostname but an IP only. .br Not working: http://example.com/path/to/your_filesystem.squashfs .br @@ -66,8 +78,23 @@ Working: http://1.2.3.4/path/to/your_filesystem.squashfs Also note that therefore it's currently not possible to fetch an image from a namebased virtualhost of an httpd if it is sharing the ip with the main httpd instance. -.IP "\fBhostname\fP=\fIHOSTNAME\fP, \fBusername\fP=\fIUSER\fP, \fBuserfullname\fP=\fIUSERFULLNAME\fP" 4 -Those parameters lets you override values read from the config file. +.br +You may also use the live iso image in place of the squashfs image. +.IP \fBiscsi\fP=\fIserver\-ip[,server\-port];target\-name\fP 4 +Boot from an iSCSI target that has an iso or disk live image as one of its +LUNs. The specified target is searched for a LUN which looks like a live +media. If you use the \fBiscsitarget\fP software iSCSI target solution which is +packaged in Debian your ietd.conf might look like this: +.br +# The target\-name you specify in the iscsi= parameter +.br +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 \fBfromiso\fP=\fI/PATH/TO/IMAGE\fP 4 +Allows to use a filesystem from within an iso image that's available on +live\-media. .IP \fBignore_uuid\fP 4 Do not check that any UUID embedded in the initramfs matches the discovered medium. live\-boot may be told to generate a UUID by setting @@ -86,16 +113,6 @@ boot param specification If this variable is set, dhcp and static configuration are just skipped and the system will use the (must be) media\-preconfigured /etc/network/interfaces instead. -.IP "{\fBkeyb\fP|\fBkbd\-chooser/method\fP}=\fIKEYBOARD\fP, {\fBklayout\fP|\fBconsole\-setup/layoutcode\fP}=\fILAYOUT\fP, {\fBkvariant\fP|\fBconsole\-setup/variantcode\fP}=\fIVARIANT\fP, {\fBkmodel\fP\fI|\fP\fBconsole\-setup/modelcode\fP}=\fICODE\fP, \fBkoptions\fP=\fIOPTIONS\fP" 4 -Configure the running keyboard as specified, if this one misses live\-boot -behaves as if "keyb=us" was specified. It will be interfered from "locale=" -if locale is only 2 lowecase letters as a special case. You could also -specify console layout, variant, code, and options (no defaults). -.IP \fBlive\-getty\fP 4 -This changes the auto\-login on virtual terminals to use the (experimental) -live\-getty code. With this option set the standard kernel argument -"console=" is parsed and if a serial console is specified then live\-getty is -used to autologin on the serial console. .IP {\fBlive\-media\fP|\fBbootfrom\fP}=\fIDEVICE\fP 4 If you specify one of this two equivalent forms, live\-boot will first try to find this device for the "/live" directory where the read\-only root @@ -122,14 +139,6 @@ accordingly. .IP \fBlive\-media\-timeout\fP=\fISECONDS\fP 4 Set the timeout in seconds for the device specified by "live\-media=" to become ready before giving up. -.IP {\fBlocale\fP|\fBdebian\-installer/locale\fP}=\fILOCALE\fP 4 -Configure the running locale as specified, if not present the live\-media -rootfs configured locale will be used and if also this one misses live\-boot -behave as "locale=en_US.UTF\-8" was specified. If only 2 lowercase letter are -specified (like "it"), the "maybe wanted" locale is generated (like -en:EN.UTF\-8), in this case if also "keyb=" is unspecified is set with those -2 lowercase letters (keyb=us). Beside that facility, only UTF8 locales are -supported by live\-boot. .IP \fBmodule\fP=\fINAME\fP 4 Instead of using the default optional file "filesystem.module" (see below) another file could be specified without the extension ".module"; it should @@ -140,12 +149,6 @@ This tells live\-boot to perform a network mount. The parameter "nfsroot=" filesystem. With no args, will try cifs first, and if it fails nfs. .IP \fBnfsopts\fP= 4 This lets you specify custom nfs options. -.IP \fBnoautologin\fP 4 -This parameter disables the automatic terminal login only, not touching -gdk/kdm. -.IP \fBnoxautologin\fP 4 -This parameter disables the automatic login of gdm/kdm only, not touching -terminals. .IP \fBnofastboot\fP 4 This parameter disables the default disabling of filesystem checks in /etc/fstab. If you have static filesystems on your harddisk and you want @@ -156,30 +159,33 @@ disables the "persistent" feature, useful if the bootloader (like syslinux) has been installed with persistent enabled. .IP \fBnoprompt\fP 4 Do not prompt to eject the CD or remove the USB flash drive on reboot. -.IP \fBnosudo\fP 4 -This parameter disables the automatic configuration of sudo. .IP \fBswapon\fP 4 This parameter enables usage of local swap partitions. -.IP \fBnouser\fP 4 -This parameter disables the creation of the default user completely. -.IP \fBnoxautoconfig\fP 4 -This parameter disables Xorg auto\-reconfiguration at boot time. This is -valuable if you either do the detection on your own, or, if you want to ship -a custom, premade xorg.conf in your live system. -.IP \fBpersistent\fP[=nofiles] 4 +.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. 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. +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\-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\-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. @@ -198,11 +204,6 @@ installation. .IP \fBsilent\fP 4 If you boot with the normal quiet parameter, live\-boot hides most messages of its own. When adding silent, it hides all. -.IP \fBtextonly\fP 4 -Start up to text\-mode shell prompts, disabling the graphical user interface. -.IP \fBtimezone\fP=\fITIMEZONE\fP 4 -By default, timezone is set to UTC. Using the timezone parameter, you can -set it to your local zone, e.g. Europe/Zurich. .IP \fBtodisk\fP=\fIDEVICE\fP 4 Adding this parameter, live\-boot will try to copy the entire read\-only media to the specified device before mounting the root filesystem. It probably @@ -214,17 +215,9 @@ Adding this parameter, live\-boot will try to copy the whole read\-only media to the computer's RAM before mounting the root filesystem. This could need a lot of ram, according to the space used by the read\-only media. .IP \fBunion\fP=aufs|unionfs 4 +.\" FIXME By default, live\-boot uses aufs. With this parameter, you can switch to unionfs. -.IP \fButc\fP=yes|no 4 -By default, Debian systems do assume that the hardware clock is set to -UTC. You can change or explicitly set it with this parameter. -.IP \fBxdebconf\fP 4 -Uses xdebconfigurator, if present on the rootfs, to configure X instead of -the standard procedure (experimental). -.IP \fBxvideomode\fP=\fIRESOLUTION\fP 4 -.\" FIXME -Doesn't do xorg autodetection, but enforces a given resolution. .\" FIXME .SH "FILES (old)" @@ -254,16 +247,16 @@ directory with a tmpfs on the original path. .SH DATEIEN .IP \fB/etc/live/boot.conf\fP 4 -.IP \fB/etc/live/boot.conf.d/\fP 4 +.IP \fB/etc/live/boot.d/\fP 4 .IP \fBlive/boot.conf\fP 4 -.IP \fBlive/boot.conf.d/\fP 4 +.IP \fBlive/boot.d/\fP 4 .SH "SIEHE AUCH" \fIlive\-snapshot\fP(1) .PP -\fIlive\-config\fP(7) +\fIlive\-build\fP(7) .PP -\fIlive\-helper\fP(7) +\fIlive\-config\fP(7) .SH HOMEPAGE Weitere Informationen ueber live\-boot und das Debian Live Projekt koennen