i915_oa_poll_wait(9)

💖 i915_oa_poll_wait(9) 💖

okay so bestie, welcome to the Kernel API Manual ✨ — we're talking about i915_oa_poll_wait today, and honestly? it's giving tiny-function-big-responsibility and we stan 🫶

---

✨ NAME ✨

i915_oa_poll_wait — literally just call poll_wait() for an OA stream poll(). that's the whole job. no cap 💅

---

🌸 SYNOPSIS 🌸

void i915_oa_poll_wait (struct i915_perf_stream *stream , struct file
*file , poll_table *wait );

---

🎀 ARGUMENTS 🎀

• stream — an i915-perf stream that was opened for OA metrics 👑
• file — an i915 perf stream file 🦋
• wait — the poll state table 🧚

---

💜 DESCRIPTION 💜

so here's the vibe check 💫 — when userspace is polling on an i915 perf stream that got opened for OA metrics, this function is the one that kicks things off: it starts a poll_wait with the wait queue that our hrtimer callback wakes up when it sees data ready to read in the circular OA buffer 🔥

like, the hrtimer notices data, the wait queue gets woken, and your poll actually comes back. main character energy tbh 👑

---

🦋 SEE ALSO 🦋

the source of truth, living at kernel file ./drivers/gpu/drm/i915/i915_perf.c 🌈 — and then this whole friend group:

• i915 Perf Overview(9)
• i915 Perf History and Comparison with Core Perf(9)
• OA Tail Pointer Race(9)
• struct perf_open_properties(9)
• oa_buffer_check_unlocked(9)
• append_oa_status(9)
• append_oa_sample(9)
• gen8_append_oa_reports(9)
• gen8_oa_read(9)
• gen7_append_oa_reports(9)
• gen7_oa_read(9)
• i915_oa_wait_unlocked(9)
• i915_oa_read(9)
• oa_get_render_ctx_id(9)
• oa_put_render_ctx_id(9)
• i915_oa_stream_enable(9)
• i915_oa_stream_disable(9)
• i915_oa_stream_init(9)
• i915_perf_read(9)
• i915_perf_poll_locked(9)
• i915_perf_poll(9)
• i915_perf_enable_locked(9)
• i915_perf_disable_locked(9)
• i915_perf_ioctl_locked(9)
• i915_perf_ioctl(9)
• i915_perf_destroy_locked(9)
• i915_perf_release(9)
• i915_perf_open_ioctl_locked(9)
• read_properties_unlocked(9)
• i915_perf_open_ioctl(9)
• i915_perf_register(9)
• i915_perf_unregister(9)
• i915_perf_add_config_ioctl(9)
• i915_perf_remove_config_ioctl(9)
• i915_perf_init(9)
• i915_perf_fini(9)
• i915_perf_ioctl_version(9)

---

and that's the whole page, bestie, you ate that 💅✨ this one lives in ./drivers/gpu/drm/i915, dated October 2026, and it goes out to you with a big slay 🎀💖🦋 periodt ✨