website view en/doc/manuals/tazpkg.en.html @ rev 359
fr: Remove stable Handbook (Archived + 2 book is a lot of work)
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Fri Apr 10 12:02:57 2009 +0200 (2009-04-10) |
| parents | e66b0f865f65 |
| children | 130803f2f1a5 |
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>Tazpkg Manual</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2008-07-18 19:45:00" />
10 <style type="text/css"><!--
11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
12 #header { background: #f0ba08; color: black; height: 50px;
13 border-top: 1px solid black; border-bottom: 1px solid black; }
14 #content { margin: 0px 50px 26px 50px; }
15 h1 { margin: 14px 0px 0px 16px; }
16 li { line-height: 1.4em; }
17 pre { padding: 5px; color: black; background: #e1e0b0; }
18 pre.script { padding: 10px; color: black; background: #e8e8e8;
19 border: 1px inset #333333; }
20 code { font-size: 100%; color: #669900; background: transparent; }
21 hr { color: white; background: white; height: 1px; border: 0; }
22 --></style>
23 </head>
24 <body bgcolor="#ffffff">
25 <div id="header">
26 <h1><font color="#3e1220">Tazpkg Manual</font></h1>
27 </div>
28 <hr />
29 <!-- Start content -->
30 <div id="content">
32 <h2>NAME</h2>
33 <p>
34 Tazpkg - Tiny autonomous zone package manager
35 </p>
37 <h2>SYNTAX</h2>
38 <pre>
39 tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt]
40 </pre>
42 <h2>DESCRIPTION</h2>
43 <p>
44 Tazpkg is an ultralightweight (~ 35KB) package manager to
45 install, list, download, update or remove precompiled packages
46 on a GNU/Linux system. Tazpkg offers commands for searching
47 and creating packages and was created independently.
48 The format of the packages using the *.tazpkg extension is a
49 cpio archive containing a filesystem compressed with gzip,
50 a receipt and an optional description. Tazpkg also manages
51 dependencies based on package receipts. Each receipt contains
52 all the information about a package and can also include
53 pre and post installation functions. The same receipt is
54 used by Tazwok to compile sources and generate a .tazpkg
55 package.
56 </p>
57 <p>
58 Tazpkg is entirely built from scratch using SHell script,
59 compatible with Bash, it runs under Ash - part of the Busybox
60 project. Tazpkg is distributed under the free GNU license GPL V3.
61 </p>
63 <h2>COMMANDS</h2>
64 <h3><font color="#6c0023">list</font></h3>
65 <p>
66 List packages installed on the system. This command displays
67 a column list of all installed packages, It also allows you to list the
68 categories, packages based on category and packages placed on hold.
69 You can also use the 'search' command for a list based
70 on a term or package name:
71 </p>
72 <pre>
73 # tazpkg list
74 # tazpkg list cat|categories
75 # tazpkg list blocked
76 </pre>
77 <h3><font color="#6c0023">xhtml-list</font></h3>
78 <p>
79 The 'xhtml-list' command can create a XHTML list
80 of all the packages installed on the system which can be read
81 with your preferred Web browser. It can be run as a normal
82 user and creates a page 'installed-packages.html' in
83 your current directory. Note that you can change the name of the
84 generated list via the command line:
85 </p>
86 <pre>
87 # tazpkg xhtml-list
88 # tazpkg xhtml-list list-name.html
89 </pre>
90 <h3><font color="#6c0023">list-mirror</font></h3>
91 <p>
92 List packages available on the mirror. This command will
93 display the 'packages.list' file recharged from the mirror.
94 If this doesn't exist, you will be asked to launch
95 'tazpkg recharge' as administrator (root) for a list of
96 available packages . The --diff option is used to display
97 the differences between the last and current list of packages:
98 </p>
99 <pre>
100 # tazpkg list-mirror
101 # tazpkg list-mirror --diff
102 </pre>
103 <h3><font color="#6c0023">info</font></h3>
104 <p>
105 Display any information available in the receipt for the
106 package in question - its version, category, maintainer,
107 Web site and any dependencies (see also Tazwok for more
108 information on receipts):
109 </p>
110 <pre>
111 # tazpkg info busybox
112 </pre>
113 <h3><font color="#6c0023">desc</font></h3>
114 <p>
115 Description of the package (if it exists). This command
116 displays the 'description.txt' file of each package (a simple
117 text file, justified to 80 characters to fit in a standard terminal):
118 </p>
119 <pre>
120 # tazpkg desc busybox
121 </pre>
122 <h3><font color="#6c0023">list-config</font></h3>
123 <p>
124 Lists the system configuration files. The --box option displays
125 in table format:
126 </p>
127 <pre> # tazpkg list-config
128 # tazpkg list-config --box
129 </pre>
130 <h3><font color="#6c0023">list-files</font></h3>
131 <p>
132 List all files installed with a package. This command will
133 simply read and display the 'files.list' of each package which is
134 automatically generated when the package is created and is
135 also used to remove files when uninstalling a package.
136 To list the files installed with the package bc:
137 </p>
138 <pre>
139 # tazpkg list-files bc
140 </pre>
141 <h3><font color="#6c0023">search</font></h3>
142 <p>
143 Search for packages by owner or package name. This command
144 will search for the term wanted in the installed packages and the
145 list of available packages on the mirror. To obtain the
146 latest list of installable packages on the mirror, just
147 run 'tazpkg recharge' before conducting a search:
148 </p>
149 <pre>
150 # tazpkg search gcc
151 </pre>
152 <h3><font color="#6c0023">search-file</font></h3>
153 <p>
154 The 'search-file' command allows you to search for a file
155 among the files installed by the packages. This command is very
156 useful to find the full path to a file and determine if
157 a file is present on the system. Example:
158 </p>
159 <pre>
160 $ tazpkg search-file libnss
161 </pre>
162 <h3><font color="#6c0023">install</font></h3>
163 <p>
164 This command allows the installation of a local package with
165 the .tazpkg extension. See 'get-install' to install a
166 package from the internet. Note that you can force the
167 installation via the --forced, uninstall and reinstall options
168 or specify the root system where you want to install the
169 packages via the -root= option:
170 </p>
171 <pre>
172 # tazpkg install package-1.0.tazpkg
173 Or :
174 # tazpkg install path/to/package-1.0.tazpkg --forced
175 Or :
176 # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
177 </pre>
178 <h3><font color="#6c0023">install-list or get-install-list</font></h3>
179 <p>
180 Install a set of packages listed in a file. This command
181 allows you to (download and) install several packages with a single command
182 and can also be forced:
183 </p>
184 <pre> # tazpkg install-list my-packages.list
185 # tazpkg get-install-list my-packages.list --forced
186 </pre>
187 <h3><font color="#6c0023">remove</font></h3>
188 <p>
189 Remove a package. You will be asked for confirmation (y/N).
190 This command will delete all files installed with the package.
191 To view the list of files, use the 'list-files' command
192 followed by the name of the package. Example
193 with the package bc:
194 </p>
195 <pre>
196 # tazpkg remove bc
197 </pre>
198 <h3><font color="#6c0023">extract</font></h3>
199 <p>
200 Extract a package into a directory. If you do not specify
201 the destination directory, the package will be extracted
202 in the current directory using the name package-version:
203 </p>
204 <pre>
205 # tazpkg extract package.tazpkg
206 # tazpkg extract package.tazpkg target/dir
207 </pre>
208 <h3><font color="#6c0023">pack</font></h3>
209 <p>
210 The 'pack' command will create a package from a directory
211 prepared in advance or from an unpacked package. It can
212 also manually create a .tazpkg package (see the Tazwok documentation
213 for the automatic creation of packages). To pack a package:
214 </p>
215 <pre>
216 # tazpkg pack package-version
217 </pre>
218 <h3><font color="#6c0023">repack</font></h3>
219 <p>
220 The 'repack' command allows you to recreate a package from
221 the files on a system where it was previously installed.
222 To repack a package:
223 </p>
224 <pre>
225 # tazpkg repack package
226 </pre>
227 <h3><font color="#6c0023">repack-config</font></h3>
228 <p>
229 The 'repack-config' command recreates a package
230 of the system configuration files (see list-config). It is enough
231 to install the package to find the current configuration. To repack
232 the configuration files:
233 </p>
234 <pre> # tazpkg repack-config
235 </pre>
236 <h3><font color="#6c0023">recharge</font></h3>
237 <p>
238 Recharge the list of available packages on the mirror.
239 This command will download the most recent 'packages.list'
240 of installable packages on the mirror and before starting
241 will save the old list. Once the list is updated
242 you can then use the 'list' and 'search' commands. To view
243 and list the differences, you can use 'list-mirror --diff', and to view
244 and update packages, you can simply 'upgrade'. To recharge the
245 latest list of packages:
246 </p>
247 <pre>
248 # tazpkg recharge
249 </pre>
250 <h3><font color="#6c0023">upgrade</font></h3>
251 <p>
252 Upgrade allows you to update all installed packages available
253 on the current mirror. Upgrading packages is an important
254 part of system security, it helps to keep you secure with
255 the latest updates and fixes. The SliTaz project,
256 although tiny, provides regular updates on security and generally
257 offers the latest versions of software. Note that this
258 function is aimed at people with SliTaz installed on a
259 hard drive. Updated packages in LiveCD mode will be lost on
260 system shutdown. To upgrade:
261 </p>
262 <pre>
263 # tazpkg upgrade
264 </pre>
265 <h3><font color="#6c0023">check</font></h3>
266 <p>
267 The 'check' command can check dependencies on installed
268 packages and determine whether all the files needed for the
269 repacking of packages are present:
270 </p>
271 <pre>
272 # tazpkg check package
273 </pre>
274 <h3><font color="#6c0023">block or unblock</font></h3>
275 <p>
276 The 'block' and 'unblock' commands permit you to block
277 installed package versions so that they are not maintained
278 by an 'upgrade'. The list of packages on hold are contained
279 in the /var/lib/tazpkg/blocked-packages.list. This file can also
280 be edited by hand. To block or unblock a package such as
281 Grub:
282 </p>
283 <pre>
284 # tazpkg block grub
285 Or :
286 # tazpkg unblock grub
287 </pre>
288 <h3><font color="#6c0023">get</font></h3>
289 <p>
290 Get a package from the mirror (if it exists). The downloaded
291 package is stored in the current directory. To find the path
292 you can use 'pwd'. To get the Grub package:
293 </p>
294 <pre>
295 # tazpkg get grub
296 </pre>
297 <h3><font color="#6c0023">get-install</font></h3>
298 <p>
299 Get and install a package from a mirror on the internet.
300 The 'get-install' command begins by checking whether the
301 package exists on the mirror and if it has been already downloaded.
302 For a list of packages on the mirror, we must
303 use the 'list-mirror' command. To install the package Grub:
304 </p>
305 <pre>
306 # tazpkg get-install grub
307 </pre>
308 <h3><font color="#6c0023">clean-cache</font></h3>
309 <p>
310 Remove *.tazpkg packages downloaded to the cache. During
311 installation, Tazpkg keeps a copy of packages downloaded
312 from the web. This is done to save bandwidth in case of
313 reinstallation, but you may want to free up space on the hard
314 drive or re-download the packages:
315 </p>
316 <pre>
317 # tazpkg clean-cache
318 </pre>
319 <h3><font color="#6c0023">setup-mirror</font></h3>
320 <p>
321 Setup the URL for the mirror. The 'setup-mirror' command
322 will ask for the URL of the new mirror. You can specify
323 multiple URLs separated by spaces. Note that you can also
324 modify the main /var/lib/tazpkg/mirror file. The URL must
325 point to the directory containing the 'packages.list' and
326 packages:
327 </p>
328 <pre>
329 # tazpkg setup-mirror
330 </pre>
331 <h3><font color="#6c0023">reconfigure</font></h3>
332 <p>
333 Replays the post-install script from the package.
334 Example using gcc:
335 </p>
336 <pre> # tazpkg reconfigure gcc
337 </pre>
338 <h3><font color="#6c0023">depends or rdepends</font></h3>
339 <p>
340 Displays a dependency tree or reverse dependency tree for a package.
341 Examples using mpd:
342 </p>
343 <pre> # tazpkg depends mpd
344 # tazpkg rdepends mpd
345 </pre>
346 <h3><font color="#6c0023">set-release</font></h3>
347 <p>
348 The 'set-release' command changes the current version and
349 upgrades the packages to the latest release:
350 </p>
351 <pre> # tazpkg set-release cooking
352 </pre>
353 <h3><font color="#6c0023">bugs</font></h3>
354 <p>
355 Generates a list of known bugs in the packages:
356 </p>
357 <pre> # tazpkg bugs
358 </pre>
360 <h2>MAINTAINER</h2>
361 <p>
362 Christophe Lincoln <pankso at slitaz.org>
363 </p>
365 </div>
366 <!-- End content -->
367 </body>
368 </html>