]> git.baikalelectronics.ru Git - kernel.git/commit
bpf/scripts: Raise an exception if the correct number of sycalls are not generated
authorUsama Arif <usama.arif@bytedance.com>
Wed, 19 Jan 2022 11:44:42 +0000 (11:44 +0000)
committerAndrii Nakryiko <andrii@kernel.org>
Wed, 19 Jan 2022 18:24:50 +0000 (10:24 -0800)
commit3a22b5af61783654c99dda2d97f6b7a1ccd78ec4
treec1d0987f6bf294413e71823b0b03253cb974e2be
parent04ae05381292986dfdb3bfc2f0e0610b7fc15edd
bpf/scripts: Raise an exception if the correct number of sycalls are not generated

Currently the syscalls rst and subsequently man page are auto-generated
using function documentation present in bpf.h. If the documentation for the
syscall is missing or doesn't follow a specific format, then that syscall
is not dumped in the auto-generated rst.

This patch checks the number of syscalls documented within the header file
with those present as part of the enum bpf_cmd and raises an Exception if
they don't match. It is not needed with the currently documented upstream
syscalls, but can help in debugging when developing new syscalls when
there might be missing or misformatted documentation.

The function helper_number_check is moved to the Printer parent
class and renamed to elem_number_check as all the most derived children
classes are using this function now.

Signed-off-by: Usama Arif <usama.arif@bytedance.com>
Signed-off-by: Andrii Nakryiko <andrii@kernel.org>
Reviewed-by: Quentin Monnet <quentin@isovalent.com>
Link: https://lore.kernel.org/bpf/20220119114442.1452088-3-usama.arif@bytedance.com
scripts/bpf_doc.py