dkim-stats(8)

1DKIM-STATS(8)               System Manager's Manual              DKIM-STATS(8)
2
3
4

NAME

6       dkim-stats - output dkim-milter statistics
7

SYNOPSIS

9       dkim-stats file
10

DESCRIPTION

12       The dkim-stats utility reads from a dkim-filter statistics database and
13       dumps the data therein to standard output.  It takes as its only  argu‐
14       ment  the  path to this database.  The dkim-filter statistics gathering
15       is disabled by default, but can be enabled through a  Statistics  entry
16       in /etc/dkim-filter.conf.  This is currently an undocumented feature of
17       the dkim-milter package which must be enabled by a compile-time option.
18

OUTPUT

20       dkim-stats groups statistics output  by  domain  and  canonicalization.
21       Each line begins with a domain and a header/body canonicalization.  The
22       canonicalization is currently the raw enumerated value taken  from  the
23       libdkim headers; for reference, 0 = simple, 1 = relaxed, and 2 = noswp.
24       This format looks like:
25
26       domain:x/x     x pass/x fail, last v=x, l=x, a=x, date
27
28       For each line, the following statistics are shown:
29
30       number pass/number fail
31              Count of passes and failures
32
33       last v=version
34              Most recent DKIM signature version seen; this is another integer
35              code  starts at 0 and goes through 5, with higher numbers repre‐
36              senting more recent versions of the draft DKIM specification.
37
38       l=number
39              A boolean indicating whether or not the most recent signed  mes‐
40              sage had an "l=" tag in its signature.
41
42       a=algorithm
43              Most recent algorithm seen (0 = rsa-sha1; 1 = rsa-sha256)
44
45       date   Last date a signed message was seen
46

EXAMPLES

48       gmail.com:1/1  212 pass/0 fail, last v=2, l=0, a=0, Sat May  5 17:42:58
49       2007
50
51       gmail.com, using canonicalization relaxed/relaxed , has sent  212  mes‐
52       sages  that  passed signature verification and 0 that failed.  The most
53       recently seen signature version was 2 , the most recently  seen  signa‐
54       ture  algorithm  was  rsa-sha1 , and the last message did not include a
55       length tag.  The most recent message was seen on 2007/05/05 at 17:42:58
56       in the server's local time zone.
57

NOTES

59       The output of dkim-stats is subject to change.  Please be aware of this
60       when upgrading to  future  releases,  especially  if  you  develop  any
61       scripts that consume the output.
62

VERSION

67       This  man page covers the dkim-stats that shipped with version 2.8.0 of
68       dkim-filter.
69

HISTORY

71       This original version of this man page was contributed by Mike  Markley
72       <mike@markley.org> for the Debian project.
73
74
75
76                                  10 May 2007                    DKIM-STATS(8)