From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by dpdk.org (Postfix) with ESMTP id 08CFE2F7D for ; Thu, 14 Sep 2017 20:33:15 +0200 (CEST) Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 14 Sep 2017 11:33:14 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.42,394,1500966000"; d="scan'208";a="151942368" Received: from fyigit-mobl1.ger.corp.intel.com (HELO [10.237.220.57]) ([10.237.220.57]) by fmsmga006.fm.intel.com with ESMTP; 14 Sep 2017 11:33:13 -0700 To: Jiayu Hu , dev@dpdk.org Cc: konstantin.ananyev@intel.com, mark.b.kavanagh@intel.com, jianfeng.tan@intel.com References: <1504598270-60080-1-git-send-email-jiayu.hu@intel.com> <1505184211-36728-1-git-send-email-jiayu.hu@intel.com> <1505184211-36728-2-git-send-email-jiayu.hu@intel.com> From: Ferruh Yigit Message-ID: Date: Thu, 14 Sep 2017 19:33:12 +0100 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.3.0 MIME-Version: 1.0 In-Reply-To: <1505184211-36728-2-git-send-email-jiayu.hu@intel.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit Subject: Re: [dpdk-dev] [PATCH v3 1/5] gso: add Generic Segmentation Offload API framework 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: , X-List-Received-Date: Thu, 14 Sep 2017 18:33:16 -0000 On 9/12/2017 3:43 AM, Jiayu Hu wrote: > Generic Segmentation Offload (GSO) is a SW technique to split large > packets into small ones. Akin to TSO, GSO enables applications to > operate on large packets, thus reducing per-packet processing overhead. > > To enable more flexibility to applications, DPDK GSO is implemented > as a standalone library. Applications explicitly use the GSO library > to segment packets. This patch introduces the GSO API framework to DPDK. > > The GSO library provides a segmentation API, rte_gso_segment(), for > applications. It splits an input packet into small ones in each > invocation. The GSO library refers to these small packets generated > by rte_gso_segment() as GSO segments. Each of the newly-created GSO > segments is organized as a two-segment MBUF, where the first segment is a > standard MBUF, which stores a copy of packet header, and the second is an > indirect MBUF which points to a section of data in the input packet. > rte_gso_segment() reduces the refcnt of the input packet by 1. Therefore, > when all GSO segments are freed, the input packet is freed automatically. > Additionally, since each GSO segment has multiple MBUFs (i.e. 2 MBUFs), > the driver of the interface which the GSO segments are sent to should > support to transmit multi-segment packets. > > Signed-off-by: Jiayu Hu > Signed-off-by: Mark Kavanagh > --- > config/common_base | 5 ++ > lib/Makefile | 2 + > lib/librte_gso/Makefile | 49 ++++++++++++++ > lib/librte_gso/rte_gso.c | 50 ++++++++++++++ > lib/librte_gso/rte_gso.h | 133 +++++++++++++++++++++++++++++++++++++ > lib/librte_gso/rte_gso_version.map | 7 ++ > mk/rte.app.mk | 1 + Can you please update documentation for new library: - library documentation "doc/guides/prog_guide/xxx.rst" - api documentation: doc/api/doxy-api.conf, doc/api/doxy-api-index.md - release notes update to announce new library - release notes, "Shared Library Versions" section with new library. <...>