website view en/doc/handbook/packages.html @ rev 135
en: Add e17 page to Hdbk and edit
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Tue Aug 12 20:36:31 2008 +0000 (2008-08-12) |
| parents | f7dbfd69ab3a |
| children | 658f2885e2f2 |
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <head>
5 <title>SliTaz Handbook (en) - Packages</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="slitaz packages tazpkg install new applications upgrade list extract" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2008-07-18 05:30:00" />
10 <meta name="publisher" content="www.slitaz.org" />
11 <meta name="author" content="Christophe Lincoln"/>
12 <link rel="shortcut icon" href="favicon.ico" />
13 <link rel="stylesheet" type="text/css" href="book.css" />
14 </head>
15 <body bgcolor="#ffffff">
17 <!-- Header and quick navigation -->
18 <div id="header">
19 <div align="right" id="quicknav">
20 <a name="top"></a>
21 <a href="network-config.html">Network configuration</a> |
22 <a href="index.html">Table of contents</a>
23 </div>
24 <h1><font color="#3E1220">SliTaz Handbook (en)</font></h1>
25 </div>
27 <!-- Content. -->
28 <div id="content">
29 <div class="content-right"></div>
31 <h2><font color="#DF8F06">Packages</font></h2>
33 <ul>
34 <li><a href="#tazpkg">Tazpkg</a> - Package manager.</li>
35 <li><a href="#list">List of packages</a> - Display or generate a list
36 of packages.</li>
37 <li><a href="#install">Install packages</a> - Get and install new
38 packages.</li>
39 <li><a href="#upgrade">Upgrade</a> - Keep your system secure.</li>
40 <li><a href="#tazwok">Tazwok & the wok</a> - Package format and build
41 tools.</li>
42 </ul>
44 <a name="tazpkg"></a>
45 <h3>Tazpkg - Package manager</h3>
46 <p>
47 SliTaz provides a tiny package manager which can easily install more software
48 on the system. Tazpkg is a lightweight package manager for <code>.tazpkg</code>
49 files, completely written in SHell script. It works well with Busybox ash shell and
50 bash. Tazpkg lets you list, install, remove, download, extract, pack, search,
51 or get information about available or installed packages. You can also repack
52 an installed package and automatically upgrade all installed packages. On SliTaz
53 you can type <code>tazpkg usage</code> in a terminal to get a list of all the
54 commands with a short description in English.
55 You can also read the <a href="../manuals/tazpkg.en.html">manual</a>.
56 </p>
58 <a name="list"></a>
59 <h3>List of packages</h3>
60 <p>
61 Tazpkg lets you list all installed packages, installed
62 packages by category or it can display the list of available packages on the mirror.
63 To display a single list of all installed packages on the system just type:
64 </p>
65 <pre>
66 $ tazpkg list
67 </pre>
68 <p>
69 To display all categories or packages sorted by category, you must specifiy
70 <code>cat</code> or <code>category</code>.
71 Examples:
72 </p>
73 <pre>
74 $ tazpkg list cat
75 $ tazpkg list base-system
76 </pre>
77 <p>
78 Tazpkg can also generate a nice xHTML list (default: <code>installed-packages.html</code>) in the local directory of all installed packages on the system:
79 </p>
80 <pre>
81 $ tazpkg xhtml-list
82 </pre>
83 <p>
84 To get a single list of all available packages on the mirror you can use
85 the command <code>list-mirror</code>. You can then examine the list in your favorite editor
86 or use the Web site interface.
87 </p>
89 <a name="install"></a>
90 <h3>Install packages</h3>
91 <p>
92 To install some new applications such as The Gimp, AbiWord, ePDFView, Perl or
93 Python, you first need to recharge the list of available packages on the
94 mirror and then install. If the package dependencies are not installed
95 Tazpkg will install them for you. For example, the installation of Gparted a
96 GTK+ partition editor using GNU parted:
97 </p>
98 <pre>
99 # tazpkg recharge
100 # tazpkg get-install gparted
101 </pre>
103 <a name="upgrade"></a>
104 <h3>Upgrade installed packages</h3>
105 <p>
106 To keep your system up-to-date and secure after recharging the packages list,
107 you can automatically install all new versions and security updates from the
108 mirror with the command:
109 </p>
110 <pre>
111 # tazpkg upgrade
112 </pre>
114 <a name="manual"></a>
115 <h4>Tazpkg Manual</h4>
116 <p>
117 The Tazpkg <a href="../manuals/tazpkg.en.html">Manual</a> contains a lot more useful information.
118 </p>
120 <a name="tazwok"></a>
121 <h3>Tazwok & the wok</h3>
122 <p>
123 All SliTaz packages are built with a tool named Tazwok and a receipt found
124 in the wok. The receipt provides all the necessary information to build a suitable
125 package for Tazpkg including variables to give us the package name, source tarball format,
126 download URL, etc. Given a receipt the <code>compile_rules</code> function has all of
127 the necessary commands to configure, make, and install the package in a specific directory.
128 After compilation, Tazwok will execute the function <code>genpkg_rules</code>
129 to pick up only the needed/wanted files and generate a pkg.tazpkg (cpio archive).
130 On SliTaz you will find all installed package receipts in the directory
131 <code>/var/lib/tazpkg/installed</code>, feel free to examine them or even use one as an
132 example.
133 </p>
134 <p>
135 Tazwok will search by default for a wok in <code>/home/slitaz/wok</code> and
136 put generated packages in <code>/home/slitaz/packages</code>. These paths are
137 set by a Tazwok configuration file which can be located in
138 <code>/etc/tazwok.conf</code> or in the current directory, which is useful if you
139 want to work with multiple woks. Now, if the <code>slitaz-toolchain</code> is
140 installed, you can start to create and build a package which doesn't need many
141 dependencies. Small example:
142 </p>
143 <pre>
144 # tazwok new-tree pkgname --interactive
145 </pre>
146 <p>
147 When a new package tree and receipt has been created in the wok, you can edit the
148 receipt with your favorite editor (Geany provides nicely colored code), modify
149 the rules functions, add dependencies to the <code>DEPENDS</code> variable
150 if needed and try a first cook:
151 </p>
152 <pre>
153 # tazwok cook pkgname
154 </pre>
155 <p>
156 Note that you can now browse the generated files, modify the cooking receipt again or
157 just rebuild the package with <code>tazwok genpkg</code>. When you are happy with
158 your work you can install the package with <code>tazpkg install</code> and
159 test the application or library.
160 </p>
162 <!-- End of content -->
163 </div>
165 <!-- Footer. -->
166 <div id="footer">
167 <div class="footer-right"></div>
168 <a href="#top">Top of the page</a> |
169 <a href="index.html">Table of contents</a>
170 </div>
172 <div id="copy">
173 Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
174 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
175 Documentation is under
176 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
177 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
178 </div>
180 </body>
181 </html>