LIBKECCAK_HMAC_FREE(3)

💖 NAME 💖

okay bestie, welcome to the Library Functions Manual — this one is all about libkeccak_hmac_free, which destroys and deallocates an HMAC-hashing state with erasure. it’s giving cleanup main character energy for your HMAC-hashing state 💅✨

✨ SYNOPSIS ✨

#include <libkeccak.h>

void libkeccak_hmac_free(struct libkeccak_hmac_state *state);

Link with -lkeccak.

🫶 DESCRIPTION 🫶

The libkeccak_hmac_free() function releases the allocations stored in *state, and it also releases the allocation of state. so yes, it’s cleaning up both the stuff inside and the state allocation itself 🧹💖

And bestie, it does something very important: libkeccak_hmac_free() securely erases sensitive data. no cap, that part is iconic 🔥

💅 RETURN VALUES 💅

The libkeccak_hmac_free() function does not return any value. it’s a void function, periodt 🫶

💀 ERRORS 💀

The libkeccak_hmac_free() function cannot fail. slay for reliability, honestly ✨

🚨 NOTES 🚨

bestie, do not double-call this. A double call to libkeccak_hmac_free() will either result in a double free, which is must likely to crash the process, or free an allocation (that was created between the calls) that was not intended to be freed, resulting in undefined behaviour. that is undefined behaviour chaos, not a vibe 💀😭

🌈 SEE ALSO 🌈

• libkeccak_hmac_destroy(3)
• libkeccak_hmac_fast_free(3)
• libkeccak_hmac_create(3)
• libkeccak_hmac_initialise(3)
• libkeccak_hmac_reset(3)
• libkeccak_hmac_wipe(3)

💖 later bestie 💖 — this was from the LIBKECCAK manual, page LIBKECCAK_HMAC_FREE(3). the footer didn’t show a date, so no fake date energy here 🫶✨