DKIM-STATS(8)

NAME
dkim-stats - output dkim-milter statistics

SYNOPSIS
dkim-stats file

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

OUTPUT
dkim-stats groups statistics output by domain and canonicalization. Each line begins with a domain and a header/body canonicalization. The canonicalization is currently the raw enumerated value taken from the libdkim headers; for reference, 0 = simple, 1 = relaxed, and 2 = noswp. This format looks like: domain:x/x x pass/x fail, last v=x, l=x, a=x, date For each line, the following statistics are shown:

number pass/number fail
    Count of passes and failures

last v=version
    Most recent DKIM signature version seen; this is another integer code starts at 0 and goes through 5, with higher numbers representing more recent versions of the draft DKIM specification.

l=number
    A boolean indicating whether or not the most recent signed message had an "l=" tag in its signature.

a=algorithm
    Most recent algorithm seen (0 = rsa-sha1; 1 = rsa-sha256)

date
    Last date a signed message was seen

EXAMPLES
gmail.com:1/1 212 pass/0 fail, last v=2, l=0, a=0, Sat May 5 17:42:58 2007

gmail.com, using canonicalization relaxed/relaxed , has sent 212 messages that passed signature verification and 0 that failed. The most recently seen signature version was 2 , the most recently seen signature algorithm was rsa-sha1 , and the last message did not include a length tag. The most recent message was seen on 2007/05/05 at 17:42:58 in the server's local time zone.

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

SEE ALSO
dkim-filter(8)

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

HISTORY
This original version of this man page was contributed by Mike Markley <mike@markley.org> for the Debian project.