diff options
Diffstat (limited to 'manpages/de/live-boot.de.7')
| -rw-r--r-- | manpages/de/live-boot.de.7 | 282 |
1 files changed, 282 insertions, 0 deletions
diff --git a/manpages/de/live-boot.de.7 b/manpages/de/live-boot.de.7 new file mode 100644 index 0000000..9bc588e --- /dev/null +++ b/manpages/de/live-boot.de.7 @@ -0,0 +1,282 @@ +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH LIVE\-BOOT 7 24.05.2010 2.0~a1 "Debian Live Projekt" + +.SH NAME +\fBlive\-boot\fP \- System Boot Skripte + +.SH BESCHREIBUNG +\fBlive\-config\fP enthaelt die Skripte welche ein Debian Live System waehrend +des Startvorganes (early userspace) konfigurieren. +.PP +.\" FIXME +live\-boot is a hook for the initramfs\-tools, used to generate a initramfs +capable to boot live systems, such as those created by +\fIlive\-helper\fP(7). This includes the Debian Live isos, netboot tarballs, and +usb stick images. +.PP +.\" FIXME +At boot time it will look for a (read\-only) media containing a "/live" +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. + +.SS "Kernel Parameter" +\fBlive\-boot\fP ist nur dann aktiv, wenn 'boot=live' als Kernel Parameter +benutzt wird. +.PP +In addition, there are some more boot parameters to influence the behaviour, +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/). + +.SH OPTIONEN +.\" 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. +.IP \fBconsole\fP=\fITTY,SPEED\fP 4 +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. +.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. +.br +Not working: http://example.com/path/to/your_filesystem.squashfs +.br +Working: http://1.2.3.4/path/to/your_filesystem.squashfs +.br +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. +.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 +LIVE_GENERATE_UUID=1 when building the initramfs. +.IP \fBintegrity\-check\fP 4 +If specified, an MD5 sum is calculated on the live media during boot and +compared to the value found in md5sum.txt found in the root directory of the +live media. +.IP "\fBip\fP=[\fICLIENT_IP\fP]:[\fISERVER_IP\fP]:[\fIGATEWAY_IP\fP]:[\fINETMASK\fP]:[\fIHOSTNAME\fP]:[\fIDEVICE\fP]:[\fIAUTOCONF\fP] [,[\fICLIENT_IP\fP]:[\fISERVER_IP\fP]:[\fIGATEWAY_IP\fP]:[\fINETMASK\fP]:[\fIHOSTNAME\fP]:[\fIDEVICE\fP]:[\fIAUTOCONF\fP]]" 4 +Let you specify the name(s) and the options of the interface(s) that should +be configured at boot time. Do not specify this if you want to use dhcp +(default). It will be changed in a future release to mimick official kernel +boot param specification +(e.g. ip=10.0.0.1::10.0.0.254:255.255.255.0::eth0,:::::eth1:dhcp). +.IP \fBip\fP=[\fIfrommedia\fP] 4 +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 +filesystem should reside. If it did not find something usable, the normal +scan for block devices is performed. +.br +Instead of specifing an actual device name, the keyword 'removable' can be +used to limit the search of acceptable live media to removable type +only. Note that if you want to further restrict the media to usb mass +storage only, you can use the 'removable\-usb' keyword. +.IP {\fBlive\-media\-encryption\fP|\fBencryption\fP}=\fITYPE\fP 4 +live\-boot will mount the encrypted rootfs TYPE, asking the passphrase, +useful to build paranoid live systems :\-). TYPE supported so far are "aes" +for loop\-aes encryption type. +.IP \fBlive\-media\-offset\fP=\fIBYTES\fP 4 +This way you could tell live\-boot that your image starts at offset BYTES in +the above specified or autodiscovered device, this could be useful to hide +the Debian Live iso or image inside another iso or image, to create "clean" +images. +.IP \fBlive\-media\-path\fP=\fIPATH\fP 4 +Sets the path to the live filesystem on the medium. By default, it is set to +\&'/live' and you should not change that unless you have customized your media +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 +be placed on "/live" directory of the live medium. +.IP \fBnetboot\fP[=nfs|cifs] 4 +This tells live\-boot to perform a network mount. The parameter "nfsroot=" +(with optional "nfsopts="), should specify where is the location of the root +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 +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 \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 +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. +.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 {\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. +.IP \fBshowmounts\fP 4 +This parameter will make live\-boot to show on "/" the ro filesystems (mostly +compressed) on "/live". This is not enabled by default because could lead to +problems by applications like "mono" which store binary paths on +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 +needs a lot of free space. Subsequent boots should then skip this step and +just specify the "live\-media=DEVICE" boot parameter with the same DEVICE +used this time. +.IP \fBtoram\fP 4 +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 +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)" +.IP \fB/etc/live.conf\fP 4 +Some variables can be configured via this config file (inside the live +system). +.IP \fBlive/filesystem.module\fP 4 +This optional file (inside the live media) contains a list of white\-space or +carriage\-return\-separated file names corresponding to disk images in the +"/live" directory. If this file exists, only images listed here will be +merged into the root aufs, and they will be loaded in the order listed +here. The first entry in this file will be the "lowest" point in the aufs, +and the last file in this list will be on the "top" of the aufs, directly +below /cow. Without this file, any images in the "/live" directory are +loaded in alphanumeric order. +.IP \fB/etc/live\-persistence.binds\fP 4 +This optional file (which resides in the rootfs system, not in the live +media) is used as a list of directories which not need be persistent: +ie. their content does not need to survive reboots when using the +persistence features. +.br +.\" FIXME +This saves expensive writes and speeds up operations on volatile data such +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 +.IP \fB/etc/live/boot.conf\fP 4 +.IP \fB/etc/live/boot.conf.d/\fP 4 +.IP \fBlive/boot.conf\fP 4 +.IP \fBlive/boot.conf.d/\fP 4 + +.SH "SIEHE AUCH" +\fIlive\-snapshot\fP(1) +.PP +\fIlive\-config\fP(7) +.PP +\fIlive\-helper\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. + +.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 AUTOR +live\-boot wurde von Daniel Baumann <\fIdaniel@debian.org\fP> fuer das +Debian Projekt geschrieben. |