STRUCT XE_GUC_ENGINE_ACTIVITY(9)

💅 NAME 💅

struct xe_guc_engine_activity — the data struct that makes the whole engine activity implementation go brrr ✨ (like, this is the little guy holding all the info, and we're obsessed 🫶)

So bestie, this is a Kernel API Manual page, and it lives in the Kernel API Manual section of your man pages — okay so now you know where to find it 💖

---

✨ SYNOPSIS ✨

struct xe_guc_engine_activity {
    u32 gpm_timestamp_shift;
    u32 num_activity_group;
    u32 num_functions;
    bool supported;
    struct engine_activity_group *eag;
    struct engine_activity_buffer device_buffer;
    struct engine_activity_buffer function_buffer;
};

Literally the whole shape of it, no cap 🔥

---

🎀 Members 🎀

Okay so let's meet the squad, member by member, because each one is a main character in their own right 👑

• gpm_timestamp_shift — the right shift value for the gpm timestamp. That's it, that's the whole vibe 🦋
• num_activity_group — the number of activity groups. Like, how many groups we're tracking, periodt 💅
• num_functions — the number of functions. Counting them, respectfully 🙈
• supported — a bool that indicates support for engine activity stats. Basically a vibe check: yes we support it, or no we don't 😭
• eag — holds the device level engine activity data in native mode 🌸 In SRIOV mode, it points to an array with entries which holds the engine activity data for PF and VF's. So yeah, it's giving dual-mode icon behavior 👑
• device_buffer — buffer object for global engine activity. The whole-device tea ☕
• function_buffer — buffer object for per-function engine activity. The per-function tea, separated out with care 🍓

---

👀 SEE ALSO 👀

Not me making sure you don't leave without the linked lore:

• Kernel file ./drivers/gpu/drm/xe/xe_guc_engine_activity_types.h
• struct engine_activity(9)
• struct engine_activity_group(9)
• struct engine_activity_buffer(9)

Go read them, iykyk 💜

---

Also lowkey if you're wondering where this all lives — it's under ./drivers/gpu/drm/xe, and the page is dated October 2026. That's the source/version and date, bestie, noted for the record 🧚

okay that's the whole page, slay, go forth and read structs 💖✨🎀