uni_pkt Test Suite

Unified packet type flag testing suite.

According to DPDK documentation, each Poll Mode Driver should reserve 32 bits of packet headers for unified packet type flags. These flags serve as an identifier for user applications, and are divided into subcategories: L2, L3, L4, tunnel, inner L2, inner L3, and inner L4 types. This suite verifies the ability of the driver to recognize these types.

class TestUniPkt

Bases: TestSuite

DPDK Unified packet test suite.

This testing suite uses testpmd’s verbose output hardware/software packet type field to verify the ability of the driver to recognize unified packet types when receiving different packets.

check_for_matching_packet(output: list[framework.remote_session.testpmd_shell.TestPmdVerbosePacket], flags: RtePTypes) → bool

Returns True if the packet in verbose output contains all specified flags.

send_packet_and_verify_flags(expected_flag: RtePTypes, packet: scapy.packet.Packet, testpmd: TestPmdShell) → None

Sends a packet to the DUT and verifies the verbose ptype flags.

setup_session(testpmd: TestPmdShell, expected_flags: list[framework.remote_session.testpmd_shell.RtePTypes], packet_list=list[scapy.packet.Packet]) → None

Sets the forwarding and verbose mode of each test case interactive shell session.

test_l2_packet_detect() → None

Ensure the correct flags are shown in verbose output when sending L2 packets.

Steps:

Create a list of packets to test, with a corresponding flag list to check against. Launch testpmd with the necessary configuration. Send each packet in the list, capture testpmd verbose output.

Verify:

Check that each packet has a destination MAC address matching the set ID. Check the packet type fields in verbose output, verify the flags match.

test_l3_l4_packet_detect() → None

Ensure correct flags are shown in the verbose output when sending IP/L4 packets.

Steps:

Create a list of packets to test, with a corresponding flag list to check against. Launch testpmd with the necessary configuration. Send each packet in the list, capture testpmd verbose output.

Verify:

Check that each packet has a destination MAC address matching the set ID. Check the packet type fields in verbose output, verify the flags match.

test_ipv6_l4_packet_detect() → None

Ensure correct flags are shown in the verbose output when sending IPv6/L4 packets.

Steps:

Create a list of packets to test, with a corresponding flag list to check against. Launch testpmd with the necessary configuration. Send each packet in the list, capture testpmd verbose output.

Verify:

Check that each packet has a destination MAC address matching the set ID. Check the packet type fields in verbose output, verify the flags match.

test_l3_tunnel_packet_detect() → None

Ensure correct flags are shown in the verbose output when sending IPv6/L4 packets.

Steps:

Create a list of packets to test, with a corresponding flag list to check against. Launch testpmd with the necessary configuration. Send each packet in the list, capture testpmd verbose output.

Verify:

Check that each packet has a destination MAC address matching the set ID. Check the packet type fields in verbose output, verify the flags match.

test_gre_tunnel_packet_detect() → None

Ensure the correct flags are shown in the verbose output when sending GRE packets.

Steps:

Create a list of packets to test, with a corresponding flag list to check against. Launch testpmd with the necessary configuration. Send each packet in the list, capture testpmd verbose output.

Verify:

Check that each packet has a destination MAC address matching the set ID. Check the packet type fields in verbose output, verify the flags match.

test_nsh_packet_detect() → None

Verify the correct flags are shown in the verbose output when sending NSH packets.

Steps:

Create a list of packets to test, with a corresponding flag list to check against. Launch testpmd with the necessary configuration. Send each packet in the list, capture testpmd verbose output.

Verify:

Check that each packet has a destination MAC address matching the set ID. Check the packet type fields in verbose output, verify the flags match.

test_vxlan_tunnel_packet_detect() → None

Ensure the correct flags are shown in the verbose output when sending VXLAN packets.

Steps:

Create a list of packets to test, with a corresponding flag list to check against. Add a UDP port for VXLAN packet filter within testpmd. Launch testpmd with the necessary configuration. Send each packet in the list, capture testpmd verbose output.

Verify:

Check that each packet has a destination MAC address matching the set ID. Check the packet type fields in verbose output, verify the flags match.