STRUCT XE_OA(9)

💅 struct xe_oa — NAME 💅

okay so this is struct xe_oa(9) from the Kernel API Manual, and it's basically the OA device level information ✨ — like, the whole vibe of the OA device in one struct. Obsessed.

🌸 SYNOPSIS 🌸

struct xe_oa {
    struct xe_device *xe;
    struct kobject *metrics_kobj;
    struct mutex metrics_lock;
    struct idr metrics_idr;
    const struct xe_oa_format *oa_formats;
    unsigned long format_mask[BITS_TO_LONGS(__XE_OA_FORMAT_MAX)];
    u16 oa_unit_ids;
};

Like, that's the whole thing. Iconic. No cap. 🫶

🎀 Members 🎀

so here's the field-by-field breakdown bestie, every single one, we're not skipping a single member 💖

• xe — back pointer to xe device. like, it points right back home to the xe device, main character energy fr fr 🏠
• metrics_kobj — kobj for metrics sysfs. yep, the kobject that handles the metrics sysfs situation ✨
• metrics_lock — lock protecting add/remove configs. it's giving bodyguard energy, keeping those add/remove config ops from stepping on each other 💅
• metrics_idr — List of dynamic configurations (struct xe_oa_config). literally a whole list of the dynamic configs, we love a collection 👑
• oa_formats — tracks all OA formats across platforms. every platform, every OA format, all tracked here 🦋
• format_mask — tracks valid OA formats for a platform. it's the vibe check for which formats are valid on a given platform, typed as unsigned long format_mask[BITS_TO_LONGS(__XE_OA_FORMAT_MAX)] — yes that whole expression, don't @ me 🌈
• oa_unit_ids — tracks oa unit ids assigned across gt's. keeping tabs on those oa unit ids spread across the gt's, someone's gotta do it ⭐

🦋 SEE ALSO 🦋

go read these next bestie (Kernel file ./drivers/gpu/drm/xe/xe_oa_types.h — that's where all the lore lives 🔥):

• struct xe_oa_format(9)
• struct xe_oa_unit(9)
• struct xe_oa_gt(9)
• struct xe_oa_buffer(9)
• struct xe_oa_stream(9)

💀 ngl these all hang out in ./drivers/gpu/drm/xe/xe_oa_types.h so like, tell xe_oa_types.h I said hi okay 🙈

🌸 cute sign-off 🌸

so this whole page comes from ./drivers/gpu/drm/xe, dated October 2026, and it's literally struct xe_oa(9) — periodt 💜🎀💖 slay, go forth and read your header files bestie 🧚✨