LIBKECCAK_HMAC_UPDATE(3)

🎀 LIBKECCAK_HMAC_UPDATE(3) 🎀

okay bestie, welcome to the Library Functions Manual page for libkeccak_hmac_update(3) — it’s giving “tiny function, very specific job” energy and honestly we love that for us 💅✨

🌸 NAME 🌸

libkeccak_hmac_update — partially HMAC-hash a message with erasure 🫶

✨ SYNOPSIS ✨

#include <libkeccak.h>

int libkeccak_hmac_update(struct libkeccak_state *state, const void *msg, size_t msglen);

Link with -lkeccak.

💖 DESCRIPTION 💖

okay so libkeccak_hmac_update() continues — or starts — HMAC-hashing a message. the current state of the hashing is stored in *state, and it will be updated. the message you pass as msg, with the byte-size specified by msglen, gets hashed. periodt.

also important: libkeccak_hmac_update() may reallocate the state’s message chunk buffer. when it does that, it attempts to do so as securely as possible, rather than as fast as possible. no cap, security is the main character here 🔥

🦋 RETURN VALUES 🦋

libkeccak_hmac_update() returns 0 upon successful completion. on error, -1 is returned and errno is set to describe the error. that’s the whole vibe check 😭

🌈 ERRORS 🌈

libkeccak_hmac_update() may fail for any reason specified by the function malloc(3). yep, that’s the whole note — malloc(3) said “iykyk” 💀

⭐ NOTES ⭐

🚨 neither parameter may be NULL or 0. the page says it, so we’re saying it, bestie — don’t test it 🙈

👑 SEE ALSO 👑

• libkeccak_hmac_create(3)
• libkeccak_hmac_initialise(3)
• libkeccak_hmac_digest(3)
• libkeccak_hmac_fast_update(3)

xoxo, your Unix bestie 💅 — source/version LIBKECCAK, tag LIBKECCAK_HMAC_UPDATE(3), and the footer didn’t show a date, so consider this sign-off officially undated 🫶🎀