LIBKECCAK_HMAC_UNMARSHAL(3)

okay so you opened the libkeccak_hmac_unmarshal(3) page from the Library Functions Manual — and bestie, we're getting that HMAC state back into shape 💅✨

🌸 NAME 🌸

• libkeccak_hmac_unmarshal — Unharshals an HMAC-hashing state 🫶

🦋 SYNOPSIS 🦋

#include <libkeccak.h>

size_t libkeccak_hmac_unmarshal(struct libkeccak_hmac_state *state, const void *data);

Link with -lkeccak.

✨ DESCRIPTION ✨

The libkeccak_hmac_unmarshal() function unmarshals an HMAC-hashing state from the beginning of data, and stores it in *state. And yes, state may be NULL — that's allowed, no cap 💖

🎀 RETURN VALUES 🎀

On success, libkeccak_hmac_unmarshal() returns the number of bytes read from data upon successful completion. On error, -1 is returned and errno is set to describe the error 😭

If state is NULL, the function will always be successful and return a positive value; that value is the number of bytes that make up the marshalled state. Iconic, honestly 👑

💀 ERRORS 💀

The libkeccak_hmac_unmarshal() function may fail for any reason specified for the function malloc(3). So if malloc(3) is having a day, this can too 🙈

🌈 SEE ALSO 🌈

• libkeccak_hmac_marshal(3)

mwah 💋 — signed off by LIBKECCAK, page LIBKECCAK_HMAC_UNMARSHAL(3), with absolutely zero extra date drama because the footer didn't bring one 🫶✨