KCAPI_RNG_SEED(3)

💖 kcapi_rng_seed(3) — from the libkcapi Programming Interface 💖

okay bestie, buckle up, we're seeding an RNG and honestly? it's giving main character energy 🔥

---

✨ NAME ✨

kcapi_rng_seed — seed the RNG 🎲

---

🌸 SYNOPSIS 🌸

int kcapi_rng_seed(struct kcapi_handle * handle, uint8_t * seed,
                   uint32_t seedlen);

---

🎀 ARGUMENTS 🎀

• handle — [in] the cipher handle, your little backstage pass 💅
• seed — [in] seed data 🌱
• seedlen — [in] size of seed 📏

---

🦋 DESCRIPTION 🦋

okay so listen, this is not a "call it if you feel like it" situation. This call must be called to initialize the selected RNG. like, mandatory mandatory. no skipping 🙅♀️

when the SP800-90A DRBG is the one in play, this call makes the DRBG seed itself from the internal noise sources. it's literally pulling up its own vibes from inside 🌈✨

and another thing — when you're using the SP800-90A DRBG, the seed buffer may be NULL. yes, NULL, it's allowed, she's flexible 💁♀️ but if it's not NULL, then the DRBG takes your given data and uses it either as a personalization string in the case of the initial seeding, or as additional data for reseeding. either way, your data is getting a job 🫶

and it returns:

• 0 upon success 🎉
• a negative errno-style error code if an error occurred 😭

ngl bestie, remember that return value check. zero is the slay, negative is the "we have a problem" 💀

---

👑 AUTHOR 👑

Stephan Mueller <smueller@chronox.de>

• Author. 💜

---

🌈 COPYRIGHT 🌈

that's the whole page, bestie!! ✨

libkcapi Manual 1.5.0 — July 2025 🎀 go forth and seed responsibly, ily 💖🦋