From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wm0-f45.google.com (mail-wm0-f45.google.com [74.125.82.45]) by dpdk.org (Postfix) with ESMTP id 7AC1C914 for ; Sun, 31 Jul 2016 09:46:08 +0200 (CEST) Received: by mail-wm0-f45.google.com with SMTP id i5so203225657wmg.0 for ; Sun, 31 Jul 2016 00:46:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cloudius-systems-com.20150623.gappssmtp.com; s=20150623; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-transfer-encoding; bh=eV6Ofwuz2FhgNKCtS9lXGgHE6KPsLNRcra8QLsCsT7U=; b=hMAYMf1FlWc/4aMBSx9C1va5mLvm/mM320lQRP4dNSRX40aBgbE81B3gpdfdV8DiyX kQh10HYPXl71VoZ6P34z5j8xZmQopBAcmah8eT3BJ2X3OJ7yosn8/lipRgOYgA2HrmxN 7nGeVZgPl3MYI9Qc4zQCWT87bizQ1rhuEEm61TQiZCDldrbHHaeK4JQNrcyCUwfwzZhZ Med9GZURBus8IzROUdW0GD3OtGT6UD/Pb38R+F8gVVv27CyG0umwW4KEOA8tG0KYd27X K1LnVR3b2qnjdpm873bceH7bFFLnbzpdu2oFV+0mO5k0KFgoGWVRdLyYBuA2ZLXqITsV 7iMw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding; bh=eV6Ofwuz2FhgNKCtS9lXGgHE6KPsLNRcra8QLsCsT7U=; b=U7DYlrxAy4DT6olqffSSPp3r9XFOJO9QWb1GSMyJRlJP7C0I5pz65ci91/oUuhD5Y0 AgC+kHeOLJsXBYVRY66wCqYj+fNFsligVEhZKgp9QKfoh80VlPjPaRxMWtbD8VIINSKp nqmwj4HMiTRiRaDu3d3pLad7v5z0+Z+u44C6Cl4e4fV3dHCFxiFI9lepVHp/APsN5Cuq QN/8ufvr0zSU0JMbVRJ9WxholIEtux/4b5fM6HmexQuacWSabhnviMW5kHiwh75Ys1mD duqeVIFxHkkJVTif9mlaExWEDrOx5lAYto3tR+xVOs4bHwztgZUTN2Yjwgtfsn9WT6RB n/2w== X-Gm-Message-State: AEkoouttHQ+s1LXIoEowK+mXGU4yWvtBbDyOh96ttnshQiWY57QZzBILLWwKR88KZsF3AA== X-Received: by 10.28.166.140 with SMTP id p134mr8117701wme.21.1469951167960; Sun, 31 Jul 2016 00:46:07 -0700 (PDT) Received: from [10.0.0.172] ([37.142.229.250]) by smtp.googlemail.com with ESMTPSA id gg10sm24509688wjd.4.2016.07.31.00.46.05 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 31 Jul 2016 00:46:06 -0700 (PDT) To: Tomasz Kulasek , dev@dpdk.org References: <1469024691-58750-1-git-send-email-tomaszx.kulasek@intel.com> From: Vlad Zolotarov Message-ID: Date: Sun, 31 Jul 2016 10:46:05 +0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.2.0 MIME-Version: 1.0 In-Reply-To: <1469024691-58750-1-git-send-email-tomaszx.kulasek@intel.com> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit Subject: Re: [dpdk-dev] [PATCH] doc: announce ABI change for rte_eth_dev structure 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: Sun, 31 Jul 2016 07:46:08 -0000 On 07/20/2016 05:24 PM, Tomasz Kulasek wrote: > This is an ABI deprecation notice for DPDK 16.11 in librte_ether about > changes in rte_eth_dev and rte_eth_desc_lim structures. > > In 16.11, we plan to introduce rte_eth_tx_prep() function to do > necessary preparations of packet burst to be safely transmitted on > device for desired HW offloads (set/reset checksum field according to > the hardware requirements) and check HW constraints (number of segments > per packet, etc). > > While the limitations and requirements may differ for devices, it > requires to extend rte_eth_dev structure with new function pointer > "tx_pkt_prep" which can be implemented in the driver to prepare and > verify packets, in devices specific way, before burst, what should to > prevent application to send malformed packets. > > Also new fields will be introduced in rte_eth_desc_lim: nb_seg_max and > nb_mtu_seg_max, providing an information about max segments in TSO and > non TSO packets acceptable by device. > > Signed-off-by: Tomasz Kulasek Acked-by: Vlad Zolotarov > --- > doc/guides/rel_notes/deprecation.rst | 7 +++++++ > 1 file changed, 7 insertions(+) > > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst > index f502f86..485aacb 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -41,3 +41,10 @@ Deprecation Notices > * The mempool functions for single/multi producer/consumer are deprecated and > will be removed in 16.11. > It is replaced by rte_mempool_generic_get/put functions. > + > +* In 16.11 ABI changes are plained: the ``rte_eth_dev`` structure will be > + extended with new function pointer ``tx_pkt_prep`` allowing verification > + and processing of packet burst to meet HW specific requirements before > + transmit. Also new fields will be added to the ``rte_eth_desc_lim`` structure: > + ``nb_seg_max`` and ``nb_mtu_seg_max`` provideing information about number of > + segments limit to be transmitted by device for TSO/non-TSO packets.