opendkim-gengraphs(8)

✨ opendkim-gengraphs ✨

okay bestie, so this is the man page for opendkim-gengraphs, part of the System Manager's Manual lineup. sit down, grab a strawberry 🍓, we're about to turn your mail stats into pretty pictures.

🎀 NAME 🎀

opendkim-gengraphs — the OpenDKIM statistics graph generation tool. yes, she makes graphs. she's an artist. 💅

🌸 SYNOPSIS 🌸

opendkim-gengraphs [options]

that's it. that's the whole vibe. no positional args, just options, go off.

🦋 DESCRIPTION 🦋

opendkim-gengraphs takes all the data that the OpenDKIM statistics feature has been quietly hoarding and collates it into an HTML report, and that report comes with graphs showing how specific domains of interest behave on the daily. 📈✨

lowkey important: it requires access to gnuplot(1). no gnuplot, no graphs, no slay. that's just the deal.

👑 OPTIONS 👑

every single one of these, no skips, no skimming, we're doing the whole list:

• --dbhost=host — tries to connect to the database server living at host. default is "localhost" (she's local, she's humble 🏠).
• --dbname=name — asks for a connection to the database called name. default is "opendkim".
• --dbpasswd=password — authenticates to the database server with password. default is "opendkim". 🔐
• --dbport=port — connects to the database on that TCP port. default is 3306.
• --dbuser=user — authenticates to the database server as user. default is "opendkim".
• --domain={ domain | file } — adds the named domain, or the domains pulled out of the named file, to the set of domains that get a graph. here's the trick: any string that starts with / or ./ is assumed to be a file to read domain naems from. (yes, "naems." we're keeping the typo, it's part of the lore 🙈)
• --help — prints a usage message and dips. bye 👋
• --nocircles — stops the script from asking for circles in the graphs that show point magnitude (aka a bubble graph) — for the installs running versions of gnuplot(1) that just don't support it. considerate queen behavior 🫶
• --nounsigned — suppresses generation of a graph for unsigned mail. not today, unsigned mail. 🚫
• --output=file — writes the HTML report to the specified file. the graphs get generated in that same directory, so they're all together, like a little family 🥹
• --verbose — asks for verbose output. she will tell you everything.
• --version — prints the version number and exits. classic.

💜 VERSION 💜

this man page covers the version of opendkim-gengraphs that shipped with version 2.11.0 of OpenDKIM. iykyk.

💖 COPYRIGHT 💖

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

🌈 SEE ALSO 🌈

• opendkim(8)
• opendkim-importstats(8)
• RFC6376 - DomainKeys Identified Mail

okay that's the whole page, bestie. big love to The Trusted Domain Project for bringing us opendkim-gengraphs(8) and version 2.11.0 of OpenDKIM — go make some graphs, they're gonna eat. 💅✨🎀