Changes for version 0.001 - 2026-11-17

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

Documentation

send one test message from this host, so its authentication can be read
summarise DMARC aggregate reports and flag unexpected senders
sign a message on stdin with DKIM, then send it with sendmail

Modules

sign a message with DKIM and hand it to sendmail