xe_exec_que...ueue_primary(9)

💅 xe_exec_queue_multi_queue_primary(9) — from the Kernel API Manual, bestie 🎀

okay so this one is a tiny little function but it's giving "small but mighty" energy, and honestly? we're obsessed. it lives in the kernel API manual, it's got a nine in parentheses which means it's A Kernel Thing, and it's about 🦋 exec queues 🦋 — specifically, getting the primary queue out of a multi queue group. let's get into it ✨

---

🌸 SYNOPSIS 🌸

struct xe_exec_queue * xe_exec_queue_multi_queue_primary (struct xe_exec_queue *q );

like, it takes one struct xe_exec_queue * and hands you back a struct xe_exec_queue *. simple. clean. iconic. periodt 💅

---

🎀 ARGUMENTS 🎀

• q — the exec_queue. that's it, that's the whole argument. she's the main character and we're just here for the ride 🫶

---

✨ DESCRIPTION ✨

so here's the vibe check 👑: if q belongs to a multi queue group, then the primary queue of the group gets returned to you. no cap, that's literally it.

but if q is not part of a multi queue group? then you just get q right back. she returns herself. self-love, we stan 😭💖

so basically: you either get the primary queue of the group, or you get your own queue back unchanged. either way you're walking away with a struct xe_exec_queue *, and that's a slay 🌈

---

🔥 SEE ALSO 🔥

• the kernel file itself, bestie: ./drivers/gpu/drm/xe/xe_exec_queue.h
• xe_exec_queue_is_multi_queue(9) — for when you need to know if something's even in a multi queue group 👀
• xe_exec_queue_is_multi_queue_primary(9) — checking if a queue is the primary one 💖
• xe_exec_queue_is_multi_queue_secondary(9) — and checking if it's the secondary one 🦋

---

ngl, these four functions are a whole friend group and they all reference each other. iykyk 💀

---

and that's the page!! written by the crew over at ./drivers/gpu/drm/xe, dated October 2026, and yes the footer still spells it xe_exec_que...ueue_primary(9) — truncated title and all, we love a consistent aesthetic ✨🎀 see u in the next manpage bestie 🫶💜