xe_guc_capture_getlist(9)

💅 xe_guc_capture_getlist 💅

okay so this is a page from the Kernel API Manual bestie, and it's all about one very specific little function in the xe graphics driver stack. it's giving "niche but essential" and honestly? we respect it 🫶

---

✨ NAME ✨

xe_guc_capture_getlist — literally just: get the register capture list for an owner/type/class combination. that's the whole vibe. no cap 💖

---

🌸 SYNOPSIS 🌸

int xe_guc_capture_getlist (struct xe_guc *guc , u32 owner , u32 type ,
enum guc_capture_list_class_type capture_class , void **outptr );

she takes five arguments and returns an int, periodt. 🎀

---

🦋 ARGUMENTS 🦋

• guc — the GuC object itself. the main character of this whole operation 👑
• owner — the PF/VF owner. like, whose list is this anyway
• type — the GuC capture register type 🌈
• capture_class — the GuC capture engine class id, an enum guc_capture_list_class_type if you're fancy
• outptr — points to the cached register capture list. this is where the good stuff lands ✨

---

💜 DESCRIPTION 💜

so what does she actually do? this function will get the register capture list for the owner/type/class combination. that's it, that's the whole job, and she does it flawlessly. iykyk 💅

fr fr, that's the entire documented behaviour — no secret extra steps, no hidden side quests. we love a focused queen.

---

🔥 RETURN 🔥

• 0 on success 🎉
• a negative error code on failure 😭

that's the classic "zero means we ate, negative means we did not" situation, and honestly it's iconic.

---

⭐ SEE ALSO ⭐

the kernel file lives right here, bestie:

• ./drivers/gpu/drm/xe/xe_guc_capture.c

and the whole friend group shows up too:

• xe_guc_capture_getlistsize(9)
• xe_guc_capture_getnullheader(9)
• xe_guc_capture_ads_input_worst_size(9)
• Init, G2H-event and reporting flows for GuC-error-capture(9)
• xe_engine_manual_capture(9)
• xe_engine_snapshot_print(9)
• xe_guc_capture_get_matching_and_lock(9)
• xe_engine_snapshot_capture_for_queue(9)

lowkey an entire squad 🫶🌸

---

and that's the page!! sourced from ./drivers/gpu/drm/xe, dated October 2026, and yes it's xe_guc_capture_getlist(9) — go forth and capture those registers responsibly, bestie 🧚💖