tazlito view doc/tazlito.html @ rev 22

Add flavor support
author Pascal Bellard <pascal.bellard@slitaz.org>
date Fri Dec 21 16:50:24 2007 +0100 (2007-12-21)
parents aa6ce5d69813
children 01f5ee3362fb
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">
31
32 <h2>NOM</h2>
33 <p>
34 Tazlito - SliTaz Live Tool.
35 </p>
36
37 <h2>SYNTAXE</h2>
38 <pre>
39 tazlito [command] [list|iso|flavor] [dir]
40 </pre>
41
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/slitaz-tools/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>
64
65 <h2>COMMANDES</h2>
66 <h3><font color="#6c0023">usage</font></h3>
67 <p>
68 La commande 'usage' affiche une liste des commandes disponibles avec une
69 courte description :
70 </p>
71 <pre>
72 # tazlito usage
73 </pre>
74 <h3><font color="#6c0023">stats</font></h3>
75 <p>
76 Stats affiche les variables de configuration, le chemin vers les différents
77 fichiers et répertoires et les informations sur l'image ISO :
78 </p>
79 <pre>
80 # tazlito stats
81 </pre>
82 <h3><font color="#6c0023">gen-config</font></h3>
83 <p>
84 La commande 'gen-config' vous permet de générer une fichier de configuration
85 prêt à être édité. Par défaut le fichier est créé dans le répertoire courant
86 et peut aussi l'être dans un autre répertoire si spécifié :
87 </p>
88 <pre>
89 # tazlito gen-config
90 # tazlito gen-config /path/to/distro
91 </pre>
92 <h3><font color="#6c0023">configure</font></h3>
93 <p>
94 La commande configure permet de configurer le fichier de configuration
95 système ou celui trouvé dans le répertoire courant :
96 </p>
97 <pre>
98 # tazlito configure
99 </pre>
100 <h3><font color="#6c0023">gen-iso</font></h3>
101 <p>
102 La commande 'gen-iso' pour <em>Generate ISO</em> permet de générer une nouvelle
103 image ISO du LiveCD suite à des modifications et ajouter dans le système
104 racine du cdrom. Pour fonctionner cette commande a besoin d'un répertoire
105 contenant la structure du système Live, cette structure peur facilement être
106 construite avec la commande 'extract-distro', modifiée et reconstruite via :
107 </p>
108 <pre>
109 # tazlito gen-iso
110 </pre>
111 <h3><font color="#6c0023">gen-initiso</font></h3>
112 <p>
113 La commande 'gen-initiso' va faire le même travail que 'gen-iso' mais en
114 reconstruisant préalablement l'initramfs compressé du système. L'initramfs
115 contient tous le système racine de la distribution et doit être reconstruite
116 en cas de modifications sur les fichiers.
117 </p>
118 <pre>
119 # tazlito gen-initiso
120 </pre>
121 <h3><font color="#6c0023">list-flavors</font></h3>
122 <p>
123 La commande 'list-flavors' télécharge si nécessaire et affiche la liste des
124 différentes saveurs disponibles. On peut forcer le téléchargement avec
125 '--recharge'.
126 </p>
127 <pre>
128 # tazlito list-flavors
129 # tazlito list-flavors --recharge
130 </pre>
131 <h3><font color="#6c0023">get-flavor</font></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>
139 <h3><font color="#6c0023">show-flavor</font></h3>
140 <p>
141 La commande 'show-flavor' affiche les caractéristiques d'une saveur et ses
142 dimensions après refabrication. Les options '--brief' et '--noheader' réduisent
143 l'affichage produit.
144 </p>
145 <pre>
146 # tazlito show-flavor saveur-particuliere
147 # tazlito show-flavor saveur-particuliere --brief
148 # tazlito show-flavor saveur-particuliere --brief --noheader
149 </pre>
150 <h3><font color="#6c0023">gen-flavor</font></h3>
151 <p>
152 La commande 'gen-flavor' crée un fichier de description d'une nouvelle saveur
153 à partir des résultats de fabrication de 'gen-distro'. Le fichier .flavor
154 produit pourra être ensuite envoyé à slitaz.org.
155 </p>
156 <pre>
157 # tazlito gen-flavor nouvelle-saveur
158 </pre>
159 <h3><font color="#6c0023">extract-distro</font></h3>
160 <p>
161 La commande 'extract-iso' sert à extraire les fichiers d'une images ISO du
162 LiveCD, pour en reconstruire la structure (Racine du cdrom et du système).
163 Il est ensuite possible de faire les modifications ou ajouts souhaités, pour
164 reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple
165 d'utilisation :
166 </p>
167 <pre>
168 # tazlito extract-distro slitaz-cooking.iso
169 </pre>
170 <h3><font color="#6c0023">gen-distro</font></h3>
171 <p>
172 La commande <em>Generate Distribution</em> permet de générer la structure du
173 système Live et une image ISO via une liste de paquets. Pour fonctionner, cette
174 commande a besoin d'une liste de paquets, d'un répertoire contenant tous les
175 paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution.
176 La liste de paquets peut être extraite d'une saveur par la commande get-flavor.
177 Si l'on utilise le Live-CD, les options --cdrom et --iso=<image-iso> permettent
178 de refabriquer les packets qui placent des fichiers dans /boot sans être obligé
179 de les télécharger et récupère les fichiers additionnels du Live-CD.
180 Le chemin vers les différents répertoires sont à configurer dans le fichier de
181 configuration utilisé et les paquets peuvent être téléchargés depuis les
182 miroirs de SliTaz ou générés par Tazwok. Pour générer une distro :
183 </p>
184 <pre>
185 # tazlito gen-distro
186 # tazlito gen-distro --cdrom
187 # tazlito gen-distro --iso=slitaz.iso
188 # tazlito gen-distro package-list
189 </pre>
190 <h3><font color="#6c0023">clean-distro</font></h3>
191 <p>
192 Supprime tous les fichiers générés ou extraits de la structure du LiveCD :
193 </p>
194 <pre>
195 # tazlito clean-distro
196 </pre>
197 <h3><font color="#6c0023">addhacker</font></h3>
198 <p>
199 La commande 'addhacker' permet d'ajouter l'utilisateur Hacker à la distribution,
200 cela permet d'avoir un compte utilisateur sans mot de passe. A noter que cette
201 commande effectue un changement de permissions sur tous les fichiers contenus
202 dans <code>/home/hacker</code> :
203 </p>
204 <pre>
205 # tazlito addhacker
206 </pre>
207 <h3><font color="#6c0023">check-distro</font></h3>
208 <p>
209 Cette commande permet simplement de vérifier si les fichiers non installés par
210 des paquets, sont bien présents dans la distro :
211 </p>
212 <pre>
213 # tazlito check-distro
214 </pre>
215 <h3><font color="#6c0023">burn-iso</font></h3>
216 <p>
217 Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer
218 l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle
219 du fichier de configuration courant, mais il est possible de spécifier une
220 autre image via la ligne de commande :
221 </p>
222 <pre>
223 # tazlito burn-iso
224 # tazlito burn-iso slitaz-hacked.iso
225 </pre>
226
227 <h2>MAINTENEUR</h2>
228 <p>
229 Christophe Lincoln &lt;pankso at slitaz.org&gt;
230 </p>
231
232 <!-- End content -->
233 </div>
234 </body>
235 </html>