提交 25906092 编写于 作者: B Bagas Sanjaya 提交者: Andrii Nakryiko

Documentation: bpf: Escape underscore in BPF type name prefix

Sphinx reported unknown target warning:

Documentation/bpf/bpf_design_QA.rst:329: WARNING: Unknown target name: "bpf".

The warning is caused by BPF type name prefix ("bpf_") which is written
without escaping the trailing underscore.

Escape the underscore to fix the warning. While at it, wrap the
containing paragraph in less than 80 characters.

Fixes: 9805af8d ("bpf: Document UAPI details for special BPF types")
Signed-off-by: NBagas Sanjaya <bagasdotme@gmail.com>
Signed-off-by: NAndrii Nakryiko <andrii@kernel.org>
Acked-by: NKP Singh <kpsingh@kernel.org>
Acked-by: NDavid Vernet <void@manifault.com>
Link: https://lore.kernel.org/bpf/20221104123913.50610-1-bagasdotme@gmail.com
上级 61fc5e66
...@@ -326,11 +326,11 @@ size, type, and alignment, or any other user visible API or ABI detail across ...@@ -326,11 +326,11 @@ size, type, and alignment, or any other user visible API or ABI detail across
kernel releases. The users must adapt their BPF programs to the new changes and kernel releases. The users must adapt their BPF programs to the new changes and
update them to make sure their programs continue to work correctly. update them to make sure their programs continue to work correctly.
NOTE: BPF subsystem specially reserves the 'bpf_' prefix for type names, in NOTE: BPF subsystem specially reserves the 'bpf\_' prefix for type names, in
order to introduce more special fields in the future. Hence, user programs must order to introduce more special fields in the future. Hence, user programs must
avoid defining types with 'bpf_' prefix to not be broken in future releases. In avoid defining types with 'bpf\_' prefix to not be broken in future releases.
other words, no backwards compatibility is guaranteed if one using a type in BTF In other words, no backwards compatibility is guaranteed if one using a type
with 'bpf_' prefix. in BTF with 'bpf\_' prefix.
Q: What is the compatibility story for special BPF types in local kptrs? Q: What is the compatibility story for special BPF types in local kptrs?
------------------------------------------------------------------------ ------------------------------------------------------------------------
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册