STRUCT XE_GUC(9)

🌸 struct xe_guc(9) — Kernel API Manual, bestie edition 🌸

Okay so this page lives in the Kernel API Manual, and it's literally all about struct xe_guc — the Graphic micro controller. Yes that's the real name, no I'm not making it up 💅. Sit down, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

struct xe_guc — Graphic micro controller 🎀

---

🦋 SYNOPSIS 🦋

Here's the whole vibe, character for character, don't touch a thing:

struct xe_guc {
    struct xe_uc_fw fw;
    struct xe_guc_log log;
    struct xe_guc_ads ads;
    struct xe_guc_ct ct;
    struct xe_guc_buf_cache buf;
    struct xe_guc_state_capture *capture;
    struct xe_guc_pc pc;
    struct xe_guc_db_mgr dbm;
    struct {
      struct xe_bo *bo;
      bool owned;
    } g2g;
    struct {
      struct xe_guc_id_mgr idm;
      struct xarray exec_queue_lookup;
      atomic_t stopped;
      atomic_t reset_blocked;
      struct mutex lock;
      bool enabled;
      bool initialized;
    } submission_state;
    struct {
      struct xe_bo *bo;
      u32 size;
    } hwconfig;
    struct xe_guc_relay relay;
    struct xe_guc_engine_activity engine_activity;
    struct xe_reg notify_reg;
    u32 params[GUC_CTL_MAX_DWORDS];
 };

---

👑 Members 👑

Every single field, explained like we're texting at 2am 🫶

• fw — the generic uC firmware management bit, classic.
• log — the GuC log, where the receipts live 📝
• ads — the GuC ads.
• ct — the GuC ct.
• buf — GuC Buffer Cache manager, holding it down.
• capture — the error-state-capture module's data and objects 🙈
• pc — GuC Power Conservation, environmentally conscious queen 🌱
• dbm — GuC Doorbell Manager, answering the door fr fr 🚪
• g2g — GuC to GuC communication state, it's giving networking 💬
  • g2g.bo — storage for GuC to GuC communication channels.
  • g2g.owned — is the BO owned by this GT or just mapped in — the eternal question 💀
• submission_state — GuC submission state, the main character energy of this struct ⭐
  • submission_state.idm — GuC context ID Manager.
  • submission_state.exec_queue_lookup — lookup an xe_engine from guc_id 🔍
  • submission_state.stopped — submissions are stopped, periodt.
  • submission_state.reset_blocked — reset attempts are blocked; blocking reset in order to delay it may be required if running an operation which is sensitive to resets. So like, sometimes you gotta hold off, iykyk.
  • submission_state.lock — protects submission state 🔒
  • submission_state.enabled — submission is enabled, slay.
  • submission_state.initialized — mark when submission state is even initialized — and hear me out: before that, not even the lock is valid. Not even the lock. Be careful 😭
• hwconfig — hardware config state, iconic.
  • hwconfig.bo — buffer object of the hardware config.
  • hwconfig.size — size of the hardware config.
• relay — GuC Relay Communication used in SR-IOV 📡
• engine_activity — device specific engine activity, getting busy 🏃‍♀️
• notify_reg — register which is written to notify GuC of H2G messages ✉️
• params — control params for fw initialization.

---

💖 SEE ALSO 💖

Go look at the kernel file ./drivers/gpu/drm/xe/xe_guc_types.h, plus these two besties: struct xe_guc_db_mgr(9), struct xe_guc_id_mgr(9) 🌈

---

That's the whole page, no cap. Love u, go read the headers 🧚💜

— sourced from ./drivers/gpu/drm/xe, dated October 2026, filed under struct xe_guc(9). Byeee 💅✨