dev.dpdk.org archive mirror
 help / color / mirror / Atom feed
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


             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).