KCAPI_RNG_GET_BYTES(3)

KCAPI_RNG_GET_BYTES 💖✨

okay bestie, welcome to section 3 of the Programming Interface manual, and today's main character is kcapi_rng_get_bytes — yes, the one and only convenience function to generate random bytes. she's short, she's sweet, she's giving ✨ effortless ✨. let's get into it 🎀

---

✨ SYNOPSIS ✨

ssize_t kcapi_rng_get_bytes(uint8_t * buffer, size_t outlen);

like. two arguments. that's it. no cap, she's lowkey minimal 💅

---

🌸 ARGUMENTS 🌸

• buffer — [out] this one gets filled with the random number. she's the output girlie, she receives 🫶
• outlen — [in] the buffer length. you're telling her how much room she's got to work with 📏

---

🦋 DESCRIPTION 🦋

so basically? this convenience function generates random bytes of the size of outlen and stores them into the provided buffer. that's the whole vibe. she generates, she stores, she serves 🧚

⭐ and the return value? on success you get the size of the random number generated. but if it goes sideways you get -EIO, which means the data cannot be obtained 😭 not me crying over an I/O error fr fr.

---

👑 AUTHOR 👑

Stephan Mueller <smueller@chronox.de>

• Author.

iconic behavior honestly, we stan 💜

---

and that's the whole page bestie!! this was the libkcapi Manual, version 1.5.0, dated July 2025 — written with love, randomness, and zero boring manpage energy 🌈💖 periodt ✨🦋