xe_guc_id_mgr_init(9)

✨ xe_guc_id_mgr_init(9) ✨

okay so bestie, welcome to the Kernel API Manual 💖 today's main character is xe_guc_id_mgr_init — the little function that gets your GuC context ID Manager all set up and ready to slay 🎀

---

🌸 NAME 🌸

xe_guc_id_mgr_init — literally just Initialize GuC context ID Manager. that's the whole vibe ✨

---

🦋 SYNOPSIS 🦋

int xe_guc_id_mgr_init (struct xe_guc_id_mgr *idm , unsigned int limit
);

like. look at her go 💅 returns an int, takes two things, done. iconic behavior honestly.

---

💜 ARGUMENTS 💜

• idm — the xe_guc_id_mgr you're initializing, bestie. this is the manager. the one we're setting up 🫶
• limit — number of IDs to manage. yes, an actual count. no cap 🔢

---

🌈 DESCRIPTION 🌈

so here's the tea ☕ the bare-metal or PF driver can pass ~0 as the limit to say "hey, all the context IDs supported by the GuC firmware are available for use" — like, the whole closet is yours, go off 👑

only VF drivers have to actually provide an explicit number of context IDs that they can use. so if you're a VF, no being vague, you gotta say the number fr fr 🙈

---

⭐ RETURN ⭐

0 on success 🎉 or a negative error code on failure 😭 that's it, that's the whole return situation.

---

🔥 SEE ALSO 🔥

• Kernel file ./drivers/gpu/drm/xe/xe_guc_id_mgr.c — the source, the origin story 📖
• xe_guc_id_mgr_reserve_locked(9)
• xe_guc_id_mgr_release_locked(9)
• xe_guc_id_mgr_reserve(9)
• xe_guc_id_mgr_release(9)
• xe_guc_id_mgr_print(9)

the whole friend group honestly, go read them all, iykyk 💀💖

---

okay that's the page!! 🧚 this little cutie lives in ./drivers/gpu/drm/xe, dated October 2026, and it's page xe_guc_id_mgr_init(9) of the Kernel API Manual — mwah, go init some ID managers bestie, you got this 🌸💅🍓