.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH LIVE\-BOOT 7 02.06.2010 2.0~a4 "Debian Live Projekt"
+.TH LIVE\-BOOT 7 12.10.2010 2.0.8 "Debian Live Projekt"
.SH NAME
\fBlive\-boot\fP \- System Boot Skripte
.SS Konfigurationsdateien
\fBlive\-boot\fP can be configured (but not activated) through configuration
files. Those files can be placed either in the root filesystem itself
-(/etc/live/boot.conf, /etc/live/boot.conf.d/), or on the live media
-(live/boot.conf, live/boot.conf.d/).
+(/etc/live/boot.conf, /etc/live/boot.d/), or on the live media
+(live/boot.conf, live/boot.d/).
.SH OPTIONEN
.\" FIXME
"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.
+.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
Do not prompt to eject the CD or remove the USB flash drive on reboot.
.IP \fBswapon\fP 4
This parameter enables usage of local swap partitions.
-.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
live\-boot 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.
+.IP \fBpersistent\-subtext\fP=\fISUFFIX\fP 4
+Add a suffix when searching for the image filenames or partition labels to
+use for the above mentioned persistent feature, the SUFFIX will be added
+after a dash (e.g.: "live\-sn" would transform to "live\-sn\-SUFFIX"). This is
+handy to test multiple live\-boot based live\-systems with different
+persistent storage choices.
.IP {\fBpreseed/file\fP|\fBfile\fP}=\fIFILE\fP 4
A path to a file present on the rootfs could be used to preseed debconf
database.
.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 \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 \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)"
.SH DATEIEN
.IP \fB/etc/live/boot.conf\fP 4
-.IP \fB/etc/live/boot.conf.d/\fP 4
+.IP \fB/etc/live/boot.d/\fP 4
.IP \fBlive/boot.conf\fP 4
-.IP \fBlive/boot.conf.d/\fP 4
+.IP \fBlive/boot.d/\fP 4
.SH "SIEHE AUCH"
\fIlive\-snapshot\fP(1)
.PP
-\fIlive\-config\fP(7)
+\fIlive\-build\fP(7)
.PP
-\fIlive\-helper\fP(7)
+\fIlive\-config\fP(7)
.SH HOMEPAGE
Weitere Informationen ueber live\-boot und das Debian Live Projekt koennen