rtas_ibm_platform_dump(9)

✨ rtas_ibm_platform_dump(9) — bestie edition ✨

okay so welcome to the Kernel API Manual page for rtas_ibm_platform_dump(9), where the assignment is literally "call ibm,platform-dump to fill a work area buffer" and we are going to understand it. 💅

---

🌸 NAME 🌸

rtas_ibm_platform_dump — call ibm,platform-dump to fill a work area buffer. That's the whole vibe, no cap. 💖

🎀 SYNOPSIS 🎀

int rtas_ibm_platform_dump (struct ibm_platform_dump_params *params ,
phys_addr_t buf_addr , u32 buf_length );

🫶 ARGUMENTS 🫶

• params — see struct ibm_platform_dump_params. 👀
• buf_addr — address of the dump buffer (work_area). 📍
• buf_length — length of the buffer in bytes (min. 1024). 🔢

💫 DESCRIPTION 💫

It calls ibm,platform-dump until it errors or successfully deposits data into the supplied work area. It handles RTAS retry statuses, and maps RTAS error statuses to reasonable errno values. Very "I got this, bestie" of it. ✨

You can request multiple dumps with different dump IDs at the same time, but not with the same dump ID — that's prevented with the check in the ioctl code (papr_platform_dump_create_handle). 🚫

The caller should inspect params.status to determine whether more calls are needed to complete the sequence. Yes, it's a whole "check the vibe as you go" situation. 👑

😴 CONTEXT 😴

May sleep. Literally may sleep — plan accordingly. 💤

🔥 RETURN 🔥

• -ve on error
• 0 for dump complete
• 1 for continue dump

👑 SEE ALSO 👑

• Kernel file ./arch/powerpc/platforms/pseries/papr-platform-dump.c
• struct ibm_platform_dump_params(9)
• papr_platform_dump_create_handle(9)

---

Cute sign-off: this page lives in the ./arch/powerpc/platforms/pseries corner of the Kernel API Manual, dated October 2026, and it's titled rtas_ibm_platform_dump(9) — periodt. 💅✨