website view en/doc/cookbook/rootcd.html @ rev 350

en: Edits and typos
author Paul Issott <paul@slitaz.org>
date Wed Apr 01 17:56:04 2009 +0000 (2009-04-01)
parents 5e44cfe79756
children fa2c5bed2417
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <head>
5 <title>SliTaz Cookbook (en) - RootCD</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="slitaz English cookbook" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2008-02-26 18:30:00" />
10 <meta name="publisher" content="www.slitaz.org" />
11 <meta name="author" content="Christophe Lincoln"/>
12 <link rel="shortcut icon" href="favicon.ico" />
13 <link rel="stylesheet" type="text/css" href="book.css" />
14 </head>
15 <body bgcolor="#ffffff">
17 <!-- Header and quick navigation -->
18 <div id="header">
19 <div align="right" id="quicknav">
20 <a name="top"></a>
21 <a href="index.html">Table of contents</a>
22 </div>
23 <h1><font color="#3E1220">SliTaz Cookbook (en)</font></h1>
24 </div>
26 <!-- Content. -->
27 <div id="content">
28 <div class="content-right"></div>
30 <h2><font color="#df8f06">Rootcd</font></h2>
31 <p>
32 Descriptions of files contained on the cdrom.
33 </p>
35 <ul>
36 <li><a href="#syslinux">Syslinux/isolinux.</a></li>
37 <li><a href="#splash">Isolinux boot splash image.</a></li>
38 <li><a href="#isolinux-iso">ISO bootable with isolinux.</a></li>
39 <li><a href="#grub">GRUB.</a></li>
40 <li><a href="#grub-iso">ISO bootable with GRUB.</a></li>
41 <li><a href="#memtest86">Memtest86.</a></li>
42 </ul>
44 <a name="syslinux"></a>
45 <h3>Syslinux/isolinux</h3>
46 <p>
47 Syslinux and main bootloader of SliTaz - we use the isolinux version to start
48 the system contained on the CD-ROM. Simple effective and configurable, isolinux
49 was installed during the creation of the base system.
50 The binary is named isolinux.bin and its configuration file: isolinux.cfg.
51 Here's an example of isolinux.cfg using isolinux.msg to post the splash
52 image and displayable help files via F1, F2, F3 and F4. You will find the
53 files help.txt, options.txt, etc in <a href="slitaz-tools.html">SliTaz tools</a>.
54 </p>
55 <pre class="script">display isolinux.msg
56 default slitaz
57 label slitaz
58 kernel /boot/bzImage
59 append initrd=/boot/rootfs.gz rw root=/dev/null vga=788
60 implicit 0
61 prompt 1
62 timeout 80
63 F1 help.txt
64 F2 options.txt
65 F3 isolinux.msg
66 F4 display.txt
67 </pre>
69 <a name="splash"></a>
70 <h3>Isolinux boot splash image</h3>
71 <p>
72 We can configure isolinux to display a splash image when booting SliTaz or
73 any other operating system using isolinux. This image has a particular
74 format <code>.lss</code>, suitable for Syslinux, and must be indexed using the 16 color
75 mode. You can use the official logo, ppmforge, imagemagick, GIMP or
76 other tools to create your image.
77 </p>
78 <p>
79 The Syslinux file (sample/syslogo.lss) provides an official logo which you can
80 directly use by copying to the root of the CD-ROM. SliTaz
81 provides a logo (rootcd/boot/isolinux/splash.lss) which you can locate in
82 <a href="slitaz-tools.html">SliTaz tools</a>.
83 To display a splash image when booting, it's necessary that the 'display' option calls
84 the isolinux.msg file which loads the *.lss format image. Note that the isolinux.msg file
85 uses 24 ASCII characters. Example using 'echo' and an isolinux.msg file incorporating a .lss
86 splash image:
87 </p>
88 <pre> # echo -e "\24isplash.lss\n" &gt; isolinux.msg
89 </pre>
90 <p>
91 You can also add a text message underneath the splash image by modifying this
92 file with your favorite text editor, <code>echo</code> or <code>cat</code> and so on.
93 </p>
95 <a name="isolinux-iso"></a>
96 <h3>ISO bootable with isolinux</h3>
97 <p>
98 To create a bootable ISO image using isolinux and genisoimage:
99 </p>
100 <pre> # genisoimage -R -o slitaz-test.iso -b boot/isolinux/isolinux.bin \
101 -c boot/isolinux/boot.cat -no-emul-boot -boot-load-size 4 \
102 -V "SliTaz" -input-charset iso8859-1 -boot-info-table rootcd
103 </pre>
105 <a name="grub"></a>
106 <h3>GRUB</h3>
107 <p>
108 GRUB (GRand Unified Bootloader) is a bootloader distributed by the GNU
109 project. This is what is used during installation to a hard drive; it can
110 boot Linux, BSD, HURD and Window$. GRUB provides stage2_eltorito
111 to start the ISO images. To find stage2_eltorito on your system, you need
112 to have the GRUB package installed. Finally you copy stage2_eltorito to the
113 root of the cdrom. Note that SliTaz provides a (.tazpkg) package
114 grub-0.97 that you can find on the mirrors or you can rebuild grub-0.97
115 from sources. Sample copy of the <code>stage2_eltorito</code> image from a
116 Debian system or SliTaz:
117 </p>
118 <pre> # mkdir -p rootcd/boot/grub
119 # cp /usr/lib/grub/i386-pc/stage2_eltorito \
120 rootcd/boot/grub
121 </pre>
122 <p>
123 The GRUB configuration file is called menu.lst and can be edited with your
124 favorite text editor. Example:
125 </p>
126 <pre class="script"># By default, boot the first entry.
127 default 0
129 # Boot automatically after 20 secs.
130 timeout 20
132 # Change the colors.
133 color yellow/brown white/black
135 title SliTaz GNU/Linux 1.0 (vga 800x600) (Kernel 2.6.20)
136 kernel /boot/bzImage root=/dev/null vga=788
137 initrd /boot/rootfs.gz
139 title SliTaz GNU/Linux 1.0 (vga 1024x768) (Kernel 2.6.20)
140 kernel /boot/bzImage root=/dev/null vga=771
141 initrd /boot/rootfs.gz
142 </pre>
144 <a name="grub-iso"></a>
145 <h3>ISO bootable with GRUB</h3>
146 <p>
147 To create a bootable ISO image using GRUB and genisoimage or mkisofs:
148 </p>
149 <pre> # genisoimage -R -o slitaz-test.iso -b boot/grub/stage2_eltorito \
150 -no-emul-boot -V "SliTaz" -boot-load-size 4 -input-charset iso8859-1 \
151 -boot-info-table rootcd
152 </pre>
153 <a name="memtest86"></a>
154 <h3>Memtest86</h3>
155 <p>
156 The application memtest86 is a tool to test random access memory
157 (RAM). We download the utility into the src directory, decompress the archive,
158 and copy the (precompiled) binary:
159 </p>
160 <pre> # mkdir -v -p src
161 # cd src
162 # wget http://www.memtest86.com/memtest86-3.2.tar.gz
163 # tar xzfv memtest86-3.2.tar.gz
164 # cd memtest86-3.2
165 (# more README)
166 # cp precomp.bin ../../rootcd/boot/memtest
167 # cd ../..
168 </pre>
169 <p>
170 Once installed, you can add the label for the memtest86 file to isolinux.cfg,
171 specifing the path to the utility:
172 </p>
173 <pre class="script">label memtest
174 kernel /boot/memtest
175 </pre>
176 <p>
177 Or if you want to use GRUB, here's the line to launch memtest86:
178 </p>
179 <pre class="script">title Memtest86 (Test system memory)
180 kernel /boot/memtest
181 </pre>
182 <p>
183 Once the lines are added, you can then create a new ISO and test.
184 </p>
186 <!-- End of content -->
187 </div>
189 <!-- Footer. -->
190 <div id="footer">
191 <div class="footer-right"></div>
192 <a href="#top">Top of the page</a> |
193 <a href="index.html">Table of contents</a>
194 </div>
196 <div id="copy">
197 Copyright &copy; 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
198 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
199 Documentation is under
200 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
201 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
202 </div>
204 </body>
205 </html>