LIBKECCAK_STATE_FAST_FREE(3)

✨ NAME ✨

hiii bestie, welcome to the LIBKECCAK_...E_FAST_FREE(3) page 💖 this one is all about libkeccak_state_fast_free — the function that destroys and deallocates a hash state without erasure. yes, the name is a whole mouthful, but she's iconic.

🌸 SYNOPSIS 🌸

#include <libkeccak.h>

void libkeccak_state_fast_free(struct libkeccak_state *state);

Link with -lkeccak 🫶

🦋 DESCRIPTION 🦋

okay so libkeccak_state_fast_free() releases the allocations stored in *state, and it also releases the allocation of state itself. like, both of them are getting freed, no crumbs.

Important vibe check though: this function does not securely erase sensitive data ⚠️ so if you were expecting a deep-clean, this is not that girl. she frees, she does not wipe.

🎀 RETURN VALUES 🎀

libkeccak_state_fast_free() does not return any value. literally nothing. no value, no little return guy, just vibes and deallocation 💅

⭐ ERRORS ⭐

libkeccak_state_fast_free() cannot fail. she simply cannot. iconic behavior, honestly.

💀 NOTES 💀

bestie, do not double-call this one 💀

A double call to libkeccak_state_fast_free() will either result in a double free, which is most 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. so yeah, one call and done. no encore. periodt.

🌈 SEE ALSO 🌈

• libkeccak_state_fast_destroy(3)
• libkeccak_state_free(3)
• libkeccak_state_create(3)
• libkeccak_state_initialise(3)
• libkeccak_state_reset(3)
• libkeccak_state_wipe(3)

mwah 💖 signing off from the LIBKECCAK manual, page LIBKECCAK_...E_FAST_FREE(3) — source/version LIBKECCAK, and the footer didn't show a date, so no fake date energy here 🧚✨