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