tazlito view doc/tazlito.fr.html @ rev 211
doc: Update CSS and clean-up
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Thu Feb 24 13:45:28 2011 +0100 (2011-02-24) |
| parents | a47ff98afc58 |
| children | b7493ef28221 |
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/flavors/'saveur' qui pourra être gérée
217 avec Mercurial dans http://hg.slitaz.org/flavors.
218 </p>
219 <pre>
220 # tazlito extract-flavor une-saveur
221 </pre>
223 <a name="pack-flavor"></a>
224 <h3>pack-flavor</h3>
225 <p>
226 La commande 'pack-flavor' convertit une arborescence de /home/slitaz/flavors/
227 en saveur (.flavor). Soit l'opération inverse de <i>tazlito extract-flavor</i>.
228 </p>
229 <pre>
230 # tazlito pack-flavor une-saveur
231 </pre>
233 <a name="extract-distro"></a>
234 <h3>extract-distro</h3>
235 <p>
236 La commande 'extract-iso' sert à extraire les fichiers d'une images ISO du
237 LiveCD, pour en reconstruire la structure (Racine du cdrom et du système).
238 Il est ensuite possible de faire les modifications ou ajouts souhaités, pour
239 reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple
240 d'utilisation :
241 </p>
242 <pre>
243 # tazlito extract-distro slitaz-cooking.iso
244 </pre>
245 <a name="gen-distro"></a>
246 <h3>gen-distro</h3>
247 <p>
248 La commande <em>Generate Distribution</em> permet de générer la structure du
249 système Live et une image ISO via une liste de paquets. Pour fonctionner, cette
250 commande a besoin d'une liste de paquets, d'un répertoire contenant tous les
251 paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution.
252 La liste de paquets peut être extraite d'une saveur par la commande get-flavor.
253 Si l'on utilise le Live-CD, les options --cdrom et --iso='image-iso' permettent
254 de refabriquer les packets qui placent des fichiers dans /boot sans être obligé
255 de les télécharger et récupère les fichiers additionnels du Live-CD.
256 Le chemin vers les différents répertoires sont à configurer dans le fichier de
257 configuration utilisé et les paquets peuvent être téléchargés depuis les
258 miroirs de SliTaz ou générés par Tazwok. Pour générer une distro :
259 </p>
260 <pre>
261 # tazlito gen-distro
262 # tazlito gen-distro --cdrom
263 # tazlito gen-distro --iso=slitaz.iso
264 # tazlito gen-distro package-list
265 </pre>
266 <a name="clean-distro"></a>
267 <h3>clean-distro</h3>
268 <p>
269 Supprime tous les fichiers générés ou extraits de la structure du LiveCD :
270 </p>
271 <pre>
272 # tazlito clean-distro
273 </pre>
274 <a name="check-distro"></a>
275 <h3>check-distro</h3>
276 <p>
277 Cette commande permet simplement de vérifier si les fichiers non installés par
278 des paquets, sont bien présents dans la distro :
279 </p>
280 <pre>
281 # tazlito check-distro
282 </pre>
284 <a name="writeiso"></a>
285 <h3>writeiso</h3>
286 <p>
287 Cette commande sauvegarde le système de fichier dans une archive cpio
288 (rootfs.gz) et génère une image ISO bootable. Writeiso peut être utilisé
289 avec une installation sur disque dur ou en mode live. Il sauvegarde aussi
290 votre répertoire /home. Cette commande vous permet de modifier de refabriquer
291 facilement votre propre LiveCD. Il suffit de démarrer le LiveCD, de modifier
292 les fichiers que vous voulez et de faire :
293 </p>
294 <pre>
295 # tazlito writeiso [gzip|lzma|none]
296 # tazlito writeiso gzip
297 # tazlito writeiso gzip image-name
298 </pre>
300 <a name="frugal-install"></a>
301 <h3>frugal-install</h3>
302 <p>
303 Installe les fichiers nécessaire du CD-ROM dans /boot/frugal et ajoute
304 une entée GRUB si nécessaire. En mode frugal, Slitaz fonctionne entièrement
305 en mémoire (RAM). Cela permet de tester une distribution sans graver d'ISO ou
306 d'avoir un OS de dépannage prêt lorsque l'ordinateur démarre.
307 Pour installer tous les fichiers nécessaires à partir d'une arborescence ou
308 d'une image ISO :
309 </p>
310 <pre>
311 # tazlito frugal-install slitaz.iso
312 # tazlito -fi slitaz.iso
313 </pre>
315 <a name="check-list"></a>
316 <h3>check-list</h3>
317 <p>
318 Vérifie si distro-packages.list est à jour avec les dernières version des paquets.
319 </p>
320 <pre>
321 # tazlito check-list
322 </pre>
324 <a name="repack"></a>
325 <h3>repack</h3>
326 <p>
327 Recompresse le(s) rootfs avec la meilleure compression possible.
328 </p>
329 <pre>
330 # tazlito repack slitaz.iso
331 </pre>
333 <a name="merge"></a>
334 <h3>merge</h3>
335 <p>
336 Réunit plusieurs saveurs imbriquées comme des poupées russes. Chaque rootfs
337 est un sous ensemble du précédent. Le premier rootfs est extrait de l'image
338 ISO en 3e paramètre.
339 La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
340 disponible.
341 </p>
342 <pre>
343 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
344 </pre>
346 <a name="build-loram"></a>
347 <h3>build-loram</h3>
348 <p>
349 Crée une image ISO pour les machines avec peu de mémoire.
350 Le système de fichier racine peut soit être toujours chargé en mémoire ou peut
351 éventuellement rester sur le cdrom selon la mémoire disponible.
352 </p>
353 <pre>
354 # tazlito build-loram slitaz.iso loram.iso
355 # tazlito build-loram slitaz.iso loram-cdrom.iso cdrom
356 </pre>
358 <a name="emu-iso"></a>
359 <h3>emu-iso</h3>
360 <p>
361 La commande emu-iso va utiliser l'émulateur Qemu pour démarrer et lançer
362 SliTaz. Qemu permet de tester l'image ISO fraîchement construite sans
363 la graver sur cdrom ou redémarrer en mode frugal.
364 </p>
365 <pre>
366 # tazlito emu-iso
367 # tazlito emu-iso path/to/image.iso
368 </pre>
370 <a name="burn-iso"></a>
371 <h3>burn-iso</h3>
372 <p>
373 Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer
374 l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle
375 du fichier de configuration courant, mais il est possible de spécifier une
376 autre image via la ligne de commande :
377 </p>
378 <pre>
379 # tazlito burn-iso
380 # tazlito burn-iso slitaz-hacked.iso
381 </pre>
383 <h2>SAVEURS</h2>
384 <p>
385 Les fichiers <i>.flavor</i> contiennent en quelques Ko toutes les informations
386 nécessaires pour refabriquer un Live CD customisé de SliTaz.
387 </p>
388 <a name="rebuild-flavor"></a>
389 <h3>Refabriquer une saveur</h3>
390 <p>
391 On choisit la saveur à refabriquer parmi celles disponibles.
392 </p>
393 <pre>
394 # tazlito list-flavors
396 List of flavors
397 ================================================================================
398 Name ISO Rootfs Description
399 ================================================================================
400 base 6.9M 13.1M Minimal set of packages to boot
401 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
402 core 31.5M 104.6M SliTaz core system
403 eeepc 31.2M 105.4M SliTaz eeepc system
404 justX 16.1M 51.2M SliTaz with a minimal X environnement
405 </pre>
406 <p>
407 Nous allons refabriquer la saveur <i>eeepc</i> dont le système de fichier utilise
408 105.4M de RAM et le CD-ROM fait 31.2M.
409 </p>
410 <pre>
411 # tazlito clean-distro
412 # tazlito get-flavor eeepc
413 # tazlito gen-distro
414 </pre>
416 <a name="create-flavor"></a>
417 <h3>Créer une saveur</h3>
418 <p>
419 Pour créer une saveur, il faut :
420 </p>
421 <ul>
422 <li>
423 Soit créer une image ISO avec <b>tazlito gen-distro</b> puis créer la saveur
424 correspondante avec <b>tazlito gen-flavor</b>.
425 </li>
426 <li>
427 Soit créer directement l'arboscence qui définie la saveur (voir la commande
428 <b>tazlito extract-flavor</b>) puis créer la saveur avec
429 <b>tazlito pack-flavor</b>.
430 </li>
431 <li>Soit utiliser le
432 <a href="http://mirror.slitaz.org/pizza/">générateur de saveur en ligne</a> :
433 </li>
434 </ul>
436 <a name="publish-flavor"></a>
437 <h3>Publier une saveur</h3>
438 <p>
439 Les fichiers .flavor ne font généralement que quelques Ko. Ils peuvent être
440 envoyés via la liste de diffusion de SliTaz.
441 </p>
442 <p>
443 Le résultat de <b>tazlito extract-flavor</b> peut aussi être mis dans mercurial
444 (http://repos.slitaz.org/flavors). Cette méthode est préférable car l'arborescence
445 sera directement visible avec
446 <a href="http://hg.slitaz.org/flavors/file/tip">l'interface web de mercurial</a>.
447 </p>
448 <p>
449 Cette arborescence comprend :
450 </p>
451 <ul>
452 <li>
453 Le fichier <b>receipt</b> décrit la saveur grâce aux variables :
454 <ul>
455 <li>
456 <i>FLAVOR</i> : le nom de la saveur.
457 </li>
458 <li>
459 <i>SHORT_DESC</i> : la description en une ligne.
460 </li>
461 <li>
462 <i>VERSION</i> : format libre.
463 </li>
464 <li>
465 <i>MAINTAINER</i> : adresse email.
466 </li>
467 <li>
468 <i>FRUGAL_RAM</i> : optionnel (peut être estimé), RAM minimum nécessaire.
469 </li>
470 <li>
471 <i>ROOTFS_SIZE</i> : optionnel (peut être estimé). Taille de rootfs.gz décompressé en RAM.
472 </li>
473 <li>
474 <i>INITRAMFS_SIZE</i> : optionnel (peut être estimé). Taille de rootfs.gz sur le CD-ROM.
475 </li>
476 <li>
477 <i>ISO_SIZE</i> : optionnel (peut être estimé). Taille du CD-ROM.
478 </li>
479 <li>
480 <i>ROOTFS_SELECTION</i> : optionnel, voir <i>Meta saveur</i> plus bas.
481 </li>
482 </ul>
483 </li>
484 <li>
485 Le fichier <b>packages.list</b> contenant la liste des paquets sans
486 préciser leur version (tazlito utilisera la dernière disponible)
487 Ce fichier est absent si ROOTFS_SELECTION est précisé dans receipt.
488 </li>
489 <li>
490 Le fichier optionnel <b>mirrors</b> contenant la liste des miroirs non
491 officiels (undigest) à ajouter pour inclure des paquets personnels.
492 </li>
493 <li>
494 Le répertoire optionnel <b>rootfs</b> contenant l'arborescence à ajouter dans
495 le système de fichier racine rootfs.gz (des fichiers de configuration
496 habituellement).
497 </li>
498 <li>
499 Le répertoire optionnel <b>rootcd</b> contenant l'arborescence à ajouter dans
500 la racine du CD-ROM.
501 </li>
502 </ul>
504 <a name="tune-flavor"></a>
505 <h3>Adapter une saveur</h3>
506 <p>
507 Il est souvent plus simple de modifier une saveur existante que d'en créer une
508 ex-nihilo. Pour adapter la saveur eeepc par exemple :
509 </p>
510 <pre>
511 # tazpkg get-install mercurial
512 # cd /home/slitaz
513 # hg clone http://hg.slitaz.org/flavors
514 # cd flavors
515 # cp -a eeepc myslitaz
516 </pre>
517 <p>
518 Les fichiers dans myslitaz peuvent être adaptés, puis
519 </p>
520 <pre>
521 # tazlito pack-flavor myslitaz
522 </pre>
523 <p>
524 Créera simplement la nouvelle saveur.
525 </p>
526 <p>
527 Astuce: on peut éviter l'installation de mercurial en extrayant une saveur.
528 L'exemple précédent dévient:
529 </p>
530 <pre>
531 # tazlito get-flavor eeepc
532 # tazlito extract-flavor eeepc.flavor
533 # cd /home/slitaz/flavors
534 # cp -a eeepc myslitaz
535 </pre>
537 <a name="meta-flavor"></a>
538 <h3>Meta saveur</h3>
539 <p>
540 Une meta saveur contient plusieurs saveurs imbriquées comme des poupées russes.
541 La saveur à lancer sera choisie au démarrage suivant la quantité de RAM
542 disponible.
543 La variable <i>ROOTFS_SELECTION</i> définit les couples (quantité de RAM minimun,
544 saveur correspondante), <a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt">
545 exemple</a> :
546 </p>
547 <pre>
548 ROOTFS_SELECTION="160M core 96M justX 32M base"
549 </pre>
550 <p>
551 Une meta saveur n'a pas de liste de paquets <i>(packages.list)</i>.
552 Les noyaux SliTaz antérieurs à la version 2.6.30 ne supportaient pas les
553 meta saveurs.
554 </p>
556 <h2>MAINTENEUR</h2>
557 <p>
558 Christophe Lincoln <pankso at slitaz.org>
559 </p>
561 <!-- End content -->
562 </div>
563 </body>
564 </html>