tazlito view doc/tazlito.html @ rev 75

Desktop file for tazlito manual
author Christophe Lincoln <pankso@slitaz.org>
date Tue Jun 10 01:22:59 2008 +0200 (2008-06-10)
parents 8c53c4a8db66
children 31c1dadc0a0a
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/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>
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">gen-liveflavor</font></h3>
160 <p>
161 La commande 'gen-liveflavor' crée une image ISO et un fichier de description
162 d'une nouvelle saveur à partir de la distribution courante. Un fichier texte
163 optionnel permetde décrire les modifications à faire par rapport à la
164 distribution courante. Le format de chacune de ses lignes est
165 [code][tabulation][caractères]. Les valeurs possibles de code sont +,-,@,! et ?
166 pour ajouter un paquet, le retirer, décrire la saveur, ajouter un paquet non
167 libre, et afficher un message à l'écran.
168 </p>
169 <pre>
170 # tazlito gen-liveflavor nouvelle-saveur
171 # tazlito gen-liveflavor autre-saveur mes-modifications
172 # cat mes-modifications
173 @ Developper tools and some non-free packages
174 + slitaz-toolchain
175 + mercurial
176 ! skype
177 ! flash-plugin
178 </pre>
179 <h3><font color="#6c0023">extract-distro</font></h3>
180 <p>
181 La commande 'extract-iso' sert à extraire les fichiers d'une images ISO du
182 LiveCD, pour en reconstruire la structure (Racine du cdrom et du système).
183 Il est ensuite possible de faire les modifications ou ajouts souhaités, pour
184 reconstruire l'image ISO via les commandes 'gen-iso' ou 'gen-initiso'. Exemple
185 d'utilisation :
186 </p>
187 <pre>
188 # tazlito extract-distro slitaz-cooking.iso
189 </pre>
190 <h3><font color="#6c0023">gen-distro</font></h3>
191 <p>
192 La commande <em>Generate Distribution</em> permet de générer la structure du
193 système Live et une image ISO via une liste de paquets. Pour fonctionner, cette
194 commande a besoin d'une liste de paquets, d'un répertoire contenant tous les
195 paquets (.tazpkg) de la liste et d'un répertoire pour générer la distribution.
196 La liste de paquets peut être extraite d'une saveur par la commande get-flavor.
197 Si l'on utilise le Live-CD, les options --cdrom et --iso=<image-iso> permettent
198 de refabriquer les packets qui placent des fichiers dans /boot sans être obligé
199 de les télécharger et récupère les fichiers additionnels du Live-CD.
200 Le chemin vers les différents répertoires sont à configurer dans le fichier de
201 configuration utilisé et les paquets peuvent être téléchargés depuis les
202 miroirs de SliTaz ou générés par Tazwok. Pour générer une distro :
203 </p>
204 <pre>
205 # tazlito gen-distro
206 # tazlito gen-distro --cdrom
207 # tazlito gen-distro --iso=slitaz.iso
208 # tazlito gen-distro package-list
209 </pre>
210 <h3><font color="#6c0023">clean-distro</font></h3>
211 <p>
212 Supprime tous les fichiers générés ou extraits de la structure du LiveCD :
213 </p>
214 <pre>
215 # tazlito clean-distro
216 </pre>
217 <h3><font color="#6c0023">addhacker</font></h3>
218 <p>
219 La commande 'addhacker' permet d'ajouter l'utilisateur Hacker à la distribution,
220 cela permet d'avoir un compte utilisateur sans mot de passe. A noter que cette
221 commande effectue un changement de permissions sur tous les fichiers contenus
222 dans <code>/home/hacker</code> :
223 </p>
224 <pre>
225 # tazlito addhacker
226 </pre>
227 <h3><font color="#6c0023">check-distro</font></h3>
228 <p>
229 Cette commande permet simplement de vérifier si les fichiers non installés par
230 des paquets, sont bien présents dans la distro :
231 </p>
232 <pre>
233 # tazlito check-distro
234 </pre>
235 <h3><font color="#6c0023">burn-iso</font></h3>
236 <p>
237 Burn ISO va deviner le périphérique de cdrom, sa vitesse de gravure et lancer
238 l'outils Wodim pour graver une image ISO. L'image ISO par défaut est celle
239 du fichier de configuration courant, mais il est possible de spécifier une
240 autre image via la ligne de commande :
241 </p>
242 <pre>
243 # tazlito burn-iso
244 # tazlito burn-iso slitaz-hacked.iso
245 </pre>
247 <h2>MAINTENEUR</h2>
248 <p>
249 Christophe Lincoln &lt;pankso at slitaz.org&gt;
250 </p>
252 <!-- End content -->
253 </div>
254 </body>
255 </html>