queue_start_stop Test Suite

Rx/Tx queue start and stop functionality suite.

This suite tests the ability of the poll mode driver to start and stop either the Rx or Tx queue (depending on the port) during runtime, and verify that packets are not received when one is disabled.

Given a paired port topology, the Rx queue will be disabled on port 0, and the Tx queue will be disabled on port 1.

class TestQueueStartStop

Bases: TestSuite

DPDK Queue start/stop test suite.

Ensures Rx/Tx queue on a port can be disabled and enabled. Verifies packets are not received when either queue is disabled. The suite contains four test cases, two Rx queue start/stop and two Tx queue start/stop, which each disable the corresponding queue and verify that packets are not received/forwarded. There are two cases that verify deferred start mode produces the expected behavior in both the Rx and Tx queue.

send_packet_and_verify(should_receive: bool = True) → None

Generate a packet, send to the DUT, and verify it is forwarded back.

Parameters:

should_receive (bool) – Indicate whether the packet should be received.

test_rx_queue_start_stop() → None

Rx queue start stop test.

Steps:

Launch testpmd, stop Rx queue 0 on port 0. Stop testpmd, start Rx queue 0 on port 0, start testpmd.

Verify:

Send a packet on port 0 after Rx queue is stopped, ensure it is not received. Send a packet on port 0 after Rx queue is started, ensure it is received.

test_tx_queue_start_stop() → None

Tx queue start stop test.

Steps:

Launch testpmd, stop Tx queue 0 on port 0. Stop testpmd, start Tx queue 0 on port 0, start testpmd.

Verify:

Send a packet on port 0 after Tx queue is stopped, ensure it is not received. Send a packet on port 0 after Tx queue is started, ensure it is received.

test_rx_queue_deferred_start() → None

Rx queue deferred start stop test.

Steps:

Stop all ports, enable deferred start mode on port 0 Rx queue 0, start all ports. Launch testpmd, send a packet. Stop testpmd, start port 0 Rx queue 0. Start testpmd, send a packet.

Verify:

Send a packet on port 0 after deferred start is set, ensure it is not received. Send a packet on port 0 after Rx queue 0 is started, ensure it is received.

test_tx_queue_deferred_start() → None

Tx queue start stop test.

Steps:

Stop all ports, enable deferred start mode on port 1 Tx queue 0, start all ports. Launch testpmd, send a packet. Stop testpmd, start port 1 Tx queue 0. Start testpmd, send a packet.

Verify:

Send a packet on port 1 after deferred start is set, ensure it is not received. Send a packet on port 1 after Tx queue 0 is started, ensure it is received.

required_capabilities: ClassVar[set[Capability]] = {NicCapability.RUNTIME_RX_QUEUE_SETUP}

The capabilities the test case or suite requires in order to be executed.