X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=manpages%2Fen%2Flive-boot.7;h=c7139da041e16382d6f9130039ccc92e5f265294;hb=8f90261c8c1024efa643cc58596b2d2c0c5213f8;hp=cd4f7b73c25a3f23841a2706761749ee26df4401;hpb=8837aacd599de325b419ccf793a7ff5e9c3fa232;p=live-boot-grml.git diff --git a/manpages/en/live-boot.7 b/manpages/en/live-boot.7 index cd4f7b7..c7139da 100644 --- a/manpages/en/live-boot.7 +++ b/manpages/en/live-boot.7 @@ -1,4 +1,4 @@ -.TH LIVE\-BOOT 7 2010\-05\-30 2.0~a3 "Debian Live Project" +.TH LIVE\-BOOT 7 2010\-06\-02 2.0~a4 "Debian Live Project" .SH NAME \fBlive\-boot\fR \- System Boot Scripts @@ -32,16 +32,29 @@ Set the accessibility level for physically or visually impared users. ACCESS mus Set the default console to be used with the "live\-getty" option. Example: "console=ttyS0,115200" .IP "\fBdebug\fR" 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\fR=\fIURL\fR" 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\fR=\fIURL\fR" 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 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\fR=\fIHOSTNAME\fR, \fBusername\fR=\fIUSER\fR, \fBuserfullname\fR=\fIUSERFULLNAME\fR" 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 "\fBignore_uuid\fR" 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\fR" 4 @@ -66,30 +79,20 @@ This way you could tell live\-boot that your image starts at offset BYTES in the 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\fR=\fISECONDS\fI" 4 Set the timeout in seconds for the device specified by "live\-media=" to become ready before giving up. -.IP "{\fBlocale\fR|\fBdebian\-installer/locale\fR}=\fILOCALE\fR" 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\fR=\fINAME\fR" 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\fR[=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\fR=" 4 This lets you specify custom nfs options. -.IP "\fBnoautologin\fR" 4 -This parameter disables the automatic terminal login only, not touching gdk/kdm. -.IP "\fBnoxautologin\fR" 4 -This parameter disables the automatic login of gdm/kdm only, not touching terminals. .IP "\fBnofastboot\fR" 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\fR" 4 disables the "persistent" feature, useful if the bootloader (like syslinux) has been installed with persistent enabled. .IP "\fBnoprompt\fR" 4 Do not prompt to eject the CD or remove the USB flash drive on reboot. -.IP "\fBnosudo\fR" 4 -This parameter disables the automatic configuration of sudo. .IP "\fBswapon\fR" 4 This parameter enables usage of local swap partitions. -.IP "\fBnouser\fR" 4 -This parameter disables the creation of the default user completely. .IP "\fBnoxautoconfig\fR" 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\fR[=nofiles]" 4 @@ -108,16 +111,12 @@ This parameter will make live\-boot to show on "/" the ro filesystems (mostly co If you boot with the normal quiet parameter, live\-boot hides most messages of its own. When adding silent, it hides all. .IP "\fBtextonly\fR" 4 Start up to text\-mode shell prompts, disabling the graphical user interface. -.IP "\fBtimezone\fR=\fITIMEZONE\fR" 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\fR=\fIDEVICE\fR" 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\fR" 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\fR=aufs|unionfs\fR" 4 By default, live\-boot uses aufs. With this parameter, you can switch to unionfs. -.IP "\fButc\fR=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\fR" 4 Uses xdebconfigurator, if present on the rootfs, to configure X instead of the standard procedure (experimental). .IP "\fBxvideomode\fR=\fIRESOLUTION\fR" 4