OSDN Git Service

libbpf: Deprecate ambiguously-named bpf_program__size() API
authorAndrii Nakryiko <andrii@kernel.org>
Mon, 25 Oct 2021 22:45:31 +0000 (15:45 -0700)
committerAlexei Starovoitov <ast@kernel.org>
Tue, 26 Oct 2021 01:37:21 +0000 (18:37 -0700)
commitc4813e969ac471af730902377a2656b6b1b92c4d
tree20e332370af87375b7a5675cd45e7a0705decfb6
parente21d585cb3db65a207cd338c74b9886090ef1ceb
libbpf: Deprecate ambiguously-named bpf_program__size() API

The name of the API doesn't convey clearly that this size is in number
of bytes (there needed to be a separate comment to make this clear in
libbpf.h). Further, measuring the size of BPF program in bytes is not
exactly the best fit, because BPF programs always consist of 8-byte
instructions. As such, bpf_program__insn_cnt() is a better alternative
in pretty much any imaginable case.

So schedule bpf_program__size() deprecation starting from v0.7 and it
will be removed in libbpf 1.0.

Signed-off-by: Andrii Nakryiko <andrii@kernel.org>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
Link: https://lore.kernel.org/bpf/20211025224531.1088894-5-andrii@kernel.org
tools/lib/bpf/libbpf.h