#bpf #ebpf #xdp

sys libbpf-sys

Rust bindings to libbpf from the Linux kernel

13 releases

0.1.0-1 Aug 27, 2020
0.0.9-1 Jul 18, 2020
0.0.6-7 Jan 15, 2020
0.0.6-4 Dec 20, 2019
0.0.0 Nov 7, 2017

#29 in Unix APIs

Download history 53/week @ 2020-06-01 86/week @ 2020-06-08 89/week @ 2020-06-15 124/week @ 2020-06-22 171/week @ 2020-06-29 97/week @ 2020-07-06 129/week @ 2020-07-13 172/week @ 2020-07-20 249/week @ 2020-07-27 175/week @ 2020-08-03 381/week @ 2020-08-10 488/week @ 2020-08-17 471/week @ 2020-08-24 181/week @ 2020-08-31 521/week @ 2020-09-07 492/week @ 2020-09-14

863 downloads per month
Used in 3 crates

BSD-2-Clause

685KB
18K SLoC

C 14K SLoC // 0.1% comments Rust 4K SLoC // 0.0% comments Shell 1K SLoC // 0.1% comments BASH 45 SLoC // 0.1% comments

libbpf-sys Travis CI build status badge crates.io version number badge

Rust bindings to libbpf from the Linux kernel

Maintainer: Alex Forster <alex@alexforster.com>
License: BSD-2-Clause

libbpf-sys is the packaged result of using bindgen to automatically generate Rust FFI bindings to libbpf from the Linux kernel.

Warning: this crate does not provide a high-level or "safe" API wrapper around libbpf. If you are looking for an easier way to use libbpf, check out these other crates that implement higher-level APIs using libbpf-sys...

The community is encouraged to build higher-level crates using libbpf-sys. Please let me know if you do!

Building

As part of the cargo build process, an included copy of libbpf is compiled and statically linked into the resulting binary. This means that, in order to build a project that depends on this crate, your system must provide a working C compiler toolchain (GCC and Clang should both work). Additionally, your system must provide development headers for zlib and libelf, and they must be discoverable via pkgconfig.

Distribution

When you add this crate as a dependency to your project, your resulting binaries will dynamically link with libz and libelf. This means that the systems where you run your binaries must have these libraries installed.

Versioning

Because the API of this crate is automatically generated from libbpf sources, it uses a versioning scheme based on the version of libbpf that it provides.

The "Major.Minor.Patch" semver numbers correspond exactly to the libbpf version that each release provides. For example, the 0.0.8-1 release of this crate provides the API for the libbpf v0.0.8 release.

In order to allow for human error, all releases have a "pre-release" version number appended to them. For example, both the 0.0.6-1 and 0.0.6-2 releases of this crate contain bindings to libbpf v0.0.6, but the later release contains bugfixes and/or enhancements to the crate itself.

Note: because this crate uses a "pre-release" version number, it is impossible to use wildcard-style version syntax in your Cargo.toml file. You must specify the exact version of libbpf-sys, and you must not assume that any other version will be API or ABI compatible.

Licensing and Dependencies

This crate is released under the BSD 2-Clause license, and is careful to avoid infecting users with viral licenses.

It currently depends on the following third-party libraries:

Website License Linkage
libbpf github.com/libbpf/libbpf LGPL-2.1-only OR BSD-2-Clause Static
libelf sourceware.org/elfutils LGPL-2.1-or-later OR LGPL-3.0-or-later Dynamic
zlib zlib.net Zlib Dynamic

Dependencies