append_oa_status(9)

🎀 append_oa_status(9) — Kernel API Manual 🎀

🍓 NAME 🍓

append_oa_status — appends a status record to a userspace read() buffer. That’s the whole gig, and it eats every time. 💅

✨ SYNOPSIS ✨

int append_oa_status (struct i915_perf_stream *stream , char __user *buf
       , size_t count , size_t *offset , enum drm_i915_perf_record_type type );

🎀 ARGUMENTS 🎀

• stream — an i915-perf stream that was opened for OA metrics.
• buf — the destination buffer handed over by userspace.
• count — the number of bytes userspace wants to read.
• offset — (inout) the current position for writing into buf.
• type — the kind of status to report to userspace.

💅 DESCRIPTION 💅

okay so picture this, bestie: append_oa_status writes a status record into the userspace read buffer. We’re talking about a status record such as DRM_I915_PERF_RECORD_OA_REPORT_LOST — yes, that exact one. ✨🔥

And the lil rule to remember is iconic: the buf offset will only be updated on success. No success? No offset move. Periodt. 💖

🌈 RETURN 🌈

• 0 on success. slay. 👑
• negative error code on failure. 😭

👑 SEE ALSO 👑

okay bestie, the whole i915 perf cinematic universe is right here:

• 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_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_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)

Sign-off bestie: this page comes from ./drivers/gpu/drm/i915, it’s dated October 2026, and the manual page is append_oa_status(9). Stay perf-y. 🫶💜