Received: by 2002:ac0:a5a7:0:0:0:0:0 with SMTP id m36-v6csp1627540imm; Wed, 8 Aug 2018 22:26:42 -0700 (PDT) X-Google-Smtp-Source: AA+uWPyt73rqTrw9T5H/XFupShiJ/cmHuz1jn0yZR4+xvfJlwGZywXjzltWCIHHBXkZYJNHPnMtP X-Received: by 2002:a62:c699:: with SMTP id x25-v6mr797178pfk.16.1533792401955; Wed, 08 Aug 2018 22:26:41 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1533792401; cv=none; d=google.com; s=arc-20160816; b=bn1wRAOUpceRYemhWH79ZCSOO81oRA6zMqMO1JQ6b2Dzkvr8FxjhHbRWVpxBh0r817 a3CgvHaNq7uCcM0nikH49FIY9pqczZqn4NWpeiiGlH7cuGAIj9yO35inZgFJh7wQrKOM pbtjY0uUYyH1WZrQSIILwnVl68cX7lwt4HO3iMGWdzxxRlEEFEzRCLukgxOkSrcLqho7 r7SG5aAdj4b1Kj79sObK5jQSPTP2pLZeV+GBAFnKg7x4NwG2Hv1HZqpIZcEFnOvRR3z3 A96Q3YQ5gRf//zku5hDnp2OAK3sAvNq/xAAiAKakKGZ1MXWs+KrV+O7f6g9D5H9EczY5 7wGg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:date:subject:cc:to:from :dkim-signature:dkim-signature:arc-authentication-results; bh=c3okl1OWYU1jpoJrDgPHDwwRHKmwQCYuiQ73nS5k+Qs=; b=itRExcU3VrGv1jd6RXDTknlZHb8kUml67DxmeCYwD8Ld5TZeFLsIQn96qCBFkOLICq BLmQf1NR/a/6DBUgcvPdPtn7tQLB+LLGn6/m5Qp1A+J+eAz8k61cEGrjpU2dfYVgaK0r oToKmMl7Y7VhfHnm+DVEtTMch91SP6E0cR3O7+z7AYy+Ioia3Tj+X7VdcrwFjRacKZ4w 8FBrHplnYtC/b4YnANP1b8RE+ZgmP7CrxJOHk9EDq+yCB9gmzRZivU1BBxxd3FiEu2q3 JlIXauwX1e8A+CpIU2OKQ4S3Z423JVeAh2oUIQ4vr/+o2IBN4aalCTiNAH+bcz9yhEor 5mnA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@tobin.cc header.s=fm3 header.b=LxCmTLAS; dkim=pass header.i=@messagingengine.com header.s=fm3 header.b=YpNrVE9A; 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 s2-v6si4928823pgc.447.2018.08.08.22.26.27; Wed, 08 Aug 2018 22:26:41 -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=LxCmTLAS; dkim=pass header.i=@messagingengine.com header.s=fm3 header.b=YpNrVE9A; 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 S1728363AbeHIHqo (ORCPT + 99 others); Thu, 9 Aug 2018 03:46:44 -0400 Received: from out1-smtp.messagingengine.com ([66.111.4.25]:55433 "EHLO out1-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727724AbeHIHqo (ORCPT ); Thu, 9 Aug 2018 03:46:44 -0400 Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.nyi.internal (Postfix) with ESMTP id F007721E0F; Thu, 9 Aug 2018 01:23:40 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute5.internal (MEProxy); Thu, 09 Aug 2018 01:23:40 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tobin.cc; h=cc :date:from:message-id:subject:to:x-me-sender:x-me-sender :x-sasl-enc; s=fm3; bh=c3okl1OWYU1jpoJrDgPHDwwRHKmwQCYuiQ73nS5k+ Qs=; b=LxCmTLASrTYKuu1zL6gBR6j1v2wnssJRVaxn+Jo3PZTArt8K8RTymhXGL 8Fw9mRjKih59owhJB7M7M5pOV6gZVh+tPhe79apMFhpjohSJg7rrNvUZVtff1T4m xdj8XlmA3GaLoWf7tJ5fmVKZUeuVH6YHAvM876tuVUysVn7sI4mVj5iVmfdngJOK +75E0RrDXgD5DbQgrTsuPorUwTqOm+Le4iMFc28DNptfwdhsiBU+fmlwQ1xjjgZ1 FtiyG8n5pXxhWaKvfuEFh5Tq0Gf9acq+uqRU+2aKPPaUejUERszA0PCqTcSHnx1z CMfL1E/MujvScDmpYQ7PQ1S5BxmFQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:date:from:message-id:subject:to :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; bh=c3okl1OWYU1jpoJrD gPHDwwRHKmwQCYuiQ73nS5k+Qs=; b=YpNrVE9ApEZDu2ejtY7DesVUJCRc3LQ+t QMtPOh7WxujvVed4ISRwq5kScOx5/+mC+XYXgHc/f6Aj8IQRecECkW8odwoy5CNt uQXkI/fhb1YOqGeeKOgLaXqNwhqPj4kNup4Ndf5zVdpSApqwzBM7fdHxxXWbNEwB 5qaaCIlyCT9OfkbfYEspsp+Jgr222TWr9HLiXxjay7cU0g776eK95yiVYpa2p7hU uiFtSF5Zn1DGc9mIWHSDRzeMJL2BVGiS2HwEwLKpLumzo9BU+OZU6Xcpoe73B07l EVJqU5p1Jc8giF1ayif+UV7bIulKEKaa0LLZBbhXz8zcmPPEmexdg== X-ME-Proxy: X-ME-Sender: Received: from localhost (ppp121-44-213-17.bras1.syd2.internode.on.net [121.44.213.17]) by mail.messagingengine.com (Postfix) with ESMTPA id 34FAC10261; Thu, 9 Aug 2018 01:23:38 -0400 (EDT) From: "Tobin C. Harding" To: Daniel Borkmann , Alexei Starovoitov Cc: "Tobin C. Harding" , Jonathan Corbet , "David S. Miller" , Kees Cook , Andy Lutomirski , Will Drewry , linux-doc@vger.kernel.org, netdev@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH bpf-next 0/4] Convert filter.txt to RST Date: Thu, 9 Aug 2018 15:23:24 +1000 Message-Id: <20180809052328.27942-1-me@tobin.cc> X-Mailer: git-send-email 2.17.1 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi, This is my latest attempt at converting Documentation/filter.txt to RST format. Added to the CC list because of additional changes to Documentation/userspace-api/seccomp_filter.rst For reference this set is a progression of the follow sets (in order of post date to LKML) 1. [PATCH bpf-next 00/13] docs: Convert BPF filter.txt to RST 2. [RFC bpf-next 0/3] docs: Convert filter.txt to RST 3. [RFC bpf-next v2 0/3] docs: Convert filter.txt to RST Sending this to BPF maintainers for hopeful inclusion in the bpf-next tree. As discussed on LKML this set does all the conversion in a single patch. This includes adding SPDX licence comments (inc. seccomp_filter), adding RST labels, and updating references. Please note this set adds three files to the MAINTAINERS file for the BPF maintainers. Is this rude? Also this set adds a SPDX licence to all new files and also to seccomp_filter.rst I did this because checkpatch asked me to but I am unsure on the protocol, is it acceptable to add a licence to documentation that someone else wrote? For the Record; Daniel and Alexei, can I please have permission to add GPLv2+ to the BPF docs? Kees, Andy, and Drewry, can I please have permission to add GPLv2+ to seccomp_filter.rst (added Cc: tag to patch 2 that adds the licence identifiers) thanks, Tobin. Tobin C. Harding (4): docs: net: Fix various minor typos docs: Separate and convert filter.txt to RST docs: Judiciously use double ticks docs: Remove filter.txt from the tree Documentation/networking/filter.txt | 1476 ----------------- Documentation/userspace-api/cBPF.rst | 432 +++++ Documentation/userspace-api/eBPF.rst | 1006 +++++++++++ Documentation/userspace-api/index.rst | 3 + .../userspace-api/seccomp_filter.rst | 11 + Documentation/userspace-api/socket_filter.rst | 183 ++ MAINTAINERS | 4 +- 7 files changed, 1638 insertions(+), 1477 deletions(-) delete mode 100644 Documentation/networking/filter.txt create mode 100644 Documentation/userspace-api/cBPF.rst create mode 100644 Documentation/userspace-api/eBPF.rst create mode 100644 Documentation/userspace-api/socket_filter.rst -- 2.17.1