On 11/09/2020 06:45, Joyce Kong wrote:
> RCU library supporting quiescent state was introduced
> in 19.05 release and has been around 4 releases, it
> should be mature enough to remove the experimental tag.
>
> Signed-off-by: Joyce Kong <joyce.k...@arm.com>
> Reviewed-by: Ruifeng Wang <ruifeng.w...@arm.com>
> ---
> MAINTAINERS | 2 +-
> lib/librte_rcu/rte_rcu_qsbr.h | 52 ------------------------------
> lib/librte_rcu/rte_rcu_version.map | 11 +++++--
> 3 files changed, 10 insertions(+), 55 deletions(-)
>
Some nits on tabing versus spaces below.
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 0e43a28bf..12f088b62 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -1449,7 +1449,7 @@ M: Olivier Matz <olivier.m...@6wind.com>
> F: lib/librte_kvargs/
> F: app/test/test_kvargs.c
>
> -RCU - EXPERIMENTAL
> +RCU
> M: Honnappa Nagarahalli <honnappa.nagaraha...@arm.com>
> F: lib/librte_rcu/
> F: app/test/test_rcu*
> diff --git a/lib/librte_rcu/rte_rcu_qsbr.h b/lib/librte_rcu/rte_rcu_qsbr.h
> index a98e8f0f8..5905c53a5 100644
> --- a/lib/librte_rcu/rte_rcu_qsbr.h
> +++ b/lib/librte_rcu/rte_rcu_qsbr.h
> @@ -202,9 +202,6 @@ struct rte_rcu_qsbr_dq_parameters {
> struct rte_rcu_qsbr_dq;
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Return the size of the memory occupied by a Quiescent State variable.
> *
> * @param max_threads
> @@ -215,14 +212,10 @@ struct rte_rcu_qsbr_dq;
> * Possible rte_errno codes are:
> * - EINVAL - max_threads is 0
> */
> -__rte_experimental
> size_t
> rte_rcu_qsbr_get_memsize(uint32_t max_threads);
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Initialize a Quiescent State (QS) variable.
> *
> * @param v
> @@ -237,14 +230,10 @@ rte_rcu_qsbr_get_memsize(uint32_t max_threads);
> * - EINVAL - max_threads is 0 or 'v' is NULL.
> *
> */
> -__rte_experimental
> int
> rte_rcu_qsbr_init(struct rte_rcu_qsbr *v, uint32_t max_threads);
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Register a reader thread to report its quiescent state
> * on a QS variable.
> *
> @@ -264,14 +253,10 @@ rte_rcu_qsbr_init(struct rte_rcu_qsbr *v, uint32_t
> max_threads);
> * the QS variable. thread_id is a value between 0 and (max_threads - 1).
> * 'max_threads' is the parameter passed in 'rte_rcu_qsbr_init' API.
> */
> -__rte_experimental
> int
> rte_rcu_qsbr_thread_register(struct rte_rcu_qsbr *v, unsigned int thread_id);
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Remove a reader thread, from the list of threads reporting their
> * quiescent state on a QS variable.
> *
> @@ -286,14 +271,10 @@ rte_rcu_qsbr_thread_register(struct rte_rcu_qsbr *v,
> unsigned int thread_id);
> * Reader thread with this thread ID will stop reporting its quiescent
> * state on the QS variable.
> */
> -__rte_experimental
> int
> rte_rcu_qsbr_thread_unregister(struct rte_rcu_qsbr *v, unsigned int
> thread_id);
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Add a registered reader thread, to the list of threads reporting their
> * quiescent state on a QS variable.
> *
> @@ -318,7 +299,6 @@ rte_rcu_qsbr_thread_unregister(struct rte_rcu_qsbr *v,
> unsigned int thread_id);
> * Reader thread with this thread ID will report its quiescent state on
> * the QS variable.
> */
> -__rte_experimental
> static __rte_always_inline void
> rte_rcu_qsbr_thread_online(struct rte_rcu_qsbr *v, unsigned int thread_id)
> {
> @@ -358,9 +338,6 @@ rte_rcu_qsbr_thread_online(struct rte_rcu_qsbr *v,
> unsigned int thread_id)
> }
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Remove a registered reader thread from the list of threads reporting their
> * quiescent state on a QS variable.
> *
> @@ -380,7 +357,6 @@ rte_rcu_qsbr_thread_online(struct rte_rcu_qsbr *v,
> unsigned int thread_id)
> * rte_rcu_qsbr_check API will not wait for the reader thread with
> * this thread ID to report its quiescent state on the QS variable.
> */
> -__rte_experimental
> static __rte_always_inline void
> rte_rcu_qsbr_thread_offline(struct rte_rcu_qsbr *v, unsigned int thread_id)
> {
> @@ -399,9 +375,6 @@ rte_rcu_qsbr_thread_offline(struct rte_rcu_qsbr *v,
> unsigned int thread_id)
> }
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Acquire a lock for accessing a shared data structure.
> *
> * This is implemented as a lock-free function. It is multi-thread
> @@ -421,7 +394,6 @@ rte_rcu_qsbr_thread_offline(struct rte_rcu_qsbr *v,
> unsigned int thread_id)
> * @param thread_id
> * Reader thread id
> */
> -__rte_experimental
> static __rte_always_inline void
> rte_rcu_qsbr_lock(__rte_unused struct rte_rcu_qsbr *v,
> __rte_unused unsigned int thread_id)
> @@ -436,9 +408,6 @@ rte_rcu_qsbr_lock(__rte_unused struct rte_rcu_qsbr *v,
> }
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Release a lock after accessing a shared data structure.
> *
> * This is implemented as a lock-free function. It is multi-thread
> @@ -458,7 +427,6 @@ rte_rcu_qsbr_lock(__rte_unused struct rte_rcu_qsbr *v,
> * @param thread_id
> * Reader thread id
> */
> -__rte_experimental
> static __rte_always_inline void
> rte_rcu_qsbr_unlock(__rte_unused struct rte_rcu_qsbr *v,
> __rte_unused unsigned int thread_id)
> @@ -477,9 +445,6 @@ rte_rcu_qsbr_unlock(__rte_unused struct rte_rcu_qsbr *v,
> }
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Ask the reader threads to report the quiescent state
> * status.
> *
> @@ -492,7 +457,6 @@ rte_rcu_qsbr_unlock(__rte_unused struct rte_rcu_qsbr *v,
> * - This is the token for this call of the API. This should be
> * passed to rte_rcu_qsbr_check API.
> */
> -__rte_experimental
> static __rte_always_inline uint64_t
> rte_rcu_qsbr_start(struct rte_rcu_qsbr *v)
> {
> @@ -511,9 +475,6 @@ rte_rcu_qsbr_start(struct rte_rcu_qsbr *v)
> }
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Update quiescent state for a reader thread.
> *
> * This is implemented as a lock-free function. It is multi-thread safe.
> @@ -525,7 +486,6 @@ rte_rcu_qsbr_start(struct rte_rcu_qsbr *v)
> * @param thread_id
> * Update the quiescent state for the reader with this thread ID.
> */
> -__rte_experimental
> static __rte_always_inline void
> rte_rcu_qsbr_quiescent(struct rte_rcu_qsbr *v, unsigned int thread_id)
> {
> @@ -683,9 +643,6 @@ __rte_rcu_qsbr_check_all(struct rte_rcu_qsbr *v, uint64_t
> t, bool wait)
> }
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Checks if all the reader threads have entered the quiescent state
> * referenced by token.
> *
> @@ -716,7 +673,6 @@ __rte_rcu_qsbr_check_all(struct rte_rcu_qsbr *v, uint64_t
> t, bool wait)
> * - 1 if all reader threads have passed through specified number
> * of quiescent states.
> */
> -__rte_experimental
> static __rte_always_inline int
> rte_rcu_qsbr_check(struct rte_rcu_qsbr *v, uint64_t t, bool wait)
> {
> @@ -740,9 +696,6 @@ rte_rcu_qsbr_check(struct rte_rcu_qsbr *v, uint64_t t,
> bool wait)
> }
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Wait till the reader threads have entered quiescent state.
> *
> * This is implemented as a lock-free function. It is multi-thread safe.
> @@ -760,14 +713,10 @@ rte_rcu_qsbr_check(struct rte_rcu_qsbr *v, uint64_t t,
> bool wait)
> * on this QS variable (i.e. the calling thread is also part of the
> * readside critical section). If not, pass RTE_QSBR_THRID_INVALID.
> */
> -__rte_experimental
> void
> rte_rcu_qsbr_synchronize(struct rte_rcu_qsbr *v, unsigned int thread_id);
>
> /**
> - * @warning
> - * @b EXPERIMENTAL: this API may change without prior notice
> - *
> * Dump the details of a single QS variables to a file.
> *
> * It is NOT multi-thread safe.
> @@ -782,7 +731,6 @@ rte_rcu_qsbr_synchronize(struct rte_rcu_qsbr *v, unsigned
> int thread_id);
> * Possible rte_errno codes are:
> * - EINVAL - NULL parameters are passed
> */
> -__rte_experimental
> int
> rte_rcu_qsbr_dump(FILE *f, struct rte_rcu_qsbr *v);
>
> diff --git a/lib/librte_rcu/rte_rcu_version.map
> b/lib/librte_rcu/rte_rcu_version.map
> index dfac88a37..e40850350 100644
> --- a/lib/librte_rcu/rte_rcu_version.map
> +++ b/lib/librte_rcu/rte_rcu_version.map
> @@ -1,5 +1,5 @@
> -EXPERIMENTAL {
> - global:
> +DPDK_21 {
> + global:
Tab pls
>
> rte_rcu_log_type;
> rte_rcu_qsbr_dump;
> @@ -8,6 +8,13 @@ EXPERIMENTAL {
> rte_rcu_qsbr_synchronize;
> rte_rcu_qsbr_thread_register;
> rte_rcu_qsbr_thread_unregister;
> +
> + local: *;
Tab pls
> +};
> +
> +EXPERIMENTAL {
> + global:
> +
> rte_rcu_qsbr_dq_create;
> rte_rcu_qsbr_dq_enqueue;
> rte_rcu_qsbr_dq_reclaim;
>
