STRUCT XE_GUC_ADS(9)

💜 struct xe_guc_ads(9) — like, the GuC additional data structures manual, bestie

okay so this is a page from the Kernel API Manual and it's all about struct xe_guc_ads — which literally stands for GuC additional data structures (ADS) 🎀 no cap, that's the name, that's the vibe.

✨ NAME ✨

struct xe_guc_ads — GuC additional data structures (ADS) 💅

🦋 SYNOPSIS 🦋

struct xe_guc_ads {
    struct xe_bo *bo;
    struct xe_bo *um_queue_bo;
    size_t golden_lrc_size;
    u32 regset_size;
    u32 ads_waklv_size;
    u32 capture_size;
 };

periodt. that's the whole struct, every field, character for character 💖

👑 Members 👑

• bo — the Xe BO for the GuC ads blob 🫶 that's its whole job, iconic.
• um_queue_bo — a dedicated BO for the HW fault ring (UM queues). it's NULL if the platform does not support USM 🙈 (so like, don't panic if you see a NULL there, it's not a bug, it's just not that kind of platform).
• golden_lrc_size — golden LRC size ✨
• regset_size — size of the register set passed to GuC for save/restore 💾
• ads_waklv_size — total waklv size supported by platform 🌸
• capture_size — size of the register set passed to GuC for capture 📸

fr fr, um_queue_bo being NULL is the "platform does not support USM" situation. that's a real thing the page says, so i'm telling you, not inventing it 💀

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_guc_ads_types.h — go read it, it's giving main character energy 👑

and that's the whole page, bestie ✨ source/version is ./drivers/gpu/drm/xe and it's dated October 2026 — cute lil sign-off for ya, struct xe_guc_ads(9) out 💜🧚‍♀️