/[clonezilla-sysresccd]/trunk/www/boot-params.html
ViewVC logotype

Annotation of /trunk/www/boot-params.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 56 - (hide annotations)
Fri May 21 14:49:03 2010 UTC (13 years, 10 months ago) by sng
File MIME type: text/html
File size: 49512 byte(s)
adding missing icons, fixing icons paths

1 sng 28 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2     <html>
3     <head>
4     <link rel="alternate" type="application/rss+xml" title="RSS" href="http://clonezilla-sysresccd.hellug.gr/clonezilla-sysresccd.rss">
5     <link rel="shortcut icon" href="favicon.ico">
6     <title>Clonezilla-SysRescCD - Documentation: Boot parameters</title>
7     <style type="text/css">
8     body { font-family: Arial, 'sans serif'; color: black; font-size: 12pt; background : url(null) fixed no-repeat; background-color: #333333; padding: 0; margin: 0; margin-top: 5px; margin-bottom: 5px; }
9    
10    
11    
12     #header {position:relative; display: block; width: 980px; height: 121px;margin: auto; padding: auto; background-color: #D37624; background-image: url('images/header.png');clear:both;}
13     #header h2{ color: #FFE6BC; font-weight: bold; font-size: 2.2em; margin:0; padding:0; padding-left: 10px; padding-top: 7px; text-shadow: #333333 2px 2px 4px;}
14     #header h3{ color: #FFE6BC; font-weight: bold; font-size: 1.8em; margin:0; padding: 0; padding-left: 10px; text-shadow: #333333 2px 2px 4px;}
15     #header h4{ color: #FFE6BC; font-weight: bold; font-size: 1.2em; margin:0; padding: 0; padding-left: 10px; padding-right: 10px; text-shadow: #333333 2px 2px 4px;}
16     #header a {text-decoration:none;}
17    
18     #contarea {display: block; width: 980px; margin: auto; padding: auto; background-color: #FFF2DD; clear:both;}
19    
20     #linkline { width: 980px; height: 29px;margin: auto; padding: auto; background-color: #D37624; background-image: url('images/linkline.png');clear:both; }
21     #linkline a{float: left; color: #FFE6BC; font-weight: bold; font-size: 0.8em; text-decoration: none; text-shadow: #333333 2px 2px 4px; padding-left: 10px; padding-right: 10px; padding-top: 5px;}
22     #linkline a:visited{color: #FFE6BC;}
23     #linkline a:hover{color: #333333;}
24     #linkline a.here {color: #333333; text-decoration: none;}
25    
26     #lastupdate {float: right; display: block; text-align: right; margin: 0; margin-top: -1.2em; padding: 0; padding-right: 15px;}
27    
28     #rss { float: right; text-align: right; padding-top: 3px;}
29    
30     #docline-top { float: right; padding-right: 40px; text-align: right; }
31     #docline-bottom { float: right; padding-right: 40px; text-align: right; font-size: 0.8em; padding-top: 15px; }
32     #docline-bottom a{ padding-left: 10px; padding-right: 10px; }
33    
34     #menu { float: right; display: block; width: 170px; margin: auto; padding: 15px; font-size: 0.8em; font-weight: bold; background-color: #FFE6BC;}
35     #menu h1 {color: #990000; font-size: 1.8em;text-shadow: gray 2px 2px 4px;}
36     #menu a,a:visited{ color: black; text-decoration: none; font-weight: normal;}
37     #menu a:hover{ text-decoration: underline;}
38     #menu p{ margin-bottom: 10px;}
39    
40     #content { float: left; display: block; width: 950px; margin: auto; padding: 15px;}
41    
42    
43     #footer {display: block; width: 980px; height: 100px;margin: auto; padding: auto; background-color: #D37624; background-image: url('images/footer.png');clear:both;text-shadow: #333333 2px 2px 4px;}
44     #footer p{color: #FFE6BC; font-weight: bold; padding:15px; padding-left: 10px;}
45     #footer a,a:visited{color: #FFE6BC; font-weight: bold; text-decoration:none;}
46     #footer a:hover{ color: #333333; text-decoration: none;}
47    
48    
49     #content H1,H2,H3,H4{color: #990000; text-align: left;}
50     #content H2{margin-top: 2em;}
51     #content H3{margin-top: 1.5em}
52     #content H4{margin-top: 1em}
53     #content li { margin-top: 1em;}
54     #content a,a:active,a:visited{text-decoration: none; color: #4075CA; font-weight: normal;}
55     #content a:hover{text-decoration: underline; font-weight: normal;}
56     #content .hidden{ display:none; }
57     #content p,td,table,tr,li { font-family: Arial, 'sans serif'; }
58     #content .nav{margin-left: 0pt;}
59     #content .newcode{font-family : "Courier New", Courier, monospace; font-weight: bold; background-color: #F2F2F2; border: solid 1px #DEDEDE;padding: 20pt;}
60     #content .note{margin-top: 30pt; margin-bottom: 30pt; text-align: left; background-color: #FFEFEF; border: double 3px; border-color: #FFD5D5;}
61     #content hr{color: Black; background-color: Black; height: 1px; border: none;}
62     #content .header-news{margin-top: 2em; margin-left: 25pt; font-weight: bold; color: #990000;}
63     #content .item-news{margin-left: 45pt; margin-right: 45pt;}
64     #content .otherpage{border: solid 1px darkgoldenrod; padding: 20pt; background-color: lemonchiffon;}
65     #content IMG {display: block; margin-left: auto; margin-right: auto; }
66     #content .red{color: white; background-color: Red; font-weight: bold;}
67     #lphp{text-align: right; padding-left: 10px; padding-right: 10px; padding-top: 50px; float: right;}
68     #lphp a{padding-left: 5px;}
69     </style>
70     <META NAME="Keywords" CONTENT="multiboot Multi Boot bootable cd rescue clonezilla sysresccd backup restore samba">
71     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
72    
73     </head>
74    
75     <body>
76     <div id="header">
77 sng 37 <div id="lphp" style=""><a target="_blank" href="onepage.html"><img src="images/chain.png" border="0" /></a><a target="_blank" href="printable.php"><img src="images/print_it.png" border="0" /></a></div>
78 sng 28 <H2>Clonezilla-SysRescCD</H2>
79     <H3>Documentation: Boot parameters</H3>
80     <div style="margin:0; padding: 3px; width: 980; position relative;">
81 sng 38 <div style="position: absolute; left: 0px;"><H4>26/03/2010 - v 3.1.0</H4></div>
82 sng 56 <div style="position: absolute; right: 0px;"><H4>Last update: 21/05/2010</H4></div>
83 sng 28 </div>
84     </div>
85     <div id="linkline">
86     <a href="index.html">Home</a>
87     <a href="news.php">News</a>
88     <!-- <a href="features.html">Features</a>-->
89     <a class="here" href="doc.html">Documentation</a>
90     <a href="index.html#download">Download</a>
91     <a href="screenshots.html">Screenshots</a>
92     <a href="index.html#credits">Credits</a>
93     <a href="help.html">Help</a>
94    
95     <div id="rss">
96     <a href="clonezilla-sysresccd.rss"><img src="images/rss-orange-11.png" width="30" height="14" border="0"/></a>
97     </div>
98     <!-- docline-top-->
99     <div id="docline-top"> <a href="usb.html">&lt; PREV</a> <a href="doc.html">UP</a> <a href="clonezilla.html">NEXT &gt;</a> </div>
100     </div>
101     <div id="contarea">
102     <div id="content">
103     <a name="boot-top"></a>
104    
105    
106     <!-- Intro -->
107    
108     <H2 style="margin-top: 0;"><a name="boot-intro"></a>Intro <span class="hideprint">[<a href="#boot-top" title="go to top of the page">^</a>]</span></H2>
109     <p>Booting a linux system means loading a kernel, which is actually the operating system. Well, this is not exactly true, and it is not the only thing that happens during boot up phase, but it is not my intension to explain it here.
110     <br><br>
111     The kernel is loaded by Isolinux (the CD boot manager), which is able to pass a number of parameters to it, through its configuration file <b>isolinux.cfg</b>.
112     <br><br>
113     These parameters, called boot parameters, are documented by the kernel itself, and can differentiate its behavior dramatically. In our case, each CD (SystemRescueCD and Clonezilla Live) accept a different set of parameters, because they are based on <a href="http://www.gentoo.org/" target="_blank">gentoo</a> and <a href="http://www.debian.org/" target="_blank">debian</a>, respectively.
114     <br><br>
115     While in the splash screen of <b>Clonezilla-SysRescCD</b>, you can edit the boot parameters by pressing TAB. They will be presented to you, and you can add or remove what you want. You must be careful not to change or remove the parameters that are dedicated to the CD itself, as altering them will certainty make it unbootable. When you are done, just press ENTER to boot.
116     </p>
117    
118    
119     <!-- sysresccd -->
120     <H2><a name="sysresccd"></a>SystemRescueCD boot parameters <span class="hideprint">[<a href="#boot-top" title="go to top of the page">^</a>]</span></H2>
121     <!-- note -->
122     <div align="center"><table class="note" border="0" cellpadding="20"><tr><td valign="top"><img src="images/info.png"></td><td>
123     The following info applies to <b>SystemRescueCD v. 1.3.5</b>. In case<br>
124     you need to get info for a more recent version of <b>SystemRescueCD</b><br>
125     please see the page "<a href="http://www.sysresccd.org/Sysresccd-manual-en_Booting_the_CD-ROM" target="_blank">Sysresccd-manual-en Booting the CD-ROM</a>"
126     </td></tr></table></div>
127     <p>A typical sysresccd isolinux entry is:</p>
128    
129     <p class="newcode">kernel rescuecd<br>
130     append initrd=initram.igz video=ofonly</p>
131     <!--empty-line-->
132     <p>The kernel used is <b>rescuecd</b>, and anything after the word <b>append</b> is a boot parameter.<br><br>
133     <!--empty-line-->
134     Available kernels (boot images):</p>
135    
136     <ul class="otherpage" style="padding: 0px 10px 20px 40px">
137 sng 56 <!-- Please do not delete these comented lines-->
138     <!-- SysRescCD documentation section. Please use "update-boot-params" script to update -->
139     <!--kernels-Documentation-->
140     <li><b>rescuecd</b> Default for 32bit systems, with Framebuffer disabled, best choice.
141     </li><li><b>rescue64</b> Default 64 bit kernel. Use it if you want to chroot to a 64bit linux system installed on your hard disk, or if you have to run 64 bits programs. This kernel is able to boot with 32bit programs, and it requires a processor with 64bit instructions (amd64 / em64t).
142     </li><li><b>altker32</b> an alternative kernel for 32bit systems. Boot with this kernel if you have problems with <b>rescuecd</b>
143     </li><li><b>altker64</b> an alternative kernel for 64bit systems. Boot with this kernel in case you have problems with <b>rescue64</b>.
144     </li>
145 sng 28 </ul>
146    
147     <p><br>The boot parameters you can use are:</p>
148     <div class="otherpage">
149 sng 40 <!-- Please do not delete these comented lines-->
150     <!-- SysRescCD documentation section. Please use "update-boot-params" script to update -->
151     <!--SysRescCD-Documentation-->
152 sng 56 <a name="General_boot_options" id="General_boot_options"></a><p><b> General boot options</b></p>
153 sng 40 <p>Press &lt;TAB&gt; to add additional options.
154     </p>
155     <ul><li><b>docache</b>: causes the CD-ROM will be fully loaded into memory. A slower start but once complete, programs start faster and the CD drive will be released allowing normal access to other CDs. This requires 400MB of memory to cache everything (including the <code>bootdisks</code> and <code>isolinux</code> directories). Add <code>lowmem</code> if you have less that 400MB of memory of to prevent these directories to be copied.
156 sng 28 </li></ul>
157 sng 40 <p>During boot you will be prompted for the keyboard configuration, avoid this by using
158     </p>
159     <ul><li><b>setkmap=kk</b>: which defines the keymap to load where <code>kk</code> (example: <code>setkmap=de</code> for German keyboards)
160 sng 56 </li><li><b>root=/dev/xdnp</b>: the <a target="_blank" href="http://www.sysresccd.org/news/2008/06/05/use-systemrescuecd-to-boot-a-linux-os-from-the-hard-disk/" class="external text" title="http://www.sysresccd.org/news/2008/06/05/use-systemrescuecd-to-boot-a-linux-os-from-the-hard-disk/" rel="nofollow">root=&lt;device&gt; option</a> boots an existing linux system. For example, if you have linux Gentoo installed on <code>/dev/sda6</code>, use <code>rescuecd root=/dev/sda6</code> to start it. Keep in mind that you must use a 64bit kernel if your system is made of 64bit programs. This option works with LVM volumes. Use <code>rescuecd root=/dev/VolGroup00/LogVol00</code>. Support is also provided for <code>root=auto</code>, which scans all the block devices tfor a linux system. The first linux system found will be started. So with <code>root=auto</code> let you start the system installed from the CD-ROM in case you have problem with your boot loader or kernel. It's also possible to specify a partition using its <code>filesystem label</code> or <code>filesystem uuid</code>. If the label of the partition where linux is installed is <code>mylinux</code>, then boot it using <code>rescuecd root=LABEL=mylinux</code>. Similarly <code>root=UUID=b3d3bec5-997a-413e-8449-0d0ec41ccba7</code>. See <a target="_blank" href="http://www.sysresccd.org/news/2008/06/05/use-systemrescuecd-to-boot-a-linux-os-from-the-hard-disk/" class="external text" title="http://www.sysresccd.org/news/2008/06/05/use-systemrescuecd-to-boot-a-linux-os-from-the-hard-disk/" rel="nofollow">more details</a>.
161 sng 40 </li><li><b>initscript=service:action</b>: This options allows start/stop a service at boot time. For instance if you need the samba service to be started, you can boot with: <code>initscript=samba:start</code>. This does the same thing as <code>/etc/init.d/samba start</code>. Use this option multiple times for different services. All the actions that are supported by an initscript can be used.
162 sng 56 </li><li><b>backstore=xxx</b>: SystemRescueCd comes with support for the <a target="_blank" href="http://www.sysresccd.org/news/2008/06/29/creating-a-backing-store-to-keep-your-modifications-in-sysresccd/" class="external text" title="http://www.sysresccd.org/news/2008/06/29/creating-a-backing-store-to-keep-your-modifications-in-sysresccd/" rel="nofollow">backing-stores</a>. A backing-store saves all the changes you can make. so that you keep these changes the next time you boot it. By default, sysresccd automatically scan removable devices (eg: USB sticks) at boot time and uses the first backing-store it finds. A backing-store is not mandatory and it the scan fails it will store the files which change in memory. To disable the disks scan at boot time specify <code>backstore=off</code> on the boot command line. If you want to save your backing-store file on an harddisk, boot with <code>backstore=alldev</code> to scan all devices (not just removable devices). The default location for backing-stores file is any file named <code>sysrcd.bs</code> located at the root of a disk which is often an USB stick. Change the path by using <code>backstore=/sysrcd/mybackstore.bs</code>. See <a target="_blank" href="http://www.sysresccd.org/news/2008/06/29/creating-a-backing-store-to-keep-your-modifications-in-sysresccd/" class="external text" title="http://www.sysresccd.org/news/2008/06/29/creating-a-backing-store-to-keep-your-modifications-in-sysresccd/" rel="nofollow">backing-stores</a>.
163     </li><li><b>isoloop=xxx</b>: Grub2 (currently in development: grub-1.98) provides a new feature to boot from an ISO image which is stored from the hard disk. If you put a copy of <code>systemrescuecd-x86-x.y.z.iso</code> on a partition that Grub2 can read then you can boot SystemRescueCd directly from the ISO image stored on your hard drive. This is very convenient if you frequently update SystemRescueCd and you want to boot it directly from Grub2. Grub2 knows what an ISO image is and it will load the kernel image (rescuecd/rescue64) and the initramfs (initram.igz) from the ISO into memory. It will then do its normal job and execute the kernel. The SystemRescueCd init script must then be aware that its <code>sysrcd.dat</code> file is in an ISO and not directly on the partition. For that reason, this <code>isoloop=xxx</code> boot option is required so you must use it in your <code>grub.cfg</code>. This option is only supported in SystemRescueCd-1.4.0 and more recent. This option specifies the path of the ISO image in the partition that grub considers as its root partition. It's important to understand that the path of the ISO image may be different from the path on your linux system. If you have a separate boot partition mounted on <code>/boot</code> and if you copy this ISO image to <code>/boot/sysrcd/systemrescuecd-x86-x.y.z.iso</code> then the option has to be <code>isoloop=/sysrcd/systemrescuecd-x86-x.y.z.iso</code>. This is because the boot partition is what Grub2 will consider as its root partition during the boot process. Please read <a target="_blank" href="http://www.sysresccd.org/Sysresccd-manual-en_Easy_install_SystemRescueCd_on_harddisk#Boot_the_ISO_image_from_the_disk_using_Grub2" title="Sysresccd-manual-en Easy install SystemRescueCd on harddisk">the section about isoloop</a> for more details.
164 sng 28 </li></ul>
165 sng 56 <a name="Hardware.2C_drivers_and_troubleshooting_options" id="Hardware.2C_drivers_and_troubleshooting_options"></a><p><b><br> Hardware, drivers and troubleshooting options</b></p>
166 sng 40 <ul><li><b>dodebug</b>: Enables verbose messages in linuxrc
167     </li></ul>
168     <ul><li><b>doload=xxx</b>: loads needed modules, multiple occurrences are permitted (example: <code>doload=3c59x</code>)
169     </li><li><b>noload=xxx</b>: prevents loading modules, multiple occurrences are permitted (example: <code>noload=3c59x</code>). Use this option if you have a problem when the system loads a particular module.
170     </li><li><b>nonet</b>: this will disable the network auto detection at startup
171     </li></ul>
172     <ul><li><b>scandelay=x</b>: pauses x seconds during the startup to allow slow devices to initialize. This is required when you boot an USB device. A delay of only few seconds should be enough.
173     </li></ul>
174     <ul><li><b>doxdetect</b>: Since version 0.3.5 the auto-configuration is done in X.Org itself, mkxf86config is disabled by default. This option forces the system to run the mkxf86config startup script and to run the hardware auto-detection from this script. Use this option if you have problems with the graphical environment configuration. This option replaces the option <code>noxdetect</code> that was useful in previous versions.
175     </li><li><b>nodetect</b>: prevents generic hardware auto-detection. Use this option if you have problems with the hardware auto-detection.
176     </li></ul>
177     <ul><li><b>dostartx</b>: load the X.Org graphical environment.
178     </li><li><b>forcevesa</b>: Forces X.Org to use the safe VESA driver instead of the best video driver detected for your video card. Use this option if you cannot get the graphical environment working with the default options.
179     </li><li><b>forcevesa=xxx</b>: The <code>startx</code> command will load the <code>Xvesa</code> server instead of <code>Xorg</code>, and use the screen resolution given as parameter (eg: <code>1024x768</code>, <code>1280x1024x32</code>).
180     </li></ul>
181     <ul><li><b>all-generic-ide</b>: In case of problems related to your hard disk, try to enable this option (eg <code>rescuecd all-generic-ide</code>)
182     </li><li><b>nodmraid</b>: Disable dmraid, for some motherboards with built-in RAID controller.
183     </li><li><b>nomdadm</b>: Disable mdadm, for software RAID.
184     </li></ul>
185     <ul><li><b>acpi-off</b> / <b>noapic</b> / <b>irqpool</b>: use these options if you have problem when the kernel boots: if it hangs on a driver or if it crashes, ...
186     </li></ul>
187     <ul><li><b>lowmem</b>: For systems with smaller memory, some daemons are not started including sshd and nfsd.
188     </li></ul>
189     <ul><li><b>skipmount=/dev/xxx</b>: The system mounts all the storage devices at boot time to find the sysrcd.dat file. If your hard disk is broken it should be mounted. Boot with <code>skipmount=/dev/sda1 skipmount=/dev/sda2</code> to ignore these two partitions.
190     </li></ul>
191 sng 56 <a name="Network_configuration_and_remote_access" id="Network_configuration_and_remote_access"></a><p><b><br> Network configuration and remote access</b></p>
192 sng 40 <ul><li><b>dodhcp</b>: to request a DHCP server provide network attributes including an IP address, gateway... . otherwise,
193     </li><li><b>ethx=ipaddr/cidr</b>: Sets the static IP address of all the ethernet interfaces on the system. The <code>/cidr</code> extension is optional. For instance, if you use option <code>ethx=192.168.0.1</code> on a machine with two ethernet adapters, both <code>eth0</code> and <code>eth1</code> will be configured with <code>192.168.0.1</code>. You can use the format <code>ethx=10.0.0.1/24</code> (using the cidr notation) if you don't use the default netmask.
194     </li><li><b>eth0=ipaddr/cidr</b>: This option is similar to <code>ethx=ipaddr/cidr</code> but it configures only one interface at a time. To configure the network on a server that has two interfaces, use: <code>eth0=192.168.10.1/24 eth1=192.168.20.1</code>.
195 sng 28 </li><li><b>dns=ipaddr</b>: Sets the static IP address of the DNS nameserver you want to use to resolve the names. For instance <code>dns=192.168.0.254</code> means that you want to use <code>192.168.0.254</code> as the DNS server.
196     </li><li><b>gateway=ipaddr</b>: Sets the static IP address of the default route on your network. For instance <code>gateway=192.168.0.254</code> means that the computer can connect to a computer outside of the local network via <code>192.168.0.254</code>.
197     </li><li><b>dhcphostname=myhost</b>: Sets the hostname that the DHCP client will send to the DHCP server. This may be required if the default hostname cannot be used with your DHCP configuration. This option has been introduced in SystemRescueCd-1.3.5.
198     </li><li><b>rootpass=123456</b>: Sets the root password of the system running on the livecd to <code>1234</code>. That way you can connect from the network and ssh on the livecd and give <code>123456</code> password as the root password.
199 sng 56 </li><li><b>vncserver=x:123456</b>: The <a target="_blank" href="http://www.sysresccd.org/news/2008/04/12/use-systemrescuecd-remotely-with-vnc-server/" class="external text" title="http://www.sysresccd.org/news/2008/04/12/use-systemrescuecd-remotely-with-vnc-server/" rel="nofollow">vncserver boot option</a> has been introduced in SystemRescueCd-1.0.2. This options forces the system to configure the VNC-server and to start it automatically at boot time. You have to replace <code>x</code> with the number of displays you want, and <code>123456</code> with your password The password must be between 5 and 8 characters, else the boot option will be ignored. In other words the <code>vncserver=2:MyPaSsWd</code> option will give you access to two displays (display=1 on tcp/5901 and display=2 on tcp/5902). Display 0 is reserved for X.Org since SystemRescueCd-1.1.0.
200     </li><li><b>nameif=xxx</b>: You can can <a target="_blank" href="http://www.sysresccd.org/news/2008/06/28/option-to-define-the-name-of-a-network-interface-using-the-mac-address/" class="external text" title="http://www.sysresccd.org/news/2008/06/28/option-to-define-the-name-of-a-network-interface-using-the-mac-address/" rel="nofollow">specify what interface name to give</a> to a particular interface using the mac address. You need SystemRescueCd-1.1.0 or newer to do that. Here is how you can specify which interface is using which mac address on a machine with two network interfaces: <code>nameif=eth0!00:0C:29:57:D0:6E,eth1!00:0C:29:57:D0:64</code>. Be careful, you have to respect the separator (comma between the interfaces and exclamation marks between the name and the mac address).
201 sng 28 </li></ul>
202 sng 56 <a name="Network_boot_using_PXE" id="Network_boot_using_PXE"></a><p><b><br> Network boot using PXE</b></p>
203 sng 40 <p>SystemRescueCd provides several options for booting from the network using PXE.
204 sng 56 These options can be combined with other network boot options such as <code>ethx</code> (cf previous section). See <a target="_blank" href="http://www.sysresccd.org/Sysresccd-manual-en_PXE_network_booting" class="external text" title="http://www.sysresccd.org/Sysresccd-manual-en_PXE_network_booting" rel="nofollow">PXE network booting</a> to get a global overview of SystemRescueCd and PXE and <a target="_blank" href="http://www.sysresccd.org/Sysresccd-manual-en_Manage_remote_windows_linux_servers_using_SystemRescueCd" class="external text" title="http://www.sysresccd.org/Sysresccd-manual-en_Manage_remote_windows_linux_servers_using_SystemRescueCd" rel="nofollow">Manage remote servers using PXE</a>.
205 sng 40 </p><p>The second stage downloads the kernel + initramfs using DHCP/TFTP.
206     </p><p>The third stage of the PXE boot process acquires the root files system.
207     </p><p>Several protocols are available.
208     </p>
209     <ul><li><b>netboot=</b>tftp<b>://ip/path/sysrcd.dat</b>: from a TFTP server. The filesystem is loaded into memory. As a consequence computers with less than 400MB of memory won't be able to boot this way. The system will continue to work if the network is disconnected after the boot process.
210     </li><li><b>netboot=</b>http<b>://ip:port/path/sysrcd.dat</b>: from a Web server. The file system is loaded into memory. Computers with smaller memory won't be able to boot this way. The the system continues to work if the network is disconnected after the boot process.
211     </li><li><b>netboot=</b>nfs<b>://ip:/path</b>: mount an NFSv3 directory. The NFS url must be the path of the directory that contains <code>sysrcd.dat</code>. Only NFSv3 can be used, NFSv4 is not supported. NFS it allows computers with smaller memory to boot SystemRescueCd from the network. After the boot process, the connection is required or you will loose the access to the root file system.
212     </li><li><b>netboot=</b>nbd<b>://ip:port</b>: connect to an NBD server configured with <code>sysrcd.dat</code> on ip:port. NBD is easier to configure than NFS (only one TCP port involved) and it allows computers with smaller memort to boot SystemRescueCd from the network. After the boot process, the connection is required the access to the root system.
213     </li></ul>
214 sng 56 <p>For information on activating <b>speakup</b>, see the <a target="_blank" href="http://www.sysresccd.org/Speakup-info" title="Speakup-info">speakup info page</a>.
215 sng 40 </p>
216 sng 56 <a name="Options_provided_for_autorun" id="Options_provided_for_autorun"></a><p><b><br> Options provided for autorun</b></p>
217     <ul><li><b>ar_source=xxx</b>: place where the autorun are stored. It may be the root directory of a partition (<code>/dev/sda1</code>), an nfs share (<code>nfs://192.168.1.1:/path/to/scripts</code>), a samba share (<code>smb://192.168.1.1/path/to/scripts</code>), or an http directory (<code><a target="_blank" href="http://192.168.1.1/path/to/scripts" class="external free" title="http://192.168.1.1/path/to/scripts" rel="nofollow">http://192.168.1.1/path/to/scripts</a></code>).
218 sng 40 </li><li><b>autoruns=[0-9]</b>: comma separated list of the autorun scrip to be run. For example <code>autoruns=0,2,7</code> the autorun sc <code>autorun0</code>, <code>autorun2</code>, <code>autorun7</code> are run. Use <code>autoruns=no</code> to disable all the autorun scripts with a number.
219 sng 28 </li><li><b>ar_ignorefail</b>: continue to execute the scripts chain even if a script failed (returned a non-zero status)
220     </li><li><b>ar_nodel</b>: do not delete the temporary copy of the autorun scripts located in <code>/var/autorun/tmp</code> after execution
221     </li><li><b>ar_disable</b>: completely disable autorun, the simple <code>autorun</code> script will not be executed
222     </li><li><b>ar_nowait</b>: do not wait for a keypress after the autorun script have been executed.
223     </li></ul>
224 sng 40 </p>
225 sng 28 </div>
226    
227    
228     <!-- Clonezilla -->
229     <H2><a name="clonezilla"></a>Clonezilla Live boot parameters <span class="hideprint">[<a href="#boot-top" title="go to top of the page">^</a>]</span></H2>
230     <!-- note -->
231     <div align="center"><table class="note" border="0" cellpadding="20"><tr valign="top"><td><img src="images/info.png"></td><td>
232     The following info applies to <b>Clonezilla Live v. 1.2.3-27</b><br>
233     In case you need to get info for a more recent version of <b>Clonezilla Live</b><br>
234     please see the page "<a href="http://www.clonezilla.org/clonezilla-live/doc/fine-print.php?path=./99_Misc/00_live-initramfs-manual.doc#00_live-initramfs-manual.doc" target="_blank">The boot parameters for Clonezilla live</a>"
235     </td></tr></table></div>
236    
237     <p>A typical Clonezilla Live isolinux entry is:</p>
238    
239     <p class="newcode"> kernel /live/vmlinuz1<br>
240     append initrd=/live/initrd1.img boot=live union=aufs ocs_live_run="ocs-live-general"<br>
241     ocs_live_extra_param="" ocs_live_keymap="" ocs_live_batch="no" ocs_lang="" vga=791 nolocales</p>
242     <!--empty-line-->
243     <p>The kernel used is <b>vmlinuz</b>, and anything after the word <b>append</b> is a boot parameter.</p>
244     <!--empty-line-->
245    
246    
247     <p>The following info comes from the page titled <a href="http://www.clonezilla.org/clonezilla-live/doc/fine-print.php?path=./99_Misc/00_live-initramfs-manual.doc#00_live-initramfs-manual.doc" target="_blank">The boot parameters for Clonezilla live</a>.</p>
248    
249 sng 40 <!-- Please do not delete these comented lines-->
250     <!-- Clonezilla documentation section. Please use "update-boot-params" script to update -->
251     <!--Clonezilla-Documentation-->
252 sng 56 <div class="otherpage">Clonezilla live is based on <a target="_blank" href="http://wiki.debian.org/DebianLive/" >Debian live</a> with clonezilla installed. Therefore there are 2 kinds of boot parameters:
253 sng 28 <ol>
254 sng 41 <li>Boot parameters from live-initramfs. You can refer to this <a href="#live-initramfs">manual of live-initramfs</a>.
255 sng 28 <li>Boot parameters specially for Clonezilla. All of them are named as "ocs_*", e.g. ocs_live_run, ocs_live_extra_param, ocs_live_batch, ocs_lang.
256     <ul>
257     <li>ocs_live_run is the main program to run in Clonezilla live to save or restore. or other command. Available program: ocs-live-general, ocs-live-restore or any command you write. Use the Absolute path in Clonezilla live.<br>
258 sng 40 e.g. ocs_live_run="ocs-live-general"<br>
259     <font color="red">//NOTE// You might have to use "sudo" command inside your own script, or you can assign it like: ocs_live_run="sudo bash /my-clonezilla"</font><br>
260 sng 28 <li>ocs_live_extra_param will be used only when ocs_live_run=ocs-live-restore (not for ocs-live-general or any other), then it will be passed to ocs-sr. Therefore these parameters are actually those of ocs-sr.<br>
261     e.g. ocs_live_extra_param="-b -c restoredisk sarge-r5 hda"
262     <li>ocs_live_keymap is for keymap used in Clonezilla live. Man install-keymap for more details.<br>
263     e.g. ocs_live_keymap="NONE" (won't change the default layout)<br>
264     ocs_live_keymap="/usr/share/keymaps/i386/azerty/fr-latin9.kmap.gz" (French keyboard)
265     <li>batch mode or not (yes/no), if no, will run interactively.<br>
266     e.g. ocs_live_batch="no"
267     <li>ocs_lang is the language used in Clonezilla live. Available value: en_US.UTF-8, zh_TW.UTF-8... (see $DRBL_SCRIPT_PATH/lang/bash/)
268     e.g. ocs_lang="en_US.UTF-8"
269     <li>ocs_debug (or ocs-debug) is for you to enter command line prompt before any clonezilla-related action is run. This is easier for you to debug.
270     <li>ocs_daemonon, ocs_daemonoff, ocs_numlk, ocs_capslk.<br>
271     Ex. for the first 2 parameters, ocs_daemonon="ssh", then ssh service will be turned on when booting. For the last 2 parameters, use "on" or "off", e.g. ocs_numlk=on to turn on numberlock when booting.
272     <li>ocs_prerun, ocs_prerun1, ocs_prerun2... is for you to run a shell script before Clonezilla is started. E.g. ocs_prerun="/live/image/myscript.sh". If you have more commands to run, you can assign them in the order: ocs_prerun=..., ocs_prerun1=..., ocs_prerun2=.... If more than 10 parameters, remember to use ocs_prerun01, ocs_prerun02..., ocs_prerun11 to make it in order.
273 sng 40 <li>ocs_live_run_tty. This option allows you to specify the tty where $ocs_live_run is run. By default $ocs_live_run is run on /dev/tty1 only. (It was also on /dev/ttyS0 before, but since Clonezilla live >= 1.2.3-22 no more this due to a problem). If you want to use ttyS0, for example, add live-getty and console=ttyS0,38400n81 in the boot parameter.<br>
274     <font color=red>//NOTE//</font><br>
275     <ul>
276     <li>This parameter was added in Clonezilla live 1.2.3-22 or later.
277     <li>If "live-getty console=$tty,38400n81" are assigned in the boot parameters, ocs_live_run_tty will honor $tty, even other value is assigned to ocs_live_run_tty in boot parameter.
278     <li>It's recommended to assign ocs_lang and ocs_live_keymap in the boot parameters too.
279     </ul>
280     <li>ip, this option allows you to specify the network parameters for network card. In Clonezilla live a patched live-initramfs is used, which is different from the original live-initramfs so that you can assign DNS server, too. Its format is: ip=ethernet port,IP address, netmask, gateway, DNS. E.g. If you want to assing eth0 with IP address 10.0.100.1, netmask 255.255.255.0, gateway 10.0.100.254, DNS server 8.8.8.8, you can assign the following in the boot parameter:<br>
281     ip=eth0,10.0.100.1,255.255.255.0,10.0.100.254,8.8.8.8<br>
282     If more than one network card, you can use ":" to separate them, e.g.:<br>
283     ip=eth0,10.0.100.1,255.255.255.0,10.0.100.254,8.8.8.8:eth1,192.168.120.1,255.255.255.0,192.168.120.254,,<br>
284 sng 28 <li>Besides, "live-netdev" (yes, not ocs_live_netdev) can be used when using PXE booting, you can force to assign the network device to get filesystem.squashfs. This is useful when there are two or more NICs are linked. E.g. live-netdev="eth1" allows you to force the live-initramfs to use eth1 to fetch the root file system filesystem.squashfs.
285     </ul>
286     </ol>
287     <hr>
288    
289     With the above options, we have the following examples:
290     <ol>
291     <li>A PXE config example for you to boot Clonezilla live via PXE, and ssh service is on, the password of account "user" is assigned:<br>
292     ----------------------------------------<br>
293     label Clonezilla Live<br>
294     MENU LABEL Clonezilla Live<br>
295     MENU DEFAULT<br>
296     kernel vmlinuz1<br>
297     append initrd=initrd1.img boot=live union=aufs noswap noprompt vga=788 fetch=tftp://192.168.120.254/filesystem.squashfs usercrypted=bkuQxLqLRuDW6 ocs_numlk="on" ocs_daemonon="ssh"<br>
298     ----------------------------------------<br>
299    
300     The usercrypted password is created by:<br>
301     echo YOUR_PASSWORD | mkpasswd -s<br>
302     ("mkpasswd" is from package "whois" in Debian or Ubuntu. Check your GNU/Linux to see which package provides this command if you are not using Debian or Ubuntu. Replace YOUR_PASSWORD with your plain text password, and remember do not put any " in the boot parameters of live-initramfs (while it's ok for those ocs_* boot parameters), i.e. do NOT use something like usercrypted="bkuQxLqLRuDW6").<br>
303     //NOTE// If you do not assign salt to mkpasswd, the encrypted password will not be the same every time you create it.<br>
304     For more about usercrypted discussion, please check the <a href="http://lists.debian.org/debian-live/2008/10/msg00020.html" target=_blank>here</a>.
305     <br><br>
306     <li>How to put your own binary driver in Clonezilla live without modifying /live/filesystem.squashfs:
307     <ul>
308     <li>Boot clonezilla live
309     <li>Become root by running "sudo su -"
310     <li>Copy the dir lsi, which contains a precompiled kernel module matching the running kernel in Clonezilla live and a script to run it, to a working dir, e.g.: <br>
311     cp -r /live/image/lsi /home/partimag
312     <li>cd /home/partimag
313     <li>/opt/drbl/sbin/ocs-live-dev -c -s -i lsi -u lsi -x "ocs_prerun=/live/image/lsi/prep-lsi.sh"
314     <li>/opt/drbl/sbin/ocs-iso -s -i lsi -u lsi -x "ocs_prerun=/live/image/lsi/prep-lsi.sh"
315     <li>///NOTE/// In this example, the 2 files in dir lsi are: megasr.ko (the binary driver) and prep-lsi.sh. The contents of prep-lsi.sh:
316     <pre>
317     ------------------------
318     #!/bin/bash
319     cp -f /live/image/lsi/megasr.ko /lib/modules/`uname -r`/kernel/drivers/block/
320     chown root.root /lib/modules/`uname -r`/kernel/drivers/block/megasr.ko
321     depmod -a modprobe megasr
322     sleep 1
323     ------------------------
324     </pre>
325     </ul>
326    
327     <li>To put your customized script with a PXE version of Clonezilla live (You have to use Clonezilla live version 1.2.2-2 or later):<br>
328     In this example, we assume (1) The IP address of your PXE server is 192.168.120.254, (2) the customized script (custom-ocs-2) is put on your PXE server's tftpd root dir (E.g. On DRBL server, the path is /tftpboot/nbi_img/. It might be different in your case if you are not use DRBL server as a PXE server).<br>
329     Therefor your pxelinux.cfg/default file is like:
330     <p>------------------------<br>
331     label Clonezilla Live<br>
332     MENU DEFAULT<br>
333     # MENU HIDE<br>
334     MENU LABEL Clonezilla Live<br>
335     # MENU PASSWD<br>
336     kernel vmlinuz1<br>
337     append initrd=initrd1.img boot=live union=aufs noswap noprompt vga=788 ip=frommedia fetch=tftp://192.168.120.254/filesystem.squashfs ocs_prerun="busybox tftp -g -b 10240 -r custom-ocs-2 -l /tmp/custom-ocs-2 192.168.120.254" ocs_live_run="bash /tmp/custom-ocs-2" ocs_live_keymap="NONE" ocs_live_batch="no" ocs_lang="en_US.UTF-8" nolocales<br>
338     TEXT HELP<br>
339     Boot Clonezilla live via network<br>
340     ENDTEXT<br>
341     <p>------------------------<br>
342     The content of custom-ocs-2 can be like:
343     <pre>
344     ------------------------
345     #!/bin/bash
346     . /opt/drbl/sbin/drbl-conf-functions
347     . /opt/drbl/sbin/ocs-functions
348     . /etc/ocs/ocs-live.conf
349    
350     # Load language file
351     ask_and_load_lang_set en_US.UTF-8
352    
353     # 1. Mount the clonezilla image home.
354     # Types: local_dev, ssh_server, samba_server, nfs_server
355     prep-ocsroot -t nfs_server
356    
357     # 2. Restore the image
358     if mountpoint /home/partimag/ &>/dev/null; then
359     ocs-sr -l en_US.UTF-8 -c -p choose restoredisk ask_user ask_user
360     else
361     [ "$BOOTUP" = "color" ] && $SETCOLOR_FAILURE
362     echo "Fail to find the Clonezilla image home /home/partimag!"
363     echo "Program terminated!"
364     [ "$BOOTUP" = "color" ] && $SETCOLOR_NORMAL
365     fi
366     ------------------------
367     </pre>
368     </li>
369     </ol>
370     </div>
371     <!-- End of copy/paste 3 -->
372    
373     <H3><a name="live-initramfs"></a>live-initramfs manual <span class="hideprint">[<a href="#boot-top" title="go to top of the page">^</a>]</span></H3>
374    
375     <p>This is the manual of <a href="http://www.clonezilla.org/clonezilla-live/live-initramfs-param.php" target=_blank>live-initramfs</a>
376     <BR>
377     </p>
378    
379 sng 56 <!-- Please do not delete these comented lines-->
380     <!-- SysRescCD documentation section. Please use "update-boot-params" script to update -->
381     <!--initramfs-Documentation-->
382     <a name="live-initramfs"></a><div class="otherpage" style="overflow: auto;"><pre>
383 sng 28 live-initramfs(7)
384     =================
385    
386     Name
387     ----
388     live-initramfs - Debian Live initramfs hook
389    
390     Synopsis
391     --------
392     BOOT=live
393    
394     as kernel parameter at boot prompt.
395    
396     Description
397     -----------
398    
399     live-initramfs is a hook for the initramfs-tools, used to generate a initramfs
400     capable to boot live systems, such as those created by *live-helper*(7).
401     This includes the Debian Live isos, netboot tarballs, and usb stick images.
402    
403     At boot time it will look for a (read-only) media containing a "/live"
404     directory where a root filesystems (often a compressed filesystem image like
405     squashfs) is stored. If found, it will create a writable environment, using
406     aufs, for Debian like systems to boot from.
407    
408     You probably do not want to install this package onto a non-live system,
409     although it will do no harm.
410    
411 sng 56 live-initramfs is a fork of <a href="http://packages.ubuntu.com/casper/" target="_blank">casper</a>.
412     casper was originally written by Tollef Fog Heen &amp;lt;tfheen@canonical.com&amp;gt;
413     and Matt Zimmerman &amp;lt;mdz@canonical.com&amp;gt;.
414 sng 28
415     Boot options
416     ------------
417    
418     Here is the complete list of recognized boot parameters by live-initramfs.
419    
420 sng 56 access=*ACCESS*::
421 sng 28
422     Set the accessibility level for physically or visually impared users. ACCESS
423     must be one of v1, v2, v3, m1, or m2. v1=lesser visual impairment, v2=moderate
424     visual impairment, v3=blindness, m1=minor motor difficulties, m2=moderate motor
425     difficulties.
426    
427 sng 56 console=*TTY,SPEED*::
428 sng 28
429     Set the default console to be used with the "live-getty" option. Example:
430     "console=ttyS0,115200"
431    
432 sng 56 debug::
433 sng 28
434     Makes initramfs boot process more verbose.
435    
436 sng 56 fetch=*URL*::
437 sng 28
438     Another form of netboot by downloading a squashfs image from a given url,
439     copying to ram and booting it.
440    
441 sng 56 hostname=*HOSTNAME*, username=*USER*, userfullname=*USERFULLNAME*::
442 sng 28
443     Those parameters lets you override values read from the config file.
444    
445 sng 56 ignore_uuid
446 sng 28
447     Do not check that any UUID embedded in the initramfs matches the discovered
448     medium. live-initramfs may be told to generate a UUID by setting
449     LIVE_GENERATE_UUID=1 when building the initramfs.
450    
451 sng 56 integrity-check::
452 sng 28
453     If specified, an MD5 sum is calculated on the live media during boot and
454     compared to the value found in md5sum.txt found in the root directory of the
455     live media.
456    
457 sng 56 ip=**[CLIENT_IP]:[SERVER_IP]:[GATEWAY_IP]:[NETMASK]:[HOSTNAME]:
458     [DEVICE]:[AUTOCONF] [,[CLIENT_IP]:[SERVER_IP]:[GATEWAY_IP]:[NETMASK]:[HOSTNAME]:
459     [DEVICE]:[AUTOCONF]]***::
460 sng 28
461     Let you specify the name(s) and the options of the interface(s) that should be
462     configured at boot time. Do not specify this if you want to use dhcp (default).
463     It will be changed in a future release to mimick official kernel boot param
464     specification (e.g. ip=10.0.0.1::10.0.0.254:255.255.255.0::eth0,:::::eth1:dhcp).
465    
466 sng 56 ip[=**frommedia**]::
467 sng 28
468     If this variable is set, dhcp and static configuration are just skipped and the
469     system will use the (must be) media-preconfigured /etc/network/interfaces
470     instead.
471    
472 sng 56 {keyb|kbd-chooser/method}=**KEYBOARD**, {klayout|console-setup/layoutcode}=**LAYOUT**,
473     {kvariant|console-setup/variantcode}=**VARIANT**, {kmodel|console-setup/modelcode}=
474     **CODE**, koptions=**OPTIONS**::
475 sng 28
476     Configure the running keyboard as specified, if this one misses live-initramfs
477     behaves as if "keyb=us" was specified. It will be interfered from "locale=" if
478     locale is only 2 lowecase letters as a special case. You could also specify
479     console layout, variant, code, and options (no defaults).
480    
481 sng 56 live-getty::
482 sng 28
483     This changes the auto-login on virtual terminals to use the (experimental)
484     live-getty code. With this option set the standard kernel argument "console=" is
485     parsed and if a serial console is specified then live-getty is used to autologin
486     on the serial console.
487    
488 sng 56 {live-media|bootfrom}=**DEVICE**::
489 sng 28
490     If you specify one of this two equivalent forms, live-initramfs will first try
491     to find this device for the "/live" directory where the read-only root
492     filesystem should reside. If it did not find something usable, the normal scan
493     for block devices is performed.
494    
495 sng 56 {live-media-encryption|encryption}=**TYPE**::
496 sng 28
497     live-initramfs will mount the encrypted rootfs TYPE, asking the passphrase,
498     useful to build paranoid live systems :-). TYPE supported so far are "aes" for
499     loop-aes encryption type.
500    
501 sng 56 live-media-offset=**BYTES**::
502 sng 28
503     This way you could tell live-initramfs that your image starts at offset BYTES in
504     the above specified or autodiscovered device, this could be useful to hide the
505     Debian Live iso or image inside another iso or image, to create "clean" images.
506    
507 sng 56 live-media-path=**PATH**::
508 sng 28
509     Sets the path to the live filesystem on the medium. By default, it is set to
510     '/live' and you should not change that unless you have customized your media
511     accordingly.
512    
513 sng 56 live-media-timeout=**SECONDS**::
514 sng 28
515     Set the timeout in seconds for the device specified by "live-media=" to become
516     ready before giving up.
517    
518 sng 56 {locale|debian-installer/locale}=**LOCALE**::
519 sng 28
520     Configure the running locale as specified, if not present the live-media rootfs
521     configured locale will be used and if also this one misses live-initramfs behave
522     as "locale=en_US.UTF-8" was specified. If only 2 lowercase letter are specified
523     (like "it"), the "maybe wanted" locale is generated (like en:EN.UTF-8), in this
524     case if also "keyb=" is unspecified is set with those 2 lowercase letters
525     (keyb=us). Beside that facility, only UTF8 locales are supported by
526     live-initramfs.
527    
528 sng 56 module=**NAME**::
529 sng 28
530     Instead of using the default optional file "filesystem.module" (see below)
531     another file could be specified without the extension ".module"; it should be
532     placed on "/live" directory of the live medium.
533    
534 sng 56 netboot[=**nfs**|**cifs**]::
535 sng 28
536     This tells live-initramfs to perform a network mount. The parameter "nfsroot="
537     (with optional "nfsopts="), should specify where is the location of the root
538     filesystem. With no args, will try cifs first, and if it fails nfs.
539    
540 sng 56 nfsopts=::
541 sng 28
542     This lets you specify custom nfs options.
543    
544 sng 56 noautologin::
545 sng 28
546     This parameter disables the automatic terminal login only, not touching gdk/kdm.
547    
548 sng 56 noxautologin::
549 sng 28
550     This parameter disables the automatic login of gdm/kdm only, not touching
551     terminals.
552    
553 sng 56 nofastboot::
554 sng 28
555     This parameter disables the default disabling of filesystem checks in
556     /etc/fstab. If you have static filesystems on your harddisk and you want them to
557     be checked at boot time, use this parameter, otherwise they are skipped.
558    
559 sng 56 nopersistent::
560 sng 28
561     disables the "persistent" feature, useful if the bootloader (like syslinux) has
562     been installed with persistent enabled.
563    
564 sng 56 noprompt
565 sng 28
566     Do not prompt to eject the CD on reboot.
567    
568 sng 56 nosudo::
569 sng 28
570     This parameter disables the automatic configuration of sudo.
571    
572 sng 56 swapon::
573 sng 28
574     This parameter enables usage of local swap partitions.
575    
576 sng 56 nouser::
577 sng 28
578     This parameter disables the creation of the default user completely.
579    
580 sng 56 noxautoconfig::
581 sng 28
582     This parameter disables Xorg auto-reconfiguration at boot time. This is valuable
583     if you either do the detection on your own, or, if you want to ship a custom,
584     premade xorg.conf in your live system.
585    
586 sng 56 persistent[=nofiles]::
587 sng 28
588     live-initramfs will look for persistent and snapshot partitions or files labeled
589     "live-rw", "home-rw", and files called "live-sn*", "home-sn*" and will try to,
590     in order: mount as /cow the first, mount the second in /home, and just copy the
591     contents of the latter in appropriate locations (snapshots). Snapshots will be
592     tried to be updated on reboot/shutdown. Look at live-snapshot(1) for more
593     informations. If "nofiles" is specified, only filesystems with matching labels
594     will be searched; no filesystems will be traversed looking for archives or image
595     files. This results in shorter boot times.
596    
597 sng 56 {preseed/file|file}=**FILE**::
598 sng 28
599     A path to a file present on the rootfs could be used to preseed debconf
600     database.
601    
602 sng 56 package/question=**VALUE**::
603 sng 28
604     All debian installed packages could be preseeded from command-line that way,
605     beware of blanks spaces, they will interfere with parsing, use a preseed file in
606     this case.
607    
608 sng 56 quickreboot::
609 sng 28
610     This option causes live-initramfs to reboot without attempting to eject the
611     media and without asking the user to remove the boot media.
612    
613 sng 56 showmounts::
614 sng 28
615     This parameter will make live-initramfs to show on "/" the ro filesystems
616     (mostly compressed) on "/live". This is not enabled by default because could
617     lead to problems by applications like "mono" which store binary paths on
618     installation.
619    
620 sng 56 textonly
621 sng 28
622     Start up to text-mode shell prompts, disabling the graphical user interface.
623    
624 sng 56 timezone=**TIMEZONE**::
625 sng 28
626     By default, timezone is set to UTC. Using the timezone parameter, you can set it
627     to your local zone, e.g. Europe/Zurich.
628    
629 sng 56 todisk=**DEVICE**::
630 sng 28
631     Adding this parameter, live-initramfs will try to copy the entire read-only
632     media to the specified device before mounting the root filesystem. It probably
633     needs a lot of free space. Subsequent boots should then skip this step and just
634     specify the "live-media=DEVICE" boot parameter with the same DEVICE used this
635     time.
636    
637 sng 56 toram::
638 sng 28
639     Adding this parameter, live-initramfs will try to copy the whole read-only media
640     to the computer's RAM before mounting the root filesystem. This could need a lot
641     of ram, according to the space used by the read-only media.
642    
643 sng 56 union=**aufs**|**unionfs**::
644 sng 28
645     By default, live-initramfs uses aufs. With this parameter, you can switch to
646     unionfs.
647    
648 sng 56 utc=**yes**|**no**::
649 sng 28
650     By default, Debian systems do assume that the hardware clock is set to UTC. You
651     can change or explicitly set it with this parameter.
652    
653 sng 56 xdebconf::
654 sng 28
655     Uses xdebconfigurator, if present on the rootfs, to configure X instead of the
656     standard procedure (experimental).
657    
658 sng 56 xvideomode=**RESOLUTION**::
659 sng 28
660     Doesn't do xorg autodetection, but enforces a given resolution.
661    
662     Files
663     -----
664    
665 sng 56 /etc/live.conf
666 sng 28
667     Some variables can be configured via this config file (inside the live system).
668    
669 sng 56 /live/filesystem.module
670 sng 28
671     This optional file (inside the live media) contains a list of white-space or
672     carriage-return-separated file names corresponding to disk images in the "/live"
673     directory. If this file exists, only images listed here will be merged into the
674     root aufs, and they will be loaded in the order listed here. The first entry
675     in this file will be the "lowest" point in the aufs, and the last file in
676     this list will be on the "top" of the aufs, directly below /cow. Without
677     this file, any images in the "/live" directory are loaded in alphanumeric order.
678    
679 sng 56 /etc/live-persistence.binds
680 sng 28
681     This optional file (which resides in the rootfs system, not in the live media)
682     is used as a list of directories which not need be persistent: ie. their
683     content does not need to survive reboots when using the persistence features.
684    
685     This saves expensive writes and speeds up operations on volatile data such as
686     web caches and temporary files (like e.g. /tmp and .mozilla) which are
687     regenerated each time. This is achieved by bind mounting each listed directory
688     with a tmpfs on the original path.
689    
690    
691     See also
692     --------
693    
694     live-snapshot(1), initramfs-tools(8), live-helper(7), live-initscripts(7),
695     live-webhelper(7)
696    
697     Bugs
698     ----
699    
700     Report bugs against live-initramfs
701 sng 56 <a href="http://packages.qa.debian.org/live-initramfs" target="_blank">http://packages.qa.debian.org/live-initramfs</a>.
702 sng 28
703     Homepage
704     --------
705    
706     More information about the Debian Live project can be found at
707 sng 56 <a href="http://debian-live.alioth.debian.org/" target="_blank">http://debian-live.alioth.debian.org/</a> and
708     <a href="http://wiki.debian.org/DebianLive/" target="_blank">http://wiki.debian.org/DebianLive/</a>.
709 sng 28
710     Authors
711     -------
712    
713 sng 56 live-initramfs is maintained by Daniel Baumann &amp;lt;daniel@debian.org&amp;gt;
714 sng 28 for the Debian project.
715    
716 sng 56 live-initramfs is a fork of <a href="http://packages.ubuntu.com/casper/" target="_blank">casper</a>.
717     casper was originally written by Tollef Fog Heen &amp;lt;tfheen@canonical.com&amp;gt;
718     and Matt Zimmerman &amp;lt;mdz@canonical.com&amp;gt;.
719     </pre>
720 sng 28 </div>
721    
722    
723     </div>
724    
725    
726     <!--<a name="template-top"></a>-->
727    
728     <div id="footer">
729     <div id="docline-bottom"> <a href="usb.html">&lt; PREV</a> <a href="doc.html">UP</a> <a href="clonezilla.html">NEXT &gt;</a> </div>
730     <p>Copyright: &#169; <a href="mailto:&#115;&#110;&#103;&#064;&#104;&#101;&#108;&#108;&#117;&#103;&#046;&#103;&#114;?subject=About Clonezilla-SysRescCD v 3.1.0">Spiros Georgaras</a>, 2007-2010<br /><br/>
731     Hosted by <a href="http://www.hellug.gr" target="_blank" title="Hellenic Linux User Group">HEL.L.U.G.</a></p>
732     </div>
733     </div>
734     </body>
735     </html>

Properties

Name Value
svn:executable *

webmaster@linux.gr
ViewVC Help
Powered by ViewVC 1.1.26