xe_oa_stream_open_ioctl(9)

💅 xe_oa_stream_open_ioctl ✨

okay so real talk, this one lives in the Kernel API Manual (yes bestie, the 9th section, we're in the deep end now 🫶), and it's literally the function that opens an OA stream. iconic behavior. let's get into it.

---

🌸 NAME 🌸

xe_oa_stream_open_ioctl — opens an OA stream 💖

---

🎀 SYNOPSIS 🎀

int xe_oa_stream_open_ioctl (struct drm_device *dev , u64 data , struct
       drm_file *file );

---

🦋 ARGUMENTS 🦋

• dev — a drm_device. that's the vibe check on which device we're talking to 💀
• data — pointer to struct drm_xe_oa_config. this is where the actual config lives, no cap
• file — a drm_file. the file handle doing the asking ✨

---

🌈 DESCRIPTION 🌈

so the function opens an OA stream. and like, what IS an OA stream? glad you asked 🧚 an OA stream, opened with specified properties, enables OA counter samples to be collected — either periodically (time based sampling ⏰) or on request (using OA queries, iykyk). two modes, both slay, she contains multitudes 💅

---

👑 SEE ALSO 👑

the kernel file is ./drivers/gpu/drm/xe/xe_oa.c, and while you're in the neighborhood, go say hi to:

• xe_oa_timestamp_frequency(9)
• xe_oa_unit_id(9)
• xe_oa_add_config_ioctl(9)
• xe_oa_remove_config_ioctl(9)
• xe_oa_register(9)
• xe_oa_init(9)

---

and that's the whole page, bestie!! this one's brought to you by the source ./drivers/gpu/drm/xe, dated October 2026 — main character energy from the kernel tree fr fr 🍓💜 go forth and open those streams, ily 🫶✨