From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by dpdk.org (Postfix) with ESMTP id 572905F24 for ; Mon, 18 Feb 2019 03:22:19 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga007.jf.intel.com ([10.7.209.58]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 17 Feb 2019 18:22:18 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.58,382,1544515200"; d="scan'208";a="115720872" Received: from unknown (HELO yaolei2.icx.intel.com) ([10.67.118.30]) by orsmga007.jf.intel.com with ESMTP; 17 Feb 2019 18:22:17 -0800 From: Lei To: dts@dpdk.org Cc: Lei Yao Date: Mon, 18 Feb 2019 09:46:53 +0000 Message-Id: <1550483213-68537-1-git-send-email-lei.a.yao@intel.com> X-Mailer: git-send-email 2.7.4 Subject: [dts] [Patch V1] test_plans: add test plan for exception path sample X-BeenThere: dts@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: test suite reviews and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 18 Feb 2019 02:22:19 -0000 From: Lei Yao This patch will add the test plan for exception path sample. The first patch will just include the performance test which is based on Ixia --- test_plans/exception_path_test_plan.rst | 98 +++++++++++++++++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 test_plans/exception_path_test_plan.rst diff --git a/test_plans/exception_path_test_plan.rst b/test_plans/exception_path_test_plan.rst new file mode 100644 index 0000000..d951275 --- /dev/null +++ b/test_plans/exception_path_test_plan.rst @@ -0,0 +1,98 @@ +.. Copyright (c) <2010-2019>, Intel Corporation + All rights reserved. + + Redistribution and use in source and binary forms, with or without + modification, are permitted provided that the following conditions + are met: + + - Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. + + - Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in + the documentation and/or other materials provided with the + distribution. + + - Neither the name of Intel Corporation nor the names of its + contributors may be used to endorse or promote products derived + from this software without specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS + FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE + COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, + INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR + SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, + STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) + ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED + OF THE POSSIBILITY OF SUCH DAMAGE. + +================================ +DPDK Exception Path Sample Tests +================================ + +Description +=========== + +The Exception Path sample application is a simple example that demonstrates +the use of the DPDK to set up an exception path for packets to go through +the Linux* kernel. This is done by using virtual TAP network interfaces. +These can be read from and written to by the DPDK application and appear +to the kernel as a standard network interface. + +The application creates two threads for each NIC port being used. One thread +reads from the port and writes the data unmodified to a thread-specific TAP +interface. The second thread reads from a TAP interface and writes the data +unmodified to the NIC port. + +Prerequisites +============= + +Two NIC ports and Iixa port are needed for this performance test. + + +Test Case: Exception Path Performance test +========================================== +1. Bind two NIC ports to DPDK driver, for example + usertools/dpdk-devbind.py --bind=vfio-pci device_bus_id1 device_bus_id2 + +2. Test Performance with 2 Cores and 1 NIC port. 1 core is for NIC RX side + and another core is for NIX TX side. For example: + ./examples/exception_path/build/exception_path -n 4 -c 0x03 -- -p 0x1 -i 0x01 -o 0x02 + +3. Configure the two TAP interface generated by the exception path sample and + add bridge for packets routing + ifconfig tap_dpdk_22 up + ifconfig tap_dpdk_23 up + brctl addbr "br_dpdk_00" + brctl addif br_dpdk_00 tap_dpdk_22 + brctl addif br_dpdk_00 tap_dpdk_23 + ifconfig br_dpdk_00 up + +4. From packets generator, send broadcast packets to the NIC and check the + throughput + +5. Similar to Step2~Step4, Test performance with 4 cores and 2 NIC ports. + ./examples/exception_path/build/exception_path -n 4 -c 0x0f -- -p 0x3 -i 0x03 -o 0x0C + ifconfig tap_dpdk_22 up + ifconfig tap_dpdk_23 up + brctl addbr "br_dpdk_00" + brctl addif br_dpdk_00 tap_dpdk_22 + brctl addif br_dpdk_00 tap_dpdk_23 + ifconfig br_dpdk_00 up + ifconfig tap_dpdk_24 up + ifconfig tap_dpdk_25 up + brctl addbr "br_dpdk_01" + brctl addif br_dpdk_01 tap_dpdk_24 + brctl addif br_dpdk_01 tap_dpdk_25 + ifconfig br_dpdk_01 up + +6. From packets generator, send broadcast packets to both 2 NICs then check the + aggregated throughput + + + + -- 2.7.4