get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 126971,
    "url": "http://patches.dpdk.org/api/patches/126971/?format=api",
    "web_url": "http://patches.dpdk.org/project/dts/patch/20230518024014.120638-2-yingyax.han@intel.com/",
    "project": {
        "id": 3,
        "url": "http://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": "<20230518024014.120638-2-yingyax.han@intel.com>",
    "list_archive_url": "https://inbox.dpdk.org/dts/20230518024014.120638-2-yingyax.han@intel.com",
    "date": "2023-05-18T02:40:12",
    "name": "[V4,1/3] test_plans: add iavf_checksum_offload_perf test plan",
    "commit_ref": null,
    "pull_url": null,
    "state": "accepted",
    "archived": false,
    "hash": "7a8bafe448f5c778e7264db3dd931f5d5f8ca274",
    "submitter": {
        "id": 1645,
        "url": "http://patches.dpdk.org/api/people/1645/?format=api",
        "name": "Yingya Han",
        "email": "yingyax.han@intel.com"
    },
    "delegate": null,
    "mbox": "http://patches.dpdk.org/project/dts/patch/20230518024014.120638-2-yingyax.han@intel.com/mbox/",
    "series": [
        {
            "id": 28051,
            "url": "http://patches.dpdk.org/api/series/28051/?format=api",
            "web_url": "http://patches.dpdk.org/project/dts/list/?series=28051",
            "date": "2023-05-18T02:40:11",
            "name": "add iavf_checksum_offload_perf test suite",
            "version": 4,
            "mbox": "http://patches.dpdk.org/series/28051/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/126971/comments/",
    "check": "pending",
    "checks": "http://patches.dpdk.org/api/patches/126971/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 9493242B31;\n\tThu, 18 May 2023 04:40:21 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 9036C42BDA;\n\tThu, 18 May 2023 04:40:21 +0200 (CEST)",
            "from mga07.intel.com (mga07.intel.com [134.134.136.100])\n by mails.dpdk.org (Postfix) with ESMTP id 8B0AF40E25\n for <dts@dpdk.org>; Thu, 18 May 2023 04:40:19 +0200 (CEST)",
            "from orsmga004.jf.intel.com ([10.7.209.38])\n by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 17 May 2023 19:40:18 -0700",
            "from dpdk-lijuan-icelake4.sh.intel.com ([10.67.119.160])\n by orsmga004.jf.intel.com with ESMTP; 17 May 2023 19:40:17 -0700"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple;\n d=intel.com; i=@intel.com; q=dns/txt; s=Intel;\n t=1684377618; x=1715913618;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=8E4YkpnmJyFboLsPiMYjAkxfhkaED+T0YNH59ZIBuaE=;\n b=LVIRa7XwnRcZGOSBSdFm8ltVfda7EZGjCmhQGFxeaobjVQvJXQfz3Sb7\n atHsGL1EAt9+l6+v+A69o75f/0jGJCxWF6zl55EnGbvSiQqiwc62+gpES\n Dr33kDs3q4b73fpaaimxGYpcYoFFfM6fQ0HqbUkUDuff5Z1VrhMK0f4H0\n BiQJcpZx6Q4qzCms6Esi4unYbeH6U72H0SI4nU5rN8DqiF9o8SMZJnxup\n dAnUAFtkn8JqFa1Jqe0z0qUNb4UXQhn2Fp1FqCrpKk0B53+Pe4ioAYdyD\n JlioywAhNPc0+DgjS3OYjDzDMhXlqo1jev7z3vhXJYAmvZqKp6PrXdDpV A==;",
        "X-IronPort-AV": [
            "E=McAfee;i=\"6600,9927,10713\"; a=\"417608465\"",
            "E=Sophos;i=\"5.99,284,1677571200\"; d=\"scan'208\";a=\"417608465\"",
            "E=McAfee;i=\"6600,9927,10713\"; a=\"826199440\"",
            "E=Sophos;i=\"5.99,284,1677571200\"; d=\"scan'208\";a=\"826199440\""
        ],
        "X-ExtLoop1": "1",
        "From": "Yingya Han <yingyax.han@intel.com>",
        "To": "dts@dpdk.org",
        "Cc": "Yingya Han <yingyax.han@intel.com>",
        "Subject": "[dts][PATCH V4 1/3]test_plans: add iavf_checksum_offload_perf test\n plan",
        "Date": "Thu, 18 May 2023 02:40:12 +0000",
        "Message-Id": "<20230518024014.120638-2-yingyax.han@intel.com>",
        "X-Mailer": "git-send-email 2.34.1",
        "In-Reply-To": "<20230518024014.120638-1-yingyax.han@intel.com>",
        "References": "<20230518024014.120638-1-yingyax.han@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": "Signed-off-by: Yingya Han <yingyax.han@intel.com>\n---\n .../iavf_checksum_offload_perf_test_plan.rst  | 216 ++++++++++++++++++\n test_plans/index.rst                          |   1 +\n 2 files changed, 217 insertions(+)\n create mode 100644 test_plans/iavf_checksum_offload_perf_test_plan.rst",
    "diff": "diff --git a/test_plans/iavf_checksum_offload_perf_test_plan.rst b/test_plans/iavf_checksum_offload_perf_test_plan.rst\nnew file mode 100644\nindex 00000000..bd5ebd50\n--- /dev/null\n+++ b/test_plans/iavf_checksum_offload_perf_test_plan.rst\n@@ -0,0 +1,216 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+   Copyright(c) 2023 Intel Corporation\n+\n+=====================================================\n+Benchmark the performance of iavf checksum forwarding\n+=====================================================\n+\n+Description\n+===========\n+\n+Send packets with incorrect checksum,\n+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.\n+\n+Prerequisites\n+=============\n+\n+1. Hardware:\n+\n+   I40E driver NIC (Intel® Ethernet 700 Series XXV710, XL710, X710)\n+   ICE driver NIC (Intel® Ethernet 800 Series E810-CQDA2, E810-XXVDA4)\n+\n+2. Software::\n+\n+    dpdk: git clone http://dpdk.org/git/dpdk\n+    trex: git clone http://trex-tgn.cisco.com/trex/release/v2.93.tar.gz\n+\n+\n+Test Case\n+=========\n+The test case check the throughput result with ipv4, in the case,\n+we will send the bi-direction flows with line rate, then we can check the\n+passthrough rate.\n+\n+Common Steps\n+------------\n+1. Bind PF ports to kernel driver(ice), then create 1 VF from each PF,\n+   take E810-CQDA2 for example::\n+\n+    echo 1 > /sys/bus/pci/devices/0000\\:17\\:00.0/sriov_numvfs\n+    echo 1 > /sys/bus/pci/devices/0000\\:4b\\:00.0/sriov_numvfs\n+\n+2. Ip link set VF trust on and spoofchk off on DUT::\n+\n+    ip link set $PF_INTF vf 0 trust on\n+    ip link set $PF_INTF vf 0 spoofchk off\n+\n+3. Set vf mac address::\n+\n+    ip link set ens5f0 vf 0 mac 00:12:34:56:78:01\n+    ip link set ens6f0 vf 0 mac 00:12:34:56:78:02\n+\n+4. Bind tested ports to vfio-pci::\n+\n+    <dpdk_dir>#./usertools/dpdk-devbind.py -s\n+    0000:17:00.0 'Device 1592' if=ens5f0 drv=ice unused=vfio-pci\n+    0000:4b:00.0 'Device 1592' if=ens6f0 drv=ice unused=vfio-pci\n+    <dpdk_dir>#./usertools/dpdk-devbind.py -b vfio-pci <pci device id>\n+    <dpdk_dir>#./usertools/dpdk-devbind.py -b vfio-pci 0000:17:01.0\n+    <dpdk_dir>#./usertools/dpdk-devbind.py -b vfio-pci 0000:4b:01.0\n+\n+5. Start dpdk-testpmd::\n+\n+     <build_dir>/app/dpdk-testpmd -l 5,6 -n 8 --force-max-simd-bitwidth=512 \\\n+     -- -i --portmask=0x3 --rxq=1 --txq=1 --txd=1024 --rxd=1024 --forward=io \\\n+     --nb-cores=1 --enable-rx-cksum\n+\n+    Note:\n+      -force-max-simd-bitwidth: set 512\n+      -enable-rx-cksum: enable rx checksum\n+\n+6. Configure traffic generator to send traffic\n+\n+    Test flow MAC table.\n+\n+    +------+---------+------------+----------------+\n+    | Flow | Traffic | MAC        | MAC            |\n+    |      | Gen.    | Src.       | Dst.           |\n+    |      | Port    | Address    | Address        |\n+    +======+=========+============+================+\n+    |   1  |   TG0   | Random MAC | 00:12:34:56:01 |\n+    +------+---------+------------+----------------+\n+    |   2  |   TG1   | Random Mac | 00:12:34:56:02 |\n+    +------+---------+------------+----------------+\n+\n+    The Flow IP table.\n+\n+    +------+---------+------------+------------+\n+    | Flow | Traffic | IPV4       | IPV4       |\n+    |      | Gen.    | Src.       | Dest.      |\n+    |      | Port    | Address    | Address    |\n+    +======+=========+============+============+\n+    |   1  |   TG0   | Any IP     | 198.18.1.0 |\n+    +------+---------+------------+------------+\n+    |   2  |   TG1   | Any IP     | 198.18.0.0 |\n+    +------+---------+------------+------------+\n+\n+    Set the packet length : 128 bytes-1518 bytes\n+    The IPV4 Dest Address increase with the num 1024.\n+\n+7. Test results table.\n+\n+    +-----------+------------+-------------+---------+\n+    |  Fwd_core | Frame Size |  Throughput |   Rate  |\n+    +===========+============+=============+=========+\n+    |  1C/1T    |    128     |  xxxxx Mpps |   xxx % |\n+    +-----------+------------+-------------+---------+\n+    |  1C/1T    |   ...      |  xxxxx Mpps |   xxx % |\n+    +-----------+------------+-------------+---------+\n+\n+Test Case 1: test_perf_disable_checksum_offload_ipv4\n+----------------------------------------------------\n+\n+1. Repeat common step 1-5.\n+\n+2. Configure traffic generator to send traffic as common step 6.\n+\n+3. Record Test results as common step 7.\n+\n+4. Config SW checksum offload::\n+\n+    testpmd>stop\n+    testpmd>set fwd csum\n+    testpmd>port stop all\n+    testpmd>csum set ip sw 0\n+    testpmd>csum set ip sw 1\n+    testpmd>port start all\n+    testpmd>start\n+\n+5. Configure traffic generator to send traffic as common step 6.\n+\n+   And configure the correct or incorrect ipv4 checksum separately.\n+\n+6. Record Test results as common step 7.\n+\n+Test Case 2: test_perf_disable_checksum_offload_vxlan\n+-----------------------------------------------------\n+\n+1. Repeat common step 1-5.\n+\n+2. Config SW checksum offload::\n+\n+    testpmd>stop\n+    testpmd>set fwd csum\n+    testpmd>port stop all\n+    testpmd>csum set ip sw 0\n+    testpmd>csum set ip sw 1\n+    testpmd>port start all\n+    testpmd>start\n+\n+3. Set the traffic flow as below:\n+\n+    Ether / IPv4 / UDP / VXLAN / Ether / IPv4 / UDP / payload\n+\n+    Set the packet length : 128 bytes-1518 bytes.\n+\n+    Configure the correct or incorrect inner and outer ipv4 checksum and udp checksum separately.\n+\n+4. Record Test results as common step 7.\n+\n+Test Case 3: test_perf_enable_checksum_offload_ipv4\n+---------------------------------------------------\n+\n+1. Repeat common step 1-5.\n+\n+2. Config HW checksum offload::\n+\n+    testpmd>stop\n+    testpmd>set fwd csum\n+    testpmd>port stop all\n+    testpmd>csum set ip hw 0\n+    testpmd>csum set ip hw 1\n+    testpmd>port start all\n+    testpmd>set promisc all on\n+    testpmd>start\n+\n+3. Configure traffic generator to send traffic as common step 6.\n+\n+   And configure the correct or incorrect ipv4 checksum separately.\n+\n+5. Record Test results as common step 7.\n+\n+Test Case 4: test_perf_enable_checksum_offload_vxlan\n+----------------------------------------------------\n+\n+1. Repeat common step 1-5.\n+\n+2. Config HW checksum offload::\n+\n+    testpmd>stop\n+    testpmd>set fwd csum\n+    testpmd>port stop all\n+    testpmd>csum set ip hw 0\n+    testpmd>csum set ip hw 1\n+    testpmd>csum set udp hw 0\n+    testpmd>csum set udp hw 1\n+    testpmd>csum set outer-ip hw 0\n+    testpmd>csum set outer-ip hw 1\n+    testpmd>csum set outer-udp hw 0\n+    testpmd>csum set outer-udp hw 1\n+    testpmd>csum parse-tunnel on 0\n+    testpmd>csum parse-tunnel on 1\n+    testpmd>port start all\n+    testpmd>set promisc all on\n+    testpmd>start\n+\n+3. Set the traffic flow as below:\n+\n+    Ether / IPv4 / UDP / VXLAN / Ether / IPv4 / UDP / payload\n+\n+    Set the packet length : 128 bytes-1518 bytes.\n+\n+    Configure the correct or incorrect inner and outer ipv4 checksum and udp checksum separately.\n+\n+4. Record Test results as common step 7.\ndiff --git a/test_plans/index.rst b/test_plans/index.rst\nindex a0c056cd..8e10a7d5 100644\n--- a/test_plans/index.rst\n+++ b/test_plans/index.rst\n@@ -80,6 +80,7 @@ The following are the test plans for the DPDK DTS automated test system.\n     hotplug_test_plan\n     ice_iavf_fdir_test_plan\n     ice_iavf_fdir_gtpogre_test_plan\n+    iavf_checksum_offload_perf_test_plan\n     iavf_flexible_descriptor_test_plan\n     iavf_package_driver_error_handle_test_plan\n     iavf_fdir_protocol_agnostic_flow_test_plan\n",
    "prefixes": [
        "V4",
        "1/3"
    ]
}