Struct 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>>(path: P) -> Result<Self>

Create link from BPF FS file.

pub unsafe fn from_ptr(ptr: NonNull<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/unregistered 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 pin_path(&self) -> Option<PathBuf>

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

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

Detach the link.

Trait Implementations

impl AsFd for Link

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

Borrows the file descriptor.

impl AsRawLibbpf for Link

fn as_libbpf_object(&self) -> NonNull<Self::LibbpfType>

Retrieve the underlying libbpf_sys::bpf_link.

type LibbpfType = bpf_link

The underlying libbpf type.

impl Debug for Link

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

Formats the value using the given formatter.

impl Drop for Link

fn drop(&mut self)

Executes the destructor for this type.

impl Send for Link