Struct InterfaceInfo 

pub struct InterfaceInfo {
    pub name: String,
    pub index: u32,
    pub mtu: u32,
    pub speed: u32,
    pub driver: String,
    pub num_queues: u32,
    pub carrier: bool,
    pub flags: u32,
}

Information about a network interface.

Useful for choosing ring buffer sizes, frame sizes, and fanout thread count.

Examples

use netring::InterfaceInfo;

let info = netring::interface_info("lo").unwrap();
println!("MTU: {}, speed: {} Mbps, queues: {}", info.mtu, info.speed, info.num_queues);
println!("Suggested profile: {:?}", info.suggest_profile());

Fields

name: String

Interface name.

index: u32

Interface index.

mtu: u32

Maximum Transmission Unit in bytes (e.g., 1500, 9000 for jumbo).

speed: u32

Link speed in Mbps (0 if unknown, e.g., loopback).

driver: String

Driver name (e.g., “e1000e”, “mlx5_core”). Empty if unknown.

num_queues: u32

Number of RX queues (for fanout thread count).

carrier: bool

Whether the interface link is up.

flags: u32

Interface flags (IFF_UP, IFF_RUNNING, etc.).

Implementations

impl InterfaceInfo

pub fn suggest_profile(&self) -> RingProfile

Suggest a ring profile based on interface capabilities.

Uses MTU and link speed to pick the best default:

• Jumbo MTU (> 1500) → RingProfile::JumboFrames
• 10 Gbps+ → RingProfile::HighThroughput
• 1 Gbps+ → RingProfile::Default
• Slower → RingProfile::LowMemory

pub fn suggest_fanout_threads(&self) -> usize

Suggest the number of fanout threads.

Returns the number of RX queues, capped at available CPUs.

Trait Implementations

impl Clone for InterfaceInfo

fn clone(&self) -> InterfaceInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InterfaceInfo

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

Formats the value using the given formatter.