From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by dpdk.space (Postfix) with ESMTP id B0646A05D3 for ; Wed, 22 May 2019 14:46:16 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 4B81910BD; Wed, 22 May 2019 14:46:15 +0200 (CEST) Received: from smtp.tuxdriver.com (charlotte.tuxdriver.com [70.61.120.58]) by dpdk.org (Postfix) with ESMTP id 83E91A69; Wed, 22 May 2019 14:46:13 +0200 (CEST) Received: from cpe-2606-a000-111b-405a-0-0-0-162e.dyn6.twc.com ([2606:a000:111b:405a::162e] helo=localhost) by smtp.tuxdriver.com with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.63) (envelope-from ) id 1hTQd8-0001Hn-C8; Wed, 22 May 2019 08:46:09 -0400 Date: Wed, 22 May 2019 08:45:33 -0400 From: Neil Horman To: Jerin Jacob Kollanukkaran Cc: "dev@dpdk.org" , "thomas@monjalon.net" , "stable@dpdk.org" Message-ID: <20190522124533.GA18629@hmswarspite.think-freely.org> References: <20190521195628.16355-1-jerinj@marvell.com> <20190521202704.GA12605@hmswarspite.think-freely.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.11.3 (2019-02-01) X-Spam-Score: -2.9 (--) X-Spam-Status: No Subject: Re: [dpdk-dev] [EXT] Re: [PATCH] devtools: skip the symbol check when map file under drivers 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 Wed, May 22, 2019 at 03:05:54AM +0000, Jerin Jacob Kollanukkaran wrote: > > -----Original Message----- > > From: Neil Horman > > Sent: Wednesday, May 22, 2019 1:57 AM > > To: Jerin Jacob Kollanukkaran > > Cc: dev@dpdk.org; thomas@monjalon.net; stable@dpdk.org > > Subject: [EXT] Re: [dpdk-dev] [PATCH] devtools: skip the symbol check when > > map file under drivers > > > > On Wed, May 22, 2019 at 01:26:28AM +0530, jerinj@marvell.com wrote: > > > From: Jerin Jacob > > > > > > Drivers do not have ABI. > > > Skip the symbol check if map file under drivers directory. > > > > > > Fixes: 4bec48184e33 ("devtools: add checks for ABI symbol addition") > > > > > > Cc: stable@dpdk.org > > > Cc: Neil Horman > > > > > Sorry, but I'm not ok with this, because many of our DPDK PMDs have functions > > that get exported which are meant to be called by applications directly. The > > OK. Just to update my knowledge, Should those API needs to go through ABI/API > depreciation process? > Yes, they definately should, they are API's just as any other in the core DPDK library. > Actually, I am concerned about the APIs, which is called between drviers not > the application. For example, > drivers/common/dpaax/rte_common_dpaax_version.map > > it is not interface to application rather it is for intra driver case. > I think, I can change my logic to Skip the symbols which NOT starting with rte_. > Agree? > No, Thats just one case, and if those calls are between drivers, so be it, but those still need to be stable, and we have other examples (like the bonding or dummy driver), which have additional APIs that are explicitly meant to be used by an application. > Context: > I am adding a new driver/common/octeontx2 directory and it has some API which > Needs to shared between drivers not to the application. For me, it does not make > sense to go through any ABI process in such case. > Why? If you create an API thats reachable from another block of code (be it a driver or an application), you've created a dependency in which that API must remain stable, lest you risk breaking something. If an end user writes an out-of-tree PMD which makes use of an an additional driver API, then you need to keep it stable or you will break them. > > > dpaa2 driver is a good example, the cryptodev scheduler is another. Take a look > > at their version.map files to see what I mean. > > > > Unless we are willing to make drivers opaque objects that are only accessible > > from the [eth|crypto|etc]dev apis in the DPDK core, we have the potential for > > exported symbols, which means we have an ABI that has to be maintained, or at > > least recognized and reviewed for consistency > > > > Nacked-by: Neil Horman > > > > > > > Signed-off-by: Jerin Jacob > > > --- > > > devtools/check-symbol-change.sh | 8 ++++++++ > > > 1 file changed, 8 insertions(+) > > > > > > diff --git a/devtools/check-symbol-change.sh > > > b/devtools/check-symbol-change.sh index c5434f3bb..444beddad 100755 > > > --- a/devtools/check-symbol-change.sh > > > +++ b/devtools/check-symbol-change.sh > > > @@ -93,6 +93,14 @@ check_for_rule_violations() > > > if [ "$ar" = "add" ] > > > then > > > > > > + directory=`echo $mname | cut -d / -f 2` > > > + if [ "$directory" = "drivers" ] > > > + then > > > + # Drivers do not have ABI. Skip further > > > + # processing if the map file is under > > > + # drivers directory > > > + continue > > > + fi > > > if [ "$secname" = "unknown" ] > > > then > > > # Just inform the user of this occurrence, but > > > -- > > > 2.21.0 > > > > > > >