i915_perf_disable_locked(9)

💅 i915_perf_disable_locked — a Kernel API Manual moment

okay so bestie, welcome to the Kernel API Manual entry for i915_perf_disable_locked(9) — yes that's the whole title, yes it's a mouthful, no we're not shortening it, it's iconic as-is 🎀

---

✨ NAME ✨

i915_perf_disable_locked — handles the I915_PERF_IOCTL_DISABLE ioctl, that's literally the whole job 🫶

---

🌸 SYNOPSIS 🌸

void i915_perf_disable_locked (struct i915_perf_stream *stream );

---

🦋 ARGUMENTS 🦋

• stream — an enabled i915 perf stream. like, it has to be enabled already, that's the vibe check it needs to pass ✨

---

💖 DESCRIPTION 💖

So what this does is it disables the associated capture of data for this stream. that's it, that's the function, and she ate 💅

The intention here — the dream, the vision — is that disabling then re-enabling a stream will ideally be cheaper than straight-up destroying it and re-opening a whole new stream with the same configuration. lowkey a glow-up instead of a full rebrand, y'know? 🧚

but ngl, there are no formal guarantees about what state or buffered data must be retained between disabling and re-enabling a stream. so don't come for her if your buffered data ghosted you 😭

---

⭐ NOTE ⭐

while a stream is disabled, it's considered an error for userspace to attempt to read from the stream, and that error is -EIO. so like… don't do that. read the room (and the stream state) fr fr 💀

---

🌈 SEE ALSO 🌈

Kernel file ./drivers/gpu/drm/i915/i915_perf.c — and honestly the whole extended 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_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_poll(9)
• i915_perf_enable_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 — mwah 💋

shoutout to the source dir ./drivers/gpu/drm/i915, the version stamp October 2026, and the manual itself for hosting this little legend. go forth and disable responsibly 👑✨