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 /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
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.