opendmarc-reports(8)                                      opendmarc-reports(8)

NAME
       opendmarc-reports - OpenDMARC aggregate report generation tool

SYNOPSIS
       opendmarc-reports [options]

DESCRIPTION
       opendmarc-reports  pulls  data from an OpenDMARC database and generates periodic aggregate reports.  The database is popu-
       lated by a running opendmarc-import(8) on a message history file generated by an opendmarc(8) filter  as  messages  arrive
       and  are  processed.   This includes the collection of reporting URIs, which this script uses to make reports available to
       those that request them.

OPTIONS
       --dbhost=hostname
              Specifies the hostname on which the SQL server is running.  Defaults to  the  value  of  the  environment  variable
              OPENDMARC_DBHOST, or "localhost" if the environment variable is not set.

       --dbname=name
              Specifies the SQL database name to be accessed.  Defaults to the value of the environment variable OPENDMARC_DB, or
              "opendmarc" if the environment variable is not set.

       --dbpasswd=password
              Specifies the password for the SQL database to be accessed.  Defaults to the  value  of  the  environment  variable
              OPENDMARC_PASSWORD, or "opendmarc" if the environment variable is not set.

       --dbport=port
              Specifies  the TCP port on which the SQL server is expected to be listening.  Defaults to the value of the environ-
              ment variable OPENDMARC_PORT, or 3306 if the environment variable is not set.

       --dbuser=user
              Specifies the SQL user to be used to access the database.  Defaults to the value of the environment variable OPEND-
              MARC_USER, or "opendmarc" if the environment variable is not set.

       --domain=name
              Generates a report (if one is due) for the named domain, rather than checking all of them.

       --help Prints a help message and terminates.

       --interval=secs
              Generates reports only for hosts that have not had a report generated in at least the last secs seconds.

       --nodomain=name
              Skips  generating  a  report  for  the  named  domain.   Can be specified multiple times to skip multiple reporting
              domains.

       --noupdate
              Suppresses marking the time of the transmission of the report in the database.  Normally this would be done to pre-
              vent reports from being sent too close together.

       --smtp-host=host
              Causes  reports  to be sent by transmitting them using SMTP to the named host which can be an IP address or a host-
              name.  The default is "127.0.0.1".

       --smtp-port=port
              Causes reports to be sent by transmitting them using SMTP to the specified port.  The default is 25.

       --verbose
              Increase the amount of verbosity written to standard output.

       --version
              Print version number and exit.

VERSION
       This man page covers the version of opendmarc-reports that shipped with version 1.2.0 of OpenDMARC.

COPYRIGHT
       Copyright (c) 2012, The Trusted Domain Project.  All rights reserved.

SEE ALSO
       opendmarc(8), opendmarc.conf(5), opendmarc-import(8)

                          The Trusted Domain Project      opendmarc-reports(8)