From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by dpdk.space (Postfix) with ESMTP id 0BB72A00E6 for ; Tue, 16 Apr 2019 10:22:45 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id B36491B480; Tue, 16 Apr 2019 10:22:44 +0200 (CEST) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by dpdk.org (Postfix) with ESMTP id B95AF1B47E for ; Tue, 16 Apr 2019 10:22:42 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 16 Apr 2019 01:22:41 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.60,357,1549958400"; d="scan'208";a="165140600" Received: from unknown (HELO localhost.localdomain.sh.intel.com) ([10.240.176.135]) by fmsmga001.fm.intel.com with ESMTP; 16 Apr 2019 01:22:41 -0700 From: Peng Yuan To: dts@dpdk.org Cc: Peng Yuan Date: Tue, 16 Apr 2019 16:27:01 +0800 Message-Id: <1555403221-1799-1-git-send-email-yuan.peng@intel.com> X-Mailer: git-send-email 1.9.3 Subject: [dts] [PATCH v1] test_plans: Add af_xdp_test_plan.rst 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: , Errors-To: dts-bounces@dpdk.org Sender: "dts" Add af_xdp_test_plan.rst to test_plans Signed-off-by: Peng Yuan diff --git a/test_plans/af_xdp_test_plan.rst b/test_plans/af_xdp_test_plan.rst new file mode 100644 index 0000000..e0e8887 --- /dev/null +++ b/test_plans/af_xdp_test_plan.rst @@ -0,0 +1,118 @@ +.. Copyright (c) <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 PMD for AF_XDP Tests +========================= + +Description +=========== + +AF_XDP is a proposed faster version of AF_PACKET interface in Linux. +This test plan is to analysis the performance of DPDK PMD for AF_XDP. + +Prerequisites +============= + +1. Hardware:: + + I40e 25G*2 + enp216s0f0 <---> IXIA_port_0 + enp216s0f1 <---> IXIA_port_0 + +2. The NIC is located on the socket 1, so we define the cores of socket 1. + +3. Take the kernel >= v5.1-rc1, build kernel and replace your host + kernel with it. + Update compiler to the proper version. + Make sure you turn on XDP sockets when compiling:: + + Networking support --> + Networking options --> + [ * ] XDP sockets + +4. Build libbpf in tools/lib/bpf:: + + cd tools/lib/bpf + make + + Then copy the libbpf.a and libbpf.so to /usr/lib64 + +5. Set DUT port only has one queue:: + + ethtool -L enp216s0f0 combined 1 + ethtool -L enp216s0f1 combined 1 + +6. Explicitly enable AF_XDP pmd by adding below line to + config/common_linux:: + + CONFIG_RTE_LIBRTE_PMD_AF_XDP=y + +Test case 1: 1 port, 1 kernel core, 1 user core +=============================================== + +1. Start the testpmd:: + + ./x86_64-native-linuxapp-gcc/app/testpmd -l 30,31 --no-pci -n 6 \ + --vdev net_af_xdp0,iface=enp216s0f0,queue=0 --file-prefix=port0 \ + --socket-mem 1024,1024 -- -a --nb-cores=1 -i --rxq=1 --txq=1 \ + --port-topology=loop + +2. Assign the kernel core:: + + ./set_irq_affinity 33 enp216s0f0 + +3. Send packet with packet generator with different packet size, + from 64 bytes to 1518 bytes, check the throughput. + +Test case 2: 2 ports, 2 kernel cores, 1 user cores +================================================== + +1. Start the testpmd:: + + ./x86_64-native-linuxapp-gcc/app/testpmd -l 30,32 --no-pci -n 6 \ + --vdev net_af_xdp0,iface=enp216s0f0,queue=0 --file-prefix=port0 \ + --socket-mem 1024,1024 -- -a --nb-cores=1 -i --rxq=1 --txq=1 \ + --port-topology=loop + + ./x86_64-native-linuxapp-gcc/app/testpmd -l 31,33 --no-pci -n 6 \ + --vdev net_af_xdp1,iface=enp216s0f1,queue=0 --file-prefix=port1 \ + --socket-mem 1024,1024 -- -a --nb-cores=1 -i --rxq=1 --txq=1 \ + --port-topology=loop + +2. Assign the kernel core:: + + ./set_irq_affinity 35 enp216s0f0 + ./set_irq_affinity 36 enp216s0f1 + +3. Send packet with packet generator with different packet size, + from 64 bytes to 1518 bytes, check the throughput. -- 2.14.3