From patchwork Fri Nov 11 06:48:12 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yingya Han X-Patchwork-Id: 119755 Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id 2693CA0542; Fri, 11 Nov 2022 07:48:20 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 1F28540141; Fri, 11 Nov 2022 07:48:20 +0100 (CET) Received: from mga18.intel.com (mga18.intel.com [134.134.136.126]) by mails.dpdk.org (Postfix) with ESMTP id 7E390400EF for ; Fri, 11 Nov 2022 07:48:18 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1668149298; x=1699685298; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=y5iUzEyNy+IKLoltwQif+2lIzhQhbJ/rueAo+dc+93E=; b=U2WjDpQrpO1/98ZeoZS+q/G0hV2gBI741ub9Te1c/FUtBIj67C58X6ht mxGW5LBc7QH960I6yfapqIXo1LeqXdXz7NU4G8vfZkmIVd3ecItkaWCXH SNnLy5TUz0crFKmKZojooq/Dv/Y80yz3ozOS1fTy6yESzEOPiZHDSvrwk IQdgxwVJItI0ukvteVtHiE7iok7YYGMHkMnXfq7oJrwBEoR4sP1Y3XnV1 oeESoQl/eh2hyriWOU5YNIn6KQzbgbDx37U8liibHBCnp2cz84InO823t FqkngVSgDL6xvVz5Et5kRJzCVdUsquHii+khj5qwdQL93K3o8EUm7xgUQ w==; X-IronPort-AV: E=McAfee;i="6500,9779,10527"; a="294896662" X-IronPort-AV: E=Sophos;i="5.96,156,1665471600"; d="scan'208";a="294896662" Received: from orsmga008.jf.intel.com ([10.7.209.65]) by orsmga106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 10 Nov 2022 22:48:17 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6500,9779,10527"; a="668719810" X-IronPort-AV: E=Sophos;i="5.96,156,1665471600"; d="scan'208";a="668719810" Received: from dpdk-lijuan-icelake4.sh.intel.com ([10.67.119.147]) by orsmga008.jf.intel.com with ESMTP; 10 Nov 2022 22:48:16 -0800 From: Yingya Han To: dts@dpdk.org Cc: Yingya Han Subject: [dts][PATCH V1]test_plans: add l3fwd_lpm_ipv4 test plan Date: Fri, 11 Nov 2022 06:48:12 +0000 Message-Id: <20221111064812.301479-1-yingyax.han@intel.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 X-BeenThere: dts@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: test suite reviews and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dts-bounces@dpdk.org Signed-off-by: Yingya Han --- test_plans/index.rst | 1 + test_plans/l3fwd_lpm_ipv4_test_plan.rst | 148 ++++++++++++++++++++++++ 2 files changed, 149 insertions(+) create mode 100644 test_plans/l3fwd_lpm_ipv4_test_plan.rst diff --git a/test_plans/index.rst b/test_plans/index.rst index 570e1c35..b4efd39a 100644 --- a/test_plans/index.rst +++ b/test_plans/index.rst @@ -96,6 +96,7 @@ The following are the test plans for the DPDK DTS automated test system. l2fwd_test_plan l2tp_esp_coverage_test_plan l3fwd_test_plan + l3fwd_lpm_ipv4_test_plan.rst l3fwd_func_test_plan l3fwdacl_test_plan large_vf_test_plan diff --git a/test_plans/l3fwd_lpm_ipv4_test_plan.rst b/test_plans/l3fwd_lpm_ipv4_test_plan.rst new file mode 100644 index 00000000..42784dd0 --- /dev/null +++ b/test_plans/l3fwd_lpm_ipv4_test_plan.rst @@ -0,0 +1,148 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright(c) 2022 Intel Corporation + +================================================ +L3 forwarding test in LPM mode with IPV4 packets +================================================ + +This document provides the plan for testing the performance of Intel Ethernet Controller. +The Layer-3 Forwarding performance results are produced using ``l3fwd`` application. +For detail test plan, please refer to ``l3fwd_test_plan.rst``. + +Prerequisites +============= + +Topology +----------- +It requires at least 1 port connected traffic generator:: + Port0 --- TG0 + +2 ports:: + Port0 --- TG0 + Port1 --- TG1 + +4 ports:: + Port0 --- TG0 + Port1 --- TG1 + Port2 --- TG2 + Port3 --- TG3 + +Hardware +-------- +This suite focus on l3fwd application, so any standard Ethernet Network Adapter is qualified. + +Software +-------- +dpdk: git clone http://dpdk.org/git/dpdk +trex: git clone http://trex-tgn.cisco.com/trex/release/v2.93.tar.gz + + +Test Case +========= +The test case check the throughput result with lpm mode and ipv4, in the case, +we will send the bi-direction flows with line rate, then we can check the +passthrough rate. + +The l3fwd application has a number of command line options, here list the key options will be tested:: + + ./dpdk-l3fwd [EAL options] -- -p PORTMASK + [--force-max-simd-bitwidth=max-simd-bitwidth] + --config(port,queue,lcore)[,(port,queue,lcore)] + [--rx-queue-size NPKTS] + [--tx-queue-size NPKTS] + [--parse-ptype] + [-L]|[-E] + ... + Note: + --force-max-simd-bitwidth: This setting is used to determine the vector path for component selection. + And the default is avx2. + --rx-queue-size: Rx queue size in decimal and default is 1024. + --tx-queue-size: Tx queue size in decimal and default is 1024. + --parse-ptype: Optional, set to use software to analyze packet type. + Without this option, hardware will check the packet type. + [-L]|[-E]: L3fwd uses the parameters "-L" and "-E" to correspond to LPM and EM modes respectively. + And the default is LPM mode. + +Common Steps +------------ +1. Bind tested ports to vfio-pci:: + + #./usertools/dpdk-devbind.py -s + 0000:17:00.0 'Device 1592' if=ens5f0 drv=ice unused=vfio-pci + #./usertools/dpdk-devbind.py -b vfio-pci + #./usertools/dpdk-devbind.py -b vfio-pci 0000:17:00.0 + +2. Configure traffic generator to send traffic + + Routing table for IPv4 packets + - In LPM mode, the LPM table used for packet routing is: + + +-------+-----------------------+ + | # | LPM prefix (IP/length)| + +=======+=======================+ + | 0 | 198.18.0.0/24 | + +-------+-----------------------+ + | 1 | 198.18.1.0/24 | + +-------+-----------------------+ + | 2 | 198.18.2.0/24 | + +-------+-----------------------+ + | 3 | 198.18.3.0/24 | + +-------+-----------------------+ + + The flows need to be configured and started by the traffic generator: + - IPv4 packets + + +------+---------+------------+---------+ + | Flow | Traffic | IPv4 | IPv4 | + | | Gen. | Dst. | Src. | + | | Port | Address | Address | + +======+=========+============+=========+ + | 1 | TG0 | 198.18.1.1 | Any Ip | + +------+---------+------------+---------+ + | 2 | TG1 | 198.18.0.1 | Any Ip | + +------+---------+------------+---------+ + | 3 | TG2 | 198.18.3.1 | Any Ip | + +------+---------+------------+---------+ + | 4 | TG3 | 198.18.2.1 | Any Ip | + +------+---------+------------+---------+ + + Set the packet length : 64 bytes-1518 bytes + The IPV4 Src Address increase with the num 1024. + +3. Test result table + + +-----------+------------+-------------+---------+ + | Fwd_core | Frame Size | Throughput | Rate | + +===========+============+=============+=========+ + | 1C/1T | 64 | xxxxx Mpps | xxx % | + +-----------+------------+-------------+---------+ + | 1C/1T | ... | xxxxx Mpps | xxx % | + +-----------+------------+-------------+---------+ + | 2C/2T | 64 | xxxxx Mpps | xxx % | + +-----------+------------+-------------+---------+ + | 2C/2T | ... | xxxxx Mpps | xxx % | + +-----------+------------+-------------+---------+ + | 4C/4T | 64 | xxxxx Mpps | xxx % | + +-----------+------------+-------------+---------+ + | 4C/4T | ... | xxxxx Mpps | xxx % | + +-----------+------------+-------------+---------+ + | 8C/8T | 64 | xxxxx Mpps | xxx % | + +-----------+------------+-------------+---------+ + | 8C/8T | ... | xxxxx Mpps | xxx % | + +-----------+------------+-------------+---------+ + + +Test Case: test_perf_throughput_ipv4_lpm +---------------------------------------- + +1. Bind PF ports to dpdk driver as common step 1. + +2. Launch l3fwd:: + + /examples/dpdk-l3fwd -l 5-8 -n 8 --force-max-simd-bitwidth=512 \ + -- -p 0x1 --config "(0,0,5),(0,1,6),(0,2,7),(0,3,8)" --rx-queue-size 1024 \ + --tx-queue-size 1024 + +3. Configure traffic generator to send traffic as common step 2. + +4. Record Test results as common step 3.