OSDN Git Service

bpf, documentation: Add graph documentation for non-owning refs
authorDave Marchevsky <davemarchevsky@fb.com>
Tue, 14 Feb 2023 00:40:17 +0000 (16:40 -0800)
committerAlexei Starovoitov <ast@kernel.org>
Tue, 14 Feb 2023 03:40:53 +0000 (19:40 -0800)
commitc31315c3aa09297d99cb39e837185ef225586d2b
treef1b9066aa67ec9e0dde41fb157452f4df3f04d82
parent215249f6adc0359e3546829e7ee622b5e309b0ad
bpf, documentation: Add graph documentation for non-owning refs

It is difficult to intuit the semantics of owning and non-owning
references from verifier code. In order to keep the high-level details
from being lost in the mailing list, this patch adds documentation
explaining semantics and details.

The target audience of doc added in this patch is folks working on BPF
internals, as there's focus on "what should the verifier do here". Via
reorganization or copy-and-paste, much of the content can probably be
repurposed for BPF program writer audience as well.

Signed-off-by: Dave Marchevsky <davemarchevsky@fb.com>
Link: https://lore.kernel.org/r/20230214004017.2534011-9-davemarchevsky@fb.com
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
Documentation/bpf/graph_ds_impl.rst [new file with mode: 0644]
Documentation/bpf/other.rst