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