doc/repo-add.8.txt

   1 /////
   2 vim:set ts=4 sw=4 syntax=asciidoc noet:
   3 /////
   4 repo-add(8)
   5 ==========
   6
   7 Name
   8 ----
   9 repo-add - package database maintenance utility
  10
  11 Synopsis
  12 --------
  13 'repo-add' [options] <path-to-db> <package|delta> [<package|delta> ...]
  14
  15 'repo-remove' [options] <path-to-db> <packagename|delta> [<packagename|delta> ...]
  16
  17
  18 Description
  19 -----------
  20 'repo-add' and 'repo-remove' are two scripts to help build a package database for
  21 packages built with linkman:makepkg[8] and installed with linkman:pacman[8].
  22 They also handle package deltas produced by linkman:pkgdelta[8].
  23
  24 'repo-add' will update a package database by reading a built package or package
  25 delta file. Multiple packages and/or deltas to add can be specified on the
  26 command line.
  27
  28 'repo-remove' will update a package database by removing the package name or
  29 delta specified on the command line. Multiple packages and/or delta to remove
  30 can be specified on the command line.
  31
  32 A package database is a tar file, optionally compressed. Valid extensions are
  33 ``.db'' or ``.files'' followed by an archive extension of ``.tar'',
  34 ``.tar.gz'', ``.tar.bz2'', or ``.tar.xz''. The file does not need to exist, but
  35 all parent directories must exist.
  36
  37
  38 Common Options
  39 --------------
  40 *-q, \--quiet*::
  41         Force this program to keep quiet and run silent except for warning and
  42         error messages.
  43
  44 *-s, \--sign*::
  45         Generate a PGP signature file using GnuPG. This will execute `gpg
  46         --detach-sign --use-agent` on the generated database to generate a detached
  47         signature file, using the GPG agent if it is available. The signature file
  48         will be the entire filename of the database with a ``.sig'' extension.
  49
  50 *-k, \--key* <key>::
  51         Specify a key to use when signing packages. Can also be specified using
  52         the GPGKEY environmental variable. If not specified in either location, the
  53         default key from the keyring will be used.
  54
  55 *-v, \--verify*::
  56         Verify the PGP signature of the database before updating the database.
  57         If the signature is invalid, an error is produced and the update does not
  58         proceed.
  59
  60 repo-add Options
  61 ----------------
  62 *-d, \--delta*::
  63         Automatically generate and add a delta file between the old entry and the
  64         new one, if the old package file is found next to the new one.
  65
  66 *-f, \--files*::
  67         Tells repo-add also to create and include a list of the files in the
  68         specified packages. This is useful for creating databases listing all files
  69         in a given sync repository for tools that may use this information.
  70
  71 See Also
  72 --------
  73 linkman:makepkg[8], linkman:pacman[8], linkman:pkgdelta[8]
  74
  75 include::footer.txt[]