From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by dpdk.org (Postfix) with ESMTP id 17FF8B4F2 for ; Fri, 13 Feb 2015 16:40:02 +0100 (CET) Received: from orsmga001.jf.intel.com ([10.7.209.18]) by orsmga101.jf.intel.com with ESMTP; 13 Feb 2015 07:39:59 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.09,571,1418112000"; d="scan'208";a="651797507" Received: from irvmail001.ir.intel.com ([163.33.26.43]) by orsmga001.jf.intel.com with ESMTP; 13 Feb 2015 07:39:57 -0800 Received: from sivswdev02.ir.intel.com (sivswdev02.ir.intel.com [10.237.217.46]) by irvmail001.ir.intel.com (8.14.3/8.13.6/MailSET/Hub) with ESMTP id t1DFduJF032334; Fri, 13 Feb 2015 15:39:56 GMT Received: from sivswdev02.ir.intel.com (localhost [127.0.0.1]) by sivswdev02.ir.intel.com with ESMTP id t1DFdtMx009134; Fri, 13 Feb 2015 15:39:55 GMT Received: (from jmcnam2x@localhost) by sivswdev02.ir.intel.com with id t1DFdq0P009130; Fri, 13 Feb 2015 15:39:52 GMT From: John McNamara To: dev@dpdk.org Date: Fri, 13 Feb 2015 15:39:45 +0000 Message-Id: <1423841989-9090-1-git-send-email-john.mcnamara@intel.com> X-Mailer: git-send-email 1.7.4.1 In-Reply-To: <1419266844-4848-1-git-send-email-bruce.richardson@intel.com> References: <1419266844-4848-1-git-send-email-bruce.richardson@intel.com> Subject: [dpdk-dev] [PATCH v2 0/4] DPDK ethdev callback support X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 13 Feb 2015 15:40:03 -0000 This patchset is for a small addition to the ethdev library, to add in support for callbacks at the RX and TX stages. This allows packet processing to be done on packets before they get returned to applications using rte_eth_rx_burst call. See the RFC cover letter for the use cases: http://dpdk.org/ml/archives/dev/2014-December/010491.html For the post-RFC version we spent some time investigating Stephen Hemminger's suggestion of using the userspace RCU (read-copy-update) library for SMP safety: http://urcu.so/ The default liburcu (which defaulted to liburcu-mb) requires the least interaction from the end user but showed a 25% drop in packet throughput in the callback sample app. The liburcu-qsbr (quiescent state) variant showed a 1% drop in packet throughput in the callback sample app. However it requires registered RCU threads in the program to periodically announce quiescent states. This makes it more difficult to implement for end user applications. For this release we will document that adding and removing callbacks is not thread safe. Note: Sample application documentation to follow in a patch update. Version 2 changes: * Added ABI versioning. * Doxygen clarifications. Version 1 changes: * Added callback removal functions. * Minor fixes. John McNamara (1): abi: Added rxtx callback functions to ABI versioning Richardson, Bruce (3): ethdev: rename callbacks field to intr_cbs ethdev: Add in data rxtx callback support examples: example showing use of callbacks. app/test/virtual_pmd.c | 2 +- examples/rxtx_callbacks/Makefile | 57 ++++++++ examples/rxtx_callbacks/basicfwd.c | 222 ++++++++++++++++++++++++++++++++ examples/rxtx_callbacks/basicfwd.h | 46 +++++++ lib/librte_ether/rte_ethdev.c | 175 ++++++++++++++++++++++++-- lib/librte_ether/rte_ethdev.h | 191 +++++++++++++++++++++++++++- lib/librte_ether/rte_ether_version.map | 4 + lib/librte_pmd_bond/rte_eth_bond_api.c | 2 +- 8 files changed, 685 insertions(+), 14 deletions(-) create mode 100644 examples/rxtx_callbacks/Makefile create mode 100644 examples/rxtx_callbacks/basicfwd.c create mode 100644 examples/rxtx_callbacks/basicfwd.h -- 1.7.4.1