tazlito view doc/tazlito.fr.html @ rev 216
Tiny edits
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Sun Mar 06 21:10:08 2011 +0000 (2011-03-06) |
| parents | deb4940afbdd |
| children | 24e40c1edb67 |
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="fr" lang="fr">
4 <head>
5 <title>Tazlito Manual - SliTaz Live Tool</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2011-02-24 13:30:00" />
10 <style type="text/css"><!--
11 body { font: 90% sans-serif, vernada, arial; margin: 0;
12 border-top: 34px solid #f1f1f1; }
13 #header { background: #351a0a; color: black; height: 50px;
14 border-top: 1px solid black; border-bottom: 1px solid black; }
15 #content { margin: 0px 50px 26px 50px; }
16 h1 { margin: 14px 0px 0px 16px; color: #fff; margin: 10px; }
17 h3 { font-weight: bold; color: #666666; }
18 li { line-height: 1.4em; }
19 pre { padding: 5px; color: black; background: #e1e0b0;
20 border-radius: 4px; -moz-border-radius: 4px; -webkit-border-radius: 4px; }
21 code { font-size: 100%; color: #669900; background: transparent; }
22 hr { color: white; background: white; height: 1px; border: 0; }
23 --></style>
24 </head>
25 <body bgcolor="#ffffff">
26 <div id="header">
27 <h1>Tazlito Manual</h1>
28 </div>
29 <hr />
30 <!-- Start content -->
31 <div id="content">
33 <h2>NOM</h2>
34 <p>
35 Tazlito - SliTaz Live Tool.
36 </p>
38 <h2>SYNTAXE</h2>
39 <pre>
40 tazlito [command] [list|iso|flavor] [dir]
41 </pre>
43 <h2>DESCRIPTION</h2>
44 <p>
45 Tazlito est un petit utilitaire permettant d'extraire le LiveCD, reconstruire
46 l'image ISO ou regénérer le système racine du LiveCD de SliTaz. Tazlito donne
47 aussi la possibilité de générer une distribution depuis une liste de paquets
48 préalablements téléchargés et stockés dans un répertoire. Pour fonctionner,
49 l'application Tazlito utilise un fichier de configuration système
50 /etc/tazlito/tazlito.conf ou un fichier tazlito.conf se trouvant dans le
51 répertoire courant. Ce fichier de configuration peut facilement être généré
52 automatiquement par Tazlito, il spécifie le nom de l'image ISO, le nom du
53 volume, le préparateur, le chemin vers le repositoire des paquets et celui
54 vers la distribution. Tazlito permet aussi de configurer un répertoire
55 contenant des fichiers additionnels, qui seront copiés dans le LiveCD lors
56 de la génération de la distribution.
57 </p>
58 <p>
59 Tazlito est, distribué sous licence libre GNU gpl v3, installé par défaut sur
60 SliTaz et installé/testé avec succès sur Debian GNU/Linux. Vous trouverez
61 aussi un complément d'informations au sujet de création de sa propre version
62 du LiveCD, via le livre de cuisine (Cookbook) de SliTaz
63 (http://www.slitaz.org/doc/cookbook/) et le Handbook.
64 </p>
66 <h2>COMMANDES</h2>
67 <a name="usage"></a>
68 <h3>usage</h3>
69 <p>
70 La commande 'usage' affiche une liste des commandes disponibles avec une
71 courte description :
72 </p>
73 <pre>
74 # tazlito usage
75 </pre>
77 <a name="stats"></a>
78 <h3>stats</h3>
79 <p>
80 Stats affiche les variables de configuration, le chemin vers les différents
81 fichiers et répertoires et les informations sur l'image ISO :
82 </p>
83 <pre>
84 # tazlito stats
85 </pre>
87 <a name="gen-config"></a>
88 <h3>gen-config</h3>
89 <p>
90 La commande 'gen-config' vous permet de générer une fichier de configuration
91 prêt à être édité. Par défaut le fichier est créé dans le répertoire courant
92 et peut aussi l'être dans un autre répertoire si spécifié :
93 </p>
94 <pre>
95 # tazlito gen-config
96 # tazlito gen-config /path/to/distro
97 </pre>
99 <a name="configure"></a>
100 <h3>configure</h3>
101 <p>
102 La commande configure permet de configurer le fichier de configuration
103 système ou celui trouvé dans le répertoire courant :
104 </p>
105 <pre>
106 # tazlito configure
107 </pre>
109 <a name="gen-iso"></a>
110 <h3>gen-iso</h3>
111 <p>
112 La commande 'gen-iso' pour <em>Generate ISO</em> permet de générer une nouvelle
113 image ISO du LiveCD suite à des modifications et ajouter dans le système
114 racine du cdrom. Pour fonctionner cette commande a besoin d'un répertoire
115 contenant la structure du système Live, cette structure peur facilement être
116 construite avec la commande 'extract-distro', modifiée et reconstruite via :
117 </p>
118 <pre>
119 # tazlito gen-iso
120 </pre>
122 <a name="gen-initiso"></a>
123 <h3>gen-initiso</h3>
124 <p>
125 La commande 'gen-initiso' va faire le même travail que 'gen-iso' mais en
126 reconstruisant préalablement l'initramfs compressé du système. L'initramfs
127 contient tous le système racine de la distribution et doit être reconstruite
128 en cas de modifications sur les fichiers.
129 </p>
130 <pre>
131 # tazlito gen-initiso
132 </pre>
134 <a name="list-flavors"></a>
135 <h3>list-flavors</h3>
136 <p>
137 La commande 'list-flavors' télécharge si nécessaire et affiche la liste des
138 différentes saveurs disponibles. On peut forcer le téléchargement avec
139 '--recharge'.
140 </p>
141 <pre>
142 # tazlito list-flavors
143 # tazlito list-flavors --recharge
144 </pre>
145 <a name="get-flavor"></a>
146 <h3>get-flavor</h3>
147 <p>
148 La commande 'get-flavor' télécharge si nécessaire et prépare les fichiers
149 nécessaires à 'gen-distro' pour refabriquer une saveur.
150 </p>
151 <pre>
152 # tazlito get-flavor saveur-particuliere
153 </pre>
155 <a name="show-flavor"></a>
156 <h3>show-flavor</h3>
157 <p>
158 La commande 'show-flavor' affiche les caractéristiques d'une saveur et ses
159 dimensions après refabrication. Les options '--brief' et '--noheader' réduisent
160 l'affichage produit.
161 </p>
162 <pre>
163 # tazlito show-flavor saveur-particuliere
164 # tazlito show-flavor saveur-particuliere --brief
165 # tazlito show-flavor saveur-particuliere --brief --noheader
166 </pre>
168 <a name="gen-flavor"></a>
169 <h3>gen-flavor</h3>
170 <p>
171 La commande 'gen-flavor' crée un fichier de description d'une nouvelle saveur
172 à partir des résultats de fabrication de 'gen-distro'. Le fichier .flavor
173 produit pourra être ensuite envoyé à slitaz.org.
174 </p>
175 <pre>
176 # tazlito gen-flavor nouvelle-saveur
177 </pre>
179 <a name="gen-liveflavor"></a>
180 <h3>gen-liveflavor</h3>
181 <p>
182 La commande 'gen-liveflavor' crée une image ISO et un fichier de description
183 d'une nouvelle saveur à partir de la distribution courante. Un fichier texte
184 optionnel permetde décrire les modifications à faire par rapport à la
185 distribution courante. Le format de chacune de ses lignes est
186 [code][tabulation][caractères]. Les valeurs possibles de code sont +,-,@,! et ?
187 pour ajouter un paquet, le retirer, décrire la saveur, ajouter un paquet non
188 libre, et afficher un message à l'écran.
189 </p>
190 <pre>
191 # tazlito gen-liveflavor nouvelle-saveur
192 # tazlito gen-liveflavor autre-saveur mes-modifications
193 # cat mes-modifications
194 @ Developper tools and some non-free packages
195 + slitaz-toolchain
196 + mercurial
197 ! skype
198 ! flash-plugin
199 </pre>
201 <a name="upgrade-flavor"></a>
202 <h3>upgrade-flavor</h3>
203 <p>
204 La commande 'upgrade-flavor' raffraîchit une saveur consue pour une ancienne
205 version de SliTaz en mettant à jour la liste des paquets avec les dernières
206 versions des paquets disponibles.
207 </p>
208 <pre>
209 # tazlito upgrade-flavor une-saveur
210 </pre>
212 <a name="extract-flavor"></a>
213 <h3>extract-flavor</h3>
214 <p>
215 La commande 'extract-flavor' convertit une saveur en une arborescence
216 facilement modifiable dans /home/slitaz/VERSION/flavors qui pourra être gérée
217 avec Mercurial dans <a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>.
218 Par exemple sur une cooking le répértoire de travail sera /home/slitaz/cooking/flavors.
219 </p>
220 <pre>
221 # tazlito extract-flavor une-saveur
222 </pre>
224 <a name="pack-flavor"></a>
225 <h3>pack-flavor</h3>
226 <p>
227 La commande 'pack-flavor' convertit une arborescence de /home/slitaz/VERSION/flavors
228 en saveur (.flavor). Soit l'opération inverse de <i>tazlito extract-flavor</i>.
229 </p>
230 <pre>
231 # tazlito pack-flavor une-saveur
232 </pre>
234 <a name="extract-distro"></a>
235 <h3>extract-distro</h3>
236 <p>
237 La commande 'extract-iso' sert à extraire les fichiers d'une images ISO du
238 LiveCD, pour en reconstruire la structure (Racine du cdrom et du système).
239 Il est ensuite possible de faire les modifications ou ajouts souhaités, pour
240 reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple
241 d'utilisation :
242 </p>
243 <pre>
244 # tazlito extract-distro slitaz-cooking.iso
245 </pre>
246 <a name="gen-distro"></a>
247 <h3>gen-distro</h3>
248 <p>
249 La commande <em>Generate Distribution</em> permet de générer la structure du
250 système Live et une image ISO via une liste de paquets. Pour fonctionner, cette
251 commande a besoin d'une liste de paquets, d'un répertoire contenant tous les
252 paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution.
253 La liste de paquets peut être extraite d'une saveur par la commande get-flavor.
254 Si l'on utilise le Live-CD, les options --cdrom et --iso='image-iso' permettent
255 de refabriquer les packets qui placent des fichiers dans /boot sans être obligé
256 de les télécharger et récupère les fichiers additionnels du Live-CD.
257 Le chemin vers les différents répertoires sont à configurer dans le fichier de
258 configuration utilisé et les paquets peuvent être téléchargés depuis les
259 miroirs de SliTaz ou générés par Tazwok. Pour générer une distro :
260 </p>
261 <pre>
262 # tazlito gen-distro
263 # tazlito gen-distro --cdrom
264 # tazlito gen-distro --iso=slitaz.iso
265 # tazlito gen-distro package-list
266 </pre>
267 <a name="clean-distro"></a>
268 <h3>clean-distro</h3>
269 <p>
270 Supprime tous les fichiers générés ou extraits de la structure du LiveCD :
271 </p>
272 <pre>
273 # tazlito clean-distro
274 </pre>
275 <a name="check-distro"></a>
276 <h3>check-distro</h3>
277 <p>
278 Cette commande permet simplement de vérifier si les fichiers non installés par
279 des paquets, sont bien présents dans la distro :
280 </p>
281 <pre>
282 # tazlito check-distro
283 </pre>
285 <a name="writeiso"></a>
286 <h3>writeiso</h3>
287 <p>
288 Cette commande sauvegarde le système de fichier dans une archive cpio
289 (rootfs.gz) et génère une image ISO bootable. Writeiso peut être utilisé
290 avec une installation sur disque dur ou en mode live. Il sauvegarde aussi
291 votre répertoire /home. Cette commande vous permet de modifier de refabriquer
292 facilement votre propre LiveCD. Il suffit de démarrer le LiveCD, de modifier
293 les fichiers que vous voulez et de faire :
294 </p>
295 <pre>
296 # tazlito writeiso [gzip|lzma|none]
297 # tazlito writeiso gzip
298 # tazlito writeiso gzip image-name
299 </pre>
301 <a name="frugal-install"></a>
302 <h3>frugal-install</h3>
303 <p>
304 Installe les fichiers nécessaire du CD-ROM dans /boot/frugal et ajoute
305 une entée GRUB si nécessaire. En mode frugal, Slitaz fonctionne entièrement
306 en mémoire (RAM). Cela permet de tester une distribution sans graver d'ISO ou
307 d'avoir un OS de dépannage prêt lorsque l'ordinateur démarre.
308 Pour installer tous les fichiers nécessaires à partir d'une arborescence ou
309 d'une image ISO :
310 </p>
311 <pre>
312 # tazlito frugal-install slitaz.iso
313 # tazlito -fi slitaz.iso
314 </pre>
316 <a name="check-list"></a>
317 <h3>check-list</h3>
318 <p>
319 Vérifie si distro-packages.list est à jour avec les dernières version des paquets.
320 </p>
321 <pre>
322 # tazlito check-list
323 </pre>
325 <a name="repack"></a>
326 <h3>repack</h3>
327 <p>
328 Recompresse le(s) rootfs avec la meilleure compression possible.
329 </p>
330 <pre>
331 # tazlito repack slitaz.iso
332 </pre>
334 <a name="merge"></a>
335 <h3>merge</h3>
336 <p>
337 Réunit plusieurs saveurs imbriquées comme des poupées russes. Chaque rootfs
338 est un sous ensemble du précédent. Le premier rootfs est extrait de l'image
339 ISO en 3e paramètre.
340 La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
341 disponible.
342 </p>
343 <pre>
344 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
345 </pre>
347 <a name="build-loram"></a>
348 <h3>build-loram</h3>
349 <p>
350 Crée une image ISO pour les machines avec peu de mémoire.
351 Le système de fichier racine peut soit être toujours chargé en mémoire ou peut
352 éventuellement rester sur le cdrom selon la mémoire disponible.
353 </p>
354 <pre>
355 # tazlito build-loram slitaz.iso loram.iso
356 # tazlito build-loram slitaz.iso loram-cdrom.iso cdrom
357 </pre>
359 <a name="emu-iso"></a>
360 <h3>emu-iso</h3>
361 <p>
362 La commande emu-iso va utiliser l'émulateur Qemu pour démarrer et lançer
363 SliTaz. Qemu permet de tester l'image ISO fraîchement construite sans
364 la graver sur cdrom ou redémarrer en mode frugal.
365 </p>
366 <pre>
367 # tazlito emu-iso
368 # tazlito emu-iso path/to/image.iso
369 </pre>
371 <a name="burn-iso"></a>
372 <h3>burn-iso</h3>
373 <p>
374 Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer
375 l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle
376 du fichier de configuration courant, mais il est possible de spécifier une
377 autre image via la ligne de commande :
378 </p>
379 <pre>
380 # tazlito burn-iso
381 # tazlito burn-iso slitaz-hacked.iso
382 </pre>
384 <h2>SAVEURS</h2>
385 <p>
386 Les fichiers <i>.flavor</i> contiennent en quelques Ko toutes les informations
387 nécessaires pour refabriquer un Live CD customisé de SliTaz.
388 </p>
389 <a name="rebuild-flavor"></a>
390 <h3>Refabriquer une saveur</h3>
391 <p>
392 On choisit la saveur à refabriquer parmi celles disponibles.
393 </p>
394 <pre>
395 # tazlito list-flavors
397 List of flavors
398 ================================================================================
399 Name ISO Rootfs Description
400 ================================================================================
401 base 6.9M 13.1M Minimal set of packages to boot
402 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
403 core 31.5M 104.6M SliTaz core system
404 eeepc 31.2M 105.4M SliTaz eeepc system
405 justX 16.1M 51.2M SliTaz with a minimal X environnement
406 </pre>
407 <p>
408 Nous allons refabriquer la saveur <i>eeepc</i> dont le système de fichier utilise
409 105.4M de RAM et le CD-ROM fait 31.2M.
410 </p>
411 <pre>
412 # tazlito clean-distro
413 # tazlito get-flavor eeepc
414 # tazlito gen-distro
415 </pre>
417 <a name="create-flavor"></a>
418 <h3>Créer une saveur</h3>
419 <p>
420 Pour créer une saveur, il faut :
421 </p>
422 <ul>
423 <li>
424 Soit créer une image ISO avec <b>tazlito gen-distro</b> puis créer la saveur
425 correspondante avec <b>tazlito gen-flavor</b>.
426 </li>
427 <li>
428 Soit créer directement l'arboscence qui définie la saveur (voir la commande
429 <b>tazlito extract-flavor</b>) puis créer la saveur avec
430 <b>tazlito pack-flavor</b>.
431 </li>
432 <li>Soit utiliser le
433 <a href="http://mirror.slitaz.org/pizza/">générateur de saveur en ligne</a> :
434 </li>
435 </ul>
437 <a name="publish-flavor"></a>
438 <h3>Publier une saveur</h3>
439 <p>
440 Les fichiers .flavor ne font généralement que quelques Ko. Ils peuvent être
441 envoyés via la liste de diffusion de SliTaz.
442 </p>
443 <p>
444 Le résultat de <b>tazlito extract-flavor</b> peut aussi être mis dans mercurial
445 (http://repos.slitaz.org/flavors). Cette méthode est préférable car l'arborescence
446 sera directement visible avec
447 <a href="http://hg.slitaz.org/flavors/file/tip">l'interface web de mercurial</a>.
448 </p>
449 <p>
450 Cette arborescence comprend :
451 </p>
452 <ul>
453 <li>
454 Le fichier <b>receipt</b> décrit la saveur grâce aux variables :
455 <ul>
456 <li>
457 <i>FLAVOR</i> : le nom de la saveur.
458 </li>
459 <li>
460 <i>SHORT_DESC</i> : la description en une ligne.
461 </li>
462 <li>
463 <i>VERSION</i> : format libre.
464 </li>
465 <li>
466 <i>MAINTAINER</i> : adresse email.
467 </li>
468 <li>
469 <i>FRUGAL_RAM</i> : optionnel (peut être estimé), RAM minimum nécessaire.
470 </li>
471 <li>
472 <i>ROOTFS_SIZE</i> : optionnel (peut être estimé). Taille de rootfs.gz décompressé en RAM.
473 </li>
474 <li>
475 <i>INITRAMFS_SIZE</i> : optionnel (peut être estimé). Taille de rootfs.gz sur le CD-ROM.
476 </li>
477 <li>
478 <i>ISO_SIZE</i> : optionnel (peut être estimé). Taille du CD-ROM.
479 </li>
480 <li>
481 <i>ROOTFS_SELECTION</i> : optionnel, voir <i>Meta saveur</i> plus bas.
482 </li>
483 </ul>
484 </li>
485 <li>
486 Le fichier <b>packages.list</b> contenant la liste des paquets sans
487 préciser leur version (tazlito utilisera la dernière disponible)
488 Ce fichier est absent si ROOTFS_SELECTION est précisé dans receipt.
489 </li>
490 <li>
491 Le fichier optionnel <b>mirrors</b> contenant la liste des miroirs non
492 officiels (undigest) à ajouter pour inclure des paquets personnels.
493 </li>
494 <li>
495 Le répertoire optionnel <b>rootfs</b> contenant l'arborescence à ajouter dans
496 le système de fichier racine rootfs.gz (des fichiers de configuration
497 habituellement).
498 </li>
499 <li>
500 Le répertoire optionnel <b>rootcd</b> contenant l'arborescence à ajouter dans
501 la racine du CD-ROM.
502 </li>
503 </ul>
505 <a name="tune-flavor"></a>
506 <h3>Adapter une saveur</h3>
507 <p>
508 Il est souvent plus simple de modifier une saveur existante que d'en créer une
509 ex-nihilo. Pour adapter la saveur eeepc par exemple :
510 </p>
511 <pre>
512 # tazpkg get-install mercurial
513 # cd /home/slitaz
514 # hg clone http://hg.slitaz.org/flavors
515 # cd flavors
516 # cp -a eeepc myslitaz
517 </pre>
518 <p>
519 Les fichiers dans myslitaz peuvent être adaptés, puis
520 </p>
521 <pre>
522 # tazlito pack-flavor myslitaz
523 </pre>
524 <p>
525 Créera simplement la nouvelle saveur.
526 </p>
527 <p>
528 Astuce: on peut éviter l'installation de mercurial en extrayant une saveur.
529 L'exemple précédent dévient:
530 </p>
531 <pre>
532 # tazlito get-flavor eeepc
533 # tazlito extract-flavor eeepc.flavor
534 # cd /home/slitaz/flavors
535 # cp -a eeepc myslitaz
536 </pre>
538 <a name="meta-flavor"></a>
539 <h3>Meta saveur</h3>
540 <p>
541 Une meta saveur contient plusieurs saveurs imbriquées comme des poupées russes.
542 La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
543 disponible.
544 La variable <i>ROOTFS_SELECTION</i> définit les couples (quantité de RAM minimun,
545 saveur correspondante), <a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt">
546 exemple</a> :
547 </p>
548 <pre>
549 ROOTFS_SELECTION="160M core 96M justX 32M base"
550 </pre>
551 <p>
552 Une meta saveur n'a pas de liste de paquets <i>(packages.list)</i>.
553 Les noyaux SliTaz antérieurs à la version 2.6.30 ne supportaient pas les
554 meta saveurs.
555 </p>
557 <h2>MAINTENEUR</h2>
558 <p>
559 Christophe Lincoln <pankso at slitaz.org>
560 </p>
562 <!-- End content -->
563 </div>
564 </body>
565 </html>