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