Struct libbpf_rs::Object

pub struct Object { /* fields omitted */ }

Represents a loaded BPF object file.

An Object is logically in charge of all the contained Programs and Maps as well as the associated metadata and runtime state that underpins the userspace portions of BPF program execution. As a libbpf-rs user, you must keep the Object alive during the entire lifetime of your interaction with anything inside the Object.

Note that this is an explanation of the motivation -- Rust's lifetime system should already be enforcing this invariant.

Implementations

impl Object

pub unsafe fn from_ptr(ptr: *mut bpf_object) -> Self

Takes ownership from pointer.

Safety

If ptr is not already loaded then further operations on the returned object are undefined.

It is not safe to manipulate ptr after this operation.

pub fn map<T: AsRef<str>>(&mut self, name: T) -> Result<Option<&mut Map>>

pub fn map_unwrap<T: AsRef<str>>(&mut self, name: T) -> &mut Map

Same as Object::map except will panic if Err or None is encountered.

pub fn prog<T: AsRef<str>>(&mut self, name: T) -> Result<Option<&mut Program>>

pub fn prog_unwrap<T: AsRef<str>>(&mut self, name: T) -> &mut Program

Same as Object::prog except will panic if Err or None is encountered.

Trait Implementations

impl Drop for Object

pub fn drop(&mut self)

Executes the destructor for this type.