Struct XdpConfig 

pub struct XdpConfig {
    pub enabled: bool,
    pub bpf_object_path: PathBuf,
    pub interface: String,
    pub port: u16,
    pub attach_mode: XdpAttachMode,
    pub cpu_queue_size: u32,
    pub collect_stats: bool,
    pub fallback_on_error: bool,
}

Configuration for XDP network optimization.

Fields

enabled: bool

Enable XDP (requires root or CAP_NET_ADMIN).

bpf_object_path: PathBuf

Path to compiled BPF object file.

interface: String

Network interface to attach to (e.g., “eth0”).

port: u16

UDP port for filtering.

attach_mode: XdpAttachMode

XDP attach mode.

cpu_queue_size: u32

Queue size per CPU for XDP redirect.

collect_stats: bool

Enable XDP statistics collection.

fallback_on_error: bool

Fallback gracefully if XDP unavailable.

Implementations

impl XdpConfig

pub fn builder() -> XdpConfigBuilder

Creates a new configuration builder.

pub fn auto() -> Self

Create configuration with automatic detection.

Detects system capabilities and generates an optimal configuration:

• Enables XDP only on Linux 4.8+ with the xdp feature
• Prefers native mode on Linux 5.3+, falls back to generic mode
• Sizes CPU queues based on available memory

Note

XDP requires additional setup (BPF object file, CAP_NET_ADMIN capability) that cannot be auto-detected. This method sets enabled: false by default; call .enabled(true) on the builder to enable XDP after ensuring prerequisites are met.

Example

use laminar_core::xdp::XdpConfig;

let config = XdpConfig::auto();
println!("XDP available: {}", config.xdp_available());

pub fn xdp_available() -> bool

Check if XDP is available on this system.

Returns true if the kernel supports XDP and the feature is enabled.

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

Validates the configuration.

Errors

Returns an error if the configuration is invalid.

Trait Implementations

impl Clone for XdpConfig

fn clone(&self) -> XdpConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for XdpConfig

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

Formats the value using the given formatter.

impl Default for XdpConfig

fn default() -> Self

Returns the “default value” for a type.