Struct libbpf_rs::OpenObject

pub struct OpenObject { /* private fields */ }

Represents an opened (but not yet loaded) BPF object file.

Use this object to access OpenMaps and OpenPrograms.

Implementations

impl OpenObject

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

Takes ownership from pointer.

Safety

Operations on the returned object are undefined if ptr is any one of: - null - points to an unopened bpf_object - points to a loaded bpf_object

It is not safe to manipulate ptr after this operation.

pub fn take_ptr(self) -> NonNull<bpf_object>

Takes underlying libbpf_sys::bpf_object pointer.

pub fn name(&self) -> Result<&str>

Retrieve the object’s name.

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

Get a reference to OpenMap with the name name, if one exists.

pub fn map_mut<T: AsRef<str>>(&mut self, name: T) -> Option<&mut OpenMap>

Get a mutable reference to OpenMap with the name name, if one exists.

pub fn maps_iter(&self) -> impl Iterator<Item = &OpenMap>

Get an iterator over references to all OpenMaps. Note that this will include automatically generated .data, .rodata, .bss, and .kconfig maps.

pub fn maps_iter_mut(&mut self) -> impl Iterator<Item = &mut OpenMap>

Get an iterator over mutable references to all OpenMaps. Note that this will include automatically generated .data, .rodata, .bss, and .kconfig maps.

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

Get a reference to OpenProgram with the name name, if one exists.

pub fn prog_mut<T: AsRef<str>>(&mut self, name: T) -> Option<&mut OpenProgram>

Get a mutable reference to OpenProgram with the name name, if one exists.

pub fn progs_iter(&self) -> impl Iterator<Item = &OpenProgram>

Get an iterator over references to all OpenPrograms.

pub fn progs_iter_mut(&mut self) -> impl Iterator<Item = &mut OpenProgram>

Get an iterator over mutable references to all OpenPrograms.

pub fn load(self) -> Result<Object>

Load the maps and programs contained in this BPF object into the system.

Trait Implementations

impl Debug for OpenObject

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

Formats the value using the given formatter.

impl Drop for OpenObject

fn drop(&mut self)

Executes the destructor for this type.