xe_guc_capture_getlistsize(9)

💅 xe_guc_capture_getlistsize(9) 💅

okay so bestie, welcome to the Kernel API Manual ✨ this one's a function page, and honestly she's a little低调 queen — short, sweet, does exactly one thing. let's get into it 🫶

---

🌸 NAME 🌸

xe_guc_capture_getlistsize — literally just: get the list size</> for the owner/type/class combination. that's the whole vibe. 💅

---

✨ SYNOPSIS ✨

int xe_guc_capture_getlistsize (struct xe_guc *guc , u32 owner , u32
       type , enum guc_capture_list_class_type capture_class , size_t *size );

she takes five things and gives you back an int, no cap 😌

---

🎀 ARGUMENTS 🎀

• guc — the GuC object itself, your main character 💖
• owner — PF/VF owner, iykyk 👑
• type — the GuC capture register type 🦋
• capture_class — the GuC capture engine class id, typed as an enum guc_capture_list_class_type 🌈
• size — a pointer to the size. yes bestie, a <italic>pointer</> — she writes into it, she doesn't return it 🙈

---

🔥 DESCRIPTION 🔥

so what does she actually do? this function grabs the list for that owner/type/class combination and hands you back the page aligned list size. that's it, that's the whole plot ✨ lowkey iconic for how tidy it is 💅

---

⭐ RETURN ⭐

• 0 — success, we love a clean win 🎉
• a negative error code — failure, and yes she will let you know 😭

---

🦋 SEE ALSO 🦋

the kernel file lives right here, go read her friends:

• Kernel file ./drivers/gpu/drm/xe/xe_guc_capture.c 📁
• xe_guc_capture_getlist(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)

like, the whole GuC-error-capture</> friend group fr fr 🫶

---

ngl bestie, if the return value is negative, do not pretend the size you got is real. check the code, handle the error, be a responsible little kernel dev 💀

---

and that's the page!! 🌸 source/version: ./drivers/gpu/drm/xe — dated October 2026</> 🎀 mwah, slay, periodt 💖✨