Test suite for verifying vxlan gpe support on NIC, as well as expected
behavior while sending vxlan packets through tunnel
Signed-off-by: Dean Marx <dm...@iol.unh.edu>
---
dts/tests/TestSuite_vxlan_gpe_support.py | 77 ++++++++++++++++++++++++
1 file changed, 77 insertions(+)
create mode 100644 dts/tests/TestSuite_vxlan_gpe_support.py
diff --git a/dts/tests/TestSuite_vxlan_gpe_support.py
b/dts/tests/TestSuite_vxlan_gpe_support.py
new file mode 100644
index 0000000000..981f878a4c
--- /dev/null
+++ b/dts/tests/TestSuite_vxlan_gpe_support.py
@@ -0,0 +1,77 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright(c) 2024 University of New Hampshire
+
+"""VXLAN-GPE support test suite.
+
+This suite verifies virtual extensible local area network packets
+are only received in the same state when a UDP tunnel port for VXLAN tunneling
+protocols is enabled. GPE is the Generic Protocol Extension for VXLAN,
+which is used for configuring fields in the VXLAN header through GPE tunnels.
+
+If a GPE tunnel is configured for the corresponding UDP port within a sent
packet,
+that packet should be received with its VXLAN layer. If there is no GPE tunnel,
+the packet should be received without its VXLAN layer.
+
+"""
+
+from scapy.layers.inet import IP, UDP # type: ignore[import-untyped]
+from scapy.layers.l2 import Ether # type: ignore[import-untyped]
+from scapy.layers.vxlan import VXLAN # type: ignore[import-untyped]
+from scapy.packet import Raw # type: ignore[import-untyped]
+
+from framework.params.testpmd import SimpleForwardingModes
+from framework.remote_session.testpmd_shell import TestPmdShell
+from framework.test_suite import TestSuite
+
+
+class TestVxlanGpeSupport(TestSuite):
+ """DPDK VXLAN-GPE test suite.
+
+ This suite consists of one test case (Port 4790 is designated for
VXLAN-GPE streams):
+ 1. VXLAN-GPE ipv4 packet detect - configures a GPE tunnel on port 4790
+ and sends packets with a matching UDP destination port. This packet
+ should be received by the traffic generator with its VXLAN layer.
+ Then, remove the GPE tunnel, send the same packet, and verify that
+ the packet is received without its VXLAN layer.
+ """
+
+ def set_up_suite(self) -> None:
+ """Set up the test suite.
+
+ Setup:
+ Verify that we have at least 2 port links in the current test run.
+ """
+ self.verify(
+ len(self._port_links) > 1,
+ "There must be at least two port links to run the scatter test
suite",
+ )
+
+ def send_vxlan_packet_and_verify(self, udp_dport: int,
should_receive_vxlan: bool) -> None:
+ """Generate a VXLAN GPE packet with the given UDP destination port,
send and verify.
+
+ Args:
+ udp_dport: The destination UDP port to generate in the packet.
+ should_receive_vxlan: Indicates whether the packet should be
+ received by the traffic generator with its VXLAN layer.
+ """
+ packet = Ether() / IP() / UDP(dport=udp_dport) / VXLAN(flags=12) /
IP() / Raw(load="xxxxx")
+ received = self.send_packet_and_capture(packet)
+ print(f"Received packets = {received}")
+ has_vxlan = any(
+ "VXLAN" in packet.summary() and "xxxxx" in str(packet.load) for
packet in received
+ )
+ self.verify(
+ not (has_vxlan ^ should_receive_vxlan), "Expected packet did not
match received packet."
+ )
+
+ def test_gpe_tunneling(self) -> None:
+ """Verifies expected behavior of VXLAN packets through a GPE tunnel."""
+ GPE_port = 4790
+ with TestPmdShell(node=self.sut_node) as testpmd:
+ testpmd.set_forward_mode(SimpleForwardingModes.io)
+ testpmd.set_verbose(level=1)
+ testpmd.start()
+ testpmd.udp_tunnel_port(port_id=0, add=True, udp_port=GPE_port,
protocol="vxlan")
+ self.send_vxlan_packet_and_verify(udp_dport=GPE_port,
should_receive_vxlan=True)
+ testpmd.udp_tunnel_port(port_id=0, add=False, udp_port=GPE_port,
protocol="vxlan")
+ self.send_vxlan_packet_and_verify(udp_dport=GPE_port,
should_receive_vxlan=False)
--
2.44.0
