From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-we0-f170.google.com (mail-we0-f170.google.com [74.125.82.170]) by dpdk.org (Postfix) with ESMTP id 729C118F for ; Thu, 18 Sep 2014 20:18:05 +0200 (CEST) Received: by mail-we0-f170.google.com with SMTP id u57so1367793wes.15 for ; Thu, 18 Sep 2014 11:23:52 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:organization :user-agent:in-reply-to:references:mime-version :content-transfer-encoding:content-type; bh=8+w4hZB1rMF4gwer7p1ZA2OjX1Z0msd7Z7lhgmJvY+E=; b=UEoLKYcjsd2PrzpKWIA5lmXTIxkmZu3l8SXbHdI5TIr3WPdcz0t5NIXyv+QjORZXDe GoztMcqqGtp8+mKezHVzFpAAr+3PXU9gomsUWwRaQXrCjBpQr3xjw/ca6JWoC3HZPUyQ KfgWnhKi1hHcdHsNOM34uIhxaFEvI5lNiwTdEfTaXK+Rtj9xPBaS/37fFQebFVa51y4f yk7D3efBkMwy+rNQVeqj5nCooor95BHja36IuDZRyZrfL+YTMGjFqPqxpmvvBrhgqlkV EC5rfyN46ker9X9txwVj1XZQytoRWfqUtBK/tvRbW6MEriQrGE1R+ipzWZLASUyIUN4F O/ew== X-Gm-Message-State: ALoCoQk5XeGAB+dlpEcw+3A+I9uzBK4/KdaJv3ptbAVP5t6SyV0DQkxkzQ4bp3C3FKtt3cdITyKe X-Received: by 10.194.206.103 with SMTP id ln7mr6910487wjc.30.1411064631986; Thu, 18 Sep 2014 11:23:51 -0700 (PDT) Received: from xps13.localnet (1.17.90.92.rev.sfr.net. [92.90.17.1]) by mx.google.com with ESMTPSA id o3sm3898070wiy.18.2014.09.18.11.23.50 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 18 Sep 2014 11:23:51 -0700 (PDT) From: Thomas Monjalon To: Neil Horman Date: Thu, 18 Sep 2014 20:23:36 +0200 Message-ID: <2657938.GdCLzJqtVh@xps13> Organization: 6WIND User-Agent: KMail/4.13.3 (Linux/3.15.8-1-ARCH; KDE/4.13.3; x86_64; ; ) In-Reply-To: <1410809031-19114-1-git-send-email-nhorman@tuxdriver.com> References: <1410809031-19114-1-git-send-email-nhorman@tuxdriver.com> MIME-Version: 1.0 Content-Transfer-Encoding: 7Bit Content-Type: text/plain; charset="us-ascii" Cc: dev@dpdk.org Subject: Re: [dpdk-dev] [PATCH 0/4] Add DSO symbol versioning to support backwards compatibility 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: Thu, 18 Sep 2014 18:18:05 -0000 Hi Neil, 2014-09-15 15:23, Neil Horman: > The DPDK ABI develops and changes quickly, which makes it difficult for > applications to keep up with the latest version of the library, especially when > it (the DPDK) is built as a set of shared objects, as applications may be built > against an older version of the library. > > To mitigate this, this patch series introduces support for library and symbol > versioning when the DPDK is built as a DSO. Specifically, it does 4 things: > > 1) Adds initial support for library versioning. Each library now has a version > map that explicitly calls out what symbols are exported to using applications, > and assigns version(s) to them > > 2) Adds support macros so that when libraries create incompatible ABI's, > multiple versions may be supported so that applications linked against older > DPDK releases can continue to function > > 3) Adds library soname versioning suffixes so that when ABI's must be broken in > a fashion that requires a rebuild of older applications, they will break at load > time, rather than cause unexpected issues at run time. > > 4) Adds documentation for ABI policy, and provides space to document deprecated > ABI versions, so that applications might be warned of impending changes. > > With these elements in place the DPDK has some support to allow for the extended > maintenence of older API's while still allowing the freedom to develop new and > improved API's. > > Implementing this feature will require some additional effort on the part of > developers and reviewers. When reviewing patches, must be checked against > existing exports to ensure that the function prototypes are not changing. If > they are, the versioning macros must be used, and the library export map should > be updated to reflect the new version of the function. > > When data structures change, if those structures are application accessible, > apis that accept or return instances of those data structures should have new > versions created so that users of the old data structure version might co-exist > at the same time. Thanks for your efforts. But I feel this change has too many constraints for the current status of the DPDK. It's probably too early to adopt such policy. By the way, this versioning doesn't cover structure changes. How could it be managed? Don't you think it would be more reliable if managed by packaging? Thank you for opening this discussion with a constructive proposal. Let's check it later on once structures will be more stable since performance is the most critical target. -- Thomas