Struct libbpf_rs::Link

pub struct Link { /* private fields */ }

Represents an attached Program.

This struct is used to model ownership. The underlying program will be detached when this object is dropped if nothing else is holding a reference count.

Implementations

impl Link

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

Create link from BPF FS file.

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

Takes ownership from pointer.

Safety

It is not safe to manipulate ptr after this operation.

pub fn update_prog(&mut self, prog: Program) -> Result<()>

Replace the underlying prog with prog.

pub fn disconnect(&mut self)

Release “ownership” of underlying BPF resource (typically, a BPF program attached to some BPF hook, e.g., tracepoint, kprobe, etc). Disconnected links, when destructed through bpf_link__destroy() call won’t attempt to detach/unregisted that BPF resource. This is useful in situations where, say, attached BPF program has to outlive userspace program that attached it in the system. Depending on type of BPF program, though, there might be additional steps (like pinning BPF program in BPF FS) necessary to ensure exit of userspace program doesn’t trigger automatic detachment and clean up inside the kernel.

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

Pin this link to bpffs.

pub fn unpin(&mut self) -> Result<()>

Unpin from bpffs

pub fn get_fd(&self) -> i32

👎 Deprecated since 0.17.0:

please use fd instead

Returns the file descriptor of the link.

pub fn fd(&self) -> i32

Returns the file descriptor of the link.

pub fn pin_path(&self) -> Option<PathBuf>

Returns path to BPF FS file or None if not pinned.

pub fn detach(&self) -> Result<()>

Trait Implementations

impl Drop for Link

fn drop(&mut self)

Executes the destructor for this type.