MAILGRAPH(8)

💌 MAILGRAPH(8) — the group chat guide to mailgraph

okay bestie, sit down, hydrate, because we're about to talk about the daemon that turns your mail server's chaos into cute lil graphs. this is the System Manager's Manual page for mailgraph, section 8, and yes it's giving sysadmin main character energy. 🎀

✨ NAME ✨

mailgraph — a daemon which produces graphs of SMTP traffic 🌈

✨ SYNOPSIS ✨

mailgraph [ options ]

that's it. that's the whole vibe. options go in, graphs come out. 💅

✨ DESCRIPTION ✨

so mailgraph is a daemon — like, it just lives in the background doing its thing, no need to supervise it constantly, she's independent — and what she does is produce mail statistics in RRDtool format for Postfix and Sendmail. 📊

those stats get stored, and then she uses them to generate daily, weekly, monthly and yearly graphs of:

• sent mails
• received mails
• rejected mails
• bounced mails
• viruses
• spam mails

so basically the whole mail emotional journey, visualized. iconic, honestly. 👑

✨ OPTIONS ✨

• -h, --help — shows you the help and then dips. exit stage left. 🚪
• -v, --verbose — be verbose about what you do. she will tell you everything, no gatekeeping. 🗣️
• -V, --version — spits out version info and exits. quick lil flex. ✨
• -c, --cat — makes the logfile only be read, not monitored. like, one pass and done, no lurking. 📖
• -l, --logfile file — monitor file as the logfile instead of /var/log/syslog. pick your own fave. 🗂️
• -t, --logtype type — sets the logfile's type. default is syslog. 🏷️
• -y, --year — the start year of the log file. default is the current year. 🗓️
• --host=HOST — only use entries for HOST (a regexp, so yes she does pattern matching, she's smart) in syslog. 🎯
• -d, --daemon — starts in the background. she's going off to do her own thing now. 🫶
• --daemon-pid=FILE — write the PID to FILE instead of /var/run/mailgraph.pid. 📌
• --daemon-rrd=DIR — write RRDs to DIR instead of /var/lib/mailgraph/. 📁
• --daemon-log=FILE — write the verbose-log to FILE instead of /var/log/mailgraph.log. 📝
• --ignore-localhost — ignore mail to/from localhost. (used for virus scanner, iykyk) 🦠
• --ignore-host=HOST — ignore mail to/from HOST. (also used for virus scanner) 🙈
• --no-mail-rrd — do not update the mail rrd. skipping that one, bestie. ⛔
• --no-virus-rrd — do not update the virus rrd. 🦠🚫
• --no-greylist-rrd — do not update the greylist rrd. 🌫️🚫
• --rrd-name=NAME — use NAME.rrd, NAME_virus.rrd and NAME_greylist.rrd for the rrd files. name your children, basically. 🍼
• --rbl-is-spam — count rbl rejects as spam. into the spam bucket they go. 🗑️
• --virbl-is-virus — count virbl rejects as viruses. into the virus bucket they go. 🧫

✨ SEE ALSO ✨

• rrdtool(1)
• RRDs(3pm)

go read those too, they're part of the lore. 📚

✨ AUTHOR ✨

David Schweikert <dws@ee.ethz.ch> — the actual genius behind all of this. give her her flowers. 💐

ngl, every single flag above matters, so don't be out here guessing — she'll happily tell you everything with --verbose if you just ask. 🦋

and that's the whole page, bestie!! footer said MAILGRAPH(8) one more time just to remind you this is section 8 of the System Manager's Manual, so like… go forth and graph your mail traffic responsibly. mwah. 💖✨🎀