checksum_offload Test Suite

DPDK checksum offload testing suite.

This suite verifies L3/L4 checksum offload features of the Poll Mode Driver. On the Rx side, IPv4 and UDP/TCP checksum by hardware is checked to ensure checksum flags match expected flags. On the Tx side, IPv4/UDP, IPv4/TCP, IPv6/UDP, and IPv6/TCP insertion by hardware is checked to checksum flags match expected flags.

class TestChecksumOffload

Bases: TestSuite

Checksum offload test suite.

This suite consists of 6 test cases: 1. Insert checksum on transmit packet 2. Do not insert checksum on transmit packet 3. Hardware checksum check L4 Rx 4. Hardware checksum check L3 Rx 5. Validate Rx checksum valid flags 6. Checksum offload with VLAN 7. Checksum offload with SCTP

send_packets_and_verify(packet_list: List[scapy.packet.Packet], load: bytes, should_receive: bool) → None

Iterates through a list of packets and verifies they are received.

Parameters:

  • packet_list (List[scapy.packet.Packet]) – List of Scapy packets to send and verify.

  • load (bytes) – Raw layer load attribute in the sent packet.

  • should_receive (bool) – Indicates whether the packet should be received by the traffic generator.

send_packet_and_verify_checksum(packet: scapy.packet.Packet, good_L4: bool, good_IP: bool, testpmd: TestPmdShell, id: str) → None

Send packet and verify verbose output matches expected output.

Parameters:

  • packet (scapy.packet.Packet) – Scapy packet to send to DUT.

  • good_L4 (bool) – Verifies RTE_MBUF_F_RX_L4_CKSUM_GOOD in verbose output if True, or RTE_MBUF_F_RX_L4_CKSUM_UNKNOWN if False.

  • good_IP (bool) – Verifies RTE_MBUF_F_RX_IP_CKSUM_GOOD in verbose output if True, or RTE_MBUF_F_RX_IP_CKSUM_UNKNOWN if False.

  • testpmd (TestPmdShell) – Testpmd shell session to analyze verbose output of.

  • id (str) – The destination mac address that matches the sent packet in verbose output.

setup_hw_offload(testpmd: TestPmdShell) → None

Sets IP, UDP, and TCP layers to hardware offload.

Parameters:

testpmd (TestPmdShell) – Testpmd shell to configure.

test_insert_checksums() → None

Enable checksum offload insertion and verify packet reception.

Steps:

Create a list of packets to send. Launch testpmd with the necessary configuration. Enable checksum hardware offload. Send list of packets.

Verify:

Verify packets are received. Verify packet checksums match the expected flags.

test_no_insert_checksums() → None

Disable checksum offload insertion and verify packet reception.

Steps:

Create a list of packets to send. Launch testpmd with the necessary configuration. Send list of packets.

Verify:

Verify packets are received. Verify packet checksums match the expected flags.

test_l4_rx_checksum() → None

Tests L4 Rx checksum in a variety of scenarios.

Steps:

Create a list of packets to send with UDP/TCP fields. Launch testpmd with the necessary configuration. Enable checksum hardware offload. Send list of packets.

Verify:

Verify packet checksums match the expected flags.

test_l3_rx_checksum() → None

Tests L3 Rx checksum hardware offload.

Steps:

Create a list of packets to send with IP fields. Launch testpmd with the necessary configuration. Enable checksum hardware offload. Send list of packets.

Verify:

Verify packet checksums match the expected flags.

test_validate_rx_checksum() → None

Verify verbose output of Rx packets matches expected behavior.

Steps:

Create a list of packets to send. Launch testpmd with the necessary configuration. Enable checksum hardware offload. Send list of packets.

Verify:

Verify packet checksums match the expected flags.

test_vlan_checksum() → None

Test VLAN Rx checksum hardware offload and verify packet reception.

Steps:

Create a list of packets to send with VLAN fields. Launch testpmd with the necessary configuration. Enable checksum hardware offload. Send list of packets.

Verify:

Verify packet checksums match the expected flags.

test_validate_sctp_checksum() → None

Test SCTP Rx checksum hardware offload and verify packet reception.

Steps:

Create a list of packets to send with SCTP fields. Launch testpmd with the necessary configuration. Enable checksum hardware offload. Send list of packets.

Verify:

Verify packet checksums match the expected flags.

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

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