Received: by 2002:a25:e74b:0:0:0:0:0 with SMTP id e72csp2212227ybh; Fri, 17 Jul 2020 12:00:35 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwlIpI/gtJFhRg1PTtl4ygDArZaICHrd3h+Jg1/7xcNAyyyIuTgmTLk6Smfn1/6QaJeNt/W X-Received: by 2002:a17:906:240d:: with SMTP id z13mr9695178eja.346.1595012435243; Fri, 17 Jul 2020 12:00:35 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1595012435; cv=none; d=google.com; s=arc-20160816; b=grfHuRsm4Njt/S9gsKn9rzXYqSWGv4GHOx/U0B+2LQqcnQzAYote90VY4fixtpsY+i nVzgsvgIznQ9breAoNX6s03e2AS21yq2B0Swrp8Tn6nD+ReR8g7MfvLDU4C3huS8wkBH 4TmNAN1XAwOy0drO+pnYi4K8/HJbKH61qS3QFm3TNfF564PxmKD+tWi6qmn5gcIa3D25 XTPw3JuM7pig5nINQcFE6rcqAy6/VcL8MWZyMgwdmVaf0QZ2e6XpAWEfm1BaifN7EVHg qWc3k3SpeBgaSLSvAcxvjfuHbkTLKTfhrUDwwdLu4+NN95vzAtQg8QwK6nJCasAXO58p G0BA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=u6fuGIKhuqHXLGaeDFzGZEA59rs5APu4eLSvG3ckX1I=; b=gOUOXdGNTDmsXARLs+bzAbNAHWFZZt5W/qQ/femgwALO3Ps7CbwnirRBhxSXlAnvYJ gX1L2dGSzcPKjGBH+sOeyguD/zwFk2IZOKtcHWDXAiaxvRhVeLDvc5AzSXBYPh+uOQ1D 6OiaJkWL3ywznXNiqR8W/LZ22eKr9zfDo6kt21EaJDi/xSwgkack/QQWerOUfRmJTf4I WiuF09kV01CkzPAPT4Qa6DGXYEdypjlqAhmlkUW0S/+fmAX3YUo6p+7/alsKKf0voJlO I9LjsGH9H5tb3hHqNsSECM1ha/MneK7dOLuZaKoVjwmr37tQghTAlByrOeu1hChGl+gR zriw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=qZaHFTWl; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id w13si5473422eju.736.2020.07.17.12.00.12; Fri, 17 Jul 2020 12:00:35 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=qZaHFTWl; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728666AbgGQS55 (ORCPT + 99 others); Fri, 17 Jul 2020 14:57:57 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57494 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1728411AbgGQS54 (ORCPT ); Fri, 17 Jul 2020 14:57:56 -0400 Received: from mail-qt1-x842.google.com (mail-qt1-x842.google.com [IPv6:2607:f8b0:4864:20::842]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 4A019C0619D2; Fri, 17 Jul 2020 11:57:56 -0700 (PDT) Received: by mail-qt1-x842.google.com with SMTP id d27so8432600qtg.4; Fri, 17 Jul 2020 11:57:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=u6fuGIKhuqHXLGaeDFzGZEA59rs5APu4eLSvG3ckX1I=; b=qZaHFTWlvx//0vt1MQgdGAjFKJvtWf8tLqNtECwjNMgTGxiRyc6V+MMT+t9TMQp3ah WzJC67QML9b9lLb0BVwDlB8/fSJYdxxlcJuNKHl1JupwqLLwoK1LATwdAVjpYYoJo+DM Be9Djd+E4vxuZhia/BvUW+wMusRWMLgB5I9NbpJWVyMyqr8IyAQhyUa7lzpInB1kEKc9 zhe4Sw3uFd5K+fIxMSDKDHyeLluJsguIn3KMCYamQjuE+W+6YxdJgUP5NWJh+79Pt6zX /B62hj4fQf+vNLfMnrFuub/eXS83IAUNYCHsvUhrHSEm+nES13GahnReHocNYag0v9Bj Jn3g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=u6fuGIKhuqHXLGaeDFzGZEA59rs5APu4eLSvG3ckX1I=; b=QFgDplXCSuP/Vpmub8TD7sCrbJwkLL+JvvaD/GQqoYCJLLnfhHT9siWILgYrZM5Fia FCL8cf195FjQnF6Uv9E+lALDqC59Uq+83At0Q88tWTvB4ZaKZ4LjSFbhNic1M15vmwmU tmit+mfVSCo28nl3uRwcWGpUYhTHFReMYTtV4XUiqi/oBNcCwyib4Q7AhEbUnzj3hRbv fUqwVkZtnYyzWG1u8KxHhWAd0YBo/dmRacdX3yDrVPVBAzubRWMqACJwMf7Cxc27utbh EmOpYUHfErtLZEfqP3p8A1mciv3OB1q1SsZqN8jol/qUecgr4zhy0viRbiJvlXRdWFc5 yT3w== X-Gm-Message-State: AOAM5333E4E95THWCkYpI4VR1hOfdQyiKWTVPGFCN0zVB5TLEMibrU7e 3XVmgpvpuNrH4BfBnUv0ChM= X-Received: by 2002:ac8:4419:: with SMTP id j25mr12574207qtn.0.1595012275507; Fri, 17 Jul 2020 11:57:55 -0700 (PDT) Received: from localhost.localdomain ([2804:18:7002:653c:f7ea:490a:10b0:ec39]) by smtp.gmail.com with ESMTPSA id r6sm11380097qtt.81.2020.07.17.11.57.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 17 Jul 2020 11:57:54 -0700 (PDT) From: "Daniel W. S. Almeida" X-Google-Original-From: Daniel W. S. Almeida To: corbet@lwn.net, mchehab@kernel.org Cc: "Daniel W. S. Almeida" , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 18/25] Documentation/bpf/ringbuf.rst: fix sphinx warnings Date: Fri, 17 Jul 2020 15:56:17 -0300 Message-Id: <20200717185624.2009393-18-dwlsalmeida@gmail.com> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20200717185624.2009393-1-dwlsalmeida@gmail.com> References: <20200717185624.2009393-1-dwlsalmeida@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: "Daniel W. S. Almeida" Fix the following warnings: ringbuf.rst:197: WARNING: Unknown target name: "bench_ringbuf.c" Signed-off-by: Daniel W. S. Almeida --- Documentation/bpf/ringbuf.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Documentation/bpf/ringbuf.rst b/Documentation/bpf/ringbuf.rst index 75f943f0009df..8e7c15a927740 100644 --- a/Documentation/bpf/ringbuf.rst +++ b/Documentation/bpf/ringbuf.rst @@ -200,10 +200,13 @@ a self-pacing notifications of new data being availability. being available after commit only if consumer has already caught up right up to the record being committed. If not, consumer still has to catch up and thus will see new data anyways without needing an extra poll notification. -Benchmarks (see tools/testing/selftests/bpf/benchs/bench_ringbuf.c_) show that +Benchmarks (see `tools/testing/selftests/bpf/benchs/bench_ringbufs.c`_) show that this allows to achieve a very high throughput without having to resort to tricks like "notify only every Nth sample", which are necessary with perf buffer. For extreme cases, when BPF program wants more manual control of notifications, commit/discard/output helpers accept ``BPF_RB_NO_WAKEUP`` and ``BPF_RB_FORCE_WAKEUP`` flags, which give full control over notifications of data availability, but require extra caution and diligence in using this API. + +.. Links +.. _tools/testing/selftests/bpf/benchs/bench_ringbufs.c: benchs/bench_ringbufs.c \ No newline at end of file -- 2.27.0