Tazwok Manual

+ +

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> +

+ + +