sourCEntral - mobile manpages

pdf

DKIM-STATS

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

dkim-filter(8)

VERSION

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

HISTORY

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

pdf