opendmarc-reports(8)opendmarc-reports(8)NAMEopendmarc-reports - OpenDMARC aggregate report generation tool
SYNOPSISopendmarc-reports [options]
DESCRIPTIONopendmarc-reports pulls data from an OpenDMARC database and generates
periodic aggregate reports. The database is populated by a running
opendmarc-import(8) on a message history file generated by an opend‐
marc(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--day Generate reports on day boundaries. Overrides the value of
--interval (see below).
--dbhost=hostname
Specifies the hostname on which the SQL server is running.
Defaults to the value of the environment variable OPEND‐
MARC_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 OPEND‐
MARC_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 environment 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 gen‐
erated in at least the last secs seconds.
--nodomain=name
Skips generating a report for the named domain. Can be speci‐
fied 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 prevent 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 hostname. 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.
--utc Instructs the database to change to the UTC timezone when gener‐
ating output. Otherwise, the database default is used.
--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.3.1 of OpenDMARC.
COPYRIGHT
Copyright (c) 2012, 2014, 2015, The Trusted Domain Project. All rights
reserved.
SEE ALSOopendmarc(8), opendmarc.conf(5), opendmarc-import(8)
The Trusted Domain Project opendmarc-reports(8)
