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