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 58D542956 for ; Thu, 10 Mar 2016 18:19:42 +0100 (CET) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga104.fm.intel.com with ESMTP; 10 Mar 2016 09:19:41 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.24,316,1455004800"; d="scan'208";a="931087871" Received: from unknown (HELO Sent) ([10.217.248.141]) by orsmga002.jf.intel.com with SMTP; 10 Mar 2016 09:19:40 -0800 Received: by Sent (sSMTP sendmail emulation); Thu, 10 Mar 2016 18:19:38 +0100 From: Tomasz Kulasek To: dev@dpdk.org Date: Thu, 10 Mar 2016 18:19:33 +0100 Message-Id: <1457630375-3116-1-git-send-email-tomaszx.kulasek@intel.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1457607478-2184-1-git-send-email-tomaszx.kulasek@intel.com> References: <1457607478-2184-1-git-send-email-tomaszx.kulasek@intel.com> Subject: [dpdk-dev] [PATCH v4 0/2] add support for buffered tx to ethdev 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: Thu, 10 Mar 2016 17:19:42 -0000 Many sample apps include internal buffering for single-packet-at-a-time operation. Since this is such a common paradigm, this functionality is better suited to being implemented in the ethdev API. The new APIs in the ethdev library are: * rte_eth_tx_buffer_init - initialize buffer * rte_eth_tx_buffer - buffer up a single packet for future transmission * rte_eth_tx_buffer_flush - flush any unsent buffered packets * rte_eth_tx_buffer_set_err_callback - set up a callback to be called in case transmitting a buffered burst fails. By default, we just free the unsent packets. As well as these, an additional reference callbacks are provided, which frees the packets: * rte_eth_tx_buffer_drop_callback - silently drop packets (default behavior) * rte_eth_tx_buffer_count_callback - drop and update user-provided counter to track the number of dropped packets Due to the feedback from mailing list, that buffer management facilities in the user application are more preferable than API simplicity, we decided to move internal buffer table, as well as callback functions and user data, from rte_eth_dev/rte_eth_dev_data to the application space. It prevents ABI breakage and gives some more flexibility in the buffer's management such as allocation, dynamical size change, reuse buffers on many ports or after fail, and so on. The following steps illustrate how tx buffers can be used in application: 1) Initialization a) Allocate memory for a buffer struct rte_eth_dev_tx_buffer *buffer = rte_zmalloc_socket("tx_buffer", RTE_ETH_TX_BUFFER_SIZE(MAX_PKT_BURST), 0, socket_id); RTE_ETH_TX_BUFFER_SIZE(size) macro computes memory required to store "size" packets in buffer. b) Initialize allocated memory and set up default values. Threshold level must be lower than or equal to the MAX_PKT_BURST from 1a) rte_eth_tx_buffer_init(buffer, threshold); c) Set error callback (optional) rte_eth_tx_buffer_set_err_callback(buffer, callback_fn, userdata); 2) Store packet "pkt" in buffer and send them all to the queue_id on port_id when number of packets reaches threshold level set up in 1b) rte_eth_tx_buffer(port_id, queue_id, buffer, pkt); 3) Send all stored packets to the queue_id on port_id rte_eth_tx_buffer_flush(port_id, queue_id, buffer); 4) Flush buffer and free memory rte_eth_tx_buffer_flush(port_id, queue_id, buffer); ... rte_free(buffer); v4 changes: - added comments - chaged names of error callback and user data - changed order of function names in map file v3 changes: - error counter removed from tx buffer structure, now default behavior is silent drop of unsent packets - some names was changed in tx buffer structure to be more descriptive - two default calbacks are provided: rte_eth_tx_buffer_drop_callback and rte_eth_tx_buffer_count_callback v2 changes: - reworked to use new buffer model - buffer data and callbacks are removed from rte_eth_dev/rte_eth_dev_data, so this patch doesn't brake an ABI anymore - introduced RTE_ETH_TX_BUFFER macro and rte_eth_tx_buffer_init - buffers are not attached to the port-queue - buffers can be allocated dynamically during application work - size of buffer can be changed without port restart Tomasz Kulasek (2): ethdev: add buffered tx api examples: rework to use buffered tx examples/l2fwd-jobstats/main.c | 104 ++++------ examples/l2fwd-keepalive/main.c | 100 ++++------ examples/l2fwd/main.c | 104 ++++------ examples/l3fwd-acl/main.c | 92 ++++----- examples/l3fwd-power/main.c | 89 ++++----- examples/link_status_interrupt/main.c | 107 ++++------ .../client_server_mp/mp_client/client.c | 101 ++++++---- examples/multi_process/l2fwd_fork/main.c | 97 ++++----- examples/packet_ordering/main.c | 122 ++++++++---- examples/qos_meter/main.c | 61 ++---- lib/librte_ether/rte_ethdev.c | 46 +++++ lib/librte_ether/rte_ethdev.h | 206 +++++++++++++++++++- lib/librte_ether/rte_ether_version.map | 10 + 13 files changed, 697 insertions(+), 542 deletions(-) -- 1.7.9.5