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