From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 3CB41A04B1; Tue, 25 Aug 2020 18:59:27 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 8E6DBB62; Tue, 25 Aug 2020 18:59:26 +0200 (CEST) Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by dpdk.org (Postfix) with ESMTP id 90C9DA3 for ; Tue, 25 Aug 2020 18:59:24 +0200 (CEST) IronPort-SDR: 08ggXL63ZquCeS9aJ227B1qM4S+gITkAEq3fQ0SfgE5HjwBVzVvmkrWQc0p+5gK+LdSLzuts8P K/Sb69RHVqeA== X-IronPort-AV: E=McAfee;i="6000,8403,9723"; a="156148326" X-IronPort-AV: E=Sophos;i="5.76,353,1592895600"; d="scan'208";a="156148326" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga004.jf.intel.com ([10.7.209.38]) by orsmga103.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 25 Aug 2020 09:59:23 -0700 IronPort-SDR: GPyunxILfvWwFpN77K0lR5jxyvXYzsg0NYZtqRWrpRjoRqrtjr3AEjr4yUgyvGPwZJdl1kfzrw 6A7DAIASVPng== X-IronPort-AV: E=Sophos;i="5.76,353,1592895600"; d="scan'208";a="443698374" Received: from fyigit-mobl.ger.corp.intel.com (HELO [10.252.20.100]) ([10.252.20.100]) by orsmga004-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 25 Aug 2020 09:59:15 -0700 To: Nithin Dabilpuram , "Dumitrescu, Cristian" , "jerinj@marvell.com" Cc: Bruce Richardson , Thomas Monjalon , Jerin Jacob , Luca Boccassi , Nithin Dabilpuram , "Singh, Jasvinder" , Andrew Rybchenko , "dev@dpdk.org" , "kkanas@marvell.com" , "Kinsella, Ray" , Neil Horman , Kevin Traynor , David Marchand References: <20200330160019.29674-1-ndabilpuram@marvell.com> <20200428144535.GC1897@bricha3-MOBL.ger.corp.intel.com> <19c8b69f68bcdb7ac23126e63456223f7aff0465.camel@debian.org> <1923738.gORTcIGjah@thomas> <20200429090354.GA1903@bricha3-MOBL.ger.corp.intel.com> <74165680-6b05-a7c3-21a7-c66372b462e4@intel.com> <20200501131634.GA24835@outlook.office365.com> From: Ferruh Yigit Autocrypt: addr=ferruh.yigit@intel.com; keydata= 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 dYuOYKR9nbPv+2zK9pwwQ2NXbUBystaGyQ== Message-ID: <1a6121c7-58d6-a2e4-e93d-fe50dfd58bb0@intel.com> Date: Tue, 25 Aug 2020 17:59:10 +0100 MIME-Version: 1.0 In-Reply-To: <20200501131634.GA24835@outlook.office365.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit Subject: Re: [dpdk-dev] [EXT] Re: [PATCH v4 1/4] ethdev: add tm support for shaper config in pkt mode 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" On 5/1/2020 2:16 PM, Nithin Dabilpuram wrote: > On Fri, May 01, 2020 at 11:27:02AM +0100, Ferruh Yigit wrote: >> External Email >> >> ---------------------------------------------------------------------- >> On 4/29/2020 10:03 AM, Bruce Richardson wrote: >>> On Wed, Apr 29, 2020 at 09:45:44AM +0100, Dumitrescu, Cristian wrote: >>>> >>>> >>>>> -----Original Message----- >>>>> From: Thomas Monjalon >>>>> Sent: Tuesday, April 28, 2020 4:54 PM >>>>> To: Jerin Jacob ; Dumitrescu, Cristian >>>>> >>>>> Cc: Richardson, Bruce ; Yigit, Ferruh >>>>> ; Luca Boccassi ; Nithin >>>>> Dabilpuram ; Singh, Jasvinder >>>>> ; Andrew Rybchenko >>>>> ; dev@dpdk.org; jerinj@marvell.com; >>>>> kkanas@marvell.com; Nithin Dabilpuram ; >>>>> Kinsella, Ray ; Neil Horman >>>>> ; Kevin Traynor ; David >>>>> Marchand >>>>> Subject: Re: [dpdk-dev] [PATCH v4 1/4] ethdev: add tm support for shaper >>>>> config in pkt mode >>>>> >>>>> 28/04/2020 17:04, Luca Boccassi: >>>>>> On Tue, 2020-04-28 at 15:45 +0100, Bruce Richardson wrote: >>>>>>> On Tue, Apr 28, 2020 at 03:06:20PM +0100, Ferruh Yigit wrote: >>>>>>>> On 4/27/2020 5:59 PM, Jerin Jacob wrote: >>>>>>>>> On Mon, Apr 27, 2020 at 10:19 PM Ferruh Yigit >>>>> wrote: >>>>>>>>>> On 4/27/2020 5:29 PM, Jerin Jacob wrote: >>>>>>>>>>> On Mon, Apr 27, 2020 at 9:42 PM Ferruh Yigit >>>>> wrote: >>>>>>>>>>>> On 4/27/2020 10:19 AM, Dumitrescu, Cristian wrote: >>>>>>>>>>>>> From: Yigit, Ferruh >>>>>>>>>>>>>> On 4/24/2020 11:28 AM, Dumitrescu, Cristian wrote: >>>>>>>>>>>>>>> From: Nithin Dabilpuram >>>>>>>>>>>>>>>> This patch also updates tm port/level/node capability >>>>> structures with >>>>>>>>>>>>>>>> exiting features of scheduler wfq packet mode, >>>>> scheduler wfq byte mode >>>>>>>>>>>>>>>> and private/shared shaper byte mode. >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> SoftNIC PMD is also updated with new capabilities. >>>>> [...] >>>>>>>>>>>>>> Hi Nithin, >>>>>>>>>>>>>> >>>>>>>>>>>>>> It looks like patch is causing ABI break, I am getting following >>>>> warning [1], >>>>>>>>>>>>>> can you please check? >>>>>>>>>>>>>> >>>>>>>>>>>>>> [1] >>>>>>>>>>>>>> https://urldefense.proofpoint.com/v2/url?u=https-3A__pastebin.com_XYNFg14u&d=DwIDaQ&c=nKjWec2b6R0mOyPaz7xtfQ&r=FZ_tPCbgFOh18zwRPO9H0yDx8VW38vuapifdDfc8SFQ&m=ej5sP3-cEhEoCTZOia-QivXqgljtzBcMLtZGs-5c-Uc&s=B8z_5mQ2xO3C1izjmRe2zBApMrCUcW6KcAN-adglhJQ&e= >>>>>>>>>>>>> >>>>>>>>>>>>> Hi Ferruh, >>>>>>>>>>>>> >>>>>>>>>>>>> The RTE_TM API is marked as experimental, >>>>>>>>>>>>> but it looks that this was not correctly marked >>>>>>>>>>>>> when __rte_experimental ABI checker was introduced. >>>>>>>>>>>>> >>>>>>>>>>>>> It is marked as experimental at the top of the rte_tm.h, >>>>>>>>>>>>> similarly to other APIs introduced around same time, >>>>>>>>>>>>> but it was not correctly picked up by the ABI check procedure >>>>>>>>>>>>> when later introduced, so __rte_experimental was not added >>>>> to every function. >>>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> :( >>>>>>>>>>>> >>>>>>>>>>>> Is it time to mature them? >>>>>>>>>>>> >>>>>>>>>>>> As you said they are not marked as experimental both in header >>>>> file (function >>>>>>>>>>>> declarations) and .map file. >>>>>>>>>>>> >>>>>>>>>>>> The problem is, they are not marked as experimental in >>>>> DPDK_20.0 ABI (v19.11), >>>>>>>>>>>> so marking them as experimental now will break the ABI. Not >>>>> sure what to do, >>>>>>>>>>>> cc'ed a few ABI related names for comment. >>>>>>>>>>>> >>>>>>>>>>>> For me, we need to proceed as the experimental tag removed >>>>> and APIs become >>>>>>>>>>>> mature starting from v19.11, since this is what happened in >>>>> practice, and remove >>>>>>>>>>>> a few existing being experimental references in the doxygen >>>>> comments. >>>>>>>>>>> >>>>>>>>>>> I think, accidentally we can not make a library as NON- >>>>> experimental. >>>>>>>>>>> TM never went through experimental to mature transition(see git >>>>> log >>>>>>>>>>> lib/librte_ethdev/rte_tm.h) >>>>>>>>>>> It was a bug to not mark as experimental in each function in the >>>>> ABI process. >>>>>>>>>>> Some of the features like packet marking are not even >>>>> implemented by any HW. >>>>>>>>>>> I think, we can make API stable only all the features are >>>>> implemented >>>>>>>>>>> by one or two HW. >>>>> >>>>> Yes this is what was decided one or two years ago I think. >>>>> But rte_tm API was introduced 3 years ago and is implemented by 6 PMDs. >>>>> >>>>> >>>>> >>>>>>>>>> Fair enough, specially if the API is not ready yet. >>>>>>>>>> >>>>>>>>>> But they were part of stable ABI, and marking them as experimental >>>>> now will >>>>>>>>>> break the old applications using these APIs. >>>>>>>>> >>>>>>>>> it is still marked as EXPERIMENTAL everywhere and API is not ready >>>>> yet. >>>>> >>>>> rte_tm is implemented in 6 PMDs. >>>>> >>>>> >>>>>>>> Existing experimental marks are text only for human parsing. >>>>>>>> >>>>>>>> The compiler attribute and build time checks are missing, and the >>>>> symbol in the >>>>>>>> binary doesn't have experimental tag. Our scripts and automated >>>>> checks won't >>>>>>>> detect it as experimental. >>>>>>>> >>>>>>>> My point is just having experimental comment in header file is not >>>>> enough to >>>>>>>> qualify the APIs as experimental. >>>>>>>> >>>>>>>>> Anyway, we need to break the ABI to make it work on various HW. >>>>> >>>>> Yes this is why I was asking in 19.11 to check our API, >>>>> in order to avoid such situation. >>>>> >>>>> >>>>>>>>> I am not sure what to do? >>>>> >>>>> Either manage ABI versioning, or wait 20.11. >>>>> >>>>> >>>>>>>>> IMO, We need to send a patch as Fixes: for the bug of not adding >>>>>>>>> __rte_experimental in each function. >>>>> >>>>> No, this is wrong. >>>>> >>>> >>>> Why exactly is this wrong? This is the gap that caused the current discussion, right? >>>> >>> It's wrong for this release, since we can't change things from stable back >>> to experimental. Any such patch will have to wait for 20.11, as agreed in >>> the discussion. >>> >> >> Deferring the patchet for this release. >> >> Reminder that if the option "to mark rte_tm_* as experimental in v20.11" >> selected, requires deprecation notice before v20.11. > > Thanks Ferruh for reminder. I'll send a deprecation notice patch for the same. > Hi Nithin Kumar, Cristian, Jerin, Who is working on updating APIs as experimental? We need that patch to proceed with this one.