STRUCT XE_GUC_RELAY(9)

💅 struct xe_guc_relay(9) 💅

okay so bestie, welcome to the Kernel API Manual ✨ — this little page is all about struct xe_guc_relay, which is the data used by the VF-PF Relay Communication over GuC. yes that's a lot of acronyms, no i will not be apologising 😌

---

🌸 NAME 🌸

struct xe_guc_relay — literally the data used by the VF-PF Relay Communication over GuC 🫶

---

✨ SYNOPSIS ✨

struct xe_guc_relay {
    spinlock_t lock;
    struct work_struct worker;
    struct list_head pending_relays;
    struct list_head incoming_actions;
    mempool_t pool;
    u32 last_rid;
    struct ratelimit_state diag_ratelimit;
 };

look at her. iconic struct. all her little fields lined up 💖

---

🎀 Members 🎀

• lock — protects all the internal data. yes, all of it. she's the bouncer at the door 💅
• worker — this one dispatches incoming action messages. main character energy fr fr 🔥
• pending_relays — a list of sent requests that are still waiting on a response. the "seen at 2:47am, no reply yet" list 😭
• incoming_actions — a list of incoming relay action messages that need to be processed. the group chat notifications she hasn't opened yet 🙈
• pool — the pool of the relay message buffers 🧚
• last_rid — the last Relay-ID used while sending a message. her last-used username, basically ⭐
• diag_ratelimit — the ratelimit state used to throttle diagnostics messages. so the diagnostics don't spam the timeline 🦋

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_guc_relay_types.h — go read it, iykyk 👑

---

lowkey this is all straight from the source, no cap — every field, every description, exactly as documented 💜

---

and that's the page bestie!! 🎀✨ this came out of ./drivers/gpu/drm/xe in October 2026, tagged struct xe_guc_relay(9) — go forth and relay, you absolute icon 👑🫶🌸