STRUCT GUC_DEBUG_CAPTURE_LIST(9)

💅 struct guc_debug_capture_list(9) — the Kernel API Manual, but make it cute ✨

okay so bestie, welcome to the Kernel API Manual 🎀 — today's main character is struct guc_debug_capture_list, and honestly? she's giving "quietly essential" and we're obsessed. 🦋

---

✨ NAME ✨

struct guc_debug_capture_list — Debug capture list 🫶 like, the literal name, no cap.

---

🌸 SYNOPSIS 🌸

here's the whole glow-up, verbatim, don't touch:

struct guc_debug_capture_list {
    struct guc_debug_capture_list_header header;
    struct guc_mmio_reg regs[];
};

that's her. that's the struct. 💖

---

🧚 Members 🧚

• header — the Debug capture list header. yeah, she's a struct guc_debug_capture_list_header, and she goes first. lead with confidence. 👑
• regs — the MMIO descriptors in the capture list ✨ this is the flexible array member at the end, iykyk.

---

💜 Description 💜

okay so here's the lore 🔥 — as part of ADS registration, these header structures (followed by an array of 'struct guc_mmio_reg' entries) are used to register with the GuC microkernel the list of registers we want it to dump out prior to an engine reset. 💀

like literally, the whole vibe is: "hey GuC bestie, here's the register list, pls dump these before the engine reset k thx bye" 😭🙈 — header first, then the array right behind it. no cap. 🫶

---

🦋 SEE ALSO 🦋

the whole friend group, fr fr — go say hi to:

• Kernel file ./drivers/gpu/drm/xe/abi/guc_capture_abi.h 📁
• struct guc_mmio_reg(9)
• struct guc_mmio_reg_set(9)
• struct guc_debug_capture_list_header(9)
• struct guc_state_capture_header_t(9)
• struct guc_state_capture_t(9)
• struct guc_state_capture_group_header_t(9)
• struct guc_state_capture_group_t(9)

they're all iconic, they all ate, periodt. 💅⭐

---

🌈 and that's the whole page, bestie — every member, every reference, nothing skipped, nothing invented. you're welcome 🫶

---

🎀 cute lil sign-off 🎀 — this one lives over in ./drivers/gpu/drm/xe/abi and it's dated October 2026 ✨, and yes struct guc_...capture_list(9) is her full government name in the header, we don't make the rules 😭💖 bye bestie!! 🌸🦋💜