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