Struct Object 

#[repr(transparent)]
pub struct Object {
    ptr: NonNull<bpf_object>,
}

Represents a loaded BPF object file.

An Object is logically in charge of all the contained [Program]s and [Map]s 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.

Fields

ptr: NonNull<bpf_object>

Implementations

impl Object

pub unsafe fn from_ptr(ptr: NonNull<bpf_object>) -> Object

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 name(&self) -> Option<&OsStr>

Retrieve the object’s name.

pub fn btf(&self) -> Result<Option<Btf<'_>>, Error>

Parse the btf information associated with this bpf object.

pub fn maps(&self) -> impl Iterator<Item = MapImpl<'_>>

Retrieve an iterator over all BPF maps in the object.

pub fn maps_mut(&mut self) -> impl Iterator<Item = MapImpl<'_, Mut>>

Retrieve an iterator over all BPF maps in the object.

pub fn progs(&self) -> impl Iterator<Item = ProgramImpl<'_>>

Retrieve an iterator over all BPF programs in the object.

pub fn progs_mut(&self) -> impl Iterator<Item = ProgramImpl<'_, Mut>>

Retrieve an iterator over all BPF programs in the object.

Trait Implementations

impl AsRawLibbpf for Object

fn as_libbpf_object(&self) -> NonNull<<Object as AsRawLibbpf>::LibbpfType>

Retrieve the underlying [libbpf_sys::bpf_object].

type LibbpfType = bpf_object

The underlying libbpf type.

impl Debug for Object

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

Formats the value using the given formatter.

impl Drop for Object

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl Send for Object

impl Sync for Object