STRUCT XE_OA_STREAM(9)

💅 struct xe_oa_stream(9) — the Kernel API Manual, but make it cute ✨

okay so this is from the Kernel API Manual and it's literally the whole tea on struct xe_oa_stream — like, this is the struct page bestie, we're doing this 🫶

🌸 NAME 🌸

struct xe_oa_stream — the state for a single open stream FD. one stream, one FD, one whole vibe 💫

✨ SYNOPSIS ✨

struct xe_oa_stream {
    struct xe_oa *oa;
    struct xe_gt *gt;
    struct xe_oa_unit *oa_unit;
    struct xe_hw_engine *hwe;
    struct mutex stream_lock;
    bool sample;
    struct xe_exec_queue *exec_q;
    struct xe_exec_queue *k_exec_q;
    bool enabled;
    struct xe_oa_config *oa_config;
    struct llist_head oa_config_bos;
    struct hrtimer poll_check_timer;
    wait_queue_head_t poll_wq;
    bool pollin;
    int wait_num_reports;
    bool periodic;
    int period_exponent;
    struct xe_oa_buffer oa_buffer;
    u64 poll_period_ns;
    u32 oa_status;
    u32 no_preempt;
    struct xe_file *xef;
    struct drm_syncobj *ufence_syncobj;
    u64 ufence_timeline_value;
    struct dma_fence *last_fence;
    u32 num_syncs;
    struct xe_sync_entry *syncs;
    unsigned int fw_ref;
};

🎀 Members 🎀

okay so every single one of these, no skips, we're not doing that 🙅‍♀️

• oa — the xe_oa backpointer. iconic little link back home 🏠
• gt — the gt associated with the oa stream
• oa_unit — the oa unit for this stream
• hwe — the hardware engine associated with this oa stream 🔥
• stream_lock — Lock serializing stream operations. one at a time bestie, we take turns 💅
• sample — true if DRM_XE_OA_PROP_SAMPLE_OA is provided
• exec_q — Exec queue corresponding to DRM_XE_OA_PROPERTY_EXEC_QUEUE_ID
• k_exec_q — kernel exec_q used for OA programming batch submissions 👑
• enabled — Whether the stream is currently enabled (are we live or not, the eternal question)
• oa_config — the OA configuration used by the stream
• oa_config_bos — List of struct xe_oa_config_bo's
• poll_check_timer — Timer to periodically check for data in the OA buffer. yes she checks in on you, that's her love language ⏰
• poll_wq — Wait queue for waiting for OA data to be available
• pollin — Whether there is data available to read 👀
• wait_num_reports — Number of reports to wait for before signalling pollin
• periodic — Whether periodic sampling is currently enabled
• period_exponent — OA unit sampling frequency is derived from this 🧮
• oa_buffer — the OA buffer for the stream
• poll_period_ns — hrtimer period for checking OA buffer for available data
• oa_status — temporary storage for oa_status register value
• no_preempt — Whether preemption and timeslicing is disabled for stream exec_q. like, no cutting in, no switching, none of that 💀
• xef — the xe_file with which the stream was opened
• ufence_syncobj — User fence syncobj
• ufence_timeline_value — User fence timeline value
• last_fence — fence to use in stream destroy when needed
• num_syncs — size of the syncs array
• syncs — syncs to wait on and to signal 🦋
• fw_ref — Forcewake reference

🌈 SEE ALSO 🌈

Kernel file ./drivers/gpu/drm/xe/xe_oa_types.h, plus these besties who also ate:

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

k so that's the whole page, literally every field accounted for, no notes 💜 this came out of ./drivers/gpu/drm/xe and it's dated October 2026 — so yeah, mark your calendar, this struct is booked and busy 🎀✨🫶