STRUCT __GUC_MMIO_REG_DESCR_GROUP(9)

✨ struct __guc_mmio_reg_descr_group (9) ✨

okay so real talk, bestie — this is a Kernel API Manual page, and it's about a struct called struct __guc_mmio_reg_descr_group, which is literally just the group of register descriptor. group chat for registers, iykyk 🫶

---

🌸 NAME 🌸

struct __guc_mmio_reg_descr_group — the group of register descriptor. that's it, that's the whole vibe 💅

---

🦋 SYNOPSIS 🦋

struct __guc_mmio_reg_descr_group {
    const struct __guc_mmio_reg_descr *list;
    u32 num_regs;
    u32 owner;
    u32 type;
    u32 engine;
 };

like, look at her. five fields. main character energy, no cap 🔥

---

🎀 MEMBERS 🎀

• list — the register list itself. the actual roster of registers, the whole squad 🧚
• num_regs — count of registers in the list. literally how many are in there, bestie can't be guessing 🙈
• owner — PF/VF owner, see enum guc_capture_list_index_type. the "whose is this" field 👑
• type — capture register type, see enum guc_state_capture_type. the "what kind" field, iconic ✨
• engine — the engine class, see enum guc_capture_list_class_type. which engine we're talking about, periodt 💜

heads up, each of those last three points at its own enum — go read those, don't just vibe off the field names 😭

---

🍓 DESCRIPTION 🍓

so the xe_guc_capture module uses these structures to maintain static tables (per unique platform) that consists of lists of registers (offsets, names, flags,...) that are used at the ADS registration time as well as during runtime processing and reporting of error-capture states generated by GuC just prior to engine reset events.

let me say that again but with feeling 💖: xe_guc_capture keeps static tables, one set per unique platform, and each table is made of lists of registers — offsets, names, flags, all that good stuff. those same lists get used at ADS registration time and during runtime processing, plus for reporting of error-capture states that the GuC generates right before engine reset events. so she's multitasking. she's booked and busy. ate 💅✨

---

🌈 SEE ALSO 🌈

• Kernel file ./drivers/gpu/drm/xe/xe_guc_capture_types.h
• struct __guc_mmio_reg_descr(9)

---

and that's the page, bestie 🦋 if you got this far you're officially smarter than the group chat. slay 💀💖

source: ./drivers/gpu/drm/xe · dated October 2026 — mwah, catch you in the next manpage 🎀⭐