Struct XdpLoader 

pub struct XdpLoader { /* private fields */ }

XDP program loader for Linux.

Loads and attaches XDP programs to network interfaces for packet filtering and CPU steering.

Example

use laminar_core::xdp::{XdpConfig, XdpLoader};

let config = XdpConfig::builder()
    .enabled(true)
    .interface("eth0")
    .port(9999)
    .build()?;

let loader = XdpLoader::load_and_attach(&config, 4)?;
println!("XDP active: {}", loader.is_active());

// Get statistics
let stats = loader.stats();
println!("Redirected: {}", stats.redirected);

Implementations

impl XdpLoader

pub fn load_and_attach( config: &XdpConfig, num_cores: usize, ) -> Result<Self, XdpError>

Loads and attaches XDP program to network interface.

Arguments

• config - XDP configuration
• num_cores - Number of cores for CPU map

Errors

Returns an error if:

• XDP program file not found
• Permission denied (requires CAP_NET_ADMIN or root)
• Network interface not found
• BPF program loading fails

pub fn is_active(&self) -> bool

Returns true if XDP is actually active.

pub fn stats(&self) -> XdpStats

Returns XDP statistics.

pub fn update_cpu_steering( &self, partition: u32, cpu: u32, ) -> Result<(), XdpError>

Updates CPU steering for a partition.

This allows runtime reconfiguration of which CPU handles packets for a given partition.

Errors

Returns XdpError::InvalidConfig if the CPU index is out of range.

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

Detaches the XDP program from the interface.

Errors

Currently infallible, but may return errors in future implementations when actual XDP detachment is performed.

pub fn interface(&self) -> &str

Returns the interface name.

pub fn ifindex(&self) -> u32

Returns the interface index.

pub fn num_cores(&self) -> usize

Returns the number of cores configured.

pub fn attach_mode(&self) -> XdpAttachMode

Returns the attach mode.

pub fn record_packet(&self, was_valid: bool, bytes: u64)

Records a packet being processed (for tracking without XDP).

Trait Implementations

impl Debug for XdpLoader

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

Formats the value using the given formatter.

impl Drop for XdpLoader

fn drop(&mut self)

Executes the destructor for this type.