LIBKECCAK_...INITIALISE(3)

🎀 NAME 🎀

okay so bestie, welcome to LIBKECCAK_...INITIALISE(3) from the Library Functions Manual — it's the page for libkeccak_state_initialise, aka Initialise hash state. She's giving tiny-function-big-main-character-energy, and we're obsessed. 💅✨

✨ SYNOPSIS ✨

#include <libkeccak.h>

int libkeccak_state_initialise(struct libkeccak_state *state, const struct libkeccak_spec *spec);

Link with -lkeccak.

🦋 DESCRIPTION 🦋

So libkeccak_state_initialise() does the thing: it initialises *state and sets the algorithm tuning parameters to those specified by *spec. That's the whole serve, fr fr. 🫶

🌸 RETURN VALUES 🌸

• 0 — successful completion, slay. ✅
• -1 — on error, this is what comes back, and errno is set to describe the error. Cue the dramatic gasp 😭💀.

💜 ERRORS 💜

libkeccak_state_initialise() may fail for any of the errors specified for the function malloc(3). So if malloc is having a rough day, this function can catch the same energy. 🙈

🔥 SEE ALSO 🔥

• libkeccak_state_create(3)
• libkeccak_state_reset(3)
• libkeccak_state_destroy(3)
• libkeccak_state_fast_destroy(3)
• libkeccak_state_copy(3)
• libkeccak_fast_update(3)
• libkeccak_zerocopy_update(3)
• libkeccak_update(3)
• libkeccak_fast_digest(3)
• libkeccak_zerocopy_digest(3)
• libkeccak_digest(3)
• libkeccak_generalised_sum_fd(3)
• libkeccak_keccaksum_fd(3)
• libkeccak_sha3sum_fd(3)
• libkeccak_rawshakesum_fd(3)
• libkeccak_shakesum_fd(3)
• libkeccak_spec_cshake(3)
• libkeccak_spec_sha3(3)
• libkeccak_spec_shake(3)
• libkeccak_spec_rawshake(3)
• libkeccak_spec_check(3)
• libkeccak_generalised_spec_initialise(3)
• libkeccak_state_marshal(3)
• libkeccak_hmac_initialise(3)

That's the page, bestie 💖 Footer tea: the source/version is LIBKECCAK, and the right-hand footer text is LIBKECCAK_...INITIALISE(3) — there's no separate date shown, just that footer energy. Mwah 💋🎀