Revision history for Mail::Send::DKIM - Sign mail with DKIM, and summarise DMARC reports
0.001 Tue Nov 17 12:40:18 PM EST 2026
First release.
- dmarc-report: summarise the DMARC aggregate reports in a directory,
one row per sending source, and flag the ones that were not expected:
a sender outside DMARC_EXPECTED, a message that failed both SPF and
DKIM, a report filed by policy anyway. --file-list names the reports
read, so a wrapper can archive them, and the exit status says whether
anything needs looking at.
- dmarc-weekly.sh: the cron wrapper. Silent when the week is clean and
a mail with the full output otherwise, with the reports moved to an
archive afterwards. --dry-run rehearses it, and --crontab prints the
line to paste into a crontab rather than installing one.
- dmarc-check-mail.pl: sends one message, signed or (with --plain)
unsigned, so the Authentication-Results header at the far end shows
what receivers make of this host's mail before the DMARC policy is
tightened. --to is checked like --from, because both become headers
and --from is also the envelope sender. It leaves with 1 when
nothing was sent - no key found, no --save written, no sendmail run -
and with 2 only when the options cannot be used, so a wrapper can
tell a message that was never attempted from one that failed on the
way out.
- mail-dkim: a drop-in for a direct call to sendmail(1). A message from
one of the domains in DKIM_DOMAINS is signed rsa-sha256 with relaxed
canonicalization and then handed to sendmail; anything else - a
foreign From:, no key, no From: at all - is passed through unsigned,
so installing it cannot stop mail being delivered.
- Mail::Send::DKIM is the signing behind mail-dkim, usable directly and
tested without a process and a pipe.
- The failure paths of dmarc-check-mail.pl are tested rather than
assumed: a --save that cannot be written, a sendmail that cannot be
run, one that reports a failure, and one that leaves with 2 of its
own, each with a stub in place of sendmail.
- t/pod-code.t holds each programme's page against the programme: an
option GetOptions takes and OPTIONS does not list, one OPTIONS lists
and the programme does not take, an environment variable it reads -
through Mail::Send::DKIM->new() as well as directly - that
ENVIRONMENT does not name, and an exit status EXIT STATUS leaves out.
dmarc-weekly.sh's documented --dry-run is the mistake it is there to
catch.
Keyboard Shortcuts
Global
s
Focus search bar
?
Bring up this help dialog
GitHub
gp
Go to pull requests
gi
Go to GitHub issues (only if GitHub is preferred repository)