Struct libbpf_rs::RingBufferBuilder

pub struct RingBufferBuilder<'a> { /* private fields */ }

Builds RingBuffer instances.

ringbufs are a special kind of Map, used to transfer data between Programs and userspace. As of Linux 5.8, the ringbuf map is now preferred over the perf buffer.

Implementations

impl<'a> RingBufferBuilder<'a>

pub fn new() -> Self

Create a new RingBufferBuilder object.

pub fn add<NewF>(&mut self, map: &Map, callback: NewF) -> Result<&mut Self>where NewF: FnMut(&[u8]) -> i32 + 'a,

Add a new ringbuf map and associated callback to this ring buffer manager. The callback should take one argument, a slice of raw bytes, and return an i32.

Non-zero return values in the callback will stop ring buffer consumption early.

The callback provides a raw byte slice. You may find libraries such as plain helpful.

pub fn build(self) -> Result<RingBuffer<'a>>

Build a new RingBuffer. Must have added at least one ringbuf.

Trait Implementations

impl<'a> Debug for RingBufferBuilder<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> Default for RingBufferBuilder<'a>

fn default() -> RingBufferBuilder<'a>

Returns the “default value” for a type.