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 6B9BFA04F0; Tue, 10 Dec 2019 13:05:05 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A8CF337A2; Tue, 10 Dec 2019 13:05:04 +0100 (CET) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by dpdk.org (Postfix) with ESMTP id C792323D for ; Tue, 10 Dec 2019 13:05:02 +0100 (CET) X-Amp-Result: UNKNOWN X-Amp-Original-Verdict: FILE UNKNOWN X-Amp-File-Uploaded: False Received: from orsmga008.jf.intel.com ([10.7.209.65]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 10 Dec 2019 04:05:01 -0800 X-IronPort-AV: E=Sophos;i="5.69,299,1571727600"; d="scan'208";a="207258867" Received: from bricha3-mobl.ger.corp.intel.com ([10.237.221.46]) by orsmga008-auth.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 10 Dec 2019 04:04:58 -0800 Date: Tue, 10 Dec 2019 12:04:55 +0000 From: Bruce Richardson To: Ferruh Yigit Cc: "Kinsella, Ray" , Thomas Monjalon , David Marchand , Luca Boccassi , Christian Ehrhardt , Timothy Redaelli , Kevin Traynor , dpdk-dev , "Laatz, Kevin" , Andrew Rybchenko , Neil Horman Message-ID: <20191210120455.GB103@bricha3-MOBL.ger.corp.intel.com> References: <5df1a33b-b338-bde1-6834-e8b5fbe65a04@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <5df1a33b-b338-bde1-6834-e8b5fbe65a04@intel.com> User-Agent: Mutt/1.12.1 (2019-06-15) Subject: Re: [dpdk-dev] How to manage new APIs added after major ABI release? 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 Tue, Dec 10, 2019 at 11:56:28AM +0000, Ferruh Yigit wrote: > Hi, > > With new process, the major ABI releases will be compatible until it is > deprecated (until next LTS for now), > like current ABI version is 20 in DPDK_19.11 and DPDK versions until DPDK_20.11 > will be ABI compatible with this version. > > But if we introduce a new API after major ABI, say in 20.02 release, are we > allowed to break the ABI for that API before DPDK_20.11? > > If we allow it break, following problem will be observed: > Assume an application using .so.20.1 library, and using the new API introduced > in 20.02, lets say foo(), > but when application switches to .so.20.2 (released via DPDK_20.05), application > will fail because of ABI breakage in foo(). > > I think it is fair that application expects forward compatibility in minor > versions of a shared library. > Like if application linked against .so.20.2, fair to expect .so.20.3, .so.20.4 > etc will work fine. I think currently only .so.20.0 is fully forward compatible. > > If we all agree on this, we may need to tweak the process a little, but before > diving into implementation details, I would like to be sure we are in same page. > Well, any new API's generally come in as experimental, in which case changes are allowed, and breakage can be expected. If they are not experiemental, then the ABI policy applies to them in that they cannot change since they are part of the .21 ABI, even if that ABI is not fully complete yet. For any application only using stable, non-experimental functions, forward compatibility must be maintained IMHO. /Bruce