From mboxrd@z Thu Jan 1 00:00:00 1970 From: Gage Eads Subject: [PATCH] doc: announce ring ABI and API changes Date: Tue, 15 Jan 2019 17:59:34 -0600 Message-ID: <20190115235934.16065-1-gage.eads@intel.com> Cc: olivier.matz@6wind.com, arybchenko@solarflare.com, bruce.richardson@intel.com, konstantin.ananyev@intel.com, stephen@networkplumber.org To: dev@dpdk.org Return-path: Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by dpdk.org (Postfix) with ESMTP id 9711110A3 for ; Wed, 16 Jan 2019 01:00:48 +0100 (CET) List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" In order to support the non-blocking ring[1], one ABI change and one API change are required in librte_ring. This commit updates the deprecation notice to pave the way for their inclusion in 19.05. [1] http://mails.dpdk.org/archives/dev/2019-January/123475.html Signed-off-by: Gage Eads --- doc/guides/rel_notes/deprecation.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index d4aea4b46..d74cff467 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -83,3 +83,14 @@ Deprecation Notices - The size and layout of ``rte_cryptodev_qp_conf`` and syntax of ``rte_cryptodev_queue_pair_setup`` will change to to allow to use two different mempools for crypto and device private sessions. + +* ring: two changes are planned for rte_ring in v19.05: + + - The ring head and tail values are planned to be changed from ``uint32_t`` + to ``size_t``. This reduces the likelihood of wrap-around to effectively + zero for 64-bit builds, which is important in avoiding the ABA problem in + the upcoming non-blocking ring implementation. (32-bit builds are + unaffected by this change.) + - rte_ring_get_memsize() will get a new ``flags`` parameter, so it can + calculate the memory required for rings that require more than 8B per entry + (such as the upcoming non-blocking ring). -- 2.13.6