Struct Port 

pub struct Port { /* private fields */ }

A DPDK Ethernet port

Implementations

impl Port

pub fn count_available() -> u16

Get the number of available DPDK ports

pub fn is_valid(port_id: u16) -> bool

Check if a port ID is valid

pub fn init( port_id: u16, config: PortConfig, mempool: &Mempool, ) -> DpdkResult<Self>

Initialize a port with the given configuration

This will:

1. Validate the port ID
2. Get device info to check capabilities
3. Configure the port
4. Set up RX and TX queues

pub fn new(port_id: u16) -> DpdkResult<Self>

Create a port handle without full initialization (for testing)

pub fn capabilities(&self) -> &DeviceCapabilities

Get the device capabilities

pub fn numa_node(&self) -> i32

Get the NUMA node of this NIC port.

Returns the NUMA socket ID where the NIC is attached. Use this to allocate mempools and pin lcores on the same NUMA node for optimal memory access latency.

pub fn active_rx_offload(&self) -> u64

Get the active RX offload flags

pub fn active_tx_offload(&self) -> u64

Get the active TX offload flags

pub fn is_rx_offload_active(&self, offload: u64) -> bool

Check if a specific RX offload is active

pub fn is_tx_offload_active(&self, offload: u64) -> bool

Check if a specific TX offload is active

pub fn port_id(&self) -> u16

Get the port ID

pub fn mac_address(&self) -> MacAddress

Get the MAC address of this port

pub fn config(&self) -> &PortConfig

Get the port configuration

pub fn is_started(&self) -> bool

Check if the port is started

pub fn start(&mut self) -> DpdkResult<()>

Start the port

pub fn stop(&mut self) -> DpdkResult<()>

Stop the port

pub fn link_status(&self) -> LinkStatus

Get link status

pub fn stats(&self) -> DpdkResult<PortStats>

Get port statistics

pub fn reset_stats(&self) -> DpdkResult<()>

Reset port statistics

pub fn rx_burst(&self, queue_id: u16, max_packets: u16) -> DpdkResult<Vec<Mbuf>>

Receive a burst of packets from the specified queue

Returns a vector of received Mbufs. The maximum number of packets returned is limited by max_packets.

pub fn tx_burst( &self, queue_id: u16, packets: &mut Vec<Mbuf>, ) -> DpdkResult<u16>

Transmit a burst of packets on the specified queue

Returns the number of packets successfully transmitted. Packets that are sent are consumed (freed) by the driver.

pub fn set_promiscuous(&mut self, enable: bool) -> DpdkResult<()>

Enable promiscuous mode on the port

In promiscuous mode, the port receives all packets regardless of destination MAC address.

pub fn is_promiscuous(&self) -> bool

Check if promiscuous mode is enabled

pub fn set_allmulticast(&self, enable: bool) -> DpdkResult<()>

Enable all-multicast mode on the port

In all-multicast mode, the port receives all multicast packets regardless of whether they match configured multicast addresses.

pub fn is_allmulticast(&self) -> bool

Check if all-multicast mode is enabled

pub fn set_multicast_addrs(&self, addrs: &[MacAddress]) -> DpdkResult<()>

Set the list of multicast MAC addresses to receive

This configures the hardware multicast filter. Pass an empty slice to clear all multicast addresses.

Trait Implementations

impl Drop for Port

fn drop(&mut self)

Executes the destructor for this type.