---
name: "dkim-stats"
section: "8"
platform: "linux"
package: "dkim-filter"
version: "2.8.2.dfsg-1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/dkim-stats"
---

# dkim-stats(8)

output dkim-milter statistics

## 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)](/dkim-filter/8.md)*

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