tazlito view doc/tazlito.fr.html @ rev 314
Apply common stylesheet for docs; reformatting of html code.
| author | Aleksej Bobylev <al.bobylev@gmail.com> |
|---|---|
| date | Sat May 04 22:59:48 2013 +0000 (2013-05-04) |
| parents | df6381a368a2 |
| children | b3041f9d49ab |
line source
1 <!DOCTYPE html>
2 <html xmlns="http://www.w3.org/1999/xhtml" lang="en">
3 <head>
4 <meta charset="utf-8" />
5 <title>Manuel de TazLito</title>
6 <link rel="shortcut icon" href="favicon.ico" />
7 <link rel="stylesheet" type="text/css" href="../slitaz-doc.css" />
8 <script type="text/javascript" src="../slitaz-doc.js"></script>
9 </head>
10 <body>
12 <header>
13 <h1>Tazlito Manual</h1>
14 </header>
16 <!-- Start content -->
17 <div id="content">
19 <h2>NOM</h2>
21 <p>Tazlito — SliTaz Live Tool.</p>
24 <h2>SYNTAXE</h2>
26 <pre>
27 tazlito [command] [list|iso|flavor] [dir]
28 </pre>
31 <h2>DESCRIPTION</h2>
33 <p>Tazlito est un petit utilitaire permettant d'extraire le LiveCD, reconstruire
34 l'image ISO ou regénérer le système racine du LiveCD de SliTaz. Tazlito donne
35 aussi la possibilité de générer une distribution depuis une liste de paquets
36 préalablements téléchargés et stockés dans un répertoire. Pour fonctionner,
37 l'application Tazlito utilise un fichier de configuration système
38 <tt>/etc/tazlito/tazlito.conf</tt> ou un fichier <tt>tazlito.conf</tt> se
39 trouvant dans le répertoire courant. Ce fichier de configuration peut facilement
40 être généré automatiquement par Tazlito, il spécifie le nom de l'image ISO,
41 le nom du volume, le préparateur, le chemin vers le repositoire des paquets et
42 celui vers la distribution. Tazlito permet aussi de configurer un répertoire
43 contenant des fichiers additionnels, qui seront copiés dans le LiveCD lors
44 de la génération de la distribution.</p>
45 <p>Tazlito est, distribué sous licence libre GNU GPL v.3, installé par défaut
46 sur SliTaz et installé/testé avec succès sur Debian GNU/Linux. Vous trouverez
47 aussi un complément d'informations au sujet de création de sa propre version
48 du LiveCD, via le livre de cuisine
49 (<a href="http://www.slitaz.org/fr/doc/cookbook/">Cookbook</a>) de SliTaz
50 et le Handbook.</p>
53 <h2>COMMANDES</h2>
56 <h3 id="usage">usage</h3>
58 <p>La commande <code>usage</code> affiche une liste des commandes disponibles
59 avec une courte description :</p>
61 <pre>
62 # tazlito usage
63 </pre>
66 <h3 id="stats">stats</h3>
68 <p><code>stats</code> affiche les variables de configuration, le chemin vers
69 les différents fichiers et répertoires et les informations sur l'image ISO :</p>
71 <pre>
72 # tazlito stats
73 </pre>
76 <h3 id="gen-config">gen-config</h3>
78 <p>La commande <code>gen-config</code> vous permet de générer une fichier
79 de configuration prêt à être édité. Par défaut le fichier est créé dans
80 le répertoire courant et peut aussi l'être dans un autre répertoire si
81 spécifié :</p>
83 <pre>
84 # tazlito gen-config
85 # tazlito gen-config <em>/path/to/distro</em>
86 </pre>
89 <h3 id="configure">configure</h3>
91 <p>La commande <code>configure</code> permet de configurer le fichier
92 de configuration système ou celui trouvé dans le répertoire courant :</p>
94 <pre>
95 # tazlito configure
96 </pre>
99 <h3 id="gen-iso">gen-iso</h3>
101 <p>La commande <code>gen-iso</code> pour <em>Generate ISO</em> permet de générer
102 une nouvelle image ISO du LiveCD suite à des modifications et ajouter dans
103 le système racine du CD-ROM. Pour fonctionner cette commande a besoin d'un
104 répertoire contenant la structure du système Live, cette structure peur
105 facilement être construite avec la commande
106 <a href="#extract-distro"><code>extract-distro</code></a>, modifiée et
107 reconstruite via :</p>
109 <pre>
110 # tazlito gen-iso
111 </pre>
114 <h3 id="gen-initiso">gen-initiso</h3>
116 <p>La commande <code>gen-initiso</code> va faire le même travail que
117 <code>gen-iso</code> mais en reconstruisant préalablement l'initramfs compressé
118 du système. L'initramfs contient tous le système racine de la distribution
119 et doit être reconstruite en cas de modifications sur les fichiers.</p>
121 <pre>
122 # tazlito gen-initiso
123 </pre>
126 <h3 id="list-flavors">list-flavors</h3>
128 <p>La commande <code>list-flavors</code> télécharge si nécessaire et affiche
129 la liste des différentes saveurs disponibles. On peut forcer le téléchargement
130 avec <code>--recharge</code>.</p>
132 <pre>
133 # tazlito list-flavors
134 # tazlito list-flavors --recharge
135 </pre>
138 <h3 id="get-flavor">get-flavor</h3>
140 <p>La commande <code>get-flavor</code> télécharge si nécessaire et prépare
141 les fichiers nécessaires à <a href="#gen-distro"><code>gen-distro</code></a>
142 pour refabriquer une saveur.</p>
144 <pre>
145 # tazlito get-flavor <em>saveur-particuliere</em>
146 </pre>
149 <h3 id="show-flavor">show-flavor</h3>
151 <p>La commande <code>show-flavor</code> affiche les caractéristiques d'une
152 saveur et ses dimensions après refabrication. Les options <code>--brief</code>
153 et <code>--noheader</code> réduisent l'affichage produit.</p>
155 <pre>
156 # tazlito show-flavor <em>saveur-particuliere</em>
157 # tazlito show-flavor <em>saveur-particuliere</em> --brief
158 # tazlito show-flavor <em>saveur-particuliere</em> --brief --noheader
159 </pre>
162 <h3 id="gen-flavor">gen-flavor</h3>
164 <p>La commande <code>gen-flavor</code> crée un fichier de description d'une
165 nouvelle saveur à partir des résultats de fabrication de
166 <a href="#gen-distro"><code>gen-distro</code></a>. Le fichier <tt>.flavor</tt>
167 produit pourra être ensuite envoyé à slitaz.org.</p>
169 <pre>
170 # tazlito gen-flavor <em>nouvelle-saveur</em>
171 </pre>
174 <h3 id="gen-liveflavor">gen-liveflavor</h3>
176 <p>La commande <code>gen-liveflavor</code> crée une image ISO et un fichier
177 de description d'une nouvelle saveur à partir de la distribution courante.
178 Un fichier texte optionnel permetde décrire les modifications à faire par
179 rapport à la distribution courante. Le format de chacune de ses lignes est
180 <tt>[code][tabulation][caractères]</tt>. Les valeurs possibles de code sont
181 <tt>+</tt>, <tt>-</tt>, <tt>@</tt>, <tt>!</tt> et <tt>?</tt> pour ajouter
182 un paquet, le retirer, décrire la saveur, ajouter un paquet non libre,
183 et afficher un message à l'écran.</p>
185 <pre>
186 # tazlito gen-liveflavor nouvelle-saveur
187 # tazlito gen-liveflavor autre-saveur mes-modifications
188 # cat mes-modifications
189 @ Developper tools and some non-free packages
190 + slitaz-toolchain
191 + mercurial
192 ! skype
193 ! flash-plugin
194 </pre>
197 <h3 id="upgrade-flavor">upgrade-flavor</h3>
199 <p>La commande <code>upgrade-flavor</code> raffraîchit une saveur consue pour
200 une ancienne version de SliTaz en mettant à jour la liste des paquets avec
201 les dernières versions des paquets disponibles.</p>
203 <pre>
204 # tazlito upgrade-flavor <em>une-saveur</em>
205 </pre>
208 <h3 id="extract-flavor">extract-flavor</h3>
210 <p>La commande <code>extract-flavor</code> convertit une saveur en
211 une arborescence facilement modifiable dans
212 <tt>/home/slitaz/VERSION/flavors</tt> qui pourra être gérée avec Mercurial dans
213 <a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>.
214 Par exemple sur une cooking le répértoire de travail sera
215 <tt>/home/slitaz/cooking/flavors</tt>.</p>
217 <pre>
218 # tazlito extract-flavor <em>une-saveur</em>
219 </pre>
222 <h3 id="pack-flavor">pack-flavor</h3>
224 <p>La commande <code>pack-flavor</code> convertit une arborescence de
225 <tt>/home/slitaz/VERSION/flavors</tt> en saveur (<tt>.flavor</tt>). Soit
226 l'opération inverse de
227 <a href="#extract-flavor"><code>tazlito extract-flavor</code></a>.</p>
229 <pre>
230 # tazlito pack-flavor <em>une-saveur</em>
231 </pre>
234 <h3 id="extract-distro">extract-distro</h3>
236 <p>La commande <code>extract-iso</code> sert à extraire les fichiers
237 d'une images ISO du LiveCD, pour en reconstruire la structure (Racine du CD-ROM
238 et du système). Il est ensuite possible de faire les modifications ou ajouts
239 souhaités, pour reconstruire l'image ISO via les commandes
240 <a href="#gen-iso"><code>gen-iso</code></a> ou
241 <a href="#gen-initiso"><code>gen-initiso</code></a>. Exemple d'utilisation :</p>
243 <pre>
244 # tazlito extract-distro <em>slitaz-cooking.iso</em>
245 </pre>
248 <h3 id="gen-distro">gen-distro</h3>
250 <p>La commande <em>Generate Distribution</em> permet de générer la structure
251 du système Live et une image ISO via une liste de paquets. Pour fonctionner,
252 cette commande a besoin d'une liste de paquets, d'un répertoire contenant tous
253 les paquets (<tt>.tazpkg</tt>) de la liste et d'un répertoire pour générer
254 la distribution. La liste de paquets peut être extraite d'une saveur par
255 la commande <a href="#get-flavor"><code>get-flavor</code></a>. Si l'on utilise
256 le Live-CD, les options <code>--cdrom</code> et <code>--iso='image-iso'</code>
257 permettent de refabriquer les packets qui placent des fichiers dans
258 <tt>/boot</tt> sans être obligé de les télécharger et récupère les fichiers
259 additionnels du Live-CD. Le chemin vers les différents répertoires sont
260 à configurer dans le fichier de configuration utilisé et les paquets peuvent
261 être téléchargés depuis les miroirs de SliTaz ou générés par Cookutils. Pour
262 générer une distro :</p>
264 <pre>
265 # tazlito gen-distro
266 # tazlito gen-distro --cdrom
267 # tazlito gen-distro --iso=<em>slitaz.iso</em>
268 # tazlito gen-distro <em>package-list</em>
269 </pre>
272 <h3 id="clean-distro">clean-distro</h3>
274 <p>Supprime tous les fichiers générés ou extraits de la structure
275 du LiveCD :</p>
277 <pre>
278 # tazlito clean-distro
279 </pre>
282 <h3 id="check-distro">check-distro</h3>
284 <p>Cette commande permet simplement de vérifier si les fichiers non installés
285 par des paquets, sont bien présents dans la distro :</p>
287 <pre>
288 # tazlito check-distro
289 </pre>
292 <h3 id="writeiso">writeiso</h3>
294 <p>Cette commande sauvegarde le système de fichier dans une archive cpio
295 (<tt>rootfs.gz</tt>) et génère une image ISO bootable. Writeiso peut être
296 utilisé avec une installation sur disque dur ou en mode live. Il sauvegarde
297 aussi votre répertoire <tt>/home</tt>. Cette commande vous permet de modifier
298 de refabriquer facilement votre propre LiveCD. Il suffit de démarrer le LiveCD,
299 de modifier les fichiers que vous voulez et de faire :</p>
301 <pre>
302 # tazlito writeiso [gzip|lzma|none]
303 # tazlito writeiso gzip
304 # tazlito writeiso gzip <em>image-name</em>
305 </pre>
308 <h3 id="frugal-install">frugal-install</h3>
310 <p>Installe les fichiers nécessaire du CD-ROM dans <tt>/boot/frugal</tt> et
311 ajoute une entée GRUB si nécessaire. En mode frugal, Slitaz fonctionne
312 entièrement en mémoire (RAM). Cela permet de tester une distribution sans graver
313 d'ISO ou d'avoir un OS de dépannage prêt lorsque l'ordinateur démarre. Pour
314 installer tous les fichiers nécessaires à partir d'une arborescence ou d'une
315 image ISO :</p>
317 <pre>
318 # tazlito frugal-install <em>slitaz.iso</em>
319 # tazlito -fi <em>slitaz.iso</em>
320 </pre>
323 <h3 id="check-list">check-list</h3>
325 <p>Vérifie si <tt>distro-packages.list</tt> est à jour avec les dernières
326 version des paquets.</p>
328 <pre>
329 # tazlito check-list
330 </pre>
333 <h3 id="repack">repack</h3>
335 <p>Recompresse le(s) rootfs avec la meilleure compression possible.</p>
337 <pre>
338 # tazlito repack <em>slitaz.iso</em>
339 </pre>
342 <h3 id="merge">merge</h3>
344 <p>Réunit plusieurs saveurs imbriquées comme des poupées russes. Chaque rootfs
345 est un sous ensemble du précédent. Le premier rootfs est extrait de l'image
346 ISO en 3e paramètre. La saveur à lancer sera choisie au démarrage suivant
347 la quantité de RAM disponible.</p>
349 <pre>
350 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
351 </pre>
354 <h3 id="build-loram">build-loram</h3>
356 <p>Crée une image ISO pour les machines avec peu de mémoire. Le système
357 de fichier racine peut soit être toujours chargé en mémoire ou peut
358 éventuellement rester sur le cdrom selon la mémoire disponible.</p>
360 <pre>
361 # tazlito build-loram <em>slitaz.iso loram.iso</em>
362 # tazlito build-loram <em>slitaz.iso loram-cdrom.iso</em> cdrom
363 </pre>
366 <h3 id="emu-iso">emu-iso</h3>
368 <p>La commande emu-iso va utiliser l'émulateur Qemu pour démarrer et lançer
369 SliTaz. Qemu permet de tester l'image ISO fraîchement construite sans la graver
370 sur CD-ROM ou redémarrer en mode frugal.</p>
372 <pre>
373 # tazlito emu-iso
374 # tazlito emu-iso <em>path/to/image.iso</em>
375 </pre>
378 <h3 id="burn-iso">burn-iso</h3>
380 <p>Burn ISO va deviner le périphérique de CD-ROM, sa vitesse de gravure
381 et lancer l'outils Wodim pour graver une image ISO. L'image ISO par défaut est
382 celle du fichier de configuration courant, mais il est possible de spécifier une
383 autre image via la ligne de commande :</p>
385 <pre>
386 # tazlito burn-iso
387 # tazlito burn-iso <em>slitaz-hacked.iso</em>
388 </pre>
391 <h2>SAVEURS</h2>
393 <p>Les fichiers <tt>.flavor</tt> contiennent en quelques Ko toutes les
394 informations nécessaires pour refabriquer un LiveCD customisé de SliTaz.</p>
397 <h3 id="rebuild-flavor">Refabriquer une saveur</h3>
399 <p>On choisit la saveur à refabriquer parmi celles disponibles.</p>
401 <pre>
402 # tazlito list-flavors
404 List of flavors
405 ================================================================================
406 Name ISO Rootfs Description
407 ================================================================================
408 base 6.9M 13.1M Minimal set of packages to boot
409 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
410 core 31.5M 104.6M SliTaz core system
411 eeepc 31.2M 105.4M SliTaz eeepc system
412 justX 16.1M 51.2M SliTaz with a minimal X environnement
413 </pre>
415 <p>
416 Nous allons refabriquer la saveur <em>eeepc</em> dont le système de fichier
417 utilise 105.4M de RAM et le CD-ROM fait 31.2M.</p>
419 <pre>
420 # tazlito clean-distro
421 # tazlito get-flavor <em>eeepc</em>
422 # tazlito gen-distro
423 </pre>
426 <h3 id="create-flavor">Créer une saveur</h3>
428 <p>Pour créer une saveur, il faut :</p>
430 <ul>
431 <li>Soit créer une image ISO avec <a href="#gen-distro"><code>tazlito
432 gen-distro</code></a> puis créer la saveur correspondante avec
433 <a href="#gen-flavor"><code>tazlito gen-flavor</code></a>.</li>
434 <li>Soit créer directement l'arboscence qui définie la saveur (voir
435 la commande <a href="#extract-flavor"><code>tazlito
436 extract-flavor</code></a>) puis créer la saveur avec
437 <a href="#pack-flavor"><code>tazlito pack-flavor</code></a>.</li>
438 <li>Soit utiliser le <a href="http://pizza.slitaz.org/">générateur de saveur
439 en ligne</a> :</li>
440 </ul>
443 <h3 id="publish-flavor">Publier une saveur</h3>
445 <p>Les fichiers <tt>.flavor</tt> ne font généralement que quelques Ko. Ils
446 peuvent être envoyés via la
447 <a href="http://www.slitaz.org/fr/mailing-list.php">liste de diffusion</a>
448 de SliTaz.</p>
449 <p>Le résultat de <a href="#extract-flavor"><code>tazlito
450 extract-flavor</code></a> peut aussi être mis dans
451 <a href="http://hg.slitaz.org/flavors">mercurial</a>. Cette méthode est
452 préférable car l'arborescence sera directement visible avec
453 <a href="http://hg.slitaz.org/flavors/file/tip">l'interface web de
454 mercurial</a>.</p>
455 <p>Cette arborescence comprend :</p>
456 <ul>
457 <li>Le fichier <b>receipt</b> décrit la saveur grâce aux variables :
458 <ul>
459 <li><em>FLAVOR</em> : le nom de la saveur.</li>
460 <li><em>SHORT_DESC</em> : la description en une ligne.</li>
461 <li><em>VERSION</em> : format libre.</li>
462 <li><em>MAINTAINER</em> : adresse email.</li>
463 <li><em>FRUGAL_RAM</em> : optionnel (peut être estimé), RAM minimum
464 nécessaire.</li>
465 <li><em>ROOTFS_SIZE</em> : optionnel (peut être estimé). Taille
466 de rootfs.gz décompressé en RAM.</li>
467 <li><em>INITRAMFS_SIZE</em> : optionnel (peut être estimé). Taille
468 de rootfs.gz sur le CD-ROM.</li>
469 <li><em>ISO_SIZE</em> : optionnel (peut être estimé). Taille
470 du CD-ROM.</li>
471 <li><em>ROOTFS_SELECTION</em> : optionnel, voir
472 <a href="#meta-flavor">Meta saveur</a> plus bas.</li>
473 </ul>
474 </li>
475 <li>Le fichier <b>packages.list</b> contenant la liste des paquets sans
476 préciser leur version (tazlito utilisera la dernière disponible)
477 Ce fichier est absent si ROOTFS_SELECTION est précisé dans receipt.</li>
478 <li>Le fichier optionnel <b>mirrors</b> contenant la liste des miroirs non
479 officiels (undigest) à ajouter pour inclure des paquets personnels.</li>
480 <li>Le répertoire optionnel <b>rootfs</b> contenant l'arborescence à ajouter
481 dans le système de fichier racine rootfs.gz (des fichiers
482 de configuration habituellement).</li>
483 <li>Le répertoire optionnel <b>rootcd</b> contenant l'arborescence à ajouter
484 dans la racine du CD-ROM.</li>
485 </ul>
488 <h3 id="tune-flavor">Adapter une saveur</h3>
490 <p>Il est souvent plus simple de modifier une saveur existante que d'en créer
491 une ex-nihilo. Pour adapter la saveur eeepc par exemple :</p>
493 <pre>
494 # tazpkg get-install mercurial
495 # cd /home/slitaz
496 # hg clone http://hg.slitaz.org/flavors
497 # cd flavors
498 # cp -a <em>eeepc myslitaz</em>
499 </pre>
501 <p>Les fichiers dans <tt>myslitaz</tt> peuvent être adaptés, puis</p>
503 <pre>
504 # tazlito pack-flavor <em>myslitaz</em>
505 </pre>
507 <p>Créera simplement la nouvelle saveur.</p>
508 <p>Astuce: on peut éviter l'installation de mercurial en extrayant une saveur.
509 L'exemple précédent dévient:</p>
511 <pre>
512 # tazlito get-flavor eeepc
513 # tazlito extract-flavor eeepc.flavor
514 # cd /home/slitaz/flavors
515 # cp -a <em>eeepc myslitaz</em>
516 </pre>
519 <h3 id="meta-flavor">Meta saveur</h3>
521 <p>Une meta saveur contient plusieurs saveurs imbriquées comme des poupées
522 russes. La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
523 disponible. La variable <em>ROOTFS_SELECTION</em> définit les couples (quantité
524 de RAM minimun, saveur correspondante),
525 <a href="http://hg.slitaz.org/flavors/file/tip/core-4in1/receipt">exemple</a> :</p>
527 <pre>
528 ROOTFS_SELECTION="160M core 96M justX 32M base"
529 </pre>
531 <p>Une meta saveur n'a pas de liste de paquets (<tt>packages.list</tt>).
532 Les noyaux SliTaz antérieurs à la version 2.6.30 ne supportaient pas les
533 meta saveurs.</p>
536 <h2>MAINTENEUR</h2>
538 <p>Christophe Lincoln <pankso at slitaz.org><br />
539 Pascal Bellard <pascal.bellard at slitaz.org></p>
541 <!-- End content -->
542 </div>
544 <footer>
545 Copyright © 2013 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
546 </footer>
548 </body>
549 </html>