rev |
line source |
pankso@467
|
1 <!DOCTYPE html>
|
al@811
|
2 <html lang="en">
|
pankso@302
|
3 <head>
|
al@844
|
4 <meta charset="UTF-8">
|
al@828
|
5 <title>TazPkg Manual</title>
|
al@844
|
6 <meta name="viewport" content="width=device-width,initial-scale=1">
|
al@844
|
7 <link rel="stylesheet" href="../slitaz-doc.css">
|
al@844
|
8 <script src="../slitaz-doc.js"></script>
|
pankso@302
|
9 </head>
|
pankso@467
|
10 <body>
|
pankso@467
|
11
|
al@811
|
12 <header>
|
al@633
|
13 <h1>TazPkg Manual</h1>
|
al@811
|
14 </header>
|
pankso@467
|
15
|
pankso@302
|
16
|
al@571
|
17
|
al@571
|
18
|
al@844
|
19 <section><header>Name</header>
|
pankso@302
|
20
|
al@844
|
21 <p>TazPkg — Tiny autonomous zone package manager.</p>
|
al@844
|
22 </section>
|
al@571
|
23
|
al@844
|
24
|
al@844
|
25 <section><header>Syntax</header>
|
al@571
|
26
|
pankso@302
|
27 <pre>
|
al@811
|
28 tazpkg [command] [options...]
|
pankso@302
|
29 </pre>
|
al@844
|
30 </section>
|
pankso@302
|
31
|
al@571
|
32
|
al@844
|
33 <section><header>Description</header>
|
al@571
|
34
|
al@844
|
35 <p>TazPkg is a lightweight package manager to install, list, download, update or remove precompiled
|
al@844
|
36 packages on a GNU/Linux system. TazPkg offers commands for searching and creating packages and was
|
al@844
|
37 created independently for the project. The format of the packages using the *.tazpkg extension is
|
al@844
|
38 a cpio archive containing a filesystem compressed with lzma, a receipt and an optional description.
|
al@844
|
39 TazPkg also manages dependencies based on package receipts. Each receipt contains all the
|
al@844
|
40 information about a package and can also include pre- and post-installation functions. The same
|
al@844
|
41 receipt is used by <a href="../cookutils/cookutils.en.html" target="_blank">Cookutils</a> to compile
|
al@844
|
42 sources and generate a .tazpkg package.</p>
|
al@811
|
43
|
al@844
|
44 <p>TazPkg is entirely built from scratch using Shell script, compatible with Bash; it runs under
|
al@844
|
45 Ash — part of the Busybox project. TazPkg is distributed under the free GNU license <a
|
al@844
|
46 href="file:///usr/share/licenses/gpl.txt" target="_blank">GPL V3</a>.</p>
|
al@844
|
47 </section>
|
pankso@302
|
48
|
al@571
|
49
|
al@844
|
50 <section><header>Environment</header>
|
al@828
|
51
|
al@828
|
52 <p>TazPkg uses some environment variables:</p>
|
al@828
|
53
|
al@828
|
54 <ul>
|
al@844
|
55 <li><tt>LANGUAGE</tt>: defines the language of output and user confirmations.
|
al@844
|
56 <x-details>Note, <tt>LANG</tt> and <tt>LC_ALL</tt> environment variables also affect output
|
al@844
|
57 language</x-details></li>
|
al@844
|
58 <li><tt>LC_TIME</tt>: defines the date format in the <a href="#activity">activity</a>
|
al@844
|
59 command</li>
|
paul@909
|
60 <li><tt>root</tt>: if defined, points to the root of a file system where TazPkg should work.
|
paul@909
|
61 Note, a value defined using <tt>--root=</tt> option has precedence over this environment
|
al@844
|
62 variable</li>
|
al@828
|
63 </ul>
|
al@844
|
64 </section>
|
al@828
|
65
|
al@828
|
66
|
al@844
|
67 <section><header>Files</header>
|
al@828
|
68
|
al@828
|
69
|
al@844
|
70 <article><header>Configuration files</header>
|
al@828
|
71
|
al@828
|
72 <ul>
|
al@828
|
73 <li><tt><a href="file:///etc/slitaz/slitaz.conf"
|
al@828
|
74 target="_blank">/etc/slitaz/slitaz.conf</a></tt></li>
|
al@828
|
75 <li><tt><a href="file:///etc/slitaz/tazpkg.conf"
|
al@828
|
76 target="_blank">/etc/slitaz/tazpkg.conf</a></tt></li>
|
al@828
|
77 </ul>
|
al@844
|
78 </article>
|
al@828
|
79
|
al@828
|
80
|
al@844
|
81 <article><header>Package database files</header>
|
al@828
|
82
|
al@828
|
83 <p>Default placement of the package database is <tt>/var/lib/tazpkg</tt>.</p>
|
al@828
|
84
|
al@828
|
85 <ul>
|
al@844
|
86 <li><tt><a href="file:///var/lib/tazpkg/ID" target="_blank">ID</a></tt> (deprecated): identifier
|
al@844
|
87 of the current SliTaz repository state.
|
paul@835
|
88 <x-details>The value changes when new or updated packages appear in the
|
al@828
|
89 repository.</x-details></li>
|
al@844
|
90 <li><tt><a href="file:///var/lib/tazpkg/IDs" target="_blank">IDs</a></tt>: identifier of the
|
al@844
|
91 current SliTaz repository state and the UNIX time stamp.
|
al@844
|
92 <x-details>The ID value changes when new or updated packages appear in the repository. Time
|
al@844
|
93 stamp allows you to track how long a change is made in the repository and to track the
|
al@844
|
94 freshness of repository mirrors. (To convert UNIX time stamp to the date:
|
al@828
|
95 <code>date -d@<em>timestamp</em></code>)</x-details></li>
|
al@844
|
96 <li><tt><a href="file:///var/lib/tazpkg/mirror" target="_blank">mirror</a></tt>: URL of the
|
al@844
|
97 current repository mirror in use.
|
al@844
|
98 <x-details>URL points to the remote folder containing packages and database
|
al@844
|
99 files.</x-details></li>
|
al@844
|
100 <li><tt><a href="file:///var/lib/tazpkg/mirrors" target="_blank">mirrors</a></tt>: list of URLs
|
al@844
|
101 of available repository mirrors.
|
al@844
|
102 <x-details>Note the difference between URLs from these two files; you should append URL from
|
al@903
|
103 this file by <tt>packages/<em>cooking</em>/</tt> (for <tt><em>cooking</em></tt>-based SliTaz
|
al@844
|
104 version).</x-details></li>
|
al@844
|
105 <li><tt><a href="file:///var/lib/tazpkg/packages.list" target="_blank">packages.list</a></tt>
|
al@844
|
106 (deprecated): list of package names with version numbers available in the repository.</li>
|
al@844
|
107 <li><tt><a href="file:///var/lib/tazpkg/packages.desc" target="_blank">packages.desc</a></tt>
|
al@844
|
108 (deprecated): list contained package name, version, short description, category and upstream
|
al@828
|
109 URL.</li>
|
al@844
|
110 <li><tt><a href="file:///var/lib/tazpkg/packages.txt" target="_blank">packages.txt</a></tt>
|
al@844
|
111 (deprecated): list containing package name, version, short description and two package sizes
|
al@844
|
112 <x-details>(first — traffic to download package, second — HDD size for installed
|
al@844
|
113 package)</x-details>.</li>
|
al@844
|
114 <li><tt><a href="file:///var/lib/tazpkg/packages.md5" target="_blank">packages.md5</a></tt>
|
al@844
|
115 (deprecated): list containing MD5 checksum with package file name.</li>
|
al@844
|
116 <li><tt><a href="file:///var/lib/tazpkg/packages.info" target="_blank">packages.info</a></tt>:
|
al@844
|
117 list was built to replace and extend above lists.
|
al@844
|
118 <x-details>For every package available in the repository it contains: package name, version,
|
al@844
|
119 category, short description, upstream URL, tags, package sizes, depends and MD5 checksum.
|
al@844
|
120 Development continues, and the list can be extended by other fields, if
|
al@844
|
121 necessary.</x-details></li>
|
al@844
|
122 <li><tt><a href="file:///var/lib/tazpkg/packages.equiv" target="_blank">packages.equiv</a></tt>:
|
al@844
|
123 list of equivalent packages available in the repository.
|
al@844
|
124 <x-details>Format of the list item: <tt><em>package</em>=<em>rule rule…</em></tt>.<br>
|
al@844
|
125 Format of the rule: <tt><em>alternative:newname</em></tt> — if <tt><em>alternative</em></tt>
|
al@844
|
126 is installed then <tt><em>newname</em></tt> will be installed instead of the
|
al@828
|
127 <tt><em>package</em></tt>.<br>
|
al@844
|
128 In the second format of the rule <tt><em>alternative:</em></tt> part is omitted — in this
|
al@844
|
129 case <tt><em>newname</em></tt> <em>can be</em> installed instead of the
|
al@844
|
130 <tt><em>package</em></tt> (in the user choice).</x-details></li>
|
al@844
|
131 <li><tt><a href="file:///var/lib/tazpkg/packages.diff" target="_blank">packages.diff</a></tt>:
|
al@844
|
132 list created when you run <tt><a href="#recharge">recharge</a></tt> command.
|
al@844
|
133 <x-details>List contains package names with versions of the new packages available in the
|
al@844
|
134 repository with the last recharge.</x-details></li>
|
al@844
|
135 <li><tt><a href="file:///var/lib/tazpkg/packages.up" target="_blank">packages.up</a></tt>: list
|
al@844
|
136 created when you run <tt><a href="#upgrade">upgrade</a></tt> command.
|
al@844
|
137 <x-details>List contains package names you can upgrade with the last
|
paul@835
|
138 recharge.</x-details></li>
|
al@844
|
139 <li><tt><a href="file:///var/lib/tazpkg/descriptions.txt"
|
al@844
|
140 target="_blank">descriptions.txt</a></tt>: list of the “long” descriptions of the all
|
al@844
|
141 packages available on the repository.</li>
|
al@844
|
142 <li><tt>packages-desc.<em>language</em></tt> — optional list of the packages translated short
|
al@844
|
143 descriptions
|
al@844
|
144 <x-details>(see the package tazpkg-desc-ru)</x-details>.</li>
|
al@844
|
145 <li><tt>descriptions.<em>language</em>.txt</tt> — optional list of the packages translated
|
al@844
|
146 “long” descriptions
|
al@844
|
147 <x-details>(see the package tazpkg-desc-ru)</x-details>.</li>
|
al@844
|
148 <li><tt>packages.icons</tt> — optional list of the packages icons for TazPanel.</li>
|
al@844
|
149 <li><tt><a href="file:///var/lib/tazpkg/blocked-packages.list"
|
al@844
|
150 target="_blank">blocked-packages.list</a></tt>: optional list of the packages blocked for
|
al@844
|
151 update.</li>
|
al@844
|
152 <li><tt><a href="file:///var/lib/tazpkg/extra.list" target="_blank">extra.list</a></tt>: list of
|
al@844
|
153 the extra packages
|
al@844
|
154 <x-details>(non-free packages; free packages but not compiled from sources). List contains
|
al@844
|
155 package name, short description, upstream URL, category, version, license.</x-details></li>
|
al@844
|
156 <li><tt>files.list.lzma</tt>: very large compressed list which contains all the files of all the
|
al@844
|
157 packages available in the repository
|
al@844
|
158 <x-details>(nearly 5,000 packages and nearly 0.7 million files now)</x-details>.</li>
|
al@844
|
159 <li><tt>files-list.md5</tt>: MD5 checksum of the <tt>files.list.lzma</tt>.</li>
|
al@844
|
160 <li><tt><a href="file:///var/lib/tazpkg/installed.info" target="_blank">installed.info</a></tt>:
|
al@844
|
161 list of the installed packages with the exact format of the <tt>packages.info</tt> list.
|
al@844
|
162 <x-details>Idea is just to copy list item from <tt>packages.info</tt> to the
|
al@844
|
163 <tt>installed.info</tt> during package installation.</x-details></li>
|
al@844
|
164 <li><tt><a href="file:///var/lib/tazpkg/installed.md5" target="_blank">installed.md5</a></tt>
|
al@844
|
165 (deprecated): list containing MD5 checksum with file names of all installed packages.</li>
|
al@844
|
166 <li><tt><a href="file:///var/lib/tazpkg/priority" target="_blank">priority</a></tt>: optional
|
al@844
|
167 list of the repositories priority.
|
al@844
|
168 <x-details>One repository name per line. Undigest repositories are called by their names and
|
al@844
|
169 main repository by “main”. If priority list absent, then default priority is: main
|
paul@909
|
170 repository and all existing undigest repositories in alphabetical
|
al@844
|
171 order.</x-details></li>
|
al@828
|
172 </ul>
|
al@828
|
173
|
al@844
|
174 <p>All the deprecated files will be deleted after we verify that the programs do not use them (and
|
al@844
|
175 modify the programs as necessary).</p>
|
al@828
|
176
|
al@844
|
177 <p>In addition to the common package database files there is also individual folders for all
|
al@844
|
178 installed packages placed by default in the <tt>/var/lib/tazpkg/installed/<em>package</em></tt>.
|
al@844
|
179 Every folder here may contain the following files:</p>
|
al@828
|
180
|
al@828
|
181 <ul>
|
al@828
|
182 <li><tt>receipt</tt> (mandatory) — the package recipe</li>
|
al@828
|
183 <li><tt>files.list</tt> (mandatory) — list of package files</li>
|
al@844
|
184 <li><tt>md5sum</tt> (mandatory) — checksums of package files (other checksum files can be
|
al@844
|
185 specified in the settings: <tt>cksum</tt> (CRC32), <tt>md5sum</tt> (MD5), <tt>sha1sum</tt>
|
al@844
|
186 (SHA1), <tt>sha256sum</tt> (SHA256), <tt>sha512sum</tt> (SHA512), <tt>sha3sum</tt>
|
al@844
|
187 (SHA3-512))</li>
|
al@828
|
188 <li><tt>description.txt</tt> (optional) — “long” description</li>
|
al@844
|
189 <li><tt>modifiers</tt> (optional) — list of packages that have replaced some of the files of
|
al@844
|
190 this package</li>
|
al@844
|
191 <li><tt>volatile.cpio.gz</tt> (optional) — archive of “official” configuration files</li>
|
al@828
|
192 </ul>
|
al@844
|
193 </article>
|
al@828
|
194
|
al@828
|
195
|
al@844
|
196 <article><header>Cache</header>
|
al@828
|
197
|
al@844
|
198 <p>Default placement of the packages cache is <tt>/var/cache/tazpkg</tt> with sub-folders for the
|
al@844
|
199 different repositories.
|
al@844
|
200 <x-details>It is exactly <tt>/var/cache/tazpkg/<em>cooking</em>/packages</tt> for the
|
al@828
|
201 <tt><em>cooking</em></tt>-based SliTaz version.</x-details></p>
|
al@844
|
202 </article>
|
al@828
|
203
|
al@828
|
204
|
al@844
|
205 <article><header>Misc files</header>
|
al@828
|
206
|
al@828
|
207 <p>File with default placement <tt><a href="file:///var/log/slitaz/tazpkg.log"
|
paul@909
|
208 target="_blank">/var/log/slitaz/tazpkg.log</a></tt> stores the TazPkg activity log.
|
al@844
|
209 <x-details>Log stores five types of actions: installing, uninstalling, blocking, unblocking,
|
al@844
|
210 reconfiguring packages.</x-details></p>
|
al@828
|
211
|
al@844
|
212 <p>Shared MIME information which allows to “guess” SliTaz package files, package receipts and
|
al@844
|
213 SliTaz flavor files.
|
al@844
|
214 <x-details>File placed here: <tt><a href="file:///usr/share/mime/packages/tazpkg.xml"
|
al@828
|
215 target="_blank">/usr/share/mime/packages/tazpkg.xml</a></tt>.</x-details></p>
|
al@828
|
216
|
al@828
|
217 <p>Plug-in for the TazPanel (SliTaz administration and configuration panel)
|
al@844
|
218 <tt>/var/www/tazpanel/pkgs.cgi</tt> allows you to manage SliTaz packages in the <a
|
al@844
|
219 href="http://127.0.0.1:82/pkgs.cgi" target="_blank">web application</a>.</p>
|
al@828
|
220
|
al@844
|
221 <p>TazPkg documentation is placed in the <tt>/usr/share/doc/tazpkg</tt> folder.</p>
|
al@844
|
222 </article>
|
al@844
|
223 </section>
|
al@828
|
224
|
al@828
|
225
|
al@828
|
226
|
al@828
|
227
|
al@844
|
228 <section><header>Commands</header>
|
al@828
|
229
|
al@844
|
230 <p>The first <tt>tazpkg</tt> parameter is a command followed by other mandatory and optional
|
al@844
|
231 parameters as will be described hereinafter. Options begin with double dashes, you can arrange them
|
al@844
|
232 in any order and in any place, even before the command. Unknown and inappropriate options are
|
al@844
|
233 ignored. The following commands are equivalent:</p>
|
al@828
|
234
|
al@834
|
235 <pre>
|
al@828
|
236 $ tazpkg info nano --root=<em>/mnt/sda6</em>
|
al@828
|
237 $ tazpkg --root=<em>/mnt/sda6</em> info nano
|
al@828
|
238 $ tazpkg info --root=<em>/mnt/sda6</em> nano <em>--color</em>
|
al@834
|
239 </pre>
|
al@828
|
240
|
paul@909
|
241 <p>You can add global option <tt>--root=…</tt> to any TazPkg command. This option allows you to work
|
paul@909
|
242 with other SliTaz installations and can point to the root of a mounted file system from another SliTaz
|
al@844
|
243 installation.
|
al@844
|
244 <x-details>By the way, using this option allows to install SliTaz to the other file system “from
|
paul@909
|
245 scratch” and upgrade SliTaz packages remotely.</x-details></p>
|
al@571
|
246
|
al@571
|
247
|
al@844
|
248 <article><header>Service commands</header>
|
al@811
|
249
|
al@811
|
250 <ul>
|
al@811
|
251 <li><a href="#usage">usage</a>: print short usage</li>
|
al@811
|
252 <li><a href="#help">help</a>: show help on the TazPkg commands</li>
|
al@811
|
253 <li><a href="#activity">activity</a>: show TazPkg activity log</li>
|
al@844
|
254 <li><a href="#clean-cache">clean-cache</a>: clean all packages downloaded in cache
|
al@844
|
255 directory</li>
|
al@866
|
256 <li><a href="#list-cache">list-cache</a>: list all packages downloaded in cache
|
al@866
|
257 directory</li>
|
al@811
|
258 <li><a href="#shell">shell</a>: run interactive TazPkg shell</li>
|
al@811
|
259 </ul>
|
al@844
|
260 </article>
|
al@811
|
261
|
al@811
|
262
|
al@844
|
263 <article><header>Working with lists</header>
|
al@811
|
264
|
al@811
|
265 <ul>
|
al@811
|
266 <li><a href="#list">list</a>: list installed packages on the system</li>
|
al@844
|
267 <li><a href="#list-mirror">list-mirror</a>: list all available packages on the mirror</li>
|
al@844
|
268 <li><a href="#list-config">list-config</a>: list the configuration files</li>
|
al@811
|
269 </ul>
|
al@844
|
270 </article>
|
al@811
|
271
|
al@811
|
272
|
al@844
|
273 <article><header>Search</header>
|
al@811
|
274
|
al@811
|
275 <ul>
|
al@844
|
276 <li><a href="#search">search</a>: search for a package by pattern or name</li>
|
al@844
|
277 <li><a href="#search-pkgname">search-pkgname</a>: search on mirror for package having a
|
al@844
|
278 particular file</li>
|
al@844
|
279 <li><a href="#search-file">search-file</a>: search for file in all installed packages files</li>
|
al@811
|
280 </ul>
|
al@844
|
281 </article>
|
al@811
|
282
|
al@811
|
283
|
al@844
|
284 <article><header>Installing and removing packages</header>
|
al@811
|
285
|
al@811
|
286 <ul>
|
al@844
|
287 <li><a href="#get">get</a>: download a package into the current directory</li>
|
al@811
|
288 <li><a href="#install">install</a>: install a local package</li>
|
al@844
|
289 <li><a href="#get-install">get-install</a>: download and install a package from the mirror</li>
|
al@844
|
290 <li><a href="#get-list">get-list</a>: download a list of packages from the mirror</li>
|
al@844
|
291 <li><a href="#get-list">install-list</a>: install all packages from a list of packages</li>
|
al@844
|
292 <li><a href="#get-list">get-install-list</a>: download and install a list of packages from the
|
al@844
|
293 mirror</li>
|
al@844
|
294 <li><a href="#remove">remove</a>: remove the specified package and all installed files</li>
|
al@844
|
295 <li><a href="#reconfigure">reconfigure</a>: replay post install script from package</li>
|
al@844
|
296 <li><a href="#link">link</a>: link a package from another SliTaz installation</li>
|
al@844
|
297 <li><a href="#set-release">set-release</a>: change release and update packages</li>
|
al@844
|
298 <li><a href="#add-flavor">add-flavor</a>: install the flavor list of packages</li>
|
al@844
|
299 <li><a href="#add-flavor">install-flavor</a>: install the flavor list of packages and remove
|
al@844
|
300 other ones</li>
|
al@811
|
301 </ul>
|
al@844
|
302 </article>
|
al@811
|
303
|
al@811
|
304
|
al@844
|
305 <article><header>Working with packages</header>
|
al@811
|
306
|
al@811
|
307 <ul>
|
al@811
|
308 <li><a href="#info">info</a>: print information about a package</li>
|
al@811
|
309 <li><a href="#desc">desc</a>: print description of a package</li>
|
al@844
|
310 <li><a href="#list-files">list-files</a>: list the files installed with a package</li>
|
al@844
|
311 <li><a href="#block">block, unblock</a>: block an installed package version or unblock it for
|
al@844
|
312 upgrade</li>
|
al@844
|
313 <li><a href="#check">check</a>: verify consistency of installed packages</li>
|
al@811
|
314 <li><a href="#bugs">bugs</a>: show known bugs in packages</li>
|
al@811
|
315 <li><a href="#depends">depends</a>: display dependencies tree</li>
|
al@811
|
316 <li><a href="#depends">rdepends</a>: display reverse dependencies tree</li>
|
al@844
|
317 <li><a href="#extract">extract</a>: extract a (*.tazpkg) package into a directory</li>
|
al@811
|
318 <li><a href="#pack">pack</a>: pack an unpacked or prepared package tree</li>
|
al@844
|
319 <li><a href="#repack">repack</a>: create a package archive from an installed package</li>
|
al@844
|
320 <li><a href="#repack-config">repack-config</a>: create a package archive with configuration
|
al@844
|
321 files</li>
|
al@844
|
322 <li><a href="#recompress">recompress</a>: rebuild a package with a better compression ratio</li>
|
al@811
|
323 <li><a href="#convert">convert</a>: convert alien package to tazpkg</li>
|
al@844
|
324 <li><a href="#list-suggested">list-suggested</a>: print list of suggested packages</li>
|
al@811
|
325 </ul>
|
al@844
|
326 </article>
|
al@811
|
327
|
al@811
|
328
|
al@844
|
329 <article><header>Working with repositories</header>
|
al@811
|
330
|
al@811
|
331 <ul>
|
al@844
|
332 <li><a href="#recharge">recharge</a>: recharge your packages database from the mirror</li>
|
al@844
|
333 <li><a href="#upgrade">upgrade</a>: check packages, list and install latest upgrades</li>
|
al@844
|
334 <li><a href="#setup-mirror">setup-mirror</a>: change the mirror URL configuration</li>
|
al@844
|
335 <li><a href="#add-undigest">setup-undigest</a>: update an undigest mirror</li>
|
al@811
|
336 <li><a href="#list-undigest">list-undigest</a>: list undigest mirrors</li>
|
al@811
|
337 <li><a href="#add-undigest">add-undigest</a>: add an undigest mirror</li>
|
al@844
|
338 <li><a href="#remove-undigest">remove-undigest</a>: remove an undigest mirror</li>
|
paul@848
|
339 <li><a href="#mkdb">mkdb</a>: make a TazPkg database for a folder with *.tazpkg packages</li>
|
al@811
|
340 </ul>
|
al@844
|
341 </article>
|
al@844
|
342 </section>
|
al@811
|
343
|
al@811
|
344
|
al@811
|
345
|
al@811
|
346
|
al@844
|
347 <section><header>Service commands</header>
|
al@811
|
348
|
al@811
|
349
|
al@844
|
350 <article id="usage"><h3>usage</h3>
|
al@811
|
351
|
al@811
|
352 <p>Show the full list of the TazPkg commands with a brief description.</p>
|
al@811
|
353
|
al@811
|
354 <pre>
|
al@811
|
355 $ tazpkg usage
|
al@811
|
356 </pre>
|
al@844
|
357 </article>
|
al@811
|
358
|
al@811
|
359
|
al@844
|
360 <article id="help"><h3>help</h3>
|
al@811
|
361
|
al@844
|
362 <p>Display help for the selected command (<tt>help</tt> or <tt>-h</tt>). You can enter a short name
|
al@844
|
363 of the command, the full name or a part of the full name. You can ignore hyphens at the beginning of
|
al@844
|
364 the short name. If the requested part of the full name match the several commands, you will be asked
|
al@844
|
365 to clarify the request.</p>
|
al@811
|
366
|
al@811
|
367 <pre>
|
al@811
|
368 $ tazpkg help <em>-gi</em>
|
al@811
|
369 $ tazpkg -h <em>us</em>
|
al@811
|
370 </pre>
|
al@844
|
371 </article>
|
al@811
|
372
|
al@811
|
373
|
al@844
|
374 <article id="activity"><h3>activity</h3>
|
al@811
|
375
|
al@844
|
376 <p>Display TazPkg activity log (<tt>activity</tt> or <tt>log</tt> or <tt>-a</tt>). Optional
|
al@844
|
377 parameter <tt>--nb=</tt> lets you set number of displayed lines.</p>
|
al@811
|
378
|
al@811
|
379 <pre>
|
al@811
|
380 $ tazpkg activity
|
al@811
|
381 $ tazpkg -a --nb=<em>20</em>
|
al@811
|
382 </pre>
|
al@844
|
383 </article>
|
al@811
|
384
|
al@811
|
385
|
al@844
|
386 <article id="clean-cache"><h3>clean-cache</h3>
|
al@811
|
387
|
al@844
|
388 <p>Remove *.tazpkg packages downloaded to the cache (<tt>clean-cache</tt> or <tt>-cc</tt>). During
|
al@844
|
389 installation, TazPkg keeps a copy of packages downloaded from the Web. This is done to save
|
al@844
|
390 bandwidth in case of reinstallation, but you may want to free up space on the hard drive or
|
al@844
|
391 re-download the packages.</p>
|
al@811
|
392
|
al@811
|
393 <pre>
|
al@811
|
394 # tazpkg clean-cache
|
al@811
|
395 # tazpkg -cc
|
al@811
|
396 </pre>
|
al@844
|
397 </article>
|
al@811
|
398
|
al@811
|
399
|
al@866
|
400 <article id="list-cache"><h3>list-cache</h3>
|
al@866
|
401
|
al@866
|
402 <p>List *.tazpkg packages downloaded to the cache. Displays a list of file names and their sizes,
|
al@866
|
403 as well as the total amount and size.</p>
|
al@866
|
404
|
al@866
|
405 <pre>
|
al@866
|
406 # tazpkg list-cache
|
al@866
|
407 </pre>
|
al@866
|
408 </article>
|
al@866
|
409
|
al@866
|
410
|
al@844
|
411 <article id="shell"><h3>shell</h3>
|
al@811
|
412
|
al@844
|
413 <p>Run interactive TazPkg shell. Here you can enter all the TazPkg commands listed above.</p>
|
al@811
|
414
|
al@811
|
415 <pre>
|
al@811
|
416 $ tazpkg shell
|
al@811
|
417 # tazpkg shell
|
al@811
|
418 </pre>
|
al@844
|
419 </article>
|
al@844
|
420 </section>
|
al@811
|
421
|
al@811
|
422
|
al@811
|
423
|
al@811
|
424
|
al@844
|
425 <section><header>Working with lists</header>
|
al@811
|
426
|
al@811
|
427
|
al@844
|
428 <article id="list"><h3>list</h3>
|
al@571
|
429
|
al@844
|
430 <p>List packages installed on the system (<tt>list</tt> or <tt>-l</tt>). This command displays a
|
al@844
|
431 column list of all installed packages. It also allows you to list the categories (<tt>c</tt> or
|
al@844
|
432 <tt>cat</tt> or <tt>categories</tt>), packages based on category and packages placed on hold
|
al@844
|
433 (<tt>b</tt> or <tt>blocked</tt>). You can also use the <tt><a href="#search">search</a></tt>
|
al@811
|
434 command for a list based on a term or package name.</p>
|
al@811
|
435
|
pankso@302
|
436 <pre>
|
al@811
|
437 $ tazpkg list
|
al@811
|
438 $ tazpkg list cat
|
al@811
|
439 $ tazpkg list <em>games</em>
|
al@811
|
440 $ tazpkg list blocked
|
pankso@302
|
441 </pre>
|
al@844
|
442 </article>
|
pankso@467
|
443
|
al@571
|
444
|
al@844
|
445 <article id="list-mirror"><h3>list-mirror</h3>
|
al@571
|
446
|
al@844
|
447 <p>List packages available on the mirror (<tt>list-mirror</tt> or <tt>-lm</tt>). This command will
|
al@844
|
448 display the packages list recharged from the mirror. If it doesn't exist, you will be asked to
|
al@844
|
449 launch <code>tazpkg <a href="#recharge">recharge</a></code> as administrator (root) for a list of
|
al@844
|
450 available packages. The <tt>--diff</tt> option is used to display the differences between the last
|
al@844
|
451 and current list of packages.</p>
|
al@811
|
452
|
pankso@302
|
453 <pre>
|
al@811
|
454 $ tazpkg list-mirror
|
al@811
|
455 $ tazpkg -lm --diff
|
pankso@302
|
456 </pre>
|
al@844
|
457 </article>
|
pankso@467
|
458
|
al@571
|
459
|
al@844
|
460 <article id="list-config"><h3>list-config</h3>
|
al@571
|
461
|
al@844
|
462 <p>Lists the system configuration files. The <tt>--box</tt> option displays in table form. You can
|
al@844
|
463 specify package name to display configuration files only for this package.</p>
|
al@811
|
464
|
al@633
|
465 <pre>
|
al@811
|
466 $ tazpkg list-config
|
al@811
|
467 $ tazpkg list-config --box
|
al@811
|
468 $ tazpkg list-config <em>slim</em>
|
al@844
|
469 $ tazpkg list-config <em>slim</em> --box
|
pankso@302
|
470 </pre>
|
al@844
|
471 </article>
|
al@844
|
472 </section>
|
pankso@467
|
473
|
al@571
|
474
|
al@571
|
475
|
al@811
|
476
|
al@844
|
477 <section><header>Search</header>
|
pankso@467
|
478
|
al@571
|
479
|
al@844
|
480 <article id="search"><h3>search</h3>
|
al@571
|
481
|
al@844
|
482 <p>Search for packages by owner or package name (<tt>search</tt> or <tt>-s</tt>). This command will
|
al@844
|
483 search for the term wanted in the installed packages (<tt>-i</tt> or <tt>--installed</tt>) and the
|
al@844
|
484 list of available packages on the mirror (<tt>-l</tt> or <tt>--list</tt>).</p>
|
al@811
|
485
|
al@844
|
486 <p>To obtain the latest list of installable packages on the mirror, just run <code>tazpkg
|
al@844
|
487 recharge</code> before conducting a search.</p>
|
al@811
|
488
|
pankso@302
|
489 <pre>
|
al@811
|
490 $ tazpkg search <em>gcc</em>
|
al@811
|
491 $ tazpkg search <em>mt</em> -i
|
al@811
|
492 $ tazpkg search <em>bit</em> -l
|
al@811
|
493 </pre>
|
al@844
|
494 </article>
|
al@811
|
495
|
al@811
|
496
|
al@844
|
497 <article id="search-pkgname"><h3>search-pkgname</h3>
|
al@811
|
498
|
al@844
|
499 <p>Search for a file on mirror and output only the packages names (<tt>search-pkgname</tt> or
|
al@844
|
500 <tt>-sp</tt>).</p>
|
al@811
|
501
|
al@811
|
502 <pre>
|
al@811
|
503 $ tazpkg search-pkgname <em>libnss</em>
|
al@811
|
504 $ tazpkg -sp <em>/usr/share/fonts</em>
|
pankso@302
|
505 </pre>
|
al@844
|
506 </article>
|
pankso@467
|
507
|
al@571
|
508
|
al@844
|
509 <article id="search-file"><h3>search-file</h3>
|
al@571
|
510
|
al@844
|
511 <p>Search for a file among the files installed by the packages (<tt>search-file</tt> or
|
al@844
|
512 <tt>-sf</tt>). This command is very useful to find the full path to a file and determine if a file
|
al@844
|
513 is present on the system. Option <tt>--mirror</tt> allows to search for a file among all the files
|
al@844
|
514 available on the mirror.</p>
|
al@811
|
515
|
pankso@302
|
516 <pre>
|
al@633
|
517 $ tazpkg search-file <em>libnss</em>
|
al@811
|
518 $ tazpkg -sf <em>/usr/share/fonts</em> --mirror
|
al@811
|
519 </pre>
|
al@844
|
520 </article>
|
al@844
|
521 </section>
|
al@811
|
522
|
al@811
|
523
|
al@811
|
524
|
al@811
|
525
|
al@844
|
526 <section><header>Installing and removing packages</header>
|
al@811
|
527
|
al@811
|
528
|
al@844
|
529 <article id="get"><h3>get</h3>
|
al@811
|
530
|
al@844
|
531 <p>Get a package from the mirror (<tt>get</tt> or <tt>-g</tt>). The downloaded package is stored in
|
al@844
|
532 the current directory. You will get regular package, or get-package, or extra-package (in that
|
al@844
|
533 order). You can specify <tt>--extra</tt> option to get an extra-package only.</p>
|
al@844
|
534
|
al@844
|
535 <p>You can specify multiple packages on the command line or give tazpkg a list of the packages you
|
al@844
|
536 want to download or use <tt><a href="#get-list">get-list</a></tt> command.</p>
|
al@811
|
537
|
al@811
|
538 <pre>
|
al@811
|
539 # tazpkg get <em>grub</em>
|
al@811
|
540 # tazpkg get <em>nano</em> --root=<em>/mnt/sda6</em>
|
al@844
|
541 # tazpkg get <em>palemoon</em> --extra
|
al@844
|
542 # tazpkg -g <em>nano mc</em>
|
al@844
|
543 # tazpkg -g --list=<em>/tmp/office</em>
|
pankso@302
|
544 </pre>
|
al@844
|
545 </article>
|
pankso@467
|
546
|
al@571
|
547
|
al@844
|
548 <article id="install"><h3>install</h3>
|
al@571
|
549
|
al@844
|
550 <p>This command allows the installation of a local package with the <tt>.tazpkg</tt> extension
|
al@844
|
551 (<tt>install</tt> or <tt>-i</tt>).</p>
|
al@844
|
552
|
al@844
|
553 <p>Option <tt>--forced</tt> allows you to update an already installed package. Option
|
al@844
|
554 <tt>--newconf</tt> allows you to rewrite all user configuration files using the new files from a
|
al@844
|
555 package. Option <tt>--nodeps</tt> allows you to install only a specified package without its
|
al@844
|
556 dependencies.</p>
|
al@844
|
557
|
paul@848
|
558 <p>When TazPkg installs package dependencies, it prefers local packages (i.e. dependent packages
|
paul@848
|
559 located in the same folder as installed packages) over mirrored/cached packages with the <tt>--local</tt> option.
|
paul@848
|
560 It is useful when you want to install a lot of already downloaded packages and their dependencies
|
paul@848
|
561 without the need of a network connection.</p>
|
al@847
|
562
|
al@844
|
563 <p>You can specify multiple packages on the command line or give tazpkg a list of the packages you
|
al@844
|
564 want to install or use <tt><a href="#get-list">install-list</a></tt> command.</p>
|
al@844
|
565
|
al@844
|
566 <p>See <tt><a href="#get-install">get-install</a></tt> to install a package from the internet.</p>
|
al@811
|
567
|
pankso@302
|
568 <pre>
|
al@571
|
569 # tazpkg install <em>package-1.0.tazpkg</em>
|
al@811
|
570 # tazpkg -i <em>path/to/package-1.0.tazpkg</em> --forced
|
al@811
|
571 # tazpkg -i <em>path/to/package-1.0.tazpkg</em> --root=<em>/mnt/rootfs</em>
|
al@844
|
572 # tazpkg -i <em>nano-2.4.0.tazpkg mc-4.8.14.tazpkg</em>
|
al@844
|
573 # tazpkg -i --list=<em>/tmp/development</em>
|
al@847
|
574 # cd <em>/home/boot/packages</em>; tazpkg -i <em>nano-2.4.0.tazpkg</em> --local
|
pankso@302
|
575 </pre>
|
al@844
|
576 </article>
|
pankso@467
|
577
|
al@571
|
578
|
al@844
|
579 <article id="get-install"><h3>get-install</h3>
|
al@811
|
580
|
al@844
|
581 <p>Get and install a package from a mirror on the internet (<tt>get-install</tt> or <tt>-gi</tt>).
|
al@844
|
582 Command begins by checking whether the package exists on the mirror and if it has been already
|
al@844
|
583 downloaded.</p>
|
al@844
|
584
|
al@844
|
585 <p>Option <tt>--forced</tt> allows you to update an already installed package. Option
|
al@844
|
586 <tt>--newconf</tt> allows you to rewrite all user configuration files using the new files from a
|
al@844
|
587 package. Option <tt>--nodeps</tt> allows you to install only a specified package without its
|
al@844
|
588 dependencies.</p>
|
al@844
|
589
|
al@844
|
590 <p>You can specify multiple packages on the command line or give tazpkg a list of the packages you
|
al@844
|
591 want to get and install or use <tt><a href="#get-list">get-install-list</a></tt>
|
al@844
|
592 command.</p>
|
al@844
|
593
|
al@844
|
594 <p>For a list of packages on the mirror, you must use the <tt><a
|
al@844
|
595 href="#list-mirror">list-mirror</a></tt> command.</p>
|
al@811
|
596
|
al@811
|
597 <pre>
|
al@811
|
598 # tazpkg get-install <em>grub</em>
|
al@811
|
599 # tazpkg -gi <em>grub</em> --forced
|
al@811
|
600 # tazpkg -gi <em>nano</em> --root=<em>/mnt/sda6</em>
|
al@844
|
601 # tazpkg -gi <em>nano mc</em>
|
al@844
|
602 # tazpkg -gi --list=<em>/tmp/multimedia</em>
|
al@811
|
603 </pre>
|
al@844
|
604 </article>
|
al@811
|
605
|
al@811
|
606
|
al@844
|
607 <article id="get-list"><h3>get-list, install-list, get-install-list</h3>
|
al@811
|
608
|
al@844
|
609 <p>Get and/or install a set of packages listed in a file. This command allows you to work with the
|
al@844
|
610 several packages with a single command.</p>
|
al@844
|
611
|
al@844
|
612 <p>All options are the same as for respective simple commands: <tt><a href="#get">get</a></tt>,
|
al@844
|
613 <tt><a href="#install">install</a></tt> and <tt><a href="#get-install">get-install</a></tt>.</p>
|
al@811
|
614
|
al@633
|
615 <pre>
|
al@633
|
616 # tazpkg install-list <em>my-packages.list</em>
|
al@571
|
617 # tazpkg get-install-list <em>my-packages.list</em> --forced
|
pankso@302
|
618 </pre>
|
al@844
|
619 </article>
|
pankso@467
|
620
|
al@571
|
621
|
al@844
|
622 <article id="remove"><h3>remove</h3>
|
al@811
|
623
|
al@844
|
624 <p>Remove a package (<tt>remove</tt> or <tt>-r</tt>). You will be asked for confirmation (y/N) of
|
al@844
|
625 removing the package, as well as for removing packages depending on this package, and for
|
al@844
|
626 reinstalling packages modified by this package. This command will delete all files installed with
|
al@844
|
627 the package.</p>
|
al@811
|
628
|
al@844
|
629 <p>Option <tt>--auto</tt> removes and reinstalls packages without your confirmation.</p>
|
al@811
|
630
|
al@811
|
631 <pre>
|
al@811
|
632 # tazpkg remove <em>bc</em>
|
al@811
|
633 # tazpkg -r <em>gtk+-3</em> --root=<em>/mnt/sda6</em>
|
al@811
|
634 # tazpkg -r <em>nano</em> --auto
|
al@811
|
635 </pre>
|
al@844
|
636 </article>
|
al@811
|
637
|
al@811
|
638
|
al@844
|
639 <article id="reconfigure"><h3>reconfigure</h3>
|
al@811
|
640
|
al@811
|
641 <p>Replays the post-install script from the package.</p>
|
al@811
|
642
|
al@811
|
643 <pre>
|
al@811
|
644 # tazpkg reconfigure <em>gcc</em>
|
al@811
|
645 # tazpkg reconfigure <em>gcc</em> --root=<em>/mnt/sda6</em>
|
al@811
|
646 </pre>
|
al@844
|
647 </article>
|
al@811
|
648
|
al@811
|
649
|
al@844
|
650 <article id="link"><h3>link</h3>
|
al@571
|
651
|
al@844
|
652 <p>This command allows the installation of a package from another media device. The set up is done
|
al@844
|
653 through symbolic links and consumes very little memory. It is generally used within the system RAM
|
al@844
|
654 to install add-ons from a USB key.</p>
|
al@811
|
655
|
pankso@302
|
656 <pre>
|
al@571
|
657 # tazpkg link <em>openoffice /media/usbdisk</em>
|
pankso@302
|
658 </pre>
|
al@844
|
659 </article>
|
pankso@467
|
660
|
al@571
|
661
|
al@844
|
662 <article id="set-release"><h3>set-release</h3>
|
al@571
|
663
|
al@844
|
664 <p>This command changes the current version and upgrades all of the packages to the latest
|
al@844
|
665 release.</p>
|
al@811
|
666
|
pankso@302
|
667 <pre>
|
al@811
|
668 # tazpkg set-release <em>cooking</em>
|
pankso@302
|
669 </pre>
|
al@844
|
670 </article>
|
pankso@467
|
671
|
al@571
|
672
|
al@844
|
673 <article id="add-flavor"><h3>add-flavor, install-flavor</h3>
|
al@571
|
674
|
al@844
|
675 <p>Install a set of packages from a flavor. In addition, <tt>install-flavor</tt> purges other
|
al@844
|
676 installed packages.</p>
|
al@811
|
677
|
pankso@302
|
678 <pre>
|
al@811
|
679 # tazpkg add-flavor <em>gtkonly</em>
|
al@811
|
680 # tazpkg install-flavor <em>justx</em>
|
pankso@302
|
681 </pre>
|
al@844
|
682 </article>
|
al@844
|
683 </section>
|
pankso@467
|
684
|
al@571
|
685
|
al@571
|
686
|
al@811
|
687
|
al@844
|
688 <section><header>Working with packages</header>
|
al@811
|
689
|
al@811
|
690
|
al@844
|
691 <article id="info"><h3>info</h3>
|
al@811
|
692
|
al@844
|
693 <p>Show all the available information related to your package. You can specify the name of the
|
al@844
|
694 installed package or a package that is not yet installed, but available in the repository. You can
|
al@844
|
695 also get information about a local file package by entering an absolute or relative path to the file
|
al@844
|
696 <tt>.tazpkg</tt>. The information contained in the TazPkg database and in the package recipe — its
|
al@844
|
697 version, category, maintainer, Web site and all the dependencies (see also <a
|
al@844
|
698 href="../cookutils/cookutils.en.html" target="_blank">Cookutils</a> for more information on
|
al@844
|
699 recipes).</p>
|
al@811
|
700
|
pankso@302
|
701 <pre>
|
al@811
|
702 $ tazpkg info <em>busybox</em>
|
al@828
|
703 $ tazpkg info <em>minitube</em>
|
al@828
|
704 $ tazpkg info <em>packages/comix-4.0.4.tazpkg</em>
|
pankso@302
|
705 </pre>
|
al@844
|
706 </article>
|
pankso@467
|
707
|
al@571
|
708
|
al@844
|
709 <article id="desc"><h3>desc</h3>
|
al@571
|
710
|
al@844
|
711 <p>Description of the package (<tt>desc</tt> or <tt>-d</tt>).</p>
|
al@811
|
712
|
pankso@302
|
713 <pre>
|
al@811
|
714 $ tazpkg desc <em>busybox</em>
|
pankso@302
|
715 </pre>
|
al@844
|
716 </article>
|
pankso@467
|
717
|
al@571
|
718
|
al@844
|
719 <article id="list-files"><h3>list-files</h3>
|
al@571
|
720
|
al@844
|
721 <p>List all files installed with a package (<tt>list-files</tt> or <tt>-lf</tt>). This command will
|
al@844
|
722 simply read and display the <tt>files.list</tt> of each package which is automatically generated
|
al@844
|
723 when the package is created and is also used to remove files when uninstalling a package.</p>
|
al@811
|
724
|
pankso@467
|
725 <pre>
|
al@811
|
726 $ tazpkg list-files <em>bc</em>
|
pankso@302
|
727 </pre>
|
al@844
|
728 </article>
|
pankso@467
|
729
|
al@571
|
730
|
al@844
|
731 <article id="block"><h3>block, unblock, chblock</h3>
|
al@571
|
732
|
al@844
|
733 <p>The <tt>block</tt> (or <tt>-b</tt>) and <tt>unblock</tt> (or <tt>-u</tt>) commands permit you to
|
al@844
|
734 block installed package versions so that they are not maintained by an <tt><a
|
al@844
|
735 href="#upgrade">upgrade</a></tt>. Command <tt>chblock</tt> changes the blocking state of the
|
al@844
|
736 package. The list of packages on hold are contained in the
|
al@844
|
737 <tt>/var/lib/tazpkg/blocked-packages.list</tt>. This file can also be edited by hand.</p>
|
al@811
|
738
|
pankso@302
|
739 <pre>
|
al@811
|
740 # tazpkg block <em>grub</em>
|
al@811
|
741 # tazpkg unblock <em>grub</em>
|
al@811
|
742 # tazpkg chblock <em>grub</em>
|
pankso@302
|
743 </pre>
|
al@844
|
744 </article>
|
pankso@467
|
745
|
al@571
|
746
|
al@844
|
747 <article id="check"><h3>check</h3>
|
al@571
|
748
|
al@844
|
749 <p>Check dependencies on installed packages and determine whether all the files needed for the
|
al@844
|
750 repacking of packages are present. You can specify package name to check or check all installed
|
al@844
|
751 packages. Option <tt>--full</tt> makes few more checks and need more time.</p>
|
al@811
|
752
|
pankso@302
|
753 <pre>
|
al@811
|
754 $ tazpkg check
|
al@811
|
755 $ tazpkg check --full
|
al@811
|
756 $ tazpkg check <em>nano</em>
|
al@811
|
757 $ tazpkg check <em>sakura</em> --full
|
pankso@302
|
758 </pre>
|
al@844
|
759 </article>
|
pankso@467
|
760
|
al@571
|
761
|
al@844
|
762 <article id="bugs"><h3>bugs</h3>
|
al@571
|
763
|
al@844
|
764 <p>Generates a list of known bugs in the packages. You can specify a single package to show
|
al@844
|
765 bugs.</p>
|
al@811
|
766
|
pankso@302
|
767 <pre>
|
al@811
|
768 $ tazpkg bugs
|
al@844
|
769 $ tazpkg bugs <em>nano</em>
|
pankso@302
|
770 </pre>
|
al@844
|
771 </article>
|
pankso@467
|
772
|
al@571
|
773
|
al@844
|
774 <article id="depends"><h3>depends, rdepends</h3>
|
al@571
|
775
|
al@811
|
776 <p>Displays a dependency tree or reverse dependency tree for a package.</p>
|
pankso@467
|
777
|
al@844
|
778 <p>For <code>depends</code> command: option <tt>--mark</tt> marks installed packages with plus sign
|
al@844
|
779 and not installed with a minus/dash. Option <tt>--total</tt> calculates the number of displayed
|
al@844
|
780 packages and their size. Also, with both options at a time you'll get the number and size of
|
al@844
|
781 packages to be installed.</p>
|
al@828
|
782
|
al@844
|
783 <p>For <code>rdepends</code> command: <em>without</em> the <tt>--all</tt> option you'll get the list
|
al@844
|
784 of only installed reverse dependency packages, <em>with</em> this option — a list of all available
|
al@844
|
785 packages. Option <tt>--mark</tt> marks packages as in the <code>depends</code> command.</p>
|
al@828
|
786
|
pankso@467
|
787 <pre>
|
al@844
|
788 $ tazpkg depends <em>mpd</em>
|
al@844
|
789 $ tazpkg rdepends <em>mpd</em>
|
pankso@302
|
790 </pre>
|
al@844
|
791 </article>
|
al@571
|
792
|
al@571
|
793
|
al@844
|
794 <article id="extract"><h3>extract</h3>
|
al@571
|
795
|
al@844
|
796 <p>Extract a package into a directory (<tt>extract</tt> or <tt>-e</tt>). If you do not specify the
|
al@844
|
797 destination directory, the package will be extracted in the current directory using the name
|
al@844
|
798 <tt><em>package-version</em></tt>.</p>
|
al@811
|
799
|
al@811
|
800 <pre>
|
al@811
|
801 $ tazpkg extract <em>package.tazpkg</em>
|
al@811
|
802 $ tazpkg extract <em>package.tazpkg target/dir</em>
|
al@811
|
803 </pre>
|
al@844
|
804 </article>
|
al@811
|
805
|
al@811
|
806
|
al@844
|
807 <article id="pack"><h3>pack</h3>
|
al@811
|
808
|
al@844
|
809 <p>Create a package from a directory prepared in advance or from an unpacked package. It can also
|
al@844
|
810 manually create a <tt>.tazpkg</tt> package (see the <a href="../cookutils/cookutils.en.html"
|
al@844
|
811 target="_blank">Cookutils</a> documentation for the automatic creation of packages).</p>
|
al@811
|
812
|
al@811
|
813 <pre>
|
al@811
|
814 # tazpkg pack <em>package-version</em>
|
al@811
|
815 </pre>
|
al@844
|
816 </article>
|
al@811
|
817
|
al@811
|
818
|
al@844
|
819 <article id="repack"><h3>repack</h3>
|
al@811
|
820
|
al@844
|
821 <p>Recreate a package from the files on a system where it was previously installed.</p>
|
al@811
|
822
|
al@811
|
823 <pre>
|
al@844
|
824 # tazpkg repack <em>package</em>
|
al@811
|
825 </pre>
|
al@844
|
826 </article>
|
al@811
|
827
|
al@811
|
828
|
al@844
|
829 <article id="repack-config"><h3>repack-config</h3>
|
al@811
|
830
|
al@844
|
831 <p>Recreate a package of the system configuration files (see <tt><a
|
al@844
|
832 href="#list-config">list-config</a></tt>). It is enough to install the package to find the current
|
al@844
|
833 configuration.</p>
|
al@811
|
834
|
al@811
|
835 <pre>
|
al@811
|
836 # tazpkg repack-config
|
al@811
|
837 </pre>
|
al@844
|
838 </article>
|
al@811
|
839
|
al@811
|
840
|
al@844
|
841 <article id="recompress"><h3>recompress</h3>
|
al@811
|
842
|
al@844
|
843 <p>Recompress <tt>.tazpkg</tt> cpio archive with lzma.</p>
|
al@811
|
844
|
al@811
|
845 <pre>
|
al@844
|
846 # tazpkg recompress <em>package.tazpkg</em>
|
al@811
|
847 </pre>
|
al@844
|
848 </article>
|
al@811
|
849
|
al@811
|
850
|
al@844
|
851 <article id="convert"><h3>convert</h3>
|
al@811
|
852
|
al@844
|
853 <p>Converts an “alien” package into a SliTaz package (<tt>.tazpkg</tt>) (<tt>convert</tt> or
|
al@844
|
854 <tt>-c</tt>).</p>
|
al@811
|
855
|
al@811
|
856 <p>Supported packages formats:</p>
|
al@811
|
857
|
al@811
|
858 <ul>
|
al@844
|
859 <li><a href="https://packages.debian.org/search" target="_blank">Debian packages</a>
|
al@844
|
860 (<tt>*.deb</tt>, <tt>*.udeb</tt>)</li>
|
al@844
|
861 <li><a href="http://rpmfind.net/linux/rpm2html/search.php" target="_blank">RPM packages</a>
|
al@844
|
862 (<tt>*.rpm</tt>)</li>
|
al@811
|
863 <li><a href="http://www.slax.org/" target="_blank">Slax packages</a>
|
al@811
|
864 (<tt>*.sb</tt>)</li>
|
al@811
|
865 <li><a href="http://puppylinux.org/" target="_blank">Puppy packages</a>
|
al@811
|
866 (<tt>*.sfs</tt>, <tt>*.pet</tt>)</li>
|
al@844
|
867 <li><a href="http://www.slackware.com/packages/" target="_blank">Slackware packages</a>
|
al@844
|
868 (<tt>*.tgz</tt>)</li>
|
al@811
|
869 <li><a href="http://www.nutyx.org/" target="_blank">NuTyX packages</a>
|
al@811
|
870 (<tt>*.cards.tar.xz</tt>)</li>
|
al@844
|
871 <li><a href="https://www.archlinux.org/packages/" target="_blank">Arch Linux</a> /
|
al@844
|
872 <a href="http://pkgs.alpinelinux.org/packages" target="_blank">Alpine Linux packages</a>
|
al@844
|
873 (<tt>*.apk</tt>, <tt>*.pkg.tar.gz</tt>, <tt>*.pkg.tar.xz</tt>)</li>
|
al@844
|
874 <li><a href="http://wiki.openwrt.org/doc/packages" target="_blank">OpenWrt packages</a>
|
al@844
|
875 (<tt>*.ipk</tt>, <tt>*.opk</tt>)</li>
|
al@844
|
876 <li><a href="http://0.tuxfamily.org/doku.php/paquets/start" target="_blank">0Linux packages</a>
|
al@844
|
877 (<tt>*.spack</tt>)</li>
|
al@844
|
878 <li><a href="http://www.paldo.org/index-section-packages.html" target="_blank">paldo packages</a>
|
al@844
|
879 (<tt>*.tar.bz2</tt>)</li>
|
al@844
|
880 <li><a href="http://www.voidlinux.eu/packages/" target="_blank">Void packages</a>
|
al@844
|
881 (<tt>*.xbps</tt>)</li>
|
al@844
|
882 <li><a href="http://tinycorelinux.net/" target="_blank">Tinycore packages</a>
|
al@844
|
883 (<tt>*.tce</tt>, <tt>*.tcel</tt>, <tt>*.tcem</tt>, <tt>*.tcz</tt>)</li>
|
al@811
|
884 </ul>
|
al@811
|
885
|
al@811
|
886 <pre>
|
al@811
|
887 # tazpkg convert <em>alien-package-file</em>
|
al@811
|
888 </pre>
|
al@844
|
889 </article>
|
al@811
|
890
|
al@811
|
891
|
al@844
|
892 <article id="list-suggested"><h3>list-suggested</h3>
|
al@811
|
893
|
al@844
|
894 <p>List suggested packages for each of your installed packages. With option <tt>--all</tt> it shows
|
al@844
|
895 all suggested packages, and without option it shows only non installed suggested packages.</p>
|
al@811
|
896
|
al@811
|
897 <pre>
|
al@811
|
898 $ tazpkg list-suggested
|
al@811
|
899 $ tazpkg list-suggested --all
|
al@811
|
900 </pre>
|
al@844
|
901 </article>
|
al@844
|
902 </section>
|
al@811
|
903
|
al@811
|
904
|
al@811
|
905
|
al@811
|
906
|
al@844
|
907 <section><header>Working with repositories</header>
|
al@811
|
908
|
al@811
|
909
|
al@844
|
910 <article id="recharge"><h3>recharge</h3>
|
al@811
|
911
|
al@844
|
912 <p>Recharge the list of available packages on the mirror. This command will download the most recent
|
al@844
|
913 packages database of installable packages on the mirror and before starting will save the old
|
al@844
|
914 database. Once the DB is updated, you can then use the <tt><a href="#list">list</a></tt> and
|
al@844
|
915 <tt><a href="#search">search</a></tt> commands. To view and list the differences, you can use
|
al@844
|
916 <code>list-mirror --diff</code>; and to view and update packages, you can simply
|
al@844
|
917 <tt><a href="#upgrade">upgrade</a></tt>.</p>
|
al@811
|
918
|
al@844
|
919 <p>Command without options will recharge databases of all your repositories. You can specify the
|
al@844
|
920 repository to be recharged: “main” for main repo, or undigest repository name.</p>
|
al@811
|
921
|
al@811
|
922 <pre>
|
al@811
|
923 # tazpkg recharge
|
al@811
|
924 # tazpkg recharge main
|
al@811
|
925 # tazpkg recharge <em>My_Undigest</em>
|
al@811
|
926 # tazpkg recharge --root=<em>/mnt/sda6</em>
|
al@811
|
927 </pre>
|
al@844
|
928 </article>
|
al@811
|
929
|
al@811
|
930
|
al@844
|
931 <article id="upgrade"><h3>upgrade</h3>
|
al@811
|
932
|
al@844
|
933 <p>Upgrade allows you to update all installed packages available on the current mirror
|
al@844
|
934 (<tt>upgrade</tt> or <tt>up</tt>). Upgrading packages is an important part of system security, it
|
al@844
|
935 helps to keep you secure with the latest updates and fixes. The SliTaz project, although tiny,
|
al@844
|
936 provides regular updates on security and generally offers the latest versions of software. Note that
|
al@844
|
937 this function is aimed at people with SliTaz installed on a hard drive. Updated packages in Live CD
|
al@844
|
938 mode will be lost on system shutdown.</p>
|
al@811
|
939
|
al@828
|
940 <p>At the beginning the packages database is updated automatically (<tt><a
|
al@844
|
941 href="#recharge">recharge</a></tt>) in order to provide you with the current list of packages that
|
al@844
|
942 you can update.</p>
|
al@828
|
943
|
al@844
|
944 <p>Without options it runs in interactive mode and asks before install. You can specify one of the
|
al@844
|
945 next options: <tt>-c</tt> or <tt>--check</tt> to check only for available upgrades; <tt>-i</tt> or
|
al@844
|
946 <tt>--install</tt> to check for upgrades and install them all.</p>
|
al@811
|
947
|
al@811
|
948 <pre>
|
al@811
|
949 # tazpkg upgrade
|
al@828
|
950 # tazpkg up --check
|
al@828
|
951 # tazpkg up -i
|
al@811
|
952 </pre>
|
al@844
|
953 </article>
|
al@811
|
954
|
al@811
|
955
|
al@844
|
956 <article id="setup-mirror"><h3>setup-mirror</h3>
|
al@811
|
957
|
al@844
|
958 <p>Setup the URL for the mirror (<tt>setup-mirror</tt> or <tt>-sm</tt>). Command will ask for the
|
al@844
|
959 URL of the new mirror. Note that you can also modify the main <tt>/var/lib/tazpkg/mirror</tt> file.
|
al@844
|
960 The URL must point to the directory containing the <tt>packages.info</tt> and packages.</p>
|
al@811
|
961
|
al@811
|
962 <pre>
|
al@811
|
963 # tazpkg setup-mirror
|
al@811
|
964 </pre>
|
al@844
|
965 </article>
|
al@811
|
966
|
al@811
|
967
|
al@844
|
968 <article id="add-undigest"><h3>add-undigest, setup-undigest</h3>
|
al@811
|
969
|
al@844
|
970 <p>Set the URL of an additional unofficial mirror to test packages that are not yet present on the
|
al@844
|
971 official mirrors. Note, you can also manually edit the file in
|
al@844
|
972 <tt>/var/lib/tazpkg/undigest/<em>repository</em></tt>. The URL must point to the directory
|
al@844
|
973 containing the packages and <tt>packages.info</tt>.</p>
|
al@811
|
974
|
pankso@302
|
975 <pre>
|
al@571
|
976 # tazpkg add-undigest <em>public-repository http://my.home.org/slitaz</em>
|
al@571
|
977 # tazpkg setup-undigest <em>local-repository /home/slitaz/packages</em>
|
pankso@302
|
978 </pre>
|
al@844
|
979 </article>
|
pankso@467
|
980
|
al@571
|
981
|
al@844
|
982 <article id="list-undigest"><h3>list-undigest</h3>
|
al@811
|
983
|
al@844
|
984 <p>Lists additional undigest mirrors. Option <tt>--box</tt> will output list in the table form.</p>
|
al@811
|
985
|
al@811
|
986 <pre>
|
al@844
|
987 $ tazpkg list-undigest
|
al@844
|
988 $ tazpkg list-undigest --box
|
al@811
|
989 </pre>
|
al@844
|
990 </article>
|
al@811
|
991
|
al@811
|
992
|
al@844
|
993 <article id="remove-undigest"><h3>remove-undigest</h3>
|
al@571
|
994
|
al@844
|
995 <p>Removes the URL of an undigest mirror. You will be asked for confirmation.</p>
|
al@811
|
996
|
pankso@302
|
997 <pre>
|
al@571
|
998 # tazpkg remove-undigest <em>my-repository</em>
|
pankso@302
|
999 </pre>
|
al@844
|
1000 </article>
|
al@847
|
1001
|
al@847
|
1002
|
al@847
|
1003 <article id="mkdb"><h3>mkdb</h3>
|
al@847
|
1004
|
paul@848
|
1005 <p>Make a TazPkg database for a selected folder with *.tazpkg packages.</p>
|
al@847
|
1006
|
paul@848
|
1007 <p>The following files describing packages will be created inside the selected folder: <tt>packages.info</tt>,
|
al@847
|
1008 <tt>packages.equiv</tt>, <tt>descriptions.txt</tt>, <tt>files.list.lzma</tt>, <tt>IDs</tt>.
|
paul@848
|
1009 Do nothing if the database already exists; you can also force database files rebuilding with the
|
al@847
|
1010 <tt>--forced</tt> option.</p>
|
al@847
|
1011
|
al@847
|
1012 <pre>
|
al@847
|
1013 # tazpkg mkdb <em>/home/boot/packages</em>
|
al@847
|
1014 # tazpkg mkdb <em>/home/boot/packages</em> --forced
|
al@847
|
1015 </pre>
|
al@847
|
1016 </article>
|
al@844
|
1017 </section>
|
pankso@467
|
1018
|
al@571
|
1019
|
al@571
|
1020
|
pankso@302
|
1021
|
al@844
|
1022 <section><header>Maintainer</header>
|
al@811
|
1023
|
al@811
|
1024 <p>Christophe Lincoln <pankso at slitaz.org></p>
|
al@844
|
1025 </section>
|
pankso@302
|
1026
|
al@844
|
1027
|
al@844
|
1028
|
al@828
|
1029
|
al@828
|
1030 <footer>
|
pascal@952
|
1031 Copyright © <span class="year"></span> <a href="http://www.slitaz.org/en/">SliTaz GNU/Linux</a>
|
al@828
|
1032 </footer>
|
al@828
|
1033
|
pankso@302
|
1034 </body>
|
pankso@302
|
1035 </html>
|