KCAPI_MD_SHA3_384(3)

✨ KCAPI_MD_SHA3_384 ✨

okay bestie, welcome to kcapi_md_sha3_384 — the one-shot SHA3-384 message digest situation, straight out of the Programming Interface manual, section 3 💅

---

🎀 NAME 🎀

kcapi_md_sha3_384 — SHA3-384 message digest on one buffer. one buffer. that's it. that's the whole vibe. 🦋

---

🌸 SYNOPSIS 🌸

ssize_t kcapi_md_sha3_384(const uint8_t * in, size_t inlen,
                          uint8_t * out, size_t outlen);

---

💖 ARGUMENTS 💖

• in — [in] the buffer holding your input data 🫶
• inlen — [in] how long that input buffer is, in bytes
• out — [out] the buffer where the message digest lands ✨
• outlen — [in] the length of out, queen

---

👑 DESCRIPTION 👑

So like, this is a one-shot convenience function, meaning you show up, hand it a buffer, and it generates a message digest of that buffer. no drama, no setup arc, just digest. periodt.

the catch tho: the output buffer must be allocated by the caller. that's you. you're the caller. and it has to have at least the length of the message digest size for the chosen message digest — so for SHA3-384, don't be out here handing it a thimble, bestie 😭

and here's the return tea:

return size of message digest upon success; -EIO — data cannot be obtained; -ENOMEM — buffer is too small for the complete message digest, the buffer is filled with the truncated message digest 💀

like, -ENOMEM isn't a total loss, it still fills your buffer with the truncated digest, but it's giving "we ran out of room" energy. noted. 🍓

---

🌈 AUTHOR 🌈

Stephan Mueller <smueller@chronox.de>

• Author. iconic behavior, fr fr 👑

---

💜 COPYRIGHT 💜

that's the whole page, bestie — no cap, every flag and fact accounted for 🧚

this was libkcapi Manual version 1.5.0, dated July 2025, and you've been reading KCAPI_MD_SHA3_384(3) the entire time 💅✨ slay responsibly.