From: Stephen Hemminger <stephen@networkplumber.org>
To: dev@dpdk.org
Cc: Stephen Hemminger <stephen@networkplumber.org>,
Volodymyr Fialko <vfialko@marvell.com>
Subject: [PATCH] reorder: promote experimental API to stable
Date: Wed, 2 Sep 2026 16:27:00 -0700 [thread overview]
Message-ID: <20260902232700.550000-1-stephen@networkplumber.org> (raw)
All the experimental symbols in the reorder library were added in
DPDK 23.07 or earlier and have not changed since, so remove the
experimental tag.
The sequence number accessor rte_reorder_seqn() and the underlying
rte_reorder_seqn_dynfield_offset date back to 20.11,
rte_reorder_drain_up_to_seqn() and rte_reorder_min_seqn_set() to 23.03,
and rte_reorder_memory_footprint_get() to 23.07.
Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
---
doc/guides/rel_notes/release_26_11.rst | 4 ++++
lib/reorder/rte_reorder.c | 8 ++++----
lib/reorder/rte_reorder.h | 16 ----------------
3 files changed, 8 insertions(+), 20 deletions(-)
diff --git a/doc/guides/rel_notes/release_26_11.rst b/doc/guides/rel_notes/release_26_11.rst
index 87c7e81bde..437cb8f2cc 100644
--- a/doc/guides/rel_notes/release_26_11.rst
+++ b/doc/guides/rel_notes/release_26_11.rst
@@ -95,6 +95,10 @@ API Changes
Also, make sure to start the actual text at the margin.
=======================================================
+* reorder: Promoted the following experimental API to stable:
+ ``rte_reorder_seqn``, ``rte_reorder_drain_up_to_seqn``,
+ ``rte_reorder_min_seqn_set`` and ``rte_reorder_memory_footprint_get``.
+
ABI Changes
-----------
diff --git a/lib/reorder/rte_reorder.c b/lib/reorder/rte_reorder.c
index be06530860..af5a6d9f01 100644
--- a/lib/reorder/rte_reorder.c
+++ b/lib/reorder/rte_reorder.c
@@ -35,7 +35,7 @@ EAL_REGISTER_TAILQ(rte_reorder_tailq)
#define RTE_REORDER_NAMESIZE 32
#define RTE_REORDER_SEQN_DYNFIELD_NAME "rte_reorder_seqn_dynfield"
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_reorder_seqn_dynfield_offset, 20.11)
+RTE_EXPORT_SYMBOL(rte_reorder_seqn_dynfield_offset)
int rte_reorder_seqn_dynfield_offset = -1;
/* A generic circular buffer */
@@ -61,7 +61,7 @@ struct __rte_cache_aligned rte_reorder_buffer {
static void
rte_reorder_free_mbufs(struct rte_reorder_buffer *b);
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_reorder_memory_footprint_get, 23.07)
+RTE_EXPORT_SYMBOL(rte_reorder_memory_footprint_get)
unsigned int
rte_reorder_memory_footprint_get(unsigned int size)
{
@@ -482,7 +482,7 @@ ready_buffer_seqn_find(const struct cir_buffer *ready_buf, const uint32_t seqn)
return low;
}
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_reorder_drain_up_to_seqn, 23.03)
+RTE_EXPORT_SYMBOL(rte_reorder_drain_up_to_seqn)
unsigned int
rte_reorder_drain_up_to_seqn(struct rte_reorder_buffer *b, struct rte_mbuf **mbufs,
const unsigned int max_mbufs, const rte_reorder_seqn_t seqn)
@@ -553,7 +553,7 @@ rte_reorder_is_empty(const struct rte_reorder_buffer *b)
return true;
}
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_reorder_min_seqn_set, 23.03)
+RTE_EXPORT_SYMBOL(rte_reorder_min_seqn_set)
unsigned int
rte_reorder_min_seqn_set(struct rte_reorder_buffer *b, rte_reorder_seqn_t min_seqn)
{
diff --git a/lib/reorder/rte_reorder.h b/lib/reorder/rte_reorder.h
index 1c8c1d5079..5bcb32b164 100644
--- a/lib/reorder/rte_reorder.h
+++ b/lib/reorder/rte_reorder.h
@@ -29,15 +29,11 @@ typedef uint32_t rte_reorder_seqn_t;
extern int rte_reorder_seqn_dynfield_offset;
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Read reorder sequence number from mbuf.
*
* @param mbuf Structure to read from.
* @return pointer to reorder sequence number.
*/
-__rte_experimental
static inline rte_reorder_seqn_t *
rte_reorder_seqn(struct rte_mbuf *mbuf)
{
@@ -170,9 +166,6 @@ rte_reorder_drain(struct rte_reorder_buffer *b, struct rte_mbuf **mbufs,
unsigned max_mbufs);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Fetch set of reordered packets up to specified sequence number (exclusive).
*
* Returns a set of in-order packets from the reorder buffer structure.
@@ -190,15 +183,11 @@ rte_reorder_drain(struct rte_reorder_buffer *b, struct rte_mbuf **mbufs,
* @return
* Number of mbuf pointers written to mbufs. 0 <= N < max_mbufs.
*/
-__rte_experimental
unsigned int
rte_reorder_drain_up_to_seqn(struct rte_reorder_buffer *b, struct rte_mbuf **mbufs,
unsigned int max_mbufs, rte_reorder_seqn_t seqn);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Set minimum sequence number of packet allowed to be buffered.
* To successfully set new value,
* reorder buffer has to be empty (after create, reset or drain_all).
@@ -210,14 +199,10 @@ rte_reorder_drain_up_to_seqn(struct rte_reorder_buffer *b, struct rte_mbuf **mbu
* @return
* 0 on success, a negative value otherwise.
*/
-__rte_experimental
unsigned int
rte_reorder_min_seqn_set(struct rte_reorder_buffer *b, rte_reorder_seqn_t min_seqn);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Determine the amount of memory needed by the reorder buffer
* to accommodate a given number of elements.
* @see rte_reorder_init()
@@ -227,7 +212,6 @@ rte_reorder_min_seqn_set(struct rte_reorder_buffer *b, rte_reorder_seqn_t min_se
* @return
* Reorder buffer footprint measured in bytes.
*/
-__rte_experimental
unsigned int
rte_reorder_memory_footprint_get(unsigned int size);
--
2.53.0
next reply other threads:[~2026-09-02 23:27 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-02 23:27 Stephen Hemminger [this message]
2026-09-16 16:23 ` [PATCH] reorder: promote experimental API to stable David Marchand
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=20260902232700.550000-1-stephen@networkplumber.org \
--to=stephen@networkplumber.org \
--cc=dev@dpdk.org \
--cc=vfialko@marvell.com \
/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).