tazpkg annotate doc/tazpkg.en.html @ rev 844

Finish modularization. Beta release: still have few FIXMEs and TODOs.
author Aleksej Bobylev <al.bobylev@gmail.com>
date Mon Oct 05 03:53:47 2015 +0300 (2015-10-05)
parents c45468fb179e
children e54a3ba8cc25
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 &lt;pankso at slitaz.org&gt;</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>