website annotate fr/doc/manuals/tazwok.html @ rev 605

fr: announce 3.0 (index + rss)
author Christophe Lincoln <pankso@slitaz.org>
date Sun Mar 28 17:39:40 2010 +0200 (2010-03-28)
parents c024635ea9df
children
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 &lt;pankso at slitaz.org&gt;
pankso@371 269 </p>
pankso@371 270
pankso@371 271 <!-- End content -->
pankso@371 272 </div>
pankso@371 273 </body>
pankso@371 274 </html>