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