xe_guc_submit_init(9)

💅 xe_guc_submit_init(9)

okay so this is a page from the Kernel API Manual (that's the manual name, bestie, consider it folded in 🫶) and it's all about one tiny little function that gets GuC submission up and running. It's giving "setup era" and honestly? iconic.

---

✨ NAME ✨

xe_guc_submit_init — Initialize GuC submission.

That's it. That's the whole job. She initializes. She submits. She slays.

---

🌸 SYNOPSIS 🌸

int xe_guc_submit_init (struct xe_guc *guc , unsigned int num_ids );

---

🎀 ARGUMENTS 🎀

• guc — the xe_guc you wanna initialize. Like, the actual thing getting set up. Your main character struct 💖
• num_ids — number of GuC context IDs to use. How many IDs we giving her? You decide, bestie.

---

🦋 DESCRIPTION 🦋

So here's the vibe check 👑: the bare-metal driver or the PF driver can pass ~0 as num_ids to say "hey, just use all the GuC context IDs that the GuC firmware supports for submission." No cap, that's the flex — let the firmware tell you what's available and take the whole buffet.

Only VF drivers have to actually sit down and provide an explicit number of GuC context IDs that they can use for submission. Like, VF drivers don't get the "surprise me" option, they gotta do the math themselves 🙈.

---

⭐ RETURN ⭐

0 on success, or a negative error code on failure. That's the whole report card — zero means she ate, negative means something went sideways 😭

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_guc_submit.c
• Multi Queue Group GuC interface(9)
• xe_guc_submit_wedge(9)
• xe_guc_submit_pause(9)
• xe_guc_submit_pause_vf(9)
• xe_guc_submit_unpause_prepare_vf(9)
• xe_guc_submit_unpause(9)
• xe_guc_submit_unpause_vf(9)
• xe_guc_submit_pause_abort(9)
• xe_guc_exec_queue_cgp_sync_done_handler(9)
• xe_guc_exec_queue_snapshot_capture(9)
• xe_guc_exec_queue_snapshot_capture_delayed(9)
• xe_guc_exec_queue_snapshot_print(9)
• xe_guc_exec_queue_snapshot_free(9)
• xe_guc_register_vf_exec_queue(9)
• xe_guc_submit_print(9)
• xe_guc_has_registered_mlrc_queues(9)
• xe_guc_contexts_hwsp_rebase(9)

---

ok that's the whole page, go read the source file if you want the lore, iykyk 💀

---

and that's a wrap, bestie 🧚💜 this came out of ./drivers/gpu/drm/xe, dated October 2026, and it's literally just xe_guc_submit_init(9) living her best life in the Kernel API Manual. periodt. 🍓🔥