From: Gage Eads <gage.eads@intel.com>
To: dev@dpdk.org
Cc: olivier.matz@6wind.com, arybchenko@solarflare.com,
bruce.richardson@intel.com, konstantin.ananyev@intel.com,
stephen@networkplumber.org
Subject: [dpdk-dev] [PATCH] doc: announce ring ABI and API changes
Date: Tue, 15 Jan 2019 17:59:34 -0600 [thread overview]
Message-ID: <20190115235934.16065-1-gage.eads@intel.com> (raw)
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 <gage.eads@intel.com>
---
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
next reply other threads:[~2019-01-16 0:00 UTC|newest]
Thread overview: 20+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-01-15 23:59 Gage Eads [this message]
2019-01-16 0:34 ` Stephen Hemminger
2019-01-16 18:21 ` Eads, Gage
2019-01-18 15:28 ` [dpdk-dev] [PATCH v2] doc: announce ring API change Gage Eads
2019-01-18 15:31 ` [dpdk-dev] [PATCH v3] " Gage Eads
2019-02-01 11:16 ` Thomas Monjalon
2019-02-01 14:18 ` Eads, Gage
2019-02-01 14:36 ` [dpdk-dev] [PATCH v4] " Gage Eads
2019-05-09 23:29 ` Thomas Monjalon
2019-05-09 23:29 ` Thomas Monjalon
2019-05-10 14:53 ` Eads, Gage
2019-05-10 14:53 ` Eads, Gage
2019-05-10 14:58 ` Stephen Hemminger
2019-05-10 14:58 ` Stephen Hemminger
2019-05-10 15:19 ` Ola Liljedahl
2019-05-10 15:19 ` Ola Liljedahl
2019-05-10 16:28 ` Eads, Gage
2019-05-10 16:28 ` Eads, Gage
2019-05-13 11:46 ` Olivier Matz
2019-05-13 11:46 ` Olivier Matz
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20190115235934.16065-1-gage.eads@intel.com \
--to=gage.eads@intel.com \
--cc=arybchenko@solarflare.com \
--cc=bruce.richardson@intel.com \
--cc=dev@dpdk.org \
--cc=konstantin.ananyev@intel.com \
--cc=olivier.matz@6wind.com \
--cc=stephen@networkplumber.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).