Received: by 2002:ac0:a5a7:0:0:0:0:0 with SMTP id m36-v6csp426825imm; Tue, 31 Jul 2018 22:13:16 -0700 (PDT) X-Google-Smtp-Source: AAOMgpdVc57lNHrXLyYZzug+OXMKO5YWQZS5xUHWPTf7yrLWUgstxOX4UR1BuLPiNh0kIZaMpSJv X-Received: by 2002:a62:9cd7:: with SMTP id u84-v6mr25310780pfk.90.1533100395934; Tue, 31 Jul 2018 22:13:15 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1533100395; cv=none; d=google.com; s=arc-20160816; b=w4BH+Bn7lpK82Di244Jlha/ezbFQiStFhHQWw56u8pslk8Q5EiqlDU8qgUl+kJY8V7 mrtjroI2mWgfXwy5DF4j2NSibpqcgMSzR57Vh796OTnNkPiLNnV3oMr0uW0dKol68hM8 4EsciGs1pog6rJ+a2ovmQ6Z/yBdgYQj3DZZXQVgE9Lbj1Rqq/p+eHbxhb1PFARssr69W mr3eBMv7O0nKVAXTaZToasP4fylYJx4KlcRN3DnU+PY8ui/8zomkGdWUtkpzwrsydKvM n1iZMZW7HWRTLYo/u5vg+EOZd5vzBuBd+45fhrKhrAiUrLCEBfPrigCj2lAtQiGSj5si csnA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:references:in-reply-to:message-id:date :subject:cc:to:from:dkim-signature:dkim-signature :arc-authentication-results; bh=2wmxxDv2UY+esS3EUJV2LGCmrVOUVjGbcEiL+i4pkDI=; b=r/6Y44b5wOZdP3qM7HuOwePUrkoLYNZMKAByJpiX5N/tvi/6Z6qcKdD4VhQT5ICz6U PBz5axGho65NMSqr40qrDOo4/Rn9mvy6nVbA6D77ph4E6ulQXzX/EjdgEL25AsJvg9kJ hQSv0Lu9OiVGCyIxyUIavLHvjvCexh7FBrQZAZsrI9b0TR/UhHzPizhZlWSVQ95bwKCK Oe2gaxwp5L+KAJRyt2vLoXugMw1ZuCfidmv6x0hGsoIEVdSf4o4mQl4fFaqVG+cmizRi gAyVlAbnLON5oT/kWk2FJmW/ng9KDE30gqC1JC2fqyEzMo4tnVxe5AhIEnGQGfkePe7v g/QA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@tobin.cc header.s=fm3 header.b=g6jcI+Pj; dkim=pass header.i=@messagingengine.com header.s=fm3 header.b=PBcHNmWR; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id t9-v6si15925941pgr.244.2018.07.31.22.13.01; Tue, 31 Jul 2018 22:13:15 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@tobin.cc header.s=fm3 header.b=g6jcI+Pj; dkim=pass header.i=@messagingengine.com header.s=fm3 header.b=PBcHNmWR; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1733109AbeHAGxS (ORCPT + 99 others); Wed, 1 Aug 2018 02:53:18 -0400 Received: from wout3-smtp.messagingengine.com ([64.147.123.19]:36585 "EHLO wout3-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1731897AbeHAGxR (ORCPT ); Wed, 1 Aug 2018 02:53:17 -0400 Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.west.internal (Postfix) with ESMTP id 6B34457E; Wed, 1 Aug 2018 01:09:33 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute5.internal (MEProxy); Wed, 01 Aug 2018 01:09:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tobin.cc; h=cc :date:from:in-reply-to:message-id:references:subject:to :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; bh=2wmxxDv2UY+esS3EU JV2LGCmrVOUVjGbcEiL+i4pkDI=; b=g6jcI+Pj6sEBqBOS1Wzqy0oJi8V8g+w+l tl2cZWu0j3GBKYzFIpijM2ltLzrtrEu5vzyLHXGwGPAsDnJyBJF5J2VkfZywPbxV CGhw7AiwxprEDUjOxq5fFQ+Yi6Z7MsWCwW78OBqaQbhfa65/+/LiQlrau9pajhIL 7iDVlIrODhjfJEZ8h7cudQKn55jyNNkgwqBBJUYaseE6vX3Ri4jPjI3k33OHgK9j QtuUCAnXEqRXIc3kD91JkvJQXts4dUJunx8N1CkjUt6oqnma0bT+PTpVFGuxZ5JU s0I9M3EGBjJfxbIwjETdqcc6HEvzpgF4M5IEvv/npYcc4fEeLorQQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:date:from:in-reply-to:message-id :references:subject:to:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; bh=2wmxxDv2UY+esS3EUJV2LGCmrVOUVjGbcEiL+i4pkDI=; b=PBcHNmWR SeIigchJhWMVn3Ma2RSaIaHMpxdd3tvIbnUYbGJuiD/8mm+cDHWD9dW3nKCLxn0f g2xBRYucOi57G25aGqkWL4LdrcGaBh2GhyXegLa8+gJdDhJeWWK2t1JWuuNAqYAS bWIXjQT50CE4Cf5DJqBTpXenIWGgvHP42DL0BgGYinimLWhi1H3znngSb4uSrqZv UiEWLaA+GgBFQgTGoKyzKuMKLygdlgtbslXi9aCzOXxE2Q4gnmowQjRE32s+s/DK oUfiF7GTmZ/kgJlLsThl/yV2kq2SSpgLwMp/V1tT/4X3To+e+D9ig5xrJSx7DhZN YjvMDIe49tDTBQ== X-ME-Proxy: X-ME-Sender: Received: from localhost (124-169-17-12.dyn.iinet.net.au [124.169.17.12]) by mail.messagingengine.com (Postfix) with ESMTPA id 2A3141026B; Wed, 1 Aug 2018 01:09:31 -0400 (EDT) From: "Tobin C. Harding" To: Daniel Borkmann , Alexei Starovoitov Cc: "Tobin C. Harding" , Jonathan Corbet , "David S. Miller" , linux-doc@vger.kernel.org, netdev@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH bpf-next 02/13] docs: Update references to filter.rst Date: Wed, 1 Aug 2018 15:08:57 +1000 Message-Id: <20180801050908.29970-3-me@tobin.cc> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20180801050908.29970-1-me@tobin.cc> References: <20180801050908.29970-1-me@tobin.cc> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Documentation/networking/filter.rst was just renamed. In order to use RST references we need to add a label to filter.rst Add label and update references from filter.txt to filter.rst Signed-off-by: Tobin C. Harding --- Documentation/bpf/index.rst | 9 ++++----- Documentation/networking/filter.rst | 2 ++ Documentation/networking/packet_mmap.txt | 2 +- tools/bpf/bpf_asm.c | 2 +- tools/bpf/bpf_dbg.c | 2 +- 5 files changed, 9 insertions(+), 8 deletions(-) diff --git a/Documentation/bpf/index.rst b/Documentation/bpf/index.rst index 00a8450a602f..192393135c61 100644 --- a/Documentation/bpf/index.rst +++ b/Documentation/bpf/index.rst @@ -7,10 +7,10 @@ Filter) facility, with a focus on the extended BPF version (eBPF). This kernel side documentation is still work in progress. The main textual documentation is (for historical reasons) described in -`Documentation/networking/filter.txt`_, which describe both classical -and extended BPF instruction-set. -The Cilium project also maintains a `BPF and XDP Reference Guide`_ -that goes into great technical depth about the BPF Architecture. +:ref:`Documentation/networking/filter.rst `, which describe +both classical and extended BPF instruction-set. The Cilium project also +maintains a `BPF and XDP Reference Guide`_ that goes into great technical +depth about the BPF Architecture. The primary info for the bpf syscall is available in the `man-pages`_ for `bpf(2)`_. @@ -30,7 +30,6 @@ Two sets of Questions and Answers (Q&A) are maintained. .. Links: -.. _Documentation/networking/filter.txt: ../networking/filter.txt .. _man-pages: https://www.kernel.org/doc/man-pages/ .. _bpf(2): http://man7.org/linux/man-pages/man2/bpf.2.html .. _BPF and XDP Reference Guide: http://cilium.readthedocs.io/en/latest/bpf/ diff --git a/Documentation/networking/filter.rst b/Documentation/networking/filter.rst index e6b4ebb2b243..14ce8901c245 100644 --- a/Documentation/networking/filter.rst +++ b/Documentation/networking/filter.rst @@ -1,6 +1,8 @@ Linux Socket Filtering aka Berkeley Packet Filter (BPF) ======================================================= +.. _bpf_filter: + Introduction ------------ diff --git a/Documentation/networking/packet_mmap.txt b/Documentation/networking/packet_mmap.txt index 999eb41da81d..494614573c67 100644 --- a/Documentation/networking/packet_mmap.txt +++ b/Documentation/networking/packet_mmap.txt @@ -1051,7 +1051,7 @@ for more information on hardware timestamps. ------------------------------------------------------------------------------- - Packet sockets work well together with Linux socket filters, thus you also - might want to have a look at Documentation/networking/filter.txt + might want to have a look at Documentation/networking/filter.rst -------------------------------------------------------------------------------- + THANKS diff --git a/tools/bpf/bpf_asm.c b/tools/bpf/bpf_asm.c index c15aef097b04..5040875735db 100644 --- a/tools/bpf/bpf_asm.c +++ b/tools/bpf/bpf_asm.c @@ -10,7 +10,7 @@ * * How to get into it: * - * 1) read Documentation/networking/filter.txt + * 1) read Documentation/networking/filter.rst * 2) Run `bpf_asm [-c] ` to translate into binary * blob that is loadable with xt_bpf, cls_bpf et al. Note: -c will * pretty print a C-like construct. diff --git a/tools/bpf/bpf_dbg.c b/tools/bpf/bpf_dbg.c index 61b9aa5d6415..d05d8df0ce3b 100644 --- a/tools/bpf/bpf_dbg.c +++ b/tools/bpf/bpf_dbg.c @@ -12,7 +12,7 @@ * for making a verdict when multiple simple BPF programs are combined * into one in order to prevent parsing same headers multiple times. * - * More on how to debug BPF opcodes see Documentation/networking/filter.txt + * More on how to debug BPF opcodes see Documentation/networking/filter.rst * which is the main document on BPF. Mini howto for getting started: * * 1) `./bpf_dbg` to enter the shell (shell cmds denoted with '>'): -- 2.17.1