This is a mirror of bpf-next linux tree's tools/lib/bpf directory plus its supporting header files.

The following files will by sync'ed with bpf-next repo: - src/ <-> bpf-next/tools/lib/bpf/ - include/uapi/linux/bpf_common.h <-> bpf-next/tools/include/uapi/linux/bpf_common.h - include/uapi/linux/bpf.h <-> bpf-next/tools/include/uapi/linux/bpf.h - include/uapi/linux/btf.h <-> bpf-next/tools/include/uapi/linux/btf.h - include/uapi/linux/if_link.h <-> bpf-next/tools/include/uapi/linux/if_link.h - include/uapi/linux/if_xdp.h <-> bpf-next/tools/include/uapi/linux/if_xdp.h - include/uapi/linux/netlink.h <-> bpf-next/tools/include/uapi/linux/netlink.h - include/tools/libc_compat.h <-> bpf-next/tools/include/tools/libc_compat.h

Other header files at this repo (include/linux/*.h) are reduced versions of their counterpart files at bpf-next's tools/include/linux/*.h to make compilation successful.

Build ===== libelf is an internal dependency of libbpf and thus it is required to link against and must be installed on the system for applications to work. pkg-config is used by default to find libelf, and the program called can be overridden with PKG_CONFIG. If using pkg-config at build time is not desired, it can be disabled by setting NO_PKG_CONFIG=1 when calling make.

To build both static libbpf.a and shared libbpf.so:

$ cd src
$ make

To build only static libbpf.a library in directory build/ and install them together with libbpf headers in a staging directory root/:

$ cd src
$ mkdir build root
$ BUILD_STATIC_ONLY=y OBJDIR=build DESTDIR=root make install

To build both static libbpf.a and shared libbpf.so against a custom libelf dependency installed in /build/root/ and install them together with libbpf headers in a build directory /build/root/:

$ cd src
$ PKG_CONFIG_PATH=/build/root/lib64/pkgconfig DESTDIR=/build/root make install

Distributions

Distributions packaging libbpf from this mirror: - Fedora - Gentoo

Benefits of packaging from the mirror over packaging from kernel sources: - Consistent versioning across distributions. - No ties to any specific kernel, transparent handling of older kernels. Libbpf is designed to be kernel-agnostic and work across multitude of kernel versions. It has built-in mechanisms to gracefully handle older kernels, that are missing some of the features, by working around or gracefully degrading functionality. Thus libbpf is not tied to a specific kernel version and can/should be packaged and versioned independently. - Continuous integration testing via TravisCI. - Static code analysis via LGTM and Coverity.

Package dependencies of libbpf, package names may vary across distros: - zlib - libelf

License

This work is dual-licensed under BSD 2-clause license and GNU LGPL v2.1 license. You can choose between one of them if you use this work.

SPDX-License-Identifier: BSD-2-Clause OR LGPL-2.1