KECCAKSUM(1)

💅 KECCAKSUM(1) 💅

ok so bestie, welcome to keccaksum(1) — it lives in the General Commands Manual section and it is literally your go-to for computing and checking Keccak[] message digests. slay.

---

✨ SYNOPSIS ✨

keccaksum [-u | -l | -b | -c] [-R rate] [-C capacity] [-N output-size]
[-S state-size] [-W word-size] [-Z squeeze-count] [-vxz] [file ...]

---

🦋 DESCRIPTION 🦋

Print or check Keccak[] checksums. And listen — if you pass no file at all, or if the file is literally -, it reads from standard input. iconic behavior tbh.

• -u — outputs checksums in upper-case hexadecimal. ALL CAPS energy 🔥
• -l — outputs checksums in lower-case hexadecimal. this is the default, no cap.
• -b — outputs checksums in binary representation. heads up: this suppresses the filenames and the checksum delimiters, so only the checksums get printed. just the vibes, nothing else 💀
• -c — reads Keccak[] sums from the file and checks them against the files on your system. the input files should be formatted as the output of this program, or similarly. ⚠️ real talk: this is not going to work if any of the filenames in the input file start with a regular space or horizontal tab, or if they contain a line feed, carriage return, or form feed — unless you also use the -z option. so like, use -z, bestie.
• -v — prints the hashing parameters. so you can see what's actually going on ✨
• -x — converts input files from hexadecimal form to binary form before calculating the checksums. glow-up for your input 🧚
• -z — lines end with NUL instead of LF. if used with -c, this applies to read files (not the output), but it will also apply more strict parsing and allow any whitespace in file names. lowkey the upgrade you want 🫶

---

🌸 changing the hashing parameters 🌸

the following options change the hashing parameters:

• -R rate — change the rate.
• -C capacity — change the capacity.
• -N, -O output-size — change the output size.
• -S, -B state-size — change the state size.
• -W word-size — change the word size.
• -Z squeeze-count — change the number of squeezes that is performed.

---

⭐ EXIT STATUS ⭐

• 0 — successful completion. we ate and left no crumbs 💖
• 1 — checksums did not match or a file did not exist. 😭 it's giving mismatch.
• 2 — an error occurred. 💀

---

👑 AUTHORS 👑

Mattias Andrée <m@maandree.se> — the main character who made this happen 🌈

---

🎀 NOTES 🎀

ok so, all commands in the sha3sum package allow changing the hashing parameters. but ngl, it's only intended to be used with keccaksum(1) — or if you know what you are doing. the one exception is -N, which is intended to always be used with shake128sum(1), shake256sum(1), shake512sum(1), rawshake128sum(1), rawshake256sum(1), and rawshake512sum(1). iykyk 💅

fr fr bestie, don't go changing parameters just because you can — that's not the vibe check you think it is.

---

✨ that's the whole page, periodt ✨

sign-off from your girl: this gem is from the SHA3SUM source, KECCAKSUM(1) edition — catch you in the next manpage, mwah 🍓💜