website view en/doc/manuals/tazpkg.en.html @ rev 164
en: Edit manuals and docs
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Fri Sep 12 19:18:03 2008 +0000 (2008-09-12) |
| parents | cbc3753477f5 |
| children | 4fc4af3cd0cc |
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-files</font></h3>
123 <p>
124 List all files installed with a package. This command will
125 simply read and display the 'files.list' of each package which is
126 automatically generated when the package is created and is
127 also used to remove files when uninstalling a package.
128 To list the files installed with the package bc:
129 </p>
130 <pre>
131 # tazpkg list-files bc
132 </pre>
133 <h3><font color="#6c0023">search</font></h3>
134 <p>
135 Search for packages by owner or package name. This command
136 will search for the term wanted in the installed packages and the
137 list of available packages on the mirror. To obtain the
138 latest list of installable packages on the mirror, just
139 run 'tazpkg recharge' before conducting a search:
140 </p>
141 <pre>
142 # tazpkg search gcc
143 </pre>
144 <h3><font color="#6c0023">search-file</font></h3>
145 <p>
146 The 'search-file' command allows you to search for a file
147 among the files installed by the packages. This command is very
148 useful to find the full path to a file and determine if
149 a file is present on the system. Example:
150 </p>
151 <pre>
152 $ tazpkg search-file libnss
153 </pre>
154 <h3><font color="#6c0023">install</font></h3>
155 <p>
156 This command allows the installation of a local package with
157 the .tazpkg extension. See 'get-install' to install a
158 package from the internet. Note that you can force the
159 installation via the --forced, uninstall and reinstall options
160 or specify the root system where you want to install the
161 packages via the -root= option:
162 </p>
163 <pre>
164 # tazpkg install package-1.0.tazpkg
165 Or :
166 # tazpkg install path/to/package-1.0.tazpkg --forced
167 Or :
168 # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
169 </pre>
170 <h3><font color="#6c0023">install-list</font></h3>
171 <p>
172 Install a set of packages listed in a file. This command
173 allows you to install several packages with a single command
174 and can also be forced:
175 </p>
176 <pre>
177 # tazpkg install-list my-packages.list
178 # tazpkg install-list my-packages.list --forced
179 </pre>
180 <h3><font color="#6c0023">remove</font></h3>
181 <p>
182 Remove a package. You will be asked for confirmation (y/N).
183 This command will delete all files installed with the package.
184 To view the list of files, use the 'list-files' command
185 followed by the name of the package. Example
186 with the package bc:
187 </p>
188 <pre>
189 # tazpkg remove bc
190 </pre>
191 <h3><font color="#6c0023">extract</font></h3>
192 <p>
193 Extract a package into a directory. If you do not specify
194 the destination directory, the package will be extracted
195 in the current directory using the name package-version:
196 </p>
197 <pre>
198 # tazpkg extract package.tazpkg
199 # tazpkg extract package.tazpkg target/dir
200 </pre>
201 <h3><font color="#6c0023">pack</font></h3>
202 <p>
203 The 'pack' command will create a package from a directory
204 prepared in advance or from an unpacked package. It can
205 also manually create a .tazpkg package (see the Tazwok documentation
206 for the automatic creation of packages). To pack a package:
207 </p>
208 <pre>
209 # tazpkg pack package-version
210 </pre>
211 <h3><font color="#6c0023">repack</font></h3>
212 <p>
213 The 'repack' command allows us to recreate a package from
214 the files on a system where it was previously installed.
215 To repack a package:
216 </p>
217 <pre>
218 # tazpkg repack package
219 </pre>
220 <h3><font color="#6c0023">recharge</font></h3>
221 <p>
222 Recharge the list of available packages on the mirror.
223 This command will download the most recent 'packages.list'
224 of installable packages on the mirror and before starting
225 will save the old list. Once the list is updated
226 you can then use the 'list' and 'search' commands. To view
227 and list the differences, you can use 'list-mirror --diff', and to view
228 and update packages, you can simply 'upgrade'. To recharge the
229 latest list of packages:
230 </p>
231 <pre>
232 # tazpkg recharge
233 </pre>
234 <h3><font color="#6c0023">upgrade</font></h3>
235 <p>
236 Upgrade allows you to update all installed packages available
237 on the current mirror. Upgrading packages is an important
238 part of system security, it helps to keep you secure with
239 the latest updates and fixes. The SliTaz project,
240 although tiny, provides regular updates on security and generally
241 offers the latest versions of software. Note that this
242 function is aimed at people with SliTaz installed on a
243 hard drive. Updated packages in LiveCD mode will be lost on
244 system shutdown. To upgrade:
245 </p>
246 <pre>
247 # tazpkg upgrade
248 </pre>
249 <h3><font color="#6c0023">check</font></h3>
250 <p>
251 The 'check' command can check dependencies on installed
252 packages and determine whether all the files needed for the
253 repacking of packages are present:
254 </p>
255 <pre>
256 # tazpkg check package
257 </pre>
258 <h3><font color="#6c0023">block or unblock</font></h3>
259 <p>
260 The 'block' and 'unblock' commands permit you to block
261 installed package versions so that they are not maintained
262 by an 'upgrade'. The list of packages on hold are contained
263 in the /var/lib/tazpkg/blocked-packages.list. This file can also
264 be edited by hand. To block or unblock a package such as
265 Grub:
266 </p>
267 <pre>
268 # tazpkg block grub
269 Or :
270 # tazpkg unblock grub
271 </pre>
272 <h3><font color="#6c0023">get</font></h3>
273 <p>
274 Get a package from the mirror (if it exists). The downloaded
275 package is stored in the current directory. To find the path
276 you can use 'pwd'. To get the Grub package:
277 </p>
278 <pre>
279 # tazpkg get grub
280 </pre>
281 <h3><font color="#6c0023">get-install</font></h3>
282 <p>
283 Get and install a package from a mirror on the internet.
284 The 'get-install' command begins by checking whether the
285 package exists on the mirror and if it has been already downloaded.
286 For a list of packages on the mirror, we must
287 use the 'list-mirror' command. To install the package Grub:
288 </p>
289 <pre>
290 # tazpkg get-install grub
291 </pre>
292 <h3><font color="#6c0023">clean-cache</font></h3>
293 <p>
294 Remove *.tazpkg packages downloaded to the cache. During
295 installation, Tazpkg keeps a copy of packages downloaded
296 from the web. This is done to save bandwidth in case of
297 reinstallation, but you may want to free up space on the hard
298 drive or re-download the packages:
299 </p>
300 <pre>
301 # tazpkg clean-cache
302 </pre>
303 <h3><font color="#6c0023">setup-mirror</font></h3>
304 <p>
305 Setup the URL for the mirror. The 'setup-mirror' command
306 will ask for the URL of the new mirror. You can specify
307 multiple URLs separated by spaces. Note that you can also
308 modify the main /var/lib/tazpkg/mirror file. The URL must
309 point to the directory containing the 'packages.list' and
310 packages:
311 </p>
312 <pre>
313 # tazpkg setup-mirror
314 </pre>
316 <h2>MAINTAINER</h2>
317 <p>
318 Christophe Lincoln <pankso at slitaz.org>
319 </p>
321 </div>
322 <!-- End content -->
323 </body>
324 </html>