NOM
Tazwok - SliTaz sources and packages cooker.
SYNTAXE
tazwok [command] [package|list|category|dir] [--option]
DESCRIPTION
Tazwok est un outils en ligne de commande permettant de configurer et de compiler un paquet depuis les sources. Tazwok permet aussi de créer des paquets prêts à être utilisé par Tazpkg, le gestionnaire de paquets créer pour SliTaz. Pour fonctionner Tazwok utilise un fichier contenant la recette et toutes les informations nécessaires à la construction du paquet, cette recette est aussi utilisée par Tazpkg et se compose de différentes variables et fonctions. Tazwok utilise un fichier de configuration (/etc/tazwok.conf) pour connaître le chemin vers le wok, les paquets sources et les paquets (.tazpkg) générés. Il est aussi capable de générer une liste paquets avec leurs sommes md5, des créer un nouveau paquet de manière interactive, de faire une recherche, de nettoyer les fichiers générés ou encore de cuire plusieurs paquets en une seule fois (Voir les commandes disponibles).
Tazwok est écript en script shell depuis rien (from scratch), compatible Bash, et fonctionnant avec Ash du projet Busybox. Tazwok est distribué sous license libre GNU gpl v3. Les recettes avec leures commades sont basée sur le livre de cuisine de SliTaz, le Cookbook fournit aussi de la documentation au sujet de Tazwok et du dévellopement de SliTaz.
COMMANDES
usage
La commande 'usage' affiche la liste des commandes diponibles avec une petite description en English :
# tazwok usage
stats
Stats affiche les informations contenue dans le fichier de configuration et le nombre de paquets disponibles dans le wok :
# tazwok stats
list
La commande 'list' permet de lister l'ensemble des paquets contenus dans le wok ou de lister les catégories par défauts (vous pouvez créer la votre). Elle permet aussi de lister les paquets d'une catégorie :
# tazwok list # tazwok list category
info
Cette commande donne des informations sur le paquet, nom, version, etc. Info ce base sur la recette du paquet pour connaître les informations, c'est les mêmes infos affichées par Tazpkg et les paquets installés :
# tazwok info package
check-log
Lors de la compilation et génération du paquet binaire, Tazwok génére quelques messages de log stockés dans un fichier 'process.log'. Pour les afficher :
# tazwok check-log package
search
Search permet de faire une recherche de paquet dans le wok. Vous pouvez spécifier un terme ou un nom de paquet :
# tazwok search name
compile
Compile va compiler. Cette commande utilise les régles de compilation (compile_rules) spécifiées dans la recette du paquet en question, pour compiler les sources. A noter qu'il n'y a pas forcement de régles de compilation, des paquets sont directement généré par 'genpkg' et que la commande 'cook' permet de compiler les sources et générer le paquet binaire en une seule fois. Exemple :
# tazwok compile package
genpkg
Genpkg pour Generate package, va générer le paquet (.tazpkg) en utilisant la fonction 'genpkg_rules' trouvée dans sa recette et compresser les fichiers. Une fois le paquet généré, il est stocké dans le repositoire des paquetss spécifié dans le fichier de configuration ('tazwok stats' pour afficher la configuration courante). Le paquet peut ensuite facilement s'installer via Tazpkg ou être utilisé par Tazlito pour générer une distribution LiveCD automatiquement. Utilisation de 'genpkg' :
# tazwok genpkg package
cook
Cook va simplement compiler et empaqueter les paquet en une seule fois :
# tazwok cook package
cook-list
Cette commade va lancer 'tazwok cook' sur tous les paquets contenus dans la liste spécifiées en argument. Cook-list est utilisés par exemple, pour cuire le système de base, les applications de base, le système X, etc. Avant de lancer cette commande avec un grand nombre de paquets, il est conseillé de cuire une fois le système de base (base-system) sans la glibc. Sur SliTaz, vous trouverez des exemples de liste de cuisson (cooklist) dans le répertoire des exemples /usr/share/examples/tazwok/cooklists :
# tazwok cook-list packages.cooklist
clean
Clean permet simplement de supprimer tous les fichiers générés par la compilation et l'empaquetage, pour recommencer à cuire (cook) :
# tazwok clean package
new-tree
La commande 'new-tree' permet de créer un nouveau paquet dans le wok et peut s'utiliser de manière interactive. New-tree va créer le répertoire du paquet et une recette modèle (receipt), cette recette peur être éditée avec votre éditeur de texte préféré et peut se configurer via l'option '--interactive'. Pour vous aider vous pouvez regarder des recettes existantes et lire la documentation du Cookbook. Exemple d'utilisation :
# tazwok new-tree package # tazwok new-tree package --interactive
gen-list
La commande 'gen-list' permet de générer une liste de paquets (packages.list) et leurs sommes md5 (packages.md5), en se basant sur les paquets contenus dans un répertoire. Le répertoire des paquets par défaut est celui spécifié dans le fichier de configuration, vous avez aussi la possibilité de spécifier le répertoire à utiliser sur la ligne de commande :
# tazwok gen-list # tazwok gen-list /path/to/packages-repository
gen-clean-wok et clean-wok
La commande 'gen-clean-wok' permet de générer un wok propre depuis le wok courant. Cette commande est utile pour sauvegarder un version du wok ou copier un wok pour tester avec un autre. Quand à la commande 'clean-wok', elle va nettoyer tous les paquets du wok courant et supprimer tous les fichiers générés. Pour récupérer un wok propre ou nettoyer le wok actuel :
# tazwok gen-clean-wok path/to/new-wok # tazwok clean-wok
remove
Supprime le paquet spécifié du wok, avec tous les fichiers, stuff et recette y compris :
# tazwok remove package
MAINTENEUR
Christophe Lincoln <pankso at slitaz.org>