libbpf-async

Crates.iolibbpf-async
lib.rslibbpf-async
version0.2.0
sourcesrc
created_at2021-11-05 01:25:45.922902
updated_at2024-01-30 01:20:16.384568
descriptionlibrary for writing BPF programs in Async Rust, complementary for libbpf-rs
homepagehttps://github.com/fujita/libbpf-async
repositoryhttps://github.com/fujita/libbpf-async
max_upload_size
id477132
size7,704
FUJITA Tomonori (fujita)

documentation

README

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.

Commit count: 32

cargo fmt