linux.git/Documentation/bpf, branch v5.8

bpf: Document optval > PAGE_SIZE behavior for sockopt hooks

2020-06-17T17:54:05+00:00

Extend existing doc with more details about requiring ctx->optlen = 0
for handling optval > PAGE_SIZE.

Signed-off-by: Stanislav Fomichev 
Signed-off-by: Alexei Starovoitov 
Link: https://lore.kernel.org/bpf/20200617010416.93086-3-sdf@google.com

docs/bpf: Add BPF ring buffer design notes

2020-06-01T21:38:22+00:00

Add commit description from patch #1 as a stand-alone documentation under
Documentation/bpf, as it might be more convenient format, in long term
perspective.

Suggested-by: Stanislav Fomichev 
Signed-off-by: Andrii Nakryiko 
Signed-off-by: Daniel Borkmann 
Link: https://lore.kernel.org/bpf/20200529075424.3139988-6-andriin@fb.com
Signed-off-by: Alexei Starovoitov

selftests/bpf: Add general instructions for test execution

2020-05-22T23:11:09+00:00

Getting a clean BPF selftests run involves ensuring latest trunk LLVM/clang
are used, pahole is recent (>=1.16) and config matches the specified
config file as closely as possible.  Add to bpf_devel_QA.rst and point
tools/testing/selftests/bpf/README.rst to it.

Signed-off-by: Alan Maguire 
Signed-off-by: Daniel Borkmann 
Acked-by: Andrii Nakryiko 
Link: https://lore.kernel.org/bpf/1590146674-25485-1-git-send-email-alan.maguire@oracle.com

docs: networking: convert filter.txt to ReST

2020-04-28T21:39:46+00:00

- add SPDX header;
- adjust title markup;
- mark code blocks and literals as such;
- use footnote markup;
- mark tables as such;
- adjust identation, whitespaces and blank lines;
- add to networking/index.rst.

Signed-off-by: Mauro Carvalho Chehab 
Signed-off-by: David S. Miller

bpf: lsm: Add Documentation

2020-03-29T23:35:12+00:00

Document how eBPF programs (BPF_PROG_TYPE_LSM) can be loaded and
attached (BPF_LSM_MAC) to the LSM hooks.

Signed-off-by: KP Singh 
Signed-off-by: Daniel Borkmann 
Reviewed-by: Brendan Jackman 
Reviewed-by: Florent Revest 
Reviewed-by: Thomas Garnier 
Reviewed-by: James Morris 
Link: https://lore.kernel.org/bpf/20200329004356.27286-9-kpsingh@chromium.org

bpf: Document bpf_inspect drgn tool

2020-03-25T23:08:36+00:00

It's a follow-up for discussion in [1].

drgn tool bpf_inspect.py was merged to drgn repo in [2]. Document it
in kernel tree to make BPF developers aware that the tool exists and
can help with getting BPF state unavailable via UAPI.

For now it's just one tool but the doc is written in a way that allows
to cover more tools in the future if needed.

Please refer to the doc itself for more details.

The patch was tested by `make htmldocs` and sanity-checking that
resulting html looks good.

v2 -> v3:
  - two sections: "Description" and "Getting started" (Daniel);
  - add examples in "Getting started" section (Daniel);
  - add "Customization" section to show how tool can be customized.

v1 -> v2:
  - better "BPF drgn tools" section (Alexei)

  [1] https://lore.kernel.org/bpf/20200228201514.GB51456@rdna-mbp/T/#mefed65e8a98116bd5d07d09a570a3eac46724951
  [2] https://github.com/osandov/drgn/pull/49

Signed-off-by: Andrey Ignatov 
Signed-off-by: Daniel Borkmann 
Link: https://lore.kernel.org/bpf/20200324185135.1431038-1-rdna@fb.com

docs/bpf: Update bpf development Q/A file

2020-02-21T02:05:37+00:00

bpf now has its own mailing list bpf@vger.kernel.org.
Update the bpf_devel_QA.rst file to reflect this.

Also llvm has switch to github with llvm and clang
in the same repo https://github.com/llvm/llvm-project.git.
Update the QA file with newer build instructions.

Signed-off-by: Yonghong Song 
Signed-off-by: Alexei Starovoitov 
Acked-by: Song Liu 
Link: https://lore.kernel.org/bpf/20200221004354.930952-1-yhs@fb.com

bpf: Add s390 testing documentation

2019-10-30T15:25:31+00:00

This commits adds a document that explains how to test BPF in an s390
QEMU guest.

Signed-off-by: Ilya Leoshkevich 
Signed-off-by: Daniel Borkmann 
Link: https://lore.kernel.org/bpf/20191029172916.36528-1-iii@linux.ibm.com

bpf/flow_dissector: add mode to enforce global BPF flow dissector

2019-10-08T03:16:33+00:00

Always use init_net flow dissector BPF program if it's attached and fall
back to the per-net namespace one. Also, deny installing new programs if
there is already one attached to the root namespace.
Users can still detach their BPF programs, but can't attach any
new ones (-EEXIST).

Cc: Petar Penkov 
Acked-by: Andrii Nakryiko 
Acked-by: Song Liu 
Signed-off-by: Stanislav Fomichev 
Signed-off-by: Alexei Starovoitov

bpf/flow_dissector: document flags

2019-07-26T01:00:41+00:00

Describe what each input flag does and who uses it.

Acked-by: Petar Penkov 
Acked-by: Willem de Bruijn 
Acked-by: Song Liu 
Cc: Song Liu 
Cc: Willem de Bruijn 
Cc: Petar Penkov 
Signed-off-by: Stanislav Fomichev 
Signed-off-by: Alexei Starovoitov