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

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