xe_guc_id_mgr_reserve(9)

💖 xe_guc_id_mgr_reserve(9) 💖

okay bestie, welcome to the Kernel API Manual entry for xe_guc_id_mgr_reserve(9) — yes that's a whole mouthful, but she's iconic and we're gonna get through it together 🫶

---

✨ NAME ✨

xe_guc_id_mgr_reserve — bestie, this one reserves a range of GuC context IDs. that's the whole vibe ✨

---

🌸 SYNOPSIS 🌸

int xe_guc_id_mgr_reserve (struct xe_guc_id_mgr *idm , unsigned int
       count , unsigned int retain );

like literally that's the signature, no notes 💅

---

🎀 ARGUMENTS 🎀

• idm — the xe_guc_id_mgr in question. she's the main character here 👑
• count — how many GuC context IDs you wanna reserve. absolutely can't be 0 — zero is not the move, ok? 🚫
• retain — how many GuC context IDs you gotta keep available. also can't be 0, no exceptions 😤

---

🦋 DESCRIPTION 🦋

so this function is dedicated for use by the PF driver, and the PF driver has some strong opinions, ngl. it expects two things:

1. the reserved range of IDs will be contiguous — no gaps, she stays together 🧚
2. there will be at least retain IDs still available for the PF after this reservation — like you can't just take everything, leave some for later bestie 😭

---

⭐ RETURN ⭐

on success you get the starting ID of the allocated GuC context ID range — slay 🔥

on failure? a negative error code. so if you see a negative number, that's your sign something went off, no cap 💀

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_guc_id_mgr.c
• xe_guc_id_mgr_init(9)
• xe_guc_id_mgr_reserve_locked(9)
• xe_guc_id_mgr_release_locked(9)
• xe_guc_id_mgr_release(9)
• xe_guc_id_mgr_print(9)

---

ngl the whole squad is linked up there, go read them too, iykyk 💜

---

and that's the page bestie!! this one came straight outta ./drivers/gpu/drm/xe, dated October 2026 — yes, the future, we're that ahead of the game 👑✨ mwah, ily, go reserve those IDs responsibly 🍓💅