Struct ProgramHandle 

pub struct ProgramHandle { /* private fields */ }

An owned handle to a loaded BPF program.

Similar to MapHandle for maps: owns the file descriptor and caches metadata, so it can outlive the Object it came from.

Implementations

impl ProgramHandle

pub fn from_prog_id(id: u32) -> Result<Self>

Open a loaded program by its kernel ID.

pub fn from_pinned_path<P: AsRef<Path>>(path: P) -> Result<Self>

Open a previously pinned program from its bpffs path.

pub fn name(&self) -> &OsStr

The program’s name.

pub fn prog_type(&self) -> ProgramType

The ProgramType of this handle.

pub fn tag(&self) -> [u8; 8]

The 8-byte tag (instruction hash) of the program.

pub fn id(&self) -> u32

The kernel ID of this program.

pub fn pin<P: AsRef<Path>>(&self, path: P) -> Result<()>

Pin this program to bpffs.

pub fn unpin<P: AsRef<Path>>(&self, path: P) -> Result<()>

Unpin this program from bpffs.

Trait Implementations

impl AsFd for ProgramHandle

fn as_fd(&self) -> BorrowedFd<'_>

Borrows the file descriptor.

impl Debug for ProgramHandle

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

Formats the value using the given formatter.

impl TryFrom<&ProgramHandle> for ProgramHandle

type Error = Error

The type returned in the event of a conversion error.

fn try_from(other: &Self) -> Result<Self>

Performs the conversion.

impl<'obj, T> TryFrom<&ProgramImpl<'obj, T>> for ProgramHandle

where ProgramImpl<'obj, T>: Deref<Target = Program<'obj>>,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(prog: &ProgramImpl<'obj, T>) -> Result<Self>

Performs the conversion.