1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 8.2.2" />
\r
7 <style type="text/css">
\r
9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
\r
11 border: 1px solid red;
\r
16 margin: 1em 5% 1em 5%;
\r
21 text-decoration: underline;
\r
39 h1, h2, h3, h4, h5, h6 {
\r
41 font-family: sans-serif;
\r
43 margin-bottom: 0.5em;
\r
48 border-bottom: 2px solid silver;
\r
51 border-bottom: 2px solid silver;
\r
61 border: 1px solid silver;
\r
66 margin-bottom: 0.5em;
\r
76 font-family: sans-serif;
\r
83 font-family: sans-serif;
\r
87 font-family: sans-serif;
\r
89 border-top: 2px solid silver;
\r
95 padding-bottom: 0.5em;
\r
99 padding-bottom: 0.5em;
\r
103 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
\r
104 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
105 div.admonitionblock {
\r
108 margin-bottom: 1.5em;
\r
110 div.admonitionblock {
\r
112 margin-bottom: 2.5em;
\r
115 div.content { /* Block element content. */
\r
119 /* Block element titles. */
\r
120 div.title, caption.title {
\r
121 font-family: sans-serif;
\r
125 margin-bottom: 0.5em;
\r
131 td div.title:first-child {
\r
134 div.content div.title:first-child {
\r
137 div.content + div.title {
\r
141 div.sidebarblock > div.content {
\r
142 background: #ffffee;
\r
143 border: 1px solid silver;
\r
150 div.listingblock > div.content {
\r
151 border: 1px solid silver;
\r
152 background: #f4f4f4;
\r
156 div.quoteblock > div.content {
\r
157 padding-left: 2.0em;
\r
163 div.verseblock + div.attribution {
\r
167 div.admonitionblock .icon {
\r
168 vertical-align: top;
\r
171 text-decoration: underline;
\r
173 padding-right: 0.5em;
\r
175 div.admonitionblock td.content {
\r
176 padding-left: 0.5em;
\r
177 border-left: 2px solid silver;
\r
180 div.exampleblock > div.content {
\r
181 border-left: 2px solid silver;
\r
185 div.verseblock div.content {
\r
189 div.imageblock div.content { padding-left: 0; }
\r
190 div.imageblock img { border: 1px solid silver; }
\r
191 span.image img { border-style: none; }
\r
195 margin-bottom: 0.8em;
\r
200 font-style: italic;
\r
202 dd > *:first-child {
\r
207 list-style-position: outside;
\r
210 list-style-type: lower-alpha;
\r
213 div.tableblock > table {
\r
214 border: 3px solid #527bbd;
\r
217 font-family: sans-serif;
\r
226 margin-bottom: 0.8em;
\r
229 padding-bottom: 5px;
\r
232 vertical-align: top;
\r
233 font-style: italic;
\r
234 padding-right: 0.8em;
\r
237 vertical-align: top;
\r
241 div#footer-badges { display: none; }
\r
246 font-family: sans-serif;
\r
250 margin-bottom: 0.1em;
\r
253 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
\r
269 /* Workarounds for IE6's broken and incomplete CSS2. */
\r
271 div.sidebar-content {
\r
272 background: #ffffee;
\r
273 border: 1px solid silver;
\r
276 div.sidebar-title, div.image-title {
\r
277 font-family: sans-serif;
\r
280 margin-bottom: 0.5em;
\r
283 div.listingblock div.content {
\r
284 border: 1px solid silver;
\r
285 background: #f4f4f4;
\r
289 div.quoteblock-content {
\r
290 padding-left: 2.0em;
\r
293 div.exampleblock-content {
\r
294 border-left: 2px solid silver;
\r
295 padding-left: 0.5em;
\r
298 /* IE6 sets dynamically generated links as visited. */
\r
299 div#toc a:visited { color: blue; }
\r
301 <title>live-initramfs(7)</title>
\r
305 <h1>live-initramfs(7)</h1>
\r
308 <div class="sectionbody">
\r
309 <p>live-initramfs - Debian Live initramfs hook</p>
\r
312 <div class="sectionbody">
\r
314 <p>as kernel parameter at boot prompt.</p>
\r
316 <h2>Description</h2>
\r
317 <div class="sectionbody">
\r
318 <p>live-initramfs is a hook for the initramfs-tools, used to generate a initramfs
\r
319 capable to boot live systems, such as those created by <strong>live-helper</strong>(7).
\r
320 This includes the Debian Live isos, netboot tarballs, and usb stick images.</p>
\r
321 <p>At boot time it will look for a (read-only) media containing a "/live"
\r
322 directory where a root filesystems (often a compressed filesystem image like
\r
323 squashfs) is stored. If found, it will create a writable environment, using
\r
324 aufs, for Debian like systems to boot from.</p>
\r
325 <p>You probably do not want to install this package onto a non-live system,
\r
326 although it will do no harm.</p>
\r
327 <p>live-initramfs is a fork of <a href="http://packages.ubuntu.com/casper/">casper</a>.
\r
328 casper was originally written by Tollef Fog Heen <tfheen@canonical.com>
\r
329 and Matt Zimmerman <mdz@canonical.com>.</p>
\r
331 <h2>Boot options</h2>
\r
332 <div class="sectionbody">
\r
333 <p>Here is the complete list of recognized boot parameters by live-initramfs.</p>
\r
336 access=<strong>ACCESS</strong>
\r
340 Set the accessibility level for physically or visually impared users. ACCESS
\r
341 must be one of v1, v2, v3, m1, or m2. v1=lesser visual impairment, v2=moderate
\r
342 visual impairment, v3=blindness, m1=minor motor difficulties, m2=moderate motor
\r
347 console=<strong>TTY,SPEED</strong>
\r
351 Set the default console to be used with the "live-getty" option. Example:
\r
352 "console=ttyS0,115200"
\r
360 Makes initramfs boot process more verbose.
\r
364 fetch=<strong>URL</strong>
\r
368 Another form of netboot by downloading a squashfs image from a given url,
\r
369 copying to ram and booting it.
\r
373 hostname=<strong>HOSTNAME</strong>, username=<strong>USER</strong>, userfullname=<strong>USERFULLNAME</strong>
\r
377 Those parameters lets you override values read from the config file.
\r
379 <div class="literalblock">
\r
380 <div class="content">
\r
381 <pre><tt>ignore_uuid</tt></pre>
\r
385 <p>Do not check that any UUID embedded in the initramfs matches the discovered
\r
386 medium. live-initramfs may be told to generate a UUID by setting
\r
387 LIVE_GENERATE_UUID=1 when building the initramfs.</p>
\r
394 If specified, an MD5 sum is calculated on the live media during boot and
\r
395 compared to the value found in md5sum.txt found in the root directory of the
\r
400 ip=<strong>[CLIENT_IP]:[SERVER_IP]:[GATEWAY_IP]:[NETMASK]:[HOSTNAME]:[DEVICE]:[AUTOCONF] [,[CLIENT_IP]:[SERVER_IP]:[GATEWAY_IP]:[NETMASK]:[HOSTNAME]:[DEVICE]:[AUTOCONF]]</strong>*
\r
404 Let you specify the name(s) and the options of the interface(s) that should be
\r
405 configured at boot time. Do not specify this if you want to use dhcp (default).
\r
406 It will be changed in a future release to mimick official kernel boot param
\r
407 specification (e.g. ip=10.0.0.1::10.0.0.254:255.255.255.0::eth0,:::::eth1:dhcp).
\r
411 ip[=<strong>frommedia</strong>]
\r
415 If this variable is set, dhcp and static configuration are just skipped and the
\r
416 system will use the (must be) media-preconfigured /etc/network/interfaces
\r
421 {keyb|kbd-chooser/method}=<strong>KEYBOARD</strong>, {klayout|console-setup/layoutcode}=<strong>LAYOUT</strong>, {kvariant|console-setup/variantcode}=<strong>VARIANT</strong>, {kmodel|console-setup/modelcode}=<strong>CODE</strong>, koptions=<strong>OPTIONS</strong>
\r
425 Configure the running keyboard as specified, if this one misses live-initramfs
\r
426 behaves as if "keyb=us" was specified. It will be interfered from "locale=" if
\r
427 locale is only 2 lowecase letters as a special case. You could also specify
\r
428 console layout, variant, code, and options (no defaults).
\r
436 This changes the auto-login on virtual terminals to use the (experimental)
\r
437 live-getty code. With this option set the standard kernel argument "console=" is
\r
438 parsed and if a serial console is specified then live-getty is used to autologin
\r
439 on the serial console.
\r
443 {live-media|bootfrom}=<strong>DEVICE</strong>
\r
447 If you specify one of this two equivalent forms, live-initramfs will first try
\r
448 to find this device for the "/live" directory where the read-only root
\r
449 filesystem should reside. If it did not find something usable, the normal scan
\r
450 for block devices is performed.
\r
454 {live-media-encryption|encryption}=<strong>TYPE</strong>
\r
458 live-initramfs will mount the encrypted rootfs TYPE, asking the passphrase,
\r
459 useful to build paranoid live systems :-). TYPE supported so far are "aes" for
\r
460 loop-aes encryption type.
\r
464 live-media-offset=<strong>BYTES</strong>
\r
468 This way you could tell live-initramfs that your image starts at offset BYTES in
\r
469 the above specified or autodiscovered device, this could be useful to hide the
\r
470 Debian Live iso or image inside another iso or image, to create "clean" images.
\r
474 live-media-path=<strong>PATH</strong>
\r
478 Sets the path to the live filesystem on the medium. By default, it is set to
\r
479 <em>/live</em> and you should not change that unless you have customized your media
\r
484 live-media-timeout=<strong>SECONDS</strong>
\r
488 Set the timeout in seconds for the device specified by "live-media=" to become
\r
489 ready before giving up.
\r
493 {locale|debian-installer/locale}=<strong>LOCALE</strong>
\r
497 Configure the running locale as specified, if not present the live-media rootfs
\r
498 configured locale will be used and if also this one misses live-initramfs behave
\r
499 as "locale=en_US.UTF-8" was specified. If only 2 lowercase letter are specified
\r
500 (like "it"), the "maybe wanted" locale is generated (like en:EN.UTF-8), in this
\r
501 case if also "keyb=" is unspecified is set with those 2 lowercase letters
\r
502 (keyb=us). Beside that facility, only UTF8 locales are supported by
\r
507 module=<strong>NAME</strong>
\r
511 Instead of using the default optional file "filesystem.module" (see below)
\r
512 another file could be specified without the extension ".module"; it should be
\r
513 placed on "/live" directory of the live medium.
\r
517 netboot[=<strong>nfs</strong>|<strong>cifs</strong>]
\r
521 This tells live-initramfs to perform a network mount. The parameter "nfsroot="
\r
522 (with optional "nfsopts="), should specify where is the location of the root
\r
523 filesystem. With no args, will try cifs first, and if it fails nfs.
\r
531 This lets you specify custom nfs options.
\r
539 This parameter disables the automatic terminal login only, not touching gdk/kdm.
\r
547 This parameter disables the automatic login of gdm/kdm only, not touching
\r
556 This parameter disables the default disabling of filesystem checks in
\r
557 /etc/fstab. If you have static filesystems on your harddisk and you want them to
\r
558 be checked at boot time, use this parameter, otherwise they are skipped.
\r
566 disables the "persistent" feature, useful if the bootloader (like syslinux) has
\r
567 been installed with persistent enabled.
\r
569 <div class="literalblock">
\r
570 <div class="content">
\r
571 <pre><tt>noprompt</tt></pre>
\r
575 <p>Do not prompt to eject the CD on reboot.</p>
\r
582 This parameter disables the automatic configuration of sudo.
\r
590 This parameter enables usage of local swap partitions.
\r
598 This parameter disables the creation of the default user completely.
\r
606 This parameter disables Xorg auto-reconfiguration at boot time. This is valuable
\r
607 if you either do the detection on your own, or, if you want to ship a custom,
\r
608 premade xorg.conf in your live system.
\r
616 live-initramfs will look for persistent and snapshot partitions or files labeled
\r
617 "live-rw", "home-rw", and files called "live-sn*", "home-sn*" and will try to,
\r
618 in order: mount as /cow the first, mount the second in /home, and just copy the
\r
619 contents of the latter in appropriate locations (snapshots). Snapshots will be
\r
620 tried to be updated on reboot/shutdown. Look at live-snapshot(1) for more
\r
625 {preseed/file|file}=<strong>FILE</strong>
\r
629 A path to a file present on the rootfs could be used to preseed debconf
\r
634 package/question=<strong>VALUE</strong>
\r
638 All debian installed packages could be preseeded from command-line that way,
\r
639 beware of blanks spaces, they will interfere with parsing, use a preseed file in
\r
648 This option causes live-initramfs to reboot without attempting to eject the
\r
649 media and without asking the user to remove the boot media.
\r
657 This parameter will make live-initramfs to show on "/" the ro filesystems
\r
658 (mostly compressed) on "/live". This is not enabled by default because could
\r
659 lead to problems by applications like "mono" which store binary paths on
\r
662 <div class="literalblock">
\r
663 <div class="content">
\r
664 <pre><tt>textonly</tt></pre>
\r
668 <p>Start up to text-mode shell prompts, disabling the graphical user interface.</p>
\r
671 timezone=<strong>TIMEZONE</strong>
\r
675 By default, timezone is set to UTC. Using the timezone parameter, you can set it
\r
676 to your local zone, e.g. Europe/Zurich.
\r
680 todisk=<strong>DEVICE</strong>
\r
684 Adding this parameter, live-initramfs will try to copy the entire read-only
\r
685 media to the specified device before mounting the root filesystem. It probably
\r
686 needs a lot of free space. Subsequent boots should then skip this step and just
\r
687 specify the "live-media=DEVICE" boot parameter with the same DEVICE used this
\r
696 Adding this parameter, live-initramfs will try to copy the whole read-only media
\r
697 to the computer's RAM before mounting the root filesystem. This could need a lot
\r
698 of ram, according to the space used by the read-only media.
\r
702 union=<strong>aufs</strong>|<strong>unionfs</strong>
\r
706 By default, live-initramfs uses aufs. With this parameter, you can switch to
\r
711 utc=<strong>yes</strong>|<strong>no</strong>
\r
715 By default, Debian systems do assume that the hardware clock is set to UTC. You
\r
716 can change or explicitly set it with this parameter.
\r
724 Uses xdebconfigurator, if present on the rootfs, to configure X instead of the
\r
725 standard procedure (experimental).
\r
729 xvideomode=<strong>RESOLUTION</strong>
\r
733 Doesn't do xorg autodetection, but enforces a given resolution.
\r
739 <div class="sectionbody">
\r
740 <div class="literalblock">
\r
741 <div class="content">
\r
742 <pre><tt>/etc/live.conf</tt></pre>
\r
744 <p>Some variables can be configured via this config file (inside the live system).</p>
\r
745 <div class="literalblock">
\r
746 <div class="content">
\r
747 <pre><tt>/live/filesystem.module</tt></pre>
\r
749 <p>This optional file (inside the live media) contains a list of white-space or
\r
750 carriage-return-separated file names corresponding to disk images in the "/live"
\r
751 directory. If this file exists, only images listed here will be merged into the
\r
752 root aufs, and they will be loaded in the order listed here. The first entry
\r
753 in this file will be the "lowest" point in the aufs, and the last file in
\r
754 this list will be on the "top" of the aufs, directly below /cow. Without
\r
755 this file, any images in the "/live" directory are loaded in alphanumeric order.</p>
\r
758 <div class="sectionbody">
\r
759 <p>live-snapshot(1), initramfs-tools(8), live-helper(7), live-initscripts(7),
\r
760 live-webhelper(7)</p>
\r
763 <div class="sectionbody">
\r
764 <p>Report bugs against live-initramfs
\r
765 <a href="http://packages.qa.debian.org/live-initramfs">http://packages.qa.debian.org/live-initramfs</a>.</p>
\r
768 <div class="sectionbody">
\r
769 <p>More information about the Debian Live project can be found at
\r
770 <a href="http://debian-live.alioth.debian.org/">http://debian-live.alioth.debian.org/</a> and
\r
771 <a href="http://wiki.debian.org/DebianLive/">http://wiki.debian.org/DebianLive/</a>.</p>
\r
774 <div class="sectionbody">
\r
775 <p>live-initramfs is maintained by Daniel Baumann <daniel@debian.org>
\r
776 for the Debian project.</p>
\r
777 <p>live-initramfs is a fork of <a href="http://packages.ubuntu.com/casper/">casper</a>.
\r
778 casper was originally written by Tollef Fog Heen <tfheen@canonical.com>
\r
779 and Matt Zimmerman <mdz@canonical.com>.</p>
\r
782 <div id="footer-text">
\r
783 Last updated 01-Nov-2009 04:31:41 CEST
\r