eal: mark older API's stable
cover eal: mark older API's stable
About 80 function in EAL were marked experimental
and should have been made stable by now.
Stephen Hemminger (15):
eal: make bitops a stable API
eal: mark rte_dev API's as stable
eal: make rte_class API's stable
eal: make rte_version_XXX API's stable
eal: make rte_drand a stable API
eal: make rte_service_lcore_may_be_active stable
eal: make rte_devargs_reset stable
eal: make pflock API stable
eal: make seqcount and seqlock stable
eal: mark rte_intr_XXX API's as stable
eal: mark rte_atomic128_cmp_exchange as stable
eal: make most rte_thread API's stable
eal: mark rte_power API's stable
eal: mark rte_eal_vfio_get_token stable
eal: mark rte_vect simd bandwidth API as stable
lib/eal/arm/include/rte_atomic_64.h | 1 - lib/eal/include/generic/rte_atomic.h | 1 - .../include/generic/rte_power_intrinsics.h | 16 --- lib/eal/include/generic/rte_vect.h | 8 -- lib/eal/include/rte_bitmap.h | 8 -- lib/eal/include/rte_bitops.h | 40 ------ lib/eal/include/rte_class.h | 4 - lib/eal/include/rte_dev.h | 32 ----- lib/eal/include/rte_devargs.h | 1 - lib/eal/include/rte_eal.h | 4 - lib/eal/include/rte_interrupts.h | 28 ---- lib/eal/include/rte_pflock.h | 20 --- lib/eal/include/rte_random.h | 4 - lib/eal/include/rte_seqcount.h | 23 --- lib/eal/include/rte_seqlock.h | 21 --- lib/eal/include/rte_service.h | 1 - lib/eal/include/rte_thread.h | 57 -------- lib/eal/include/rte_version.h | 6 - lib/eal/version.map | 132 ++++++++---------- lib/eal/x86/include/rte_atomic_64.h | 1 - 20 files changed, 55 insertions(+), 353 deletions(-)
Signature · 1 line
2.39.2
PATCH 1/15 eal: make bitops a stable API
These were added in 20.05 release.
--- lib/eal/include/rte_bitmap.h | 8 -------- lib/eal/include/rte_bitops.h | 40 ------------------------------------ 2 files changed, 48 deletions(-)
lib/eal/include/rte_bitmap.h +0 -8
@@ -203,9 +203,6 @@ rte_bitmap_init(uint32_t n_bits, uint8_t *mem, uint32_t mem_size) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Bitmap clear slab overhead bits. * * @param slabs
@@ -215,7 +212,6 @@ rte_bitmap_init(uint32_t n_bits, uint8_t *mem, uint32_t mem_size)* @param pos * The start bit position in the slabs to be cleared. */ -__rte_experimental static inline void __rte_bitmap_clear_slab_overhead_bits (uint64_t *slabs,uint32_t slab_size,uint32_t pos)
@@ -235,9 +231,6 @@ __rte_bitmap_clear_slab_overhead_bits(uint64_t *slabs, uint32_t slab_size, }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Bitmap initialization with all bits set * * @param n_bits
@@ -249,7 +242,6 @@ __rte_bitmap_clear_slab_overhead_bits(uint64_t *slabs, uint32_t slab_size,* @return * Handle to bitmap instance. */ -__rte_experimental static inline struct rte_bitmap *rte_bitmap_init_with_all_set (uint32_t n_bits,uint8_t *mem,uint32_t mem_size) {
lib/eal/include/rte_bitops.h +0 -40
@@ -40,9 +40,6 @@ extern "C" {/*------------------------ 32-bit relaxed operations ------------------------*/ /** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Get the target bit from a 32-bit value without memory ordering. * * @param nr
@@ -52,7 +49,6 @@ extern "C" {* @return * The target bit. */ -__rte_experimental static inline uint32_t rte_bit_relaxed_get32 (unsigned int nr,volatile uint32_t *addr) {
@@ -63,9 +59,6 @@ rte_bit_relaxed_get32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Set the target bit in a 32-bit value to 1 without memory ordering. * * @param nr
@@ -73,7 +66,6 @@ rte_bit_relaxed_get32(unsigned int nr, volatile uint32_t *addr)* @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_set32 (unsigned int nr,volatile uint32_t *addr) {
@@ -84,9 +76,6 @@ rte_bit_relaxed_set32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Clear the target bit in a 32-bit value to 0 without memory ordering. * * @param nr
@@ -94,7 +83,6 @@ rte_bit_relaxed_set32(unsigned int nr, volatile uint32_t *addr)* @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_clear32 (unsigned int nr,volatile uint32_t *addr) {
@@ -105,9 +93,6 @@ rte_bit_relaxed_clear32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Return the original bit from a 32-bit value, then set it to 1 without * memory ordering. *
@@ -118,7 +103,6 @@ rte_bit_relaxed_clear32(unsigned int nr, volatile uint32_t *addr)* @return * The original bit. */ -__rte_experimental static inline uint32_t rte_bit_relaxed_test_and_set32 (unsigned int nr,volatile uint32_t *addr) {
@@ -131,9 +115,6 @@ rte_bit_relaxed_test_and_set32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Return the original bit from a 32-bit value, then clear it to 0 without * memory ordering. *
@@ -144,7 +125,6 @@ rte_bit_relaxed_test_and_set32(unsigned int nr, volatile uint32_t *addr)* @return * The original bit. */ -__rte_experimental static inline uint32_t rte_bit_relaxed_test_and_clear32 (unsigned int nr,volatile uint32_t *addr) {
@@ -159,9 +139,6 @@ rte_bit_relaxed_test_and_clear32(unsigned int nr, volatile uint32_t *addr)/*------------------------ 64-bit relaxed operations ------------------------*/ /** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Get the target bit from a 64-bit value without memory ordering. * * @param nr
@@ -171,7 +148,6 @@ rte_bit_relaxed_test_and_clear32(unsigned int nr, volatile uint32_t *addr)* @return * The target bit. */ -__rte_experimental static inline uint64_t rte_bit_relaxed_get64 (unsigned int nr,volatile uint64_t *addr) {
@@ -182,9 +158,6 @@ rte_bit_relaxed_get64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Set the target bit in a 64-bit value to 1 without memory ordering. * * @param nr
@@ -192,7 +165,6 @@ rte_bit_relaxed_get64(unsigned int nr, volatile uint64_t *addr)* @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_set64 (unsigned int nr,volatile uint64_t *addr) {
@@ -203,9 +175,6 @@ rte_bit_relaxed_set64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Clear the target bit in a 64-bit value to 0 without memory ordering. * * @param nr
@@ -213,7 +182,6 @@ rte_bit_relaxed_set64(unsigned int nr, volatile uint64_t *addr)* @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_clear64 (unsigned int nr,volatile uint64_t *addr) {
@@ -224,9 +192,6 @@ rte_bit_relaxed_clear64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Return the original bit from a 64-bit value, then set it to 1 without * memory ordering. *
@@ -237,7 +202,6 @@ rte_bit_relaxed_clear64(unsigned int nr, volatile uint64_t *addr)* @return * The original bit. */ -__rte_experimental static inline uint64_t rte_bit_relaxed_test_and_set64 (unsigned int nr,volatile uint64_t *addr) {
@@ -250,9 +214,6 @@ rte_bit_relaxed_test_and_set64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Return the original bit from a 64-bit value, then clear it to 0 without * memory ordering. *
@@ -263,7 +224,6 @@ rte_bit_relaxed_test_and_set64(unsigned int nr, volatile uint64_t *addr)* @return * The original bit. */ -__rte_experimental static inline uint64_t rte_bit_relaxed_test_and_clear64 (unsigned int nr,volatile uint64_t *addr) {
Signature · 1 line
2.39.2
Re: [PATCH 01/15] eal: make bitops a stable API
Quoted 4 lines · Stephen Hemminger
These were added in 20.05 release.
Signed-off-by Stephen Hemminger <[email protected]>---
can i ask that this patch be held until this series is merged?
https://patchwork.dpdk.org/project/dpdk/list/?series=27612
i'm already overloaded with rebasing for other changes, i'm working with david to get the above series merged.
adding david as a fyi
Re: [PATCH 01/15] eal: make bitops a stable API
Quoted 7 lines · On Wed, 9 Aug 2023 10:58:51 -0700 Tyler Retzlaff…
Quoted 4 lines · Stephen Hemminger
These were added in 20.05 release.
Signed-off-by Stephen Hemminger <[email protected]>---
can i ask that this patch be held until this series is merged?
I expect these mostly will go in after other changes are done.
Re: [PATCH 01/15] eal: make bitops a stable API
Quoted 4 lines · Stephen Hemminger
Quoted 1 line · On Wed, 9 Aug 2023 10:58:51 -0700 Tyler Retzlaff…
On Wed, Aug 09, 2023 at 09:42:53AM -0700, Stephen Hemminger wrote:
Quoted 8 lines
Quoted 6 lines
Quoted 4 lines
These were added in 20.05 release.
Signed-off-by Stephen Hemminger <[email protected]>---
can i ask that this patch be held until this series is merged?
I expect these mostly will go in after other changes are done.
thanks!
PATCH 2/15 eal: mark rte_dev API's as stable
In reply to Stephen HemmingerThese have been around since 2020.
--- lib/eal/include/rte_dev.h | 32 -------------------------------- lib/eal/version.map | 28 +++++++++++----------------- 2 files changed, 11 insertions(+), 49 deletions(-)
lib/eal/include/rte_dev.h +0 -32
@@ -341,7 +341,6 @@ typedef void *(*rte_dev_iterate_t)(const void *start,* 0 on successful initialization. * <0 on error. */ -__rte_experimental int rte_dev_iterator_init (struct rte_dev_iterator *it,const char *str);
@@ -361,7 +360,6 @@ rte_dev_iterator_init(struct rte_dev_iterator *it, const char *str);* NULL if an error occurred (rte_errno is set). * NULL if no device could be found (rte_errno is not set). */ -__rte_experimental struct rte_device *rte_dev_iterator_next (struct rte_dev_iterator *it);
@@ -372,9 +370,6 @@ rte_dev_iterator_next(struct rte_dev_iterator *it); dev = rte_dev_iterator_next(it))/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * It registers the callback for the specific device. * Multiple callbacks can be registered at the same time. *
@@ -390,16 +385,12 @@ rte_dev_iterator_next(struct rte_dev_iterator *it);* - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_callback_register (const char *device_name,rte_dev_event_cb_fn cb_fn,void *cb_arg);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * It unregisters the callback according to the specified device. * * @param device_name
@@ -415,16 +406,12 @@ rte_dev_event_callback_register(const char *device_name,* - On success, return the number of callback entities removed. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_callback_unregister (const char *device_name,rte_dev_event_cb_fn cb_fn,void *cb_arg);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Executes all the user application registered callbacks for * the specific device. *
@@ -433,64 +420,47 @@ rte_dev_event_callback_unregister(const char *device_name,* @param event * the device event type. */ -__rte_experimental void rte_dev_event_callback_process (const char *device_name,enum rte_dev_event_type event);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Start the device event monitoring. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_monitor_start (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Stop the device event monitoring. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_monitor_stop (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Enable hotplug handling for devices. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_hotplug_handle_enable (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Disable hotplug handling for devices. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_hotplug_handle_disable (void );
@@ -514,7 +484,6 @@ rte_dev_hotplug_handle_disable(void);* 0 if mapping was successful. * Negative value and rte_errno is set otherwise. */ -__rte_experimental int rte_dev_dma_map (struct rte_device *dev,void *addr,uint64_t iova,size_t len);
@@ -538,7 +507,6 @@ rte_dev_dma_map(struct rte_device *dev, void *addr, uint64_t iova, size_t len);* 0 if un-mapping was successful. * Negative value and rte_errno is set otherwise. */ -__rte_experimental int rte_dev_dma_unmap (struct rte_device *dev,void *addr,uint64_t iova,size_t len);
lib/eal/version.map +11 -17
@@ -29,8 +29,19 @@ DPDK_24 { rte_dev_bus; rte_dev_bus_info; rte_dev_devargs; + rte_dev_dma_map; + rte_dev_dma_unmap; rte_dev_driver; + rte_dev_event_callback_process; + rte_dev_event_callback_register; + rte_dev_event_callback_unregister; + rte_dev_event_monitor_start; + rte_dev_event_monitor_stop; + rte_dev_hotplug_handle_disable; + rte_dev_hotplug_handle_enable; rte_dev_is_probed; + rte_dev_iterator_init; + rte_dev_iterator_next; rte_dev_name; rte_dev_numa_node; rte_dev_probe;
@@ -309,28 +320,11 @@ DPDK_24 { EXPERIMENTAL { global: - # added in 18.05 - rte_dev_event_callback_register; - rte_dev_event_callback_unregister; - rte_dev_event_monitor_start; - rte_dev_event_monitor_stop; - # added in 18.08 rte_class_find; rte_class_find_by_name; rte_class_register; rte_class_unregister; - rte_dev_iterator_init; - rte_dev_iterator_next; - - # added in 18.11 - rte_dev_event_callback_process; - rte_dev_hotplug_handle_disable; - rte_dev_hotplug_handle_enable; - - # added in 19.05 - rte_dev_dma_map; - rte_dev_dma_unmap; # added in 20.05 __rte_eal_trace_generic_double;
Signature · 1 line
2.39.2
PATCH 3/15 eal: make rte_class API's stable
In reply to Stephen HemmingerThese API's have been around for a while.
--- lib/eal/include/rte_class.h | 4 ---- lib/eal/version.map | 10 ++++------ 2 files changed, 4 insertions(+), 10 deletions(-)
lib/eal/include/rte_class.h +0 -4
@@ -76,7 +76,6 @@ typedef int (*rte_class_cmp_t)(const struct rte_class *cls, const void *data);* @return * A pointer to a rte_class structure or NULL in case no class matches */ -__rte_experimental struct rte_class *rte_class_find (const struct rte_class *start,rte_class_cmp_t cmp,const void *data);
@@ -84,7 +83,6 @@ rte_class_find(const struct rte_class *start, rte_class_cmp_t cmp,/** * Find the registered class for a given name. */ -__rte_experimental struct rte_class *rte_class_find_by_name (const char *name);
@@ -95,7 +93,6 @@ rte_class_find_by_name(const char *name);* A pointer to a rte_class structure describing the class * to be registered. */ -__rte_experimental void rte_class_register (struct rte_class *cls);/**
@@ -105,7 +102,6 @@ void rte_class_register(struct rte_class *cls);* A pointer to a rte_class structure describing the class * to be unregistered. */ -__rte_experimental void rte_class_unregister (struct rte_class *cls);/**
lib/eal/version.map +4 -6
@@ -17,6 +17,10 @@ DPDK_24 { rte_bus_scan; rte_calloc; rte_calloc_socket; + rte_class_find; + rte_class_find_by_name; + rte_class_register; + rte_class_unregister; rte_cpu_get_flag_enabled; rte_cpu_get_flag_name; rte_cpu_is_supported; # WINDOWS_NO_EXPORT
@@ -320,12 +324,6 @@ DPDK_24 { EXPERIMENTAL { global: - # added in 18.08 - rte_class_find; - rte_class_find_by_name; - rte_class_register; - rte_class_unregister; - # added in 20.05 __rte_eal_trace_generic_double; __rte_eal_trace_generic_float;
Signature · 1 line
2.39.2
PATCH 4/15 eal: make rte_version_XXX API's stable
In reply to Stephen HemmingerThe subparts of rte_version were added in 2020 and can now be marked stable.
--- lib/eal/include/rte_version.h | 6 ------ lib/eal/version.map | 12 ++++++------ 2 files changed, 6 insertions(+), 12 deletions(-)
lib/eal/include/rte_version.h +0 -6
@@ -35,37 +35,31 @@ extern "C" {/** * Function to return DPDK version prefix string */ -__rte_experimental const char *rte_version_prefix (void );/** * Function to return DPDK version year */ -__rte_experimental unsigned int rte_version_year (void );/** * Function to return DPDK version month */ -__rte_experimental unsigned int rte_version_month (void );/** * Function to return DPDK minor version number */ -__rte_experimental unsigned int rte_version_minor (void );/** * Function to return DPDK version suffix for any release candidates */ -__rte_experimental const char *rte_version_suffix (void );/** * Function to return DPDK version release candidate value */ -__rte_experimental unsigned int rte_version_release (void );/**
lib/eal/version.map +6 -6
@@ -299,6 +299,12 @@ DPDK_24 { rte_uuid_parse; rte_uuid_unparse; rte_version; + rte_version_minor; + rte_version_month; + rte_version_prefix; + rte_version_release; + rte_version_suffix; + rte_version_year; rte_vfio_clear_group; # WINDOWS_NO_EXPORT rte_vfio_container_create; # WINDOWS_NO_EXPORT rte_vfio_container_destroy; # WINDOWS_NO_EXPORT
@@ -381,12 +387,6 @@ EXPERIMENTAL { rte_thread_key_delete; rte_thread_value_get; rte_thread_value_set; - rte_version_minor; - rte_version_month; - rte_version_prefix; - rte_version_release; - rte_version_suffix; - rte_version_year; # added in 21.08 rte_power_monitor_multi; # WINDOWS_NO_EXPORT
Signature · 1 line
2.39.2
Re: [PATCH 04/15] eal: make rte_version_XXX API's stable
Quoted 5 lines · Stephen Hemminger
The subparts of
rte_versionwere added in 2020 and can now be marked stable.Signed-off-by Stephen Hemminger <[email protected]>---
PATCH 5/15 eal: make rte_drand a stable API
In reply to Stephen HemmingerThis API was added in 2020.
--- lib/eal/include/rte_random.h | 4 ---- 1 file changed, 4 deletions(-)
lib/eal/include/rte_random.h +0 -4
@@ -68,9 +68,6 @@ uint64_t rte_rand_max(uint64_t upper_bound);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Generates a pseudo-random floating point number. * * This function returns a non-negative double-precision floating random
@@ -84,7 +81,6 @@ rte_rand_max(uint64_t upper_bound);* @return * A pseudo-random value between 0 and 1.0. */ -__rte_experimental double rte_drand (void );#ifdef __cplusplus
Signature · 1 line
2.39.2
PATCH 6/15 eal: make rte_service_lcore_may_be_active stable
In reply to Stephen HemmingerThis API was added in 2020.
--- lib/eal/include/rte_service.h | 1 - lib/eal/version.map | 4 ++-- 2 files changed, 2 insertions(+), 3 deletions(-)
lib/eal/include/rte_service.h +0 -1
@@ -275,7 +275,6 @@ int32_t rte_service_lcore_stop(uint32_t lcore_id);* @retval 1 Service thread is in the service core polling loop. * @retval -EINVAL Invalid *lcore_id* provided. */ -__rte_experimental int32_t rte_service_lcore_may_be_active (uint32_t lcore_id);/**
lib/eal/version.map +2 -2
@@ -58,6 +58,7 @@ DPDK_24 { rte_devargs_parsef; rte_devargs_remove; rte_devargs_type_count; + rte_drand; rte_driver_name; rte_dump_physmem_layout; rte_dump_stack;
@@ -265,6 +266,7 @@ DPDK_24 { rte_service_lcore_count_services; rte_service_lcore_del; rte_service_lcore_list; + rte_service_lcore_may_be_active; rte_service_lcore_reset_all; rte_service_lcore_start; rte_service_lcore_stop;
@@ -371,7 +373,6 @@ EXPERIMENTAL { # added in 20.11 __rte_eal_trace_generic_size_t; # WINDOWS_NO_EXPORT rte_cpu_get_intrinsics_support; # WINDOWS_NO_EXPORT - rte_service_lcore_may_be_active; rte_vect_get_max_simd_bitwidth; rte_vect_set_max_simd_bitwidth;
@@ -400,7 +401,6 @@ EXPERIMENTAL { rte_intr_type_set; # added in 22.07 - rte_drand; rte_thread_get_affinity_by_id; rte_thread_get_priority; rte_thread_self;
Signature · 1 line
2.39.2
RE: [PATCH 06/15] eal: make rte_service_lcore_may_be_active stable
Quoted 11 lines
-----Original Message-----
From: Stephen Hemminger <[email protected]>
Sent: Wednesday, August 9, 2023 5:43 PM
To: [email protected]
Cc: Stephen Hemminger <[email protected]>; Van Haaren, Harry <[email protected]>
Subject: [PATCH 06/15] eal: makerte_service_lcore_may_be_activestableThis API was added in 2020.
Signed-off-by Stephen Hemminger <[email protected]>
It looks like parts of the "rte_drand" patch accidentally got into the service-cores patch, with that minor update;
<snip>
Below diffs to 5/15 rte_drand patch.
Quoted 12 lines
lib/eal/version.map +1
-0@@ -58,6 +58,7 @@ DPDK_24 { rte_devargs_parsef; rte_devargs_remove; rte_devargs_type_count; + rte_drand; rte_driver_name; rte_dump_physmem_layout; rte_dump_stack;
<snip>
Quoted 10 lines
lib/eal/version.map +0
-2@@ -400,7 +401,6 @@ EXPERIMENTAL { rte_intr_type_set; # added in 22.07 - rte_drand; rte_thread_get_affinity_by_id; rte_thread_get_priority; rte_thread_self; --2.39.2
PATCH 7/15 eal: make rte_devargs_reset stable
In reply to Stephen HemmingerWas added in 20.05 release.
--- lib/eal/include/rte_devargs.h | 1 - lib/eal/version.map | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-)
lib/eal/include/rte_devargs.h +0 -1
@@ -169,7 +169,6 @@ __rte_format_printf(2, 0);* @param da * The devargs structure holding the device information. */ -__rte_experimental void rte_devargs_reset (struct rte_devargs *da);
lib/eal/version.map +1 -1
@@ -57,6 +57,7 @@ DPDK_24 { rte_devargs_parse; rte_devargs_parsef; rte_devargs_remove; + rte_devargs_reset; rte_devargs_type_count; rte_drand; rte_driver_name;
@@ -382,7 +383,6 @@ EXPERIMENTAL { rte_power_pause; # WINDOWS_NO_EXPORT # added in 21.05 - rte_devargs_reset; rte_intr_callback_unregister_sync; rte_thread_key_create; rte_thread_key_delete;
Signature · 1 line
2.39.2
PATCH 8/15 eal: make pflock API stable
In reply to Stephen HemmingerAdded in 21.11 release.
--- lib/eal/include/rte_pflock.h | 20 -------------------- 1 file changed, 20 deletions(-)
lib/eal/include/rte_pflock.h +0 -20
@@ -79,15 +79,11 @@ typedef struct rte_pflock rte_pflock_t;#define RTE_PFLOCK_INITIALIZER { }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the pflock to an unlocked state. * * @param pf * A pointer to the pflock. */ -__rte_experimental static inline void rte_pflock_init (struct rte_pflock *pf) {
@@ -98,15 +94,11 @@ rte_pflock_init(struct rte_pflock *pf) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Take a pflock for read. * * @param pf * A pointer to a pflock structure. */ -__rte_experimental static inline void rte_pflock_read_lock (rte_pflock_t *pf) {
@@ -127,15 +119,11 @@ rte_pflock_read_lock(rte_pflock_t *pf) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Release a pflock locked for reading. * * @param pf * A pointer to the pflock structure. */ -__rte_experimental static inline void rte_pflock_read_unlock (rte_pflock_t *pf) {
@@ -143,15 +131,11 @@ rte_pflock_read_unlock(rte_pflock_t *pf) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Take the pflock for write. * * @param pf * A pointer to the pflock structure. */ -__rte_experimental static inline void rte_pflock_write_lock (rte_pflock_t *pf) {
@@ -179,15 +163,11 @@ rte_pflock_write_lock(rte_pflock_t *pf) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Release a pflock held for writing. * * @param pf * A pointer to a pflock structure. */ -__rte_experimental static inline void rte_pflock_write_unlock (rte_pflock_t *pf) {
Signature · 1 line
2.39.2
PATCH 9/15 eal: make seqcount and seqlock stable
In reply to Stephen HemmingerThese were add back in 22.07 release.
--- lib/eal/include/rte_seqcount.h | 23 ----------------------- lib/eal/include/rte_seqlock.h | 21 --------------------- 2 files changed, 44 deletions(-)
lib/eal/include/rte_seqcount.h +0 -23
@@ -40,15 +40,11 @@ typedef struct {#define RTE_SEQCOUNT_INITIALIZER { .sn = 0 }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the sequence counter. * * @param seqcount * A pointer to the sequence counter. */ -__rte_experimental static inline void rte_seqcount_init (rte_seqcount_t *seqcount) {
@@ -56,9 +52,6 @@ rte_seqcount_init(rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a read-side critical section. * * A call to this function marks the beginning of a read-side critical
@@ -100,8 +93,6 @@ rte_seqcount_init(rte_seqcount_t *seqcount)* * @see rte_seqcount_read_retry() */ - -__rte_experimental static inline uint32_t rte_seqcount_read_begin (const rte_seqcount_t *seqcount) {
@@ -113,9 +104,6 @@ rte_seqcount_read_begin(const rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a read-side critical section. * * A call to this function marks the end of a read-side critical
@@ -145,8 +133,6 @@ rte_seqcount_read_begin(const rte_seqcount_t *seqcount)* * @see rte_seqcount_read_begin() */ - -__rte_experimental static inline bool rte_seqcount_read_retry (const rte_seqcount_t *seqcount,uint32_t begin_sn) {
@@ -171,9 +157,6 @@ rte_seqcount_read_retry(const rte_seqcount_t *seqcount, uint32_t begin_sn) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a write-side critical section. * * A call to this function marks the beginning of a write-side
@@ -195,8 +178,6 @@ rte_seqcount_read_retry(const rte_seqcount_t *seqcount, uint32_t begin_sn)* * @see rte_seqcount_write_end() */ - -__rte_experimental static inline void rte_seqcount_write_begin (rte_seqcount_t *seqcount) {
@@ -213,9 +194,6 @@ rte_seqcount_write_begin(rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a write-side critical section. * * A call to this function marks the end of the write-side critical
@@ -227,7 +205,6 @@ rte_seqcount_write_begin(rte_seqcount_t *seqcount)* * @see rte_seqcount_write_begin() */ -__rte_experimental static inline void rte_seqcount_write_end (rte_seqcount_t *seqcount) {
lib/eal/include/rte_seqlock.h +0 -21
@@ -114,9 +114,6 @@ typedef struct { }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the seqlock. * * This function initializes the seqlock, and leaves the writer-side
@@ -125,7 +122,6 @@ typedef struct {* @param seqlock * A pointer to the seqlock. */ -__rte_experimental static inline void rte_seqlock_init (rte_seqlock_t *seqlock) {
@@ -134,9 +130,6 @@ rte_seqlock_init(rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a read-side critical section. * * See rte_seqcount_read_retry() for details.
@@ -150,8 +143,6 @@ rte_seqlock_init(rte_seqlock_t *seqlock)* @see rte_seqlock_read_retry() * @see rte_seqcount_read_retry() */ - -__rte_experimental static inline uint32_t rte_seqlock_read_begin (const rte_seqlock_t *seqlock) {
@@ -159,9 +150,6 @@ rte_seqlock_read_begin(const rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a read-side critical section. * * See rte_seqcount_read_retry() for details.
@@ -177,7 +165,6 @@ rte_seqlock_read_begin(const rte_seqlock_t *seqlock)* * @see rte_seqlock_read_begin() */ -__rte_experimental static inline bool rte_seqlock_read_retry (const rte_seqlock_t *seqlock,uint32_t begin_sn) {
@@ -185,9 +172,6 @@ rte_seqlock_read_retry(const rte_seqlock_t *seqlock, uint32_t begin_sn) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a write-side critical section. * * A call to this function acquires the write lock associated @p
@@ -212,7 +196,6 @@ rte_seqlock_read_retry(const rte_seqlock_t *seqlock, uint32_t begin_sn)* * @see rte_seqlock_write_unlock() */ -__rte_experimental static inline void rte_seqlock_write_lock(rte_seqlock_t *seqlock) __rte_exclusive_lock_function(&seqlock->lock)
@@ -224,9 +207,6 @@ rte_seqlock_write_lock(rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a write-side critical section. * * A call to this function marks the end of the write-side critical
@@ -238,7 +218,6 @@ rte_seqlock_write_lock(rte_seqlock_t *seqlock)* * @see rte_seqlock_write_lock() */ -__rte_experimental static inline void rte_seqlock_write_unlock(rte_seqlock_t *seqlock) __rte_unlock_function(&seqlock->lock)
Signature · 1 line
2.39.2
Re: [PATCH 09/15] eal: make seqcount and seqlock stable
Quoted 8 lines · Stephen Hemminger
These were add back in 22.07 release.
Signed-off-by Stephen Hemminger <[email protected]>--- lib/eal/include/rte_seqcount.h | 23 ----------------------- lib/eal/include/rte_seqlock.h | 21 --------------------- 2 files changed, 44 deletions(-)
Quoted 190 lines
lib/eal/include/rte_seqcount.h +0
-23@@ -40,15 +40,11 @@ typedef struct {#define RTE_SEQCOUNT_INITIALIZER { .sn = 0 }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the sequence counter. * * @param seqcount * A pointer to the sequence counter. */ -__rte_experimental static inline void rte_seqcount_init (rte_seqcount_t *seqcount) {@@ -56,9 +52,6 @@ rte_seqcount_init(rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a read-side critical section. * * A call to this function marks the beginning of a read-side critical @@ -100,8 +93,6 @@ rte_seqcount_init(rte_seqcount_t *seqcount)* * @see rte_seqcount_read_retry() */ - -__rte_experimental static inline uint32_t rte_seqcount_read_begin (const rte_seqcount_t *seqcount) {@@ -113,9 +104,6 @@ rte_seqcount_read_begin(const rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a read-side critical section. * * A call to this function marks the end of a read-side critical @@ -145,8 +133,6 @@ rte_seqcount_read_begin(const rte_seqcount_t *seqcount)* * @see rte_seqcount_read_begin() */ - -__rte_experimental static inline bool rte_seqcount_read_retry (const rte_seqcount_t *seqcount,uint32_t begin_sn) {@@ -171,9 +157,6 @@ rte_seqcount_read_retry(const rte_seqcount_t *seqcount, uint32_t begin_sn) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a write-side critical section. * * A call to this function marks the beginning of a write-side @@ -195,8 +178,6 @@ rte_seqcount_read_retry(const rte_seqcount_t *seqcount, uint32_t begin_sn)* * @see rte_seqcount_write_end() */ - -__rte_experimental static inline void rte_seqcount_write_begin (rte_seqcount_t *seqcount) {@@ -213,9 +194,6 @@ rte_seqcount_write_begin(rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a write-side critical section. * * A call to this function marks the end of the write-side critical @@ -227,7 +205,6 @@ rte_seqcount_write_begin(rte_seqcount_t *seqcount)* * @see rte_seqcount_write_begin() */ -__rte_experimental static inline void rte_seqcount_write_end (rte_seqcount_t *seqcount) {lib/eal/include/rte_seqlock.h +0
-21@@ -114,9 +114,6 @@ typedef struct { }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the seqlock. * * This function initializes the seqlock, and leaves the writer-side @@ -125,7 +122,6 @@ typedef struct {* @param seqlock * A pointer to the seqlock. */ -__rte_experimental static inline void rte_seqlock_init (rte_seqlock_t *seqlock) {@@ -134,9 +130,6 @@ rte_seqlock_init(rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a read-side critical section. * * See rte_seqcount_read_retry() for details. @@ -150,8 +143,6 @@ rte_seqlock_init(rte_seqlock_t *seqlock)* @see rte_seqlock_read_retry() * @see rte_seqcount_read_retry() */ - -__rte_experimental static inline uint32_t rte_seqlock_read_begin (const rte_seqlock_t *seqlock) {@@ -159,9 +150,6 @@ rte_seqlock_read_begin(const rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a read-side critical section. * * See rte_seqcount_read_retry() for details. @@ -177,7 +165,6 @@ rte_seqlock_read_begin(const rte_seqlock_t *seqlock)* * @see rte_seqlock_read_begin() */ -__rte_experimental static inline bool rte_seqlock_read_retry (const rte_seqlock_t *seqlock,uint32_t begin_sn) {@@ -185,9 +172,6 @@ rte_seqlock_read_retry(const rte_seqlock_t *seqlock, uint32_t begin_sn) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a write-side critical section. * * A call to this function acquires the write lock associated @p @@ -212,7 +196,6 @@ rte_seqlock_read_retry(const rte_seqlock_t *seqlock, uint32_t begin_sn)* * @see rte_seqlock_write_unlock() */ -__rte_experimental static inline void rte_seqlock_write_lock(rte_seqlock_t *seqlock) __rte_exclusive_lock_function(&seqlock->lock)@@ -224,9 +207,6 @@ rte_seqlock_write_lock(rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a write-side critical section. * * A call to this function marks the end of the write-side critical @@ -238,7 +218,6 @@ rte_seqlock_write_lock(rte_seqlock_t *seqlock)* * @see rte_seqlock_write_lock() */ -__rte_experimental static inline void rte_seqlock_write_unlock(rte_seqlock_t *seqlock) __rte_unlock_function(&seqlock->lock)
PATCH 10/15 eal: mark rte_intr_XXX API's as stable
In reply to Stephen HemmingerThese were added back in 2020.
--- lib/eal/include/rte_interrupts.h | 28 ---------------------------- lib/eal/version.map | 14 +++++++------- 2 files changed, 7 insertions(+), 35 deletions(-)
lib/eal/include/rte_interrupts.h +0 -28
@@ -127,9 +127,6 @@ rte_intr_callback_unregister_pending(const struct rte_intr_handle *intr_handle, rte_intr_unregister_callback_fn ucb_fn);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Loop until rte_intr_callback_unregister() succeeds. * After a call to this function, * the callback provided by the specified interrupt handle is unregistered.
@@ -146,7 +143,6 @@ rte_intr_callback_unregister_pending(const struct rte_intr_handle *intr_handle,* - On success, return the number of callback entities removed. * - On failure, a negative value. */ -__rte_experimental int rte_intr_callback_unregister_sync (const struct rte_intr_handle *intr_handle,rte_intr_callback_fn cb,void *cb_arg);
@@ -201,9 +197,6 @@ int rte_intr_ack(const struct rte_intr_handle *intr_handle);int rte_thread_is_intr (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * It allocates memory for interrupt instance. API takes flag as an argument * which define from where memory should be allocated i.e. using DPDK memory * management library APIs or normal heap allocation.
@@ -221,28 +214,20 @@ int rte_thread_is_intr(void);* - On success, address of interrupt handle. * - On failure, NULL. */ -__rte_experimental struct rte_intr_handle *rte_intr_instance_alloc (uint32_t flags);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Free the memory allocated for interrupt handle resources. * * @param intr_handle * Interrupt handle allocated with rte_intr_instance_alloc(). * If intr_handle is NULL, no operation is performed. */ -__rte_experimental void rte_intr_instance_free (struct rte_intr_handle *intr_handle);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Set the fd field of interrupt handle with user provided * file descriptor. *
@@ -255,14 +240,10 @@ rte_intr_instance_free(struct rte_intr_handle *intr_handle);* - On success, zero. * - On failure, a negative value and rte_errno is set. */ -__rte_experimental int rte_intr_fd_set (struct rte_intr_handle *intr_handle,int fd);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Returns the fd field of the given interrupt handle instance. * * @param intr_handle
@@ -272,14 +253,10 @@ rte_intr_fd_set(struct rte_intr_handle *intr_handle, int fd);* - On success, fd field. * - On failure, a negative value. */ -__rte_experimental int rte_intr_fd_get (const struct rte_intr_handle *intr_handle);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Set the type field of interrupt handle with user provided * interrupt type. *
@@ -292,15 +269,11 @@ rte_intr_fd_get(const struct rte_intr_handle *intr_handle);* - On success, zero. * - On failure, a negative value and rte_errno is set. */ -__rte_experimental int rte_intr_type_set (struct rte_intr_handle *intr_handle,enum rte_intr_handle_type type);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Returns the type field of the given interrupt handle instance. * * @param intr_handle
@@ -310,7 +283,6 @@ rte_intr_type_set(struct rte_intr_handle *intr_handle,* - On success, interrupt type * - On failure, RTE_INTR_HANDLE_UNKNOWN. */ -__rte_experimental enum rte_intr_handle_type rte_intr_type_get (const struct rte_intr_handle *intr_handle);
lib/eal/version.map +7 -7
@@ -138,8 +138,15 @@ DPDK_24 { rte_intr_callback_register; rte_intr_callback_unregister; rte_intr_callback_unregister_pending; + rte_intr_callback_unregister_sync; rte_intr_disable; rte_intr_enable; + rte_intr_fd_get; + rte_intr_fd_set; + rte_intr_instance_alloc; + rte_intr_instance_free; + rte_intr_type_get; + rte_intr_type_set; rte_keepalive_create; # WINDOWS_NO_EXPORT rte_keepalive_dispatch_pings; # WINDOWS_NO_EXPORT rte_keepalive_mark_alive; # WINDOWS_NO_EXPORT
@@ -383,7 +390,6 @@ EXPERIMENTAL { rte_power_pause; # WINDOWS_NO_EXPORT # added in 21.05 - rte_intr_callback_unregister_sync; rte_thread_key_create; rte_thread_key_delete; rte_thread_value_get;
@@ -393,12 +399,6 @@ EXPERIMENTAL { rte_power_monitor_multi; # WINDOWS_NO_EXPORT # added in 21.11 - rte_intr_fd_get; - rte_intr_fd_set; - rte_intr_instance_alloc; - rte_intr_instance_free; - rte_intr_type_get; - rte_intr_type_set; # added in 22.07 rte_thread_get_affinity_by_id;
Signature · 1 line
2.39.2
PATCH 11/15 eal: mark rte_atomic128_cmp_exchange as stable
In reply to Stephen HemmingerThis has been around since 2021.
--- lib/eal/arm/include/rte_atomic_64.h | 1 - lib/eal/include/generic/rte_atomic.h | 1 - lib/eal/x86/include/rte_atomic_64.h | 1 - 3 files changed, 3 deletions(-)
lib/eal/arm/include/rte_atomic_64.h +0 -1
@@ -94,7 +94,6 @@ __ATOMIC128_CAS_OP(__cas_128_acq_rel, "caspal")#endif -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp, const rte_int128_t *src, unsigned int weak, int success,
lib/eal/include/generic/rte_atomic.h +0 -1
@@ -1121,7 +1121,6 @@ typedef struct {* @return * Non-zero on success; 0 on failure. */ -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp,
lib/eal/x86/include/rte_atomic_64.h +0 -1
@@ -182,7 +182,6 @@ static inline void rte_atomic64_clear(rte_atomic64_t *v)/*------------------------ 128 bit atomic operations -------------------------*/ -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp,
Signature · 1 line
2.39.2
Re: [PATCH 11/15] eal: mark rte_atomic128_cmp_exchange as stable
Quoted 38 lines · Stephen Hemminger
This has been around since 2021.
Signed-off-by Stephen Hemminger <[email protected]>--- lib/eal/arm/include/rte_atomic_64.h | 1 - lib/eal/include/generic/rte_atomic.h | 1 - lib/eal/x86/include/rte_atomic_64.h | 1 - 3 files changed, 3 deletions(-)lib/eal/arm/include/rte_atomic_64.h +0
-1@@ -94,7 +94,6 @@ __ATOMIC128_CAS_OP(__cas_128_acq_rel, "caspal")#endif -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp, const rte_int128_t *src, unsigned int weak, int success,lib/eal/include/generic/rte_atomic.h +0
-1@@ -1121,7 +1121,6 @@ typedef struct {* @return * Non-zero on success; 0 on failure. */ -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp,lib/eal/x86/include/rte_atomic_64.h +0
-0
lib/eal/x86/include/rte_atomic_64.h static inline void rte_atomic64_clear(rte_atomic64_t *v) · line 187
Quoted 7 lines
lib/eal/x86/include/rte_atomic_64.h +0
-1@@ -182,7 +182,6 @@ static inline void rte_atomic64_clear(rte_atomic64_t *v)/*------------------------ 128 bit atomic operations -------------------------*/ -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp,
I'm wondering if given the fluidity of changes in atomics right now we should hold this for a little while / close to the end of the merge window just in case we want to adjust it?
Quoted 2 lines
Signature · 1 line
2.39.2
PATCH 12/15 eal: make most rte_thread API's stable
In reply to Stephen HemmingerAll rte_thread API's added before 23.03 release should be marked as not experimental.
--- lib/eal/include/rte_thread.h | 57 ------------------------------------ lib/eal/version.map | 41 +++++++++++--------------- 2 files changed, 17 insertions(+), 81 deletions(-)
lib/eal/include/rte_thread.h +0 -57
@@ -68,9 +68,6 @@ typedef struct {typedef struct eal_tls_key *rte_thread_key ;/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Create a new thread that will invoke the 'thread_func' routine. * * @param thread_id
@@ -89,7 +86,6 @@ typedef struct eal_tls_key *rte_thread_key;* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_create (rte_thread_t *thread_id,const rte_thread_attr_t *thread_attr,rte_thread_func thread_func,void *arg);
@@ -128,9 +124,6 @@ rte_thread_create_control(rte_thread_t *thread, const char *name, void *arg);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Waits for the thread identified by 'thread_id' to terminate * * @param thread_id
@@ -143,13 +136,9 @@ rte_thread_create_control(rte_thread_t *thread, const char *name,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_join (rte_thread_t thread_id,uint32_t *value_ptr);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Indicate that the return value of the thread is not needed and * all thread resources should be release when the thread terminates. *
@@ -160,19 +149,14 @@ int rte_thread_join(rte_thread_t thread_id, uint32_t *value_ptr);* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_detach (rte_thread_t thread_id);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Get the id of the calling thread. * * @return * Return the thread id of the calling thread. */ -__rte_experimental rte_thread_t rte_thread_self (void );/**
@@ -196,9 +180,6 @@ void rte_thread_set_name(rte_thread_t thread_id, const char *thread_name);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Check if 2 thread ids are equal. * * @param t1
@@ -211,13 +192,9 @@ rte_thread_set_name(rte_thread_t thread_id, const char *thread_name);* If the ids are equal, return nonzero. * Otherwise, return 0. */ -__rte_experimental int rte_thread_equal (rte_thread_t t1,rte_thread_t t2);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the attributes of a thread. * These attributes can be passed to the rte_thread_create() function * that will create a new thread and set its attributes according to attr.
@@ -229,13 +206,9 @@ int rte_thread_equal(rte_thread_t t1, rte_thread_t t2);* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_attr_init (rte_thread_attr_t *attr);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Set the thread priority value in the thread attributes pointed to * by 'thread_attr'. *
@@ -249,16 +222,12 @@ int rte_thread_attr_init(rte_thread_attr_t *attr);* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_attr_set_priority (rte_thread_attr_t *thread_attr,enum rte_thread_priority priority);#ifdef RTE_HAS_CPUSET /** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Set the CPU affinity value in the thread attributes pointed to * by 'thread_attr'. *
@@ -272,14 +241,10 @@ int rte_thread_attr_set_priority(rte_thread_attr_t *thread_attr,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_attr_set_affinity (rte_thread_attr_t *thread_attr,rte_cpuset_t *cpuset);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Get the value of CPU affinity that is set in the thread attributes pointed * to by 'thread_attr'. *
@@ -293,14 +258,10 @@ int rte_thread_attr_set_affinity(rte_thread_attr_t *thread_attr,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_attr_get_affinity (rte_thread_attr_t *thread_attr,rte_cpuset_t *cpuset);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Set the affinity of thread 'thread_id' to the cpu set * specified by 'cpuset'. *
@@ -314,14 +275,10 @@ int rte_thread_attr_get_affinity(rte_thread_attr_t *thread_attr,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_set_affinity_by_id (rte_thread_t thread_id,const rte_cpuset_t *cpuset);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Get the affinity of thread 'thread_id' and store it * in 'cpuset'. *
@@ -335,7 +292,6 @@ int rte_thread_set_affinity_by_id(rte_thread_t thread_id,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_get_affinity_by_id (rte_thread_t thread_id,rte_cpuset_t *cpuset);
@@ -362,9 +318,6 @@ void rte_thread_get_affinity(rte_cpuset_t *cpusetp);#endif /* RTE_HAS_CPUSET */ /** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Get the priority of a thread. * * @param thread_id
@@ -377,14 +330,10 @@ void rte_thread_get_affinity(rte_cpuset_t *cpusetp);* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_get_priority (rte_thread_t thread_id,enum rte_thread_priority *priority);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Set the priority of a thread. * * @param thread_id
@@ -397,7 +346,6 @@ int rte_thread_get_priority(rte_thread_t thread_id,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_set_priority (rte_thread_t thread_id,enum rte_thread_priority priority);
@@ -418,8 +366,6 @@ int rte_thread_set_priority(rte_thread_t thread_id,* rte_errno can be: ENOMEM - Memory allocation error. * ENOEXEC - Specific OS error. */ - -__rte_experimental int rte_thread_key_create (rte_thread_key *key,void (*destructor)(void *));
@@ -435,7 +381,6 @@ int rte_thread_key_create(rte_thread_key *key,* rte_errno can be: EINVAL - Invalid parameter passed. * ENOEXEC - Specific OS error. */ -__rte_experimental int rte_thread_key_delete (rte_thread_key key);/**
@@ -452,7 +397,6 @@ int rte_thread_key_delete(rte_thread_key key);* rte_errno can be: EINVAL - Invalid parameter passed. * ENOEXEC - Specific OS error. */ -__rte_experimental int rte_thread_value_set (rte_thread_key key,const void *value);/**
@@ -467,7 +411,6 @@ int rte_thread_value_set(rte_thread_key key, const void *value);* rte_errno can be: EINVAL - Invalid parameter passed. * ENOEXEC - Specific OS error. */ -__rte_experimental void *rte_thread_value_get (rte_thread_key key);#ifdef __cplusplus
lib/eal/version.map +17 -24
63 lines not on this page · raw message
Signature · 1 line
2.39.2
Re: [PATCH 12/15] eal: make most rte_thread API's stable
Quoted 5 lines · Stephen Hemminger
All
rte_threadAPI's added before 23.03 release should be marked as not experimental.Signed-off-by Stephen Hemminger <[email protected]>---
Already acked the series but since i know about this set here's an explicit ack.
note: i have on my todo list but still haven't managed to get to it adding the __rte_deprecated to rte_ctrl_thread_create which has a posix name in the signature. rte_thread_create_control was introduced as a replacement in .. 23.07.
Quoted 315 lines
lib/eal/include/rte_thread.h | 57 ------------------------------------ lib/eal/version.map | 41 +++++++++++--------------- 2 files changed, 17 insertions(+), 81 deletions(-)lib/eal/include/rte_thread.h +0
-57@@ -68,9 +68,6 @@ typedef struct {typedef struct eal_tls_key *rte_thread_key ;/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Create a new thread that will invoke the 'thread_func' routine. * * @param thread_id @@ -89,7 +86,6 @@ typedef struct eal_tls_key *rte_thread_key;* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_create (rte_thread_t *thread_id,const rte_thread_attr_t *thread_attr,rte_thread_func thread_func,void *arg);@@ -128,9 +124,6 @@ rte_thread_create_control(rte_thread_t *thread, const char *name, void *arg);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Waits for the thread identified by 'thread_id' to terminate * * @param thread_id @@ -143,13 +136,9 @@ rte_thread_create_control(rte_thread_t *thread, const char *name,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_join (rte_thread_t thread_id,uint32_t *value_ptr);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Indicate that the return value of the thread is not needed and * all thread resources should be release when the thread terminates. * @@ -160,19 +149,14 @@ int rte_thread_join(rte_thread_t thread_id, uint32_t *value_ptr);* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_detach (rte_thread_t thread_id);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Get the id of the calling thread. * * @return * Return the thread id of the calling thread. */ -__rte_experimental rte_thread_t rte_thread_self (void );/** @@ -196,9 +180,6 @@ void rte_thread_set_name(rte_thread_t thread_id, const char *thread_name);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Check if 2 thread ids are equal. * * @param t1 @@ -211,13 +192,9 @@ rte_thread_set_name(rte_thread_t thread_id, const char *thread_name);* If the ids are equal, return nonzero. * Otherwise, return 0. */ -__rte_experimental int rte_thread_equal (rte_thread_t t1,rte_thread_t t2);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the attributes of a thread. * These attributes can be passed to the rte_thread_create() function * that will create a new thread and set its attributes according to attr. @@ -229,13 +206,9 @@ int rte_thread_equal(rte_thread_t t1, rte_thread_t t2);* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_attr_init (rte_thread_attr_t *attr);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Set the thread priority value in the thread attributes pointed to * by 'thread_attr'. * @@ -249,16 +222,12 @@ int rte_thread_attr_init(rte_thread_attr_t *attr);* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_attr_set_priority (rte_thread_attr_t *thread_attr,enum rte_thread_priority priority);#ifdef RTE_HAS_CPUSET /** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Set the CPU affinity value in the thread attributes pointed to * by 'thread_attr'. * @@ -272,14 +241,10 @@ int rte_thread_attr_set_priority(rte_thread_attr_t *thread_attr,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_attr_set_affinity (rte_thread_attr_t *thread_attr,rte_cpuset_t *cpuset);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Get the value of CPU affinity that is set in the thread attributes pointed * to by 'thread_attr'. * @@ -293,14 +258,10 @@ int rte_thread_attr_set_affinity(rte_thread_attr_t *thread_attr,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_attr_get_affinity (rte_thread_attr_t *thread_attr,rte_cpuset_t *cpuset);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Set the affinity of thread 'thread_id' to the cpu set * specified by 'cpuset'. * @@ -314,14 +275,10 @@ int rte_thread_attr_get_affinity(rte_thread_attr_t *thread_attr,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_set_affinity_by_id (rte_thread_t thread_id,const rte_cpuset_t *cpuset);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Get the affinity of thread 'thread_id' and store it * in 'cpuset'. * @@ -335,7 +292,6 @@ int rte_thread_set_affinity_by_id(rte_thread_t thread_id,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_get_affinity_by_id (rte_thread_t thread_id,rte_cpuset_t *cpuset);@@ -362,9 +318,6 @@ void rte_thread_get_affinity(rte_cpuset_t *cpusetp);#endif /* RTE_HAS_CPUSET */ /** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Get the priority of a thread. * * @param thread_id @@ -377,14 +330,10 @@ void rte_thread_get_affinity(rte_cpuset_t *cpusetp);* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_get_priority (rte_thread_t thread_id,enum rte_thread_priority *priority);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Set the priority of a thread. * * @param thread_id @@ -397,7 +346,6 @@ int rte_thread_get_priority(rte_thread_t thread_id,* On success, return 0. * On failure, return a positive errno-style error number. */ -__rte_experimental int rte_thread_set_priority (rte_thread_t thread_id,enum rte_thread_priority priority);@@ -418,8 +366,6 @@ int rte_thread_set_priority(rte_thread_t thread_id,* rte_errno can be: ENOMEM - Memory allocation error. * ENOEXEC - Specific OS error. */ - -__rte_experimental int rte_thread_key_create (rte_thread_key *key,void (*destructor)(void *));@@ -435,7 +381,6 @@ int rte_thread_key_create(rte_thread_key *key,* rte_errno can be: EINVAL - Invalid parameter passed. * ENOEXEC - Specific OS error. */ -__rte_experimental int rte_thread_key_delete (rte_thread_key key);/** @@ -452,7 +397,6 @@ int rte_thread_key_delete(rte_thread_key key);* rte_errno can be: EINVAL - Invalid parameter passed. * ENOEXEC - Specific OS error. */ -__rte_experimental int rte_thread_value_set (rte_thread_key key,const void *value);/** @@ -467,7 +411,6 @@ int rte_thread_value_set(rte_thread_key key, const void *value);* rte_errno can be: EINVAL - Invalid parameter passed. * ENOEXEC - Specific OS error. */ -__rte_experimental void *rte_thread_value_get (rte_thread_key key);#ifdef __cpluspluslib/eal/version.map +17
-24@@ -298,12 +298,29 @@ DPDK_24 { rte_strscpy; rte_strsplit; rte_sys_gettid; + rte_thread_attr_get_affinity; + rte_thread_attr_init; + rte_thread_attr_set_affinity; + rte_thread_attr_set_priority; + rte_thread_create; + rte_thread_detach; + rte_thread_equal; rte_thread_get_affinity; + rte_thread_get_affinity_by_id; + rte_thread_get_priority; rte_thread_is_intr; + rte_thread_join; + rte_thread_key_create; + rte_thread_key_delete; rte_thread_register; + rte_thread_self; rte_thread_set_affinity; + rte_thread_set_affinity_by_id; + rte_thread_set_priority; rte_thread_setname; rte_thread_unregister; + rte_thread_value_get; + rte_thread_value_set; rte_uuid_compare; rte_uuid_is_null; rte_uuid_parse;@@ -389,34 +406,10 @@ EXPERIMENTAL { rte_power_monitor_wakeup; # WINDOWS_NO_EXPORT rte_power_pause; # WINDOWS_NO_EXPORT - # added in 21.05 - rte_thread_key_create; - rte_thread_key_delete; - rte_thread_value_get; - rte_thread_value_set; # added in 21.08 rte_power_monitor_multi; # WINDOWS_NO_EXPORT - # added in 21.11 - - # added in 22.07 - rte_thread_get_affinity_by_id; - rte_thread_get_priority; - rte_thread_self; - rte_thread_set_affinity_by_id; - rte_thread_set_priority; - - # added in 22.11 - rte_thread_attr_get_affinity; - rte_thread_attr_init; - rte_thread_attr_set_affinity; - rte_thread_attr_set_priority; - rte_thread_create; - rte_thread_detach; - rte_thread_equal; - rte_thread_join; - # added in 23.03 rte_lcore_register_usage_cb; rte_thread_create_control;Signature · 1 line
2.39.2
PATCH 13/15 eal: mark rte_power API's stable
In reply to Stephen HemmingerThese were added back in 2020.
--- lib/eal/include/generic/rte_power_intrinsics.h | 16 ---------------- lib/eal/version.map | 13 ++++--------- 2 files changed, 4 insertions(+), 25 deletions(-)
lib/eal/include/generic/rte_power_intrinsics.h +0 -16
@@ -54,9 +54,6 @@ struct rte_power_monitor_cond { };/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Monitor specific address for changes. This will cause the CPU to enter an * architecture-defined optimized power state until either the specified * memory address is written to, a certain TSC timestamp is reached, or other
@@ -84,14 +81,10 @@ struct rte_power_monitor_cond {* -EINVAL on invalid parameters * -ENOTSUP if unsupported */ -__rte_experimental int rte_power_monitor (const struct rte_power_monitor_cond *pmc,const uint64_t tsc_timestamp);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Wake up a specific lcore that is in a power optimized state and is monitoring * an address. *
@@ -104,13 +97,9 @@ int rte_power_monitor(const struct rte_power_monitor_cond *pmc,* @param lcore_id * Lcore ID of a sleeping thread. */ -__rte_experimental int rte_power_monitor_wakeup (const unsigned int lcore_id);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Enter an architecture-defined optimized power state until a certain TSC * timestamp is reached. *
@@ -126,13 +115,9 @@ int rte_power_monitor_wakeup(const unsigned int lcore_id);* -EINVAL on invalid parameters * -ENOTSUP if unsupported */ -__rte_experimental int rte_power_pause (const uint64_t tsc_timestamp);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Monitor a set of addresses for changes. This will cause the CPU to enter an * architecture-defined optimized power state until either one of the specified * memory addresses is written to, a certain TSC timestamp is reached, or other
@@ -160,7 +145,6 @@ int rte_power_pause(const uint64_t tsc_timestamp);* -EINVAL on invalid parameters * -ENOTSUP if unsupported */ -__rte_experimental int rte_power_monitor_multi (const struct rte_power_monitor_cond pmc[],const uint32_t num,const uint64_t tsc_timestamp);
lib/eal/version.map +4 -9
@@ -250,6 +250,10 @@ DPDK_24 { rte_mp_request_sync; rte_mp_sendmsg; rte_openlog_stream; + rte_power_monitor; # WINDOWS_NO_EXPORT + rte_power_monitor_wakeup; # WINDOWS_NO_EXPORT + rte_power_pause; # WINDOWS_NO_EXPORT + rte_power_monitor_multi; # WINDOWS_NO_EXPORT rte_rand; rte_rand_max; rte_realloc;
@@ -401,15 +405,6 @@ EXPERIMENTAL { rte_vect_get_max_simd_bitwidth; rte_vect_set_max_simd_bitwidth; - # added in 21.02 - rte_power_monitor; # WINDOWS_NO_EXPORT - rte_power_monitor_wakeup; # WINDOWS_NO_EXPORT - rte_power_pause; # WINDOWS_NO_EXPORT - - - # added in 21.08 - rte_power_monitor_multi; # WINDOWS_NO_EXPORT - # added in 23.03 rte_lcore_register_usage_cb; rte_thread_create_control;
Signature · 1 line
2.39.2
PATCH 14/15 eal: mark rte_eal_vfio_get_token stable
In reply to Stephen HemmingerThis API was added in 20.08 release.
--- lib/eal/include/rte_eal.h | 4 ---- lib/eal/version.map | 4 +--- 2 files changed, 1 insertion(+), 7 deletions(-)
lib/eal/include/rte_eal.h +0 -4
@@ -412,16 +412,12 @@ int rte_eal_create_uio_dev(void);enum rte_intr_mode rte_eal_vfio_intr_mode (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Copy the user-configured vfio VF token. * * @param vf_token * vfio VF token configured with the command line is copied * into this parameter, zero uuid by default. */ -__rte_experimental void rte_eal_vfio_get_vf_token (rte_uuid_t vf_token);/**
lib/eal/version.map +1 -3
@@ -89,6 +89,7 @@ DPDK_24 { rte_eal_tailq_lookup; rte_eal_tailq_register; rte_eal_using_phys_addrs; + rte_eal_vfio_get_vf_token; # WINDOWS_NO_EXPORT rte_eal_vfio_intr_mode; # WINDOWS_NO_EXPORT rte_eal_wait_lcore; rte_epoll_ctl;
@@ -396,9 +397,6 @@ EXPERIMENTAL { rte_trace_regexp; # WINDOWS_NO_EXPORT rte_trace_save; # WINDOWS_NO_EXPORT - # added in 20.08 - rte_eal_vfio_get_vf_token; # WINDOWS_NO_EXPORT - # added in 20.11 __rte_eal_trace_generic_size_t; # WINDOWS_NO_EXPORT rte_cpu_get_intrinsics_support; # WINDOWS_NO_EXPORT
Signature · 1 line
2.39.2
Re: [PATCH 14/15] eal: mark rte_eal_vfio_get_token stable
Quoted 4 lines · Stephen Hemminger
This API was added in 20.08 release.
Signed-off-by Stephen Hemminger <[email protected]>---
there is driver work going on for similar functionality to vfio on windows. it's possible that this api could be exposed for windows but in the current form may not be suitable.
*not blocking*
just wanted to make you aware, i don't have a firm enough schedule to derail this process.
Quoted 49 lines
lib/eal/include/rte_eal.h | 4 ---- lib/eal/version.map | 4 +--- 2 files changed, 1 insertion(+), 7 deletions(-)lib/eal/include/rte_eal.h +0
-4@@ -412,16 +412,12 @@ int rte_eal_create_uio_dev(void);enum rte_intr_mode rte_eal_vfio_intr_mode (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Copy the user-configured vfio VF token. * * @param vf_token * vfio VF token configured with the command line is copied * into this parameter, zero uuid by default. */ -__rte_experimental void rte_eal_vfio_get_vf_token (rte_uuid_t vf_token);/** lib/eal/version.map +1
-3@@ -89,6 +89,7 @@ DPDK_24 { rte_eal_tailq_lookup; rte_eal_tailq_register; rte_eal_using_phys_addrs; + rte_eal_vfio_get_vf_token; # WINDOWS_NO_EXPORT rte_eal_vfio_intr_mode; # WINDOWS_NO_EXPORT rte_eal_wait_lcore; rte_epoll_ctl;@@ -396,9 +397,6 @@ EXPERIMENTAL { rte_trace_regexp; # WINDOWS_NO_EXPORT rte_trace_save; # WINDOWS_NO_EXPORT - # added in 20.08 - rte_eal_vfio_get_vf_token; # WINDOWS_NO_EXPORT - # added in 20.11 __rte_eal_trace_generic_size_t; # WINDOWS_NO_EXPORT rte_cpu_get_intrinsics_support; # WINDOWS_NO_EXPORTSignature · 1 line
2.39.2
PATCH 15/15 eal: mark rte_vect simd bandwidth API as stable
In reply to Stephen HemmingerThese were added back in 20.11.
--- lib/eal/include/generic/rte_vect.h | 8 -------- lib/eal/version.map | 4 ++-- 2 files changed, 2 insertions(+), 10 deletions(-)
lib/eal/include/generic/rte_vect.h +0 -8
@@ -204,21 +204,14 @@ enum rte_vect_max_simd { };/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Get the supported SIMD bitwidth. * * @return * uint16_t bitwidth. */ -__rte_experimental uint16_t rte_vect_get_max_simd_bitwidth (void );/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Set the supported SIMD bitwidth. * This API should only be called once at initialization, before EAL init. *
@@ -229,7 +222,6 @@ uint16_t rte_vect_get_max_simd_bitwidth(void);* - -EINVAL on invalid bitwidth parameter. * - -EPERM if bitwidth is forced. */ -__rte_experimental int rte_vect_set_max_simd_bitwidth (uint16_t bitwidth);#endif /* _RTE_VECT_H_ */
lib/eal/version.map +2 -2
@@ -330,6 +330,8 @@ DPDK_24 { rte_uuid_is_null; rte_uuid_parse; rte_uuid_unparse; + rte_vect_get_max_simd_bitwidth; + rte_vect_set_max_simd_bitwidth; rte_version; rte_version_minor; rte_version_month;
@@ -400,8 +402,6 @@ EXPERIMENTAL { # added in 20.11 __rte_eal_trace_generic_size_t; # WINDOWS_NO_EXPORT rte_cpu_get_intrinsics_support; # WINDOWS_NO_EXPORT - rte_vect_get_max_simd_bitwidth; - rte_vect_set_max_simd_bitwidth; # added in 23.03 rte_lcore_register_usage_cb;
Signature · 1 line
2.39.2
Quoted 4 lines · Stephen Hemminger
About 80 function in EAL were marked experimental
and should have been made stable by now.
Quoted 16 lines
Stephen Hemminger (15):
eal: make bitops a stable API
eal: markrte_devAPI's as stable
eal: makerte_classAPI's stable
eal: makerte_version_XXXAPI's stable
eal: makerte_dranda stable API
eal: makerte_service_lcore_may_be_activestable
eal: makerte_devargs_resetstable
eal: make pflock API stable
eal: make seqcount and seqlock stable
eal: markrte_intr_XXXAPI's as stable
eal: markrte_atomic128_cmp_exchangeas stable
eal: make mostrte_threadAPI's stable
eal: markrte_powerAPI's stable
eal: markrte_eal_vfio_get_tokenstable
eal: markrte_vectsimd bandwidth API as stable
This needs some rebasing too.
Signature · 1 line
David Marchand
v2 cover eal: mark older API's as stable
In reply to Stephen HemmingerAbout 80 function in EAL were marked experimental
and should have been made stable by now.
v2 - rebase and fix some bits in wrong patch
Stephen Hemminger (14):
eal: make bitops a stable API
eal: mark rte_dev API's as stable
eal: make rte_class API's stable
eal: make rte_drand a stable API
eal: make rte_service_lcore_may_be_active stable
eal: make rte_devargs_reset stable
eal: make pflock API stable
eal: make seqcount and seqlock stable
eal: mark rte_intr_XXX API's as stable
eal: mark rte_atomic128_cmp_exchange as stable
eal: mark rte_power API's stable
eal: mark rte_eal_vfio_get_token stable
eal: mark rte_vect simd bandwidth API as stable
eal: make rte_version API's stable
lib/eal/arm/include/rte_atomic_64.h | 1 - lib/eal/include/generic/rte_atomic.h | 1 - .../include/generic/rte_power_intrinsics.h | 16 ---- lib/eal/include/generic/rte_vect.h | 8 -- lib/eal/include/rte_bitmap.h | 8 -- lib/eal/include/rte_bitops.h | 40 -------- lib/eal/include/rte_class.h | 4 - lib/eal/include/rte_dev.h | 32 ------- lib/eal/include/rte_devargs.h | 1 - lib/eal/include/rte_eal.h | 4 - lib/eal/include/rte_interrupts.h | 28 ------ lib/eal/include/rte_pflock.h | 20 ---- lib/eal/include/rte_random.h | 4 - lib/eal/include/rte_seqcount.h | 23 ----- lib/eal/include/rte_seqlock.h | 21 ---- lib/eal/include/rte_service.h | 1 - lib/eal/include/rte_version.h | 6 -- lib/eal/version.map | 96 ++++++++----------- lib/eal/x86/include/rte_atomic_64.h | 1 - 19 files changed, 38 insertions(+), 277 deletions(-)
Signature · 1 line
2.39.2
PATCH v2 1/14 eal: make bitops a stable API
These were added in 20.05 release.
--- lib/eal/include/rte_bitmap.h | 8 -------- lib/eal/include/rte_bitops.h | 40 ------------------------------------ 2 files changed, 48 deletions(-)
lib/eal/include/rte_bitmap.h +0 -8
@@ -203,9 +203,6 @@ rte_bitmap_init(uint32_t n_bits, uint8_t *mem, uint32_t mem_size) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Bitmap clear slab overhead bits. * * @param slabs
@@ -215,7 +212,6 @@ rte_bitmap_init(uint32_t n_bits, uint8_t *mem, uint32_t mem_size)* @param pos * The start bit position in the slabs to be cleared. */ -__rte_experimental static inline void __rte_bitmap_clear_slab_overhead_bits (uint64_t *slabs,uint32_t slab_size,uint32_t pos)
@@ -235,9 +231,6 @@ __rte_bitmap_clear_slab_overhead_bits(uint64_t *slabs, uint32_t slab_size, }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Bitmap initialization with all bits set * * @param n_bits
@@ -249,7 +242,6 @@ __rte_bitmap_clear_slab_overhead_bits(uint64_t *slabs, uint32_t slab_size,* @return * Handle to bitmap instance. */ -__rte_experimental static inline struct rte_bitmap *rte_bitmap_init_with_all_set (uint32_t n_bits,uint8_t *mem,uint32_t mem_size) {
lib/eal/include/rte_bitops.h +0 -40
@@ -42,9 +42,6 @@ extern "C" {/*------------------------ 32-bit relaxed operations ------------------------*/ /** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Get the target bit from a 32-bit value without memory ordering. * * @param nr
@@ -54,7 +51,6 @@ extern "C" {* @return * The target bit. */ -__rte_experimental static inline uint32_t rte_bit_relaxed_get32 (unsigned int nr,volatile uint32_t *addr) {
@@ -65,9 +61,6 @@ rte_bit_relaxed_get32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Set the target bit in a 32-bit value to 1 without memory ordering. * * @param nr
@@ -75,7 +68,6 @@ rte_bit_relaxed_get32(unsigned int nr, volatile uint32_t *addr)* @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_set32 (unsigned int nr,volatile uint32_t *addr) {
@@ -86,9 +78,6 @@ rte_bit_relaxed_set32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Clear the target bit in a 32-bit value to 0 without memory ordering. * * @param nr
@@ -96,7 +85,6 @@ rte_bit_relaxed_set32(unsigned int nr, volatile uint32_t *addr)* @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_clear32 (unsigned int nr,volatile uint32_t *addr) {
@@ -107,9 +95,6 @@ rte_bit_relaxed_clear32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Return the original bit from a 32-bit value, then set it to 1 without * memory ordering. *
@@ -120,7 +105,6 @@ rte_bit_relaxed_clear32(unsigned int nr, volatile uint32_t *addr)* @return * The original bit. */ -__rte_experimental static inline uint32_t rte_bit_relaxed_test_and_set32 (unsigned int nr,volatile uint32_t *addr) {
@@ -133,9 +117,6 @@ rte_bit_relaxed_test_and_set32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Return the original bit from a 32-bit value, then clear it to 0 without * memory ordering. *
@@ -146,7 +127,6 @@ rte_bit_relaxed_test_and_set32(unsigned int nr, volatile uint32_t *addr)* @return * The original bit. */ -__rte_experimental static inline uint32_t rte_bit_relaxed_test_and_clear32 (unsigned int nr,volatile uint32_t *addr) {
@@ -161,9 +141,6 @@ rte_bit_relaxed_test_and_clear32(unsigned int nr, volatile uint32_t *addr)/*------------------------ 64-bit relaxed operations ------------------------*/ /** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Get the target bit from a 64-bit value without memory ordering. * * @param nr
@@ -173,7 +150,6 @@ rte_bit_relaxed_test_and_clear32(unsigned int nr, volatile uint32_t *addr)* @return * The target bit. */ -__rte_experimental static inline uint64_t rte_bit_relaxed_get64 (unsigned int nr,volatile uint64_t *addr) {
@@ -184,9 +160,6 @@ rte_bit_relaxed_get64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Set the target bit in a 64-bit value to 1 without memory ordering. * * @param nr
@@ -194,7 +167,6 @@ rte_bit_relaxed_get64(unsigned int nr, volatile uint64_t *addr)* @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_set64 (unsigned int nr,volatile uint64_t *addr) {
@@ -205,9 +177,6 @@ rte_bit_relaxed_set64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Clear the target bit in a 64-bit value to 0 without memory ordering. * * @param nr
@@ -215,7 +184,6 @@ rte_bit_relaxed_set64(unsigned int nr, volatile uint64_t *addr)* @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_clear64 (unsigned int nr,volatile uint64_t *addr) {
@@ -226,9 +194,6 @@ rte_bit_relaxed_clear64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Return the original bit from a 64-bit value, then set it to 1 without * memory ordering. *
@@ -239,7 +204,6 @@ rte_bit_relaxed_clear64(unsigned int nr, volatile uint64_t *addr)* @return * The original bit. */ -__rte_experimental static inline uint64_t rte_bit_relaxed_test_and_set64 (unsigned int nr,volatile uint64_t *addr) {
@@ -252,9 +216,6 @@ rte_bit_relaxed_test_and_set64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Return the original bit from a 64-bit value, then clear it to 0 without * memory ordering. *
@@ -265,7 +226,6 @@ rte_bit_relaxed_test_and_set64(unsigned int nr, volatile uint64_t *addr)* @return * The original bit. */ -__rte_experimental static inline uint64_t rte_bit_relaxed_test_and_clear64 (unsigned int nr,volatile uint64_t *addr) {
Signature · 1 line
2.39.2
RE: [PATCH v2 01/14] eal: make bitops a stable API
Quoted 9 lines
-----Original Message-----
From: Stephen Hemminger <[email protected]>
Sent: Saturday, October 21, 2023 5:41 AM
To: [email protected]
Cc: Stephen Hemminger <[email protected]>; Cristian Dumitrescu <[email protected]>; Joyce Kong <[email protected]>
Subject: [PATCH v2 01/14] eal: make bitops a stable API
Quoted 3 lines
These were added in 20.05 release.
Signed-off-by Stephen Hemminger <[email protected]>
Quoted 235 lines
--- lib/eal/include/rte_bitmap.h | 8 -------- lib/eal/include/rte_bitops.h | 40 ----- ------------------------------- 2 files changed, 48 deletions(-)lib/eal/include/rte_bitmap.h index renamed from lib/eal/include/rte_bitmap.h +0
-0
46a822768d50..ec819595624c100644lib/eal/include/rte_bitmap.h +0
-4@@ -203,9 +203,6 @@ rte_bitmap_init(uint32_t n_bits, uint8_t *mem, uint32_t mem_size) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Bitmap clear slab overhead bits. * * @param slabs @@ -215,7 +212,6 @@ rte_bitmap_init(uint32_t n_bits, uint8_t *mem,uint32_t mem_size) * @param pos * The start bit position in the slabs to be cleared. */ -__rte_experimental static inline void __rte_bitmap_clear_slab_overhead_bits(uint64_t *slabs, uint32_t slab_size,uint32_t pos)lib/eal/include/rte_bitmap.h +0
-4@@ -235,9 +231,6 @@ __rte_bitmap_clear_slab_overhead_bits(uint64_t *slabs, uint32_t slab_size, }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Bitmap initialization with all bits set * * @param n_bits @@ -249,7 +242,6 @@ __rte_bitmap_clear_slab_overhead_bits(uint64_t*slabs, uint32_t slab_size, * @return * Handle to bitmap instance. */ -__rte_experimental static inline struct rte_bitmap * rte_bitmap_init_with_all_set(uint32_t n_bits, uint8_t *mem, uint32_t
mem_size) { diff --gita/lib/eal/include/rte_bitops.hb/lib/eal/include/rte_bitops.hindex6b8ae8d3acf6..29d24b3a780e100644lib/eal/include/rte_bitops.h +0
-2@@ -42,9 +42,6 @@ extern "C" {/*------------------------ 32-bit relaxed operations ------------------------*/ /** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get the target bit from a 32-bit value without memory ordering. *
* @param nrlib/eal/include/rte_bitops.h +1
-3@@ -54,7 +51,6 @@ extern "C" {* @return * The target bit. */ -__rte_experimental static inline uint32_t rte_bit_relaxed_get32(unsigned int nr, volatile uint32_t *addr) { @@ -65,9 +61,6 @@ rte_bit_relaxed_get32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Set the target bit in a 32-bit value to 1 without memory ordering. *
* @param nrlib/eal/include/rte_bitops.h +1
-3@@ -75,7 +68,6 @@ rte_bit_relaxed_get32(unsigned int nr, volatile uint32_t*addr) * @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_set32(unsigned int nr, volatile uint32_t *addr) { @@ -86,9 +78,6 @@ rte_bit_relaxed_set32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Clear the target bit in a 32-bit value to 0 without memory ordering. *
* @param nrlib/eal/include/rte_bitops.h +1
-3@@ -96,7 +85,6 @@ rte_bit_relaxed_set32(unsigned int nr, volatile uint32_t*addr) * @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_clear32(unsigned int nr, volatile uint32_t *addr) { @@ -107,9 +95,6 @@ rte_bit_relaxed_clear32(unsigned int nr, volatile uint32_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Return the original bit from a 32-bit value, then set it to 1 without
* memory ordering.
*lib/eal/include/rte_bitops.h +0
-1@@ -120,7 +105,6 @@ rte_bit_relaxed_clear32(unsigned int nr, volatileuint32_t *addr) * @return * The original bit. */ -__rte_experimental static inline uint32_t rte_bit_relaxed_test_and_set32 (unsigned int nr,volatile uint32_t *addr){ @@ -133,9 +117,6 @@
rte_bit_relaxed_test_and_set32(unsigned int nr, volatile uint32_t *addr)}/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Return the original bit from a 32-bit value, then clear it to 0 without
* memory ordering.
*lib/eal/include/rte_bitops.h +0
-1@@ -146,7 +127,6 @@ rte_bit_relaxed_test_and_set32(unsigned int nr,volatile uint32_t *addr) * @return * The original bit. */ -__rte_experimental static inline uint32_t rte_bit_relaxed_test_and_clear32 (unsigned int nr,volatile uint32_t *addr){ @@ -161,9 +141,6 @@
rte_bit_relaxed_test_and_clear32(unsigned int nr, volatile uint32_t *addr)
/*------------------------ 64-bit relaxed operations ------------------------*//**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get the target bit from a 64-bit value without memory ordering. *
* @param nrlib/eal/include/rte_bitops.h +1
-3@@ -173,7 +150,6 @@ rte_bit_relaxed_test_and_clear32(unsigned int nr,volatile uint32_t *addr) * @return * The target bit. */ -__rte_experimental static inline uint64_t rte_bit_relaxed_get64(unsigned int nr, volatile uint64_t *addr) { @@ -184,9 +160,6 @@ rte_bit_relaxed_get64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Set the target bit in a 64-bit value to 1 without memory ordering. *
* @param nrlib/eal/include/rte_bitops.h +1
-3@@ -194,7 +167,6 @@ rte_bit_relaxed_get64(unsigned int nr, volatileuint64_t *addr) * @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_set64(unsigned int nr, volatile uint64_t *addr) { @@ -205,9 +177,6 @@ rte_bit_relaxed_set64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Clear the target bit in a 64-bit value to 0 without memory ordering. *
* @param nrlib/eal/include/rte_bitops.h +1
-3@@ -215,7 +184,6 @@ rte_bit_relaxed_set64(unsigned int nr, volatileuint64_t *addr) * @param addr * The address holding the bit. */ -__rte_experimental static inline void rte_bit_relaxed_clear64(unsigned int nr, volatile uint64_t *addr) { @@ -226,9 +194,6 @@ rte_bit_relaxed_clear64(unsigned int nr, volatile uint64_t *addr) }/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Return the original bit from a 64-bit value, then set it to 1 without
* memory ordering.
*lib/eal/include/rte_bitops.h +0
-1@@ -239,7 +204,6 @@ rte_bit_relaxed_clear64(unsigned int nr, volatileuint64_t *addr) * @return * The original bit. */ -__rte_experimental static inline uint64_t rte_bit_relaxed_test_and_set64 (unsigned int nr,volatile uint64_t *addr){ @@ -252,9 +216,6 @@
rte_bit_relaxed_test_and_set64(unsigned int nr, volatile uint64_t *addr)}/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Return the original bit from a 64-bit value, then clear it to 0 without
* memory ordering.
*lib/eal/include/rte_bitops.h +0
-2@@ -265,7 +226,6 @@ rte_bit_relaxed_test_and_set64(unsigned int nr,volatile uint64_t *addr) * @return * The original bit. */ -__rte_experimental static inline uint64_t rte_bit_relaxed_test_and_clear64 (unsigned int nr,volatile uint64_t *addr) { --
Quoted 1 line
2.39.2
IMPORTANT NOTICE: The contents of this email and any attachments are confidential and may also be privileged. If you are not the intended recipient, please notify the sender immediately and do not disclose the contents to any other person, use it for any purpose, or store or copy the information in any medium. Thank you.
PATCH v2 2/14 eal: mark rte_dev API's as stable
In reply to Stephen HemmingerThese have been around since 2020.
--- lib/eal/include/rte_dev.h | 32 -------------------------------- lib/eal/version.map | 28 +++++++++++----------------- 2 files changed, 11 insertions(+), 49 deletions(-)
lib/eal/include/rte_dev.h +0 -32
@@ -341,7 +341,6 @@ typedef void *(*rte_dev_iterate_t)(const void *start,* 0 on successful initialization. * <0 on error. */ -__rte_experimental int rte_dev_iterator_init (struct rte_dev_iterator *it,const char *str);
@@ -361,7 +360,6 @@ rte_dev_iterator_init(struct rte_dev_iterator *it, const char *str);* NULL if an error occurred (rte_errno is set). * NULL if no device could be found (rte_errno is not set). */ -__rte_experimental struct rte_device *rte_dev_iterator_next (struct rte_dev_iterator *it);
@@ -372,9 +370,6 @@ rte_dev_iterator_next(struct rte_dev_iterator *it); dev = rte_dev_iterator_next(it))/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * It registers the callback for the specific device. * Multiple callbacks can be registered at the same time. *
@@ -390,16 +385,12 @@ rte_dev_iterator_next(struct rte_dev_iterator *it);* - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_callback_register (const char *device_name,rte_dev_event_cb_fn cb_fn,void *cb_arg);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * It unregisters the callback according to the specified device. * * @param device_name
@@ -415,16 +406,12 @@ rte_dev_event_callback_register(const char *device_name,* - On success, return the number of callback entities removed. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_callback_unregister (const char *device_name,rte_dev_event_cb_fn cb_fn,void *cb_arg);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Executes all the user application registered callbacks for * the specific device. *
@@ -433,64 +420,47 @@ rte_dev_event_callback_unregister(const char *device_name,* @param event * the device event type. */ -__rte_experimental void rte_dev_event_callback_process (const char *device_name,enum rte_dev_event_type event);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Start the device event monitoring. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_monitor_start (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Stop the device event monitoring. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_event_monitor_stop (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Enable hotplug handling for devices. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_hotplug_handle_enable (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Disable hotplug handling for devices. * * @return * - On success, zero. * - On failure, a negative value. */ -__rte_experimental int rte_dev_hotplug_handle_disable (void );
@@ -514,7 +484,6 @@ rte_dev_hotplug_handle_disable(void);* 0 if mapping was successful. * Negative value and rte_errno is set otherwise. */ -__rte_experimental int rte_dev_dma_map (struct rte_device *dev,void *addr,uint64_t iova,size_t len);
@@ -538,7 +507,6 @@ rte_dev_dma_map(struct rte_device *dev, void *addr, uint64_t iova, size_t len);* 0 if un-mapping was successful. * Negative value and rte_errno is set otherwise. */ -__rte_experimental int rte_dev_dma_unmap (struct rte_device *dev,void *addr,uint64_t iova,size_t len);
lib/eal/version.map +11 -17
@@ -28,8 +28,19 @@ DPDK_24 { rte_dev_bus; rte_dev_bus_info; rte_dev_devargs; + rte_dev_dma_map; + rte_dev_dma_unmap; rte_dev_driver; + rte_dev_event_callback_process; + rte_dev_event_callback_register; + rte_dev_event_callback_unregister; + rte_dev_event_monitor_start; + rte_dev_event_monitor_stop; + rte_dev_hotplug_handle_disable; + rte_dev_hotplug_handle_enable; rte_dev_is_probed; + rte_dev_iterator_init; + rte_dev_iterator_next; rte_dev_name; rte_dev_numa_node; rte_dev_probe;
@@ -309,28 +320,11 @@ DPDK_24 { EXPERIMENTAL { global: - # added in 18.05 - rte_dev_event_callback_register; - rte_dev_event_callback_unregister; - rte_dev_event_monitor_start; - rte_dev_event_monitor_stop; - # added in 18.08 rte_class_find; rte_class_find_by_name; rte_class_register; rte_class_unregister; - rte_dev_iterator_init; - rte_dev_iterator_next; - - # added in 18.11 - rte_dev_event_callback_process; - rte_dev_hotplug_handle_disable; - rte_dev_hotplug_handle_enable; - - # added in 19.05 - rte_dev_dma_map; - rte_dev_dma_unmap; # added in 20.05 __rte_eal_trace_generic_double;
Signature · 1 line
2.39.2
PATCH v2 3/14 eal: make rte_class API's stable
In reply to Stephen HemmingerThese API's have been around for a while.
--- lib/eal/include/rte_class.h | 4 ---- lib/eal/version.map | 10 ++++------ 2 files changed, 4 insertions(+), 10 deletions(-)
lib/eal/include/rte_class.h +0 -4
@@ -76,7 +76,6 @@ typedef int (*rte_class_cmp_t)(const struct rte_class *cls, const void *data);* @return * A pointer to a rte_class structure or NULL in case no class matches */ -__rte_experimental struct rte_class *rte_class_find (const struct rte_class *start,rte_class_cmp_t cmp,const void *data);
@@ -84,7 +83,6 @@ rte_class_find(const struct rte_class *start, rte_class_cmp_t cmp,/** * Find the registered class for a given name. */ -__rte_experimental struct rte_class *rte_class_find_by_name (const char *name);
@@ -95,7 +93,6 @@ rte_class_find_by_name(const char *name);* A pointer to a rte_class structure describing the class * to be registered. */ -__rte_experimental void rte_class_register (struct rte_class *cls);/**
@@ -105,7 +102,6 @@ void rte_class_register(struct rte_class *cls);* A pointer to a rte_class structure describing the class * to be unregistered. */ -__rte_experimental void rte_class_unregister (struct rte_class *cls);/**
lib/eal/version.map +4 -6
@@ -17,6 +17,10 @@ DPDK_24 { rte_bus_scan; rte_calloc; rte_calloc_socket; + rte_class_find; + rte_class_find_by_name; + rte_class_register; + rte_class_unregister; rte_cpu_get_flag_enabled; rte_cpu_get_flag_name; rte_cpu_is_supported; # WINDOWS_NO_EXPORT
@@ -320,12 +324,6 @@ DPDK_24 { EXPERIMENTAL { global: - # added in 18.08 - rte_class_find; - rte_class_find_by_name; - rte_class_register; - rte_class_unregister; - # added in 20.05 __rte_eal_trace_generic_double; __rte_eal_trace_generic_float;
Signature · 1 line
2.39.2
PATCH v2 4/14 eal: make rte_drand a stable API
In reply to Stephen HemmingerThis API was added in 2020.
--- lib/eal/include/rte_random.h | 4 ---- lib/eal/version.map | 4 +--- 2 files changed, 1 insertion(+), 7 deletions(-)
lib/eal/include/rte_random.h +0 -4
@@ -70,9 +70,6 @@ uint64_t rte_rand_max(uint64_t upper_bound);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Generates a pseudo-random floating point number. * * This function returns a non-negative double-precision floating random
@@ -87,7 +84,6 @@ rte_rand_max(uint64_t upper_bound);* @return * A pseudo-random value between 0 and 1.0. */ -__rte_experimental double rte_drand (void );#ifdef __cplusplus
lib/eal/version.map +1 -3
@@ -57,6 +57,7 @@ DPDK_24 { rte_devargs_parsef; rte_devargs_remove; rte_devargs_type_count; + rte_drand; rte_driver_name; rte_dump_physmem_layout; rte_dump_stack;
@@ -395,9 +396,6 @@ EXPERIMENTAL { rte_intr_type_get; rte_intr_type_set; - # added in 22.07 - rte_drand; - # added in 23.03 rte_lcore_register_usage_cb; __rte_eal_trace_generic_blob;
Signature · 1 line
2.39.2
Re: [PATCH v2 04/14] eal: make rte_drand a stable API
Quoted 43 lines · Stephen Hemminger
This API was added in 2020.
Signed-off-by Stephen Hemminger <[email protected]>--- lib/eal/include/rte_random.h | 4 ---- lib/eal/version.map | 4 +--- 2 files changed, 1 insertion(+), 7 deletions(-)lib/eal/include/rte_random.h +0
-4@@ -70,9 +70,6 @@ uint64_t rte_rand_max(uint64_t upper_bound);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Generates a pseudo-random floating point number. * * This function returns a non-negative double-precision floating random @@ -87,7 +84,6 @@ rte_rand_max(uint64_t upper_bound);* @return * A pseudo-random value between 0 and 1.0. */ -__rte_experimental double rte_drand (void );#ifdef __cpluspluslib/eal/version.map +1
-0@@ -57,6 +57,7 @@ DPDK_24 { rte_devargs_parsef; rte_devargs_remove; rte_devargs_type_count; + rte_drand; rte_driver_name; rte_dump_physmem_layout; rte_dump_stack;
lib/eal/version.map EXPERIMENTAL { · line 401
Quoted 9 lines
lib/eal/version.map +0
-3@@ -395,9 +396,6 @@ EXPERIMENTAL { rte_intr_type_get; rte_intr_type_set; - # added in 22.07 - rte_drand; - # added in 23.03 rte_lcore_register_usage_cb; __rte_eal_trace_generic_blob;
PATCH v2 5/14 eal: make rte_service_lcore_may_be_active stable
In reply to Stephen HemmingerThis API was added in 2020.
--- lib/eal/include/rte_service.h | 1 - lib/eal/version.map | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-)
lib/eal/include/rte_service.h +0 -1
@@ -275,7 +275,6 @@ int32_t rte_service_lcore_stop(uint32_t lcore_id);* @retval 1 Service thread is in the service core polling loop. * @retval -EINVAL Invalid *lcore_id* provided. */ -__rte_experimental int32_t rte_service_lcore_may_be_active (uint32_t lcore_id);/**
lib/eal/version.map +1 -1
@@ -249,6 +249,7 @@ DPDK_24 { rte_service_lcore_count_services; rte_service_lcore_del; rte_service_lcore_list; + rte_service_lcore_may_be_active; rte_service_lcore_reset_all; rte_service_lcore_start; rte_service_lcore_stop;
@@ -366,7 +367,6 @@ EXPERIMENTAL { # added in 20.11 __rte_eal_trace_generic_size_t; # WINDOWS_NO_EXPORT rte_cpu_get_intrinsics_support; # WINDOWS_NO_EXPORT - rte_service_lcore_may_be_active; rte_vect_get_max_simd_bitwidth; rte_vect_set_max_simd_bitwidth;
Signature · 1 line
2.39.2
PATCH v2 6/14 eal: make rte_devargs_reset stable
In reply to Stephen HemmingerWas added in 20.05 release.
--- lib/eal/include/rte_devargs.h | 1 - lib/eal/version.map | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-)
lib/eal/include/rte_devargs.h +0 -1
@@ -168,7 +168,6 @@ __rte_format_printf(2, 0);* @param da * The devargs structure holding the device information. */ -__rte_experimental void rte_devargs_reset (struct rte_devargs *da);
lib/eal/version.map +1 -1
@@ -56,6 +56,7 @@ DPDK_24 { rte_devargs_parse; rte_devargs_parsef; rte_devargs_remove; + rte_devargs_reset; rte_devargs_type_count; rte_drand; rte_driver_name;
@@ -376,7 +377,6 @@ EXPERIMENTAL { rte_power_pause; # WINDOWS_NO_EXPORT # added in 21.05 - rte_devargs_reset; rte_intr_callback_unregister_sync; rte_version_minor; rte_version_month;
Signature · 1 line
2.39.2
PATCH v2 7/14 eal: make pflock API stable
In reply to Stephen HemmingerAdded in 21.11 release.
--- lib/eal/include/rte_pflock.h | 20 -------------------- 1 file changed, 20 deletions(-)
lib/eal/include/rte_pflock.h +0 -20
@@ -80,15 +80,11 @@ typedef struct rte_pflock rte_pflock_t;#define RTE_PFLOCK_INITIALIZER { }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the pflock to an unlocked state. * * @param pf * A pointer to the pflock. */ -__rte_experimental static inline void rte_pflock_init (struct rte_pflock *pf) {
@@ -99,15 +95,11 @@ rte_pflock_init(struct rte_pflock *pf) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Take a pflock for read. * * @param pf * A pointer to a pflock structure. */ -__rte_experimental static inline void rte_pflock_read_lock (rte_pflock_t *pf) {
@@ -127,15 +119,11 @@ rte_pflock_read_lock(rte_pflock_t *pf) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Release a pflock locked for reading. * * @param pf * A pointer to the pflock structure. */ -__rte_experimental static inline void rte_pflock_read_unlock (rte_pflock_t *pf) {
@@ -143,15 +131,11 @@ rte_pflock_read_unlock(rte_pflock_t *pf) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Take the pflock for write. * * @param pf * A pointer to the pflock structure. */ -__rte_experimental static inline void rte_pflock_write_lock (rte_pflock_t *pf) {
@@ -181,15 +165,11 @@ rte_pflock_write_lock(rte_pflock_t *pf) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Release a pflock held for writing. * * @param pf * A pointer to a pflock structure. */ -__rte_experimental static inline void rte_pflock_write_unlock (rte_pflock_t *pf) {
Signature · 1 line
2.39.2
PATCH v2 8/14 eal: make seqcount and seqlock stable
In reply to Stephen HemmingerThese were add back in 22.07 release.
--- lib/eal/include/rte_seqcount.h | 23 ----------------------- lib/eal/include/rte_seqlock.h | 21 --------------------- 2 files changed, 44 deletions(-)
lib/eal/include/rte_seqcount.h +0 -23
@@ -41,15 +41,11 @@ typedef struct {#define RTE_SEQCOUNT_INITIALIZER { .sn = 0 }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the sequence counter. * * @param seqcount * A pointer to the sequence counter. */ -__rte_experimental static inline void rte_seqcount_init (rte_seqcount_t *seqcount) {
@@ -57,9 +53,6 @@ rte_seqcount_init(rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a read-side critical section. * * A call to this function marks the beginning of a read-side critical
@@ -101,8 +94,6 @@ rte_seqcount_init(rte_seqcount_t *seqcount)* * @see rte_seqcount_read_retry() */ - -__rte_experimental static inline uint32_t rte_seqcount_read_begin (const rte_seqcount_t *seqcount) {
@@ -114,9 +105,6 @@ rte_seqcount_read_begin(const rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a read-side critical section. * * A call to this function marks the end of a read-side critical
@@ -146,8 +134,6 @@ rte_seqcount_read_begin(const rte_seqcount_t *seqcount)* * @see rte_seqcount_read_begin() */ - -__rte_experimental static inline bool rte_seqcount_read_retry (const rte_seqcount_t *seqcount,uint32_t begin_sn) {
@@ -172,9 +158,6 @@ rte_seqcount_read_retry(const rte_seqcount_t *seqcount, uint32_t begin_sn) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a write-side critical section. * * A call to this function marks the beginning of a write-side
@@ -196,8 +179,6 @@ rte_seqcount_read_retry(const rte_seqcount_t *seqcount, uint32_t begin_sn)* * @see rte_seqcount_write_end() */ - -__rte_experimental static inline void rte_seqcount_write_begin (rte_seqcount_t *seqcount) {
@@ -214,9 +195,6 @@ rte_seqcount_write_begin(rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a write-side critical section. * * A call to this function marks the end of the write-side critical
@@ -228,7 +206,6 @@ rte_seqcount_write_begin(rte_seqcount_t *seqcount)* * @see rte_seqcount_write_begin() */ -__rte_experimental static inline void rte_seqcount_write_end (rte_seqcount_t *seqcount) {
lib/eal/include/rte_seqlock.h +0 -21
@@ -114,9 +114,6 @@ typedef struct { }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the seqlock. * * This function initializes the seqlock, and leaves the writer-side
@@ -125,7 +122,6 @@ typedef struct {* @param seqlock * A pointer to the seqlock. */ -__rte_experimental static inline void rte_seqlock_init (rte_seqlock_t *seqlock) {
@@ -134,9 +130,6 @@ rte_seqlock_init(rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a read-side critical section. * * See rte_seqcount_read_retry() for details.
@@ -150,8 +143,6 @@ rte_seqlock_init(rte_seqlock_t *seqlock)* @see rte_seqlock_read_retry() * @see rte_seqcount_read_retry() */ - -__rte_experimental static inline uint32_t rte_seqlock_read_begin (const rte_seqlock_t *seqlock) {
@@ -159,9 +150,6 @@ rte_seqlock_read_begin(const rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a read-side critical section. * * See rte_seqcount_read_retry() for details.
@@ -177,7 +165,6 @@ rte_seqlock_read_begin(const rte_seqlock_t *seqlock)* * @see rte_seqlock_read_begin() */ -__rte_experimental static inline bool rte_seqlock_read_retry (const rte_seqlock_t *seqlock,uint32_t begin_sn) {
@@ -185,9 +172,6 @@ rte_seqlock_read_retry(const rte_seqlock_t *seqlock, uint32_t begin_sn) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a write-side critical section. * * A call to this function acquires the write lock associated @p
@@ -212,7 +196,6 @@ rte_seqlock_read_retry(const rte_seqlock_t *seqlock, uint32_t begin_sn)* * @see rte_seqlock_write_unlock() */ -__rte_experimental static inline void rte_seqlock_write_lock(rte_seqlock_t *seqlock) __rte_exclusive_lock_function(&seqlock->lock)
@@ -224,9 +207,6 @@ rte_seqlock_write_lock(rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a write-side critical section. * * A call to this function marks the end of the write-side critical
@@ -238,7 +218,6 @@ rte_seqlock_write_lock(rte_seqlock_t *seqlock)* * @see rte_seqlock_write_lock() */ -__rte_experimental static inline void rte_seqlock_write_unlock(rte_seqlock_t *seqlock) __rte_unlock_function(&seqlock->lock)
Signature · 1 line
2.39.2
Re: [PATCH v2 08/14] eal: make seqcount and seqlock stable
Quoted 192 lines · Stephen Hemminger
These were add back in 22.07 release.
Signed-off-by Stephen Hemminger <[email protected]>Acked-by Mattias Rönnblom <[email protected]>--- lib/eal/include/rte_seqcount.h | 23 ----------------------- lib/eal/include/rte_seqlock.h | 21 --------------------- 2 files changed, 44 deletions(-)lib/eal/include/rte_seqcount.h +0
-23@@ -41,15 +41,11 @@ typedef struct {#define RTE_SEQCOUNT_INITIALIZER { .sn = 0 }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the sequence counter. * * @param seqcount * A pointer to the sequence counter. */ -__rte_experimental static inline void rte_seqcount_init (rte_seqcount_t *seqcount) {@@ -57,9 +53,6 @@ rte_seqcount_init(rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a read-side critical section. * * A call to this function marks the beginning of a read-side critical @@ -101,8 +94,6 @@ rte_seqcount_init(rte_seqcount_t *seqcount)* * @see rte_seqcount_read_retry() */ - -__rte_experimental static inline uint32_t rte_seqcount_read_begin (const rte_seqcount_t *seqcount) {@@ -114,9 +105,6 @@ rte_seqcount_read_begin(const rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a read-side critical section. * * A call to this function marks the end of a read-side critical @@ -146,8 +134,6 @@ rte_seqcount_read_begin(const rte_seqcount_t *seqcount)* * @see rte_seqcount_read_begin() */ - -__rte_experimental static inline bool rte_seqcount_read_retry (const rte_seqcount_t *seqcount,uint32_t begin_sn) {@@ -172,9 +158,6 @@ rte_seqcount_read_retry(const rte_seqcount_t *seqcount, uint32_t begin_sn) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a write-side critical section. * * A call to this function marks the beginning of a write-side @@ -196,8 +179,6 @@ rte_seqcount_read_retry(const rte_seqcount_t *seqcount, uint32_t begin_sn)* * @see rte_seqcount_write_end() */ - -__rte_experimental static inline void rte_seqcount_write_begin (rte_seqcount_t *seqcount) {@@ -214,9 +195,6 @@ rte_seqcount_write_begin(rte_seqcount_t *seqcount) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a write-side critical section. * * A call to this function marks the end of the write-side critical @@ -228,7 +206,6 @@ rte_seqcount_write_begin(rte_seqcount_t *seqcount)* * @see rte_seqcount_write_begin() */ -__rte_experimental static inline void rte_seqcount_write_end (rte_seqcount_t *seqcount) {lib/eal/include/rte_seqlock.h +0
-20@@ -114,9 +114,6 @@ typedef struct { }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Initialize the seqlock. * * This function initializes the seqlock, and leaves the writer-side @@ -125,7 +122,6 @@ typedef struct {* @param seqlock * A pointer to the seqlock. */ -__rte_experimental static inline void rte_seqlock_init (rte_seqlock_t *seqlock) {@@ -134,9 +130,6 @@ rte_seqlock_init(rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a read-side critical section. * * See rte_seqcount_read_retry() for details. @@ -150,8 +143,6 @@ rte_seqlock_init(rte_seqlock_t *seqlock)* @see rte_seqlock_read_retry() * @see rte_seqcount_read_retry() */ - -__rte_experimental static inline uint32_t rte_seqlock_read_begin (const rte_seqlock_t *seqlock) {@@ -159,9 +150,6 @@ rte_seqlock_read_begin(const rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a read-side critical section. * * See rte_seqcount_read_retry() for details. @@ -177,7 +165,6 @@ rte_seqlock_read_begin(const rte_seqlock_t *seqlock)* * @see rte_seqlock_read_begin() */ -__rte_experimental static inline bool rte_seqlock_read_retry (const rte_seqlock_t *seqlock,uint32_t begin_sn) {@@ -185,9 +172,6 @@ rte_seqlock_read_retry(const rte_seqlock_t *seqlock, uint32_t begin_sn) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Begin a write-side critical section. * * A call to this function acquires the write lock associated @p @@ -212,7 +196,6 @@ rte_seqlock_read_retry(const rte_seqlock_t *seqlock, uint32_t begin_sn)* * @see rte_seqlock_write_unlock() */ -__rte_experimental static inline void rte_seqlock_write_lock(rte_seqlock_t *seqlock) __rte_exclusive_lock_function(&seqlock->lock)@@ -224,9 +207,6 @@ rte_seqlock_write_lock(rte_seqlock_t *seqlock) }/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * End a write-side critical section. * * A call to this function marks the end of the write-side critical
lib/eal/include/rte_seqlock.h rte_seqlock_write_lock(rte_seqlock_t *seqlock) · line 223
Quoted 7 lines
lib/eal/include/rte_seqlock.h +0
-1@@ -238,7 +218,6 @@ rte_seqlock_write_lock(rte_seqlock_t *seqlock)* * @see rte_seqlock_write_lock() */ -__rte_experimental static inline void rte_seqlock_write_unlock(rte_seqlock_t *seqlock) __rte_unlock_function(&seqlock->lock)
Thanks!
PATCH v2 9/14 eal: mark rte_intr_XXX API's as stable
In reply to Stephen HemmingerThese were added back in 2020.
--- lib/eal/include/rte_interrupts.h | 28 ---------------------------- lib/eal/version.map | 14 +++++++------- 2 files changed, 7 insertions(+), 35 deletions(-)
lib/eal/include/rte_interrupts.h +0 -28
@@ -127,9 +127,6 @@ rte_intr_callback_unregister_pending(const struct rte_intr_handle *intr_handle, rte_intr_unregister_callback_fn ucb_fn);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Loop until rte_intr_callback_unregister() succeeds. * After a call to this function, * the callback provided by the specified interrupt handle is unregistered.
@@ -146,7 +143,6 @@ rte_intr_callback_unregister_pending(const struct rte_intr_handle *intr_handle,* - On success, return the number of callback entities removed. * - On failure, a negative value. */ -__rte_experimental int rte_intr_callback_unregister_sync (const struct rte_intr_handle *intr_handle,rte_intr_callback_fn cb,void *cb_arg);
@@ -201,9 +197,6 @@ int rte_intr_ack(const struct rte_intr_handle *intr_handle);int rte_thread_is_intr (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * It allocates memory for interrupt instance. API takes flag as an argument * which define from where memory should be allocated i.e. using DPDK memory * management library APIs or normal heap allocation.
@@ -221,28 +214,20 @@ int rte_thread_is_intr(void);* - On success, address of interrupt handle. * - On failure, NULL. */ -__rte_experimental struct rte_intr_handle *rte_intr_instance_alloc (uint32_t flags);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Free the memory allocated for interrupt handle resources. * * @param intr_handle * Interrupt handle allocated with rte_intr_instance_alloc(). * If intr_handle is NULL, no operation is performed. */ -__rte_experimental void rte_intr_instance_free (struct rte_intr_handle *intr_handle);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Set the fd field of interrupt handle with user provided * file descriptor. *
@@ -255,14 +240,10 @@ rte_intr_instance_free(struct rte_intr_handle *intr_handle);* - On success, zero. * - On failure, a negative value and rte_errno is set. */ -__rte_experimental int rte_intr_fd_set (struct rte_intr_handle *intr_handle,int fd);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Returns the fd field of the given interrupt handle instance. * * @param intr_handle
@@ -272,14 +253,10 @@ rte_intr_fd_set(struct rte_intr_handle *intr_handle, int fd);* - On success, fd field. * - On failure, a negative value. */ -__rte_experimental int rte_intr_fd_get (const struct rte_intr_handle *intr_handle);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Set the type field of interrupt handle with user provided * interrupt type. *
@@ -292,15 +269,11 @@ rte_intr_fd_get(const struct rte_intr_handle *intr_handle);* - On success, zero. * - On failure, a negative value and rte_errno is set. */ -__rte_experimental int rte_intr_type_set (struct rte_intr_handle *intr_handle,enum rte_intr_handle_type type);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Returns the type field of the given interrupt handle instance. * * @param intr_handle
@@ -310,7 +283,6 @@ rte_intr_type_set(struct rte_intr_handle *intr_handle,* - On success, interrupt type * - On failure, RTE_INTR_HANDLE_UNKNOWN. */ -__rte_experimental enum rte_intr_handle_type rte_intr_type_get (const struct rte_intr_handle *intr_handle);
lib/eal/version.map +7 -7
@@ -137,8 +137,15 @@ DPDK_24 { rte_intr_callback_register; rte_intr_callback_unregister; rte_intr_callback_unregister_pending; + rte_intr_callback_unregister_sync; rte_intr_disable; rte_intr_enable; + rte_intr_fd_get; + rte_intr_fd_set; + rte_intr_instance_alloc; + rte_intr_instance_free; + rte_intr_type_get; + rte_intr_type_set; rte_keepalive_create; # WINDOWS_NO_EXPORT rte_keepalive_dispatch_pings; # WINDOWS_NO_EXPORT rte_keepalive_mark_alive; # WINDOWS_NO_EXPORT
@@ -377,7 +384,6 @@ EXPERIMENTAL { rte_power_pause; # WINDOWS_NO_EXPORT # added in 21.05 - rte_intr_callback_unregister_sync; rte_version_minor; rte_version_month; rte_version_prefix;
@@ -389,12 +395,6 @@ EXPERIMENTAL { rte_power_monitor_multi; # WINDOWS_NO_EXPORT # added in 21.11 - rte_intr_fd_get; - rte_intr_fd_set; - rte_intr_instance_alloc; - rte_intr_instance_free; - rte_intr_type_get; - rte_intr_type_set; # added in 23.03 rte_lcore_register_usage_cb;
Signature · 1 line
2.39.2
PATCH v2 10/14 eal: mark rte_atomic128_cmp_exchange as stable
In reply to Stephen HemmingerThis has been around since 2021.
--- lib/eal/arm/include/rte_atomic_64.h | 1 - lib/eal/include/generic/rte_atomic.h | 1 - lib/eal/x86/include/rte_atomic_64.h | 1 - 3 files changed, 3 deletions(-)
lib/eal/arm/include/rte_atomic_64.h +0 -1
@@ -94,7 +94,6 @@ __ATOMIC128_CAS_OP(__cas_128_acq_rel, "caspal")#endif -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp, const rte_int128_t *src, unsigned int weak, int success,
lib/eal/include/generic/rte_atomic.h +0 -1
@@ -1147,7 +1147,6 @@ typedef struct {* @return * Non-zero on success; 0 on failure. */ -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp,
lib/eal/x86/include/rte_atomic_64.h +0 -1
@@ -182,7 +182,6 @@ static inline void rte_atomic64_clear(rte_atomic64_t *v)/*------------------------ 128 bit atomic operations -------------------------*/ -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp,
Signature · 1 line
2.39.2
RE: [PATCH v2 10/14] eal: mark rte_atomic128_cmp_exchange as stable
Quoted 54 lines
-----Original Message-----
From: Stephen Hemminger <[email protected]>
Sent: Saturday, October 21, 2023 5:41 AM
To: [email protected]
Cc: Stephen Hemminger <[email protected]>; Ruifeng Wang <[email protected]>; Bruce Richardson <[email protected]>; Konstantin Ananyev <[email protected]>
Subject: [PATCH v2 10/14] eal: markrte_atomic128_cmp_exchangeas stableThis has been around since 2021.
Signed-off-by Stephen Hemminger <[email protected]>--- lib/eal/arm/include/rte_atomic_64.h | 1 - lib/eal/include/generic/rte_atomic.h | 1 - lib/eal/x86/include/rte_atomic_64.h | 1 - 3 files changed, 3 deletions(-)lib/eal/arm/include/rte_atomic_64.h +0
-1@@ -94,7 +94,6 @@ __ATOMIC128_CAS_OP(__cas_128_acq_rel, "caspal")#endif -__rte_experimental static inline int rte_atomic128_cmp_exchange (rte_int128_t *dst,rte_int128_t *exp, const rte_int128_t *src, unsigned int weak, int success, diff --git
a/lib/eal/include/generic/rte_atomic.hb/lib/eal/include/generic/rte_atomic.hindexdb6797e379f3..048b547ea62b100644lib/eal/include/generic/rte_atomic.h +0
-1@@ -1147,7 +1147,6 @@ typedef struct {* @return * Non-zero on success; 0 on failure. */ -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp,lib/eal/x86/include/rte_atomic_64.h +0
-2@@ -182,7 +182,6 @@ static inline void rte_atomic64_clear(rte_atomic64_t *v)/*------------------------ 128 bit atomic operations -------------------------*/ -__rte_experimental static inline int rte_atomic128_cmp_exchange(rte_int128_t *dst, rte_int128_t *exp, --
Quoted 1 line
2.39.2
PATCH v2 11/14 eal: mark rte_power API's stable
In reply to Stephen HemmingerThese were added back in 2020.
--- lib/eal/include/generic/rte_power_intrinsics.h | 16 ---------------- lib/eal/version.map | 12 ++++-------- 2 files changed, 4 insertions(+), 24 deletions(-)
lib/eal/include/generic/rte_power_intrinsics.h +0 -16
@@ -54,9 +54,6 @@ struct rte_power_monitor_cond { };/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Monitor specific address for changes. This will cause the CPU to enter an * architecture-defined optimized power state until either the specified * memory address is written to, a certain TSC timestamp is reached, or other
@@ -84,14 +81,10 @@ struct rte_power_monitor_cond {* -EINVAL on invalid parameters * -ENOTSUP if unsupported */ -__rte_experimental int rte_power_monitor (const struct rte_power_monitor_cond *pmc,const uint64_t tsc_timestamp);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Wake up a specific lcore that is in a power optimized state and is monitoring * an address. *
@@ -104,13 +97,9 @@ int rte_power_monitor(const struct rte_power_monitor_cond *pmc,* @param lcore_id * Lcore ID of a sleeping thread. */ -__rte_experimental int rte_power_monitor_wakeup (const unsigned int lcore_id);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice. -* * Enter an architecture-defined optimized power state until a certain TSC * timestamp is reached. *
@@ -126,13 +115,9 @@ int rte_power_monitor_wakeup(const unsigned int lcore_id);* -EINVAL on invalid parameters * -ENOTSUP if unsupported */ -__rte_experimental int rte_power_pause (const uint64_t tsc_timestamp);/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Monitor a set of addresses for changes. This will cause the CPU to enter an * architecture-defined optimized power state until either one of the specified * memory addresses is written to, a certain TSC timestamp is reached, or other
@@ -160,7 +145,6 @@ int rte_power_pause(const uint64_t tsc_timestamp);* -EINVAL on invalid parameters * -ENOTSUP if unsupported */ -__rte_experimental int rte_power_monitor_multi (const struct rte_power_monitor_cond pmc[],const uint32_t num,const uint64_t tsc_timestamp);
lib/eal/version.map +4 -8
@@ -233,6 +233,10 @@ DPDK_24 { rte_mp_request_async; rte_mp_request_sync; rte_mp_sendmsg; + rte_power_monitor; # WINDOWS_NO_EXPORT + rte_power_monitor_wakeup; # WINDOWS_NO_EXPORT + rte_power_pause; # WINDOWS_NO_EXPORT + rte_power_monitor_multi; # WINDOWS_NO_EXPORT rte_rand; rte_rand_max; rte_realloc;
@@ -378,11 +382,6 @@ EXPERIMENTAL { rte_vect_get_max_simd_bitwidth; rte_vect_set_max_simd_bitwidth; - # added in 21.02 - rte_power_monitor; # WINDOWS_NO_EXPORT - rte_power_monitor_wakeup; # WINDOWS_NO_EXPORT - rte_power_pause; # WINDOWS_NO_EXPORT - # added in 21.05 rte_version_minor; rte_version_month;
@@ -391,9 +390,6 @@ EXPERIMENTAL { rte_version_suffix; rte_version_year; - # added in 21.08 - rte_power_monitor_multi; # WINDOWS_NO_EXPORT - # added in 21.11 # added in 23.03
Signature · 1 line
2.39.2
PATCH v2 12/14 eal: mark rte_eal_vfio_get_token stable
In reply to Stephen HemmingerThis API was added in 20.08 release.
--- lib/eal/include/rte_eal.h | 4 ---- lib/eal/version.map | 4 +--- 2 files changed, 1 insertion(+), 7 deletions(-)
lib/eal/include/rte_eal.h +0 -4
@@ -409,16 +409,12 @@ int rte_eal_create_uio_dev(void);enum rte_intr_mode rte_eal_vfio_intr_mode (void );/** -* @warning -* @b EXPERIMENTAL: this API may change without prior notice -* * Copy the user-configured vfio VF token. * * @param vf_token * vfio VF token configured with the command line is copied * into this parameter, zero uuid by default. */ -__rte_experimental void rte_eal_vfio_get_vf_token (rte_uuid_t vf_token);/**
lib/eal/version.map +1 -3
@@ -88,6 +88,7 @@ DPDK_24 { rte_eal_tailq_lookup; rte_eal_tailq_register; rte_eal_using_phys_addrs; + rte_eal_vfio_get_vf_token; # WINDOWS_NO_EXPORT rte_eal_vfio_intr_mode; # WINDOWS_NO_EXPORT rte_eal_wait_lcore; rte_epoll_ctl;
@@ -373,9 +374,6 @@ EXPERIMENTAL { rte_trace_regexp; # WINDOWS_NO_EXPORT rte_trace_save; # WINDOWS_NO_EXPORT - # added in 20.08 - rte_eal_vfio_get_vf_token; # WINDOWS_NO_EXPORT - # added in 20.11 __rte_eal_trace_generic_size_t; # WINDOWS_NO_EXPORT rte_cpu_get_intrinsics_support; # WINDOWS_NO_EXPORT
Signature · 1 line
2.39.2
PATCH v2 13/14 eal: mark rte_vect simd bandwidth API as stable
In reply to Stephen HemmingerThese were added back in 20.11.
--- lib/eal/include/generic/rte_vect.h | 8 -------- lib/eal/version.map | 4 ++-- 2 files changed, 2 insertions(+), 10 deletions(-)
lib/eal/include/generic/rte_vect.h +0 -8
@@ -208,21 +208,14 @@ enum rte_vect_max_simd { };/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Get the supported SIMD bitwidth. * * @return * uint16_t bitwidth. */ -__rte_experimental uint16_t rte_vect_get_max_simd_bitwidth (void );/** -* @warning -* @b EXPERIMENTAL: this API may change, or be removed, without prior notice -* * Set the supported SIMD bitwidth. * This API should only be called once at initialization, before EAL init. *
@@ -233,7 +226,6 @@ uint16_t rte_vect_get_max_simd_bitwidth(void);* - -EINVAL on invalid bitwidth parameter. * - -EPERM if bitwidth is forced. */ -__rte_experimental int rte_vect_set_max_simd_bitwidth (uint16_t bitwidth);#endif /* _RTE_VECT_H_ */
lib/eal/version.map +2 -2
@@ -314,6 +314,8 @@ DPDK_24 { rte_uuid_is_null; rte_uuid_parse; rte_uuid_unparse; + rte_vect_get_max_simd_bitwidth; + rte_vect_set_max_simd_bitwidth; rte_version; rte_vfio_clear_group; # WINDOWS_NO_EXPORT rte_vfio_container_create; # WINDOWS_NO_EXPORT
@@ -377,8 +379,6 @@ EXPERIMENTAL { # added in 20.11 __rte_eal_trace_generic_size_t; # WINDOWS_NO_EXPORT rte_cpu_get_intrinsics_support; # WINDOWS_NO_EXPORT - rte_vect_get_max_simd_bitwidth; - rte_vect_set_max_simd_bitwidth; # added in 21.05 rte_version_minor;
Signature · 1 line
2.39.2
PATCH v2 14/14 eal: make rte_version API's stable
In reply to Stephen HemmingerThese have been around since 2020 releases.
--- lib/eal/include/rte_version.h | 6 ------ lib/eal/version.map | 16 ++++++---------- 2 files changed, 6 insertions(+), 16 deletions(-)
lib/eal/include/rte_version.h +0 -6
@@ -35,37 +35,31 @@ extern "C" {/** * Function to return DPDK version prefix string */ -__rte_experimental const char *rte_version_prefix (void );/** * Function to return DPDK version year */ -__rte_experimental unsigned int rte_version_year (void );/** * Function to return DPDK version month */ -__rte_experimental unsigned int rte_version_month (void );/** * Function to return DPDK minor version number */ -__rte_experimental unsigned int rte_version_minor (void );/** * Function to return DPDK version suffix for any release candidates */ -__rte_experimental const char *rte_version_suffix (void );/** * Function to return DPDK version release candidate value */ -__rte_experimental unsigned int rte_version_release (void );/**
lib/eal/version.map +6 -10
@@ -317,6 +317,12 @@ DPDK_24 { rte_vect_get_max_simd_bitwidth; rte_vect_set_max_simd_bitwidth; rte_version; + rte_version_minor; + rte_version_month; + rte_version_prefix; + rte_version_release; + rte_version_suffix; + rte_version_year; rte_vfio_clear_group; # WINDOWS_NO_EXPORT rte_vfio_container_create; # WINDOWS_NO_EXPORT rte_vfio_container_destroy; # WINDOWS_NO_EXPORT
@@ -380,16 +386,6 @@ EXPERIMENTAL { __rte_eal_trace_generic_size_t; # WINDOWS_NO_EXPORT rte_cpu_get_intrinsics_support; # WINDOWS_NO_EXPORT - # added in 21.05 - rte_version_minor; - rte_version_month; - rte_version_prefix; - rte_version_release; - rte_version_suffix; - rte_version_year; - - # added in 21.11 - # added in 23.03 rte_lcore_register_usage_cb; __rte_eal_trace_generic_blob;
Signature · 1 line
2.39.2
Re: [PATCH v2 00/14] eal: mark older API's as stable
In reply to Stephen HemmingerQuoted 5 lines · Stephen Hemminger
About 80 function in EAL were marked experimental
and should have been made stable by now.v2 - rebase and fix some bits in wrong patch
Quoted 16 lines
Stephen Hemminger (14):
eal: make bitops a stable API
eal: markrte_devAPI's as stable
eal: makerte_classAPI's stable
eal: makerte_dranda stable API
eal: makerte_service_lcore_may_be_activestable
eal: makerte_devargs_resetstable
eal: make pflock API stable
eal: make seqcount and seqlock stable
eal: markrte_intr_XXXAPI's as stable
eal: markrte_atomic128_cmp_exchangeas stable
eal: markrte_powerAPI's stable
eal: markrte_eal_vfio_get_tokenstable
eal: markrte_vectsimd bandwidth API as stable
eal: makerte_versionAPI's stable
Re: [PATCH v2 00/14] eal: mark older API's as stable
In reply to Stephen HemmingerQuoted 34 lines · Stephen Hemminger
About 80 function in EAL were marked experimental
and should have been made stable by now.v2 - rebase and fix some bits in wrong patch
Stephen Hemminger (14):
eal: make bitops a stable API
eal: markrte_devAPI's as stable
eal: makerte_classAPI's stable
eal: makerte_dranda stable API
eal: makerte_service_lcore_may_be_activestable
eal: makerte_devargs_resetstable
eal: make pflock API stable
eal: make seqcount and seqlock stable
eal: markrte_intr_XXXAPI's as stable
eal: markrte_atomic128_cmp_exchangeas stable
eal: markrte_powerAPI's stable
eal: markrte_eal_vfio_get_tokenstable
eal: markrte_vectsimd bandwidth API as stable
eal: makerte_versionAPI's stablelib/eal/arm/include/rte_atomic_64.h | 1 - lib/eal/include/generic/rte_atomic.h | 1 - .../include/generic/rte_power_intrinsics.h | 16 ---- lib/eal/include/generic/rte_vect.h | 8 -- lib/eal/include/rte_bitmap.h | 8 -- lib/eal/include/rte_bitops.h | 40 -------- lib/eal/include/rte_class.h | 4 - lib/eal/include/rte_dev.h | 32 ------- lib/eal/include/rte_devargs.h | 1 - lib/eal/include/rte_eal.h | 4 - lib/eal/include/rte_interrupts.h | 28 ------ lib/eal/include/rte_pflock.h | 20 ----
Quoted 8 lines
lib/eal/include/rte_random.h | 4 - lib/eal/include/rte_seqcount.h | 23 ----- lib/eal/include/rte_seqlock.h | 21 ---- lib/eal/include/rte_service.h | 1 - lib/eal/include/rte_version.h | 6 -- lib/eal/version.map | 96 ++++++++----------- lib/eal/x86/include/rte_atomic_64.h | 1 - 19 files changed, 38 insertions(+), 277 deletions(-)
Series applied.
Thanks.
Signature · 1 line
David Marchand