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