Man Linux: Main Page and Category List

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

                                  10 May 2007