KCAPI_MD_SHA3_256(3)

💖 KCAPI_MD_SHA3_256 — the manual page, bestie edition 💖

okay so this is KCAPI_MD_SHA3_256(3), section 3, and it's literally one of the most chill functions in the whole libkcapi lineup. no cap.

---

✨ NAME ✨

kcapi_md_sha3_256 — SHA3-256 message digest on one buffer 🎀

like. one buffer. one digest. one function call. it's giving low-effort-high-reward and we're obsessed.

---

✨ SYNOPSIS ✨

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

---

✨ ARGUMENTS ✨

• in — [in] the buffer holding your input data 🫶 hand it over, bestie
• inlen — [in] how long that input buffer is
• out — [out] the buffer where the message digest gets written 💅 you're providing this one
• outlen — [in] the length of out

---

✨ DESCRIPTION ✨

so with this one-shot convenience function, a message digest of the given buffer gets generated. that's it. that's the whole vibe. 🦋

the output buffer? you allocate it, bestie, not the library. and it has to be at least the length of the message digest size for the chosen message digest. if it's not... well, we'll get to that. 😭

what it returns:

• the size of the message digest upon success ✨ (slay)
• -EIO — data cannot be obtained 😔
• -ENOMEM — the buffer is too small for the complete message digest, and heads up: the buffer gets filled with the truncated message digest

so like, -ENOMEM isn't a total wipeout here — you still get something in your buffer, just the truncated version of the digest. but also... girl, size your buffer right the first time. 💀

---

✨ AUTHOR ✨

Stephan Mueller <smueller@chronox.de>

• Author.

periodt. the icon who wrote this. 👑

---

✨ COPYRIGHT ✨

that's the whole page, bestie, hope it ate 🌈

this was the libkcapi Manual version 1.5.0, from July 2025 — go forth and hash responsibly, ily 💜🧚

---

KCAPI_MD_SHA3_256(3) — Programming Interface 🌸