kernel/linux.git/Documentation/bpf/standardization, branch v6.6.132

bpf, docs: s/eBPF/BPF in standards documents

2023-08-30T14:36:10+00:00

There isn't really anything other than just "BPF" at this point, so referring to it as "eBPF" in our standards document just causes unnecessary confusion. Let's just be consistent and use "BPF". Suggested-by: Will Hawkins Signed-off-by: David Vernet Signed-off-by: Daniel Borkmann Link: https://lore.kernel.org/bpf/20230828155948.123405-4-void@manifault.com

bpf, docs: Add abi.rst document to standardization subdirectory

2023-08-30T14:35:58+00:00

As specified in the IETF BPF charter, the BPF working group has plans to add one or more informational documents that recommend conventions and guidelines for producing portable BPF program binaries. The instruction-set.rst document currently contains a "Registers and calling convention" subsection which dictates a calling convention that belongs in an ABI document, rather than an instruction set document. Let's move it to a new abi.rst document so we can clean it up. The abi.rst document will of course be significantly changed and expanded upon over time. For now, it's really just a placeholder which will contain ABI-specific language that doesn't belong in other documents. Signed-off-by: David Vernet Signed-off-by: Daniel Borkmann Link: https://lore.kernel.org/bpf/20230828155948.123405-3-void@manifault.com

bpf, docs: Move linux-notes.rst to root bpf docs tree

2023-08-30T14:35:44+00:00

In commit 4d496be9ca05 ("bpf,docs: Create new standardization subdirectory"), I added a standardization/ directory to the BPF documentation, which will contain the docs that will be standardized as part of the effort with the IETF. I included linux-notes.rst in that directory, but I shouldn't have. It doesn't contain anything that will be standardized. Let's move it back to Documentation/bpf. Signed-off-by: David Vernet Signed-off-by: Daniel Borkmann Link: https://lore.kernel.org/bpf/20230828155948.123405-2-void@manifault.com

bpf, docs: Correct source of offset for program-local call

2023-08-30T07:49:53+00:00

The offset to use when calculating the target of a program-local call is in the instruction's imm field, not its offset field. Signed-off-by: Will Hawkins Signed-off-by: Daniel Borkmann Acked-by: Eduard Zingerman Acked-by: David Vernet Link: https://lore.kernel.org/bpf/20230826053258.1860167-1-hawkinsw@obs.cr

bpf, docs: Fix small typo and define semantics of sign extension

2023-08-08T23:29:20+00:00

Add additional precision on the semantics of the sign extension operations in BPF. In addition, fix a very minor typo. Signed-off-by: Will Hawkins Acked-by: David Vernet Link: https://lore.kernel.org/r/20230808212503.197834-1-hawkinsw@obs.cr Signed-off-by: Martin KaFai Lau

bpf, docs: Formalize type notation and function semantics in ISA standard

2023-08-07T22:13:26+00:00

Give a single place where the shorthand for types are defined and the semantics of helper functions are described. Signed-off-by: Will Hawkins Acked-by: David Vernet Link: https://lore.kernel.org/r/20230807140651.122484-1-hawkinsw@obs.cr Signed-off-by: Martin KaFai Lau

docs/bpf: Fix malformed documentation

2023-07-30T01:57:51+00:00

Two issues are fixed: 1. Malformed table due to newly-introduced BPF_MOVSX 2. Missing reference link for ``Sign-extension load operations`` Fixes: 245d4c40c09b ("docs/bpf: Add documentation for new instructions") Cc: bpf@ietf.org Reported-by: kernel test robot Closes: https://lore.kernel.org/oe-kbuild-all/202307291840.Cqhj7uox-lkp@intel.com/ Signed-off-by: Yonghong Song Link: https://lore.kernel.org/r/20230730004251.381307-1-yonghong.song@linux.dev Signed-off-by: Alexei Starovoitov

docs/bpf: Improve documentation for cpu=v4 instructions

2023-07-28T23:50:06+00:00

Improve documentation for cpu=v4 instructions based on David's suggestions. Cc: bpf@ietf.org Suggested-by: David Vernet Acked-by: David Vernet Signed-off-by: Yonghong Song Link: https://lore.kernel.org/r/20230728225105.919595-1-yonghong.song@linux.dev Signed-off-by: Alexei Starovoitov

docs/bpf: Add documentation for new instructions

2023-07-28T01:54:17+00:00

Add documentation in instruction-set.rst for new instruction encoding and their corresponding operations. Also removed the question related to 'no BPF_SDIV' in bpf_design_QA.rst since we have BPF_SDIV insn now. Cc: bpf@ietf.org Signed-off-by: Yonghong Song Link: https://lore.kernel.org/r/20230728011342.3724411-1-yonghong.song@linux.dev Signed-off-by: Alexei Starovoitov

bpf, docs: fix BPF_NEG entry in instruction-set.rst

2023-07-28T00:31:49+00:00

This patch fixes the documentation of the BPF_NEG instruction to denote that it does not use the source register operand. Signed-off-by: Jose E. Marchesi Acked-by: Dave Thaler Acked-by: Yonghong Song Link: https://lore.kernel.org/r/20230726092543.6362-1-jose.marchesi@oracle.com Signed-off-by: Alexei Starovoitov