LIBKECCAK_HMAC_CREATE(3)

🎀 LIBKECCAK_HMAC_CREATE(3) 🎀

okay bestie, welcome to the LIBKECCAK_HMAC_CREATE(3) page from the Library Functions Manual ✨ this one is all about making a fresh HMAC-hashing state and setting it up, and yes, the vibes are immaculate 💖

---

🌸 NAME 🌸

• libkeccak_hmac_create — allocate and initialise HMAC-hashing state 🫶

---

✨ SYNOPSIS ✨

#include <libkeccak.h>

struct libkeccak_hmac_state *libkeccak_hmac_create(const struct libkeccak_spec *spec, const void *key, size_t key_length);

and don’t forget, bestie: link with -lkeccak 💅

---

💖 DESCRIPTION 💖

okay so libkeccak_hmac_create() is the function that allocates a new struct libkeccak_hmac_state * with one initialised element 😌 it then sets the algorithm tuning parameters to those specified by *spec, and sets the key to key of length key_length. that’s the whole glow-up: allocate, initialise, tune, key. iconic behavior, no cap ✨

---

🫶 RETURN VALUES 🫶

on a successful completion, libkeccak_hmac_create() returns a newly allocated struct libkeccak_hmac_state * — and yes, of one initialised element 💖

on error? NULL, bestie 😭 and errno is set to describe the error. that’s the signal to go check what went wrong 🫶

---

😭 ERRORS 😭

libkeccak_hmac_create() may fail for any of the errors specified for the functions malloc(3) and realloc(3) 💀 so yeah, it’s giving memory-allocation drama, and that’s the error menu here. not me pretending there’s more 🙈

---

🦋 SEE ALSO 🦋

• libkeccak_hmac_initialise(3)
• libkeccak_hmac_free(3)
• libkeccak_hmac_fast_free(3)
• libkeccak_hmac_duplicate(3)

go read these next, bestie, iykyk 🫶✨

---

okay that’s the whole page, bestie 🎀 source/version field says LIBKECCAK, and the date slot in the original footer is blank — no fake date here, fr fr 💅 LIBKECCAK_HMAC_CREATE(3) out 🌈