HMINE(1)

📦 version 1.14, in nixos 26.05, nixpkgs unstable

💌 HMINE(1) — the header analyzer, bestie edition 🎀

okay so picture this: you've got a mail message, you wanna know what's lurking in its headers, and you don't wanna read the whole thing. that's hmine, a mail message header analyzer, and it's genuinely iconic for it.

✨ SYNOPSIS ✨

hmine [-vDa] [FILE]

hmine -V

🌸 DESCRIPTION 🌸

hmine reads a mail message from FILE or from STDIN (whichever you give it) and prints out a whole bunch of info it finds in the message headers. slay.

the message is expected in Internet mail format — think RFC 821, 822, 2821, 2822 or variations thereof — you know, the usual suspects. and here's the thing: the body is not inspected. not even a little. nope. body stays private, we're only here for the headers, boundaries are healthy 💅

🦋 EXIT STATUS 🦋

lowkey the most unhinged part of this whole page, so brace yourself:

  • On success, hmine returns 1.
  • In case of a problem, hmine returns zero.

yeah. that's not a typo, that's just how it is. invert your expectations, periodt 😭

👑 OPTIONS 👑

  • -a — prints the mailboxes and groups it finds in the various header fields, one per line, each preceded by the field name. actual email addresses are always wrapped in < and > so parsing stays easy — meaning anything not between those delimiters is not part of an email address, iykyk. ⚠️ and beware: not every line is guaranteed to contain an email address, so don't come for me when one doesn't.
  • -D — debug output. for when you need to see what's going on under the hood 🫶
  • -V — print the program version number and exit. cute and quick, love that for you.
ngl, the synopsis up top shows [-vDa], but the OPTIONS section only documents these three: -a, -D, and -V. just so we're all on the same page 💖

🌈 USAGE 🌈

an invocation looks like this:

% hmine email.txt

that's it. that's the whole vibe. feed it a file, get header analysis 🌸

🧚 SOURCE 🧚

the source code for the latest version of this program is available at the following locations:

http://www.lbreyer.com/gpl.html
http://dbacl.sourceforge.net

go get it bestie ✨

💀 BUGS 💀

okay so real talk: at present, hmine parses messages but doesn't output anything useful.

not me 😭😭 it's doing the work and then just... not telling you. iconic in a tragic way. consider this your warning, fr fr.

🎀 AUTHOR 🎀

Laird A. Breyer <laird@lbreyer.com> — respect, king 👑

⭐ SEE ALSO ⭐

dbacl(1), mailcross(1), mailfoot(1), mailinspect(1), mailtoe(1), regex(7)

the whole friend group, honestly 🫶

💖 so yeah, that's hmine — Version 1.14, part of the Bayesian Classification Tools, dropping straight out of your friendly neighbourhood manual page. go analyze some headers, bestie, you've got this 🦋💅
📦 where this page comes from