xe_guc_captu...ing_and_lock(9)

✨ xe_guc_capture_get_matching_and_lock(9) ✨

okay so bestie, welcome to the Kernel API Manual 💖 this is one of those pages from the kernel docs, and honestly it's a whole little baddie. it's literally called xe_guc_capture_get_matching_and_lock (9) and yes the header on the page is kinda slay-truncated as xe_guc_captu...ing_and_lock(9) — that's just how it's printed, not a typo, iykyk 🎀

---

🌸 NAME 🌸

xe_guc_capture_get_matching_and_lock — Matching GuC capture for the queue. literally what it says on the tin, no cap 💅

---

🦋 SYNOPSIS 🦋

struct __guc_capture_parsed_output *
xe_guc_capture_get_matching_and_lock (struct xe_exec_queue *q );

like, it hands you back a struct __guc_capture_parsed_output * and it takes a struct xe_exec_queue *q, periodt ✨

---

🎀 ARGUMENTS 🎀

• q — the exec queue object 🫶 that's the one thing you pass in, she's the main character here

---

👑 DESCRIPTION 👑

so what does she actually do? she searches within the capture outlist for the queue 🔍 could be used for check if GuC capture is ready for the queue — yes bestie, that's a vibe check on whether the GuC capture is ready for that queue 👀

and if it is found? the locked boolean of the node will be flagged 🚩 like, not me just flagging the locked boolean, but that's literally the assignment and she ate 💅

---

💀 RETURN 💀

found guc-capture node ptr else NULL — so you either get the found guc-capture node pointer, or you get NULL, there is no in-between, fr fr 😭

ngl bestie, always check for that NULL before you go dereferencing anything, that's a whole heartbreak waiting to happen 🙈

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_guc_capture.c 📁

and the whole friend group, obviously:

• xe_guc_capture_getlistsize(9)
• 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_engine_snapshot_capture_for_queue(9)

---

okay that's the whole page, you're officially educated 🧚‍♀️ this masterpiece lives over in ./drivers/gpu/drm/xe and the footer says October 2026 with the page tag xe_guc_captu...ing_and_lock(9) — so like, dated October 2026, iconic, no notes 💜 bye bestie, go read the source, mwah 🍓