uv_retrieve_secret(9)

bestie, welcome to uv_retrieve_secret(9) — it's from the Kernel API Manual, and it's literally the glow-up for grabbing a secret value by its index. 💖

✨ NAME ✨

uv_retrieve_secret — get the secret value for the secret index. 🔐

📜 SYNOPSIS 📜

int uv_retrieve_secret (u16 secret_idx , u8 *buf , size_t buf_size );

🫶 ARGUMENTS 🫶

• secret_idx — Secret index for which the secret should be retrieved. like, which secret are we pulling today? 👀
• buf — Buffer to store retrieved secret. this is where the secret lands, bestie. 🎀
• buf_size — Size of the buffer. The correct buffer size is reported as part of the result from uv_get_secret_metadata. that's where the correct number lives, iykyk. 🦋

💅 DESCRIPTION 💅

Calls the Retrieve Secret UVC and translates the UV return code into an errno. that's the whole vibe: call the UVC, then turn that UV return code into an errno. slay. ✨

😴 CONTEXT 😴

might sleep. literally might sleep, so don't act surprised. 💀

🌈 RETURN 🌈

• 0 — Entry found; buffer contains a valid secret. we love a successful retrieval, no cap. 💖
• ENOENT — No entry found or secret at the index is non-retrievable. the secret said “not today” 🙈
• ENODEV — Not supported: UV not available or command not available. this environment is not giving supported vibes 😭
• EINVAL — Buffer too small for content. your buf_size needs to eat more, bestie 🍓
• EIO — Other unexpected UV error. unexpected UV error behavior, not iconic 💀

👑 SEE ALSO 👑

Kernel file ./arch/s390/kernel/uv.c — plus __make_folio_secure(9), s390_wiggle_split_folio(9), and uv_find_secret(9). go off, kernel docs 🫶

made with 💖 from the ./arch/s390/kernel crew, October 2026 edition. mwah 💋