uv_list_secrets(9)

💅 uv_list_secrets — the Kernel API Manual girlies are gonna eat this UP

Ok so bestie, welcome to uv_list_secrets(9) — yes it's a real one, no I'm not kidding, and yes it's giving "ultraviolet secret list realness" 🔥

---

✨ NAME ✨

uv_list_secrets — literally just "Do a List Secrets UVC." That's the whole vibe. Iconic, concise, no notes 🎀

---

🌸 SYNOPSIS 🌸

int uv_list_secrets (struct uv_secret_list *buf , u16 start_idx , u16
*rc , u16 *rrc );

Look at her. Four params, one int return, zero drama. Slay 💅

---

🦋 ARGUMENTS 🦋

• buf — the buffer you're writing the list into. Heads up: it's gotta be the size of one page, ok? Not vibes-sized, page-sized 🫶
• start_idx — the SMALLEST index that should be included in the list. For the first call? Use 0. Just 0. That's it, that's the whole thing ✨
• rc — pointer to store the return code, or NULL if you're not about that life 🙈
• rrc — pointer to store the return reason code, or NULL if you also don't care about that 😭

---

💖 DESCRIPTION 💖

So what this function actually does: it calls the List Secrets UVC. That's the whole job. Very main character energy 👑

The result gets written into buf, and buf needs to be at least one page of writable memory. Not optional, not negotiable, not "ehh probably fine" — at least one page, writable, periodt.

And buf is built out of these, in this order:

• struct uv_secret_list_hdr
• struct uv_secret_list_item (multiple — yes, multiple, she can hold more than one 🍓)

For start_idx, use _0_ on the first call. Easy.

Now here's the tea ☕ — if there are more secrets available but they couldn't fit into the page, then rc comes back as UVC_RC_MORE_DATA. And when that happens? You take uv_secret_list_hdr.next_secret_idx and feed it right back in as your start_idx. Loop it, bestie 🔁✨

---

🌈 CONTEXT 🌈

might sleep.

(Yeah. That's it. That's the whole context. She's lowkey sleepy, respect it 😴💜)

---

⭐ RETURN ⭐

The UVC condition code. That's what comes back. That's the answer 🎀

---

👑 SEE ALSO 👑

Kernel file ./arch/s390/include/asm/uv.h — go read her, she has lore 🧚

---

💀 fr fr do NOT forget that buf has to be a full page of writable memory. Not me warning you twice. Okay maybe I am warning you twice. You're welcome 🫶

---

🌸 That's the page!! Brought to you by the fine folks at ./arch/s390/include/asm, dated October 2026 — mwah, love that for us, bye bestie!! 💅✨🎀