LIBKECCAK_CSHAKE_SUFFIX(3)

okay so bestie, welcome to LIBKECCAK_CSHAKE_SUFFIX(3) from the Library Functions Manual — yes, the manual name is folded in near the top because we are not doing that giant duplicated header line today 💅

✨ NAME ✨

• libkeccak_cshake_suffix — Get message suffix for cSHAKE hashing 🎀

🦋 SYNOPSIS 🦋

#include <libkeccak.h>

const char *libkeccak_cshake_suffix(size_t nlen, size_t slen);

Link with -lkeccak.

🌸 DESCRIPTION 🌸

The libkeccak_cshake_suffix() function returns a string of '1':s and '0':s — literally the message-suffix bits that shall be used. It’s giving “bit-string brat summer,” no cap ✨

Canonically, the values of the nlen and slen parameters shall be the length of the cSHAKE function-name bit-string and the cSHAKE customisation bit-string. However — and this is the lowkey important part 👀 — the function will only check whether these values are zero or non-zero. It is not out here measuring your actual bit-string lengths, bestie. Periodt.

🫶 RETURN VALUES 🫶

The libkeccak_cshake_suffix() function returns a statically allocated, read-only, message suffix bit-string that shall be used. Iconic. Immutable. Main-character energy 💖

😭 ERRORS 😭

The libkeccak_cshake_suffix() function cannot fail. Not even a little. No error path, no dramatic flop era, nothing to catch. Slay 💀

👑 SEE ALSO 👑

• libkeccak_spec_cshake(3)
• libkeccak_generalised_spec_initialise(3)
• libkeccak_state_initialise(3)
• libkeccak_cshake_initialise(3)
• libkeccak_fast_digest(3)
• libkeccak_zerocopy_digest(3)
• libkeccak_digest(3)

okay bye bestie — source/version LIBKECCAK, page LIBKECCAK_CSHAKE_SUFFIX(3), and the footer didn’t give a date so I’m not inventing one 🫶💜