website view fr/doc/manuals/tazwok.html @ rev 541
tazwok*: add hooks
| author | Pascal Bellard <pascal.bellard@slitaz.org> |
|---|---|
| date | Thu Sep 17 11:29:31 2009 +0200 (2009-09-17) |
| parents | c024635ea9df |
| children |
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>Tazwok Manual</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="2008-02-06 15:05:00" />
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">Tazwok Manual</font></h1>
27 </div>
28 <hr />
29 <!-- Start content -->
30 <div id="content">
32 <h2>NOM</h2>
33 <p>
34 Tazwok - SliTaz sources and packages cooker.
35 </p>
37 <h2>SYNTAXE</h2>
38 <pre>
39 tazwok [command] [package|list|category|dir] [--option]
40 </pre>
42 <h2>DESCRIPTION</h2>
43 <p>
44 Tazwok est un outils en ligne de commande permettant de configurer et de
45 compiler un paquet depuis les sources. Tazwok permet aussi de créer des
46 paquets prêts à être utilisé par Tazpkg, le gestionnaire de paquets créer
47 pour SliTaz. Pour fonctionner Tazwok utilise un fichier contenant la recette
48 et toutes les informations nécessaires à la construction du paquet, cette
49 recette est aussi utilisée par Tazpkg et se compose de différentes variables
50 et fonctions. Tazwok utilise un fichier de configuration (/etc/tazwok.conf)
51 pour connaître le chemin vers le wok, les paquets sources et les paquets
52 (.tazpkg) générés. Il est aussi capable de générer une liste paquets avec
53 leurs sommes md5, des créer un nouveau paquet de manière interactive, de faire
54 une recherche, de nettoyer les fichiers générés ou encore de cuire plusieurs
55 paquets en une seule fois (Voir les commandes disponibles).
56 </p>
57 <p>
58 Tazwok est écript en script shell depuis rien (from scratch), compatible Bash,
59 et fonctionnant avec Ash du projet Busybox. Tazwok est distribué sous license
60 libre GNU gpl v3. Les recettes avec leures commades sont basée sur le livre
61 de cuisine de SliTaz, le Cookbook fournit aussi de la documentation au sujet
62 de Tazwok et du développement de SliTaz.
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 la liste des commandes diponibles avec une petite
70 description en English :
71 </p>
72 <pre>
73 # tazwok usage
74 </pre>
75 <a name="stats"></a>
76 <h3><font color="#6c0023">stats</font></h3>
77 <p>
78 Stats affiche les informations contenue dans le fichier de configuration et
79 le nombre de paquets disponibles dans le wok :
80 </p>
81 <pre>
82 # tazwok stats
83 </pre>
84 <a name="list"></a>
85 <h3><font color="#6c0023">list</font></h3>
86 <p>
87 La commande 'list' permet de lister l'ensemble des paquets contenus dans le
88 wok ou de lister les catégories par défauts (vous pouvez créer la votre). Elle
89 permet aussi de lister les paquets d'une catégorie :
90 </p>
91 <pre>
92 # tazwok list
93 # tazwok list category
94 </pre>
95 <a name="info"></a>
96 <h3><font color="#6c0023">info</font></h3>
97 <p>
98 Cette commande donne des informations sur le paquet, nom, version, etc. Info
99 ce base sur la recette du paquet pour connaître les informations, c'est les
100 mêmes infos affichées par Tazpkg et les paquets installés :
101 </p>
102 <pre>
103 # tazwok info package
104 </pre>
105 <a name="check-log"></a>
106 <h3><font color="#6c0023">check-log</font></h3>
107 <p>
108 Lors de la compilation et génération du paquet binaire, Tazwok génére quelques
109 messages de log stockés dans un fichier 'process.log'. Pour les afficher :
110 </p>
111 <pre>
112 # tazwok check-log package
113 </pre>
114 <a name="search"></a>
115 <h3><font color="#6c0023">search</font></h3>
116 <p>
117 Search permet de faire une recherche de paquet dans le wok. Vous pouvez
118 spécifier un terme ou un nom de paquet :
119 </p>
120 <pre>
121 # tazwok search name
122 </pre>
123 <a name="compile"></a>
124 <h3><font color="#6c0023">compile</font></h3>
125 <p>
126 Compile va compiler. Cette commande utilise les régles de compilation
127 (compile_rules) spécifiées dans la recette du paquet en question, pour
128 compiler les sources. A noter qu'il n'y a pas forcement de régles de
129 compilation, des paquets sont directement généré par 'genpkg' et que la
130 commande 'cook' permet de compiler les sources et générer le paquet binaire
131 en une seule fois. Exemple :
132 </p>
133 <pre>
134 # tazwok compile package
135 </pre>
136 <a name="genpkg"></a>
137 <h3><font color="#6c0023">genpkg</font></h3>
138 <p>
139 Genpkg pour <em>Generate package</em>, va générer le paquet (.tazpkg) en
140 utilisant la fonction 'genpkg_rules' trouvée dans sa recette et compresser
141 les fichiers. Une fois le paquet généré, il est stocké dans le repositoire
142 des paquetss spécifié dans le fichier de configuration ('tazwok stats' pour
143 afficher la configuration courante). Le paquet peut ensuite facilement
144 s'installer via Tazpkg ou être utilisé par Tazlito pour générer une
145 distribution LiveCD automatiquement. A noter que les fichiers standards tels
146 que les locales, le pixmap ou le fichier.desktop sont automatiquement copiés
147 dans $fs/usr/share, si les chemins sont standards ou si le fichier existe dans
148 /stuff. Utilisation de 'genpkg' :
149 </p>
150 <pre>
151 # tazwok genpkg package
152 </pre>
153 <a name="cook"></a>
154 <h3><font color="#6c0023">cook</font></h3>
155 <p>
156 Cook va simplement compiler et empaqueter les paquet en une seule fois :
157 </p>
158 <pre>
159 # tazwok cook package
160 </pre>
161 <a name="cook-list"></a>
162 <h3><font color="#6c0023">cook-list</font></h3>
163 <p>
164 Cette commade va lancer 'tazwok cook' sur tous les paquets contenus dans la
165 liste spécifiées en argument. Cook-list est utilisés par exemple, pour cuire
166 le système de base, les applications de base, le système X, etc. Avant de
167 lancer cette commande avec un grand nombre de paquets, il est conseillé de
168 cuire une fois le système de base (base-system) sans la glibc. Sur SliTaz,
169 vous trouverez des exemples de liste de cuisson (cooklist) dans le répertoire
170 des exemples /usr/share/examples/tazwok/cooklists :
171 </p>
172 <pre>
173 # tazwok cook-list packages.cooklist
174 </pre>
175 <a name="clean"></a>
176 <h3><font color="#6c0023">clean</font></h3>
177 <p>
178 Clean permet simplement de supprimer tous les fichiers générés par la
179 compilation et l'empaquetage, pour recommencer à cuire (cook) :
180 </p>
181 <pre>
182 # tazwok clean package
183 </pre>
184 <a name="new-tree"></a>
185 <h3><font color="#6c0023">new-tree</font></h3>
186 <p>
187 La commande 'new-tree' permet de créer un nouveau paquet dans le wok et
188 peut s'utiliser de manière interactive. New-tree va créer le répertoire du
189 paquet et une recette modèle (receipt), cette recette peur être éditée avec
190 votre éditeur de texte préféré et peut se configurer via l'option
191 '--interactive'. Pour vous aider vous pouvez regarder des recettes existantes
192 et lire la documentation du Cookbook. Exemple d'utilisation :
193 </p>
194 <pre>
195 # tazwok new-tree package
196 # tazwok new-tree package --interactive
197 </pre>
198 <a name="gen-list"></a>
199 <h3><font color="#6c0023">gen-list</font></h3>
200 <p>
201 La commande 'gen-list' permet de générer une liste de paquets (packages.list),
202 leurs sommes md5 (packages.md5) et en option une liste de paquet contenant plus
203 d'informations (packages.txt). Les simples listes sont crées en se basant sur
204 les paquets contenus dans un répertoire. La liste au format texte est construite
205 avec les recettes contenues dans un wok. Le répertoire des paquets par défaut
206 est celui spécifié dans le fichier de configuration, vous avez aussi la
207 possibilité de spécifier le répertoire à utiliser sur la ligne de commande.
208 Utilisation de la commande 'gen-list' :
209 </p>
210 <pre>
211 # tazwok gen-list
212 # tazwok gen-list --text
213 # tazwok gen-list /path/to/repository
214 </pre>
215 <a name="gen-clean-wok"></a>
216 <h3><font color="#6c0023">gen-clean-wok et clean-wok</font></h3>
217 <p>
218 La commande 'gen-clean-wok' permet de générer un wok propre depuis le wok
219 courant. Cette commande est utile pour sauvegarder un version du wok ou copier
220 un wok pour tester avec un autre. Quand à la commande 'clean-wok', elle va
221 nettoyer tous les paquets du wok courant et supprimer tous les fichiers
222 générés. Pour récupérer un wok propre ou nettoyer le wok actuel :
223 </p>
224 <pre>
225 # tazwok gen-clean-wok path/to/new-wok
226 # tazwok clean-wok
227 </pre>
228 <a name="remove"></a>
229 <h3><font color="#6c0023">remove</font></h3>
230 <p>
231 Supprime le paquet spécifié du wok, avec tous les fichiers, stuff et recette
232 y compris :
233 </p>
234 <pre>
235 # tazwok remove package
236 </pre>
237 <a name="build-depends"></a>
238 <h3><font color="#6c0023">build-depends</font></h3>
239 <p>
240 Build-depends génère une liste de paquets nécessaires pour compiler le wok :
241 </p>
242 <pre>
243 # tazwok build-depends
244 </pre>
245 <a name="compare"></a>
246 <h3><font color="#6c0023">cmp|compare</font></h3>
247 <p>
248 Compare le wok avec les paquets déjà cuits et génère un rapport.
249 Les paquets obsolètes peuvent être effacés avec l'option --remove.
250 Les paquets à compiler peuvent l'être avec l'option --cook.
251 </p>
252 <pre>
253 # tazwok compare
254 # tazwok compare --remove
255 # tazwok compare --cook
256 </pre>
257 <a name="check"></a>
258 <h3><font color="#6c0023">check</font></h3>
259 <p>
260 Recherche les erreurs courantes dans les receipts :
261 </p>
262 <pre>
263 # tazwok check
264 </pre>
266 <h2>MAINTENEUR</h2>
267 <p>
268 Christophe Lincoln <pankso at slitaz.org>
269 </p>
271 <!-- End content -->
272 </div>
273 </body>
274 </html>