LIBKECCAK_HMAC_INITIALISE(3)

🌸 NAME 🌸

libkeccak_hmac_initialise — initialise HMAC-hashing state. This is the LIBKECCAK_..._INITIALISE(3) page from the Library Functions Manual, bestie — manual name folded in near the top, exactly as requested, no copy-pasted header line in sight. 💖

---

✨ SYNOPSIS ✨

#include <libkeccak.h>

int libkeccak_hmac_initialise(struct libkeccak_hmac_state *state, const struct libkeccak_spec *spec,
                              const void *key, size_t key_length);

Link with -lkeccak.

---

🦋 DESCRIPTION 🦋

Okay so libkeccak_hmac_initialise() is the starter-upper for your HMAC-hashing state: it initialises *state and sets the algorithm tuning parameters to those specified by *spec, and it sets the key to key of length key_length. That's the whole assignment, fr fr. ✨

---

🌈 RETURN VALUES 🌈

libkeccak_hmac_initialise() returns 0 upon successful completion. Slay. On error, -1 is returned and errno is set to describe the error — so if you see -1, check errno, bestie. 💅

---

🎀 ERRORS 🎀

The libkeccak_hmac_initialise() function may fail for any error specified for malloc(3) and realloc(3). It's giving allocation-dependent, lowkey. If those functions have a bad day, this one can too. 😭

---

💜 SEE ALSO 💜

Go read these next, iykyk:

• libkeccak_hmac_create(3)
• libkeccak_hmac_destroy(3)
• libkeccak_hmac_fast_destroy(3)
• libkeccak_hmac_copy(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_initialise(3)

---

Footer tea, served cute: source/version is LIBKECCAK, the page is LIBKECCAK_..._INITIALISE(3), and the original footer didn't hand us a date — so I'm not inventing one, periodt. Bye bestie! 💅✨🫶