-.TH LIVE\-BOOT 7 2010\-05\-27 2.0~a2 "Debian Live Project"
+.TH LIVE\-BOOT 7 2010\-06\-05 2.0~a5 "Debian Live Project"
.SH NAME
\fBlive\-boot\fR \- System Boot Scripts
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
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
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
projects / live-boot-grml.git / blobdiff