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>
|
al@844
|
60 <li><tt>root</tt>: if defined it points to the root of file system where TazPkg should work.
|
al@844
|
61 Note, 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@844
|
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
|
al@844
|
170 repository and all existing undigest repositories in the 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"
|
al@828
|
208 target="_blank">/var/log/slitaz/tazpkg.log</a></tt> stores 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
|
al@844
|
241 <p>You can add global option <tt>--root=…</tt> to any TazPkg command. This option allows to work
|
al@844
|
242 with other SliTaz installations. Option points to the root of mounted file system from other 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
|
al@844
|
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@811
|
256 <li><a href="#shell">shell</a>: run interactive TazPkg shell</li>
|
al@811
|
257 </ul>
|
al@844
|
258 </article>
|
al@811
|
259
|
al@811
|
260
|
al@844
|
261 <article><header>Working with lists</header>
|
al@811
|
262
|
al@811
|
263 <ul>
|
al@811
|
264 <li><a href="#list">list</a>: list installed packages on the system</li>
|
al@844
|
265 <li><a href="#list-mirror">list-mirror</a>: list all available packages on the mirror</li>
|
al@844
|
266 <li><a href="#list-config">list-config</a>: list the configuration files</li>
|
al@811
|
267 </ul>
|
al@844
|
268 </article>
|
al@811
|
269
|
al@811
|
270
|
al@844
|
271 <article><header>Search</header>
|
al@811
|
272
|
al@811
|
273 <ul>
|
al@844
|
274 <li><a href="#search">search</a>: search for a package by pattern or name</li>
|
al@844
|
275 <li><a href="#search-pkgname">search-pkgname</a>: search on mirror for package having a
|
al@844
|
276 particular file</li>
|
al@844
|
277 <li><a href="#search-file">search-file</a>: search for file in all installed packages files</li>
|
al@811
|
278 </ul>
|
al@844
|
279 </article>
|
al@811
|
280
|
al@811
|
281
|
al@844
|
282 <article><header>Installing and removing packages</header>
|
al@811
|
283
|
al@811
|
284 <ul>
|
al@844
|
285 <li><a href="#get">get</a>: download a package into the current directory</li>
|
al@811
|
286 <li><a href="#install">install</a>: install a local package</li>
|
al@844
|
287 <li><a href="#get-install">get-install</a>: download and install a package from the mirror</li>
|
al@844
|
288 <li><a href="#get-list">get-list</a>: download a list of packages from the mirror</li>
|
al@844
|
289 <li><a href="#get-list">install-list</a>: install all packages from a list of packages</li>
|
al@844
|
290 <li><a href="#get-list">get-install-list</a>: download and install a list of packages from the
|
al@844
|
291 mirror</li>
|
al@844
|
292 <li><a href="#remove">remove</a>: remove the specified package and all installed files</li>
|
al@844
|
293 <li><a href="#reconfigure">reconfigure</a>: replay post install script from package</li>
|
al@844
|
294 <li><a href="#link">link</a>: link a package from another SliTaz installation</li>
|
al@844
|
295 <li><a href="#set-release">set-release</a>: change release and update packages</li>
|
al@844
|
296 <li><a href="#add-flavor">add-flavor</a>: install the flavor list of packages</li>
|
al@844
|
297 <li><a href="#add-flavor">install-flavor</a>: install the flavor list of packages and remove
|
al@844
|
298 other ones</li>
|
al@811
|
299 </ul>
|
al@844
|
300 </article>
|
al@811
|
301
|
al@811
|
302
|
al@844
|
303 <article><header>Working with packages</header>
|
al@811
|
304
|
al@811
|
305 <ul>
|
al@811
|
306 <li><a href="#info">info</a>: print information about a package</li>
|
al@811
|
307 <li><a href="#desc">desc</a>: print description of a package</li>
|
al@844
|
308 <li><a href="#list-files">list-files</a>: list the files installed with a package</li>
|
al@844
|
309 <li><a href="#block">block, unblock</a>: block an installed package version or unblock it for
|
al@844
|
310 upgrade</li>
|
al@844
|
311 <li><a href="#check">check</a>: verify consistency of installed packages</li>
|
al@811
|
312 <li><a href="#bugs">bugs</a>: show known bugs in packages</li>
|
al@811
|
313 <li><a href="#depends">depends</a>: display dependencies tree</li>
|
al@811
|
314 <li><a href="#depends">rdepends</a>: display reverse dependencies tree</li>
|
al@844
|
315 <li><a href="#extract">extract</a>: extract a (*.tazpkg) package into a directory</li>
|
al@811
|
316 <li><a href="#pack">pack</a>: pack an unpacked or prepared package tree</li>
|
al@844
|
317 <li><a href="#repack">repack</a>: create a package archive from an installed package</li>
|
al@844
|
318 <li><a href="#repack-config">repack-config</a>: create a package archive with configuration
|
al@844
|
319 files</li>
|
al@844
|
320 <li><a href="#recompress">recompress</a>: rebuild a package with a better compression ratio</li>
|
al@811
|
321 <li><a href="#convert">convert</a>: convert alien package to tazpkg</li>
|
al@844
|
322 <li><a href="#list-suggested">list-suggested</a>: print list of suggested packages</li>
|
al@811
|
323 </ul>
|
al@844
|
324 </article>
|
al@811
|
325
|
al@811
|
326
|
al@844
|
327 <article><header>Working with repositories</header>
|
al@811
|
328
|
al@811
|
329 <ul>
|
al@844
|
330 <li><a href="#recharge">recharge</a>: recharge your packages database from the mirror</li>
|
al@844
|
331 <li><a href="#upgrade">upgrade</a>: check packages, list and install latest upgrades</li>
|
al@844
|
332 <li><a href="#setup-mirror">setup-mirror</a>: change the mirror URL configuration</li>
|
al@844
|
333 <li><a href="#add-undigest">setup-undigest</a>: update an undigest mirror</li>
|
al@811
|
334 <li><a href="#list-undigest">list-undigest</a>: list undigest mirrors</li>
|
al@811
|
335 <li><a href="#add-undigest">add-undigest</a>: add an undigest mirror</li>
|
al@844
|
336 <li><a href="#remove-undigest">remove-undigest</a>: remove an undigest mirror</li>
|
al@847
|
337 <li><a href="#mkdb">mkdb</a>: make TazPkg database for folder with *.tazpkg packages</li>
|
al@811
|
338 </ul>
|
al@844
|
339 </article>
|
al@844
|
340 </section>
|
al@811
|
341
|
al@811
|
342
|
al@811
|
343
|
al@811
|
344
|
al@844
|
345 <section><header>Service commands</header>
|
al@811
|
346
|
al@811
|
347
|
al@844
|
348 <article id="usage"><h3>usage</h3>
|
al@811
|
349
|
al@811
|
350 <p>Show the full list of the TazPkg commands with a brief description.</p>
|
al@811
|
351
|
al@811
|
352 <pre>
|
al@811
|
353 $ tazpkg usage
|
al@811
|
354 </pre>
|
al@844
|
355 </article>
|
al@811
|
356
|
al@811
|
357
|
al@844
|
358 <article id="help"><h3>help</h3>
|
al@811
|
359
|
al@844
|
360 <p>Display help for the selected command (<tt>help</tt> or <tt>-h</tt>). You can enter a short name
|
al@844
|
361 of the command, the full name or a part of the full name. You can ignore hyphens at the beginning of
|
al@844
|
362 the short name. If the requested part of the full name match the several commands, you will be asked
|
al@844
|
363 to clarify the request.</p>
|
al@811
|
364
|
al@811
|
365 <pre>
|
al@811
|
366 $ tazpkg help <em>-gi</em>
|
al@811
|
367 $ tazpkg -h <em>us</em>
|
al@811
|
368 </pre>
|
al@844
|
369 </article>
|
al@811
|
370
|
al@811
|
371
|
al@844
|
372 <article id="activity"><h3>activity</h3>
|
al@811
|
373
|
al@844
|
374 <p>Display TazPkg activity log (<tt>activity</tt> or <tt>log</tt> or <tt>-a</tt>). Optional
|
al@844
|
375 parameter <tt>--nb=</tt> lets you set number of displayed lines.</p>
|
al@811
|
376
|
al@811
|
377 <pre>
|
al@811
|
378 $ tazpkg activity
|
al@811
|
379 $ tazpkg -a --nb=<em>20</em>
|
al@811
|
380 </pre>
|
al@844
|
381 </article>
|
al@811
|
382
|
al@811
|
383
|
al@844
|
384 <article id="clean-cache"><h3>clean-cache</h3>
|
al@811
|
385
|
al@844
|
386 <p>Remove *.tazpkg packages downloaded to the cache (<tt>clean-cache</tt> or <tt>-cc</tt>). During
|
al@844
|
387 installation, TazPkg keeps a copy of packages downloaded from the Web. This is done to save
|
al@844
|
388 bandwidth in case of reinstallation, but you may want to free up space on the hard drive or
|
al@844
|
389 re-download the packages.</p>
|
al@811
|
390
|
al@811
|
391 <pre>
|
al@811
|
392 # tazpkg clean-cache
|
al@811
|
393 # tazpkg -cc
|
al@811
|
394 </pre>
|
al@844
|
395 </article>
|
al@811
|
396
|
al@811
|
397
|
al@844
|
398 <article id="shell"><h3>shell</h3>
|
al@811
|
399
|
al@844
|
400 <p>Run interactive TazPkg shell. Here you can enter all the TazPkg commands listed above.</p>
|
al@811
|
401
|
al@811
|
402 <pre>
|
al@811
|
403 $ tazpkg shell
|
al@811
|
404 # tazpkg shell
|
al@811
|
405 </pre>
|
al@844
|
406 </article>
|
al@844
|
407 </section>
|
al@811
|
408
|
al@811
|
409
|
al@811
|
410
|
al@811
|
411
|
al@844
|
412 <section><header>Working with lists</header>
|
al@811
|
413
|
al@811
|
414
|
al@844
|
415 <article id="list"><h3>list</h3>
|
al@571
|
416
|
al@844
|
417 <p>List packages installed on the system (<tt>list</tt> or <tt>-l</tt>). This command displays a
|
al@844
|
418 column list of all installed packages. It also allows you to list the categories (<tt>c</tt> or
|
al@844
|
419 <tt>cat</tt> or <tt>categories</tt>), packages based on category and packages placed on hold
|
al@844
|
420 (<tt>b</tt> or <tt>blocked</tt>). You can also use the <tt><a href="#search">search</a></tt>
|
al@811
|
421 command for a list based on a term or package name.</p>
|
al@811
|
422
|
pankso@302
|
423 <pre>
|
al@811
|
424 $ tazpkg list
|
al@811
|
425 $ tazpkg list cat
|
al@811
|
426 $ tazpkg list <em>games</em>
|
al@811
|
427 $ tazpkg list blocked
|
pankso@302
|
428 </pre>
|
al@844
|
429 </article>
|
pankso@467
|
430
|
al@571
|
431
|
al@844
|
432 <article id="list-mirror"><h3>list-mirror</h3>
|
al@571
|
433
|
al@844
|
434 <p>List packages available on the mirror (<tt>list-mirror</tt> or <tt>-lm</tt>). This command will
|
al@844
|
435 display the packages list recharged from the mirror. If it doesn't exist, you will be asked to
|
al@844
|
436 launch <code>tazpkg <a href="#recharge">recharge</a></code> as administrator (root) for a list of
|
al@844
|
437 available packages. The <tt>--diff</tt> option is used to display the differences between the last
|
al@844
|
438 and current list of packages.</p>
|
al@811
|
439
|
pankso@302
|
440 <pre>
|
al@811
|
441 $ tazpkg list-mirror
|
al@811
|
442 $ tazpkg -lm --diff
|
pankso@302
|
443 </pre>
|
al@844
|
444 </article>
|
pankso@467
|
445
|
al@571
|
446
|
al@844
|
447 <article id="list-config"><h3>list-config</h3>
|
al@571
|
448
|
al@844
|
449 <p>Lists the system configuration files. The <tt>--box</tt> option displays in table form. You can
|
al@844
|
450 specify package name to display configuration files only for this package.</p>
|
al@811
|
451
|
al@633
|
452 <pre>
|
al@811
|
453 $ tazpkg list-config
|
al@811
|
454 $ tazpkg list-config --box
|
al@811
|
455 $ tazpkg list-config <em>slim</em>
|
al@844
|
456 $ tazpkg list-config <em>slim</em> --box
|
pankso@302
|
457 </pre>
|
al@844
|
458 </article>
|
al@844
|
459 </section>
|
pankso@467
|
460
|
al@571
|
461
|
al@571
|
462
|
al@811
|
463
|
al@844
|
464 <section><header>Search</header>
|
pankso@467
|
465
|
al@571
|
466
|
al@844
|
467 <article id="search"><h3>search</h3>
|
al@571
|
468
|
al@844
|
469 <p>Search for packages by owner or package name (<tt>search</tt> or <tt>-s</tt>). This command will
|
al@844
|
470 search for the term wanted in the installed packages (<tt>-i</tt> or <tt>--installed</tt>) and the
|
al@844
|
471 list of available packages on the mirror (<tt>-l</tt> or <tt>--list</tt>).</p>
|
al@811
|
472
|
al@844
|
473 <p>To obtain the latest list of installable packages on the mirror, just run <code>tazpkg
|
al@844
|
474 recharge</code> before conducting a search.</p>
|
al@811
|
475
|
pankso@302
|
476 <pre>
|
al@811
|
477 $ tazpkg search <em>gcc</em>
|
al@811
|
478 $ tazpkg search <em>mt</em> -i
|
al@811
|
479 $ tazpkg search <em>bit</em> -l
|
al@811
|
480 </pre>
|
al@844
|
481 </article>
|
al@811
|
482
|
al@811
|
483
|
al@844
|
484 <article id="search-pkgname"><h3>search-pkgname</h3>
|
al@811
|
485
|
al@844
|
486 <p>Search for a file on mirror and output only the packages names (<tt>search-pkgname</tt> or
|
al@844
|
487 <tt>-sp</tt>).</p>
|
al@811
|
488
|
al@811
|
489 <pre>
|
al@811
|
490 $ tazpkg search-pkgname <em>libnss</em>
|
al@811
|
491 $ tazpkg -sp <em>/usr/share/fonts</em>
|
pankso@302
|
492 </pre>
|
al@844
|
493 </article>
|
pankso@467
|
494
|
al@571
|
495
|
al@844
|
496 <article id="search-file"><h3>search-file</h3>
|
al@571
|
497
|
al@844
|
498 <p>Search for a file among the files installed by the packages (<tt>search-file</tt> or
|
al@844
|
499 <tt>-sf</tt>). This command is very useful to find the full path to a file and determine if a file
|
al@844
|
500 is present on the system. Option <tt>--mirror</tt> allows to search for a file among all the files
|
al@844
|
501 available on the mirror.</p>
|
al@811
|
502
|
pankso@302
|
503 <pre>
|
al@633
|
504 $ tazpkg search-file <em>libnss</em>
|
al@811
|
505 $ tazpkg -sf <em>/usr/share/fonts</em> --mirror
|
al@811
|
506 </pre>
|
al@844
|
507 </article>
|
al@844
|
508 </section>
|
al@811
|
509
|
al@811
|
510
|
al@811
|
511
|
al@811
|
512
|
al@844
|
513 <section><header>Installing and removing packages</header>
|
al@811
|
514
|
al@811
|
515
|
al@844
|
516 <article id="get"><h3>get</h3>
|
al@811
|
517
|
al@844
|
518 <p>Get a package from the mirror (<tt>get</tt> or <tt>-g</tt>). The downloaded package is stored in
|
al@844
|
519 the current directory. You will get regular package, or get-package, or extra-package (in that
|
al@844
|
520 order). You can specify <tt>--extra</tt> option to get an extra-package only.</p>
|
al@844
|
521
|
al@844
|
522 <p>You can specify multiple packages on the command line or give tazpkg a list of the packages you
|
al@844
|
523 want to download or use <tt><a href="#get-list">get-list</a></tt> command.</p>
|
al@811
|
524
|
al@811
|
525 <pre>
|
al@811
|
526 # tazpkg get <em>grub</em>
|
al@811
|
527 # tazpkg get <em>nano</em> --root=<em>/mnt/sda6</em>
|
al@844
|
528 # tazpkg get <em>palemoon</em> --extra
|
al@844
|
529 # tazpkg -g <em>nano mc</em>
|
al@844
|
530 # tazpkg -g --list=<em>/tmp/office</em>
|
pankso@302
|
531 </pre>
|
al@844
|
532 </article>
|
pankso@467
|
533
|
al@571
|
534
|
al@844
|
535 <article id="install"><h3>install</h3>
|
al@571
|
536
|
al@844
|
537 <p>This command allows the installation of a local package with the <tt>.tazpkg</tt> extension
|
al@844
|
538 (<tt>install</tt> or <tt>-i</tt>).</p>
|
al@844
|
539
|
al@844
|
540 <p>Option <tt>--forced</tt> allows you to update an already installed package. Option
|
al@844
|
541 <tt>--newconf</tt> allows you to rewrite all user configuration files using the new files from a
|
al@844
|
542 package. Option <tt>--nodeps</tt> allows you to install only a specified package without its
|
al@844
|
543 dependencies.</p>
|
al@844
|
544
|
al@847
|
545 <p>When TazPkg installs package dependencies, it will prefer local packages (i.e. dependent packages
|
al@847
|
546 located in the same folder as installed package) over mirrored/cached with <tt>--local</tt> option.
|
al@847
|
547 It is useful when you want to install a lot of already downloaded packages with its dependencies
|
al@847
|
548 without the need of network connection.</p>
|
al@847
|
549
|
al@844
|
550 <p>You can specify multiple packages on the command line or give tazpkg a list of the packages you
|
al@844
|
551 want to install or use <tt><a href="#get-list">install-list</a></tt> command.</p>
|
al@844
|
552
|
al@844
|
553 <p>See <tt><a href="#get-install">get-install</a></tt> to install a package from the internet.</p>
|
al@811
|
554
|
pankso@302
|
555 <pre>
|
al@571
|
556 # tazpkg install <em>package-1.0.tazpkg</em>
|
al@811
|
557 # tazpkg -i <em>path/to/package-1.0.tazpkg</em> --forced
|
al@811
|
558 # tazpkg -i <em>path/to/package-1.0.tazpkg</em> --root=<em>/mnt/rootfs</em>
|
al@844
|
559 # tazpkg -i <em>nano-2.4.0.tazpkg mc-4.8.14.tazpkg</em>
|
al@844
|
560 # tazpkg -i --list=<em>/tmp/development</em>
|
al@847
|
561 # cd <em>/home/boot/packages</em>; tazpkg -i <em>nano-2.4.0.tazpkg</em> --local
|
pankso@302
|
562 </pre>
|
al@844
|
563 </article>
|
pankso@467
|
564
|
al@571
|
565
|
al@844
|
566 <article id="get-install"><h3>get-install</h3>
|
al@811
|
567
|
al@844
|
568 <p>Get and install a package from a mirror on the internet (<tt>get-install</tt> or <tt>-gi</tt>).
|
al@844
|
569 Command begins by checking whether the package exists on the mirror and if it has been already
|
al@844
|
570 downloaded.</p>
|
al@844
|
571
|
al@844
|
572 <p>Option <tt>--forced</tt> allows you to update an already installed package. Option
|
al@844
|
573 <tt>--newconf</tt> allows you to rewrite all user configuration files using the new files from a
|
al@844
|
574 package. Option <tt>--nodeps</tt> allows you to install only a specified package without its
|
al@844
|
575 dependencies.</p>
|
al@844
|
576
|
al@844
|
577 <p>You can specify multiple packages on the command line or give tazpkg a list of the packages you
|
al@844
|
578 want to get and install or use <tt><a href="#get-list">get-install-list</a></tt>
|
al@844
|
579 command.</p>
|
al@844
|
580
|
al@844
|
581 <p>For a list of packages on the mirror, you must use the <tt><a
|
al@844
|
582 href="#list-mirror">list-mirror</a></tt> command.</p>
|
al@811
|
583
|
al@811
|
584 <pre>
|
al@811
|
585 # tazpkg get-install <em>grub</em>
|
al@811
|
586 # tazpkg -gi <em>grub</em> --forced
|
al@811
|
587 # tazpkg -gi <em>nano</em> --root=<em>/mnt/sda6</em>
|
al@844
|
588 # tazpkg -gi <em>nano mc</em>
|
al@844
|
589 # tazpkg -gi --list=<em>/tmp/multimedia</em>
|
al@811
|
590 </pre>
|
al@844
|
591 </article>
|
al@811
|
592
|
al@811
|
593
|
al@844
|
594 <article id="get-list"><h3>get-list, install-list, get-install-list</h3>
|
al@811
|
595
|
al@844
|
596 <p>Get and/or install a set of packages listed in a file. This command allows you to work with the
|
al@844
|
597 several packages with a single command.</p>
|
al@844
|
598
|
al@844
|
599 <p>All options are the same as for respective simple commands: <tt><a href="#get">get</a></tt>,
|
al@844
|
600 <tt><a href="#install">install</a></tt> and <tt><a href="#get-install">get-install</a></tt>.</p>
|
al@811
|
601
|
al@633
|
602 <pre>
|
al@633
|
603 # tazpkg install-list <em>my-packages.list</em>
|
al@571
|
604 # tazpkg get-install-list <em>my-packages.list</em> --forced
|
pankso@302
|
605 </pre>
|
al@844
|
606 </article>
|
pankso@467
|
607
|
al@571
|
608
|
al@844
|
609 <article id="remove"><h3>remove</h3>
|
al@811
|
610
|
al@844
|
611 <p>Remove a package (<tt>remove</tt> or <tt>-r</tt>). You will be asked for confirmation (y/N) of
|
al@844
|
612 removing the package, as well as for removing packages depending on this package, and for
|
al@844
|
613 reinstalling packages modified by this package. This command will delete all files installed with
|
al@844
|
614 the package.</p>
|
al@811
|
615
|
al@844
|
616 <p>Option <tt>--auto</tt> removes and reinstalls packages without your confirmation.</p>
|
al@811
|
617
|
al@811
|
618 <pre>
|
al@811
|
619 # tazpkg remove <em>bc</em>
|
al@811
|
620 # tazpkg -r <em>gtk+-3</em> --root=<em>/mnt/sda6</em>
|
al@811
|
621 # tazpkg -r <em>nano</em> --auto
|
al@811
|
622 </pre>
|
al@844
|
623 </article>
|
al@811
|
624
|
al@811
|
625
|
al@844
|
626 <article id="reconfigure"><h3>reconfigure</h3>
|
al@811
|
627
|
al@811
|
628 <p>Replays the post-install script from the package.</p>
|
al@811
|
629
|
al@811
|
630 <pre>
|
al@811
|
631 # tazpkg reconfigure <em>gcc</em>
|
al@811
|
632 # tazpkg reconfigure <em>gcc</em> --root=<em>/mnt/sda6</em>
|
al@811
|
633 </pre>
|
al@844
|
634 </article>
|
al@811
|
635
|
al@811
|
636
|
al@844
|
637 <article id="link"><h3>link</h3>
|
al@571
|
638
|
al@844
|
639 <p>This command allows the installation of a package from another media device. The set up is done
|
al@844
|
640 through symbolic links and consumes very little memory. It is generally used within the system RAM
|
al@844
|
641 to install add-ons from a USB key.</p>
|
al@811
|
642
|
pankso@302
|
643 <pre>
|
al@571
|
644 # tazpkg link <em>openoffice /media/usbdisk</em>
|
pankso@302
|
645 </pre>
|
al@844
|
646 </article>
|
pankso@467
|
647
|
al@571
|
648
|
al@844
|
649 <article id="set-release"><h3>set-release</h3>
|
al@571
|
650
|
al@844
|
651 <p>This command changes the current version and upgrades all of the packages to the latest
|
al@844
|
652 release.</p>
|
al@811
|
653
|
pankso@302
|
654 <pre>
|
al@811
|
655 # tazpkg set-release <em>cooking</em>
|
pankso@302
|
656 </pre>
|
al@844
|
657 </article>
|
pankso@467
|
658
|
al@571
|
659
|
al@844
|
660 <article id="add-flavor"><h3>add-flavor, install-flavor</h3>
|
al@571
|
661
|
al@844
|
662 <p>Install a set of packages from a flavor. In addition, <tt>install-flavor</tt> purges other
|
al@844
|
663 installed packages.</p>
|
al@811
|
664
|
pankso@302
|
665 <pre>
|
al@811
|
666 # tazpkg add-flavor <em>gtkonly</em>
|
al@811
|
667 # tazpkg install-flavor <em>justx</em>
|
pankso@302
|
668 </pre>
|
al@844
|
669 </article>
|
al@844
|
670 </section>
|
pankso@467
|
671
|
al@571
|
672
|
al@571
|
673
|
al@811
|
674
|
al@844
|
675 <section><header>Working with packages</header>
|
al@811
|
676
|
al@811
|
677
|
al@844
|
678 <article id="info"><h3>info</h3>
|
al@811
|
679
|
al@844
|
680 <p>Show all the available information related to your package. You can specify the name of the
|
al@844
|
681 installed package or a package that is not yet installed, but available in the repository. You can
|
al@844
|
682 also get information about a local file package by entering an absolute or relative path to the file
|
al@844
|
683 <tt>.tazpkg</tt>. The information contained in the TazPkg database and in the package recipe — its
|
al@844
|
684 version, category, maintainer, Web site and all the dependencies (see also <a
|
al@844
|
685 href="../cookutils/cookutils.en.html" target="_blank">Cookutils</a> for more information on
|
al@844
|
686 recipes).</p>
|
al@811
|
687
|
pankso@302
|
688 <pre>
|
al@811
|
689 $ tazpkg info <em>busybox</em>
|
al@828
|
690 $ tazpkg info <em>minitube</em>
|
al@828
|
691 $ tazpkg info <em>packages/comix-4.0.4.tazpkg</em>
|
pankso@302
|
692 </pre>
|
al@844
|
693 </article>
|
pankso@467
|
694
|
al@571
|
695
|
al@844
|
696 <article id="desc"><h3>desc</h3>
|
al@571
|
697
|
al@844
|
698 <p>Description of the package (<tt>desc</tt> or <tt>-d</tt>).</p>
|
al@811
|
699
|
pankso@302
|
700 <pre>
|
al@811
|
701 $ tazpkg desc <em>busybox</em>
|
pankso@302
|
702 </pre>
|
al@844
|
703 </article>
|
pankso@467
|
704
|
al@571
|
705
|
al@844
|
706 <article id="list-files"><h3>list-files</h3>
|
al@571
|
707
|
al@844
|
708 <p>List all files installed with a package (<tt>list-files</tt> or <tt>-lf</tt>). This command will
|
al@844
|
709 simply read and display the <tt>files.list</tt> of each package which is automatically generated
|
al@844
|
710 when the package is created and is also used to remove files when uninstalling a package.</p>
|
al@811
|
711
|
pankso@467
|
712 <pre>
|
al@811
|
713 $ tazpkg list-files <em>bc</em>
|
pankso@302
|
714 </pre>
|
al@844
|
715 </article>
|
pankso@467
|
716
|
al@571
|
717
|
al@844
|
718 <article id="block"><h3>block, unblock, chblock</h3>
|
al@571
|
719
|
al@844
|
720 <p>The <tt>block</tt> (or <tt>-b</tt>) and <tt>unblock</tt> (or <tt>-u</tt>) commands permit you to
|
al@844
|
721 block installed package versions so that they are not maintained by an <tt><a
|
al@844
|
722 href="#upgrade">upgrade</a></tt>. Command <tt>chblock</tt> changes the blocking state of the
|
al@844
|
723 package. The list of packages on hold are contained in the
|
al@844
|
724 <tt>/var/lib/tazpkg/blocked-packages.list</tt>. This file can also be edited by hand.</p>
|
al@811
|
725
|
pankso@302
|
726 <pre>
|
al@811
|
727 # tazpkg block <em>grub</em>
|
al@811
|
728 # tazpkg unblock <em>grub</em>
|
al@811
|
729 # tazpkg chblock <em>grub</em>
|
pankso@302
|
730 </pre>
|
al@844
|
731 </article>
|
pankso@467
|
732
|
al@571
|
733
|
al@844
|
734 <article id="check"><h3>check</h3>
|
al@571
|
735
|
al@844
|
736 <p>Check dependencies on installed packages and determine whether all the files needed for the
|
al@844
|
737 repacking of packages are present. You can specify package name to check or check all installed
|
al@844
|
738 packages. Option <tt>--full</tt> makes few more checks and need more time.</p>
|
al@811
|
739
|
pankso@302
|
740 <pre>
|
al@811
|
741 $ tazpkg check
|
al@811
|
742 $ tazpkg check --full
|
al@811
|
743 $ tazpkg check <em>nano</em>
|
al@811
|
744 $ tazpkg check <em>sakura</em> --full
|
pankso@302
|
745 </pre>
|
al@844
|
746 </article>
|
pankso@467
|
747
|
al@571
|
748
|
al@844
|
749 <article id="bugs"><h3>bugs</h3>
|
al@571
|
750
|
al@844
|
751 <p>Generates a list of known bugs in the packages. You can specify a single package to show
|
al@844
|
752 bugs.</p>
|
al@811
|
753
|
pankso@302
|
754 <pre>
|
al@811
|
755 $ tazpkg bugs
|
al@844
|
756 $ tazpkg bugs <em>nano</em>
|
pankso@302
|
757 </pre>
|
al@844
|
758 </article>
|
pankso@467
|
759
|
al@571
|
760
|
al@844
|
761 <article id="depends"><h3>depends, rdepends</h3>
|
al@571
|
762
|
al@811
|
763 <p>Displays a dependency tree or reverse dependency tree for a package.</p>
|
pankso@467
|
764
|
al@844
|
765 <p>For <code>depends</code> command: option <tt>--mark</tt> marks installed packages with plus sign
|
al@844
|
766 and not installed with a minus/dash. Option <tt>--total</tt> calculates the number of displayed
|
al@844
|
767 packages and their size. Also, with both options at a time you'll get the number and size of
|
al@844
|
768 packages to be installed.</p>
|
al@828
|
769
|
al@844
|
770 <p>For <code>rdepends</code> command: <em>without</em> the <tt>--all</tt> option you'll get the list
|
al@844
|
771 of only installed reverse dependency packages, <em>with</em> this option — a list of all available
|
al@844
|
772 packages. Option <tt>--mark</tt> marks packages as in the <code>depends</code> command.</p>
|
al@828
|
773
|
pankso@467
|
774 <pre>
|
al@844
|
775 $ tazpkg depends <em>mpd</em>
|
al@844
|
776 $ tazpkg rdepends <em>mpd</em>
|
pankso@302
|
777 </pre>
|
al@844
|
778 </article>
|
al@571
|
779
|
al@571
|
780
|
al@844
|
781 <article id="extract"><h3>extract</h3>
|
al@571
|
782
|
al@844
|
783 <p>Extract a package into a directory (<tt>extract</tt> or <tt>-e</tt>). If you do not specify the
|
al@844
|
784 destination directory, the package will be extracted in the current directory using the name
|
al@844
|
785 <tt><em>package-version</em></tt>.</p>
|
al@811
|
786
|
al@811
|
787 <pre>
|
al@811
|
788 $ tazpkg extract <em>package.tazpkg</em>
|
al@811
|
789 $ tazpkg extract <em>package.tazpkg target/dir</em>
|
al@811
|
790 </pre>
|
al@844
|
791 </article>
|
al@811
|
792
|
al@811
|
793
|
al@844
|
794 <article id="pack"><h3>pack</h3>
|
al@811
|
795
|
al@844
|
796 <p>Create a package from a directory prepared in advance or from an unpacked package. It can also
|
al@844
|
797 manually create a <tt>.tazpkg</tt> package (see the <a href="../cookutils/cookutils.en.html"
|
al@844
|
798 target="_blank">Cookutils</a> documentation for the automatic creation of packages).</p>
|
al@811
|
799
|
al@811
|
800 <pre>
|
al@811
|
801 # tazpkg pack <em>package-version</em>
|
al@811
|
802 </pre>
|
al@844
|
803 </article>
|
al@811
|
804
|
al@811
|
805
|
al@844
|
806 <article id="repack"><h3>repack</h3>
|
al@811
|
807
|
al@844
|
808 <p>Recreate a package from the files on a system where it was previously installed.</p>
|
al@811
|
809
|
al@811
|
810 <pre>
|
al@844
|
811 # tazpkg repack <em>package</em>
|
al@811
|
812 </pre>
|
al@844
|
813 </article>
|
al@811
|
814
|
al@811
|
815
|
al@844
|
816 <article id="repack-config"><h3>repack-config</h3>
|
al@811
|
817
|
al@844
|
818 <p>Recreate a package of the system configuration files (see <tt><a
|
al@844
|
819 href="#list-config">list-config</a></tt>). It is enough to install the package to find the current
|
al@844
|
820 configuration.</p>
|
al@811
|
821
|
al@811
|
822 <pre>
|
al@811
|
823 # tazpkg repack-config
|
al@811
|
824 </pre>
|
al@844
|
825 </article>
|
al@811
|
826
|
al@811
|
827
|
al@844
|
828 <article id="recompress"><h3>recompress</h3>
|
al@811
|
829
|
al@844
|
830 <p>Recompress <tt>.tazpkg</tt> cpio archive with lzma.</p>
|
al@811
|
831
|
al@811
|
832 <pre>
|
al@844
|
833 # tazpkg recompress <em>package.tazpkg</em>
|
al@811
|
834 </pre>
|
al@844
|
835 </article>
|
al@811
|
836
|
al@811
|
837
|
al@844
|
838 <article id="convert"><h3>convert</h3>
|
al@811
|
839
|
al@844
|
840 <p>Converts an “alien” package into a SliTaz package (<tt>.tazpkg</tt>) (<tt>convert</tt> or
|
al@844
|
841 <tt>-c</tt>).</p>
|
al@811
|
842
|
al@811
|
843 <p>Supported packages formats:</p>
|
al@811
|
844
|
al@811
|
845 <ul>
|
al@844
|
846 <li><a href="https://packages.debian.org/search" target="_blank">Debian packages</a>
|
al@844
|
847 (<tt>*.deb</tt>, <tt>*.udeb</tt>)</li>
|
al@844
|
848 <li><a href="http://rpmfind.net/linux/rpm2html/search.php" target="_blank">RPM packages</a>
|
al@844
|
849 (<tt>*.rpm</tt>)</li>
|
al@811
|
850 <li><a href="http://www.slax.org/" target="_blank">Slax packages</a>
|
al@811
|
851 (<tt>*.sb</tt>)</li>
|
al@811
|
852 <li><a href="http://puppylinux.org/" target="_blank">Puppy packages</a>
|
al@811
|
853 (<tt>*.sfs</tt>, <tt>*.pet</tt>)</li>
|
al@844
|
854 <li><a href="http://www.slackware.com/packages/" target="_blank">Slackware packages</a>
|
al@844
|
855 (<tt>*.tgz</tt>)</li>
|
al@811
|
856 <li><a href="http://www.nutyx.org/" target="_blank">NuTyX packages</a>
|
al@811
|
857 (<tt>*.cards.tar.xz</tt>)</li>
|
al@844
|
858 <li><a href="https://www.archlinux.org/packages/" target="_blank">Arch Linux</a> /
|
al@844
|
859 <a href="http://pkgs.alpinelinux.org/packages" target="_blank">Alpine Linux packages</a>
|
al@844
|
860 (<tt>*.apk</tt>, <tt>*.pkg.tar.gz</tt>, <tt>*.pkg.tar.xz</tt>)</li>
|
al@844
|
861 <li><a href="http://wiki.openwrt.org/doc/packages" target="_blank">OpenWrt packages</a>
|
al@844
|
862 (<tt>*.ipk</tt>, <tt>*.opk</tt>)</li>
|
al@844
|
863 <li><a href="http://0.tuxfamily.org/doku.php/paquets/start" target="_blank">0Linux packages</a>
|
al@844
|
864 (<tt>*.spack</tt>)</li>
|
al@844
|
865 <li><a href="http://www.paldo.org/index-section-packages.html" target="_blank">paldo packages</a>
|
al@844
|
866 (<tt>*.tar.bz2</tt>)</li>
|
al@844
|
867 <li><a href="http://www.voidlinux.eu/packages/" target="_blank">Void packages</a>
|
al@844
|
868 (<tt>*.xbps</tt>)</li>
|
al@844
|
869 <li><a href="http://tinycorelinux.net/" target="_blank">Tinycore packages</a>
|
al@844
|
870 (<tt>*.tce</tt>, <tt>*.tcel</tt>, <tt>*.tcem</tt>, <tt>*.tcz</tt>)</li>
|
al@811
|
871 </ul>
|
al@811
|
872
|
al@811
|
873 <pre>
|
al@811
|
874 # tazpkg convert <em>alien-package-file</em>
|
al@811
|
875 </pre>
|
al@844
|
876 </article>
|
al@811
|
877
|
al@811
|
878
|
al@844
|
879 <article id="list-suggested"><h3>list-suggested</h3>
|
al@811
|
880
|
al@844
|
881 <p>List suggested packages for each of your installed packages. With option <tt>--all</tt> it shows
|
al@844
|
882 all suggested packages, and without option it shows only non installed suggested packages.</p>
|
al@811
|
883
|
al@811
|
884 <pre>
|
al@811
|
885 $ tazpkg list-suggested
|
al@811
|
886 $ tazpkg list-suggested --all
|
al@811
|
887 </pre>
|
al@844
|
888 </article>
|
al@844
|
889 </section>
|
al@811
|
890
|
al@811
|
891
|
al@811
|
892
|
al@811
|
893
|
al@844
|
894 <section><header>Working with repositories</header>
|
al@811
|
895
|
al@811
|
896
|
al@844
|
897 <article id="recharge"><h3>recharge</h3>
|
al@811
|
898
|
al@844
|
899 <p>Recharge the list of available packages on the mirror. This command will download the most recent
|
al@844
|
900 packages database of installable packages on the mirror and before starting will save the old
|
al@844
|
901 database. Once the DB is updated, you can then use the <tt><a href="#list">list</a></tt> and
|
al@844
|
902 <tt><a href="#search">search</a></tt> commands. To view and list the differences, you can use
|
al@844
|
903 <code>list-mirror --diff</code>; and to view and update packages, you can simply
|
al@844
|
904 <tt><a href="#upgrade">upgrade</a></tt>.</p>
|
al@811
|
905
|
al@844
|
906 <p>Command without options will recharge databases of all your repositories. You can specify the
|
al@844
|
907 repository to be recharged: “main” for main repo, or undigest repository name.</p>
|
al@811
|
908
|
al@811
|
909 <pre>
|
al@811
|
910 # tazpkg recharge
|
al@811
|
911 # tazpkg recharge main
|
al@811
|
912 # tazpkg recharge <em>My_Undigest</em>
|
al@811
|
913 # tazpkg recharge --root=<em>/mnt/sda6</em>
|
al@811
|
914 </pre>
|
al@844
|
915 </article>
|
al@811
|
916
|
al@811
|
917
|
al@844
|
918 <article id="upgrade"><h3>upgrade</h3>
|
al@811
|
919
|
al@844
|
920 <p>Upgrade allows you to update all installed packages available on the current mirror
|
al@844
|
921 (<tt>upgrade</tt> or <tt>up</tt>). Upgrading packages is an important part of system security, it
|
al@844
|
922 helps to keep you secure with the latest updates and fixes. The SliTaz project, although tiny,
|
al@844
|
923 provides regular updates on security and generally offers the latest versions of software. Note that
|
al@844
|
924 this function is aimed at people with SliTaz installed on a hard drive. Updated packages in Live CD
|
al@844
|
925 mode will be lost on system shutdown.</p>
|
al@811
|
926
|
al@828
|
927 <p>At the beginning the packages database is updated automatically (<tt><a
|
al@844
|
928 href="#recharge">recharge</a></tt>) in order to provide you with the current list of packages that
|
al@844
|
929 you can update.</p>
|
al@828
|
930
|
al@844
|
931 <p>Without options it runs in interactive mode and asks before install. You can specify one of the
|
al@844
|
932 next options: <tt>-c</tt> or <tt>--check</tt> to check only for available upgrades; <tt>-i</tt> or
|
al@844
|
933 <tt>--install</tt> to check for upgrades and install them all.</p>
|
al@811
|
934
|
al@811
|
935 <pre>
|
al@811
|
936 # tazpkg upgrade
|
al@828
|
937 # tazpkg up --check
|
al@828
|
938 # tazpkg up -i
|
al@811
|
939 </pre>
|
al@844
|
940 </article>
|
al@811
|
941
|
al@811
|
942
|
al@844
|
943 <article id="setup-mirror"><h3>setup-mirror</h3>
|
al@811
|
944
|
al@844
|
945 <p>Setup the URL for the mirror (<tt>setup-mirror</tt> or <tt>-sm</tt>). Command will ask for the
|
al@844
|
946 URL of the new mirror. Note that you can also modify the main <tt>/var/lib/tazpkg/mirror</tt> file.
|
al@844
|
947 The URL must point to the directory containing the <tt>packages.info</tt> and packages.</p>
|
al@811
|
948
|
al@811
|
949 <pre>
|
al@811
|
950 # tazpkg setup-mirror
|
al@811
|
951 </pre>
|
al@844
|
952 </article>
|
al@811
|
953
|
al@811
|
954
|
al@844
|
955 <article id="add-undigest"><h3>add-undigest, setup-undigest</h3>
|
al@811
|
956
|
al@844
|
957 <p>Set the URL of an additional unofficial mirror to test packages that are not yet present on the
|
al@844
|
958 official mirrors. Note, you can also manually edit the file in
|
al@844
|
959 <tt>/var/lib/tazpkg/undigest/<em>repository</em></tt>. The URL must point to the directory
|
al@844
|
960 containing the packages and <tt>packages.info</tt>.</p>
|
al@811
|
961
|
pankso@302
|
962 <pre>
|
al@571
|
963 # tazpkg add-undigest <em>public-repository http://my.home.org/slitaz</em>
|
al@571
|
964 # tazpkg setup-undigest <em>local-repository /home/slitaz/packages</em>
|
pankso@302
|
965 </pre>
|
al@844
|
966 </article>
|
pankso@467
|
967
|
al@571
|
968
|
al@844
|
969 <article id="list-undigest"><h3>list-undigest</h3>
|
al@811
|
970
|
al@844
|
971 <p>Lists additional undigest mirrors. Option <tt>--box</tt> will output list in the table form.</p>
|
al@811
|
972
|
al@811
|
973 <pre>
|
al@844
|
974 $ tazpkg list-undigest
|
al@844
|
975 $ tazpkg list-undigest --box
|
al@811
|
976 </pre>
|
al@844
|
977 </article>
|
al@811
|
978
|
al@811
|
979
|
al@844
|
980 <article id="remove-undigest"><h3>remove-undigest</h3>
|
al@571
|
981
|
al@844
|
982 <p>Removes the URL of an undigest mirror. You will be asked for confirmation.</p>
|
al@811
|
983
|
pankso@302
|
984 <pre>
|
al@571
|
985 # tazpkg remove-undigest <em>my-repository</em>
|
pankso@302
|
986 </pre>
|
al@844
|
987 </article>
|
al@847
|
988
|
al@847
|
989
|
al@847
|
990 <article id="mkdb"><h3>mkdb</h3>
|
al@847
|
991
|
al@847
|
992 <p>Make TazPkg database for selected folder with *.tazpkg packages.</p>
|
al@847
|
993
|
al@847
|
994 <p>Next files describing packages will be created inside selected folder: <tt>packages.info</tt>,
|
al@847
|
995 <tt>packages.equiv</tt>, <tt>descriptions.txt</tt>, <tt>files.list.lzma</tt>, <tt>IDs</tt>.
|
al@847
|
996 Do nothing if database already exists; you can force database files rebuilding with
|
al@847
|
997 <tt>--forced</tt> option.</p>
|
al@847
|
998
|
al@847
|
999 <pre>
|
al@847
|
1000 # tazpkg mkdb <em>/home/boot/packages</em>
|
al@847
|
1001 # tazpkg mkdb <em>/home/boot/packages</em> --forced
|
al@847
|
1002 </pre>
|
al@847
|
1003 </article>
|
al@844
|
1004 </section>
|
pankso@467
|
1005
|
al@571
|
1006
|
al@571
|
1007
|
pankso@302
|
1008
|
al@844
|
1009 <section><header>Maintainer</header>
|
al@811
|
1010
|
al@811
|
1011 <p>Christophe Lincoln <pankso at slitaz.org></p>
|
al@844
|
1012 </section>
|
pankso@302
|
1013
|
al@844
|
1014
|
al@844
|
1015
|
al@828
|
1016
|
al@828
|
1017 <footer>
|
al@844
|
1018 Copyright © 2015 <a href="http://www.slitaz.org/en/">SliTaz GNU/Linux</a>
|
al@828
|
1019 </footer>
|
al@828
|
1020
|
pankso@302
|
1021 </body>
|
pankso@302
|
1022 </html>
|