papr_rtas_retrieve(9)

✨ papr_rtas_retrieve(9) ✨

okay so this is a kernel API manual page, section 9, and the star of the show is papr_rtas_retrieve 💖 bestie, get comfy.

---

🌸 NAME 🌸

papr_rtas_retrieve — literally returns the data blob that's exposed to user space 🫶 no cap, that's the whole job.

---

🎀 SYNOPSIS 🎀

const struct papr_rtas_blob * papr_rtas_retrieve (struct
papr_rtas_sequence *seq );

look at her. iconic signature. she takes one seq and hands you back a const struct papr_rtas_blob * 💅

---

🦋 ARGUMENTS 🦋

• seq — RTAS call specific functions that get invoked until the sequence is completed ✨ think of it as the little to-do list of calls that keeps running until the sequence is done.

---

⭐ DESCRIPTION ⭐

So what she does is run sequences against param — running them until one of these three things happens, periodt:

1. a blob is successfully instantiated 💖
2. a hard error is encountered 💀
3. a fatal signal is pending 😭

whichever hits first, that's when she stops. main character energy honestly.

---

🌈 CONTEXT 🌈

May sleep. 😴 yes bestie, she is allowed to sleep. plan accordingly.

---

👑 RETURN 👑

• On success? A fully populated data blob 🎀 slay.
• Otherwise? An encoded error pointer 🙈 so like, check that return value, iykyk.

---

💜 SEE ALSO 💜

• Kernel file ./arch/powerpc/platforms/pseries/papr-rtas-common.c
• papr_rtas_blob_extend(9)
• papr_rtas_blob_generate(9)
• papr_rtas_run_sequence(9)
• papr_rtas_setup_file_interface(9)

go read the whole friend group, they're all certified bangers 🔥

---

okay and the cute lil sign-off: this one lives over in ./arch/powerpc/platforms/pseries, dated October 2026, and it's the papr_rtas_retrieve(9) page, fr fr 🧚‍♀️💜 bye bestie, go instantiate some blobs ✨