Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/121516/?format=api
{ "id": 121516, "url": "http://patches.dpdk.org/api/patches/121516/?format=api", "web_url": "http://patches.dpdk.org/project/dts/patch/20230103083951.1553786-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": "<20230103083951.1553786-2-yingyax.han@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dts/20230103083951.1553786-2-yingyax.han@intel.com", "date": "2023-01-03T08:39:43", "name": "[V1,1/9] test_plans: add l3fwd_lpm_ipv4_rfc2544 test plan", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": false, "hash": "bf25c0f696e875002cd1dfce602c2a9bcc35d9d0", "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/20230103083951.1553786-2-yingyax.han@intel.com/mbox/", "series": [ { "id": 26354, "url": "http://patches.dpdk.org/api/series/26354/?format=api", "web_url": "http://patches.dpdk.org/project/dts/list/?series=26354", "date": "2023-01-03T08:39:42", "name": "test_plans: add perf test plans", "version": 1, "mbox": "http://patches.dpdk.org/series/26354/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/121516/comments/", "check": "pending", "checks": "http://patches.dpdk.org/api/patches/121516/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 2D8B0A00C4;\n\tTue, 3 Jan 2023 09:40:00 +0100 (CET)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 256E540A82;\n\tTue, 3 Jan 2023 09:40:00 +0100 (CET)", "from mga09.intel.com (mga09.intel.com [134.134.136.24])\n by mails.dpdk.org (Postfix) with ESMTP id 3AD7D40689\n for <dts@dpdk.org>; Tue, 3 Jan 2023 09:39:58 +0100 (CET)", "from orsmga002.jf.intel.com ([10.7.209.21])\n by orsmga102.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 03 Jan 2023 00:39:57 -0800", "from dpdk-lijuan-icelake4.sh.intel.com ([10.67.119.188])\n by orsmga002.jf.intel.com with ESMTP; 03 Jan 2023 00:39:56 -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=1672735198; x=1704271198;\n h=from:to:cc:subject:date:message-id:in-reply-to:\n references:mime-version:content-transfer-encoding;\n bh=qvgo6qYJu2pQtnfszTTAyKeZoiVKHlxzfIUneOwpMjM=;\n b=dfS/JNzl+Q9LmUjTnyJDRlh62YWVGiBOspER1Sh9B3UIoyPY8W+g7oEr\n 0lkOr948HXYPAkttKBAQq7pNVsc91PeDFvIN3XGjSMFhrC+sirirc6y52\n q0mvW+hyri8TzliJAFKCsS0mS/QrfG+JPbrtr+w3aKZ+N7+g3bKnne4Yw\n ce8aywkzca6i5miAC1b/QOJeJPYpYYPbrIIO6Re0C+l2NY6oC2DhOeceq\n lqLAu51iSRb121sAdYl6sIvm7mTPsoIqhyCo/vKMzZ0/UVYy9GduOp2rD\n bTrGulkIcIYMtY2QdMOdkJHjH2BfnTWiqexB4Jl5Pz/jRlHjPb96PaGq3 Q==;", "X-IronPort-AV": [ "E=McAfee;i=\"6500,9779,10578\"; a=\"322847054\"", "E=Sophos;i=\"5.96,296,1665471600\"; d=\"scan'208\";a=\"322847054\"", "E=McAfee;i=\"6500,9779,10578\"; a=\"654706411\"", "E=Sophos;i=\"5.96,296,1665471600\"; d=\"scan'208\";a=\"654706411\"" ], "X-ExtLoop1": "1", "From": "Yingya Han <yingyax.han@intel.com>", "To": "dts@dpdk.org", "Cc": "Yingya Han <yingyax.han@intel.com>", "Subject": "[dts][PATCH V1 1/9]test_plans: add l3fwd_lpm_ipv4_rfc2544 test plan", "Date": "Tue, 3 Jan 2023 08:39:43 +0000", "Message-Id": "<20230103083951.1553786-2-yingyax.han@intel.com>", "X-Mailer": "git-send-email 2.34.1", "In-Reply-To": "<20230103083951.1553786-1-yingyax.han@intel.com>", "References": "<20230103083951.1553786-1-yingyax.han@intel.com>", "MIME-Version": "1.0", "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 .../l3fwd_lpm_ipv4_rfc2544_test_plan.rst | 151 ++++++++++++++++++\n 1 file changed, 151 insertions(+)\n create mode 100644 test_plans/l3fwd_lpm_ipv4_rfc2544_test_plan.rst", "diff": "diff --git a/test_plans/l3fwd_lpm_ipv4_rfc2544_test_plan.rst b/test_plans/l3fwd_lpm_ipv4_rfc2544_test_plan.rst\nnew file mode 100644\nindex 00000000..29b16b3e\n--- /dev/null\n+++ b/test_plans/l3fwd_lpm_ipv4_rfc2544_test_plan.rst\n@@ -0,0 +1,151 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2022 Intel Corporation\n+\n+========================================================\n+L3 forwarding rfc2544 test in LPM mode with IPV4 packets\n+========================================================\n+\n+RFC2544 Zero packet loss test case: Used to determine the DUT throughput as defined in\n+RFC1242(https://www.ietf.org/rfc/rfc1242.txt). Note RFC6201\n+https://www.ietf.org/rfc/rfc6201.txt has updated RFC2544 and RFC1242. Please check the link\n+for more details. In this case, RFC2544 test uses DPDK l3fwd as test application.\n+\n+Prerequisites\n+=============\n+\n+Topology\n+--------\n+It requires at least 1 port connected traffic generator::\n+ Port0 --- TG0\n+\n+2 ports::\n+ Port0 --- TG0\n+ Port1 --- TG1\n+\n+4 ports::\n+ Port0 --- TG0\n+ Port1 --- TG1\n+ Port2 --- TG2\n+ Port3 --- TG3\n+\n+Hardware\n+--------\n+This suite focus on l3fwd application, so any standard Ethernet Network Adapter is qualified.\n+\n+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+Send a specific number of frames at a specific rate through the DUT and then\n+count the frames that are transmitted by the DUT. If the count of offered frames is not equal\n+to the count of received frames, the rate of the offered stream is reduced and the test is rerun.\n+The throughput is the fastest rate at which the count of test frames transmitted by the DUT is\n+equal to the number of test frames sent to it by the test equipment.\n+\n+The l3fwd application has a number of command line options, here list the key options will be tested::\n+\n+ ./dpdk-l3fwd [EAL options] -- -p PORTMASK\n+ [--force-max-simd-bitwidth=max-simd-bitwidth]\n+ --config(port,queue,lcore)[,(port,queue,lcore)]\n+ [--rx-queue-size NPKTS]\n+ [--tx-queue-size NPKTS]\n+ [--parse-ptype]\n+ [-L]|[-E]\n+ ...\n+ Note:\n+ --force-max-simd-bitwidth: This setting is used to determine the vector path for component selection.\n+ And the default is avx2.\n+ --rx-queue-size: Rx queue size in decimal and default is 1024.\n+ --tx-queue-size: Tx queue size in decimal and default is 1024.\n+ --parse-ptype: Optional, set to use software to analyze packet type.\n+ Without this option, hardware will check the packet type.\n+ [-L]|[-E]: L3fwd uses the parameters \"-L\" and \"-E\" to correspond to LPM and EM modes respectively.\n+ And the default is LPM mode.\n+\n+Common Steps\n+------------\n+1. 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+ <dpdk_dir>#./usertools/dpdk-devbind.py -b vfio-pci <pci device id>\n+ <dpdk_dir>#./usertools/dpdk-devbind.py -b vfio-pci 0000:17:00.0\n+\n+2. Configure traffic generator to send traffic\n+\n+ Routing table for IPv4 packets\n+ - In LPM mode, the LPM table used for packet routing is:\n+\n+ +-------+-----------------------+\n+ | # | LPM prefix (IP/length)|\n+ +=======+=======================+\n+ | 0 | 198.18.0.0/24 |\n+ +-------+-----------------------+\n+ | 1 | 198.18.1.0/24 |\n+ +-------+-----------------------+\n+ | 2 | 198.18.2.0/24 |\n+ +-------+-----------------------+\n+ | 3 | 198.18.3.0/24 |\n+ +-------+-----------------------+\n+\n+ The flows need to be configured and started by the traffic generator:\n+ - IPv4 packets\n+\n+ +------+---------+------------+---------+\n+ | Flow | Traffic | IPv4 | IPv4 |\n+ | | Gen. | Dst. | Src. |\n+ | | Port | Address | Address |\n+ +======+=========+============+=========+\n+ | 1 | TG0 | 198.18.1.1 | Any Ip |\n+ +------+---------+------------+---------+\n+ | 2 | TG1 | 198.18.0.1 | Any Ip |\n+ +------+---------+------------+---------+\n+ | 3 | TG2 | 198.18.3.1 | Any Ip |\n+ +------+---------+------------+---------+\n+ | 4 | TG3 | 198.18.2.1 | Any Ip |\n+ +------+---------+------------+---------+\n+\n+ Set the packet length : 64 bytes-1518 bytes\n+ The IPV4 Src Address increase with the num 1024.\n+\n+3. Test result table\n+\n+ +-----------+------------+-------------+---------+\n+ | Fwd_core | Frame Size | Throughput | Rate |\n+ +===========+============+=============+=========+\n+ | 1C/1T | 64 | xxxxx Mpps | xxx % |\n+ +-----------+------------+-------------+---------+\n+ | 1C/1T | ... | xxxxx Mpps | xxx % |\n+ +-----------+------------+-------------+---------+\n+ | 2C/2T | 64 | xxxxx Mpps | xxx % |\n+ +-----------+------------+-------------+---------+\n+ | 2C/2T | ... | xxxxx Mpps | xxx % |\n+ +-----------+------------+-------------+---------+\n+ | 4C/4T | 64 | xxxxx Mpps | xxx % |\n+ +-----------+------------+-------------+---------+\n+ | 4C/4T | ... | xxxxx Mpps | xxx % |\n+ +-----------+------------+-------------+---------+\n+ | 8C/8T | 64 | xxxxx Mpps | xxx % |\n+ +-----------+------------+-------------+---------+\n+ | 8C/8T | ... | xxxxx Mpps | xxx % |\n+ +-----------+------------+-------------+---------+\n+\n+\n+Test Case: test_perf_rfc2544_ipv4_lpm\n+-------------------------------------\n+\n+1. Bind PF ports to dpdk driver as common step 1.\n+\n+2. Launch l3fwd::\n+\n+ <build_dir>/examples/dpdk-l3fwd -l 5-8 -n 8 --force-max-simd-bitwidth=512 \\\n+ -- -p 0x1 --config \"(0,0,5),(0,1,6),(0,2,7),(0,3,8)\" --rx-queue-size 1024 \\\n+ --tx-queue-size 1024\n+\n+3. Configure traffic generator to send traffic as common step 2.\n+\n+4. Record Test results as common step 3.\n", "prefixes": [ "V1", "1/9" ] }