X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=manpages%2Flive-initramfs.en.7.txt;h=c1dcd5b3e6c4e22b682d6be1fb4bbb93ac3f7e49;hb=4fc648acc4e010fe0c3046baeb26ec1334c16e27;hp=238c810cafaf9892f068eaed743aa17ff2a961b2;hpb=f197369a2f2a0078e58b869f5884254d138e5894;p=live-boot-grml.git diff --git a/manpages/live-initramfs.en.7.txt b/manpages/live-initramfs.en.7.txt index 238c810..c1dcd5b 100644 --- a/manpages/live-initramfs.en.7.txt +++ b/manpages/live-initramfs.en.7.txt @@ -21,7 +21,7 @@ This includes the Debian Live isos, netboot tarballs, and usb stick images. 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 -unionfs, for Debian like systems to boot from. +aufs, for Debian like systems to boot from. You probably do not want to install this package onto a non-live system, although it will do no harm. @@ -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*:: @@ -62,8 +70,9 @@ Those parameters lets you override values read from the config file. ignore_uuid -Do not check that any UUID embedded in the initramfs matches the discovered medium. -casper may be told to generate a UUID by setting CASPER_GENERATE_UUID=1 when building the initramfs. +Do not check that any UUID embedded in the initramfs matches the discovered +medium. live-initramfs may be told to generate a UUID by setting +LIVE_GENERATE_UUID=1 when building the initramfs. integrity-check:: @@ -174,13 +183,17 @@ be checked at boot time, use this parameter, otherwise they are skipped. disables the "persistent" feature, useful if the bootloader (like syslinux) has been installed with persistent enabled. + noprompt + +Do not prompt to eject the CD on reboot. + nosudo:: 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:: @@ -192,14 +205,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**:: @@ -224,6 +245,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. @@ -247,10 +273,10 @@ Adding this parameter, live-initramfs 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. - union=**unionfs**|**aufs**:: + union=**aufs**|**unionfs**:: -By default, live-initramfs uses unionfs. With this parameter, you can switch to -aufs. +By default, live-initramfs uses aufs. With this parameter, you can switch to +unionfs. utc=**yes**|**no**:: @@ -278,11 +304,23 @@ Some variables can be configured via this config file (inside the live system). 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 unionfs, and they will be loaded in the order listed here. The first entry -in this file will be the "lowest" point in the unionfs, and the last file in -this list will be on the "top" of the unionfs, directly below /cow. Without +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. + /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 --------