X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=manpages%2Flive-initramfs.en.7.txt;h=d6a7d2110c4c42e3239cc1302e80ebb5d29cc6f5;hb=f63c8fffb429db2b3d3b8feb708e78dcd710d01a;hp=eb2e3026307faff3a266a847d496e3b9c1aac7e4;hpb=9746eca8c332f95578d766263d55b377cf58428a;p=live-boot-grml.git diff --git a/manpages/live-initramfs.en.7.txt b/manpages/live-initramfs.en.7.txt index eb2e302..d6a7d21 100644 --- a/manpages/live-initramfs.en.7.txt +++ b/manpages/live-initramfs.en.7.txt @@ -54,7 +54,15 @@ Makes initramfs boot process more verbose. fetch=*URL*:: Another form of netboot by downloading a squashfs image from a given url, -copying to ram and booting it. +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. + +Not working: http://example.com/path/to/your_filesystem.squashfs +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. hostname=*HOSTNAME*, username=*USER*, userfullname=*USERFULLNAME*:: @@ -106,6 +114,10 @@ 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. +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 +cdrom devices are not removable, but e.g. usb mass storage is. + {live-media-encryption|encryption}=**TYPE**:: live-initramfs will mount the encrypted rootfs TYPE, asking the passphrase, @@ -183,9 +195,9 @@ Do not prompt to eject the CD on reboot. This parameter disables the automatic configuration of sudo. - noswap:: + swapon:: -This parameter disables usage of local swap partitions. +This parameter enables usage of local swap partitions. nouser:: @@ -197,14 +209,22 @@ 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. - persistent:: + persistent[=nofiles]:: live-initramfs 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. +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. + + persistent-path=PATH + +live-initramfs 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. {preseed/file|file}=**FILE**:: @@ -229,6 +249,11 @@ This parameter will make live-initramfs to show on "/" the ro filesystems lead to problems by applications like "mono" which store binary paths on installation. + silent + +If you boot with the normal quiet parameter, live-initramfs hides most messages +of its own. When adding silent, it hides all. + textonly Start up to text-mode shell prompts, disabling the graphical user interface. @@ -288,6 +313,18 @@ 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. + /etc/live-persistence.binds + +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. + +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. + + See also --------