website rev 157
en: Add RootCD to Cookbook
author | Paul Issott <paul@slitaz.org> |
---|---|
date | Tue Sep 09 18:23:09 2008 +0000 (2008-09-09) |
parents | 442ece8703dd |
children | 0d9a6846b211 |
files | en/doc/cookbook/index.html en/doc/cookbook/rootcd.html |
line diff
1.1 --- a/en/doc/cookbook/index.html Tue Sep 09 10:36:54 2008 +0000 1.2 +++ b/en/doc/cookbook/index.html Tue Sep 09 18:23:09 2008 +0000 1.3 @@ -35,8 +35,9 @@ 1.4 <li><a href="wok-tools.html">Wok & Tools.</a> - SliTaz Package Tools.</li> 1.5 <li><a href="receipts.html">Receipts.</a> - Receipts for creating SliTaz packages.</li> 1.6 <li><a href="../manuals/tazwok.en.html">Tazwok manual.</a> - Manual for compiling & generating packages for SliTaz.</li> 1.7 - <li><a href="boot-scripts.html">Boot Scripts</a> - The startup and shutdown scripts.</li> 1.8 - <li><a href="slitaz-tools.html">SliTaz Tools</a> - The Toolbox.</li> 1.9 + <li><a href="rootcd.html">Root cdrom (rootcd).</a> - Descriptions of files contained on the cdrom.</li> 1.10 + <li><a href="boot-scripts.html">Boot Scripts.</a> - The startup and shutdown scripts.</li> 1.11 + <li><a href="slitaz-tools.html">SliTaz Tools.</a> - The Toolbox.</li> 1.12 1.13 </ul> 1.14
2.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 2.2 +++ b/en/doc/cookbook/rootcd.html Tue Sep 09 18:23:09 2008 +0000 2.3 @@ -0,0 +1,206 @@ 2.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 2.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 2.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 2.7 +<head> 2.8 + <title>SliTaz Cookbook (en) - RootCD</title> 2.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 2.10 + <meta name="description" content="slitaz English cookbook" /> 2.11 + <meta name="expires" content="never" /> 2.12 + <meta name="modified" content="2008-02-26 18:30:00" /> 2.13 + <meta name="publisher" content="www.slitaz.org" /> 2.14 + <meta name="author" content="Christophe Lincoln"/> 2.15 + <link rel="shortcut icon" href="favicon.ico" /> 2.16 + <link rel="stylesheet" type="text/css" href="book.css" /> 2.17 +</head> 2.18 +<body bgcolor="#ffffff"> 2.19 + 2.20 +<!-- Header and quick navigation --> 2.21 +<div id="header"> 2.22 +<div align="right" id="quicknav"> 2.23 + <a name="top"></a> 2.24 + <a href="boot-scripts.html">Boot Scripts</a> | 2.25 + <a href="index.html">Table of contents</a> 2.26 +</div> 2.27 +<h1><font color="#3E1220">SliTaz Cookbook (en)</font></h1> 2.28 +</div> 2.29 + 2.30 +<!-- Content. --> 2.31 +<div id="content"> 2.32 +<div class="content-right"></div> 2.33 + 2.34 +<h2><font color="#df8f06">Rootcd</font></h2> 2.35 +<p> 2.36 +Descriptions of files contained on the cdrom. 2.37 +</p> 2.38 + 2.39 +<ul> 2.40 + <li><a href="#syslinux">Syslinux/isolinux.</a></li> 2.41 + <li><a href="#splash">Isolinux boot splash image.</a></li> 2.42 + <li><a href="#isolinux-iso">ISO bootable with isolinux.</a></li> 2.43 + <li><a href="#grub">GRUB.</a></li> 2.44 + <li><a href="#grub-iso">ISO bootable with GRUB.</a></li> 2.45 + <li><a href="#memtest86">Memtest86.</a></li> 2.46 +</ul> 2.47 + 2.48 +<a name="syslinux"></a> 2.49 +<h3><font color="#6c0023">Syslinux/isolinux</font></h3> 2.50 +<p> 2.51 +Syslinux and main bootloader of SliTaz - we use the isolinux version to start 2.52 +the system contained on the CD-ROM. Simple effective and configurable, it 2.53 +was installed during the creation of the base system. 2.54 +The binary is named isolinux.bin and its configuration file isolinux.cfg. 2.55 +Here's an example of isolinux.cfg using isolinux.msg to post the splash 2.56 +image and displayable help files via F1, F2, F3 and F4. You will find the 2.57 +files help.txt, options.txt, etc in <a href="slitaz-tools.html">SliTaz tools</a>. 2.58 +</p> 2.59 +<pre class="script">display isolinux.msg 2.60 +default slitaz 2.61 +label slitaz 2.62 + kernel /boot/bzImage 2.63 + append initrd=/boot/rootfs.gz rw root=/dev/null vga=788 2.64 +implicit 0 2.65 +prompt 1 2.66 +timeout 80 2.67 +F1 help.txt 2.68 +F2 options.txt 2.69 +F3 isolinux.msg 2.70 +F4 display.txt 2.71 +</pre> 2.72 + 2.73 +<a name="splash"></a> 2.74 +<h3><font color="#6c0023">Isolinux boot splash image</font></h3> 2.75 +<p> 2.76 +We can configure isolinux to display a splash image when booting SliTaz or 2.77 +any other operating system using isolinux. This image has a particular 2.78 +format <code>.lss</code>, suitable for Syslinux, and must be indexed using the 16 color 2.79 +mode. You can use the official logo, ppmforge, imagemagick, GIMP or 2.80 +other tools to create your image. 2.81 +</p> 2.82 +<p> 2.83 +The Syslinux file (sample/syslogo.lss) provides an official logo which you can 2.84 +directly use by copying to the root of the CD-ROM. SliTaz 2.85 +provides a logo (rootcd/boot/isolinux/splash.lss) which you can locate in 2.86 +<a href="slitaz-tools.html">SliTaz tools</a>. 2.87 +To display a splash image when booting; it's necessary that the 'display' option calls 2.88 +the isolinux.msg file which loads the *.lss format image. Note that the isolinux.msg file 2.89 +uses 24 ASCII characters. Example using 'echo' and an isolinux.msg file incorporating a .lss 2.90 +splash image: 2.91 +</p> 2.92 +<pre> # echo -e "\24isplash.lss\n" > isolinux.msg 2.93 +</pre> 2.94 +<p> 2.95 +You can also add a text message underneath the splash image by modifying this 2.96 +file with your favorite text editor, <code>echo</code> or <code>cat</code> and so on. 2.97 +</p> 2.98 + 2.99 +<a name="isolinux-iso"></a> 2.100 +<h3><font color="#6c0023">ISO bootable with isolinux</font></h3> 2.101 +<p> 2.102 +To create a bootable ISO image using isolinux and genisoimage: 2.103 +</p> 2.104 +<pre> # genisoimage -R -o slitaz-test.iso -b boot/isolinux/isolinux.bin \ 2.105 + -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \ 2.106 + -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd 2.107 +</pre> 2.108 + 2.109 +<a name="grub"></a> 2.110 +<h3><font color="#6c0023">GRUB</font></h3> 2.111 +<p> 2.112 +GRUB (GRand Unified Bootloader) is a bootloader distributed by the GNU 2.113 +project. This is what is used during installation to a hard drive; it can 2.114 +boot Linux, BSD, HURD and Window$. GRUB provides stage2_eltorito 2.115 +to start the ISO images. To find stage2_eltorito on your system, you need 2.116 +to have the GRUB package installed. Finally you copy stage2_eltorito to the 2.117 +root of the cdrom. Note that SliTaz provides a (.tazpkg) package 2.118 +grub-0.97 that you can find on the mirrors or you can rebuild grub-0.97 2.119 +from sources. Sample copy of the <code>stage2_eltorito</code> image from a 2.120 +Debian system or SliTaz: 2.121 +</p> 2.122 +<pre> # mkdir -p rootcd/boot/grub 2.123 + # cp /usr/lib/grub/i386-pc/stage2_eltorito \ 2.124 + rootcd/boot/grub 2.125 +</pre> 2.126 +<p> 2.127 +The GRUB configuration file is called menu.lst and can be edited with your 2.128 +favorite text editor. Example: 2.129 +</p> 2.130 +<pre class="script"># By default, boot the first entry. 2.131 +default 0 2.132 + 2.133 +# Boot automatically after 20 secs. 2.134 +timeout 20 2.135 + 2.136 +# Change the colors. 2.137 +color yellow/brown white/black 2.138 + 2.139 +title SliTaz GNU/Linux 1.0 (vga 800x600) (Kernel 2.6.20) 2.140 + kernel /boot/bzImage root=/dev/null vga=788 2.141 + initrd /boot/rootfs.gz 2.142 + 2.143 +title SliTaz GNU/Linux 1.0 (vga 1024x768) (Kernel 2.6.20) 2.144 + kernel /boot/bzImage root=/dev/null vga=771 2.145 + initrd /boot/rootfs.gz 2.146 +</pre> 2.147 + 2.148 +<a name="grub-iso"></a> 2.149 +<h3><font color="#6c0023">ISO bootable with GRUB</font></h3> 2.150 +<p> 2.151 +To create a bootable ISO image using GRUB and genisoimage or mkisofs: 2.152 +</p> 2.153 +<pre> # genisoimage -R -o slitaz-test.iso -b boot/grub/stage2_eltorito \ 2.154 + -no-emul-boot -V "SliTaz" -boot-load-size 4 -input-charset iso8859-1 \ 2.155 + -boot-info-table rootcd 2.156 +</pre> 2.157 +<a name="Memtest86"></a> 2.158 +<h3><font color="#6c0023">Memtest86</font></h3> 2.159 +<p> 2.160 +The application memtest86 is a tool to test random access memory 2.161 +(RAM). We download the utility into the src directory, decompress the archive, 2.162 +and copy the (precompiled) binary: 2.163 +</p> 2.164 +<pre> # mkdir -v -p src 2.165 + # cd src 2.166 + # wget http://www.memtest86.com/memtest86-3.2.tar.gz 2.167 + # tar xzfv memtest86-3.2.tar.gz 2.168 + # cd memtest86-3.2 2.169 + (# more README) 2.170 + # cp precomp.bin ../../rootcd/boot/memtest 2.171 + # cd ../.. 2.172 +</pre> 2.173 +<p> 2.174 +Once installed, you can add the label for the memtest86 file to isolinux.cfg, 2.175 +specifing the path to the utility: 2.176 +</p> 2.177 +<pre class="script">label memtest 2.178 + kernel /boot/memtest 2.179 +</pre> 2.180 +<p> 2.181 +Or if you want to use GRUB, the line to launch memtest86: 2.182 +</p> 2.183 +<pre class="script">title Memtest86 (Test system memory) 2.184 +kernel /boot/memtest 2.185 +</pre> 2.186 +<p> 2.187 +Once the lines are added, you can then create a new ISO and test. 2.188 +</p> 2.189 + 2.190 +<!-- End of content --> 2.191 +</div> 2.192 + 2.193 +<!-- Footer. --> 2.194 +<div id="footer"> 2.195 + <div class="footer-right"></div> 2.196 + <a href="#top">Top of the page</a> | 2.197 + <a href="index.html">Table of contents</a> 2.198 +</div> 2.199 + 2.200 +<div id="copy"> 2.201 + Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> - 2.202 + <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br /> 2.203 + Documentation is under 2.204 + <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a> 2.205 + and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>. 2.206 +</div> 2.207 + 2.208 +</body> 2.209 +</html>