xe_exec_queue_lrc(9)

💅 xe_exec_queue_lrc (9) — get that LRC out of your exec queue, bestie

okay so this is a page from the Kernel API Manual, and it's genuinely one of the shorter ones — like, a little snack of a manpage. but don't let the length fool you, there's lore here. 🫶

---

✨ NAME ✨

xe_exec_queue_lrc — Get the LRC from exec queue. that's it, that's the whole job. 🎀

---

🌸 SYNOPSIS 🌸

struct xe_lrc * xe_exec_queue_lrc (struct xe_exec_queue *q );

like yes bestie the spacing in that signature is a whole vibe, we keep it exactly as-is. 💅

---

🦋 ARGUMENTS 🦋

• q — The exec queue instance. that's your queue, your girl, the thing you're pulling the LRC out of. 💖

---

⭐ DESCRIPTION ⭐

so what does it actually do? it retrieves the primary LRC for the exec queue. simple, iconic, done. 👑

but here's the part where you gotta pay attention, because this is the classic trap:

this function returns only the first LRC instance, even when multiple parallel LRCs are configured. so if you've got a whole squad of parallel LRCs going? this one's only grabbing the first one. no cap, that's literally all you get. 😭

and the other big thing — it does not increment the reference count. so the reference can just be forgotten after use. like, no refcount bookkeeping needed, you can just let it go. it's giving "no strings attached" energy, which is honestly kind of refreshing ngl. ✨

---

💀 RETURN 💀

• Pointer to LRC on success 🔥
• error on failure 💀

(no in-between. it either slays or it doesn't.)

---

🌈 SEE ALSO 🌈

okay this is where the page goes absolutely feral — look at this friend group. this function knows everyone. 🧚

• Kernel file ./drivers/gpu/drm/xe/xe_exec_queue.c
• Execution Queue(9)
• Multi Queue Group(9)
• xe_exec_queue_get_lrc(9)
• xe_exec_queue_create(9)
• xe_exec_queue_create_class(9)
• xe_exec_queue_create_bind(9)
• xe_exec_queue_destroy(9)
• xe_exec_queue_fini(9)
• xe_exec_queue_assign_name(9)
• xe_exec_queue_lookup(9)
• xe_exec_queue_device_get_max_priority(9)
• xe_exec_queue_set_property_ioctl(9)
• xe_exec_queue_create_ioctl(9)
• xe_exec_queue_get_property_ioctl(9)
• xe_exec_queue_is_lr(9)
• xe_exec_queue_is_idle(9)
• xe_exec_queue_update_run_ticks(9)
• xe_exec_queue_kill(9)
• xe_exec_queue_destroy_ioctl(9)
• xe_exec_queue_last_fence_put(9)
• xe_exec_queue_last_fence_put_unlocked(9)
• xe_exec_queue_last_fence_get(9)
• xe_exec_queue_last_fence_get_for_resume(9)
• xe_exec_queue_last_fence_set(9)
• xe_exec_queue_tlb_inval_last_fence_put(9)
• xe_exec_queue_tlb_inval_last_fence_put_unlocked(9)
• xe_exec_queue_tlb_inval_last_fence_get(9)
• xe_exec_queue_tlb_inval_last_fence_set(9)
• xe_exec_queue_contexts_hwsp_rebase(9)

like, thirty entries. thirty. she's popular, okay? let her have this. 🎀✨

---

and that's the whole page, bestie 💜 cute little sign-off time: this one lives over in ./drivers/gpu/drm/xe, it's dated October 2026, and it's filed under xe_exec_queue_lrc(9). mwah, go forth and grab that primary LRC 🫶🌸