libbpf: add bpf_object__open_{file, mem} w/ extensible opts
authorAndrii Nakryiko <andriin@fb.com>
Fri, 4 Oct 2019 22:40:35 +0000 (15:40 -0700)
committerAlexei Starovoitov <ast@kernel.org>
Sun, 6 Oct 2019 01:09:47 +0000 (18:09 -0700)
commit2ce8450ef5a381e5ffeb4682c0093a3ab5d07008
treebe97146a8e0eac4a465259ed2b11393685c09622
parent5e61f27070292d4ad3af51dc68eebab6c1df69d3
libbpf: add bpf_object__open_{file, mem} w/ extensible opts

Add new set of bpf_object__open APIs using new approach to optional
parameters extensibility allowing simpler ABI compatibility approach.

This patch demonstrates an approach to implementing libbpf APIs that
makes it easy to extend existing APIs with extra optional parameters in
such a way, that ABI compatibility is preserved without having to do
symbol versioning and generating lots of boilerplate code to handle it.
To facilitate succinct code for working with options, add OPTS_VALID,
OPTS_HAS, and OPTS_GET macros that hide all the NULL, size, and zero
checks.

Additionally, newly added libbpf APIs are encouraged to follow similar
pattern of having all mandatory parameters as formal function parameters
and always have optional (NULL-able) xxx_opts struct, which should
always have real struct size as a first field and the rest would be
optional parameters added over time, which tune the behavior of existing
API, if specified by user.

Signed-off-by: Andrii Nakryiko <andriin@fb.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
tools/lib/bpf/libbpf.c
tools/lib/bpf/libbpf.h
tools/lib/bpf/libbpf.map
tools/lib/bpf/libbpf_internal.h