DMARCTS-REPORT-PARSER(8)

📦 version 1.0+git20230715.9dd92cf, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 dmarcts-report-parser — DMARC Report Parser 💖

okay bestie, welcome to dmarcts-report-parser, section 8 of the manual (the big-girl sysadmin section, iykyk). this is the lil script that eats DMARC reports and files them away all neat and tidy. let's go 🦋

✨ SYNOPSIS ✨

dmarcts-report-parser [OPTIONS] [PATH]

🌸 DESCRIPTION 🌸

so like, this script parses .xml files inside DMARC reports that email providers send you, and then it stores all that parsed info in an SQL database. that's the whole vibe. 🎀

the .xml files are expected to be attachments of emails, and the script can grab those emails from local folders, mbox files, or IMAP account folders. so many options, we love a flexible queen 👑

also, real talk, this script needs a configuration file called dmarcts-report-parser.conf, and it looks for it in /etc/ (or in the current working directory). that file defines a database server plus credentials, and — if you're using it — an IMAP server plus credentials. no config, no party. periodt. 💅

🔥 OPTIONS 🔥

okay so one of these following options MUST be provided. not optional, bestie, pick one:

  • -i — read reports from messages on the IMAP server, as defined in the config file. 📬
  • -m — read reports from mbox file(s) provided in PATH. 📦
  • -e — read reports from MIME email file(s) provided in PATH. 📧
  • -x — read reports from xml file(s) provided in PATH. 📄

and then these optional cuties are allowed on top of that:

  • -d — print debug info. 🐛
  • -r — replace existing reports rather than skipping them. 🔁
  • --delete — delete processed message files (the XML is stored in the database for later reference). 🗑️
  • --info — print out the number of XML files or emails processed. 📊

👀 SEE ALSO 👀

  • dmarcts-report-viewer

👑 AUTHOR 👑

this man page was written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the Debian project, and it may be used by others. ty king 🫶

and that's the whole page, bestie!! 💖 this one is dmarcts-report-parser, from February 2020, and it lives at the top of the page as DMARCTS-REPORT-PARSER(8). go parse something iconic, mwah 💅✨🌈

📦 where this page comes from