From: Honnappa Nagarahalli Date: Fri, 15 Oct 2021 02:27:10 +0000 (-0500) Subject: hash: promote some functions to stable X-Git-Url: http://git.droids-corp.org/?a=commitdiff_plain;h=f4acb429d09db0594d41c5f5a48906df03ce6e5c;p=dpdk.git hash: promote some functions to stable Promote APIs to stable. Signed-off-by: Honnappa Nagarahalli Reviewed-by: Dharmik Thakkar Acked-by: Yipeng Wang --- diff --git a/lib/hash/rte_hash.h b/lib/hash/rte_hash.h index 73c415ff7e..6067aad954 100644 --- a/lib/hash/rte_hash.h +++ b/lib/hash/rte_hash.h @@ -205,9 +205,6 @@ int32_t rte_hash_count(const struct rte_hash *h); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Return the maximum key value ID that could possibly be returned by * rte_hash_add_key function. * @@ -217,7 +214,6 @@ rte_hash_count(const struct rte_hash *h); * - -EINVAL if parameters are invalid * - A value indicating the max key ID of key slots present in the table. */ -__rte_experimental int32_t rte_hash_max_key_id(const struct rte_hash *h); @@ -406,9 +402,6 @@ rte_hash_get_key_with_position(const struct rte_hash *h, const int32_t position, void **key); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Free a hash key in the hash table given the position * of the key. This operation is not multi-thread safe and should * only be called from one thread by default. Thread safety @@ -430,7 +423,6 @@ rte_hash_get_key_with_position(const struct rte_hash *h, const int32_t position, * - 0 if freed successfully * - -EINVAL if the parameters are invalid. */ -__rte_experimental int rte_hash_free_key_with_position(const struct rte_hash *h, const int32_t position); @@ -564,9 +556,6 @@ rte_hash_lookup_bulk_data(const struct rte_hash *h, const void **keys, uint32_t num_keys, uint64_t *hit_mask, void *data[]); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Find multiple keys in the hash table with precomputed hash value array. * This operation is multi-thread safe with regarding to other lookup threads. * Read-write concurrency can be enabled by setting flag during @@ -589,15 +578,11 @@ rte_hash_lookup_bulk_data(const struct rte_hash *h, const void **keys, * @return * -EINVAL if there's an error, otherwise 0. */ -__rte_experimental int rte_hash_lookup_with_hash_bulk(const struct rte_hash *h, const void **keys, hash_sig_t *sig, uint32_t num_keys, int32_t *positions); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Find multiple keys in the hash table with precomputed hash value array. * This operation is multi-thread safe with regarding to other lookup threads. * Read-write concurrency can be enabled by setting flag during @@ -618,7 +603,6 @@ rte_hash_lookup_with_hash_bulk(const struct rte_hash *h, const void **keys, * @return * -EINVAL if there's an error, otherwise number of successful lookups. */ -__rte_experimental int rte_hash_lookup_with_hash_bulk_data(const struct rte_hash *h, const void **keys, hash_sig_t *sig, @@ -672,9 +656,6 @@ int32_t rte_hash_iterate(const struct rte_hash *h, const void **key, void **data, uint32_t *next); /** - * @warning - * @b EXPERIMENTAL: this API may change without prior notice - * * Associate RCU QSBR variable with a Hash object. * This API should be called to enable the integrated RCU QSBR support and * should be called immediately after creating the Hash object. @@ -691,7 +672,6 @@ rte_hash_iterate(const struct rte_hash *h, const void **key, void **data, uint32 * - EEXIST - already added QSBR * - ENOMEM - memory allocation failure */ -__rte_experimental int rte_hash_rcu_qsbr_add(struct rte_hash *h, struct rte_hash_rcu_config *cfg); #ifdef __cplusplus diff --git a/lib/hash/version.map b/lib/hash/version.map index ce4309aa07..81854701c8 100644 --- a/lib/hash/version.map +++ b/lib/hash/version.map @@ -14,6 +14,7 @@ DPDK_22 { rte_hash_del_key_with_hash; rte_hash_find_existing; rte_hash_free; + rte_hash_free_key_with_position; rte_hash_get_key_with_position; rte_hash_hash; rte_hash_iterate; @@ -22,7 +23,11 @@ DPDK_22 { rte_hash_lookup_bulk_data; rte_hash_lookup_data; rte_hash_lookup_with_hash; + rte_hash_lookup_with_hash_bulk; + rte_hash_lookup_with_hash_bulk_data; rte_hash_lookup_with_hash_data; + rte_hash_max_key_id; + rte_hash_rcu_qsbr_add; rte_hash_reset; rte_hash_set_cmp_func; @@ -32,11 +37,6 @@ DPDK_22 { EXPERIMENTAL { global: - rte_hash_free_key_with_position; - rte_hash_lookup_with_hash_bulk; - rte_hash_lookup_with_hash_bulk_data; - rte_hash_max_key_id; - rte_hash_rcu_qsbr_add; rte_thash_add_helper; rte_thash_adjust_tuple; rte_thash_find_existing;