#bpf #async #ring-buffer #libbpf

libbpf-async

library for writing BPF programs in Async Rust, complementary for libbpf-rs

2 unstable releases

0.2.0 Jan 30, 2024
0.1.0 Nov 5, 2021

#654 in Unix APIs

36 downloads per month

LGPL-2.1 OR BSD-2-Clause

8KB
126 lines

libbpf-async

A library for writing BPF programs in Async Rust, complementary for libbpf-rs, Rust wrapper for libbpf.

Currently, this provides Async-friendly APIs for BPF ring buffer.

To use in your project, add into your Cargo.toml:

[dependencies]
libbpf-async = "0.1"

Example

#[tokio::main]
async fn main() {
    let mut builder = TracerSkelBuilder::default();
    let mut skel = builder.open().unwrap().load().unwrap();

    let mut rb = libbpf_async::RingBuffer::new(skel.obj.map_mut("ringbuf").unwrap());
    loop {
        let mut buf = [0; 128];
        let n = rb.read(&mut buf).await.unwrap();
        // do something useful with the buffer
    }
}

A working example code can be found here.

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.

Dependencies

~13–21MB
~303K SLoC