[PATCH 07/22] ethdev: promote link speed helpers to stable
Stephen Hemminger
stephen at networkplumber.org
Tue Sep 1 22:23:06 CEST 2026
rte_eth_link_speed_to_str() and rte_eth_link_to_str() were added in
v20.11 to give applications a common way to format link information
instead of open coding it. Both are unchanged since.
Signed-off-by: Stephen Hemminger <stephen at networkplumber.org>
---
doc/guides/rel_notes/release_26_11.rst | 1 +
lib/ethdev/rte_ethdev.c | 4 ++--
lib/ethdev/rte_ethdev.h | 8 --------
3 files changed, 3 insertions(+), 10 deletions(-)
diff --git a/doc/guides/rel_notes/release_26_11.rst b/doc/guides/rel_notes/release_26_11.rst
index c4a9053b59..9b5e3cf902 100644
--- a/doc/guides/rel_notes/release_26_11.rst
+++ b/doc/guides/rel_notes/release_26_11.rst
@@ -109,6 +109,7 @@ API Changes
* clock: ``rte_eth_read_clock``
* flow dump: ``rte_flow_dev_dump``
* FEC: ``rte_eth_fec_get_capability``, ``rte_eth_fec_get`` and ``rte_eth_fec_set``
+ * link speed: ``rte_eth_link_speed_to_str`` and ``rte_eth_link_to_str``
ABI Changes
diff --git a/lib/ethdev/rte_ethdev.c b/lib/ethdev/rte_ethdev.c
index d814ee55f9..6fda1468f9 100644
--- a/lib/ethdev/rte_ethdev.c
+++ b/lib/ethdev/rte_ethdev.c
@@ -3208,7 +3208,7 @@ rte_eth_link_get_nowait(uint16_t port_id, struct rte_eth_link *eth_link)
return 0;
}
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_eth_link_speed_to_str, 20.11)
+RTE_EXPORT_SYMBOL(rte_eth_link_speed_to_str)
const char *
rte_eth_link_speed_to_str(uint32_t link_speed)
{
@@ -3275,7 +3275,7 @@ rte_eth_link_speed_to_str(uint32_t link_speed)
return ret;
}
-RTE_EXPORT_EXPERIMENTAL_SYMBOL(rte_eth_link_to_str, 20.11)
+RTE_EXPORT_SYMBOL(rte_eth_link_to_str)
int
rte_eth_link_to_str(char *str, size_t len, const struct rte_eth_link *eth_link)
{
diff --git a/lib/ethdev/rte_ethdev.h b/lib/ethdev/rte_ethdev.h
index 41a744059c..2a694130ea 100644
--- a/lib/ethdev/rte_ethdev.h
+++ b/lib/ethdev/rte_ethdev.h
@@ -3110,9 +3110,6 @@ int rte_eth_link_get_nowait(uint16_t port_id, struct rte_eth_link *link)
__rte_warn_unused_result;
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* The function converts a link_speed to a string. It handles all special
* values like unknown or none speed.
*
@@ -3122,7 +3119,6 @@ int rte_eth_link_get_nowait(uint16_t port_id, struct rte_eth_link *link)
* Link speed in textual format. It's pointer to immutable memory.
* No free is required.
*/
-__rte_experimental
const char *rte_eth_link_speed_to_str(uint32_t link_speed);
/**
@@ -3140,9 +3136,6 @@ __rte_experimental
const char *rte_eth_link_connector_to_str(enum rte_eth_link_connector link_connector);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* The function converts a rte_eth_link struct representing a link status to
* a string.
*
@@ -3157,7 +3150,6 @@ const char *rte_eth_link_connector_to_str(enum rte_eth_link_connector link_conne
* @return
* Number of bytes written to str array or -EINVAL if bad parameter.
*/
-__rte_experimental
int rte_eth_link_to_str(char *str, size_t len,
const struct rte_eth_link *eth_link);
--
2.53.0
More information about the dev
mailing list