dynamic_config Test Suite

Dynamic configuration capabilities test suite.

This suite checks that it is possible to change the configuration of a port dynamically. The Poll Mode Driver should be able to enable and disable promiscuous mode on each port, as well as check the Rx and Tx packets of each port. Promiscuous mode in networking passes all traffic a NIC receives to the CPU, rather than just frames with matching MAC addresses. Each test case sends a packet with a matching address, and one with an unknown address, to ensure this behavior is shown.

If packets should be received and forwarded, or received and not forwarded, depending on the configuration, the port info should match the expected behavior.

class TestDynamicConfig

Bases: TestSuite

Dynamic config suite.

Use the show port commands to see the MAC address and promisc mode status of the Rx port on the DUT. The suite will check the Rx and Tx packets of each port after configuring promiscuous, multicast, and default mode on the DUT to verify the expected behavior. It consists of four test cases:

  1. Default mode: verify packets are received and forwarded.

  2. Disable promiscuous mode: verify that packets are received only for the packet with destination address matching the port address.

  3. Disable promiscuous mode broadcast: verify that packets with destination MAC address not matching the port are received and not forwarded, and verify that broadcast packets are received and forwarded.

  4. Disable promiscuous mode multicast: verify that packets with destination MAC address not matching the port are received and not forwarded, and verify that multicast packets are received and forwarded.

send_packet_and_verify(should_receive: bool, mac_address: str) → None

Generate, send and verify packets.

Generate a packet and send to the DUT, verify that packet is forwarded from DUT to traffic generator if that behavior is expected.

Parameters:

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

  • mac_address (str) – Destination MAC address to generate in packet.

disable_promisc_setup(testpmd: TestPmdShell, port_id: int) → TestPmdShell

Sets up testpmd shell config for cases where promisc mode is disabled.

Parameters:

  • testpmd (TestPmdShell) – Testpmd session that is being configured.

  • port_id (int) – Port number to disable promisc mode on.

Returns:

interactive testpmd shell object.

Return type:

TestPmdShell

test_default_mode() → None

Tests default configuration.

Creates a testpmd shell, verifies that promiscuous mode is enabled by default, and sends two packets; one matching source MAC address and one unknown. Verifies that both are received.

test_disable_promisc() → None

Tests disabled promiscuous mode configuration.

Creates an interactive testpmd shell, disables promiscuous mode, and sends two packets; one matching source MAC address and one unknown. Verifies that only the matching address packet is received.

test_disable_promisc_broadcast() → None

Tests broadcast reception with disabled promisc mode config.

Creates an interactive testpmd shell, disables promiscuous mode, and sends two packets; one matching source MAC address and one broadcast. Verifies that both packets are received.

test_disable_promisc_multicast() → None

Tests allmulticast mode with disabled promisc config.

Creates an interactive testpmd shell, disables promiscuous mode, and sends two packets; one matching source MAC address and one multicast. Verifies that the multicast packet is only received once allmulticast mode is enabled.