[PATCH 20/22] ethdev: promote remaining aged symbols to stable
Stephen Hemminger
stephen at networkplumber.org
Tue Sep 1 22:23:19 CEST 2026
The last ethdev symbols that are at least two years old:
21.02 rte_eth_get_monitor_addr
21.05 rte_eth_representor_info_get
22.11 rte_eth_buffer_split_get_supported_hdr_ptypes
24.11 rte_eth_timesync_adjust_freq
24.11 rte_tm_node_query
With this the only exported, non-inline experimental symbols left in
ethdev are from 25.03 and later. The inline helpers
rte_eth_recycle_mbufs() and rte_eth_tx_queue_count(), and the trace
point symbols, keep the experimental tag and are left for later.
Signed-off-by: Stephen Hemminger <stephen at networkplumber.org>
---
doc/guides/rel_notes/release_26_11.rst | 4 ++++
lib/ethdev/rte_ethdev.c | 8 ++++----
lib/ethdev/rte_ethdev.h | 16 ----------------
lib/ethdev/rte_tm.c | 2 +-
lib/ethdev/rte_tm.h | 1 -
5 files changed, 9 insertions(+), 22 deletions(-)
diff --git a/doc/guides/rel_notes/release_26_11.rst b/doc/guides/rel_notes/release_26_11.rst
index b23ffa6cb0..7254ef585c 100644
--- a/doc/guides/rel_notes/release_26_11.rst
+++ b/doc/guides/rel_notes/release_26_11.rst
@@ -151,6 +151,10 @@ API Changes
``rte_eth_recycle_rx_queue_info_get``,
``rte_eth_dev_count_aggr_ports`` and
``rte_eth_dev_map_aggr_tx_affinity``
+ * utility funcs:
+ ``rte_eth_get_monitor_addr``, ``rte_eth_representor_info_get``,
+ ``rte_eth_buffer_split_get_supported_hdr_ptypes``,
+ ``rte_eth_timesync_adjust_freq`` and ``rte_tm_node_query``
ABI Changes
diff --git a/lib/ethdev/rte_ethdev.c b/lib/ethdev/rte_ethdev.c
index 4c675f1f22..62e2c0dd07 100644
--- a/lib/ethdev/rte_ethdev.c
+++ b/lib/ethdev/rte_ethdev.c
@@ -6547,7 +6547,7 @@ rte_eth_tx_burst_mode_get(uint16_t port_id, uint16_t queue_id,
return ret;
}
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_eth_get_monitor_addr, 21.02)
+RTE_EXPORT_SYMBOL(rte_eth_get_monitor_addr)
int
rte_eth_get_monitor_addr(uint16_t port_id, uint16_t queue_id,
struct rte_power_monitor_cond *pmc)
@@ -6718,7 +6718,7 @@ rte_eth_timesync_adjust_time(uint16_t port_id, int64_t delta)
return ret;
}
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_eth_timesync_adjust_freq, 24.11)
+RTE_EXPORT_SYMBOL(rte_eth_timesync_adjust_freq)
int
rte_eth_timesync_adjust_freq(uint16_t port_id, int64_t ppm)
{
@@ -7149,7 +7149,7 @@ rte_eth_dev_pool_ops_supported(uint16_t port_id, const char *pool)
return ret;
}
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_eth_representor_info_get, 21.05)
+RTE_EXPORT_SYMBOL(rte_eth_representor_info_get)
int
rte_eth_representor_info_get(uint16_t port_id,
struct rte_eth_representor_info *info)
@@ -7389,7 +7389,7 @@ rte_eth_tx_descriptor_dump(uint16_t port_id, uint16_t queue_id,
dev->dev_ops->eth_tx_descriptor_dump(dev, queue_id, offset, num, file));
}
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_eth_buffer_split_get_supported_hdr_ptypes, 22.11)
+RTE_EXPORT_SYMBOL(rte_eth_buffer_split_get_supported_hdr_ptypes)
int
rte_eth_buffer_split_get_supported_hdr_ptypes(uint16_t port_id, uint32_t *ptypes, int num)
{
diff --git a/lib/ethdev/rte_ethdev.h b/lib/ethdev/rte_ethdev.h
index d18afa20c6..6f18878bc5 100644
--- a/lib/ethdev/rte_ethdev.h
+++ b/lib/ethdev/rte_ethdev.h
@@ -5139,9 +5139,6 @@ int rte_eth_tx_burst_mode_get(uint16_t port_id, uint16_t queue_id,
struct rte_eth_burst_mode *mode);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Retrieve the monitor condition for a given receive queue.
*
* @param port_id
@@ -5158,7 +5155,6 @@ int rte_eth_tx_burst_mode_get(uint16_t port_id, uint16_t queue_id,
* -EINVAL: Invalid parameters.
* -ENODEV: Invalid port ID.
*/
-__rte_experimental
int rte_eth_get_monitor_addr(uint16_t port_id, uint16_t queue_id,
struct rte_power_monitor_cond *pmc);
@@ -5449,7 +5445,6 @@ int rte_eth_timesync_adjust_time(uint16_t port_id, int64_t delta);
* - -EIO: if device is removed.
* - -ENOTSUP: The function is not supported by the Ethernet driver.
*/
-__rte_experimental
int rte_eth_timesync_adjust_freq(uint16_t port_id, int64_t ppm);
/**
@@ -5636,9 +5631,6 @@ int rte_eth_dev_hairpin_capability_get(uint16_t port_id,
struct rte_eth_hairpin_cap *cap);
/**
- * @warning
- * @b EXPERIMENTAL: this structure may change without prior notice.
- *
* Ethernet device representor ID range entry
*/
struct rte_eth_representor_range {
@@ -5656,9 +5648,6 @@ struct rte_eth_representor_range {
};
/**
- * @warning
- * @b EXPERIMENTAL: this structure may change without prior notice.
- *
* Ethernet device representor information
*/
struct rte_eth_representor_info {
@@ -5692,7 +5681,6 @@ struct rte_eth_representor_info {
* - (-EIO) if device is removed.
* - (>=0) number of available representor range entries.
*/
-__rte_experimental
int rte_eth_representor_info_get(uint16_t port_id,
struct rte_eth_representor_info *info);
@@ -6921,9 +6909,6 @@ rte_eth_recycle_mbufs(uint16_t rx_port_id, uint16_t rx_queue_id,
}
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Get supported header protocols to split on Rx.
*
* When a packet type is announced to be split,
@@ -6948,7 +6933,6 @@ rte_eth_recycle_mbufs(uint16_t rx_port_id, uint16_t rx_queue_id,
* - (-ENODEV) if *port_id* invalid.
* - (-EINVAL) if bad parameter.
*/
-__rte_experimental
int rte_eth_buffer_split_get_supported_hdr_ptypes(uint16_t port_id, uint32_t *ptypes, int num)
__rte_warn_unused_result;
diff --git a/lib/ethdev/rte_tm.c b/lib/ethdev/rte_tm.c
index 66b8934c3b..675d6e146d 100644
--- a/lib/ethdev/rte_tm.c
+++ b/lib/ethdev/rte_tm.c
@@ -316,7 +316,7 @@ int rte_tm_node_add(uint16_t port_id,
return ret;
}
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_tm_node_query, 24.11)
+RTE_EXPORT_SYMBOL(rte_tm_node_query)
int rte_tm_node_query(uint16_t port_id,
uint32_t node_id,
uint32_t *parent_node_id,
diff --git a/lib/ethdev/rte_tm.h b/lib/ethdev/rte_tm.h
index c9dd760858..c393b86b3b 100644
--- a/lib/ethdev/rte_tm.h
+++ b/lib/ethdev/rte_tm.h
@@ -1638,7 +1638,6 @@ rte_tm_node_add(uint16_t port_id,
* -EINVAL - port or node id value is invalid
* -ENOENT - no node exists with the provided id on the provided port
*/
-__rte_experimental
int
rte_tm_node_query(uint16_t port_id,
uint32_t node_id,
--
2.53.0
More information about the dev
mailing list