xe_hw_engin...shot_capture(9)

💅 xe_hw_engine_snapshot_capture — Kernel API Manual

okay so bestie, welcome to the Kernel API Manual ✨ this one's a lil function page for xe_hw_engine_snapshot_capture, and the header up top is so long it got its vibe check cut off (xe_hw_engin...shot_capture(9), she's giving "text message truncated"). don't worry, we know her full name. 🎀

---

✨ NAME ✨

xe_hw_engine_snapshot_capture — take a quick snapshot of the HW Engine. like a lil polaroid but for hardware 🦋

---

🌸 SYNOPSIS 🌸

struct xe_hw_engine_snapshot * xe_hw_engine_snapshot_capture (struct
xe_hw_engine *hwe , struct xe_exec_queue *q );

---

🎀 ARGUMENTS 🎀

• hwe — the Xe HW Engine. yes bestie, the actual engine, main character energy 👑
• q — the exec queue object. she's coming along for the ride 💅

---

🦋 DESCRIPTION 🦋

you grab your snapshot now, and it can be printed out at a later stage — like during dev_coredump analysis. so it's literally "save it for later" but make it kernel dev 🔥

---

💖 RETURN 💖

returns a Xe HW Engine snapshot object 💫 and the caller must free it, using xe_hw_engine_snapshot_free. no cap, if you don't free it that's a leak and we don't do that here 🙈

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_hw_engine.c 📁
• xe_hw_engine_mmio_read32(9)
• xe_hw_engine_snapshot_free(9)
• xe_hw_engine_print(9)
• xe_hw_engine_lookup(9)

---

bestie reminder: grab the snapshot, print it later, free it with xe_hw_engine_snapshot_free. that's the whole loop, slay ✨

---

and that's the page, periodt 💜 this lil drop came from ./drivers/gpu/drm/xe, dated October 2026, filed under the Kernel API Manual. mwah, go snapshot something 🫶