linuXperts.org

DKIM-STATS(8) 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 argu- ment the path to this database. The dkim-filter statis- tics gathering is disabled by default, but can be enabled through a Statistics entry in /etc/dkim-filter.conf. This is currently an undocu- mented feature of the dkim-milter package which must be enabled by a com- pile-time option. OUTPUT dkim-stats groups statistics output by domain and canonicalization. Each line begins with a domain and a header/body canoni- calization. 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 repre- senting more recent versions of the draft DKIM specification. l=number A boolean indicating whether or not the most re- cent signed mes- sage 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 mes- sages that passed signature verification and 0 that failed. The most recently seen signature version was 2 , the most recent- ly seen signa- ture 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 ver- sion 2.7.0 of dkim-filter. HISTORY This original version of this man page was contributed by Mike Markley <mike@markley.org> for the Debian project. 10 May 2007 DKIM-STATS(8)