NAME
Tazwok - SliTaz sources and packages cooker.
SYNTAX
tazwok [command] [package|list|category|dir] [--option]
DESCRIPTION
Tazwok is a command line tool to configure and compile a package from source. Tazwok can also create packages ready to be used by Tazpkg, the SliTaz package manager. To work, Tazwok uses a directory containing the receipt and the necessary information (stuff) for the construction of the package. This receipt is also used by Tazpkg and consists of different variables and functions. Tazwok uses a configuration file (/etc/tazwok.conf) to find the path to the wok, the package sources, and any generated .tazpkg packages. Tazwok can also generate a list of packages with their md5, create packages interactively, search for packages in the wok, clean generated files and even cook several packages at once (See available commands).
Tazwok is entirely built from scratch using SHell script, compatible with Bash, it runs under Ash - part of the Busybox project. Tazwok is distributed under the free GNU license GPL V3. The SliTaz Cookbook also provides documentation about Tazwok and the package receipts.
COMMANDS
usage
Usage displays a summary of available commands with a short description in English:
# tazwok usage
stats
Stats displays information contained in the configuration file and the number of packages available in the wok:
# tazwok stats
list
List allows you to list all the packages contained in the wok or the default categories (you can create your own). It can also list packages by category:
# tazwok list # tazwok list category
info
This command provides information on the package - name, version, etc. Info on the basic package receipt is the same as displayed by Tazpkg and the installed packages:
# tazwok info package
check-log
When compiling a binary source, Tazwok generates a few messages stored in the file 'process.log'. To view:
# tazwok check-log package
search
Search allows you to search for packages in the wok. You can specify a term or package name:
# tazwok search name
compile
This command uses the compilation rules (compile_rules) specified in the receipt for the package in question to compile the sources. Note compilation rules are not always necessary - packages generated by 'genpkg' and 'cook' can also compile sources and generate the binary package. Example:
# tazwok compile package
genpkg
Genpkg will generate the .tazpkg package using the 'genpkg_rules' found in the receipt. Once the package is generated, it's stored in the repository of packages specified in the configuration file ('tazwok stats' to view). The package can be used by Tazpkg or Tazlito to generate a LiveCD distribution. Note that the standard files such as local, pixmap or name.desktop are automatically copied to $fs/usr/share, provided the paths are standard or if the file exists in /stuff. Example using 'genpkg':
# tazwok genpkg package
cook
Cook will simply compile and generate the package:
# tazwok cook package
cook-list
This command will launch 'tazwok cook' on all the packages contained in the list file specified in the argument. Cook-list is used for example, to cook the base system (base-system) without glibc. On SliTaz, you will find examples of cooking lists in the directory /usr/share/examples/tazwok.cooklists:
# tazwok cook-list packages.cooklist
clean
Clean can simply delete all files generated by compiling and packaging:
# tazwok clean package
new-tree
The 'new-tree' command can create a new package in the wok and can be used interactively. It will create a directory of the package and a receipt that can then be edited with your favorite text editor. The receipt can also be configured using the '--interactive' option. For help you can look at existing receipts or read the documentation in the Cookbook. Example:
# tazwok new-tree package # tazwok new-tree package --interactive
gen-list
The 'gen-list' command can generate a list of packages (packages.list), their md5 (packages.md5) and a list of options containing information (packages.txt). The lists are created on the basis of packages contained in a directory. The list in text format is built using a receipt contained in a wok. The default packages directory is the one specified in the configuration file, you can also specify the directory on the command line. Examples:
# tazwok gen-list # tazwok gen-list --text # tazwok gen-list /path/to/repository
gen-clean-wok and clean-wok
The 'gen-clean-wok' command can create a new wok, this is useful to save a version of the wok, or create a new wok to test with another. Running 'clean-wok' will clean all packages in the current wok and delete any generated files. To generate a clean wok or clean the current wok:
# tazwok gen-clean-wok path/to/new-wok # tazwok clean-wok
remove
Removes the package specified from the wok, including the receipt, stuff, all files, etc:
# tazwok remove package
build-depends
Build-depends generates a list of packages to build a wok:
# tazwok build-depends
cmp|compare
Compares the wok and the cooked packages and generates a report. Obsolete packages can be deleted with the --remove option. The --cook option compiles the packages. Examples:
# tazwok compare # tazwok compare --remove # tazwok compare --cook
check
Checks the receipts for common errors:
# tazwok check
MAINTAINER
Christophe Lincoln <pankso at slitaz.org>