From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f70.google.com (mail-wr1-f70.google.com [209.85.221.70]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id AE8D746D2D9 for ; Tue, 4 Aug 2026 14:04:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.70 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1785852250; cv=none; b=e3iCUQir5xqiZ6S68cd+dI2k7cJLsKrFSmLSwfa0HOZQ4IyFxO7hNIShLDAKlU9wBXnJFWdffU79RBlSDS9w63iDogmwKB/5NxS6wcfbx1G3zG3ZFxoPkhdQ4LWLM9U2vK/cV13ufSAthVndumoEOs3u63v2bmXKK5LGAMGq9us= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1785852250; c=relaxed/simple; bh=mJd4AJ8AR+Jb9QHmo1fgIyfkiHMyyvJ/w+QEr57zfYw=; h=Date:In-Reply-To:Mime-Version:References:Message-ID:Subject:From: To:Cc:Content-Type; b=sKz/bYsICrkoszoBt7BVjwZMAX8ikPh2lHIzTLIY0DmAeqZHwQwdUVSxZjqAy1KBSyCRnHj1lepFuOnJnwcq3I/5C2528wdB0HtMXUm+y75xvj+EtsBU4WVKB5p6HWCCmNuJvNxrAqIiowGl56QRxdS5AtYQZdjAQNgK2xCNuFs= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=flex--vdonnefort.bounces.google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=Qpksj6qF; arc=none smtp.client-ip=209.85.221.70 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flex--vdonnefort.bounces.google.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="Qpksj6qF" Received: by mail-wr1-f70.google.com with SMTP id ffacd0b85a97d-472a798fc7cso3893170f8f.1 for ; Tue, 04 Aug 2026 07:04:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20251104; t=1785852246; x=1786457046; darn=vger.kernel.org; h=content-type:cc:to:from:subject:message-id:references:mime-version :in-reply-to:date:from:to:cc:subject:date:message-id:reply-to :content-type; bh=KB5qHRnyZLsgA5zhQzo7YNGC/4MQ072Z7VCdf5mW6a8=; b=Qpksj6qFq3lCEf5bkJF2qGnZaLiaOeF1o1yeq6FxTZCsKWM+/JQZbdTTWF/P3XQgw9 Qfvr+XHs5prhQdvAAEfFt6w5Bsrwd0yzvrdr3JuhY6sGJAoBQv1Yud3rKZzRIaEvl26+ 8VtGYrIrvwBjPMrR7aYCJL8uSkewQE4ePWsH4eJaIBSYugIqstoexVCvMSj4czNEwVc0 Ds50fkp2rVRuqehKz25eqhAwA8S/iK7amtLbMeilNFBoVQKX33SrYEYwEPIVGJrMrl+u YLu2AWY0JKKwoxgYfSh5unhDbBvQL0v8rnF2VrU4guTbfEfHRgadxbH/AnDCSq+s0Uxs 9fvQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1785852246; x=1786457046; h=content-type:cc:to:from:subject:message-id:references:mime-version :in-reply-to:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=KB5qHRnyZLsgA5zhQzo7YNGC/4MQ072Z7VCdf5mW6a8=; b=YtakcbbcXkBsV4yOitoLcoN0b2DVujXqq0D5amu7r2/7yPCq3LTGgFPKLzYFhiBJEi XBRmovo8SDifpWMTV/sH3/RT6dAH77xLuKrKUfiHK3V2VPd6yQJH3qdPIdG4IcKmLM7p BV11ooIlhHMrPmTo2S2WX4lEM9KIyyI51Rn54URpEIBxNAp4GcCLp4CqB6M36PetvM2p E0oejpc8/BisjNRE2ktQ9FKiVclVEjsd+BxyUpmuD506PEYeMePjhqAydx6OpDg6sjja De4+lRUMb0aJHNUaVsDJ7YTYS1m2bvnH5t3V2Q7e57kqkLXzrTUwNBl2b22qH+2p7tdI YpfQ== X-Forwarded-Encrypted: i=1; AHgh+RrZiKREkqliwCyuLtxs8npC5DNbdIOAmNWr7NlkeOB5K1CYuN7biFkRpDvLR+ytIY+4p8hxpdurVt0v4Es=@vger.kernel.org X-Gm-Message-State: AOJu0YxBVfgJJOFFi8FRR5rRyorcRNXH6SX6e5jIKLh8X5+7t0lRa3qu SZOQYZ+RGCAMOpRa4jPzI4xSiFenlDfqjsxVcffe+y/hky0/hlpmT2lrOlQu2rDcuSwlCIHppoj nH8tNpCDY1wLNDKSrlVrGJA== X-Received: from wmxa7-n2.prod.google.com ([2002:a05:600d:6447:20b0:495:55d9:36ad]) (user=vdonnefort job=prod-delivery.src-stubby-dispatcher) by 2002:a05:600c:12c8:b0:495:63e6:5fb8 with SMTP id 5b1f17b1804b1-4980c653e58mr226747225e9.12.1785852245793; Tue, 04 Aug 2026 07:04:05 -0700 (PDT) Date: Tue, 4 Aug 2026 15:03:27 +0100 In-Reply-To: <20260804140333.797210-1-vdonnefort@google.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: Mime-Version: 1.0 References: <20260804140333.797210-1-vdonnefort@google.com> X-Mailer: git-send-email 2.55.0.571.g244d577d93-goog Message-ID: <20260804140333.797210-13-vdonnefort@google.com> Subject: [PATCH v4 12/18] ring-buffer: Add kerneldoc for ring_buffer_poll_remote From: Vincent Donnefort To: rostedt@goodmis.org, mhiramat@kernel.org, linux-trace-kernel@vger.kernel.org Cc: mathieu.desnoyers@efficios.com, kernel-team@android.com, linux-kernel@vger.kernel.org, Vincent Donnefort Content-Type: text/plain; charset="UTF-8" Document ring_buffer_poll_remote(). Signed-off-by: Vincent Donnefort diff --git a/kernel/trace/ring_buffer.c b/kernel/trace/ring_buffer.c index 4bb1a7780860..8cb10e9da122 100644 --- a/kernel/trace/ring_buffer.c +++ b/kernel/trace/ring_buffer.c @@ -6848,6 +6848,17 @@ int ring_buffer_read_remote_meta_page(struct trace_buffer *buffer, int cpu) return 0; } +/** + * 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.55.0.571.g244d577d93-goog