xe_gt_record_user_engines(9)

xe_gt_record_user_engines(9) 💖

okay bestie, welcome to the Kernel API Manual page for xe_gt_record_user_engines(9) — yes, the title is right there, we’re being iconic and organized ✨

---

✨ NAME ✨

xe_gt_record_user_engines — save data related to engines available to userspace 🎀

---

🌸 SYNOPSIS 🌸

void xe_gt_record_user_engines (struct xe_gt *gt );

---

💅 ARGUMENTS 💅

• gt — GT structure. Like, the GT structure itself, main character energy 👑

---

🦋 DESCRIPTION 🦋

okay so what this function does is walk the available HW engines from gt->info.engine_mask and calculate data related to those engines that may be used by userspace. That’s the whole mission, and it ate. 💫

Use it whenever available engines change in runtime (e.g. with ccs_mode) or during initialization. No cap, that’s the vibe check for when it gets called. 🫶

---

🎀 SEE ALSO 🎀

• Kernel file ./drivers/gpu/drm/xe/xe_gt.h
• xe_gt_wait_for_reset(9)
• xe_gt_reset(9)
• xe_gt_any_hw_engine_by_reset_domain(9)
• xe_gt_any_hw_engine(9)
• xe_gt_recovery_pending(9)
• xe_gt_supports_multi_queue(9)

---

kisses, this page is from the ./drivers/gpu/drm/xe source tree — October 2026 edition, page xe_gt_record_user_engines(9). 💅🎀