XYMONDIGEST(1)

πŸ’… XYMONDIGEST(1) β€” the groupchat manual page πŸ’…

okay bestie, pull up a chair πŸŽ€ this is xymondigest, and its whole entire job is calculating message digests. that's it. that's the gig. and it does it beautifully. no cap.


✨ NAME ✨

xymondigest β€” calculate message digests 🧚


✨ SYNOPSIS ✨

xymondigest md5|sha1|sha256|sha512|sha224|sha384|rmd160 [filename]

✨ DESCRIPTION ✨

so xymondigest(1) is this little utility that calculates message digests for a file or a document. and the way it actually gets used is chef's kiss β€” it's for when you're defining HTTP- or FTP-based content checks, y'know, the ones where xymonnet(1) checks that a URL returns a specific document. and instead of sitting there comparing the ENTIRE document character by character (exhausting, honestly, we don't have the time πŸ’€), the comparison gets done against a pre-computed message digest value instead. so much faster. so much cleaner. it's giving efficiency.

and the algorithms it'll do that with? literally all the icons: MD5, RIPEMD160, SHA1, or any of the SHA2 family (SHA-512, SHA-256, SHA-384, SHA-224). pick your fighter 🫢

now, that optional filename parameter? that's the input file whose message digest you want calculated. super straightforward. and if you don't hand it a filename at all β€” no filename, nothing β€” then the data just gets read from standard input. yes queen, pipes work. we love a flexible icon.

so what does it actually spit out? xymondigest outputs a string containing the digest algorithm and the computed message digest. and the format it uses is specifically suitable for use in the hosts.cfg(5) definition of a content check. so you can basically copy-paste it straight in. convenient? yes. iconic? also yes. 🌟


✨ EXAMPLE ✨

okay watch this, this is the good part:

$ xymondigest md5 index.html
md5:88b81b110a85c83db56a939caa2e2cf6

like. look at that. clean. and then my personal fave, the pipe moment 🌈:

$ curl -s http://www.foo.com/ | xymondigest sha1
sha1:e5c69784cb971680e2c7380138e04021a20a45a2

curl the URL, pipe it in, digest comes out. main character energy fr fr.


✨ SEE ALSO ✨


πŸ’€ reminder bestie: the digest is only as trustworthy as the algorithm, so don't come for me if you pick something spicy β€” the manual just tells you what it computes, not how to feel about it.

okay that's the whole page, you ate it, you understood it, periodt. πŸ’–

this has been Xymon, Version 4.3.30: 4 Sep 2019 β€” mwah, catch you on the next manpage πŸŒΈπŸ‘‘

πŸ“¦ where this page comes from