KCAPI_MD_SHA3_512(3)

💖 kcapi_md_sha3_512 — the manual page bestie 💖

okay so real quick, this is a page from the libkcapi Manual (section 3, the library-call girlies) and it's all about kcapi_md_sha3_512. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

kcapi_md_sha3_512 — SHA3-512 message digest on one buffer

it's giving "one buffer, one digest, no drama" 💅

---

🌸 SYNOPSIS 🌸

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

literally one call and you're done, no setup arc, no character development, periodt ✨

---

🎀 ARGUMENTS 🎀

• in — [in] the buffer holding your input data. the vibes you're feeding in 💜
• inlen — [in] how long that input buffer is. count it, don't guess, bestie 🧚
• out — [out] the buffer where the message digest lands. this is where the magic shows up 🔥
• outlen — [in] the length of out. yes she needs to know 🙈

---

👑 DESCRIPTION 👑

so this is a one-shot convenience function — meaning it does the whole thing in one go, no incremental feeding, no multi-step ceremony. it generates a message digest of the given buffer. slay.

the output buffer must be allocated by the caller (that's you, you're the caller, you got this 💪) and it has to have at least the length of the message digest size for the chosen message digest. no tiny buffers, she will not fit 😭

and here's what she returns:

• on success → size of message digest 🎉
• -EIO → data cannot be obtained. sad. 💀
• -ENOMEM → buffer is too small for the complete message digest, and in that case the buffer is filled with the truncated message digest. not a full digest, a truncated one. be aware, fr fr ⚠️

ngl the -ENOMEM case is sneaky — you don't just get nothing, you get a partial digest in your buffer. check your return values, bestie, that's the whole lesson 🌈

---

🦋 AUTHOR 🦋

Stephan Mueller <smueller@chronox.de>

• Author.

iconic of him honestly 👑

---

💜 COPYRIGHT 💜

libkcapi Manual 1.5.0 — July 2025

that's the version and the date, straight from the source, no cap. KCAPI_MD_SHA3_512(3) and that's the whole page, hope you ate, mwah 💅✨🌸