.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH LIVE\-BOOT 7 30.05.2010 2.0~a3 "Debian Live Projekt"
+.TH LIVE\-BOOT 7 17.07.2010 2.0~a14 "Debian Live Projekt"
.SH NAME
\fBlive\-boot\fP \- System Boot Skripte
"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
-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\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 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
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\fP=\fIHOSTNAME\fP, \fBusername\fP=\fIUSER\fP, \fBuserfullname\fP=\fIUSERFULLNAME\fP" 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 \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
+media. If you use the \fBiscsitarget\fP software iSCSI target solution which is
+packaged in Debian your ietd.conf might look like this:
+.br
+# The target\-name you specify in the iscsi= parameter
+.br
+Target <target\-name>
+ Lun 0 Path=<path\-to\-your\-live\-image.iso>,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 \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
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 "{\fBkeyb\fP|\fBkbd\-chooser/method\fP}=\fIKEYBOARD\fP, {\fBklayout\fP|\fBconsole\-setup/layoutcode\fP}=\fILAYOUT\fP, {\fBkvariant\fP|\fBconsole\-setup/variantcode\fP}=\fIVARIANT\fP, {\fBkmodel\fP\fI|\fP\fBconsole\-setup/modelcode\fP}=\fICODE\fP, \fBkoptions\fP=\fIOPTIONS\fP" 4
-Configure the running keyboard as specified, if this one misses live\-boot
-behaves as if "keyb=us" was specified. It will be interfered from "locale="
-if locale is only 2 lowecase letters as a special case. You could also
-specify console layout, variant, code, and options (no defaults).
-.IP \fBlive\-getty\fP 4
-This changes the auto\-login on virtual terminals to use the (experimental)
-live\-getty code. With this option set the standard kernel argument
-"console=" is parsed and if a serial console is specified then live\-getty is
-used to autologin on the serial console.
.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
.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 {\fBlocale\fP|\fBdebian\-installer/locale\fP}=\fILOCALE\fP 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\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
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 \fBnoautologin\fP 4
-This parameter disables the automatic terminal login only, not touching
-gdk/kdm.
-.IP \fBnoxautologin\fP 4
-This parameter disables the automatic login of gdm/kdm only, not touching
-terminals.
.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
has been installed with persistent enabled.
.IP \fBnoprompt\fP 4
Do not prompt to eject the CD or remove the USB flash drive on reboot.
-.IP \fBnosudo\fP 4
-This parameter disables the automatic configuration of sudo.
.IP \fBswapon\fP 4
This parameter enables usage of local swap partitions.
-.IP \fBnouser\fP 4
-This parameter disables the creation of the default user completely.
-.IP \fBnoxautoconfig\fP 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\fP[=nofiles] 4
live\-boot will look for persistent and snapshot partitions or files labeled
"live\-rw", "home\-rw", and files called "live\-sn*", "home\-sn*" and will try
.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 \fBtextonly\fP 4
-Start up to text\-mode shell prompts, disabling the graphical user interface.
-.IP \fBtimezone\fP=\fITIMEZONE\fP 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\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
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.
-.IP \fButc\fP=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\fP 4
-Uses xdebconfigurator, if present on the rootfs, to configure X instead of
-the standard procedure (experimental).
-.IP \fBxvideomode\fP=\fIRESOLUTION\fP 4
-.\" FIXME
-Doesn't do xorg autodetection, but enforces a given resolution.
.\" FIXME
.SH "FILES (old)"
projects / live-boot-grml.git / blobdiff