slitaz-doc-wiki-data view pages/en/handbook/packages.txt @ rev 7
Add pages/en folder.
| author | Christopher Rogers <slaxemulator@gmail.com> |
|---|---|
| date | Sat Feb 26 12:17:18 2011 +0000 (2011-02-26) |
| parents | |
| children |
line source
1 ====== Packages ======
3 ===== Tazpkg - Package manager =====
5 SliTaz provides a tiny package manager which can easily install more software on the system. Tazpkg is a lightweight package manager for .tazpkg files. Completely written in SHell script, it works well with Busybox ash shell and bash. Tazpkg lets you list, install, remove, download, extract, pack, search, or get information about available or installed packages. You can also repack an installed package and automatically upgrade all installed packages. On SliTaz you can type tazpkg usage in a terminal to get a list of all the commands with a short description in English.
7 === List of packages ===
9 Tazpkg lets you list all installed packages, installed packages by category or it can display the list of available packages on the mirror. To display a single list of all installed packages on the system, just type:
11 <code> $ tazpkg list </code>
13 To display all categories or packages sorted by category, you must specify cat or category. Examples:
15 <code>
16 $ tazpkg list cat
17 $ tazpkg list base-system
18 </code>
20 Tazpkg can also generate a xHTML list (default: installed-packages.html) in the local directory of all installed packages on the system:
22 <code> $ tazpkg xhtml-list </code>
24 To get a single list of all available packages on the mirror you can use the command //list-mirror//. You can then examine the list in your favorite editor or use the Web site interface.
26 === Install packages ===
28 To install some new applications such as The Gimp, AbiWord, ePDFView, Perl or Python, you first need to recharge the list of available packages on the mirror and then install. If the package dependencies are not installed, Tazpkg will install them for you. For example, the installation of Gparted a GTK+ partition editor using GNU parted:
30 <code>
31 # tazpkg recharge
32 # tazpkg get-install gparted
33 </code>
35 == The 'get' Packages ==
37 There are a few packages that are prefixed with //get-//. These are not packages per-sé but contain only a script. This script provides binary software by:
39 * downloading the program
40 * creating a Tazpkg from it
41 * installing the generated Tazpkg
43 This means that the actual program is not contained within the //get// package, but that generated by it.
45 To manage this style of software:
46 * install the latest version using the //get// script in the //get// package;
47 * remove it by using tazpkg on the **generated** package.
49 <note tip>Please note that after downloading the //get-package//, you need to run the script that has the same name:
50 <code> # tazpkg get-install get-OpenOffice3
51 # get-OpenOffice3</code>
52 </note>
54 === Upgrade installed packages ===
56 To keep your system up-to-date and secure after recharging the packages list, you can automatically install all new versions and security updates from the mirror with the command:
58 <code> # tazpkg upgrade </code>
60 === Tazpkg Manual ===
62 The Tazpkg [[http://hg.slitaz.org/tazpkg/raw-file/tip/doc/tazpkg.en.html|Manual]] contains a lot more useful information.
64 ===== Tazwok & the wok =====
66 All SliTaz packages are built with a tool named Tazwok and a receipt found in the wok. The receipt provides all the necessary information to build a suitable package for Tazpkg including variables to give us the package name, source tarball format, download URL, etc. Given a receipt, the compile_rules function has all of the necessary commands to configure, make, and install the package in a specific directory. After compilation, Tazwok will execute the function genpkg_rules to pick up only the needed/wanted files and generate a pkg.tazpkg (cpio archive). On SliTaz you will find all installed package receipts in the directory ///var/lib/tazpkg///installed, feel free to examine them or even use one as an example.
68 Tazwok will search by default for a wok in ///home/slitaz/wok// and put generated packages in ///home/slitaz/packages//. These paths are set by a Tazwok configuration file which can be located in ///etc/tazwok.conf// or in the current directory, which is useful if you want to work with multiple woks. Now, if the slitaz-toolchain is installed, you can start to create and build a package which doesn't need many dependencies. Small example:
70 <code> # tazwok new-tree pkgname --interactive </code>
72 When a new package tree and receipt has been created in the wok, you can edit the receipt with your favorite editor (Geany provides nicely colored code), modify the rules, functions, add dependencies to the DEPENDS variable if needed and try a first cook:
74 <code> # tazwok cook pkgname </code>
76 Note that you can now browse the generated files, modify the cooking receipt again or just rebuild the package with tazwok genpkg. When you are happy with your work you can install the package with tazpkg install and then test the application or library.