X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=manpages%2Fde%2Flive-boot.de.7;fp=manpages%2Fde%2Flive-boot.de.7;h=0000000000000000000000000000000000000000;hb=b5a65f0e127b6cd95770ac450a133347ef7d9005;hp=58b324c0d84a4de4644f7da3cef9a83d3d577b34;hpb=2054612ec4da08beae7d6f4c5357513d8d4e0c87;p=live-boot-grml.git diff --git a/manpages/de/live-boot.de.7 b/manpages/de/live-boot.de.7 deleted file mode 100644 index 58b324c..0000000 --- a/manpages/de/live-boot.de.7 +++ /dev/null @@ -1,283 +0,0 @@ -.\"******************************************************************* -.\" -.\" This file was generated with po4a. Translate the source file. -.\" -.\"******************************************************************* -.TH LIVE\-BOOT 7 2014\-08\-27 4.0~alpha21\-1 "Live Systems Project" - -.SH NAME -\fBlive\-boot\fP \- System Boot Components - -.SH DESCRIPTION -\fBlive\-boot\fP contains the components that configure a live system during the -boot process (early userspace). -.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 Live systems ISOs, netboot tarballs, -and usb stick images. -.PP -.\" FIXME -At boot time it will look for a (read\-only) medium 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, to boot the system from. - -.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 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 "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/*), or on the live media -(live/boot.conf, live/boot/*). - -.SH OPTIONS -.\" FIXME -\fBlive\-boot\fP currently features the following parameters. -.IP \fBaccess\fP=\fIACCESS\fP 4 -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" -.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 -.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 busybox's wget and DNS resolution, an URL can -not contain a hostname but an IP address 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 name\-based virtualhost of an httpd if it is sharing the IP address with -the main httpd instance. -.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 -medium. If you use the \fBiscsitarget\fP software iSCSI target solution 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 \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. -.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 \fBverify\-checksums\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=[\fIDEVICE\fP]:[\fICLIENT_IP\fP]:[\fINETMASK\fP]:[\fIGATEWAY_IP\fP]:[\fINAMESERVER\fP] [,[\fIDEVICE\fP]:[\fICLIENT_IP\fP]:[\fINETMASK\fP]:[\fIGATEWAY_IP\fP]:[\fINAMESERVER\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 {\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 is "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 live system 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 \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 \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 \fBnopersistence\fP 4 -disables the "persistence" feature, useful if the bootloader (like syslinux) -has been installed with persistence enabled. -.IP \fBnoeject\fP 4 -Do not prompt to eject the live medium. -.IP \fBramdisk\-size\fP 4 -This parameter allows to set a custom ramdisk size (it's the '\-o size' -option of tmpfs mount). By default, there is no ramdisk size set, so the -default of mount applies (currently 50% of available RAM). Note that this -option has currently no effect when booting with toram. -.IP \fBswap=true\fP 4 -This parameter enables usage of local swap 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 -files (with the correct file name). Overlays are labeled/named "persistence" -(see \fIpersistence.conf\fP(5)). Overlay image files are named "persistence". -.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 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 \fBpersistence\-media\fP={\fIremovable\fP|\fIremovable\-usb\fP} 4 -If you specify the keyword 'removable', live\-boot will try to find -persistence 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"). The default is "overlay". -.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 \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. -.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 \fBpersistence\-label\fP=\fILABEL\fP 4 -live\-boot will use the name "LABEL" instead of "persistence" when searching -for persistent storage. LABEL can be any valid filename, partition label, or -GPT name. -.IP \fBnoeject\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 "/lib/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 \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 -.\" FIXME -By default, live\-boot uses aufs. With this parameter, you can switch to -unionfs. - -.\" 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 -.\" FIXME -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 /overlay. Without this file, any images in the "/live" directory are -loaded in alphanumeric order. - -.SH FILES -.IP \fB/etc/live/boot.conf\fP 4 -.IP \fB/etc/live/boot/*\fP 4 -.IP \fBlive/boot.conf\fP 4 -.IP \fBlive/boot/*\fP 4 -.IP \fBpersistence.conf\fP 4 - -.SH "SEE ALSO" -\fIpersistence.conf\fP(5) -.PP -\fIlive\-build\fP(7) -.PP -\fIlive\-config\fP(7) -.PP -\fIlive\-tools\fP(7) - -.SH HOMEPAGE -More information about live\-boot and the Live Systems project can be found -on the homepage at <\fIhttp://live\-systems.org/\fP> and in the manual -at <\fIhttp://live\-systems.org/manual/\fP>. - -.SH BUGS -Bugs can be reported by submitting a bugreport for the live\-boot package in -the Bug Tracking System at <\fIhttp://bugs.debian.org/\fP> or by -writing a mail to the Live Systems mailing list at -<\fIdebian\-live@lists.debian.org\fP>. - -.SH AUTHOR -live\-boot was written by Daniel Baumann <\fImail@daniel\-baumann.ch\fP>.