# \[PATCH v8 14/21\] ring-buffer: Add kerneldoc for ring\_buffer\_poll\_remote - From: Vincent Donnefort \ - Date: 2026-11-06 18:08:00 - List: linux-trace-kernel - Page: https://ratatoskr.run/linux-trace-kernel/2026/11/17880572 - Thread: https://ratatoskr.run/linux-trace-kernel/2026/11/17880557/t.md ```text Document ring_buffer_poll_remote(). Signed-off-by: Vincent Donnefort --- kernel/trace/ring_buffer.c | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/kernel/trace/ring_buffer.c b/kernel/trace/ring_buffer.c index 9c707cb751ba..82f0a4654c95 100644 --- a/kernel/trace/ring_buffer.c +++ b/kernel/trace/ring_buffer.c @@ -6910,6 +6910,17 @@ bool ring_buffer_empty_cpu(struct trace_buffer *buffer, int cpu) } EXPORT_SYMBOL_GPL(ring_buffer_empty_cpu); +/** + * ring_buffer_poll_remote - poll a remote ring buffer for new data + * @buffer: The ring buffer + * @cpu: The CPU buffer to poll (or RING_BUFFER_ALL_CPUS) + * + * This function polls the specified remote CPU buffer (or all of them) + * by reading its meta page to update the local reader's view. If new + * entries are detected, it triggers wakeups for any waiting readers. + * Returns: + * 0 on success, or -EINVAL if the CPU is not in the buffer's cpumask. + */ int ring_buffer_poll_remote(struct trace_buffer *buffer, int cpu) { struct ring_buffer_per_cpu *cpu_buffer; -- 2.56.0.455.g6c5a503b38-goog ```