Struct NicDataPlane 

pub struct NicDataPlane {
    pub queues: Vec<RingPair>,
}

Multi-queue NIC data plane.

Initialised during NIC driver setup. Each hardware queue gets one RingPair; the consumer (strate-net) polls all RX rings in round-robin.

Fields

queues: Vec<RingPair>

One ring pair per RSS queue.

Implementations

impl NicDataPlane

pub fn new( queue_count: usize, slot_count: u32, slot_size: usize, ) -> Result<Self, &'static str>

Create a new data plane with queue_count ring pairs.

Each ring has slot_count slots of slot_size bytes. Returns an error if ring allocation fails.

pub fn push_rx(&self, queue_index: usize, data: &[u8]) -> Result<(), ()>

Push a received packet into the RX ring for queue_index.

Called from the NIC IRQ handler. Returns Err if the ring is full (backpressure : drop the packet).

pub fn pop_rx( &self, queue_index: usize, buf: &mut [u8], ) -> Result<Option<usize>, ()>

Pop a received packet from the RX ring for queue_index.

Called by strate-net. Returns Ok(None) if the ring is empty.

pub fn push_tx(&self, queue_index: usize, data: &[u8]) -> Result<(), ()>

Push an outbound packet into the TX ring for queue_index.

Called by strate-net. The NIC driver will read from the TX ring and transmit onto the wire.

pub fn pop_tx( &self, queue_index: usize, buf: &mut [u8], ) -> Result<Option<usize>, ()>

Pop an outbound packet from the TX ring for queue_index.

Called by the NIC driver. Returns Ok(None) if the ring is empty.

pub fn notify_rx_consumer(&self, queue_index: usize)

Notify the consumer (strate-net) that new RX data is available.

pub fn notify_tx_producer(&self, queue_index: usize)

Notify the NIC driver that new TX data is available.

pub fn queue_count(&self) -> usize

Number of queues (ring pairs).