xe_guc_using...mctrl_queues(9)

💅 xe_guc_using_main_gamctrl_queues(9) — the "which queues tho" check 💅

okay bestie, so this one's a kernel API page from the manual, and it's lowkey a little baddie. it lives in the kernel docs, section 9, and the whole name is xe_guc_using_main_gamctrl_queues — the header up top just abbreviates it to xe_guc_using...mctrl_queues(9) because apparently even man pages get tired. anyway. let's go 🎀

---

✨ NAME ✨

xe_guc_using_main_gamctrl_queues — literally just: detect which reporting queues to use. that's the whole vibe. 🦋

---

🌸 SYNOPSIS 🌸

so you call it like this, no cap:

bool xe_guc_using_main_gamctrl_queues(struct xe_guc *guc);

returns a bool, takes one pointer to a struct xe_guc. simple. iconic. periodt. ✨

---

💖 ARGUMENTS 💖

• guc — The GuC object. that's it, that's the whole argument list. one (1) guy. go off king 👑

---

🧚 DESCRIPTION 🧚

okay so here's the tea, and honestly it's giving "we're upgrading the whole setup" 🫶

For Xe3p and beyond, we want to program the hardware to use the "Main GAMCTRL queue" rather than the legacy queue — and we gotta do it before we upload the GuC firmware. the way that timing matters... 😭

why tho? because this lets the GuC use a new set of registers for pagefault handling, and it also helps us avoid some unnecessary complications with MCR register range handling. so like, fewer headaches. cleaner vibes. we love that for us. 💅

fr fr, the order is the whole point — main GAMCTRL queue gets set up before the GuC firmware upload. don't be out here doing it backwards 🙈

---

⭐ RETURN ⭐

returns true if we can use the new main gamctrl queues. yes, that's the entire return contract. short and slay. 🔥

---

🌈 SEE ALSO 🌈

the whole friend group, in a kernel file called ./drivers/gpu/drm/xe/xe_guc.c:

• xe_guc_comm_init_early(9)
• xe_guc_init_post_hwconfig(9)
• xe_guc_min_load_for_hwconfig(9)
• xe_guc_softreset(9)
• xe_guc_runtime_suspend(9)
• xe_guc_runtime_resume(9)
• xe_guc_declare_wedged(9)
• xe_hwe_guc_logical_instance(9)

go read those too, iykyk 💜

---

🎀 cute sign-off time 🎀 this page lives under ./drivers/gpu/drm/xe, and the footer stamps it October 2026. you're welcome, bestie. now go use the main gamctrl queues and be iconic about it 💖✨👑