bpf,docs: Create new standardization subdirectory
Subsystems (3)
David Vernet
reviewerPATCH 1/1 bpf,docs: Create new standardization subdirectory
The BPF standardization effort is actively underway with the IETF. As described in the BPF Working Group (WG) charter in [0], there are a number of proposed documents, some informational and some proposed standards, that will be drafted as part of the standardization effort.
[0]: https://datatracker.ietf.org/wg/bpf/about/
Though the specific documents that will formally be standardized will exist as Internet Drafts (I-D) and WG documents in the BPF WG datatracker page, the source of truth from where those documents will be generated will reside in the kernel documentation tree (originating in the bpf-next tree).
Because these documents will be used to generate the I-D and WG documents which will be standardized with the IETF, they are a bit special as far as kernel-tree documentation goes:
- They will be dual licensed with LGPL-2.1 OR BSD-2-Clause
- IETF I-D and WG documents (the documents which will actually be standardized) will be auto-generated from these documents.
In order to keep things clearly organized in the BPF documentation tree, and to make it abundantly clear where standards-related documentation needs to go, we should move standards-relevant documents into a separate standardization/ subdirectory.
---
Documentation/bpf/index.rst | 3 +--
Documentation/bpf/standardization/index.rst | 18 ++++++++++++++++++
.../{ => standardization}/instruction-set.rst | 0
.../bpf/{ => standardization}/linux-notes.rst | 3 ++-
MAINTAINERS | 2 +-
5 files changed, 22 insertions(+), 4 deletions(-)
create mode 100644 Documentation/bpf/standardization/index.rst
rename Documentation/bpf/{ => standardization}/instruction-set.rst (100%)
rename Documentation/bpf/{ => standardization}/linux-notes.rst (96%)Documentation/bpf/index.rst +1 -2
@@ -12,9 +12,9 @@ that goes into great technical depth about the BPF Architecture. .. toctree:: :maxdepth: 1 - instruction-set verifier libbpf/index + standardization/index btf faq syscall_api
@@ -29,7 +29,6 @@ that goes into great technical depth about the BPF Architecture. bpf_licensing test_debug clang-notes - linux-notes other redirect
Documentation/bpf/standardization/index.rst new file +18 -0
@@ -0,0 +1,18 @@ +.. SPDX-License-Identifier: (LGPL-2.1 OR BSD-2-Clause) + +=================== +BPF Standardization +=================== + +This directory contains documents that are being iterated on as part of the BPF +standardization effort with the IETF. See the `IETF BPF Working Group`_ page +for the working group charter, documents, and more. + +.. toctree:: + :maxdepth: 1 + + instruction-set + linux-notes + +.. Links: +.. _IETF BPF Working Group: https://datatracker.ietf.org/wg/bpf/about/
Documentation/bpf/standardization/instruction-set.rst renamed from Documentation/bpf/instruction-set.rst +0 -0
Documentation/bpf/standardization/linux-notes.rst renamed from Documentation/bpf/linux-notes.rst +2 -1
@@ -45,7 +45,8 @@ On Linux, this integer is a BTF ID. Legacy BPF Packet access instructions ===================================== -As mentioned in the `ISA standard documentation <instruction-set.rst#legacy-bpf-packet-access-instructions>`_, +As mentioned in the `ISA standard documentation +<instruction-set.html#legacy-bpf-packet-access-instructions>`_, Linux has special eBPF instructions for access to packet data that have been carried over from classic BPF to retain the performance of legacy socket filters running in the eBPF interpreter.
MAINTAINERS +1 -1
@@ -3746,7 +3746,7 @@ R: David Vernet <[email protected]> L: [email protected] L: [email protected] S: Maintained -F: Documentation/bpf/instruction-set.rst +F: Documentation/bpf/standardization/ BPF [GENERAL] (Safe Dynamic Programs and Tools) M: Alexei Starovoitov <[email protected]>
Signature · 1 line
2.40.1
This patch was applied to bpf/bpf-next.git (master) by Alexei Starovoitov <[email protected]>:
Hello:
This patch was applied to bpf/bpf-next.git (master) by Alexei Starovoitov <[email protected]>:
Quoted 8 lines · On Mon, 10 Jul 2023 13:30:27 -0500 you wrote:
The BPF standardization effort is actively underway with the IETF. As described in the BPF Working Group (WG) charter in [0], there are a number of proposed documents, some informational and some proposed standards, that will be drafted as part of the standardization effort.
[0]: https://datatracker.ietf.org/wg/bpf/about/
[...]
Here is the summary with links:
- [bpf-next] bpf,docs: Create new standardization subdirectory
https://git.kernel.org/bpf/bpf-next/c/4d496be9ca05
You are awesome, thank you!
Signature · 2 lines
Deet-doot-dot, I am a bot. https://korg.docs.kernel.org/patchwork/pwbot.html