oa_get_render_ctx_id(9)

💖 NAME

okay so this page lives in the Kernel API Manual, and the main character is oa_get_render_ctx_id — it determines and holds ctx hw id. Bestie, let’s go ✨

✨ SYNOPSIS

int oa_get_render_ctx_id (struct i915_perf_stream *stream );

🎀 ARGUMENTS

• stream — an i915-perf stream opened for OA metrics. That’s the bestie we’re working with 💅

🦋 DESCRIPTION

Here’s the vibe: oa_get_render_ctx_id determines the render context hw id, and then makes sure it stays fixed for the lifetime of the stream. The whole point? So we don’t have to worry about updating the context ID in OACONTROL on the fly. Iconic, honestly ✨

🌸 RETURN

zero on success, or a negative error code. Simple as that, no cap 🫶

🌈 SEE ALSO

• 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_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 🫶 source/version squad: ./drivers/gpu/drm/i915; date on the vibe calendar: October 2026; filed under oa_get_render_ctx_id(9) 💖