From mboxrd@z Thu Jan 1 00:00:00 1970 From: Olivier Matz Subject: Re: rte_ring features in use (or not) Date: Tue, 31 Jan 2017 11:53:49 +0100 Message-ID: <20170131115349.7efadb09@platinum> References: <20170125121456.GA24344@bricha3-MOBL3.ger.corp.intel.com> <20170125142052.7989e0ec@glumotte.dev.6wind.com> <20170125135404.GA24352@bricha3-MOBL3.ger.corp.intel.com> <20170125144809.GA26936@bricha3-MOBL3.ger.corp.intel.com> <647B0F09-667B-41D2-A8E1-964F71D4C365@intel.com> <20170125165740.GA33248@bricha3-MOBL3.ger.corp.intel.com> <2601191342CEEE43887BDE71AB9772583F10CD7E@irsmsx105.ger.corp.intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Cc: "Richardson, Bruce" , "Wiles, Keith" , "dev@dpdk.org" To: "Ananyev, Konstantin" Return-path: Received: from mail-wm0-f43.google.com (mail-wm0-f43.google.com [74.125.82.43]) by dpdk.org (Postfix) with ESMTP id 2FDBB2B98 for ; Tue, 31 Jan 2017 11:53:53 +0100 (CET) Received: by mail-wm0-f43.google.com with SMTP id v77so87619664wmv.0 for ; Tue, 31 Jan 2017 02:53:53 -0800 (PST) In-Reply-To: <2601191342CEEE43887BDE71AB9772583F10CD7E@irsmsx105.ger.corp.intel.com> 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 Wed, 25 Jan 2017 17:29:18 +0000, "Ananyev, Konstantin" wrote: > > > > Bonus question: > > > > * Do we know how widely used the enq_bulk/deq_bulk functions > > > > are? They are useful for unit tests, so they do have uses, but > > > > I think it would be good if we harmonized the return values > > > > between bulk and burst functions. Right now: > > > > enq_bulk - only enqueues all elements or none. Returns 0 > > > > for all, or negative error for none. > > > > enq_burst - enqueues as many elements as possible. Returns > > > > the number enqueued. > > > > > > I do use the apis in pktgen and the difference in return values > > > has got me once. Making them common would be great, but the > > > problem is > > backward compat to old versions I would need to have an ifdef in > > pktgen now. So it seems like we moved the problem to the > > application. > > > > > > > Yes, an ifdef would be needed, but how many versions of DPDK back > > do you support? Could the ifdef be removed again after say, 6 > > months? > > > I would like to see the old API kept and a new API with the new > > > behavior. I know it adds another API but one of the API would be > > > nothing > > more than wrapper function if not a macro. > > > > > > Would that be more reasonable then changing the ABI? > > > > Technically, this would be an API rather than ABI change, since the > > functions are inlined in the code. However, it's not the only API > > change I'm looking to make here - I'd like to have all the > > functions start returning details of the state of the ring, rather > > than have the watermarks facility. If we add all new functions for > > this and keep the old ones around, we are just increasing our > > maintenance burden. > > > > I'd like other opinions here. Do we see increasing the API surface > > as the best solution, or are we ok to change the APIs of a key > > library like the rings one? > > I am ok with changing API to make both _bulk and _burst return the > same thing. Konstantin I agree that the _bulk() functions returning 0 or -err can be confusing. But it has at least one advantage: it explicitly shows that if user ask for N enqueues/dequeues, it will either get N or 0, not something between. Changing the API of the existing _bulk() functions looks a bit dangerous to me. There's probably a lot of code relying on the ring API, and changing its behavior may break it. I'd prefer to deprecate the old _bulk and _burst functions, and introduce a new api, maybe something like: rte_ring_generic_dequeue(ring, objs, n, behavior, flags) -> return nb_objs or -err Olivier