summaryrefslogtreecommitdiff
path: root/contrib/doc/verify-pacman-repo-db.1.txt
blob: 62564b8f7785923916ed1a9874f9d218d358589a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
/////
vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us:
/////
verify-pacman-repo-db(1)
========================

Name
----
verify-pacman-repo-db - package repository verification utility


Synopsis
--------
'verify-pacman-repo-db' [options]


Description
-----------
'verify-pacman-repo-db' looks at a pacman repo database and verifies its
content with the actual package files. The database is expected to be in
the same directory as the packages (or symlinks to the packages).

The following properties are verified for each package in the database:

     - existence of the package file
     - file size
     - MD5 and SHA256 checksum (--checksum)

Options
-------
*-h, \--help*::
    Output a short help message.

*\--debug*::
    Enable debug output.

*-c, \--checksum*::
    Verify checksums of packages. Note that this means all packages files will
    be read from disk. Otherwise only metadata is compared which does not
    require to read package file contents.

*-t, \--threads* <number>::
    Use 'number' threads to verify packages. Note that each thread may use up
    to approximately 128MiB of memory. Default: 1

Notes
-----

This script does intentionally not use any ALPM libraries. The format is simple
enough to be parsed and this way we might just detect more problems because the
libalpm parsing code might also have bugs. We also stay much more portable
which might be good for people that want to check a db, but don't actually have
pacman installed.


See Also
--------
linkman:repo-add[8]

include::footer.txt[]