website view en/doc/handbook/packages.html @ rev 59
Minor typos
| author | hacker@slitaz |
|---|---|
| date | Thu May 22 23:10:07 2008 +0000 (2008-05-22) |
| parents | 86c53b7a99c4 |
| children | b34d650ff817 |
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-02-26 18: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="system-admin.html">System administration</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 </p>
57 <a name="list"></a>
58 <h3>List of packages</h3>
59 <p>
60 Tazpkg lets you list all installed packages, installed
61 packages by category or it can display the list of available packages on the mirror.
62 To display a single list of all installed packages on the system just type:
63 </p>
64 <pre>
65 $ tazpkg list
66 </pre>
67 <p>
68 To display all categories or packages sorted by category, you must specifiy
69 <code>cat</code> or <code>category</code>.
70 Examples:
71 </p>
72 <pre>
73 $ tazpkg list cat
74 $ tazpkg list base-system
75 </pre>
76 <p>
77 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:
78 </p>
79 <pre>
80 $ tazpkg xhtml-list
81 </pre>
82 <p>
83 To get a single list of all available packages on the mirror you can use
84 the command <code>list-mirror</code>, you can then examine the list in your favorite editor
85 or use the Web site interface.
86 </p>
88 <a name="install"></a>
89 <h3>Install packages</h3>
90 <p>
91 To install some new applications such as The Gimp, AbiWord, ePDFView, Perl or
92 Python, you first need to recharge the list of available packages on the
93 mirror and then install. If the package dependencies are not installed
94 Tazpkg will install them for you. For example, the installation of Gparted a
95 GTK+ partition editor using GNU parted:
96 </p>
97 <pre>
98 # tazpkg recharge
99 # tazpkg get-install gparted
100 </pre>
102 <a name="upgrade"></a>
103 <h3>Upgrade installed packages</h3>
104 <p>
105 To keep your system up-to-date and secure after recharging the packages list,
106 you can automatically install all new versions and security updates from the
107 mirror with the command:
108 </p>
109 <pre>
110 # tazpkg upgrade
111 </pre>
113 <a name="tazwok"></a>
114 <h3>Tazwok & the wok</h3>
115 <p>
116 All SliTaz packages are built with a tool named Tazwok and a receipt found
117 in the wok. The receipt provides all the necessary information to build a suitable
118 package for Tazpkg, variables to give us the package name, source tarball format,
119 download URL, etc. With a receipt then the <code>compile_rules</code> function has got all
120 the necessary commands to configure, make and install the package in a specific directory.
121 After the compilation, Tazwok will execute the function <code>genpkg_rules</code>
122 to pick up only the needed/wanted files and generate a pkg.tazpkg (cpio archive).
123 On SliTaz you will find all installed package receipts in the directory
124 <code>/var/lib/tazpkg/installed</code>, feel free to examine them or even use one as an
125 example.
126 </p>
127 <p>
128 Tazwok will search by default for a wok in <code>/home/slitaz/wok</code> and
129 put generated packages in <code>/home/slitaz/packages</code>, these paths are
130 set by a Tazwok configuration file which can be located in
131 <code>/etc/tazwok.conf</code> or in the current directory, this is useful if you
132 want to work with multiple woks. Now, if the <code>slitaz-toolchain</code> is
133 installed, you can start to create and build a package which doesn't need many
134 dependencies. Small example:
135 </p>
136 <pre>
137 # tazwok new-tree pkgname --interactive
138 </pre>
139 <p>
140 When a new package tree and receipt has been created in the wok, you can edit the
141 receipt with your favorite editor (Geany provides nicely colored code), modify
142 the rules functions, add dependencies to the <code>DEPENDS</code> variable
143 if needed and try a first cook:
144 </p>
145 <pre>
146 # tazwok cook pkgname
147 </pre>
148 <p>
149 Note that you can now browse the generated files, modify the cooking receipt again or
150 just rebuild the package with <code>tazwok genpkg</code>. When you are happy with
151 your work you can install the package with <code>tazpkg install</code> and
152 test the application or library.
153 </p>
155 <!-- End of content -->
156 </div>
158 <!-- Footer. -->
159 <div id="footer">
160 <div class="footer-right"></div>
161 <a href="#top">Top of the page</a> |
162 <a href="index.html">Table of contents</a>
163 </div>
165 <div id="copy">
166 Copyright © 2008 <a href="http://www.slitaz.org/en/">SliTaz</a> -
167 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>;<br />
168 Documentation is under
169 <a href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>
170 and code is <a href="http://validator.w3.org/">valid xHTML 1.0</a>.
171 </div>
173 </body>
174 </html>