tazlito view doc/tazlito.fr.html @ rev 324
Remove frugal stuff (now a tiny tool is dedicated to frugal install) + (c) --> 2014
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Thu Jan 02 19:22:15 2014 +0100 (2014-01-02) |
| parents | 07b0ae7de856 |
| children | d7d87b67adeb |
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>
307 <h3 id="check-list">check-list</h3>
309 <p>Vérifie si <tt>distro-packages.list</tt> est à jour avec les dernières
310 version des paquets.</p>
312 <pre>
313 # tazlito check-list
314 </pre>
317 <h3 id="repack">repack</h3>
319 <p>Recompresse le(s) rootfs avec la meilleure compression possible.</p>
321 <pre>
322 # tazlito repack <em>slitaz.iso</em>
323 </pre>
326 <h3 id="merge">merge</h3>
328 <p>Réunit plusieurs saveurs imbriquées comme des poupées russes. Chaque rootfs
329 est un sous ensemble du précédent. Le premier rootfs est extrait de l'image
330 ISO en 3e paramètre. La saveur à lancer sera choisie au démarrage suivant
331 la quantité de RAM disponible.</p>
333 <pre>
334 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
335 </pre>
338 <h3 id="build-loram">build-loram</h3>
340 <p>Crée une image ISO pour les machines avec peu de mémoire. Le système
341 de fichier racine peut soit être toujours chargé en mémoire ou peut
342 éventuellement rester sur le cdrom selon la mémoire disponible.</p>
344 <pre>
345 # tazlito build-loram <em>slitaz.iso loram.iso</em>
346 # tazlito build-loram <em>slitaz.iso loram-cdrom.iso</em> cdrom
347 </pre>
350 <h3 id="emu-iso">emu-iso</h3>
352 <p>La commande emu-iso va utiliser l'émulateur Qemu pour démarrer et lançer
353 SliTaz. Qemu permet de tester l'image ISO fraîchement construite sans la graver
354 sur CD-ROM ou redémarrer en mode frugal.</p>
356 <pre>
357 # tazlito emu-iso
358 # tazlito emu-iso <em>path/to/image.iso</em>
359 </pre>
362 <h3 id="burn-iso">burn-iso</h3>
364 <p>Burn ISO va deviner le périphérique de CD-ROM, sa vitesse de gravure
365 et lancer l'outils Wodim pour graver une image ISO. L'image ISO par défaut est
366 celle du fichier de configuration courant, mais il est possible de spécifier une
367 autre image via la ligne de commande :</p>
369 <pre>
370 # tazlito burn-iso
371 # tazlito burn-iso <em>slitaz-hacked.iso</em>
372 </pre>
375 <h2>SAVEURS</h2>
377 <p>Les fichiers <tt>.flavor</tt> contiennent en quelques Ko toutes les
378 informations nécessaires pour refabriquer un LiveCD customisé de SliTaz.</p>
381 <h3 id="rebuild-flavor">Refabriquer une saveur</h3>
383 <p>On choisit la saveur à refabriquer parmi celles disponibles.</p>
385 <pre>
386 # tazlito list-flavors
388 List of flavors
389 ================================================================================
390 Name ISO Rootfs Description
391 ================================================================================
392 base 6.9M 13.1M Minimal set of packages to boot
393 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
394 core 31.5M 104.6M SliTaz core system
395 eeepc 31.2M 105.4M SliTaz eeepc system
396 justX 16.1M 51.2M SliTaz with a minimal X environnement
397 </pre>
399 <p>
400 Nous allons refabriquer la saveur <em>eeepc</em> dont le système de fichier
401 utilise 105.4M de RAM et le CD-ROM fait 31.2M.</p>
403 <pre>
404 # tazlito clean-distro
405 # tazlito get-flavor <em>eeepc</em>
406 # tazlito gen-distro
407 </pre>
410 <h3 id="create-flavor">Créer une saveur</h3>
412 <p>Pour créer une saveur, il faut :</p>
414 <ul>
415 <li>Soit créer une image ISO avec <a href="#gen-distro"><code>tazlito
416 gen-distro</code></a> puis créer la saveur correspondante avec
417 <a href="#gen-flavor"><code>tazlito gen-flavor</code></a>.</li>
418 <li>Soit créer directement l'arboscence qui définie la saveur (voir
419 la commande <a href="#extract-flavor"><code>tazlito
420 extract-flavor</code></a>) puis créer la saveur avec
421 <a href="#pack-flavor"><code>tazlito pack-flavor</code></a>.</li>
422 <li>Soit utiliser le <a href="http://pizza.slitaz.org/">générateur de saveur
423 en ligne</a> :</li>
424 </ul>
427 <h3 id="publish-flavor">Publier une saveur</h3>
429 <p>Les fichiers <tt>.flavor</tt> ne font généralement que quelques Ko. Ils
430 peuvent être envoyés via la
431 <a href="http://www.slitaz.org/fr/mailing-list.php">liste de diffusion</a>
432 de SliTaz.</p>
433 <p>Le résultat de <a href="#extract-flavor"><code>tazlito
434 extract-flavor</code></a> peut aussi être mis dans
435 <a href="http://hg.slitaz.org/flavors">mercurial</a>. Cette méthode est
436 préférable car l'arborescence sera directement visible avec
437 <a href="http://hg.slitaz.org/flavors/file/tip">l'interface web de
438 mercurial</a>.</p>
439 <p>Cette arborescence comprend :</p>
440 <ul>
441 <li>Le fichier <b>receipt</b> décrit la saveur grâce aux variables :
442 <ul>
443 <li><em>FLAVOR</em> : le nom de la saveur.</li>
444 <li><em>SHORT_DESC</em> : la description en une ligne.</li>
445 <li><em>VERSION</em> : format libre.</li>
446 <li><em>MAINTAINER</em> : adresse email.</li>
447 <li><em>FRUGAL_RAM</em> : optionnel (peut être estimé), RAM minimum
448 nécessaire.</li>
449 <li><em>ROOTFS_SIZE</em> : optionnel (peut être estimé). Taille
450 de rootfs.gz décompressé en RAM.</li>
451 <li><em>INITRAMFS_SIZE</em> : optionnel (peut être estimé). Taille
452 de rootfs.gz sur le CD-ROM.</li>
453 <li><em>ISO_SIZE</em> : optionnel (peut être estimé). Taille
454 du CD-ROM.</li>
455 <li><em>ROOTFS_SELECTION</em> : optionnel, voir
456 <a href="#meta-flavor">Meta saveur</a> plus bas.</li>
457 </ul>
458 </li>
459 <li>Le fichier <b>packages.list</b> contenant la liste des paquets sans
460 préciser leur version (tazlito utilisera la dernière disponible)
461 Ce fichier est absent si ROOTFS_SELECTION est précisé dans receipt.</li>
462 <li>Le fichier optionnel <b>mirrors</b> contenant la liste des miroirs non
463 officiels (undigest) à ajouter pour inclure des paquets personnels.</li>
464 <li>Le répertoire optionnel <b>rootfs</b> contenant l'arborescence à ajouter
465 dans le système de fichier racine rootfs.gz (des fichiers
466 de configuration habituellement).</li>
467 <li>Le répertoire optionnel <b>rootcd</b> contenant l'arborescence à ajouter
468 dans la racine du CD-ROM.</li>
469 </ul>
472 <h3 id="tune-flavor">Adapter une saveur</h3>
474 <p>Il est souvent plus simple de modifier une saveur existante que d'en créer
475 une ex-nihilo. Pour adapter la saveur eeepc par exemple :</p>
477 <pre>
478 # tazpkg get-install mercurial
479 # cd /home/slitaz
480 # hg clone http://hg.slitaz.org/flavors
481 # cd flavors
482 # cp -a <em>eeepc myslitaz</em>
483 </pre>
485 <p>Les fichiers dans <tt>myslitaz</tt> peuvent être adaptés, puis</p>
487 <pre>
488 # tazlito pack-flavor <em>myslitaz</em>
489 </pre>
491 <p>Créera simplement la nouvelle saveur.</p>
492 <p>Astuce: on peut éviter l'installation de mercurial en extrayant une saveur.
493 L'exemple précédent dévient:</p>
495 <pre>
496 # tazlito get-flavor eeepc
497 # tazlito extract-flavor eeepc.flavor
498 # cd /home/slitaz/flavors
499 # cp -a <em>eeepc myslitaz</em>
500 </pre>
503 <h3 id="meta-flavor">Meta saveur</h3>
505 <p>Une meta saveur contient plusieurs saveurs imbriquées comme des poupées
506 russes. La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
507 disponible. La variable <em>ROOTFS_SELECTION</em> définit les couples (quantité
508 de RAM minimun, saveur correspondante),
509 <a href="http://hg.slitaz.org/flavors/file/tip/core-4in1/receipt">exemple</a> :</p>
511 <pre>
512 ROOTFS_SELECTION="160M core 96M justX 32M base"
513 </pre>
515 <p>Une meta saveur n'a pas de liste de paquets (<tt>packages.list</tt>).
516 Les noyaux SliTaz antérieurs à la version 2.6.30 ne supportaient pas les
517 meta saveurs.</p>
520 <h2>MAINTENEUR</h2>
522 <p>Christophe Lincoln <pankso at slitaz.org><br />
523 Pascal Bellard <pascal.bellard at slitaz.org></p>
525 <!-- End content -->
526 </div>
528 <footer>
529 Copyright © 2014 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
530 </footer>
532 </body>
533 </html>