i915_perf_poll(9)

🎀 NAME 🎀

okay so bestie, you're looking at the Kernel API Manual entry for i915_perf_poll, and its whole job is literally to call poll_wait() with a suitable wait queue for stream. that's the vibe 💅

✨ SYNOPSIS ✨

__poll_t i915_perf_poll (struct file *file , poll_table *wait );

💖 ARGUMENTS 💖

• file — an i915 perf stream file.
• wait — poll state table.

🦋 DESCRIPTION 🦋

for handling userspace polling on an i915 perf stream, this ensures poll_wait gets called with a wait queue that will be woken for new stream data. it's giving “wake me up when there's fresh stream data” energy 🦋

💅 NOTE 💅

not me finding out the implementation is deferred to i915_perf_poll_locked 😭 — yeah, that's the whole note, bestie.

🌸 RETURN 🌸

it returns any poll events that are ready without sleeping. no nap required, just the ready ones ✨

🔥 SEE ALSO 🔥

the full squad, no cap:

• Kernel file ./drivers/gpu/drm/i915/i915_perf.c
• 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_poll_wait(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_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)

mwah 💋 this lil page is filed under ./drivers/gpu/drm/i915, dated October 2026, and its full glam name is i915_perf_poll(9). slay.