website rev 25

Update LiveCD - Handbook (en)
author Paul Issot <paul@slitaz.org>
date Tue Apr 15 22:28:47 2008 +0100 (2008-04-15)
parents 8f918dd1c1be
children 16ab7f88b9d8
files en/doc/handbook/livecd.html
line diff
     1.1 --- a/en/doc/handbook/livecd.html	Sun Apr 13 14:06:40 2008 +0100
     1.2 +++ b/en/doc/handbook/livecd.html	Tue Apr 15 22:28:47 2008 +0100
     1.3 @@ -32,15 +32,21 @@
     1.4  
     1.5  <ul>
     1.6  	<li><a href="#boot">Boot from a cdrom.</a></li>
     1.7 -	<li><a href="#home">Option : home=usb</a> - Use USB media as /home 
     1.8 +	<li><a href="#options">Options to pass at boot.</a></li>
     1.9 +	<li><a href="#kernel-param">Linux Kernel Parameters.</a></li>
    1.10 +	<li><a href="#usbmedia">Option : home=usb</a> - Use USB media as /home 
    1.11  	partition.</li>
    1.12 -	<li><a href="#home">Options : lang=XX and kmap=XX</a> - Specify language 
    1.13 +	<li><a href="#mapping">Options : lang=XX and kmap=XX</a> - Specify language 
    1.14  	and keyboard.</li>
    1.15  	<li><a href="#config">Option : config=&lt;device&gt;,&lt;path&gt;</a> - 
    1.16  	Execute a script at boot time.</li>
    1.17 +	<li><a href="#screen">Option : screen=&lt;type&gt;</a> - Specify screen resolution.</li>
    1.18 +	<li><a href="#sound">Option : sound=*</a> - Disable sound support.</li>
    1.19  	<li><a href="#modprobe">Option : modprobe=modules</a> - Load needed Kernel
    1.20  	modules.</li>
    1.21  	<li><a href="#laptop">Option : laptop</a> - Load ac and battery modules.</li>
    1.22 +	<li><a href="#sessions">Sessions</a> - Logins, passwords and X.</li>
    1.23 +	
    1.24  </ul>
    1.25  
    1.26  <a name="boot"></a>
    1.27 @@ -50,8 +56,8 @@
    1.28  reboot your computer with the disc in your cdrom drive. The first splash image
    1.29  is powered by isolinux bootloader, you can then just press <code>ENTER</code>
    1.30  with or without any options to start system initialisation. Note that pressing
    1.31 -<code>F1</code> will display help and information. SliTaz runs all
    1.32 -in memory and will not damage the host installed system. When the boot
    1.33 +<code>F1-F4</code> will display help and information. SliTaz runs entirely
    1.34 +in memory and will not damage the installed host system. When the boot
    1.35  process is finished, you can login without any password as user 
    1.36  <code>hacker</code>. To become root administrator, you can use the command 
    1.37  <code>su</code> with the password <code>root</code> in a XTerm window or 
    1.38 @@ -61,11 +67,53 @@
    1.39  The desktop is powered by JWM (Joe's Window Manager), you can get the menu by
    1.40  clicking on the screen with one of the mouse buttons. Applications are
    1.41  classified by category and are available in English. Menu, theme and wallpaper 
    1.42 -can all be changed to your needs/preferences by editing one single file, 
    1.43 +can all be changed to your needs/preferences by editing one single file - 
    1.44  personal settings and data can be stored on USB media (Flash key, SD card, etc).
    1.45  </p>
    1.46  
    1.47 -<a name="home"></a>
    1.48 +<a name="options"></a>
    1.49 +<h3>Options and parameters to pass at boot</h3>
    1.50 +<p>
    1.51 +The SliTaz LiveCD can pass various <em>boot</em> options via the command prompt powered by syslinux. 
    1.52 +There are two types of option: those of SliTaz and those of the Linux Kernel. 
    1.53 +The options for SliTaz are used by various startup scripts and the parameters 
    1.54 +such as the VGA mode, are managed directly by the Kernel (<em>kernel boot parameters</em>).
    1.55 +To pass options at startup, just precede your commands with <code>slitaz</code>
    1.56 +</p>
    1.57 +<pre> slitaz vga=791 no387
    1.58 +</pre>
    1.59 +<p>
    1.60 +Note that the Linux Kernel keeps data passed to <em>boot</em> in the text file <code>/proc/cmdline</code>. 
    1.61 +On a GNU/Linux system, you can view this information by running the command:
    1.62 +</p>
    1.63 +<pre> $ cat /proc/cmdline 
    1.64 +</pre>
    1.65 +
    1.66 +<a name="kernel-param"></a>
    1.67 +<h3>Parameters of the Linux Kernel</h3>
    1.68 +<p>
    1.69 +On GNU/Linux systems, parameters specific to the Kernel vary greatly depending on
    1.70 +the configuration used in compiling it. The kernel used by SliTaz 
    1.71 +is constructed with a minimum of modules and offers very 
    1.72 +few modifiable parameters at startup. However, you can disable the 
    1.73 +emulation of a math coprocessor via option: <code>no387</code> and/or activate
    1.74 +<code>irqpoll</code> in the case of problems with interrupts (CD/DVD). The SliTaz
    1.75 +Kernel also provides a video output mode for the VGA Vesa <em>framebuffer</em>
    1.76 + - this is what displays the tux logo and manages the display of the Linux terminal. 
    1.77 +Once the system has started you have access to six pseudo terminals via the key combinations 
    1.78 +<code>Ctrl+alt+F1</code>, <code>Ctrl+alt+F2</code>, and so on.
    1.79 +</p>
    1.80 +
    1.81 +<h4>vga=XXX - VGA Kernel modes</h4>
    1.82 +<pre class="script">Colors | 640x480  800x600  1024x768  1280x1024  1600x1200
    1.83 +-------------------------------------------------------
    1.84 +256    |  769      771       773       775        796
    1.85 +32768  |  784      787       790       793        797
    1.86 +65536  |  785      788       791       794        798
    1.87 +16,8M  |  786      789       792       795        799
    1.88 +</pre>
    1.89 +
    1.90 +<a name="usbmedia"></a>
    1.91  <h3>Option : home=usb</h3>
    1.92  <p>
    1.93  To store your data permanently (bookmarks, downloads, Firefox Add-ons, etc),
    1.94 @@ -92,7 +140,7 @@
    1.95   # tazusb format /dev/sda1
    1.96  </pre>
    1.97  
    1.98 -<a name="i18n"></a>
    1.99 +<a name="mapping"></a>
   1.100  <h3>Options : lang=XX and kmap=XX</h3>
   1.101  <p>
   1.102  When you use the LiveCD you have two options to directly configure the system 
   1.103 @@ -118,6 +166,25 @@
   1.104   slitaz config=/dev/hda1,slitaz.sh
   1.105  </pre>
   1.106  
   1.107 +<a name="screen"></a>
   1.108 +<h3>Option : screen=&lt;type&gt;</h3>
   1.109 +<p>
   1.110 +The <code>screen=</code> option lets you specify your screen resolution at boot.
   1.111 +Note that the <code>screen=text</code> option disables the Slim login manager. Example:
   1.112 +</p>
   1.113 +<pre> slitaz screen=1024x768x24
   1.114 +</pre>
   1.115 +
   1.116 +<a name="sound"></a>
   1.117 +<h3>Option : sound=*</h3>
   1.118 +<p>
   1.119 +The option <code>sound=no</code> or <code>sound=noconf</code> lets you respectively disable all
   1.120 +of the modules and applications relating to sound to save memory (ram) or skip the automatic setup
   1.121 +of the sound card, but still allow you to manually configure if needed:
   1.122 +</p>
   1.123 +<pre> slitaz sound=no
   1.124 +</pre>
   1.125 +
   1.126  <a name="modprobe"></a>
   1.127  <h3>Option : modprobe=modules</h3>
   1.128  <p>
   1.129 @@ -131,12 +198,30 @@
   1.130  <h3>Option : laptop</h3>
   1.131  <p>
   1.132  The option <code>laptop</code> will automatically load ac and battery Kernel 
   1.133 -modules, useful for laptop computers:
   1.134 +modules - useful for laptop computers:
   1.135  </p>
   1.136  <pre>
   1.137   slitaz laptop
   1.138  </pre>
   1.139  
   1.140 +<a name="sessions"></a>
   1.141 +<h3>Sessions - Login, passwords and X</h3>
   1.142 +<p>
   1.143 +When the system has finished it's initialization, the screen is cleared and the
   1.144 +login prompt or the session manager Slim is displayed. Now you can choose to login
   1.145 +as <code>hacker</code> (without password) or as root administrator.
   1.146 +</p>
   1.147 +<p>
   1.148 +Once logged into a session, you can use the many commands available in Busybox, 
   1.149 +the GNU text editor Nano or the Clex file manager. You can initiate a graphical server
   1.150 +(X) via <code>startx</code> or connect to a remote machine via SSH or X.
   1.151 +The <code>startx</code> command will launch Xvesa and start the JWM window manager.
   1.152 +To launch a X session from the Linux console, for example if you have passed the 
   1.153 +<code>screen=text</code> option or if Slim is not configured to run at startup:
   1.154 +</p>
   1.155 +<pre> $ startx
   1.156 +</pre>
   1.157 +
   1.158  
   1.159  <!-- End of content -->
   1.160  </div>