FIPSHMAC(8)

📦 version 1.7.0, in opensuse-leap 16.0

💅 FIPSHMAC(8) — like, the fipshmac manual page, bestie ✨

okay so you opened the fipshmac page — welcome, this is the one that makes FIPS-140-2 validation checksum files. yes, that FIPS. no cap, it's giving "serious crypto paperwork" energy, but we're gonna get through it together 🫶

🌸 NAME 🌸

fipshmac — create FIPS-140-2 validation checksum files 💖

✨ SYNTAX ✨

fipshmac [-d <directory>] file1 [file2 ...]

🦋 DESCRIPTION 🦋

So basically, fipshmac creates FIPS-140-2 checksum files for literally all the filenames you hand it. Every single one. It's an overachiever like that 💅

Now here's the naming tea ☕ — if you don't pass the -d option, the checksum files get written straight into the same directory as the file being checksummed. And the name? It prepends a . and appends .hmac to the original file name. Cute little makeover, no notes.

pause for the important distinction — when you do specify a directory with the -d option, the . does not get prepended, and the files are stored into that directory. so like, different vibe, different filename. don't mix them up 🙈

If you invoke it correctly, fipshmac will print absolutely nothing to standard output or standard error. silent. stealth mode. a mystery. 🔥 Otherwise it prints an error message to stderr, so if you see words, something went sideways.

And then there's the -s option, which lets you specify the suffix of the hmac file names. The default value .hmac is used when this option isn't specified. so yeah, .hmac unless you say otherwise 🎀

⭐ RETURN CODES ⭐

fipscheck can return the following return codes — memorize these, they're the receipts 🧾

  • 0 — OK ✨
  • 2 — Missing filename 😭
  • 3 — Cannot open the checksum file for writing 💀
  • 4 — Cannot read the file to be checksummed, or the checksum computation failed 🙈
  • 5 — Memory allocation error 🫠
  • 6,7 — Cannot write to the checksum file 🌧️

🔍 SEE ALSO 🔍

go poke at these next, bestie:

👑 AUTHOR 👑

Tomas Mraz <tmraz@redhat.com>.

Man page by Paul Wouters <pwouters@redhat.com>

Copyright 2008, 2012 Red Hat, Inc. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
legal text stays legal text, babe — I'm not paraphrasing that one 💅

and that's the whole page!! mwah, go make some checksums 🌈💖✨

fipscheck · April 11, 2012 — this page was brought to you by fipshmac (8), signing off 🎀🦋⭐

📦 where this page comes from