online-docs/live-initramfs.en.7.html

   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
   4 <head>\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
   8 /* Debug borders */\r
   9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {\r
  10 /*\r
  11   border: 1px solid red;\r
  12 */\r
  13 }\r
  14 \r
  15 body {\r
  16   margin: 1em 5% 1em 5%;\r
  17 }\r
  18 \r
  19 a {\r
  20   color: blue;\r
  21   text-decoration: underline;\r
  22 }\r
  23 a:visited {\r
  24   color: fuchsia;\r
  25 }\r
  26 \r
  27 em {\r
  28   font-style: italic;\r
  29 }\r
  30 \r
  31 strong {\r
  32   font-weight: bold;\r
  33 }\r
  34 \r
  35 tt {\r
  36   color: navy;\r
  37 }\r
  38 \r
  39 h1, h2, h3, h4, h5, h6 {\r
  40   color: #527bbd;\r
  41   font-family: sans-serif;\r
  42   margin-top: 1.2em;\r
  43   margin-bottom: 0.5em;\r
  44   line-height: 1.3;\r
  45 }\r
  46 \r
  47 h1 {\r
  48   border-bottom: 2px solid silver;\r
  49 }\r
  50 h2 {\r
  51   border-bottom: 2px solid silver;\r
  52   padding-top: 0.5em;\r
  53 }\r
  54 \r
  55 div.sectionbody {\r
  56   font-family: serif;\r
  57   margin-left: 0;\r
  58 }\r
  59 \r
  60 hr {\r
  61   border: 1px solid silver;\r
  62 }\r
  63 \r
  64 p {\r
  65   margin-top: 0.5em;\r
  66   margin-bottom: 0.5em;\r
  67 }\r
  68 \r
  69 pre {\r
  70   padding: 0;\r
  71   margin: 0;\r
  72 }\r
  73 \r
  74 span#author {\r
  75   color: #527bbd;\r
  76   font-family: sans-serif;\r
  77   font-weight: bold;\r
  78   font-size: 1.1em;\r
  79 }\r
  80 span#email {\r
  81 }\r
  82 span#revision {\r
  83   font-family: sans-serif;\r
  84 }\r
  85 \r
  86 div#footer {\r
  87   font-family: sans-serif;\r
  88   font-size: small;\r
  89   border-top: 2px solid silver;\r
  90   padding-top: 0.5em;\r
  91   margin-top: 4.0em;\r
  92 }\r
  93 div#footer-text {\r
  94   float: left;\r
  95   padding-bottom: 0.5em;\r
  96 }\r
  97 div#footer-badges {\r
  98   float: right;\r
  99   padding-bottom: 0.5em;\r
 100 }\r
 101 \r
 102 div#preamble,\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
 106   margin-right: 10%;\r
 107   margin-top: 1.5em;\r
 108   margin-bottom: 1.5em;\r
 109 }\r
 110 div.admonitionblock {\r
 111   margin-top: 2.5em;\r
 112   margin-bottom: 2.5em;\r
 113 }\r
 114 \r
 115 div.content { /* Block element content. */\r
 116   padding: 0;\r
 117 }\r
 118 \r
 119 /* Block element titles. */\r
 120 div.title, caption.title {\r
 121   font-family: sans-serif;\r
 122   font-weight: bold;\r
 123   text-align: left;\r
 124   margin-top: 1.0em;\r
 125   margin-bottom: 0.5em;\r
 126 }\r
 127 div.title + * {\r
 128   margin-top: 0;\r
 129 }\r
 130 \r
 131 td div.title:first-child {\r
 132   margin-top: 0.0em;\r
 133 }\r
 134 div.content div.title:first-child {\r
 135   margin-top: 0.0em;\r
 136 }\r
 137 div.content + div.title {\r
 138   margin-top: 0.0em;\r
 139 }\r
 140 \r
 141 div.sidebarblock > div.content {\r
 142   background: #ffffee;\r
 143   border: 1px solid silver;\r
 144   padding: 0.5em;\r
 145 }\r
 146 \r
 147 div.listingblock {\r
 148   margin-right: 0%;\r
 149 }\r
 150 div.listingblock > div.content {\r
 151   border: 1px solid silver;\r
 152   background: #f4f4f4;\r
 153   padding: 0.5em;\r
 154 }\r
 155 \r
 156 div.quoteblock > div.content {\r
 157   padding-left: 2.0em;\r
 158 }\r
 159 \r
 160 div.attribution {\r
 161   text-align: right;\r
 162 }\r
 163 div.verseblock + div.attribution {\r
 164   text-align: left;\r
 165 }\r
 166 \r
 167 div.admonitionblock .icon {\r
 168   vertical-align: top;\r
 169   font-size: 1.1em;\r
 170   font-weight: bold;\r
 171   text-decoration: underline;\r
 172   color: #527bbd;\r
 173   padding-right: 0.5em;\r
 174 }\r
 175 div.admonitionblock td.content {\r
 176   padding-left: 0.5em;\r
 177   border-left: 2px solid silver;\r
 178 }\r
 179 \r
 180 div.exampleblock > div.content {\r
 181   border-left: 2px solid silver;\r
 182   padding: 0.5em;\r
 183 }\r
 184 \r
 185 div.verseblock div.content {\r
 186   white-space: pre;\r
 187 }\r
 188 \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
 192 \r
 193 dl {\r
 194   margin-top: 0.8em;\r
 195   margin-bottom: 0.8em;\r
 196 }\r
 197 dt {\r
 198   margin-top: 0.5em;\r
 199   margin-bottom: 0;\r
 200   font-style: italic;\r
 201 }\r
 202 dd > *:first-child {\r
 203   margin-top: 0;\r
 204 }\r
 205 \r
 206 ul, ol {\r
 207     list-style-position: outside;\r
 208 }\r
 209 ol.olist2 {\r
 210   list-style-type: lower-alpha;\r
 211 }\r
 212 \r
 213 div.tableblock > table {\r
 214   border: 3px solid #527bbd;\r
 215 }\r
 216 thead {\r
 217   font-family: sans-serif;\r
 218   font-weight: bold;\r
 219 }\r
 220 tfoot {\r
 221   font-weight: bold;\r
 222 }\r
 223 \r
 224 div.hlist {\r
 225   margin-top: 0.8em;\r
 226   margin-bottom: 0.8em;\r
 227 }\r
 228 div.hlist td {\r
 229   padding-bottom: 5px;\r
 230 }\r
 231 td.hlist1 {\r
 232   vertical-align: top;\r
 233   font-style: italic;\r
 234   padding-right: 0.8em;\r
 235 }\r
 236 td.hlist2 {\r
 237   vertical-align: top;\r
 238 }\r
 239 \r
 240 @media print {\r
 241   div#footer-badges { display: none; }\r
 242 }\r
 243 \r
 244 div#toctitle {\r
 245   color: #527bbd;\r
 246   font-family: sans-serif;\r
 247   font-size: 1.1em;\r
 248   font-weight: bold;\r
 249   margin-top: 1.0em;\r
 250   margin-bottom: 0.1em;\r
 251 }\r
 252 \r
 253 div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {\r
 254   margin-top: 0;\r
 255   margin-bottom: 0;\r
 256 }\r
 257 div.toclevel2 {\r
 258   margin-left: 2em;\r
 259   font-size: 0.9em;\r
 260 }\r
 261 div.toclevel3 {\r
 262   margin-left: 4em;\r
 263   font-size: 0.9em;\r
 264 }\r
 265 div.toclevel4 {\r
 266   margin-left: 6em;\r
 267   font-size: 0.9em;\r
 268 }\r
 269 /* Workarounds for IE6's broken and incomplete CSS2. */\r
 270 \r
 271 div.sidebar-content {\r
 272   background: #ffffee;\r
 273   border: 1px solid silver;\r
 274   padding: 0.5em;\r
 275 }\r
 276 div.sidebar-title, div.image-title {\r
 277   font-family: sans-serif;\r
 278   font-weight: bold;\r
 279   margin-top: 0.0em;\r
 280   margin-bottom: 0.5em;\r
 281 }\r
 282 \r
 283 div.listingblock div.content {\r
 284   border: 1px solid silver;\r
 285   background: #f4f4f4;\r
 286   padding: 0.5em;\r
 287 }\r
 288 \r
 289 div.quoteblock-content {\r
 290   padding-left: 2.0em;\r
 291 }\r
 292 \r
 293 div.exampleblock-content {\r
 294   border-left: 2px solid silver;\r
 295   padding-left: 0.5em;\r
 296 }\r
 297 \r
 298 /* IE6 sets dynamically generated links as visited. */\r
 299 div#toc a:visited { color: blue; }\r
 300 </style>\r
 301 <title>live-initramfs(7)</title>\r
 302 </head>\r
 303 <body>\r
 304 <div id="header">\r
 305 <h1>live-initramfs(7)</h1>\r
 306 </div>\r
 307 <h2>Name</h2>\r
 308 <div class="sectionbody">\r
 309 <p>live-initramfs - Debian Live initramfs hook</p>\r
 310 </div>\r
 311 <h2>Synopsis</h2>\r
 312 <div class="sectionbody">\r
 313 <p>BOOT=live</p>\r
 314 <p>as kernel parameter at boot prompt.</p>\r
 315 </div>\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 &lt;tfheen@canonical.com&gt;\r
 329 and Matt Zimmerman &lt;mdz@canonical.com&gt;.</p>\r
 330 </div>\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
 334 <dl>\r
 335 <dt>\r
 336 access=<strong>ACCESS</strong>\r
 337 </dt>\r
 338 <dd>\r
 339 <p>\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
 343 difficulties.\r
 344 </p>\r
 345 </dd>\r
 346 <dt>\r
 347 console=<strong>TTY,SPEED</strong>\r
 348 </dt>\r
 349 <dd>\r
 350 <p>\r
 351 Set the default console to be used with the "live-getty" option. Example:\r
 352 "console=ttyS0,115200"\r
 353 </p>\r
 354 </dd>\r
 355 <dt>\r
 356 debug\r
 357 </dt>\r
 358 <dd>\r
 359 <p>\r
 360 Makes initramfs boot process more verbose.\r
 361 </p>\r
 362 </dd>\r
 363 <dt>\r
 364 fetch=<strong>URL</strong>\r
 365 </dt>\r
 366 <dd>\r
 367 <p>\r
 368 Another form of netboot by downloading a squashfs image from a given url,\r
 369 copying to ram and booting it.\r
 370 </p>\r
 371 </dd>\r
 372 <dt>\r
 373 hostname=<strong>HOSTNAME</strong>, username=<strong>USER</strong>, userfullname=<strong>USERFULLNAME</strong>\r
 374 </dt>\r
 375 <dd>\r
 376 <p>\r
 377 Those parameters lets you override values read from the config file.\r
 378 </p>\r
 379 <div class="literalblock">\r
 380 <div class="content">\r
 381 <pre><tt>ignore_uuid</tt></pre>\r
 382 </div></div>\r
 383 </dd>\r
 384 </dl>\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
 388 <dl>\r
 389 <dt>\r
 390 integrity-check\r
 391 </dt>\r
 392 <dd>\r
 393 <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
 396 live media.\r
 397 </p>\r
 398 </dd>\r
 399 <dt>\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
 401 </dt>\r
 402 <dd>\r
 403 <p>\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
 408 </p>\r
 409 </dd>\r
 410 <dt>\r
 411 ip[=<strong>frommedia</strong>]\r
 412 </dt>\r
 413 <dd>\r
 414 <p>\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
 417 instead.\r
 418 </p>\r
 419 </dd>\r
 420 <dt>\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
 422 </dt>\r
 423 <dd>\r
 424 <p>\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
 429 </p>\r
 430 </dd>\r
 431 <dt>\r
 432 live-getty\r
 433 </dt>\r
 434 <dd>\r
 435 <p>\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
 440 </p>\r
 441 </dd>\r
 442 <dt>\r
 443 {live-media|bootfrom}=<strong>DEVICE</strong>\r
 444 </dt>\r
 445 <dd>\r
 446 <p>\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
 451 </p>\r
 452 </dd>\r
 453 <dt>\r
 454 {live-media-encryption|encryption}=<strong>TYPE</strong>\r
 455 </dt>\r
 456 <dd>\r
 457 <p>\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
 461 </p>\r
 462 </dd>\r
 463 <dt>\r
 464 live-media-offset=<strong>BYTES</strong>\r
 465 </dt>\r
 466 <dd>\r
 467 <p>\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
 471 </p>\r
 472 </dd>\r
 473 <dt>\r
 474 live-media-path=<strong>PATH</strong>\r
 475 </dt>\r
 476 <dd>\r
 477 <p>\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
 480 accordingly.\r
 481 </p>\r
 482 </dd>\r
 483 <dt>\r
 484 live-media-timeout=<strong>SECONDS</strong>\r
 485 </dt>\r
 486 <dd>\r
 487 <p>\r
 488 Set the timeout in seconds for the device specified by "live-media=" to become\r
 489 ready before giving up.\r
 490 </p>\r
 491 </dd>\r
 492 <dt>\r
 493 {locale|debian-installer/locale}=<strong>LOCALE</strong>\r
 494 </dt>\r
 495 <dd>\r
 496 <p>\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
 503 live-initramfs.\r
 504 </p>\r
 505 </dd>\r
 506 <dt>\r
 507 module=<strong>NAME</strong>\r
 508 </dt>\r
 509 <dd>\r
 510 <p>\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
 514 </p>\r
 515 </dd>\r
 516 <dt>\r
 517 netboot[=<strong>nfs</strong>|<strong>cifs</strong>]\r
 518 </dt>\r
 519 <dd>\r
 520 <p>\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
 524 </p>\r
 525 </dd>\r
 526 <dt>\r
 527 nfsopts=\r
 528 </dt>\r
 529 <dd>\r
 530 <p>\r
 531 This lets you specify custom nfs options.\r
 532 </p>\r
 533 </dd>\r
 534 <dt>\r
 535 noautologin\r
 536 </dt>\r
 537 <dd>\r
 538 <p>\r
 539 This parameter disables the automatic terminal login only, not touching gdk/kdm.\r
 540 </p>\r
 541 </dd>\r
 542 <dt>\r
 543 noxautologin\r
 544 </dt>\r
 545 <dd>\r
 546 <p>\r
 547 This parameter disables the automatic login of gdm/kdm only, not touching\r
 548 terminals.\r
 549 </p>\r
 550 </dd>\r
 551 <dt>\r
 552 nofastboot\r
 553 </dt>\r
 554 <dd>\r
 555 <p>\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
 559 </p>\r
 560 </dd>\r
 561 <dt>\r
 562 nopersistent\r
 563 </dt>\r
 564 <dd>\r
 565 <p>\r
 566 disables the "persistent" feature, useful if the bootloader (like syslinux) has\r
 567 been installed with persistent enabled.\r
 568 </p>\r
 569 <div class="literalblock">\r
 570 <div class="content">\r
 571 <pre><tt>noprompt</tt></pre>\r
 572 </div></div>\r
 573 </dd>\r
 574 </dl>\r
 575 <p>Do not prompt to eject the CD on reboot.</p>\r
 576 <dl>\r
 577 <dt>\r
 578 nosudo\r
 579 </dt>\r
 580 <dd>\r
 581 <p>\r
 582 This parameter disables the automatic configuration of sudo.\r
 583 </p>\r
 584 </dd>\r
 585 <dt>\r
 586 swapon\r
 587 </dt>\r
 588 <dd>\r
 589 <p>\r
 590 This parameter enables usage of local swap partitions.\r
 591 </p>\r
 592 </dd>\r
 593 <dt>\r
 594 nouser\r
 595 </dt>\r
 596 <dd>\r
 597 <p>\r
 598 This parameter disables the creation of the default user completely.\r
 599 </p>\r
 600 </dd>\r
 601 <dt>\r
 602 noxautoconfig\r
 603 </dt>\r
 604 <dd>\r
 605 <p>\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
 609 </p>\r
 610 </dd>\r
 611 <dt>\r
 612 persistent\r
 613 </dt>\r
 614 <dd>\r
 615 <p>\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
 621 informations.\r
 622 </p>\r
 623 </dd>\r
 624 <dt>\r
 625 {preseed/file|file}=<strong>FILE</strong>\r
 626 </dt>\r
 627 <dd>\r
 628 <p>\r
 629 A path to a file present on the rootfs could be used to preseed debconf\r
 630 database.\r
 631 </p>\r
 632 </dd>\r
 633 <dt>\r
 634 package/question=<strong>VALUE</strong>\r
 635 </dt>\r
 636 <dd>\r
 637 <p>\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
 640 this case.\r
 641 </p>\r
 642 </dd>\r
 643 <dt>\r
 644 quickreboot\r
 645 </dt>\r
 646 <dd>\r
 647 <p>\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
 650 </p>\r
 651 </dd>\r
 652 <dt>\r
 653 showmounts\r
 654 </dt>\r
 655 <dd>\r
 656 <p>\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
 660 installation.\r
 661 </p>\r
 662 <div class="literalblock">\r
 663 <div class="content">\r
 664 <pre><tt>textonly</tt></pre>\r
 665 </div></div>\r
 666 </dd>\r
 667 </dl>\r
 668 <p>Start up to text-mode shell prompts, disabling the graphical user interface.</p>\r
 669 <dl>\r
 670 <dt>\r
 671 timezone=<strong>TIMEZONE</strong>\r
 672 </dt>\r
 673 <dd>\r
 674 <p>\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
 677 </p>\r
 678 </dd>\r
 679 <dt>\r
 680 todisk=<strong>DEVICE</strong>\r
 681 </dt>\r
 682 <dd>\r
 683 <p>\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
 688 time.\r
 689 </p>\r
 690 </dd>\r
 691 <dt>\r
 692 toram\r
 693 </dt>\r
 694 <dd>\r
 695 <p>\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
 699 </p>\r
 700 </dd>\r
 701 <dt>\r
 702 union=<strong>aufs</strong>|<strong>unionfs</strong>\r
 703 </dt>\r
 704 <dd>\r
 705 <p>\r
 706 By default, live-initramfs uses aufs. With this parameter, you can switch to\r
 707 unionfs.\r
 708 </p>\r
 709 </dd>\r
 710 <dt>\r
 711 utc=<strong>yes</strong>|<strong>no</strong>\r
 712 </dt>\r
 713 <dd>\r
 714 <p>\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
 717 </p>\r
 718 </dd>\r
 719 <dt>\r
 720 xdebconf\r
 721 </dt>\r
 722 <dd>\r
 723 <p>\r
 724 Uses xdebconfigurator, if present on the rootfs, to configure X instead of the\r
 725 standard procedure (experimental).\r
 726 </p>\r
 727 </dd>\r
 728 <dt>\r
 729 xvideomode=<strong>RESOLUTION</strong>\r
 730 </dt>\r
 731 <dd>\r
 732 <p>\r
 733 Doesn't do xorg autodetection, but enforces a given resolution.\r
 734 </p>\r
 735 </dd>\r
 736 </dl>\r
 737 </div>\r
 738 <h2>Files</h2>\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
 743 </div></div>\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
 748 </div></div>\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
 756 </div>\r
 757 <h2>See also</h2>\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
 761 </div>\r
 762 <h2>Bugs</h2>\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
 766 </div>\r
 767 <h2>Homepage</h2>\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
 772 </div>\r
 773 <h2>Authors</h2>\r
 774 <div class="sectionbody">\r
 775 <p>live-initramfs is maintained by Daniel Baumann &lt;daniel@debian.org&gt;\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 &lt;tfheen@canonical.com&gt;\r
 779 and Matt Zimmerman &lt;mdz@canonical.com&gt;.</p>\r
 780 </div>\r
 781 <div id="footer">\r
 782 <div id="footer-text">\r
 783 Last updated 01-Nov-2009 04:31:41 CEST\r
 784 </div>\r
 785 </div>\r
 786 </body>\r
 787 </html>\r