From patchwork Tue Apr 2 15:46:52 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Xiaolong Ye X-Patchwork-Id: 52120 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 07BCC4C90; Tue, 2 Apr 2019 17:51:52 +0200 (CEST) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by dpdk.org (Postfix) with ESMTP id F0A5E4C8F for ; Tue, 2 Apr 2019 17:51:49 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga006.jf.intel.com ([10.7.209.51]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 02 Apr 2019 08:51:49 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.60,301,1549958400"; d="scan'208";a="132331459" Received: from yexl-server.sh.intel.com ([10.67.110.206]) by orsmga006.jf.intel.com with ESMTP; 02 Apr 2019 08:51:45 -0700 From: Xiaolong Ye To: dev@dpdk.org, Stephen Hemminger , Ferruh Yigit Cc: Qi Zhang , Karlsson Magnus , Topel Bjorn , Maxime Coquelin , Luca Boccassi , Bruce Richardson , Ananyev Konstantin , David Marchand , Andrew Rybchenko , Olivier Matz , Xiaolong Ye Date: Tue, 2 Apr 2019 23:46:52 +0800 Message-Id: <20190402154653.711-1-xiaolong.ye@intel.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20190301080947.91086-1-xiaolong.ye@intel.com> References: <20190301080947.91086-1-xiaolong.ye@intel.com> Subject: [dpdk-dev] [PATCH v9 0/1] Introduce AF_XDP PMD X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Overview ======== This patchset adds a new PMD driver for AF_XDP which is a proposed faster version of AF_PACKET interface in Linux, see below links [1] [2] for details of AF_XDP introduction: AF_XDP roadmap ============== - AF_XDP is included in upstream kernel since 4.18, and AF_XDP support in libbpf has been merged in v5.1-rc1. - Now i40e and ixgbe drivers have supported zero copy mode. Change logs =========== V9: - adjust header files order according to Stephen's suggestion v8: - address Ferruh's comments on V7 - replace posix_memalign with rte_memzone_reserve_aligned to get better performance - keep the first patch only as Oliver suggested as zero copy part implementation is still in suspense, we may provide the related patch later. v7: - mention mtu limitation in af_xdp.rst - fix the vdev name in af_xdp.rst V6: - remove the newline in AF_XDP_LOG definition to avoid double new lines issue. - rename MEMPOOL_F_PAGE_ALIGN to MEMPOOL_CHUNK_F_PAGE_ALIGN. V5: - disable AF_XDP pmd by default due to it requires kernel more recent than minimum kernel version supported by DPDK - address other review comments of Maxime V4: - change vdev name to net_af_xdp - adopt dynamic log type for all logging - Fix other style issues raised by Stephen V3: - Fix all style issues pointed by Stephen, Mattias, David. - Drop the testpmd change as we'll adopt Jerin's suggestion to add a new mempool driver to handle the application use of AF_XDP's zero copy feature. V2: - Fix a NULL pointer reference crash issue - Fix txonly stop sending traffic in zc mode - Refactor rte_mbuf.c to avoid ABI breakage. - Fix multiple style issues pointed by Ferruh, David, Stephen, Luca. changes vs RFC sent by Qi last Aug: - Re-work base on AF_XDP's interface changes since the new libbpf has provided higher-level APIs that hide many of the details of the AP_XDP uapi. After the rework, it helps to reduce 300+ lines of code. - multi-queues is not supported due to current libbpf doesn't support multi-sockets on a single umem. - No extra steps to load xdp program manually, since the current behavior of libbpf would load a default xdp program when user calls xsk_socket__create. userspace application only needs to handle the cleanup. How to try ========== 1. take the kernel >= v5.1-rc1, build kernel and replace your host kernel with it. make sure you turn on XDP sockets when compiling Networking support --> Networking options --> [ * ] XDP sockets 2. build libbpf in tools/lib/bpf, and copy the libbpf.a and libbpf.so to /usr/lib64 cd tools/lib/bpf make 3. ethtool -L enp59s0f0 combined 1 4. extra step to build dpdk explicitly enable AF_XDP pmd by adding below line to config/common_linux CONFIG_RTE_LIBRTE_PMD_AF_XDP=y 5. start testpmd ./build/app/testpmd -c 0xc -n 4 --vdev net_af_xdp,iface=enp59s0f0,queue=0 -- -i --rxq=1 --txq=1 in this case, default xdp program will be loaded and linked to queue 0 of enp59s0f0, network traffics travel to queue 0 will be redirected to af_xdp socket. Xiaolong Ye (1): net/af_xdp: introduce AF XDP PMD driver MAINTAINERS | 7 + config/common_base | 5 + doc/guides/nics/af_xdp.rst | 48 + doc/guides/nics/features/af_xdp.ini | 11 + doc/guides/nics/index.rst | 1 + doc/guides/rel_notes/release_19_05.rst | 7 + drivers/net/Makefile | 1 + drivers/net/af_xdp/Makefile | 32 + drivers/net/af_xdp/meson.build | 21 + drivers/net/af_xdp/rte_eth_af_xdp.c | 956 ++++++++++++++++++ drivers/net/af_xdp/rte_pmd_af_xdp_version.map | 3 + drivers/net/meson.build | 1 + mk/rte.app.mk | 1 + 13 files changed, 1094 insertions(+) create mode 100644 doc/guides/nics/af_xdp.rst create mode 100644 doc/guides/nics/features/af_xdp.ini create mode 100644 drivers/net/af_xdp/Makefile create mode 100644 drivers/net/af_xdp/meson.build create mode 100644 drivers/net/af_xdp/rte_eth_af_xdp.c create mode 100644 drivers/net/af_xdp/rte_pmd_af_xdp_version.map