From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
by inbox.dpdk.org (Postfix) with ESMTP id 0B20845834;
Wed, 21 Aug 2024 18:25:45 +0200 (CEST)
Received: from mails.dpdk.org (localhost [127.0.0.1])
by mails.dpdk.org (Postfix) with ESMTP id 6CF9A427AB;
Wed, 21 Aug 2024 18:25:36 +0200 (CEST)
Received: from mail-qv1-f46.google.com (mail-qv1-f46.google.com
[209.85.219.46]) by mails.dpdk.org (Postfix) with ESMTP id E20494279C
for <dev@dpdk.org>; Wed, 21 Aug 2024 18:25:34 +0200 (CEST)
Received: by mail-qv1-f46.google.com with SMTP id
6a1803df08f44-6bf775d1bdfso35249896d6.1
for <dev@dpdk.org>; Wed, 21 Aug 2024 09:25:34 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=iol.unh.edu; s=unh-iol; t=1724257534; x=1724862334; darn=dpdk.org;
h=content-transfer-encoding:mime-version:references:in-reply-to
:message-id:date:subject:cc:to:from:from:to:cc:subject:date
:message-id:reply-to;
bh=GtkDDZ5qBNfoipmS86CT+bN7UETH66Gau8pJ32OGAHw=;
b=Cxv9Nshyi6e/ejDOiGKl48MPXLzEw+B68L3AcKfI3m4yxwtRQikVkfKMjHksQQ8RM9
uyJA5MFlikJYq4R09kdwO1wkBg+rpEz8UXjSy5C6mfqElDBRun12vj+c0Mujn8GUTo6r
KSGvurPb8AL9JfmYz4oTcHcZHRbNDmpuukqig=
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20230601; t=1724257534; x=1724862334;
h=content-transfer-encoding:mime-version:references:in-reply-to
:message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc
:subject:date:message-id:reply-to;
bh=GtkDDZ5qBNfoipmS86CT+bN7UETH66Gau8pJ32OGAHw=;
b=KU/ruV2VExj5jKknyq0TFAHlFYvfp0F6wyKkl6ko35ktmm6qX+cdw1n+lrLpPTVCxv
M09KjjwHFU1TT3v/3OR/ykEvkrBXgAlJgswg1v6KJLSDOwNNHG7uu+88LICaPfMsTkb8
fkDSePwaLFnvKrqP1xvU59CHSIr3jzJypKaK1Enn+7M8g3ykDt+sRM980uc7A2THSPKo
zL7lpbL03DFsjMMJgnYQCjOTl9m/Wm+A9eOLv/pOMGEyWIciKwyLwKHYYk1lQhq9GKjr
PxXWBtoWPlsXdxZtlf5XK1xQ7YJmOLP0bPq0GghfK2OY4om0F3Nsr7p/kqweBKnQOBS1
Rk5Q==
X-Gm-Message-State: AOJu0YzwM8Ooke4BS20kU6FmwG5hI3g/gjA83WJuP8TsrR5faQYysCY0
BrZDCUBS1s9MEonST5PtHuMNNQEmAkAi4Ecp4iNOsS6bOpBkPyi8YPls7yIj6ko=
X-Google-Smtp-Source: AGHT+IHnKRqaK4TzedhsnNQPcCyrRnJfHJKWuTWcOWuhL5hml4FAepeiPCJvUsUGISHXTJlOWRin1w==
X-Received: by 2002:a05:6214:3984:b0:6bb:bd1c:f55f with SMTP id
6a1803df08f44-6c155d6f280mr32633536d6.13.1724257534026;
Wed, 21 Aug 2024 09:25:34 -0700 (PDT)
Received: from dean-laptop.iol.unh.edu
([2606:4100:3880:1271:f9bd:24da:464d:6294])
by smtp.gmail.com with ESMTPSA id
6a1803df08f44-6bf6fef223csm63014796d6.122.2024.08.21.09.25.33
(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
Wed, 21 Aug 2024 09:25:33 -0700 (PDT)
From: Dean Marx <dmarx@iol.unh.edu>
To: probb@iol.unh.edu, npratte@iol.unh.edu, jspewock@iol.unh.edu,
luca.vizzarro@arm.com, yoan.picchi@foss.arm.com,
Honnappa.Nagarahalli@arm.com, paul.szczepanek@arm.com,
juraj.linkes@pantheon.tech
Cc: dev@dpdk.org,
Dean Marx <dmarx@iol.unh.edu>
Subject: [PATCH v2 2/2] dts: checksum offload test suite
Date: Wed, 21 Aug 2024 12:25:50 -0400
Message-ID: <20240821162550.1163-3-dmarx@iol.unh.edu>
X-Mailer: git-send-email 2.44.0
In-Reply-To: <20240821162550.1163-1-dmarx@iol.unh.edu>
References: <20240816142031.15150-1-dmarx@iol.unh.edu>
<20240821162550.1163-1-dmarx@iol.unh.edu>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
<mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
<mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
test suite for verifying layer 3/4 checksum offload
features on poll mode driver.
Depends-on: patch-143033
("dts: add text parser for testpmd verbose output")
Depends-on: patch-142691
("dts: add send_packets to test suites and rework packet addressing")
Signed-off-by: Dean Marx <dmarx@iol.unh.edu>
---
dts/framework/config/conf_yaml_schema.json | 3 +-
dts/tests/TestSuite_checksum_offload.py | 264 +++++++++++++++++++++
2 files changed, 266 insertions(+), 1 deletion(-)
create mode 100644 dts/tests/TestSuite_checksum_offload.py
diff --git a/dts/framework/config/conf_yaml_schema.json b/dts/framework/config/conf_yaml_schema.json
index f02a310bb5..a83a6786df 100644
--- a/dts/framework/config/conf_yaml_schema.json
+++ b/dts/framework/config/conf_yaml_schema.json
@@ -187,7 +187,8 @@
"enum": [
"hello_world",
"os_udp",
- "pmd_buffer_scatter"
+ "pmd_buffer_scatter",
+ "checksum_offload"
]
},
"test_target": {
diff --git a/dts/tests/TestSuite_checksum_offload.py b/dts/tests/TestSuite_checksum_offload.py
new file mode 100644
index 0000000000..406c9077dc
--- /dev/null
+++ b/dts/tests/TestSuite_checksum_offload.py
@@ -0,0 +1,264 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright(c) 2024 University of New Hampshire
+
+"""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.
+
+"""
+
+from typing import List
+
+from scapy.all import Packet # type: ignore[import-untyped]
+from scapy.layers.inet import IP, TCP, UDP # type: ignore[import-untyped]
+from scapy.layers.inet6 import IPv6 # type: ignore[import-untyped]
+from scapy.layers.sctp import SCTP # type: ignore[import-untyped]
+from scapy.layers.l2 import Dot1Q # type: ignore[import-untyped]
+from scapy.layers.l2 import Ether
+from scapy.packet import Raw # type: ignore[import-untyped]
+
+from framework.remote_session.testpmd_shell import (
+ SimpleForwardingModes,
+ TestPmdShell,
+ OLFlag,
+ ChecksumOffloadOptions
+)
+from framework.test_suite import TestSuite
+
+
+class TestChecksumOffload(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. Validate Rx checksum valid flags
+ 4. Hardware checksum check L4 Rx
+ 5. Hardware checksum check L3 Rx
+ 6. Checksum offload with vlan
+
+ """
+
+ def set_up_suite(self) -> None:
+ """Set up the test suite.
+
+ Setup:
+ Verify that at least two port links are created when the
+ test run is initialized.
+ """
+ self.verify(len(self._port_links) > 1, "Not enough port links.")
+
+ def send_packets_and_verify(
+ self, packet_list: List[Packet], load: str, should_receive: bool
+ ) -> None:
+ """Send and verify packet is received on the traffic generator.
+
+ Args:
+ packet_list: list of Scapy packets to send and verify.
+ load: Raw layer load attribute in the sent packet.
+ should_receive: Indicates whether the packet should be received
+ by the traffic generator.
+ """
+ for i in range(0, len(packet_list)):
+ received_packets = self.send_packet_and_capture(packet=packet_list[i])
+ received = any(
+ packet.haslayer(Raw) and load in str(packet.load) for packet in received_packets
+ )
+ self.verify(
+ received == should_receive,
+ f"Packet was {'dropped' if should_receive else 'received'}",
+ )
+
+ def send_packet_and_verify_checksum(
+ self, packet: Packet, goodL4: bool, goodIP: bool, testpmd: TestPmdShell
+ ) -> None:
+ """Send packet and verify verbose output matches expected output.
+
+ Args:
+ packet: Scapy packet to send to DUT.
+ goodL4: Verifies RTE_MBUF_F_RX_L4_CKSUM_GOOD in verbose output
+ if :data:`True`, or RTE_MBUF_F_RX_L4_CKSUM_UNKNOWN if :data:`False`.
+ goodIP: Verifies RTE_MBUF_F_RX_IP_CKSUM_GOOD in verbose output
+ if :data:`True`, or RTE_MBUF_F_RX_IP_CKSUM_UNKNOWN if :data:`False`.
+ testpmd: Testpmd shell session to analyze verbose output of.
+ """
+ testpmd.start()
+ self.send_packet_and_capture(packet=packet)
+ verbose_output = testpmd.extract_verbose_output(testpmd.stop())
+ for packet in verbose_output:
+ if packet.dst_mac == "00:00:00:00:00:01":
+ if OLFlag.RTE_MBUF_F_RX_L4_CKSUM_GOOD in packet.ol_flags:
+ isIP = True
+ else:
+ isIP = False
+ if OLFlag.RTE_MBUF_F_RX_L4_CKSUM_GOOD in packet.ol_flags:
+ isL4 = True
+ else:
+ isL4 = False
+ else:
+ isIP = False
+ isL4 = False
+ self.verify(isL4 == goodL4, "Layer 4 checksum flag did not match expected checksum flag.")
+ self.verify(isIP == goodIP, "IP checksum flag did not match expected checksum flag.")
+
+ def setup_hw_offload(self, testpmd: TestPmdShell) -> None:
+ """Sets IP, UDP, TCP, and SCTP layers to hardware offload."""
+ testpmd.port_stop(port=0)
+ testpmd.csum_set_hw(layer=ChecksumOffloadOptions.ip, port_id=0)
+ testpmd.csum_set_hw(layer=ChecksumOffloadOptions.udp, port_id=0)
+ testpmd.csum_set_hw(layer=ChecksumOffloadOptions.tcp, port_id=0)
+ testpmd.csum_set_hw(layer=ChecksumOffloadOptions.sctp, port_id=0)
+ testpmd.port_start(port=0)
+
+ def test_insert_checksums(self) -> None:
+ """Enable checksum offload insertion and verify packet reception."""
+ payload = "xxxxx"
+ mac_id = "00:00:00:00:00:01"
+ packet_list = [
+ Ether(dst=mac_id) / IP() / UDP() / Raw(payload),
+ Ether(dst=mac_id) / IP() / TCP() / Raw(payload),
+ Ether(dst=mac_id) / IP() / SCTP() / Raw(payload),
+ Ether(dst=mac_id) / IPv6(src="::1") / UDP() / Raw(payload),
+ Ether(dst=mac_id) / IPv6(src="::1") / TCP() / Raw(payload),
+ ]
+ with TestPmdShell(node=self.sut_node, enable_rx_cksum=True) as testpmd:
+ testpmd.set_forward_mode(SimpleForwardingModes.csum)
+ testpmd.set_verbose(level=1)
+ self.setup_hw_offload(testpmd=testpmd)
+ testpmd.start()
+ self.send_packet_and_verify(packet_list=packet_list, load=payload, should_receive=True)
+ for i in range(0, len(packet_list)):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=True, goodIP=True, testpmd=testpmd
+ )
+
+ def test_no_insert_checksums(self) -> None:
+ """Enable checksum offload insertion and verify packet reception."""
+ payload = "xxxxx"
+ mac_id = "00:00:00:00:00:01"
+ packet_list = [
+ Ether(dst=mac_id) / IP() / UDP() / Raw(payload),
+ Ether(dst=mac_id) / IP() / TCP() / Raw(payload),
+ Ether(dst=mac_id) / IP() / SCTP() / Raw(payload),
+ Ether(dst=mac_id) / IPv6(src="::1") / UDP() / Raw(payload),
+ Ether(dst=mac_id) / IPv6(src="::1") / TCP() / Raw(payload),
+ ]
+ with TestPmdShell(node=self.sut_node, enable_rx_cksum=True) as testpmd:
+ testpmd.set_forward_mode(SimpleForwardingModes.csum)
+ testpmd.set_verbose(level=1)
+ testpmd.start()
+ self.send_packet_and_verify(packet_list=packet_list, load=payload, should_receive=True)
+ for i in range(0, len(packet_list)):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=True, goodIP=True, testpmd=testpmd
+ )
+
+ def test_validate_rx_checksum(self) -> None:
+ """Verify verbose output of Rx packets matches expected behavior."""
+ mac_id = "00:00:00:00:00:01"
+ packet_list = [
+ Ether(dst=mac_id) / IP() / UDP(),
+ Ether(dst=mac_id) / IP() / TCP(),
+ Ether(dst=mac_id) / IP() / SCTP(),
+ Ether(dst=mac_id) / IPv6(src="::1") / UDP(),
+ Ether(dst=mac_id) / IPv6(src="::1") / TCP(),
+ Ether(dst=mac_id) / IP(chksum=0x0) / UDP(chksum=0xF),
+ Ether(dst=mac_id) / IP(chksum=0x0) / TCP(chksum=0xF),
+ Ether(dst=mac_id) / IP(chksum=0x0) / SCTP(chksum=0xf),
+ Ether(dst=mac_id) / IPv6(src="::1") / UDP(chksum=0xF),
+ Ether(dst=mac_id) / IPv6(src="::1") / TCP(chksum=0xF),
+ ]
+ with TestPmdShell(node=self.sut_node, enable_rx_cksum=True) as testpmd:
+ testpmd.set_forward_mode(SimpleForwardingModes.csum)
+ testpmd.set_verbose(level=1)
+ self.setup_hw_offload(testpmd=testpmd)
+ for i in range(0, 5):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=True, goodIP=True, testpmd=testpmd
+ )
+ for i in range(5, 8):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=False, goodIP=False, testpmd=testpmd
+ )
+ for i in range(8, 10):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=False, goodIP=True, testpmd=testpmd
+ )
+
+ def test_l4_rx_checksum(self) -> None:
+ """Tests L4 Rx checksum in a variety of scenarios."""
+ mac_id = "00:00:00:00:00:01"
+ packet_list = [
+ Ether(dst=mac_id) / IP() / UDP(),
+ Ether(dst=mac_id) / IP() / TCP(),
+ Ether(dst=mac_id) / IP() / SCTP(),
+ Ether(dst=mac_id) / IP() / UDP(chksum=0xF),
+ Ether(dst=mac_id) / IP() / TCP(chksum=0xF),
+ Ether(dst=mac_id) / IP() / SCTP(chksum=0xf)
+ ]
+ with TestPmdShell(node=self.sut_node, enable_rx_cksum=True) as testpmd:
+ testpmd.set_forward_mode(SimpleForwardingModes.csum)
+ testpmd.set_verbose(level=1)
+ self.setup_hw_offload(testpmd=testpmd)
+ for i in range(0, 3):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=True, goodIP=True, testpmd=testpmd
+ )
+ for i in range(3, 6):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=False, goodIP=True, testpmd=testpmd
+ )
+
+ def test_l3_rx_checksum(self) -> None:
+ """Tests L3 Rx checksum hardware offload."""
+ mac_id = "00:00:00:00:00:01"
+ packet_list = [
+ Ether(dst=mac_id) / IP() / UDP(),
+ Ether(dst=mac_id) / IP() / TCP(),
+ Ether(dst=mac_id) / IP() / SCTP(),
+ Ether(dst=mac_id) / IP(chksum=0xF) / UDP(),
+ Ether(dst=mac_id) / IP(chksum=0xF) / TCP(),
+ Ether(dst=mac_id) / IP(chksum=0xf) / SCTP()
+ ]
+ with TestPmdShell(node=self.sut_node, enable_rx_cksum=True) as testpmd:
+ testpmd.set_forward_mode(SimpleForwardingModes.csum)
+ testpmd.set_verbose(level=1)
+ self.setup_hw_offload(testpmd=testpmd)
+ for i in range(0, 3):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=True, goodIP=True, testpmd=testpmd
+ )
+ for i in range(3, 6):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=True, goodIP=False, testpmd=testpmd
+ )
+
+ def test_vlan_checksum(self) -> None:
+ """Tests VLAN Rx checksum hardware offload and verify packet reception."""
+ payload = "xxxxx"
+ mac_id = "00:00:00:00:00:01"
+ packet_list = [
+ Ether(dst=mac_id) / Dot1Q(vlan=1) / IP(chksum=0x0) / UDP(chksum=0xF) / Raw(payload),
+ Ether(dst=mac_id) / Dot1Q(vlan=1) / IP(chksum=0x0) / TCP(chksum=0xF) / Raw(payload),
+ Ether(dst=mac_id) / Dot1Q(vlan=1) / IP(chksum=0x0) / SCTP(chksum=0x0) / Raw(payload),
+ Ether(dst=mac_id) / Dot1Q(vlan=1) / IPv6(src="::1") / UDP(chksum=0xF) / Raw(payload),
+ Ether(dst=mac_id) / Dot1Q(vlan=1) / IPv6(src="::1") / TCP(chksum=0xF) / Raw(payload),
+ ]
+ with TestPmdShell(node=self.sut_node, enable_rx_cksum=True) as testpmd:
+ testpmd.set_forward_mode(SimpleForwardingModes.csum)
+ testpmd.set_verbose(level=1)
+ self.setup_hw_offload(testpmd=testpmd)
+ testpmd.start()
+ self.send_packet_and_verify(packet_list=packet_list, load=payload, should_receive=True)
+ for i in range(0, 3):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=False, goodIP=False, testpmd=testpmd
+ )
+ for i in range(3, 5):
+ self.send_packet_and_verify_checksum(
+ packet=packet_list[i], goodL4=False, goodIP=True, testpmd=testpmd
+ )
--
2.44.0