get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/120807/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 120807,
    "url": "https://patches.dpdk.org/api/patches/120807/?format=api",
    "web_url": "https://patches.dpdk.org/project/dts/patch/20221213090141.170959-2-ke1.xu@intel.com/",
    "project": {
        "id": 3,
        "url": "https://patches.dpdk.org/api/projects/3/?format=api",
        "name": "DTS",
        "link_name": "dts",
        "list_id": "dts.dpdk.org",
        "list_email": "dts@dpdk.org",
        "web_url": "",
        "scm_url": "git://dpdk.org/tools/dts",
        "webscm_url": "http://git.dpdk.org/tools/dts/",
        "list_archive_url": "https://inbox.dpdk.org/dts",
        "list_archive_url_format": "https://inbox.dpdk.org/dts/{}",
        "commit_url_format": ""
    },
    "msgid": "<20221213090141.170959-2-ke1.xu@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dts/20221213090141.170959-2-ke1.xu@intel.com",
    "date": "2022-12-13T09:01:40",
    "name": "[V3,1/2] test_plans/vf_offload: add test cases for tunneling packets",
    "commit_ref": null,
    "pull_url": null,
    "state": "accepted",
    "archived": false,
    "hash": "edde9818f9d7453c1a934deb92524417df2f061a",
    "submitter": {
        "id": 2810,
        "url": "https://patches.dpdk.org/api/people/2810/?format=api",
        "name": "Ke Xu",
        "email": "ke1.xu@intel.com"
    },
    "delegate": null,
    "mbox": "https://patches.dpdk.org/project/dts/patch/20221213090141.170959-2-ke1.xu@intel.com/mbox/",
    "series": [
        {
            "id": 26100,
            "url": "https://patches.dpdk.org/api/series/26100/?format=api",
            "web_url": "https://patches.dpdk.org/project/dts/list/?series=26100",
            "date": "2022-12-13T09:01:39",
            "name": "update existing cases and add new cases to validate vf tunneling packets",
            "version": 3,
            "mbox": "https://patches.dpdk.org/series/26100/mbox/"
        }
    ],
    "comments": "https://patches.dpdk.org/api/patches/120807/comments/",
    "check": "pending",
    "checks": "https://patches.dpdk.org/api/patches/120807/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<dts-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id C1AE7A0542;\n\tTue, 13 Dec 2022 10:03:04 +0100 (CET)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id BC9A440A89;\n\tTue, 13 Dec 2022 10:03:04 +0100 (CET)",
            "from mga07.intel.com (mga07.intel.com [134.134.136.100])\n by mails.dpdk.org (Postfix) with ESMTP id 4D71040146\n for <dts@dpdk.org>; Tue, 13 Dec 2022 10:03:02 +0100 (CET)",
            "from fmsmga002.fm.intel.com ([10.253.24.26])\n by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 13 Dec 2022 01:03:00 -0800",
            "from dpdk-xuke-lab.sh.intel.com ([10.67.119.8])\n by fmsmga002.fm.intel.com with ESMTP; 13 Dec 2022 01:02:59 -0800"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1670922181; x=1702458181;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=0QPmiACD++HcNKEuU5JO6dhY8pV8ohP4RDMv0nSOJI0=;\n b=PiIUrMwQULonP3f8OZUa6sFwsWxGUxFXpG4ZPviTEPva50dMi/+x5ta5\n 81mM2cQkDZ/tKrLaudQETHAxf+BOpx2Zb5Krw96A7PdYj3WAIgs1GfYLe\n vdSPgpA5JmsIW+QHRypxmAph3WYO7sFyt0tlCZ5yQ8pd+jA+fPfhhPxRE\n jkrasIjThQZlMhVPmCvN4vuXrWF9JiVh5lIhI6fhkLy8Y2tA+OMDJs1m/\n r9x3nxCAnr9+xhB+zu9tu4EhkVcK8NTWepWBVe+4fZiTkpzWsPXZOkGLG\n zfNZP5EwOEABFtjo4fM9DxJJYLRf21SFu/CxbgKXryjefVkWbxzcnuyrq A==;",
        "X-IronPort-AV": [
            "E=McAfee;i=\"6500,9779,10559\"; a=\"382386469\"",
            "E=Sophos;i=\"5.96,240,1665471600\"; d=\"scan'208\";a=\"382386469\"",
            "E=McAfee;i=\"6500,9779,10559\"; a=\"755294423\"",
            "E=Sophos;i=\"5.96,240,1665471600\"; d=\"scan'208\";a=\"755294423\""
        ],
        "X-ExtLoop1": "1",
        "From": "Ke Xu <ke1.xu@intel.com>",
        "To": "dts@dpdk.org",
        "Cc": "ke1.xu@intel.com,\n\tqi.fu@intel.com,\n\tlijuan.tu@intel.com",
        "Subject": "[DTS][PATCH V3 1/2] test_plans/vf_offload: add test cases for\n tunneling packets",
        "Date": "Tue, 13 Dec 2022 17:01:40 +0800",
        "Message-Id": "<20221213090141.170959-2-ke1.xu@intel.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20221213090141.170959-1-ke1.xu@intel.com>",
        "References": "<20221213090141.170959-1-ke1.xu@intel.com>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=UTF-8",
        "Content-Transfer-Encoding": "8bit",
        "X-BeenThere": "dts@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "test suite reviews and discussions <dts.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dts>,\n <mailto:dts-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/dts/>",
        "List-Post": "<mailto:dts@dpdk.org>",
        "List-Help": "<mailto:dts-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dts>,\n <mailto:dts-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dts-bounces@dpdk.org"
    },
    "content": "DPDK will support outer checksum offload and tunneling TSO in release 22.11, this commit is intended to cover the new scenario of test these features.\n\nSigned-off-by: Ke Xu <ke1.xu@intel.com>\n---\n test_plans/vf_offload_test_plan.rst | 233 ++++++++++++++++++++++++++++\n 1 file changed, 233 insertions(+)",
    "diff": "diff --git a/test_plans/vf_offload_test_plan.rst b/test_plans/vf_offload_test_plan.rst\nindex c5e720f2..f80290f5 100644\n--- a/test_plans/vf_offload_test_plan.rst\n+++ b/test_plans/vf_offload_test_plan.rst\n@@ -113,6 +113,101 @@ be validated as pass by the tester.\n The IPv4 source address will not be changed by testpmd.\n \n \n+Test Case: HW tunneling checksum offload check\n+==============================================\n+In DPDK 22.11 release, Intel® Ethernet 800 Series NIC with ICE supports HW\n+checksum offload for tunneling packets for checking both inner and outer\n+checksum. For the packets involved in this case, a ICE COMMON DDP Package\n+is required.\n+\n+Start testpmd and enable checksum offload on rx port.\n+\n+Setup the ``csum`` forwarding mode::\n+\n+  testpmd> set fwd csum\n+  Set csum packet forwarding mode\n+\n+Enable the IPv4/UDP/TCP/SCTP HW checksum offload on port 0::\n+\n+  testpmd> port stop all\n+  testpmd> csum set ip hw 0\n+  testpmd> csum set tcp hw 0\n+  testpmd> csum set udp hw 0\n+  testpmd> csum set sctp hw 0\n+  testpmd> csum set outer-ip hw 0\n+  testpmd> csum set outer-udp hw 0\n+  testpmd> csum parse-tunnel on 0\n+  testpmd> port start all\n+  testpmd> set promisc 0 on\n+  testpmd> start\n+    csum packet forwarding - CRC stripping disabled - packets/burst=32\n+    nb forwarding cores=1 - nb forwarding ports=10\n+    RX queues=1 - RX desc=128 - RX free threshold=64\n+    RX threshold registers: pthresh=8 hthresh=8 wthresh=4\n+    TX queues=1 - TX desc=512 - TX free threshold=0\n+    TX threshold registers: pthresh=32 hthresh=8 wthresh=8\n+\n+Configure the traffic generator to send the multiple packets for the following\n+combination with inner package of:\n+\n+  +----------------+----------------------------------------+\n+  | packet type    | packet organization                    |\n+  +================+========================================+\n+  |                | IPv4 / UDP / payload                   |\n+  |                +----------------------------------------+\n+  |                | IPv4 / TCP / payload                   |\n+  |                +----------------------------------------+\n+  | inner packets  | IPv4 / SCTP / payload                  |\n+  | for checksum   +----------------------------------------+\n+  | offload test   | IPv6 / UDP / payload                   |\n+  |                +----------------------------------------+\n+  |                | IPv6 / TCP / payload                   |\n+  |                +----------------------------------------+\n+  |                | IPv6 / SCTP / payload                  |\n+  +----------------+----------------------------------------+\n+\n+And outer or tunneling package of :\n+\n+  +----------------+----------------------------------------+\n+  | packet type    | packet organization                    |\n+  +================+========================================+\n+  |                | Ether / IPv4 / UDP / VXLAN / Ether     |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / UDP / VXLAN / Ether     |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / GRE                     |\n+  | outer and      +----------------------------------------+\n+  | tunneling      | Ether / IPv4 / GRE / Ether             |\n+  | packets        +----------------------------------------+\n+  | for checksum   | Ether / IPv6 / GRE                     |\n+  | offload test   +----------------------------------------+\n+  |                | Ether / IPv6 / GRE / Ether             |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / NVGRE                   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / NVGRE / Ether           |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / NVGRE                   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / NVGRE / Ether           |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / UDP / GTPU              |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / UDP / GTPU              |\n+  +----------------+----------------------------------------+\n+  \n+Notice that VxLAN needs DCF to configure, so testing of VxLAN may need to perform\n+on DCF.\n+\n+Send packets with incorrect checksum on outer IPv4, outer UDP (if exists), inner\n+IP, inner L4, verify dpdk can rx it and report the checksum error,\n+verify that the same number of packet are correctly received on the traffic\n+generator side. And IPv4 checksum, TCP checksum, UDP checksum, SCTP checksum need\n+be validated as pass by the tester.\n+\n+The IPv4 source address will not be changed by testpmd.\n+\n+\n Test Case: SW checksum offload check\n ====================================\n \n@@ -183,6 +278,91 @@ and checksum on rx port. The test commands is below::\n   # Enable TSO on tx port\n   testpmd> tso set 800 1\n \n+For tunneling cases on Intel® Ethernet 800 Series NIC with ICE, add tunneling support\n+on csum and enable tunnel tso as below::\n+\n+  # Enable hw checksum for tunneling on rx port\n+  testpmd> port stop all\n+  testpmd> csum set outer-ip hw 0\n+  testpmd> csum set outer-udp hw 0\n+  testpmd> csum parse-tunnel on 0\n+  testpmd> port start all\n+  testpmd> tunnel_tso set 800 1\n+\n+Configure the traffic generator to send the multiple packets for the following\n+combination:\n+\n+  +----------------+----------------------------------------+\n+  | packet type    | packet organization                    |\n+  +================+========================================+\n+  |                | Ether / IPv4 / TCP / payload len 128   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / TCP / payload len 800   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / TCP / payload len 801   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / TCP / payload len 1700  |\n+  | non-tunneling  +----------------------------------------+\n+  | packets for    | Ether / IPv4 / TCP / payload len 2500  |\n+  | TSO test       +----------------------------------------+\n+  |                | Ether / IPv6 / TCP / payload len 128   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / TCP / payload len 800   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / TCP / payload len 801   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / TCP / payload len 1700  |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / TCP / payload len 2500  |\n+  +----------------+----------------------------------------+\n+  |                | Ether / IPv4 / UDP / VXLAN / Ether     |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / UDP / VXLAN / Ether     |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / GRE                     |\n+  | outer and      +----------------------------------------+\n+  | tunneling      | Ether / IPv4 / GRE / Ether             |\n+  | packets        +----------------------------------------+\n+  | for tso test   | Ether / IPv6 / GRE                     |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / GRE / Ether             |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / NVGRE                   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / NVGRE / Ether           |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / NVGRE                   |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / NVGRE / Ether           |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv4 / UDP / GTPU              |\n+  |                +----------------------------------------+\n+  |                | Ether / IPv6 / UDP / GTPU              |\n+  +----------------+----------------------------------------+\n+  |                | IPv4 / TCP / payload len 128           |\n+  |                +----------------------------------------+\n+  |                | IPv4 / TCP / payload len 800           |\n+  |                +----------------------------------------+\n+  |                | IPv4 / TCP / payload len 801           |\n+  |                +----------------------------------------+\n+  |                | IPv4 / TCP / payload len 1700          |\n+  |                +----------------------------------------+\n+  | inner packets  | IPv4 / TCP / payload len 2500          |\n+  | for TSO test   +----------------------------------------+\n+  |                | IPv6 / TCP / payload len 128           |\n+  |                +----------------------------------------+\n+  |                | IPv6 / TCP / payload len 800           |\n+  |                +----------------------------------------+\n+  |                | IPv6 / TCP / payload len 801           |\n+  |                +----------------------------------------+\n+  |                | IPv6 / TCP / payload len 1700          |\n+  |                +----------------------------------------+\n+  |                | IPv6 / TCP / payload len 2500          |\n+  +----------------+----------------------------------------+\n+  \n+Notice that VxLAN needs DCF to configure, so testing of VxLAN may need to perform\n+on DCF.\n+\n \n Test case: csum fwd engine, use TSO\n ===================================\n@@ -226,3 +406,56 @@ Test IPv4() in scapy::\n Test IPv6() in scapy::\n \n     sendp([Ether(dst=\"%s\", src=\"52:00:00:00:00:00\")/IPv6(src=\"FE80:0:0:0:200:1FF:FE00:200\", dst=\"3555:5555:6666:6666:7777:7777:8888:8888\")/UDP(sport=1021,dport=1021)/Raw(load=\"\\x50\"*%s)], iface=\"%s\")\n+\n+\n+Test case: csum fwd engine, use tunnel TSO\n+==========================================\n+In DPDK 22.11 release, Intel® Ethernet 800 Series NIC with ICE supports HW\n+TSO for tunneling packets. For the packets involved in this case, a ICE COMMON\n+DDP Package is required.\n+\n+This test uses ``Scapy`` to send out one large tunneled TCP package. The dut\n+forwards package with tunnel TSO enable on tx port while rx port turns checksum\n+on. After package send out by TSO on tx port, the tester receives multiple small\n+TCP package.\n+\n+Turn off tx port by ethtool on tester::\n+\n+  ethtool -K <tx port> rx off tx off tso off gso off gro off lro off\n+  ip l set <tx port> up\n+\n+Capture package rx port on tester::\n+\n+  tcpdump -n -e -i <rx port> -s 0 -w /tmp/cap\n+\n+Launch the userland ``testpmd`` application on DUT as follows::\n+\n+  testpmd> set verbose 1\n+  # Enable hw checksum on rx port\n+  testpmd> port stop all\n+  testpmd> csum set ip hw 0\n+  testpmd> csum set tcp hw 0\n+  testpmd> csum set udp hw 0\n+  testpmd> csum set sctp hw 0\n+  testpmd> csum set outer-ip hw 0\n+  testpmd> csum set outer-udp hw 0\n+  testpmd> csum parse-tunnel on 0\n+  testpmd> set promisc 0 on\n+  testpmd> port start all\n+\n+  # Enable TSO on tx port\n+  testpmd> tunnel_tso set 800 1\n+  # Set fwd engine and start\n+\n+  testpmd> set fwd csum\n+  testpmd> start\n+\n+Test IPv4() in scapy::\n+\n+  for one_outer_packet in outer_packet_list:\n+    sendp([Ether(dst=\"%s\", src=\"52:00:00:00:00:00\")/one_outer_packet/IP(src=\"192.168.1.1\",dst=\"192.168.1.2\")/UDP(sport=1021,dport=1021)/Raw(load=\"\\x50\"*%s)], iface=\"%s\")\n+\n+Test IPv6() in scapy::\n+\n+  for one_outer_packet in outer_packet_list:\n+    sendp([Ether(dst=\"%s\", src=\"52:00:00:00:00:00\")/one_outer_packet/IPv6(src=\"FE80:0:0:0:200:1FF:FE00:200\", dst=\"3555:5555:6666:6666:7777:7777:8888:8888\")/UDP(sport=1021,dport=1021)/Raw(load=\"\\x50\"*%s)], iface=\"%s\")\n",
    "prefixes": [
        "V3",
        "1/2"
    ]
}