* [dpdk-dev] [PATCH 0/2] Fix remaining issues with __rte_experimental
@ 2019-06-28 15:56 Adrien Mazarguil
2019-06-28 15:56 ` [dpdk-dev] [PATCH 1/2] eal: fix duplicate experimental tag Adrien Mazarguil
2019-06-28 15:56 ` [dpdk-dev] [PATCH 2/2] Fix __rte_experimental clutter Adrien Mazarguil
0 siblings, 2 replies; 7+ messages in thread
From: Adrien Mazarguil @ 2019-06-28 15:56 UTC (permalink / raw)
To: Thomas Monjalon; +Cc: dev, David Marchand
This is a follow-up series to David's [1], addressing one remaining minor
issue and moving __rte_experimental on its own line where it belongs.
[1] "[PATCH 0/9] experimental tags fixes"
https://mails.dpdk.org/archives/dev/2019-June/136009.html
Adrien Mazarguil (2):
eal: fix duplicate experimental tag
Fix __rte_experimental clutter
devtools/checkpatches.sh | 6 +-
drivers/net/ixgbe/rte_pmd_ixgbe.h | 15 ++--
drivers/net/softnic/rte_eth_softnic.h | 3 +-
lib/librte_bbdev/rte_bbdev.h | 72 ++++++++++++------
lib/librte_bbdev/rte_bbdev_op.h | 18 +++--
lib/librte_bbdev/rte_bbdev_pmd.h | 12 ++-
lib/librte_bpf/rte_bpf.h | 18 +++--
lib/librte_bpf/rte_bpf_ethdev.h | 12 ++-
lib/librte_compressdev/rte_comp.h | 18 +++--
lib/librte_compressdev/rte_compressdev.h | 66 +++++++++++------
lib/librte_compressdev/rte_compressdev_pmd.h | 18 +++--
lib/librte_cryptodev/rte_cryptodev.h | 42 +++++++----
.../common/include/arch/x86/rte_atomic_64.h | 3 +-
.../common/include/generic/rte_atomic.h | 3 +-
.../common/include/generic/rte_cycles.h | 3 +-
.../common/include/generic/rte_rwlock.h | 6 +-
.../common/include/generic/rte_ticketlock.h | 27 ++++---
lib/librte_eal/common/include/rte_dev.h | 27 ++++---
lib/librte_eal/common/include/rte_eal.h | 18 +++--
lib/librte_eal/common/include/rte_fbarray.h | 78 +++++++++++++-------
lib/librte_eal/common/include/rte_interrupts.h | 3 +-
lib/librte_eal/common/include/rte_lcore.h | 6 +-
lib/librte_eal/common/include/rte_malloc.h | 30 +++++---
lib/librte_eal/common/include/rte_memory.h | 72 ++++++++++++------
lib/librte_eal/common/include/rte_random.h | 3 +-
lib/librte_eal/common/include/rte_service.h | 9 ++-
lib/librte_eal/common/rte_random.c | 2 +-
lib/librte_ethdev/rte_ethdev.h | 36 ++++++---
lib/librte_ethdev/rte_ethdev_driver.h | 15 ++--
lib/librte_ethdev/rte_flow_driver.h | 3 +-
lib/librte_ethdev/rte_mtr.h | 36 ++++++---
lib/librte_eventdev/rte_event_eth_rx_adapter.h | 6 +-
lib/librte_flow_classify/rte_flow_classify.h | 21 ++++--
lib/librte_hash/rte_hash.h | 3 +-
lib/librte_ip_frag/rte_ip_frag.h | 3 +-
lib/librte_ipsec/rte_ipsec.h | 9 ++-
lib/librte_ipsec/rte_ipsec_group.h | 6 +-
lib/librte_ipsec/rte_ipsec_sa.h | 12 ++-
lib/librte_kni/rte_kni.h | 3 +-
lib/librte_mbuf/rte_mbuf.h | 9 ++-
lib/librte_meter/rte_meter.h | 18 +++--
lib/librte_net/rte_arp.h | 3 +-
lib/librte_net/rte_net.h | 3 +-
lib/librte_pipeline/rte_port_in_action.h | 24 ++++--
lib/librte_pipeline/rte_table_action.h | 48 ++++++++----
lib/librte_power/rte_power_empty_poll.h | 21 ++++--
lib/librte_rcu/rte_rcu_qsbr.h | 39 ++++++----
lib/librte_sched/rte_sched.h | 3 +-
lib/librte_security/rte_security.h | 9 ++-
lib/librte_stack/rte_stack.h | 21 ++++--
lib/librte_stack/rte_stack_lf.h | 6 +-
lib/librte_stack/rte_stack_std.h | 9 ++-
lib/librte_table/rte_table_hash_func.h | 27 ++++---
lib/librte_telemetry/rte_telemetry.h | 9 ++-
lib/librte_telemetry/rte_telemetry_parser.h | 3 +-
lib/librte_timer/rte_timer.h | 24 ++++--
lib/librte_vhost/rte_vdpa.h | 21 ++++--
lib/librte_vhost/rte_vhost.h | 33 ++++++---
lib/librte_vhost/rte_vhost_crypto.h | 15 ++--
59 files changed, 724 insertions(+), 364 deletions(-)
--
2.11.0
^ permalink raw reply [flat|nested] 7+ messages in thread
* [dpdk-dev] [PATCH 1/2] eal: fix duplicate experimental tag
2019-06-28 15:56 [dpdk-dev] [PATCH 0/2] Fix remaining issues with __rte_experimental Adrien Mazarguil
@ 2019-06-28 15:56 ` Adrien Mazarguil
2019-06-28 16:05 ` Stephen Hemminger
2019-06-28 16:23 ` David Marchand
2019-06-28 15:56 ` [dpdk-dev] [PATCH 2/2] Fix __rte_experimental clutter Adrien Mazarguil
1 sibling, 2 replies; 7+ messages in thread
From: Adrien Mazarguil @ 2019-06-28 15:56 UTC (permalink / raw)
To: Thomas Monjalon; +Cc: dev, David Marchand, Mattias Rönnblom
Its presence on the function prototype in the header file is enough.
Fixes: 5f4ed3f05849 ("eal: introduce random generator with upper bound")
Cc: Mattias Rönnblom <mattias.ronnblom@ericsson.com>
Signed-off-by: Adrien Mazarguil <adrien.mazarguil@6wind.com>
---
lib/librte_eal/common/rte_random.c | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/lib/librte_eal/common/rte_random.c b/lib/librte_eal/common/rte_random.c
index 3d9b9b7d8..f85119048 100644
--- a/lib/librte_eal/common/rte_random.c
+++ b/lib/librte_eal/common/rte_random.c
@@ -137,7 +137,7 @@ rte_rand(void)
return __rte_rand_lfsr258(state);
}
-uint64_t __rte_experimental
+uint64_t
rte_rand_max(uint64_t upper_bound)
{
struct rte_rand_state *state;
--
2.11.0
^ permalink raw reply [flat|nested] 7+ messages in thread
* [dpdk-dev] [PATCH 2/2] Fix __rte_experimental clutter
2019-06-28 15:56 [dpdk-dev] [PATCH 0/2] Fix remaining issues with __rte_experimental Adrien Mazarguil
2019-06-28 15:56 ` [dpdk-dev] [PATCH 1/2] eal: fix duplicate experimental tag Adrien Mazarguil
@ 2019-06-28 15:56 ` Adrien Mazarguil
2019-06-28 19:22 ` David Marchand
1 sibling, 1 reply; 7+ messages in thread
From: Adrien Mazarguil @ 2019-06-28 15:56 UTC (permalink / raw)
To: Thomas Monjalon; +Cc: dev, David Marchand
Rather than prefixing the return type of function prototypes with
__rte_experimental, move it to a separate line to enhance readability.
Except for checkpatches.sh, this patch was automatically generated by:
sed -i \
-e '/^\([^#].*\)\?__rte_experimental */{' \
-e 's//\1/; s/ *$//; i\' \
-e __rte_experimental \
-e '/^$/d}' \
$(git grep -l __rte_experimental -- '*.h')
And applies on top of below commit:
Fixes: 3b45414830ff ("enforce __rte_experimental at the start of symbol declarations")
Cc: David Marchand <david.marchand@redhat.com>
Signed-off-by: Adrien Mazarguil <adrien.mazarguil@6wind.com>
---
devtools/checkpatches.sh | 6 +-
drivers/net/ixgbe/rte_pmd_ixgbe.h | 15 ++--
drivers/net/softnic/rte_eth_softnic.h | 3 +-
lib/librte_bbdev/rte_bbdev.h | 72 ++++++++++++------
lib/librte_bbdev/rte_bbdev_op.h | 18 +++--
lib/librte_bbdev/rte_bbdev_pmd.h | 12 ++-
lib/librte_bpf/rte_bpf.h | 18 +++--
lib/librte_bpf/rte_bpf_ethdev.h | 12 ++-
lib/librte_compressdev/rte_comp.h | 18 +++--
lib/librte_compressdev/rte_compressdev.h | 66 +++++++++++------
lib/librte_compressdev/rte_compressdev_pmd.h | 18 +++--
lib/librte_cryptodev/rte_cryptodev.h | 42 +++++++----
.../common/include/arch/x86/rte_atomic_64.h | 3 +-
.../common/include/generic/rte_atomic.h | 3 +-
.../common/include/generic/rte_cycles.h | 3 +-
.../common/include/generic/rte_rwlock.h | 6 +-
.../common/include/generic/rte_ticketlock.h | 27 ++++---
lib/librte_eal/common/include/rte_dev.h | 27 ++++---
lib/librte_eal/common/include/rte_eal.h | 18 +++--
lib/librte_eal/common/include/rte_fbarray.h | 78 +++++++++++++-------
lib/librte_eal/common/include/rte_interrupts.h | 3 +-
lib/librte_eal/common/include/rte_lcore.h | 6 +-
lib/librte_eal/common/include/rte_malloc.h | 30 +++++---
lib/librte_eal/common/include/rte_memory.h | 72 ++++++++++++------
lib/librte_eal/common/include/rte_random.h | 3 +-
lib/librte_eal/common/include/rte_service.h | 9 ++-
lib/librte_ethdev/rte_ethdev.h | 36 ++++++---
lib/librte_ethdev/rte_ethdev_driver.h | 15 ++--
lib/librte_ethdev/rte_flow_driver.h | 3 +-
lib/librte_ethdev/rte_mtr.h | 36 ++++++---
lib/librte_eventdev/rte_event_eth_rx_adapter.h | 6 +-
lib/librte_flow_classify/rte_flow_classify.h | 21 ++++--
lib/librte_hash/rte_hash.h | 3 +-
lib/librte_ip_frag/rte_ip_frag.h | 3 +-
lib/librte_ipsec/rte_ipsec.h | 9 ++-
lib/librte_ipsec/rte_ipsec_group.h | 6 +-
lib/librte_ipsec/rte_ipsec_sa.h | 12 ++-
lib/librte_kni/rte_kni.h | 3 +-
lib/librte_mbuf/rte_mbuf.h | 9 ++-
lib/librte_meter/rte_meter.h | 18 +++--
lib/librte_net/rte_arp.h | 3 +-
lib/librte_net/rte_net.h | 3 +-
lib/librte_pipeline/rte_port_in_action.h | 24 ++++--
lib/librte_pipeline/rte_table_action.h | 48 ++++++++----
lib/librte_power/rte_power_empty_poll.h | 21 ++++--
lib/librte_rcu/rte_rcu_qsbr.h | 39 ++++++----
lib/librte_sched/rte_sched.h | 3 +-
lib/librte_security/rte_security.h | 9 ++-
lib/librte_stack/rte_stack.h | 21 ++++--
lib/librte_stack/rte_stack_lf.h | 6 +-
lib/librte_stack/rte_stack_std.h | 9 ++-
lib/librte_table/rte_table_hash_func.h | 27 ++++---
lib/librte_telemetry/rte_telemetry.h | 9 ++-
lib/librte_telemetry/rte_telemetry_parser.h | 3 +-
lib/librte_timer/rte_timer.h | 24 ++++--
lib/librte_vhost/rte_vdpa.h | 21 ++++--
lib/librte_vhost/rte_vhost.h | 33 ++++++---
lib/librte_vhost/rte_vhost_crypto.h | 15 ++--
58 files changed, 723 insertions(+), 363 deletions(-)
diff --git a/devtools/checkpatches.sh b/devtools/checkpatches.sh
index 25e3cc56c..e39bb5e21 100755
--- a/devtools/checkpatches.sh
+++ b/devtools/checkpatches.sh
@@ -95,9 +95,9 @@ check_experimental_tags() { # <patch>
print "Please only put __rte_experimental tags in headers ("current_file")";
ret = 1;
}
- if ($1 != "+__rte_experimental" &&
- ($1 != "+" || $2 != "__rte_experimental")) {
- print "__rte_experimental must be at the start of functions prototype.";
+ if ($1 != "+__rte_experimental" || $2 != "") {
+ print "__rte_experimental must appear alone on the line" \
+ " immediately preceding the return type of a function."
ret = 1;
}
}
diff --git a/drivers/net/ixgbe/rte_pmd_ixgbe.h b/drivers/net/ixgbe/rte_pmd_ixgbe.h
index c0e91c861..f62fd761d 100644
--- a/drivers/net/ixgbe/rte_pmd_ixgbe.h
+++ b/drivers/net/ixgbe/rte_pmd_ixgbe.h
@@ -584,7 +584,8 @@ int rte_pmd_ixgbe_bypass_wd_reset(uint16_t port);
* - (-ENODEV) if *port* invalid.
* - (IXGBE_ERR_SWFW_SYNC) If sw/fw semaphore acquisition failed
*/
-__rte_experimental int
+__rte_experimental
+int
rte_pmd_ixgbe_mdio_lock(uint16_t port);
/**
@@ -597,7 +598,8 @@ rte_pmd_ixgbe_mdio_lock(uint16_t port);
* - (-ENOTSUP) if hardware doesn't support.
* - (-ENODEV) if *port* invalid.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_pmd_ixgbe_mdio_unlock(uint16_t port);
/**
@@ -618,7 +620,8 @@ rte_pmd_ixgbe_mdio_unlock(uint16_t port);
* - (-ENODEV) if *port* invalid.
* - (IXGBE_ERR_PHY) If PHY read command failed
*/
-__rte_experimental int
+__rte_experimental
+int
rte_pmd_ixgbe_mdio_unlocked_read(uint16_t port, uint32_t reg_addr,
uint32_t dev_type, uint16_t *phy_data);
@@ -641,7 +644,8 @@ rte_pmd_ixgbe_mdio_unlocked_read(uint16_t port, uint32_t reg_addr,
* - (-ENODEV) if *port* invalid.
* - (IXGBE_ERR_PHY) If PHY read command failed
*/
-__rte_experimental int
+__rte_experimental
+int
rte_pmd_ixgbe_mdio_unlocked_write(uint16_t port, uint32_t reg_addr,
uint32_t dev_type, uint16_t phy_data);
@@ -719,6 +723,7 @@ enum {
* - (-ENODEV) if *port* invalid.
* - (-ENOTSUP) if hardware doesn't support this feature.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_pmd_ixgbe_upd_fctrl_sbp(uint16_t port, int enable);
#endif /* _PMD_IXGBE_H_ */
diff --git a/drivers/net/softnic/rte_eth_softnic.h b/drivers/net/softnic/rte_eth_softnic.h
index 53cd48a2a..3f0116177 100644
--- a/drivers/net/softnic/rte_eth_softnic.h
+++ b/drivers/net/softnic/rte_eth_softnic.h
@@ -75,7 +75,8 @@ rte_pmd_softnic_run(uint16_t port_id);
* @return
* Zero on success, error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_pmd_softnic_manage(uint16_t port_id);
#ifdef __cplusplus
diff --git a/lib/librte_bbdev/rte_bbdev.h b/lib/librte_bbdev/rte_bbdev.h
index 3775dc4d4..c5175cc8d 100644
--- a/lib/librte_bbdev/rte_bbdev.h
+++ b/lib/librte_bbdev/rte_bbdev.h
@@ -55,7 +55,8 @@ enum rte_bbdev_state {
* @return
* The total number of usable devices.
*/
-__rte_experimental uint16_t
+__rte_experimental
+uint16_t
rte_bbdev_count(void);
/**
@@ -67,7 +68,8 @@ rte_bbdev_count(void);
* @return
* true if device ID is valid and device is attached, false otherwise.
*/
-__rte_experimental bool
+__rte_experimental
+bool
rte_bbdev_is_valid(uint16_t dev_id);
/**
@@ -80,7 +82,8 @@ rte_bbdev_is_valid(uint16_t dev_id);
* - The next device, or
* - RTE_BBDEV_MAX_DEVS if none found
*/
-__rte_experimental uint16_t
+__rte_experimental
+uint16_t
rte_bbdev_find_next(uint16_t dev_id);
/** Iterate through all enabled devices */
@@ -109,7 +112,8 @@ rte_bbdev_find_next(uint16_t dev_id);
* - -EBUSY if the identified device has already started
* - -ENOMEM if unable to allocate memory
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_setup_queues(uint16_t dev_id, uint16_t num_queues, int socket_id);
/**
@@ -126,7 +130,8 @@ rte_bbdev_setup_queues(uint16_t dev_id, uint16_t num_queues, int socket_id);
* - -EBUSY if the identified device has already started
* - -ENOTSUP if the interrupts are not supported by the device
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_intr_enable(uint16_t dev_id);
/** Device queue configuration structure */
@@ -155,7 +160,8 @@ struct rte_bbdev_queue_conf {
* - EINVAL if the identified queue size or priority are invalid
* - EBUSY if the identified queue or its device have already started
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_queue_configure(uint16_t dev_id, uint16_t queue_id,
const struct rte_bbdev_queue_conf *conf);
@@ -170,7 +176,8 @@ rte_bbdev_queue_configure(uint16_t dev_id, uint16_t queue_id,
* - 0 on success
* - negative value on failure - as returned from PMD driver
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_start(uint16_t dev_id);
/**
@@ -183,7 +190,8 @@ rte_bbdev_start(uint16_t dev_id);
* @return
* - 0 on success
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_stop(uint16_t dev_id);
/**
@@ -196,7 +204,8 @@ rte_bbdev_stop(uint16_t dev_id);
* @return
* - 0 on success
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_close(uint16_t dev_id);
/**
@@ -213,7 +222,8 @@ rte_bbdev_close(uint16_t dev_id);
* - 0 on success
* - negative value on failure - as returned from PMD driver
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_queue_start(uint16_t dev_id, uint16_t queue_id);
/**
@@ -228,7 +238,8 @@ rte_bbdev_queue_start(uint16_t dev_id, uint16_t queue_id);
* - 0 on success
* - negative value on failure - as returned from PMD driver
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_queue_stop(uint16_t dev_id, uint16_t queue_id);
/** Device statistics. */
@@ -261,7 +272,8 @@ struct rte_bbdev_stats {
* - 0 on success
* - EINVAL if invalid parameter pointer is provided
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_stats_get(uint16_t dev_id, struct rte_bbdev_stats *stats);
/**
@@ -272,7 +284,8 @@ rte_bbdev_stats_get(uint16_t dev_id, struct rte_bbdev_stats *stats);
* @return
* - 0 on success
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_stats_reset(uint16_t dev_id);
/** Device information supplied by the device's driver */
@@ -332,7 +345,8 @@ struct rte_bbdev_info {
* - 0 on success
* - EINVAL if invalid parameter pointer is provided
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_info_get(uint16_t dev_id, struct rte_bbdev_info *dev_info);
/** Queue information */
@@ -358,7 +372,8 @@ struct rte_bbdev_queue_info {
* - 0 on success
* - EINVAL if invalid parameter pointer is provided
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_queue_info_get(uint16_t dev_id, uint16_t queue_id,
struct rte_bbdev_queue_info *queue_info);
@@ -466,7 +481,8 @@ extern struct rte_bbdev rte_bbdev_devices[];
* The number of operations actually enqueued (this is the number of processed
* entries in the @p ops array).
*/
-__rte_experimental static inline uint16_t
+__rte_experimental
+static inline uint16_t
rte_bbdev_enqueue_enc_ops(uint16_t dev_id, uint16_t queue_id,
struct rte_bbdev_enc_op **ops, uint16_t num_ops)
{
@@ -496,7 +512,8 @@ rte_bbdev_enqueue_enc_ops(uint16_t dev_id, uint16_t queue_id,
* The number of operations actually enqueued (this is the number of processed
* entries in the @p ops array).
*/
-__rte_experimental static inline uint16_t
+__rte_experimental
+static inline uint16_t
rte_bbdev_enqueue_dec_ops(uint16_t dev_id, uint16_t queue_id,
struct rte_bbdev_dec_op **ops, uint16_t num_ops)
{
@@ -526,7 +543,8 @@ rte_bbdev_enqueue_dec_ops(uint16_t dev_id, uint16_t queue_id,
* The number of operations actually dequeued (this is the number of entries
* copied into the @p ops array).
*/
-__rte_experimental static inline uint16_t
+__rte_experimental
+static inline uint16_t
rte_bbdev_dequeue_enc_ops(uint16_t dev_id, uint16_t queue_id,
struct rte_bbdev_enc_op **ops, uint16_t num_ops)
{
@@ -557,7 +575,8 @@ rte_bbdev_dequeue_enc_ops(uint16_t dev_id, uint16_t queue_id,
* copied into the @p ops array).
*/
-__rte_experimental static inline uint16_t
+__rte_experimental
+static inline uint16_t
rte_bbdev_dequeue_dec_ops(uint16_t dev_id, uint16_t queue_id,
struct rte_bbdev_dec_op **ops, uint16_t num_ops)
{
@@ -608,7 +627,8 @@ typedef void (*rte_bbdev_cb_fn)(uint16_t dev_id,
* @return
* Zero on success, negative value on failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_callback_register(uint16_t dev_id, enum rte_bbdev_event_type event,
rte_bbdev_cb_fn cb_fn, void *cb_arg);
@@ -631,7 +651,8 @@ rte_bbdev_callback_register(uint16_t dev_id, enum rte_bbdev_event_type event,
* - EINVAL if invalid parameter pointer is provided
* - EAGAIN if the provided callback pointer does not exist
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_callback_unregister(uint16_t dev_id, enum rte_bbdev_event_type event,
rte_bbdev_cb_fn cb_fn, void *cb_arg);
@@ -651,7 +672,8 @@ rte_bbdev_callback_unregister(uint16_t dev_id, enum rte_bbdev_event_type event,
* - 0 on success
* - negative value on failure - as returned from PMD driver
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_queue_intr_enable(uint16_t dev_id, uint16_t queue_id);
/**
@@ -667,7 +689,8 @@ rte_bbdev_queue_intr_enable(uint16_t dev_id, uint16_t queue_id);
* - 0 on success
* - negative value on failure - as returned from PMD driver
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_queue_intr_disable(uint16_t dev_id, uint16_t queue_id);
/**
@@ -694,7 +717,8 @@ rte_bbdev_queue_intr_disable(uint16_t dev_id, uint16_t queue_id);
* - ENOTSUP if interrupts are not supported by the identified device
* - negative value on failure - as returned from PMD driver
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_queue_intr_ctl(uint16_t dev_id, uint16_t queue_id, int epfd, int op,
void *data);
diff --git a/lib/librte_bbdev/rte_bbdev_op.h b/lib/librte_bbdev/rte_bbdev_op.h
index a36625a53..b6ca3b0cd 100644
--- a/lib/librte_bbdev/rte_bbdev_op.h
+++ b/lib/librte_bbdev/rte_bbdev_op.h
@@ -461,7 +461,8 @@ struct rte_bbdev_op_pool_private {
* Operation type as string or NULL if op_type is invalid
*
*/
-__rte_experimental const char*
+__rte_experimental
+const char*
rte_bbdev_op_type_str(enum rte_bbdev_op_type op_type);
/**
@@ -484,7 +485,8 @@ rte_bbdev_op_type_str(enum rte_bbdev_op_type op_type);
* - Pointer to a mempool on success,
* - NULL pointer on failure.
*/
-__rte_experimental struct rte_mempool *
+__rte_experimental
+struct rte_mempool *
rte_bbdev_op_pool_create(const char *name, enum rte_bbdev_op_type type,
unsigned int num_elements, unsigned int cache_size,
int socket_id);
@@ -503,7 +505,8 @@ rte_bbdev_op_pool_create(const char *name, enum rte_bbdev_op_type type,
* - 0 on success
* - EINVAL if invalid mempool is provided
*/
-__rte_experimental static inline int
+__rte_experimental
+static inline int
rte_bbdev_enc_op_alloc_bulk(struct rte_mempool *mempool,
struct rte_bbdev_enc_op **ops, uint16_t num_ops)
{
@@ -538,7 +541,8 @@ rte_bbdev_enc_op_alloc_bulk(struct rte_mempool *mempool,
* - 0 on success
* - EINVAL if invalid mempool is provided
*/
-__rte_experimental static inline int
+__rte_experimental
+static inline int
rte_bbdev_dec_op_alloc_bulk(struct rte_mempool *mempool,
struct rte_bbdev_dec_op **ops, uint16_t num_ops)
{
@@ -569,7 +573,8 @@ rte_bbdev_dec_op_alloc_bulk(struct rte_mempool *mempool,
* @param num_ops
* Number of structures
*/
-__rte_experimental static inline void
+__rte_experimental
+static inline void
rte_bbdev_dec_op_free_bulk(struct rte_bbdev_dec_op **ops, unsigned int num_ops)
{
if (num_ops > 0)
@@ -586,7 +591,8 @@ rte_bbdev_dec_op_free_bulk(struct rte_bbdev_dec_op **ops, unsigned int num_ops)
* @param num_ops
* Number of structures
*/
-__rte_experimental static inline void
+__rte_experimental
+static inline void
rte_bbdev_enc_op_free_bulk(struct rte_bbdev_enc_op **ops, unsigned int num_ops)
{
if (num_ops > 0)
diff --git a/lib/librte_bbdev/rte_bbdev_pmd.h b/lib/librte_bbdev/rte_bbdev_pmd.h
index b5aa26764..24ddcee7a 100644
--- a/lib/librte_bbdev/rte_bbdev_pmd.h
+++ b/lib/librte_bbdev/rte_bbdev_pmd.h
@@ -43,7 +43,8 @@ extern "C" {
* @return
* - Slot in the rte_bbdev array for a new device;
*/
-__rte_experimental struct rte_bbdev *
+__rte_experimental
+struct rte_bbdev *
rte_bbdev_allocate(const char *name);
/**
@@ -55,7 +56,8 @@ rte_bbdev_allocate(const char *name);
* @return
* - 0 on success, negative on error
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bbdev_release(struct rte_bbdev *bbdev);
/**
@@ -69,7 +71,8 @@ rte_bbdev_release(struct rte_bbdev *bbdev);
* - NULL otherwise
*
*/
-__rte_experimental struct rte_bbdev *
+__rte_experimental
+struct rte_bbdev *
rte_bbdev_get_named_dev(const char *name);
/**
@@ -187,7 +190,8 @@ struct rte_bbdev_ops {
* @param ret_param
* To pass data back to user application.
*/
-__rte_experimental void
+__rte_experimental
+void
rte_bbdev_pmd_callback_process(struct rte_bbdev *dev,
enum rte_bbdev_event_type event, void *ret_param);
diff --git a/lib/librte_bpf/rte_bpf.h b/lib/librte_bpf/rte_bpf.h
index 2f275edea..cd4d56dea 100644
--- a/lib/librte_bpf/rte_bpf.h
+++ b/lib/librte_bpf/rte_bpf.h
@@ -113,7 +113,8 @@ struct rte_bpf;
* @param bpf
* BPF handle to destroy.
*/
-__rte_experimental void
+__rte_experimental
+void
rte_bpf_destroy(struct rte_bpf *bpf);
/**
@@ -128,7 +129,8 @@ rte_bpf_destroy(struct rte_bpf *bpf);
* - EINVAL - invalid parameter passed to function
* - ENOMEM - can't reserve enough memory
*/
-__rte_experimental struct rte_bpf *
+__rte_experimental
+struct rte_bpf *
rte_bpf_load(const struct rte_bpf_prm *prm);
/**
@@ -151,7 +153,8 @@ rte_bpf_load(const struct rte_bpf_prm *prm);
* - EINVAL - invalid parameter passed to function
* - ENOMEM - can't reserve enough memory
*/
-__rte_experimental struct rte_bpf *
+__rte_experimental
+struct rte_bpf *
rte_bpf_elf_load(const struct rte_bpf_prm *prm, const char *fname,
const char *sname);
/**
@@ -164,7 +167,8 @@ rte_bpf_elf_load(const struct rte_bpf_prm *prm, const char *fname,
* @return
* BPF execution return value.
*/
-__rte_experimental uint64_t
+__rte_experimental
+uint64_t
rte_bpf_exec(const struct rte_bpf *bpf, void *ctx);
/**
@@ -181,7 +185,8 @@ rte_bpf_exec(const struct rte_bpf *bpf, void *ctx);
* @return
* number of successfully processed inputs.
*/
-__rte_experimental uint32_t
+__rte_experimental
+uint32_t
rte_bpf_exec_burst(const struct rte_bpf *bpf, void *ctx[], uint64_t rc[],
uint32_t num);
@@ -196,7 +201,8 @@ rte_bpf_exec_burst(const struct rte_bpf *bpf, void *ctx[], uint64_t rc[],
* - -EINVAL if the parameters are invalid.
* - Zero if operation completed successfully.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bpf_get_jit(const struct rte_bpf *bpf, struct rte_bpf_jit *jit);
#ifdef __cplusplus
diff --git a/lib/librte_bpf/rte_bpf_ethdev.h b/lib/librte_bpf/rte_bpf_ethdev.h
index 0a63ac275..0ce526e39 100644
--- a/lib/librte_bpf/rte_bpf_ethdev.h
+++ b/lib/librte_bpf/rte_bpf_ethdev.h
@@ -45,7 +45,8 @@ enum {
* @param queue
* The identifier of the RX queue on the given port
*/
-__rte_experimental void
+__rte_experimental
+void
rte_bpf_eth_rx_unload(uint16_t port, uint16_t queue);
/**
@@ -57,7 +58,8 @@ rte_bpf_eth_rx_unload(uint16_t port, uint16_t queue);
* @param queue
* The identifier of the TX queue on the given port
*/
-__rte_experimental void
+__rte_experimental
+void
rte_bpf_eth_tx_unload(uint16_t port, uint16_t queue);
/**
@@ -80,7 +82,8 @@ rte_bpf_eth_tx_unload(uint16_t port, uint16_t queue);
* @return
* Zero on successful completion or negative error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bpf_eth_rx_elf_load(uint16_t port, uint16_t queue,
const struct rte_bpf_prm *prm, const char *fname, const char *sname,
uint32_t flags);
@@ -105,7 +108,8 @@ rte_bpf_eth_rx_elf_load(uint16_t port, uint16_t queue,
* @return
* Zero on successful completion or negative error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_bpf_eth_tx_elf_load(uint16_t port, uint16_t queue,
const struct rte_bpf_prm *prm, const char *fname, const char *sname,
uint32_t flags);
diff --git a/lib/librte_compressdev/rte_comp.h b/lib/librte_compressdev/rte_comp.h
index a4f35e48a..b7474c49b 100644
--- a/lib/librte_compressdev/rte_comp.h
+++ b/lib/librte_compressdev/rte_comp.h
@@ -420,7 +420,8 @@ struct rte_comp_op {
* - On success pointer to mempool
* - On failure NULL
*/
-__rte_experimental struct rte_mempool *
+__rte_experimental
+struct rte_mempool *
rte_comp_op_pool_create(const char *name,
unsigned int nb_elts, unsigned int cache_size,
uint16_t user_size, int socket_id);
@@ -435,7 +436,8 @@ rte_comp_op_pool_create(const char *name,
* - On success returns a valid rte_comp_op structure
* - On failure returns NULL
*/
-__rte_experimental struct rte_comp_op *
+__rte_experimental
+struct rte_comp_op *
rte_comp_op_alloc(struct rte_mempool *mempool);
/**
@@ -451,7 +453,8 @@ rte_comp_op_alloc(struct rte_mempool *mempool);
* - nb_ops: Success, the nb_ops requested was allocated
* - 0: Not enough entries in the mempool; no ops are retrieved.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_comp_op_bulk_alloc(struct rte_mempool *mempool,
struct rte_comp_op **ops, uint16_t nb_ops);
@@ -463,7 +466,8 @@ rte_comp_op_bulk_alloc(struct rte_mempool *mempool,
* @param op
* Compress operation
*/
-__rte_experimental void
+__rte_experimental
+void
rte_comp_op_free(struct rte_comp_op *op);
/**
@@ -477,7 +481,8 @@ rte_comp_op_free(struct rte_comp_op *op);
* @param nb_ops
* Number of operations to free
*/
-__rte_experimental void
+__rte_experimental
+void
rte_comp_op_bulk_free(struct rte_comp_op **ops, uint16_t nb_ops);
/**
@@ -489,7 +494,8 @@ rte_comp_op_bulk_free(struct rte_comp_op **ops, uint16_t nb_ops);
* @return
* The name of this flag, or NULL if it's not a valid feature flag.
*/
-__rte_experimental const char *
+__rte_experimental
+const char *
rte_comp_get_feature_name(uint64_t flag);
#ifdef __cplusplus
diff --git a/lib/librte_compressdev/rte_compressdev.h b/lib/librte_compressdev/rte_compressdev.h
index c3d779770..8052efe67 100644
--- a/lib/librte_compressdev/rte_compressdev.h
+++ b/lib/librte_compressdev/rte_compressdev.h
@@ -50,7 +50,8 @@ struct rte_compressdev_capabilities {
#define RTE_COMP_END_OF_CAPABILITIES_LIST() \
{ RTE_COMP_ALGO_UNSPECIFIED }
-__rte_experimental const struct rte_compressdev_capabilities *
+__rte_experimental
+const struct rte_compressdev_capabilities *
rte_compressdev_capability_get(uint8_t dev_id,
enum rte_comp_algorithm algo);
@@ -89,7 +90,8 @@ rte_compressdev_capability_get(uint8_t dev_id,
* @return
* The name of this flag, or NULL if it's not a valid feature flag.
*/
-__rte_experimental const char *
+__rte_experimental
+const char *
rte_compressdev_get_feature_name(uint64_t flag);
/** comp device information */
@@ -127,7 +129,8 @@ struct rte_compressdev_stats {
* - Returns compress device identifier on success.
* - Return -1 on failure to find named compress device.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_get_dev_id(const char *name);
/**
@@ -139,7 +142,8 @@ rte_compressdev_get_dev_id(const char *name);
* - Returns compress device name.
* - Returns NULL if compress device is not present.
*/
-__rte_experimental const char *
+__rte_experimental
+const char *
rte_compressdev_name_get(uint8_t dev_id);
/**
@@ -149,7 +153,8 @@ rte_compressdev_name_get(uint8_t dev_id);
* @return
* - The total number of usable compress devices.
*/
-__rte_experimental uint8_t
+__rte_experimental
+uint8_t
rte_compressdev_count(void);
/**
@@ -166,7 +171,8 @@ rte_compressdev_count(void);
* @return
* Returns number of attached compress devices.
*/
-__rte_experimental uint8_t
+__rte_experimental
+uint8_t
rte_compressdev_devices_get(const char *driver_name, uint8_t *devices,
uint8_t nb_devices);
@@ -180,7 +186,8 @@ rte_compressdev_devices_get(const char *driver_name, uint8_t *devices,
* a default of zero if the socket could not be determined.
* -1 if returned is the dev_id value is out of range.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_socket_id(uint8_t dev_id);
/** Compress device configuration structure */
@@ -210,7 +217,8 @@ struct rte_compressdev_config {
* - 0: Success, device configured.
* - <0: Error code returned by the driver configuration function.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_configure(uint8_t dev_id,
struct rte_compressdev_config *config);
@@ -228,7 +236,8 @@ rte_compressdev_configure(uint8_t dev_id,
* - 0: Success, device started.
* - <0: Error code of the driver device start function.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_start(uint8_t dev_id);
/**
@@ -238,7 +247,8 @@ rte_compressdev_start(uint8_t dev_id);
* @param dev_id
* Compress device identifier
*/
-__rte_experimental void
+__rte_experimental
+void
rte_compressdev_stop(uint8_t dev_id);
/**
@@ -255,7 +265,8 @@ rte_compressdev_stop(uint8_t dev_id);
* - 0 on successfully closing device
* - <0 on failure to close device
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_close(uint8_t dev_id);
/**
@@ -281,7 +292,8 @@ rte_compressdev_close(uint8_t dev_id);
* - 0: Success, queue pair correctly set up.
* - <0: Queue pair configuration failed
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_queue_pair_setup(uint8_t dev_id, uint16_t queue_pair_id,
uint32_t max_inflight_ops, int socket_id);
@@ -293,7 +305,8 @@ rte_compressdev_queue_pair_setup(uint8_t dev_id, uint16_t queue_pair_id,
* @return
* - The number of configured queue pairs.
*/
-__rte_experimental uint16_t
+__rte_experimental
+uint16_t
rte_compressdev_queue_pair_count(uint8_t dev_id);
@@ -310,7 +323,8 @@ rte_compressdev_queue_pair_count(uint8_t dev_id);
* - Zero if successful.
* - Non-zero otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_stats_get(uint8_t dev_id, struct rte_compressdev_stats *stats);
/**
@@ -319,7 +333,8 @@ rte_compressdev_stats_get(uint8_t dev_id, struct rte_compressdev_stats *stats);
* @param dev_id
* The identifier of the device.
*/
-__rte_experimental void
+__rte_experimental
+void
rte_compressdev_stats_reset(uint8_t dev_id);
/**
@@ -336,7 +351,8 @@ rte_compressdev_stats_reset(uint8_t dev_id);
* The element after the last valid element has it's op field set to
* RTE_COMP_ALGO_LIST_END.
*/
-__rte_experimental void
+__rte_experimental
+void
rte_compressdev_info_get(uint8_t dev_id, struct rte_compressdev_info *dev_info);
/**
@@ -393,7 +409,8 @@ rte_compressdev_info_get(uint8_t dev_id, struct rte_compressdev_info *dev_info);
* of pointers to *rte_comp_op* structures effectively supplied to the
* *ops* array.
*/
-__rte_experimental uint16_t
+__rte_experimental
+uint16_t
rte_compressdev_dequeue_burst(uint8_t dev_id, uint16_t qp_id,
struct rte_comp_op **ops, uint16_t nb_ops);
@@ -447,7 +464,8 @@ rte_compressdev_dequeue_burst(uint8_t dev_id, uint16_t qp_id,
* comp devices queue is full or if invalid parameters are specified in
* a *rte_comp_op*.
*/
-__rte_experimental uint16_t
+__rte_experimental
+uint16_t
rte_compressdev_enqueue_burst(uint8_t dev_id, uint16_t qp_id,
struct rte_comp_op **ops, uint16_t nb_ops);
@@ -475,7 +493,8 @@ rte_compressdev_enqueue_burst(uint8_t dev_id, uint16_t qp_id,
* - Returns -ENOMEM if the private stream could not be allocated.
*
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_stream_create(uint8_t dev_id,
const struct rte_comp_xform *xform,
void **stream);
@@ -496,7 +515,8 @@ rte_compressdev_stream_create(uint8_t dev_id,
* - Returns -ENOTSUP if comp device does not support STATEFUL operations.
* - Returns -EBUSY if can't free stream as there are inflight operations
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_stream_free(uint8_t dev_id, void *stream);
/**
@@ -522,7 +542,8 @@ rte_compressdev_stream_free(uint8_t dev_id, void *stream);
* - Returns -ENOTSUP if comp device does not support the comp transform.
* - Returns -ENOMEM if the private_xform could not be allocated.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_private_xform_create(uint8_t dev_id,
const struct rte_comp_xform *xform,
void **private_xform);
@@ -543,7 +564,8 @@ rte_compressdev_private_xform_create(uint8_t dev_id,
* - <0 in error cases
* - Returns -EINVAL if input parameters are invalid.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_private_xform_free(uint8_t dev_id, void *private_xform);
#ifdef __cplusplus
diff --git a/lib/librte_compressdev/rte_compressdev_pmd.h b/lib/librte_compressdev/rte_compressdev_pmd.h
index 7d947e074..c8e017577 100644
--- a/lib/librte_compressdev/rte_compressdev_pmd.h
+++ b/lib/librte_compressdev/rte_compressdev_pmd.h
@@ -59,7 +59,8 @@ struct rte_compressdev_global {
* @return
* - The rte_compressdev structure pointer for the given device identifier.
*/
-__rte_experimental struct rte_compressdev *
+__rte_experimental
+struct rte_compressdev *
rte_compressdev_pmd_get_named_dev(const char *name);
/**
@@ -299,7 +300,8 @@ struct rte_compressdev_ops {
* @return
* - Slot in the rte_dev_devices array for a new device;
*/
-__rte_experimental struct rte_compressdev *
+__rte_experimental
+struct rte_compressdev *
rte_compressdev_pmd_allocate(const char *name, int socket_id);
/**
@@ -314,7 +316,8 @@ rte_compressdev_pmd_allocate(const char *name, int socket_id);
* @return
* - 0 on success, negative on error
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_pmd_release_device(struct rte_compressdev *dev);
@@ -336,7 +339,8 @@ rte_compressdev_pmd_release_device(struct rte_compressdev *dev);
* - 0 on success
* - errno on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_pmd_parse_input_args(
struct rte_compressdev_pmd_init_params *params,
const char *args);
@@ -357,7 +361,8 @@ rte_compressdev_pmd_parse_input_args(
* - comp device instance on success
* - NULL on creation failure
*/
-__rte_experimental struct rte_compressdev *
+__rte_experimental
+struct rte_compressdev *
rte_compressdev_pmd_create(const char *name,
struct rte_device *device,
size_t private_data_size,
@@ -375,7 +380,8 @@ rte_compressdev_pmd_create(const char *name,
* - 0 on success
* - errno on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_compressdev_pmd_destroy(struct rte_compressdev *dev);
#ifdef __cplusplus
diff --git a/lib/librte_cryptodev/rte_cryptodev.h b/lib/librte_cryptodev/rte_cryptodev.h
index 09a04680c..cb894ef63 100644
--- a/lib/librte_cryptodev/rte_cryptodev.h
+++ b/lib/librte_cryptodev/rte_cryptodev.h
@@ -230,7 +230,8 @@ rte_cryptodev_sym_capability_get(uint8_t dev_id,
* - Return description of the asymmetric crypto capability if exist.
* - Return NULL if the capability not exist.
*/
-__rte_experimental const struct rte_cryptodev_asymmetric_xform_capability *
+__rte_experimental
+const struct rte_cryptodev_asymmetric_xform_capability *
rte_cryptodev_asym_capability_get(uint8_t dev_id,
const struct rte_cryptodev_asym_capability_idx *idx);
@@ -299,7 +300,8 @@ rte_cryptodev_sym_capability_check_aead(
* - Return 1 if the op type is supported
* - Return 0 if unsupported
*/
-__rte_experimental int
+__rte_experimental
+int
rte_cryptodev_asym_xform_capability_check_optype(
const struct rte_cryptodev_asymmetric_xform_capability *capability,
enum rte_crypto_asym_op_type op_type);
@@ -314,7 +316,8 @@ rte_cryptodev_asym_xform_capability_check_optype(
* - Return 0 if the parameters are in range of the capability.
* - Return -1 if the parameters are out of range of the capability.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_cryptodev_asym_xform_capability_check_modlen(
const struct rte_cryptodev_asymmetric_xform_capability *capability,
uint16_t modlen);
@@ -375,7 +378,8 @@ rte_cryptodev_get_aead_algo_enum(enum rte_crypto_aead_algorithm *algo_enum,
* - Return -1 if string is not valid
* - Return 0 if the string is valid
*/
-__rte_experimental int
+__rte_experimental
+int
rte_cryptodev_asym_get_xform_enum(enum rte_crypto_asym_xform_type *xform_enum,
const char *xform_string);
@@ -1002,7 +1006,8 @@ struct rte_cryptodev_asym_session {
* - On success return size of the session
* - On failure returns 0
*/
-__rte_experimental struct rte_mempool *
+__rte_experimental
+struct rte_mempool *
rte_cryptodev_sym_session_pool_create(const char *name, uint32_t nb_elts,
uint32_t elt_size, uint32_t cache_size, uint16_t priv_size,
int socket_id);
@@ -1028,7 +1033,8 @@ rte_cryptodev_sym_session_create(struct rte_mempool *mempool);
* - On success return pointer to asym-session
* - On failure returns NULL
*/
-__rte_experimental struct rte_cryptodev_asym_session *
+__rte_experimental
+struct rte_cryptodev_asym_session *
rte_cryptodev_asym_session_create(struct rte_mempool *mempool);
/**
@@ -1058,7 +1064,8 @@ rte_cryptodev_sym_session_free(struct rte_cryptodev_sym_session *sess);
* - -EINVAL if session is NULL.
* - -EBUSY if not all device private data has been freed.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_cryptodev_asym_session_free(struct rte_cryptodev_asym_session *sess);
/**
@@ -1098,7 +1105,8 @@ rte_cryptodev_sym_session_init(uint8_t dev_id,
* - -ENOTSUP if crypto device does not support the crypto transform.
* - -ENOMEM if the private session could not be allocated.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_cryptodev_asym_session_init(uint8_t dev_id,
struct rte_cryptodev_asym_session *sess,
struct rte_crypto_asym_xform *xforms,
@@ -1132,7 +1140,8 @@ rte_cryptodev_sym_session_clear(uint8_t dev_id,
* - 0 if successful.
* - -EINVAL if device is invalid or session is NULL.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_cryptodev_asym_session_clear(uint8_t dev_id,
struct rte_cryptodev_asym_session *sess);
@@ -1157,7 +1166,8 @@ rte_cryptodev_sym_get_header_session_size(void);
* the private data size defined within sess.
* - If sess is NULL, return 0.
*/
-__rte_experimental unsigned int
+__rte_experimental
+unsigned int
rte_cryptodev_sym_get_existing_header_session_size(
struct rte_cryptodev_sym_session *sess);
@@ -1167,7 +1177,8 @@ rte_cryptodev_sym_get_existing_header_session_size(
* @return
* Size of the asymmetric header session.
*/
-__rte_experimental unsigned int
+__rte_experimental
+unsigned int
rte_cryptodev_asym_get_header_session_size(void);
/**
@@ -1194,7 +1205,8 @@ rte_cryptodev_sym_get_private_session_size(uint8_t dev_id);
* - Size of the asymmetric private data, if successful
* - 0 if device is invalid or does not have private session
*/
-__rte_experimental unsigned int
+__rte_experimental
+unsigned int
rte_cryptodev_asym_get_private_session_size(uint8_t dev_id);
/**
@@ -1229,7 +1241,8 @@ const char *rte_cryptodev_driver_name_get(uint8_t driver_id);
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_cryptodev_sym_session_set_user_data(
struct rte_cryptodev_sym_session *sess,
void *data,
@@ -1245,7 +1258,8 @@ rte_cryptodev_sym_session_set_user_data(
* - On success return pointer to user data.
* - On failure returns NULL.
*/
-__rte_experimental void *
+__rte_experimental
+void *
rte_cryptodev_sym_session_get_user_data(
struct rte_cryptodev_sym_session *sess);
diff --git a/lib/librte_eal/common/include/arch/x86/rte_atomic_64.h b/lib/librte_eal/common/include/arch/x86/rte_atomic_64.h
index 4943a984a..e087c6c32 100644
--- a/lib/librte_eal/common/include/arch/x86/rte_atomic_64.h
+++ b/lib/librte_eal/common/include/arch/x86/rte_atomic_64.h
@@ -224,7 +224,8 @@ typedef struct {
};
} __rte_aligned(16) rte_int128_t;
-__rte_experimental static inline int
+__rte_experimental
+static inline int
rte_atomic128_cmp_exchange(rte_int128_t *dst,
rte_int128_t *exp,
const rte_int128_t *src,
diff --git a/lib/librte_eal/common/include/generic/rte_atomic.h b/lib/librte_eal/common/include/generic/rte_atomic.h
index 1eb55d95c..24ff7dcae 100644
--- a/lib/librte_eal/common/include/generic/rte_atomic.h
+++ b/lib/librte_eal/common/include/generic/rte_atomic.h
@@ -1121,7 +1121,8 @@ static inline void rte_atomic64_clear(rte_atomic64_t *v)
* @return
* Non-zero on success; 0 on failure.
*/
-__rte_experimental static inline int
+__rte_experimental
+static inline int
rte_atomic128_cmp_exchange(rte_int128_t *dst,
rte_int128_t *exp,
const rte_int128_t *src,
diff --git a/lib/librte_eal/common/include/generic/rte_cycles.h b/lib/librte_eal/common/include/generic/rte_cycles.h
index 4c7e3e091..73d1fa7b9 100644
--- a/lib/librte_eal/common/include/generic/rte_cycles.h
+++ b/lib/librte_eal/common/include/generic/rte_cycles.h
@@ -165,7 +165,8 @@ void rte_delay_us_block(unsigned int us);
* @param us
* Number of microseconds to wait.
*/
-__rte_experimental void
+__rte_experimental
+void
rte_delay_us_sleep(unsigned int us);
/**
diff --git a/lib/librte_eal/common/include/generic/rte_rwlock.h b/lib/librte_eal/common/include/generic/rte_rwlock.h
index 4139a0483..da9bc3e9c 100644
--- a/lib/librte_eal/common/include/generic/rte_rwlock.h
+++ b/lib/librte_eal/common/include/generic/rte_rwlock.h
@@ -88,7 +88,8 @@ rte_rwlock_read_lock(rte_rwlock_t *rwl)
* - -EBUSY if lock could not be acquired for reading because a
* writer holds the lock
*/
-__rte_experimental static inline int
+__rte_experimental
+static inline int
rte_rwlock_read_trylock(rte_rwlock_t *rwl)
{
int32_t x;
@@ -131,7 +132,8 @@ rte_rwlock_read_unlock(rte_rwlock_t *rwl)
* - -EBUSY if lock could not be acquired for writing because
* it was already locked for reading or writing
*/
-__rte_experimental static inline int
+__rte_experimental
+static inline int
rte_rwlock_write_trylock(rte_rwlock_t *rwl)
{
int32_t x;
diff --git a/lib/librte_eal/common/include/generic/rte_ticketlock.h b/lib/librte_eal/common/include/generic/rte_ticketlock.h
index d93d3877a..d9bec8769 100644
--- a/lib/librte_eal/common/include/generic/rte_ticketlock.h
+++ b/lib/librte_eal/common/include/generic/rte_ticketlock.h
@@ -48,7 +48,8 @@ typedef union {
* @param tl
* A pointer to the ticketlock.
*/
-__rte_experimental static inline void
+__rte_experimental
+static inline void
rte_ticketlock_init(rte_ticketlock_t *tl)
{
__atomic_store_n(&tl->tickets, 0, __ATOMIC_RELAXED);
@@ -60,7 +61,8 @@ rte_ticketlock_init(rte_ticketlock_t *tl)
* @param tl
* A pointer to the ticketlock.
*/
-__rte_experimental static inline void
+__rte_experimental
+static inline void
rte_ticketlock_lock(rte_ticketlock_t *tl)
{
uint16_t me = __atomic_fetch_add(&tl->s.next, 1, __ATOMIC_RELAXED);
@@ -74,7 +76,8 @@ rte_ticketlock_lock(rte_ticketlock_t *tl)
* @param tl
* A pointer to the ticketlock.
*/
-__rte_experimental static inline void
+__rte_experimental
+static inline void
rte_ticketlock_unlock(rte_ticketlock_t *tl)
{
uint16_t i = __atomic_load_n(&tl->s.current, __ATOMIC_RELAXED);
@@ -89,7 +92,8 @@ rte_ticketlock_unlock(rte_ticketlock_t *tl)
* @return
* 1 if the lock is successfully taken; 0 otherwise.
*/
-__rte_experimental static inline int
+__rte_experimental
+static inline int
rte_ticketlock_trylock(rte_ticketlock_t *tl)
{
rte_ticketlock_t old, new;
@@ -113,7 +117,8 @@ rte_ticketlock_trylock(rte_ticketlock_t *tl)
* @return
* 1 if the lock is currently taken; 0 otherwise.
*/
-__rte_experimental static inline int
+__rte_experimental
+static inline int
rte_ticketlock_is_locked(rte_ticketlock_t *tl)
{
rte_ticketlock_t tic;
@@ -144,7 +149,8 @@ typedef struct {
* @param tlr
* A pointer to the recursive ticketlock.
*/
-__rte_experimental static inline void
+__rte_experimental
+static inline void
rte_ticketlock_recursive_init(rte_ticketlock_recursive_t *tlr)
{
rte_ticketlock_init(&tlr->tl);
@@ -158,7 +164,8 @@ rte_ticketlock_recursive_init(rte_ticketlock_recursive_t *tlr)
* @param tlr
* A pointer to the recursive ticketlock.
*/
-__rte_experimental static inline void
+__rte_experimental
+static inline void
rte_ticketlock_recursive_lock(rte_ticketlock_recursive_t *tlr)
{
int id = rte_gettid();
@@ -176,7 +183,8 @@ rte_ticketlock_recursive_lock(rte_ticketlock_recursive_t *tlr)
* @param tlr
* A pointer to the recursive ticketlock.
*/
-__rte_experimental static inline void
+__rte_experimental
+static inline void
rte_ticketlock_recursive_unlock(rte_ticketlock_recursive_t *tlr)
{
if (--(tlr->count) == 0) {
@@ -194,7 +202,8 @@ rte_ticketlock_recursive_unlock(rte_ticketlock_recursive_t *tlr)
* @return
* 1 if the lock is successfully taken; 0 otherwise.
*/
-__rte_experimental static inline int
+__rte_experimental
+static inline int
rte_ticketlock_recursive_trylock(rte_ticketlock_recursive_t *tlr)
{
int id = rte_gettid();
diff --git a/lib/librte_eal/common/include/rte_dev.h b/lib/librte_eal/common/include/rte_dev.h
index 6c3b8be53..a01c4ad92 100644
--- a/lib/librte_eal/common/include/rte_dev.h
+++ b/lib/librte_eal/common/include/rte_dev.h
@@ -363,7 +363,8 @@ rte_dev_iterator_next(struct rte_dev_iterator *it);
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_dev_event_callback_register(const char *device_name,
rte_dev_event_cb_fn cb_fn,
void *cb_arg);
@@ -387,7 +388,8 @@ 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_experimental
+int
rte_dev_event_callback_unregister(const char *device_name,
rte_dev_event_cb_fn cb_fn,
void *cb_arg);
@@ -404,7 +406,8 @@ rte_dev_event_callback_unregister(const char *device_name,
* @param event
* the device event type.
*/
-__rte_experimental void
+__rte_experimental
+void
rte_dev_event_callback_process(const char *device_name,
enum rte_dev_event_type event);
@@ -418,7 +421,8 @@ rte_dev_event_callback_process(const char *device_name,
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_dev_event_monitor_start(void);
/**
@@ -431,7 +435,8 @@ rte_dev_event_monitor_start(void);
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_dev_event_monitor_stop(void);
/**
@@ -444,7 +449,8 @@ rte_dev_event_monitor_stop(void);
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_dev_hotplug_handle_enable(void);
/**
@@ -457,7 +463,8 @@ rte_dev_hotplug_handle_enable(void);
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_dev_hotplug_handle_disable(void);
/**
@@ -480,7 +487,8 @@ rte_dev_hotplug_handle_disable(void);
* 0 if mapping was successful.
* Negative value and rte_errno is set otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_dev_dma_map(struct rte_device *dev, void *addr, uint64_t iova, size_t len);
/**
@@ -503,7 +511,8 @@ 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_experimental
+int
rte_dev_dma_unmap(struct rte_device *dev, void *addr, uint64_t iova,
size_t len);
diff --git a/lib/librte_eal/common/include/rte_eal.h b/lib/librte_eal/common/include/rte_eal.h
index 1500ded8f..bf0c74e07 100644
--- a/lib/librte_eal/common/include/rte_eal.h
+++ b/lib/librte_eal/common/include/rte_eal.h
@@ -275,7 +275,8 @@ typedef int (*rte_mp_async_reply_t)(const struct rte_mp_msg *request,
* - 0 on success.
* - (<0) on failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mp_action_register(const char *name, rte_mp_t action);
/**
@@ -295,7 +296,8 @@ rte_mp_action_register(const char *name, rte_mp_t action);
* The name argument plays as the nonredundant key to find the action.
*
*/
-__rte_experimental void
+__rte_experimental
+void
rte_mp_action_unregister(const char *name);
/**
@@ -314,7 +316,8 @@ rte_mp_action_unregister(const char *name);
* - On success, return 0.
* - On failure, return -1, and the reason will be stored in rte_errno.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mp_sendmsg(struct rte_mp_msg *msg);
/**
@@ -348,7 +351,8 @@ rte_mp_sendmsg(struct rte_mp_msg *msg);
* - On success, return 0.
* - On failure, return -1, and the reason will be stored in rte_errno.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mp_request_sync(struct rte_mp_msg *req, struct rte_mp_reply *reply,
const struct timespec *ts);
@@ -377,7 +381,8 @@ rte_mp_request_sync(struct rte_mp_msg *req, struct rte_mp_reply *reply,
* - On success, return 0.
* - On failure, return -1, and the reason will be stored in rte_errno.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mp_request_async(struct rte_mp_msg *req, const struct timespec *ts,
rte_mp_async_reply_t clb);
@@ -405,7 +410,8 @@ rte_mp_request_async(struct rte_mp_msg *req, const struct timespec *ts,
* - On success, return 0.
* - On failure, return -1, and the reason will be stored in rte_errno.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mp_reply(struct rte_mp_msg *msg, const char *peer);
/**
diff --git a/lib/librte_eal/common/include/rte_fbarray.h b/lib/librte_eal/common/include/rte_fbarray.h
index 57fb20442..d0af2d8c7 100644
--- a/lib/librte_eal/common/include/rte_fbarray.h
+++ b/lib/librte_eal/common/include/rte_fbarray.h
@@ -75,7 +75,8 @@ struct rte_fbarray {
* - 0 on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_init(struct rte_fbarray *arr, const char *name, unsigned int len,
unsigned int elt_sz);
@@ -97,7 +98,8 @@ rte_fbarray_init(struct rte_fbarray *arr, const char *name, unsigned int len,
* - 0 on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_attach(struct rte_fbarray *arr);
@@ -118,7 +120,8 @@ rte_fbarray_attach(struct rte_fbarray *arr);
* - 0 on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_destroy(struct rte_fbarray *arr);
@@ -136,7 +139,8 @@ rte_fbarray_destroy(struct rte_fbarray *arr);
* - 0 on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_detach(struct rte_fbarray *arr);
@@ -153,7 +157,8 @@ rte_fbarray_detach(struct rte_fbarray *arr);
* - non-NULL pointer on success.
* - NULL on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental void *
+__rte_experimental
+void *
rte_fbarray_get(const struct rte_fbarray *arr, unsigned int idx);
@@ -170,7 +175,8 @@ rte_fbarray_get(const struct rte_fbarray *arr, unsigned int idx);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_idx(const struct rte_fbarray *arr, const void *elt);
@@ -187,7 +193,8 @@ rte_fbarray_find_idx(const struct rte_fbarray *arr, const void *elt);
* - 0 on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_set_used(struct rte_fbarray *arr, unsigned int idx);
@@ -204,7 +211,8 @@ rte_fbarray_set_used(struct rte_fbarray *arr, unsigned int idx);
* - 0 on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_set_free(struct rte_fbarray *arr, unsigned int idx);
@@ -222,7 +230,8 @@ rte_fbarray_set_free(struct rte_fbarray *arr, unsigned int idx);
* - 0 if element is unused.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_is_used(struct rte_fbarray *arr, unsigned int idx);
@@ -239,7 +248,8 @@ rte_fbarray_is_used(struct rte_fbarray *arr, unsigned int idx);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_next_free(struct rte_fbarray *arr, unsigned int start);
@@ -256,7 +266,8 @@ rte_fbarray_find_next_free(struct rte_fbarray *arr, unsigned int start);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_next_used(struct rte_fbarray *arr, unsigned int start);
@@ -276,7 +287,8 @@ rte_fbarray_find_next_used(struct rte_fbarray *arr, unsigned int start);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_next_n_free(struct rte_fbarray *arr, unsigned int start,
unsigned int n);
@@ -297,7 +309,8 @@ rte_fbarray_find_next_n_free(struct rte_fbarray *arr, unsigned int start,
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_next_n_used(struct rte_fbarray *arr, unsigned int start,
unsigned int n);
@@ -315,7 +328,8 @@ rte_fbarray_find_next_n_used(struct rte_fbarray *arr, unsigned int start,
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_contig_free(struct rte_fbarray *arr,
unsigned int start);
@@ -333,7 +347,8 @@ rte_fbarray_find_contig_free(struct rte_fbarray *arr,
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_contig_used(struct rte_fbarray *arr, unsigned int start);
/**
@@ -349,7 +364,8 @@ rte_fbarray_find_contig_used(struct rte_fbarray *arr, unsigned int start);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_prev_free(struct rte_fbarray *arr, unsigned int start);
@@ -366,7 +382,8 @@ rte_fbarray_find_prev_free(struct rte_fbarray *arr, unsigned int start);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_prev_used(struct rte_fbarray *arr, unsigned int start);
@@ -387,7 +404,8 @@ rte_fbarray_find_prev_used(struct rte_fbarray *arr, unsigned int start);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_prev_n_free(struct rte_fbarray *arr, unsigned int start,
unsigned int n);
@@ -409,7 +427,8 @@ rte_fbarray_find_prev_n_free(struct rte_fbarray *arr, unsigned int start,
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_prev_n_used(struct rte_fbarray *arr, unsigned int start,
unsigned int n);
@@ -428,7 +447,8 @@ rte_fbarray_find_prev_n_used(struct rte_fbarray *arr, unsigned int start,
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_rev_contig_free(struct rte_fbarray *arr,
unsigned int start);
@@ -447,7 +467,8 @@ rte_fbarray_find_rev_contig_free(struct rte_fbarray *arr,
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_rev_contig_used(struct rte_fbarray *arr, unsigned int start);
@@ -464,7 +485,8 @@ rte_fbarray_find_rev_contig_used(struct rte_fbarray *arr, unsigned int start);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_biggest_free(struct rte_fbarray *arr, unsigned int start);
@@ -481,7 +503,8 @@ rte_fbarray_find_biggest_free(struct rte_fbarray *arr, unsigned int start);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_biggest_used(struct rte_fbarray *arr, unsigned int start);
@@ -499,7 +522,8 @@ rte_fbarray_find_biggest_used(struct rte_fbarray *arr, unsigned int start);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_rev_biggest_free(struct rte_fbarray *arr, unsigned int start);
@@ -517,7 +541,8 @@ rte_fbarray_find_rev_biggest_free(struct rte_fbarray *arr, unsigned int start);
* - non-negative integer on success.
* - -1 on failure, with ``rte_errno`` indicating reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_fbarray_find_rev_biggest_used(struct rte_fbarray *arr, unsigned int start);
@@ -530,7 +555,8 @@ rte_fbarray_find_rev_biggest_used(struct rte_fbarray *arr, unsigned int start);
* @param f
* File object to dump information into.
*/
-__rte_experimental void
+__rte_experimental
+void
rte_fbarray_dump_metadata(struct rte_fbarray *arr, FILE *f);
#ifdef __cplusplus
diff --git a/lib/librte_eal/common/include/rte_interrupts.h b/lib/librte_eal/common/include/rte_interrupts.h
index 109e5a3f8..d1a78ef20 100644
--- a/lib/librte_eal/common/include/rte_interrupts.h
+++ b/lib/librte_eal/common/include/rte_interrupts.h
@@ -88,7 +88,8 @@ int rte_intr_callback_unregister(const struct rte_intr_handle *intr_handle,
* - On success, return the number of callback entities marked for remove.
* - On failure, a negative value.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_intr_callback_unregister_pending(const struct rte_intr_handle *intr_handle,
rte_intr_callback_fn cb_fn, void *cb_arg,
rte_intr_unregister_callback_fn ucb_fn);
diff --git a/lib/librte_eal/common/include/rte_lcore.h b/lib/librte_eal/common/include/rte_lcore.h
index 1e3c8877d..411df30d5 100644
--- a/lib/librte_eal/common/include/rte_lcore.h
+++ b/lib/librte_eal/common/include/rte_lcore.h
@@ -183,7 +183,8 @@ rte_lcore_to_socket_id(unsigned int lcore_id);
* @return
* The relative index, or -1 if not enabled.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_lcore_to_cpu_id(int lcore_id);
/**
@@ -196,7 +197,8 @@ rte_lcore_to_cpu_id(int lcore_id);
* @return
* The cpuset of that lcore
*/
-__rte_experimental rte_cpuset_t
+__rte_experimental
+rte_cpuset_t
rte_lcore_cpuset(unsigned int lcore_id);
/**
diff --git a/lib/librte_eal/common/include/rte_malloc.h b/lib/librte_eal/common/include/rte_malloc.h
index 429f7f827..3d4fad40e 100644
--- a/lib/librte_eal/common/include/rte_malloc.h
+++ b/lib/librte_eal/common/include/rte_malloc.h
@@ -153,7 +153,8 @@ rte_realloc(void *ptr, size_t size, unsigned int align);
* align is not a power of two).
* - Otherwise, the pointer to the reallocated memory.
*/
-__rte_experimental void *
+__rte_experimental
+void *
rte_realloc_socket(void *ptr, size_t size, unsigned int align, int socket);
/**
@@ -330,7 +331,8 @@ rte_malloc_get_socket_stats(int socket,
* EPERM - attempted to add memory to a reserved heap
* ENOSPC - no more space in internal config to store a new memory chunk
*/
-__rte_experimental int
+__rte_experimental
+int
rte_malloc_heap_memory_add(const char *heap_name, void *va_addr, size_t len,
rte_iova_t iova_addrs[], unsigned int n_pages, size_t page_sz);
@@ -361,7 +363,8 @@ rte_malloc_heap_memory_add(const char *heap_name, void *va_addr, size_t len,
* ENOENT - heap or memory chunk was not found
* EBUSY - memory chunk still contains data
*/
-__rte_experimental int
+__rte_experimental
+int
rte_malloc_heap_memory_remove(const char *heap_name, void *va_addr, size_t len);
/**
@@ -385,7 +388,8 @@ rte_malloc_heap_memory_remove(const char *heap_name, void *va_addr, size_t len);
* EPERM - attempted to attach memory to a reserved heap
* ENOENT - heap or memory chunk was not found
*/
-__rte_experimental int
+__rte_experimental
+int
rte_malloc_heap_memory_attach(const char *heap_name, void *va_addr, size_t len);
/**
@@ -409,7 +413,8 @@ rte_malloc_heap_memory_attach(const char *heap_name, void *va_addr, size_t len);
* EPERM - attempted to detach memory from a reserved heap
* ENOENT - heap or memory chunk was not found
*/
-__rte_experimental int
+__rte_experimental
+int
rte_malloc_heap_memory_detach(const char *heap_name, void *va_addr, size_t len);
/**
@@ -428,7 +433,8 @@ rte_malloc_heap_memory_detach(const char *heap_name, void *va_addr, size_t len);
* EEXIST - heap by name of ``heap_name`` already exists
* ENOSPC - no more space in internal config to store a new heap
*/
-__rte_experimental int
+__rte_experimental
+int
rte_malloc_heap_create(const char *heap_name);
/**
@@ -451,7 +457,8 @@ rte_malloc_heap_create(const char *heap_name);
* EPERM - attempting to destroy reserved heap
* EBUSY - heap still contains data
*/
-__rte_experimental int
+__rte_experimental
+int
rte_malloc_heap_destroy(const char *heap_name);
/**
@@ -465,7 +472,8 @@ rte_malloc_heap_destroy(const char *heap_name);
* EINVAL - ``name`` was NULL
* ENOENT - heap identified by the name ``name`` was not found
*/
-__rte_experimental int
+__rte_experimental
+int
rte_malloc_heap_get_socket(const char *name);
/**
@@ -480,7 +488,8 @@ rte_malloc_heap_get_socket(const char *name);
* 0 if socket ID refers to internal DPDK memory
* -1 if socket ID is invalid
*/
-__rte_experimental int
+__rte_experimental
+int
rte_malloc_heap_socket_is_external(int socket_id);
/**
@@ -510,7 +519,8 @@ rte_malloc_dump_stats(FILE *f, const char *type);
* @param f
* A pointer to a file for output
*/
-__rte_experimental void
+__rte_experimental
+void
rte_malloc_dump_heaps(FILE *f);
/**
diff --git a/lib/librte_eal/common/include/rte_memory.h b/lib/librte_eal/common/include/rte_memory.h
index 3f159f83d..44cbe6fd2 100644
--- a/lib/librte_eal/common/include/rte_memory.h
+++ b/lib/librte_eal/common/include/rte_memory.h
@@ -148,7 +148,8 @@ rte_iova_t rte_mem_virt2iova(const void *virt);
* Virtual address corresponding to iova address (or NULL if address does not
* exist within DPDK memory map).
*/
-__rte_experimental void *
+__rte_experimental
+void *
rte_mem_iova2virt(rte_iova_t iova);
/**
@@ -162,7 +163,8 @@ rte_mem_iova2virt(rte_iova_t iova);
* @return
* Memseg pointer on success, or NULL on error.
*/
-__rte_experimental struct rte_memseg *
+__rte_experimental
+struct rte_memseg *
rte_mem_virt2memseg(const void *virt, const struct rte_memseg_list *msl);
/**
@@ -173,7 +175,8 @@ rte_mem_virt2memseg(const void *virt, const struct rte_memseg_list *msl);
* @return
* Memseg list to which this virtual address belongs to.
*/
-__rte_experimental struct rte_memseg_list *
+__rte_experimental
+struct rte_memseg_list *
rte_mem_virt2memseg_list(const void *virt);
/**
@@ -227,7 +230,8 @@ typedef int (*rte_memseg_list_walk_t)(const struct rte_memseg_list *msl,
* 1 if stopped by the user
* -1 if user function reported error
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_walk(rte_memseg_walk_t func, void *arg);
/**
@@ -248,7 +252,8 @@ rte_memseg_walk(rte_memseg_walk_t func, void *arg);
* 1 if stopped by the user
* -1 if user function reported error
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_contig_walk(rte_memseg_contig_walk_t func, void *arg);
/**
@@ -269,7 +274,8 @@ rte_memseg_contig_walk(rte_memseg_contig_walk_t func, void *arg);
* 1 if stopped by the user
* -1 if user function reported error
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_list_walk(rte_memseg_list_walk_t func, void *arg);
/**
@@ -287,7 +293,8 @@ rte_memseg_list_walk(rte_memseg_list_walk_t func, void *arg);
* 1 if stopped by the user
* -1 if user function reported error
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_walk_thread_unsafe(rte_memseg_walk_t func, void *arg);
/**
@@ -305,7 +312,8 @@ rte_memseg_walk_thread_unsafe(rte_memseg_walk_t func, void *arg);
* 1 if stopped by the user
* -1 if user function reported error
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_contig_walk_thread_unsafe(rte_memseg_contig_walk_t func, void *arg);
/**
@@ -323,7 +331,8 @@ rte_memseg_contig_walk_thread_unsafe(rte_memseg_contig_walk_t func, void *arg);
* 1 if stopped by the user
* -1 if user function reported error
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_list_walk_thread_unsafe(rte_memseg_list_walk_t func, void *arg);
/**
@@ -347,7 +356,8 @@ rte_memseg_list_walk_thread_unsafe(rte_memseg_list_walk_t func, void *arg);
* - ENOENT - ``ms`` is an unused segment
* - ENOTSUP - segment fd's are not supported
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_get_fd(const struct rte_memseg *ms);
/**
@@ -371,7 +381,8 @@ rte_memseg_get_fd(const struct rte_memseg *ms);
* - ENOENT - ``ms`` is an unused segment
* - ENOTSUP - segment fd's are not supported
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_get_fd_thread_unsafe(const struct rte_memseg *ms);
/**
@@ -395,7 +406,8 @@ rte_memseg_get_fd_thread_unsafe(const struct rte_memseg *ms);
* - ENOENT - ``ms`` is an unused segment
* - ENOTSUP - segment fd's are not supported
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_get_fd_offset(const struct rte_memseg *ms, size_t *offset);
/**
@@ -419,7 +431,8 @@ rte_memseg_get_fd_offset(const struct rte_memseg *ms, size_t *offset);
* - ENOENT - ``ms`` is an unused segment
* - ENOTSUP - segment fd's are not supported
*/
-__rte_experimental int
+__rte_experimental
+int
rte_memseg_get_fd_offset_thread_unsafe(const struct rte_memseg *ms,
size_t *offset);
@@ -460,7 +473,8 @@ rte_memseg_get_fd_offset_thread_unsafe(const struct rte_memseg *ms,
* EEXIST - memory chunk is already registered
* ENOSPC - no more space in internal config to store a new memory chunk
*/
-__rte_experimental int
+__rte_experimental
+int
rte_extmem_register(void *va_addr, size_t len, rte_iova_t iova_addrs[],
unsigned int n_pages, size_t page_sz);
@@ -490,7 +504,8 @@ rte_extmem_register(void *va_addr, size_t len, rte_iova_t iova_addrs[],
* EINVAL - one of the parameters was invalid
* ENOENT - memory chunk was not found
*/
-__rte_experimental int
+__rte_experimental
+int
rte_extmem_unregister(void *va_addr, size_t len);
/**
@@ -516,7 +531,8 @@ rte_extmem_unregister(void *va_addr, size_t len);
* EINVAL - one of the parameters was invalid
* ENOENT - memory chunk was not found
*/
-__rte_experimental int
+__rte_experimental
+int
rte_extmem_attach(void *va_addr, size_t len);
/**
@@ -542,7 +558,8 @@ rte_extmem_attach(void *va_addr, size_t len);
* EINVAL - one of the parameters was invalid
* ENOENT - memory chunk was not found
*/
-__rte_experimental int
+__rte_experimental
+int
rte_extmem_detach(void *va_addr, size_t len);
/**
@@ -595,7 +612,8 @@ unsigned rte_memory_get_nrank(void);
* @param maskbits
* Address width to check against.
*/
-__rte_experimental int rte_mem_check_dma_mask(uint8_t maskbits);
+__rte_experimental
+int rte_mem_check_dma_mask(uint8_t maskbits);
/**
* @warning
@@ -613,7 +631,8 @@ __rte_experimental int rte_mem_check_dma_mask(uint8_t maskbits);
* @param maskbits
* Address width to check against.
*/
-__rte_experimental int rte_mem_check_dma_mask_thread_unsafe(uint8_t maskbits);
+__rte_experimental
+int rte_mem_check_dma_mask_thread_unsafe(uint8_t maskbits);
/**
* @warning
@@ -623,7 +642,8 @@ __rte_experimental int rte_mem_check_dma_mask_thread_unsafe(uint8_t maskbits);
* rte_mem_check_dma_mask and rte_mem_check_dma_mask_thread_unsafe can not be
* used safely until memory has been initialized.
*/
-__rte_experimental void rte_mem_set_dma_mask(uint8_t maskbits);
+__rte_experimental
+void rte_mem_set_dma_mask(uint8_t maskbits);
/**
* Drivers based on uio will not load unless physical
@@ -679,7 +699,8 @@ typedef void (*rte_mem_event_callback_t)(enum rte_mem_event event_type,
* -1 on unsuccessful callback register, with rte_errno value indicating
* reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mem_event_callback_register(const char *name, rte_mem_event_callback_t clb,
void *arg);
@@ -697,7 +718,8 @@ rte_mem_event_callback_register(const char *name, rte_mem_event_callback_t clb,
* -1 on unsuccessful callback unregister, with rte_errno value indicating
* reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mem_event_callback_unregister(const char *name, void *arg);
@@ -746,7 +768,8 @@ typedef int (*rte_mem_alloc_validator_t)(int socket_id,
* -1 on unsuccessful callback register, with rte_errno value indicating
* reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mem_alloc_validator_register(const char *name,
rte_mem_alloc_validator_t clb, int socket_id, size_t limit);
@@ -764,7 +787,8 @@ rte_mem_alloc_validator_register(const char *name,
* -1 on unsuccessful callback unregister, with rte_errno value indicating
* reason for failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mem_alloc_validator_unregister(const char *name, int socket_id);
#ifdef __cplusplus
diff --git a/lib/librte_eal/common/include/rte_random.h b/lib/librte_eal/common/include/rte_random.h
index 939e6aaa9..2b30ec85c 100644
--- a/lib/librte_eal/common/include/rte_random.h
+++ b/lib/librte_eal/common/include/rte_random.h
@@ -62,7 +62,8 @@ rte_rand(void);
* @return
* A pseudo-random value between 0 and (upper_bound-1).
*/
-uint64_t __rte_experimental
+__rte_experimental
+uint64_t
rte_rand_max(uint64_t upper_bound);
#ifdef __cplusplus
diff --git a/lib/librte_eal/common/include/rte_service.h b/lib/librte_eal/common/include/rte_service.h
index e54ec50b2..8b4de551e 100644
--- a/lib/librte_eal/common/include/rte_service.h
+++ b/lib/librte_eal/common/include/rte_service.h
@@ -178,7 +178,8 @@ int32_t rte_service_runstate_get(uint32_t id);
* @retval 0 Service is not running on any lcore
* @retval -EINVAL Invalid service id
*/
-__rte_experimental int32_t
+__rte_experimental
+int32_t
rte_service_may_be_active(uint32_t id);
/**
@@ -401,7 +402,8 @@ int32_t rte_service_attr_reset_all(uint32_t id);
* -EINVAL Invalid lcore, attr_id or attr_value was NULL.
* -ENOTSUP lcore is not a service core.
*/
-__rte_experimental int32_t
+__rte_experimental
+int32_t
rte_service_lcore_attr_get(uint32_t lcore, uint32_t attr_id,
uint64_t *attr_value);
@@ -416,7 +418,8 @@ rte_service_lcore_attr_get(uint32_t lcore, uint32_t attr_id,
* -EINVAL Invalid service id provided
* -ENOTSUP lcore is not a service core.
*/
-__rte_experimental int32_t
+__rte_experimental
+int32_t
rte_service_lcore_attr_reset_all(uint32_t lcore);
#ifdef __cplusplus
diff --git a/lib/librte_ethdev/rte_ethdev.h b/lib/librte_ethdev/rte_ethdev.h
index 2a0c0b208..c85212649 100644
--- a/lib/librte_ethdev/rte_ethdev.h
+++ b/lib/librte_ethdev/rte_ethdev.h
@@ -1453,7 +1453,8 @@ uint16_t rte_eth_find_next(uint16_t port_id);
* Next port id of the device, possibly port_id_start,
* RTE_MAX_ETHPORTS if there is none.
*/
-__rte_experimental uint16_t
+__rte_experimental
+uint16_t
rte_eth_find_next_of(uint16_t port_id_start,
const struct rte_device *parent);
@@ -1484,7 +1485,8 @@ rte_eth_find_next_of(uint16_t port_id_start,
* Next sibling port id, possibly port_id_start or ref_port_id itself,
* RTE_MAX_ETHPORTS if there is none.
*/
-__rte_experimental uint16_t
+__rte_experimental
+uint16_t
rte_eth_find_next_sibling(uint16_t port_id_start,
uint16_t ref_port_id);
@@ -1516,7 +1518,8 @@ rte_eth_find_next_sibling(uint16_t port_id_start,
* @return
* Negative errno value on error, 0 on success.
*/
-__rte_experimental int rte_eth_dev_owner_new(uint64_t *owner_id);
+__rte_experimental
+int rte_eth_dev_owner_new(uint64_t *owner_id);
/**
* @warning
@@ -1531,7 +1534,8 @@ __rte_experimental int rte_eth_dev_owner_new(uint64_t *owner_id);
* @return
* Negative errno value on error, 0 on success.
*/
-__rte_experimental int rte_eth_dev_owner_set(const uint16_t port_id,
+__rte_experimental
+int rte_eth_dev_owner_set(const uint16_t port_id,
const struct rte_eth_dev_owner *owner);
/**
@@ -1547,7 +1551,8 @@ __rte_experimental int rte_eth_dev_owner_set(const uint16_t port_id,
* @return
* 0 on success, negative errno value on error.
*/
-__rte_experimental int rte_eth_dev_owner_unset(const uint16_t port_id,
+__rte_experimental
+int rte_eth_dev_owner_unset(const uint16_t port_id,
const uint64_t owner_id);
/**
@@ -1559,7 +1564,8 @@ __rte_experimental int rte_eth_dev_owner_unset(const uint16_t port_id,
* @param owner_id
* The owner identifier.
*/
-__rte_experimental void rte_eth_dev_owner_delete(const uint64_t owner_id);
+__rte_experimental
+void rte_eth_dev_owner_delete(const uint64_t owner_id);
/**
* @warning
@@ -1574,7 +1580,8 @@ __rte_experimental void rte_eth_dev_owner_delete(const uint64_t owner_id);
* @return
* 0 on success, negative errno value on error..
*/
-__rte_experimental int rte_eth_dev_owner_get(const uint16_t port_id,
+__rte_experimental
+int rte_eth_dev_owner_get(const uint16_t port_id,
struct rte_eth_dev_owner *owner);
/**
@@ -1700,7 +1707,8 @@ int rte_eth_dev_configure(uint16_t port_id, uint16_t nb_rx_queue,
* @return
* 1 when the Ethernet device is removed, otherwise 0.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_dev_is_removed(uint16_t port_id);
/**
@@ -2928,7 +2936,8 @@ int rte_eth_dev_rx_intr_ctl_q(uint16_t port_id, uint16_t queue_id,
* successful.
* - (-1) on error.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_dev_rx_intr_ctl_q_get_fd(uint16_t port_id, uint16_t queue_id);
/**
@@ -3626,7 +3635,8 @@ int rte_eth_dev_set_eeprom(uint16_t port_id, struct rte_dev_eeprom_info *info);
* - (-EIO) if device is removed.
* - others depends on the specific operations implementation.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_dev_get_module_info(uint16_t port_id,
struct rte_eth_dev_module_info *modinfo);
@@ -3648,7 +3658,8 @@ rte_eth_dev_get_module_info(uint16_t port_id,
* - (-EIO) if device is removed.
* - others depends on the specific operations implementation.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_dev_get_module_eeprom(uint16_t port_id,
struct rte_dev_eeprom_info *info);
@@ -3840,7 +3851,8 @@ int rte_eth_timesync_write_time(uint16_t port_id, const struct timespec *time);
* - -ENODEV: The port ID is invalid.
* - -ENOTSUP: The function is not supported by the Ethernet driver.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_read_clock(uint16_t port_id, uint64_t *clock);
/**
diff --git a/lib/librte_ethdev/rte_ethdev_driver.h b/lib/librte_ethdev/rte_ethdev_driver.h
index 217a02bc7..936ff8c98 100644
--- a/lib/librte_ethdev/rte_ethdev_driver.h
+++ b/lib/librte_ethdev/rte_ethdev_driver.h
@@ -225,7 +225,8 @@ rte_eth_linkstatus_get(const struct rte_eth_dev *dev,
* @return
* Negative errno value on error, 0 on success.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_switch_domain_alloc(uint16_t *domain_id);
/**
@@ -243,7 +244,8 @@ rte_eth_switch_domain_alloc(uint16_t *domain_id);
* @return
* Negative errno value on error, 0 on success.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_switch_domain_free(uint16_t domain_id);
/** Generic Ethernet device arguments */
@@ -272,7 +274,8 @@ struct rte_eth_devargs {
* @return
* Negative errno value on error, 0 on success.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_devargs_parse(const char *devargs, struct rte_eth_devargs *eth_devargs);
@@ -304,7 +307,8 @@ typedef int (*ethdev_bus_specific_init)(struct rte_eth_dev *ethdev,
* @return
* Negative errno value on error, 0 on success.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_dev_create(struct rte_device *device, const char *name,
size_t priv_data_size,
ethdev_bus_specific_init bus_specific_init, void *bus_init_params,
@@ -328,7 +332,8 @@ typedef int (*ethdev_uninit_t)(struct rte_eth_dev *ethdev);
* @return
* Negative errno value on error, 0 on success.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_eth_dev_destroy(struct rte_eth_dev *ethdev, ethdev_uninit_t ethdev_uninit);
#ifdef __cplusplus
diff --git a/lib/librte_ethdev/rte_flow_driver.h b/lib/librte_ethdev/rte_flow_driver.h
index e41b81584..a0359853e 100644
--- a/lib/librte_ethdev/rte_flow_driver.h
+++ b/lib/librte_ethdev/rte_flow_driver.h
@@ -171,7 +171,8 @@ struct rte_flow_expand_rss {
*
* -E2BIG: graph-depth @p graph is too deep.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_flow_expand_rss(struct rte_flow_expand_rss *buf, size_t size,
const struct rte_flow_item *pattern, uint64_t types,
const struct rte_flow_expand_node graph[],
diff --git a/lib/librte_ethdev/rte_mtr.h b/lib/librte_ethdev/rte_mtr.h
index 49be06b55..6ba7d18ae 100644
--- a/lib/librte_ethdev/rte_mtr.h
+++ b/lib/librte_ethdev/rte_mtr.h
@@ -438,7 +438,8 @@ struct rte_mtr_error {
* @return
* 0 on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_capabilities_get(uint16_t port_id,
struct rte_mtr_capabilities *cap,
struct rte_mtr_error *error);
@@ -461,7 +462,8 @@ rte_mtr_capabilities_get(uint16_t port_id,
* @return
* 0 on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_meter_profile_add(uint16_t port_id,
uint32_t meter_profile_id,
struct rte_mtr_meter_profile *profile,
@@ -482,7 +484,8 @@ rte_mtr_meter_profile_add(uint16_t port_id,
* @return
* 0 on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_meter_profile_delete(uint16_t port_id,
uint32_t meter_profile_id,
struct rte_mtr_error *error);
@@ -510,7 +513,8 @@ rte_mtr_meter_profile_delete(uint16_t port_id,
*
* @see enum rte_flow_action_type::RTE_FLOW_ACTION_TYPE_METER
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_create(uint16_t port_id,
uint32_t mtr_id,
struct rte_mtr_params *params,
@@ -533,7 +537,8 @@ rte_mtr_create(uint16_t port_id,
* @return
* 0 on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_destroy(uint16_t port_id,
uint32_t mtr_id,
struct rte_mtr_error *error);
@@ -560,7 +565,8 @@ rte_mtr_destroy(uint16_t port_id,
* @return
* 0 on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_meter_disable(uint16_t port_id,
uint32_t mtr_id,
struct rte_mtr_error *error);
@@ -581,7 +587,8 @@ rte_mtr_meter_disable(uint16_t port_id,
* @return
* 0 on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_meter_enable(uint16_t port_id,
uint32_t mtr_id,
struct rte_mtr_error *error);
@@ -600,7 +607,8 @@ rte_mtr_meter_enable(uint16_t port_id,
* @return
* 0 on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_meter_profile_update(uint16_t port_id,
uint32_t mtr_id,
uint32_t meter_profile_id,
@@ -624,7 +632,8 @@ rte_mtr_meter_profile_update(uint16_t port_id,
* @return
* 0 on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_meter_dscp_table_update(uint16_t port_id,
uint32_t mtr_id,
enum rte_color *dscp_table,
@@ -650,7 +659,8 @@ rte_mtr_meter_dscp_table_update(uint16_t port_id,
* @return
* 0 on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_policer_actions_update(uint16_t port_id,
uint32_t mtr_id,
uint32_t action_mask,
@@ -675,7 +685,8 @@ rte_mtr_policer_actions_update(uint16_t port_id,
*
* @see enum rte_mtr_stats_type
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_stats_update(uint16_t port_id,
uint32_t mtr_id,
uint64_t stats_mask,
@@ -706,7 +717,8 @@ rte_mtr_stats_update(uint16_t port_id,
*
* @see enum rte_mtr_stats_type
*/
-__rte_experimental int
+__rte_experimental
+int
rte_mtr_stats_read(uint16_t port_id,
uint32_t mtr_id,
struct rte_mtr_stats *stats,
diff --git a/lib/librte_eventdev/rte_event_eth_rx_adapter.h b/lib/librte_eventdev/rte_event_eth_rx_adapter.h
index 0423c082e..d1a11a181 100644
--- a/lib/librte_eventdev/rte_event_eth_rx_adapter.h
+++ b/lib/librte_eventdev/rte_event_eth_rx_adapter.h
@@ -413,7 +413,8 @@ int rte_event_eth_rx_adapter_stop(uint8_t id);
* - 0: Success, retrieved successfully.
* - <0: Error code on failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_event_eth_rx_adapter_stats_get(uint8_t id,
struct rte_event_eth_rx_adapter_stats *stats);
@@ -466,7 +467,8 @@ int rte_event_eth_rx_adapter_service_id_get(uint8_t id, uint32_t *service_id);
* - 0: Success
* - <0: Error code on failure.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_event_eth_rx_adapter_cb_register(uint8_t id,
uint16_t eth_dev_id,
rte_event_eth_rx_adapter_cb_fn cb_fn,
diff --git a/lib/librte_flow_classify/rte_flow_classify.h b/lib/librte_flow_classify/rte_flow_classify.h
index eefadfc10..74d1ecaf5 100644
--- a/lib/librte_flow_classify/rte_flow_classify.h
+++ b/lib/librte_flow_classify/rte_flow_classify.h
@@ -155,7 +155,8 @@ struct rte_flow_classify_ipv4_5tuple_stats {
* @return
* Handle to flow classifier instance on success or NULL otherwise
*/
-__rte_experimental struct rte_flow_classifier *
+__rte_experimental
+struct rte_flow_classifier *
rte_flow_classifier_create(struct rte_flow_classifier_params *params);
/**
@@ -166,7 +167,8 @@ rte_flow_classifier_create(struct rte_flow_classifier_params *params);
* @return
* 0 on success, error code otherwise
*/
-__rte_experimental int
+__rte_experimental
+int
rte_flow_classifier_free(struct rte_flow_classifier *cls);
/**
@@ -179,7 +181,8 @@ rte_flow_classifier_free(struct rte_flow_classifier *cls);
* @return
* 0 on success, error code otherwise
*/
-__rte_experimental int
+__rte_experimental
+int
rte_flow_classify_table_create(struct rte_flow_classifier *cls,
struct rte_flow_classify_table_params *params);
@@ -200,7 +203,8 @@ rte_flow_classify_table_create(struct rte_flow_classifier *cls,
* @return
* 0 on success, error code otherwise
*/
-__rte_experimental int
+__rte_experimental
+int
rte_flow_classify_validate(struct rte_flow_classifier *cls,
const struct rte_flow_attr *attr,
const struct rte_flow_item pattern[],
@@ -226,7 +230,8 @@ rte_flow_classify_validate(struct rte_flow_classifier *cls,
* @return
* A valid handle in case of success, NULL otherwise.
*/
-__rte_experimental struct rte_flow_classify_rule *
+__rte_experimental
+struct rte_flow_classify_rule *
rte_flow_classify_table_entry_add(struct rte_flow_classifier *cls,
const struct rte_flow_attr *attr,
const struct rte_flow_item pattern[],
@@ -244,7 +249,8 @@ rte_flow_classify_table_entry_add(struct rte_flow_classifier *cls,
* @return
* 0 on success, error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_flow_classify_table_entry_delete(struct rte_flow_classifier *cls,
struct rte_flow_classify_rule *rule);
@@ -265,7 +271,8 @@ rte_flow_classify_table_entry_delete(struct rte_flow_classifier *cls,
* @return
* 0 on success, error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_flow_classifier_query(struct rte_flow_classifier *cls,
struct rte_mbuf **pkts,
const uint16_t nb_pkts,
diff --git a/lib/librte_hash/rte_hash.h b/lib/librte_hash/rte_hash.h
index 20ca9905f..0d73370dc 100644
--- a/lib/librte_hash/rte_hash.h
+++ b/lib/librte_hash/rte_hash.h
@@ -366,7 +366,8 @@ 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_experimental
+int
rte_hash_free_key_with_position(const struct rte_hash *h,
const int32_t position);
diff --git a/lib/librte_ip_frag/rte_ip_frag.h b/lib/librte_ip_frag/rte_ip_frag.h
index 1c2a7e213..0c0d95f47 100644
--- a/lib/librte_ip_frag/rte_ip_frag.h
+++ b/lib/librte_ip_frag/rte_ip_frag.h
@@ -348,7 +348,8 @@ rte_ip_frag_table_statistics_dump(FILE * f, const struct rte_ip_frag_tbl *tbl);
* @param tms
* Current timestamp
*/
-__rte_experimental void
+__rte_experimental
+void
rte_frag_table_del_expired_entries(struct rte_ip_frag_tbl *tbl,
struct rte_ip_frag_death_row *dr, uint64_t tms);
diff --git a/lib/librte_ipsec/rte_ipsec.h b/lib/librte_ipsec/rte_ipsec.h
index b7dfc37d1..f3b1f936b 100644
--- a/lib/librte_ipsec/rte_ipsec.h
+++ b/lib/librte_ipsec/rte_ipsec.h
@@ -84,7 +84,8 @@ struct rte_ipsec_session {
* - Zero if operation completed successfully.
* - -EINVAL if the parameters are invalid.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_ipsec_session_prepare(struct rte_ipsec_session *ss);
/**
@@ -108,7 +109,8 @@ rte_ipsec_session_prepare(struct rte_ipsec_session *ss);
* @return
* Number of successfully processed packets, with error code set in rte_errno.
*/
-__rte_experimental static inline uint16_t
+__rte_experimental
+static inline uint16_t
rte_ipsec_pkt_crypto_prepare(const struct rte_ipsec_session *ss,
struct rte_mbuf *mb[], struct rte_crypto_op *cop[], uint16_t num)
{
@@ -138,7 +140,8 @@ rte_ipsec_pkt_crypto_prepare(const struct rte_ipsec_session *ss,
* @return
* Number of successfully processed packets, with error code set in rte_errno.
*/
-__rte_experimental static inline uint16_t
+__rte_experimental
+static inline uint16_t
rte_ipsec_pkt_process(const struct rte_ipsec_session *ss, struct rte_mbuf *mb[],
uint16_t num)
{
diff --git a/lib/librte_ipsec/rte_ipsec_group.h b/lib/librte_ipsec/rte_ipsec_group.h
index 1de96d466..47b33ca5e 100644
--- a/lib/librte_ipsec/rte_ipsec_group.h
+++ b/lib/librte_ipsec/rte_ipsec_group.h
@@ -42,7 +42,8 @@ struct rte_ipsec_group {
* @return
* The pointer to the related *rte_ipsec_session* structure.
*/
-__rte_experimental static inline struct rte_ipsec_session *
+__rte_experimental
+static inline struct rte_ipsec_session *
rte_ipsec_ses_from_crypto(const struct rte_crypto_op *cop)
{
const struct rte_security_session *ss;
@@ -78,7 +79,8 @@ rte_ipsec_ses_from_crypto(const struct rte_crypto_op *cop)
* @return
* Number of filled elements in *grp* array.
*/
-__rte_experimental static inline uint16_t
+__rte_experimental
+static inline uint16_t
rte_ipsec_pkt_crypto_group(const struct rte_crypto_op *cop[],
struct rte_mbuf *mb[], struct rte_ipsec_group grp[], uint16_t num)
{
diff --git a/lib/librte_ipsec/rte_ipsec_sa.h b/lib/librte_ipsec/rte_ipsec_sa.h
index 50707015e..b3f9b1080 100644
--- a/lib/librte_ipsec/rte_ipsec_sa.h
+++ b/lib/librte_ipsec/rte_ipsec_sa.h
@@ -128,7 +128,8 @@ enum {
* @return
* SA type value.
*/
-__rte_experimental uint64_t
+__rte_experimental
+uint64_t
rte_ipsec_sa_type(const struct rte_ipsec_sa *sa);
/**
@@ -139,7 +140,8 @@ rte_ipsec_sa_type(const struct rte_ipsec_sa *sa);
* - Actual size required for SA with given parameters.
* - -EINVAL if the parameters are invalid.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_ipsec_sa_size(const struct rte_ipsec_sa_prm *prm);
/**
@@ -155,7 +157,8 @@ rte_ipsec_sa_size(const struct rte_ipsec_sa_prm *prm);
* - -EINVAL if the parameters are invalid.
* - -ENOSPC if the size of the provided buffer is not big enough.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_ipsec_sa_init(struct rte_ipsec_sa *sa, const struct rte_ipsec_sa_prm *prm,
uint32_t size);
@@ -164,7 +167,8 @@ rte_ipsec_sa_init(struct rte_ipsec_sa *sa, const struct rte_ipsec_sa_prm *prm,
* @param sa
* Pointer to SA object to de-initialize.
*/
-__rte_experimental void
+__rte_experimental
+void
rte_ipsec_sa_fini(struct rte_ipsec_sa *sa);
#ifdef __cplusplus
diff --git a/lib/librte_kni/rte_kni.h b/lib/librte_kni/rte_kni.h
index dda7de6ad..5699a6443 100644
--- a/lib/librte_kni/rte_kni.h
+++ b/lib/librte_kni/rte_kni.h
@@ -249,7 +249,8 @@ int rte_kni_unregister_handlers(struct rte_kni *kni);
* Previous link state == linkdown: 0
* Previous link state == linkup: 1
*/
-__rte_experimental int
+__rte_experimental
+int
rte_kni_update_link(struct rte_kni *kni, unsigned int linkup);
/**
diff --git a/lib/librte_mbuf/rte_mbuf.h b/lib/librte_mbuf/rte_mbuf.h
index 21a8870c5..b114fb0c9 100644
--- a/lib/librte_mbuf/rte_mbuf.h
+++ b/lib/librte_mbuf/rte_mbuf.h
@@ -866,7 +866,8 @@ rte_mbuf_from_indirect(struct rte_mbuf *mi)
* @return
* The pointer of the mbuf buffer.
*/
-__rte_experimental static inline char *
+__rte_experimental
+static inline char *
rte_mbuf_buf_addr(struct rte_mbuf *mb, struct rte_mempool *mp)
{
return (char *)mb + sizeof(*mb) + rte_pktmbuf_priv_size(mp);
@@ -883,7 +884,8 @@ rte_mbuf_buf_addr(struct rte_mbuf *mb, struct rte_mempool *mp)
* @return
* The pointer of the beginning of the mbuf data.
*/
-__rte_experimental static inline char *
+__rte_experimental
+static inline char *
rte_mbuf_data_addr_default(struct rte_mbuf *mb __rte_unused)
{
/* gcc complains about calling this experimental function even
@@ -933,7 +935,8 @@ rte_mbuf_to_baddr(struct rte_mbuf *md)
* @return
* The starting address of the private data area of the given mbuf.
*/
-__rte_experimental static inline void *
+__rte_experimental
+static inline void *
rte_mbuf_to_priv(struct rte_mbuf *m)
{
return RTE_PTR_ADD(m, sizeof(struct rte_mbuf));
diff --git a/lib/librte_meter/rte_meter.h b/lib/librte_meter/rte_meter.h
index 59f7b90f6..d69b11849 100644
--- a/lib/librte_meter/rte_meter.h
+++ b/lib/librte_meter/rte_meter.h
@@ -140,7 +140,8 @@ rte_meter_trtcm_profile_config(struct rte_meter_trtcm_profile *p,
* @return
* 0 upon success, error code otherwise
*/
-__rte_experimental int
+__rte_experimental
+int
rte_meter_trtcm_rfc4115_profile_config(
struct rte_meter_trtcm_rfc4115_profile *p,
struct rte_meter_trtcm_rfc4115_params *params);
@@ -186,7 +187,8 @@ rte_meter_trtcm_config(struct rte_meter_trtcm *m,
* @return
* 0 upon success, error code otherwise
*/
-__rte_experimental int
+__rte_experimental
+int
rte_meter_trtcm_rfc4115_config(struct rte_meter_trtcm_rfc4115 *m,
struct rte_meter_trtcm_rfc4115_profile *p);
@@ -293,7 +295,8 @@ rte_meter_trtcm_color_aware_check(struct rte_meter_trtcm *m,
* @return
* Color assigned to the current IP packet
*/
-__rte_experimental static inline enum rte_color
+__rte_experimental
+static inline enum rte_color
rte_meter_trtcm_rfc4115_color_blind_check(
struct rte_meter_trtcm_rfc4115 *m,
struct rte_meter_trtcm_rfc4115_profile *p,
@@ -319,7 +322,8 @@ rte_meter_trtcm_rfc4115_color_blind_check(
* @return
* Color assigned to the current IP packet
*/
-__rte_experimental static inline enum rte_color
+__rte_experimental
+static inline enum rte_color
rte_meter_trtcm_rfc4115_color_aware_check(
struct rte_meter_trtcm_rfc4115 *m,
struct rte_meter_trtcm_rfc4115_profile *p,
@@ -578,7 +582,8 @@ rte_meter_trtcm_color_aware_check(struct rte_meter_trtcm *m,
return RTE_COLOR_GREEN;
}
-__rte_experimental static inline enum rte_color
+__rte_experimental
+static inline enum rte_color
rte_meter_trtcm_rfc4115_color_blind_check(
struct rte_meter_trtcm_rfc4115 *m,
struct rte_meter_trtcm_rfc4115_profile *p,
@@ -621,7 +626,8 @@ rte_meter_trtcm_rfc4115_color_blind_check(
return RTE_COLOR_RED;
}
-__rte_experimental static inline enum rte_color
+__rte_experimental
+static inline enum rte_color
rte_meter_trtcm_rfc4115_color_aware_check(
struct rte_meter_trtcm_rfc4115 *m,
struct rte_meter_trtcm_rfc4115_profile *p,
diff --git a/lib/librte_net/rte_arp.h b/lib/librte_net/rte_arp.h
index 6db6dfa0c..ccb6875cf 100644
--- a/lib/librte_net/rte_arp.h
+++ b/lib/librte_net/rte_arp.h
@@ -63,7 +63,8 @@ struct rte_arp_hdr {
* @return
* - RARP packet pointer on success, or NULL on error
*/
-__rte_experimental struct rte_mbuf *
+__rte_experimental
+struct rte_mbuf *
rte_net_make_rarp_packet(struct rte_mempool *mpool,
const struct rte_ether_addr *mac);
diff --git a/lib/librte_net/rte_net.h b/lib/librte_net/rte_net.h
index f219621f7..b83f8c13a 100644
--- a/lib/librte_net/rte_net.h
+++ b/lib/librte_net/rte_net.h
@@ -51,7 +51,8 @@ struct rte_net_hdr_lens {
* Protocol that follows IPv6 header.
* -1 if an error occurs during mbuf parsing.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_net_skip_ip6_ext(uint16_t proto, const struct rte_mbuf *m, uint32_t *off,
int *frag);
diff --git a/lib/librte_pipeline/rte_port_in_action.h b/lib/librte_pipeline/rte_port_in_action.h
index 3e0d4a66c..d6b063cf5 100644
--- a/lib/librte_pipeline/rte_port_in_action.h
+++ b/lib/librte_pipeline/rte_port_in_action.h
@@ -172,7 +172,8 @@ struct rte_port_in_action_profile;
* @return
* Input port action profile handle on success, NULL otherwise.
*/
-__rte_experimental struct rte_port_in_action_profile *
+__rte_experimental
+struct rte_port_in_action_profile *
rte_port_in_action_profile_create(uint32_t socket_id);
/**
@@ -183,7 +184,8 @@ rte_port_in_action_profile_create(uint32_t socket_id);
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_port_in_action_profile_free(struct rte_port_in_action_profile *profile);
/**
@@ -201,7 +203,8 @@ rte_port_in_action_profile_free(struct rte_port_in_action_profile *profile);
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_port_in_action_profile_action_register(
struct rte_port_in_action_profile *profile,
enum rte_port_in_action_type type,
@@ -223,7 +226,8 @@ rte_port_in_action_profile_action_register(
*
* @see rte_port_in_action_create()
*/
-__rte_experimental int
+__rte_experimental
+int
rte_port_in_action_profile_freeze(struct rte_port_in_action_profile *profile);
/**
@@ -245,7 +249,8 @@ struct rte_port_in_action;
* @return
* Handle to input port action object on success, NULL on error.
*/
-__rte_experimental struct rte_port_in_action *
+__rte_experimental
+struct rte_port_in_action *
rte_port_in_action_create(struct rte_port_in_action_profile *profile,
uint32_t socket_id);
@@ -257,7 +262,8 @@ rte_port_in_action_create(struct rte_port_in_action_profile *profile,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_port_in_action_free(struct rte_port_in_action *action);
/**
@@ -270,7 +276,8 @@ rte_port_in_action_free(struct rte_port_in_action *action);
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_port_in_action_params_get(struct rte_port_in_action *action,
struct rte_pipeline_port_in_params *params);
@@ -289,7 +296,8 @@ rte_port_in_action_params_get(struct rte_port_in_action *action,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_port_in_action_apply(struct rte_port_in_action *action,
enum rte_port_in_action_type type,
void *action_params);
diff --git a/lib/librte_pipeline/rte_table_action.h b/lib/librte_pipeline/rte_table_action.h
index da4ec4274..44041b5c9 100644
--- a/lib/librte_pipeline/rte_table_action.h
+++ b/lib/librte_pipeline/rte_table_action.h
@@ -823,7 +823,8 @@ struct rte_table_action_profile;
* @return
* Table action profile handle on success, NULL otherwise.
*/
-__rte_experimental struct rte_table_action_profile *
+__rte_experimental
+struct rte_table_action_profile *
rte_table_action_profile_create(struct rte_table_action_common_config *common);
/**
@@ -834,7 +835,8 @@ rte_table_action_profile_create(struct rte_table_action_common_config *common);
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_profile_free(struct rte_table_action_profile *profile);
/**
@@ -852,7 +854,8 @@ rte_table_action_profile_free(struct rte_table_action_profile *profile);
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_profile_action_register(struct rte_table_action_profile *profile,
enum rte_table_action_type type,
void *action_config);
@@ -872,7 +875,8 @@ rte_table_action_profile_action_register(struct rte_table_action_profile *profil
*
* @see rte_table_action_create()
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_profile_freeze(struct rte_table_action_profile *profile);
/**
@@ -895,7 +899,8 @@ struct rte_table_action;
*
* @see rte_table_action_create()
*/
-__rte_experimental struct rte_table_action *
+__rte_experimental
+struct rte_table_action *
rte_table_action_create(struct rte_table_action_profile *profile,
uint32_t socket_id);
@@ -907,7 +912,8 @@ rte_table_action_create(struct rte_table_action_profile *profile,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_free(struct rte_table_action *action);
/**
@@ -920,7 +926,8 @@ rte_table_action_free(struct rte_table_action *action);
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_table_params_get(struct rte_table_action *action,
struct rte_pipeline_table_params *params);
@@ -942,7 +949,8 @@ rte_table_action_table_params_get(struct rte_table_action *action,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_apply(struct rte_table_action *action,
void *data,
enum rte_table_action_type type,
@@ -961,7 +969,8 @@ rte_table_action_apply(struct rte_table_action *action,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_dscp_table_update(struct rte_table_action *action,
uint64_t dscp_mask,
struct rte_table_action_dscp_table *table);
@@ -980,7 +989,8 @@ rte_table_action_dscp_table_update(struct rte_table_action *action,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_meter_profile_add(struct rte_table_action *action,
uint32_t meter_profile_id,
struct rte_table_action_meter_profile *profile);
@@ -996,7 +1006,8 @@ rte_table_action_meter_profile_add(struct rte_table_action *action,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_meter_profile_delete(struct rte_table_action *action,
uint32_t meter_profile_id);
@@ -1027,7 +1038,8 @@ rte_table_action_meter_profile_delete(struct rte_table_action *action,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_meter_read(struct rte_table_action *action,
void *data,
uint32_t tc_mask,
@@ -1053,7 +1065,8 @@ rte_table_action_meter_read(struct rte_table_action *action,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_ttl_read(struct rte_table_action *action,
void *data,
struct rte_table_action_ttl_counters *stats,
@@ -1078,7 +1091,8 @@ rte_table_action_ttl_read(struct rte_table_action *action,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_stats_read(struct rte_table_action *action,
void *data,
struct rte_table_action_stats_counters *stats,
@@ -1098,7 +1112,8 @@ rte_table_action_stats_read(struct rte_table_action *action,
* @return
* Zero on success, non-zero error code otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_table_action_time_read(struct rte_table_action *action,
void *data,
uint64_t *timestamp);
@@ -1113,7 +1128,8 @@ rte_table_action_time_read(struct rte_table_action *action,
* @return
* The pointer to the session on success, NULL otherwise.
*/
-__rte_experimental struct rte_cryptodev_sym_session *
+__rte_experimental
+struct rte_cryptodev_sym_session *
rte_table_action_crypto_sym_session_get(struct rte_table_action *action,
void *data);
diff --git a/lib/librte_power/rte_power_empty_poll.h b/lib/librte_power/rte_power_empty_poll.h
index e246a0953..6ba0a3707 100644
--- a/lib/librte_power/rte_power_empty_poll.h
+++ b/lib/librte_power/rte_power_empty_poll.h
@@ -142,14 +142,16 @@ struct ep_policy {
* - 0 on success.
* - Negative on error.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_power_empty_poll_stat_init(struct ep_params **eptr, uint8_t *freq_tlb,
struct ep_policy *policy);
/**
* Free the resource hold by power management system.
*/
-__rte_experimental void
+__rte_experimental
+void
rte_power_empty_poll_stat_free(void);
/**
@@ -163,7 +165,8 @@ rte_power_empty_poll_stat_free(void);
* - 0 on success.
* - Negative on error.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_power_empty_poll_stat_update(unsigned int lcore_id);
/**
@@ -178,7 +181,8 @@ rte_power_empty_poll_stat_update(unsigned int lcore_id);
* - 0 on success.
* - Negative on error.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_power_poll_stat_update(unsigned int lcore_id, uint8_t nb_pkt);
/**
@@ -190,7 +194,8 @@ rte_power_poll_stat_update(unsigned int lcore_id, uint8_t nb_pkt);
* @return
* Current lcore empty poll counter value.
*/
-__rte_experimental uint64_t
+__rte_experimental
+uint64_t
rte_power_empty_poll_stat_fetch(unsigned int lcore_id);
/**
@@ -202,7 +207,8 @@ rte_power_empty_poll_stat_fetch(unsigned int lcore_id);
* @return
* Current lcore valid poll counter value.
*/
-__rte_experimental uint64_t
+__rte_experimental
+uint64_t
rte_power_poll_stat_fetch(unsigned int lcore_id);
/**
@@ -213,7 +219,8 @@ rte_power_poll_stat_fetch(unsigned int lcore_id);
* @param arg
* The customized parameter
*/
-__rte_experimental void
+__rte_experimental
+void
rte_empty_poll_detection(struct rte_timer *tim, void *arg);
#ifdef __cplusplus
diff --git a/lib/librte_rcu/rte_rcu_qsbr.h b/lib/librte_rcu/rte_rcu_qsbr.h
index b48ed47be..53a5a7165 100644
--- a/lib/librte_rcu/rte_rcu_qsbr.h
+++ b/lib/librte_rcu/rte_rcu_qsbr.h
@@ -122,7 +122,8 @@ struct rte_rcu_qsbr {
* Possible rte_errno codes are:
* - EINVAL - max_threads is 0
*/
-__rte_experimental size_t
+__rte_experimental
+size_t
rte_rcu_qsbr_get_memsize(uint32_t max_threads);
/**
@@ -143,7 +144,8 @@ rte_rcu_qsbr_get_memsize(uint32_t max_threads);
* - EINVAL - max_threads is 0 or 'v' is NULL.
*
*/
-__rte_experimental int
+__rte_experimental
+int
rte_rcu_qsbr_init(struct rte_rcu_qsbr *v, uint32_t max_threads);
/**
@@ -169,7 +171,8 @@ 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_experimental
+int
rte_rcu_qsbr_thread_register(struct rte_rcu_qsbr *v, unsigned int thread_id);
/**
@@ -190,7 +193,8 @@ 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_experimental
+int
rte_rcu_qsbr_thread_unregister(struct rte_rcu_qsbr *v, unsigned int thread_id);
/**
@@ -221,7 +225,8 @@ 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_experimental
+static __rte_always_inline void
rte_rcu_qsbr_thread_online(struct rte_rcu_qsbr *v, unsigned int thread_id)
{
uint64_t t;
@@ -282,7 +287,8 @@ 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_experimental
+static __rte_always_inline void
rte_rcu_qsbr_thread_offline(struct rte_rcu_qsbr *v, unsigned int thread_id)
{
RTE_ASSERT(v != NULL && thread_id < v->max_threads);
@@ -322,7 +328,8 @@ 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_experimental
+static __rte_always_inline void
rte_rcu_qsbr_lock(__rte_unused struct rte_rcu_qsbr *v,
__rte_unused unsigned int thread_id)
{
@@ -358,7 +365,8 @@ 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_experimental
+static __rte_always_inline void
rte_rcu_qsbr_unlock(__rte_unused struct rte_rcu_qsbr *v,
__rte_unused unsigned int thread_id)
{
@@ -391,7 +399,8 @@ 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_experimental
+static __rte_always_inline uint64_t
rte_rcu_qsbr_start(struct rte_rcu_qsbr *v)
{
uint64_t t;
@@ -423,7 +432,8 @@ 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_experimental
+static __rte_always_inline void
rte_rcu_qsbr_quiescent(struct rte_rcu_qsbr *v, unsigned int thread_id)
{
uint64_t t;
@@ -578,7 +588,8 @@ __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_experimental
+static __rte_always_inline int
rte_rcu_qsbr_check(struct rte_rcu_qsbr *v, uint64_t t, bool wait)
{
RTE_ASSERT(v != NULL);
@@ -610,7 +621,8 @@ 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_experimental
+void
rte_rcu_qsbr_synchronize(struct rte_rcu_qsbr *v, unsigned int thread_id);
/**
@@ -631,7 +643,8 @@ 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_experimental
+int
rte_rcu_qsbr_dump(FILE *f, struct rte_rcu_qsbr *v);
#ifdef __cplusplus
diff --git a/lib/librte_sched/rte_sched.h b/lib/librte_sched/rte_sched.h
index a6ef9ee90..d61dda9f5 100644
--- a/lib/librte_sched/rte_sched.h
+++ b/lib/librte_sched/rte_sched.h
@@ -249,7 +249,8 @@ rte_sched_port_free(struct rte_sched_port *port);
* @return
* 0 upon success, error code otherwise
*/
-__rte_experimental int
+__rte_experimental
+int
rte_sched_port_pipe_profile_add(struct rte_sched_port *port,
struct rte_sched_pipe_params *params,
uint32_t *pipe_profile_id);
diff --git a/lib/librte_security/rte_security.h b/lib/librte_security/rte_security.h
index 0292d9335..bbdf4b07b 100644
--- a/lib/librte_security/rte_security.h
+++ b/lib/librte_security/rte_security.h
@@ -346,7 +346,8 @@ rte_security_session_create(struct rte_security_ctx *instance,
* - On success returns 0
* - On failure return errno
*/
-__rte_experimental int
+__rte_experimental
+int
rte_security_session_update(struct rte_security_ctx *instance,
struct rte_security_session *sess,
struct rte_security_session_conf *conf);
@@ -414,7 +415,8 @@ rte_security_set_pkt_metadata(struct rte_security_ctx *instance,
* - On success, userdata
* - On failure, NULL
*/
-__rte_experimental void *
+__rte_experimental
+void *
rte_security_get_userdata(struct rte_security_ctx *instance, uint64_t md);
/**
@@ -501,7 +503,8 @@ struct rte_security_stats {
* - On success return 0
* - On failure errno
*/
-__rte_experimental int
+__rte_experimental
+int
rte_security_session_stats_get(struct rte_security_ctx *instance,
struct rte_security_session *sess,
struct rte_security_stats *stats);
diff --git a/lib/librte_stack/rte_stack.h b/lib/librte_stack/rte_stack.h
index 536874a50..27ddb199e 100644
--- a/lib/librte_stack/rte_stack.h
+++ b/lib/librte_stack/rte_stack.h
@@ -112,7 +112,8 @@ struct rte_stack {
* @return
* Actual number of objects pushed (either 0 or *n*).
*/
-__rte_experimental static __rte_always_inline unsigned int
+__rte_experimental
+static __rte_always_inline unsigned int
rte_stack_push(struct rte_stack *s, void * const *obj_table, unsigned int n)
{
RTE_ASSERT(s != NULL);
@@ -139,7 +140,8 @@ rte_stack_push(struct rte_stack *s, void * const *obj_table, unsigned int n)
* @return
* Actual number of objects popped (either 0 or *n*).
*/
-__rte_experimental static __rte_always_inline unsigned int
+__rte_experimental
+static __rte_always_inline unsigned int
rte_stack_pop(struct rte_stack *s, void **obj_table, unsigned int n)
{
RTE_ASSERT(s != NULL);
@@ -162,7 +164,8 @@ rte_stack_pop(struct rte_stack *s, void **obj_table, unsigned int n)
* @return
* The number of used entries in the stack.
*/
-__rte_experimental static __rte_always_inline unsigned int
+__rte_experimental
+static __rte_always_inline unsigned int
rte_stack_count(struct rte_stack *s)
{
RTE_ASSERT(s != NULL);
@@ -184,7 +187,8 @@ rte_stack_count(struct rte_stack *s)
* @return
* The number of free entries in the stack.
*/
-__rte_experimental static __rte_always_inline unsigned int
+__rte_experimental
+static __rte_always_inline unsigned int
rte_stack_free_count(struct rte_stack *s)
{
RTE_ASSERT(s != NULL);
@@ -222,7 +226,8 @@ rte_stack_free_count(struct rte_stack *s)
* - ENOMEM - insufficient memory to create the stack
* - ENAMETOOLONG - name size exceeds RTE_STACK_NAMESIZE
*/
-__rte_experimental struct rte_stack *
+__rte_experimental
+struct rte_stack *
rte_stack_create(const char *name, unsigned int count, int socket_id,
uint32_t flags);
@@ -235,7 +240,8 @@ rte_stack_create(const char *name, unsigned int count, int socket_id,
* @param s
* Stack to free
*/
-__rte_experimental void
+__rte_experimental
+void
rte_stack_free(struct rte_stack *s);
/**
@@ -252,7 +258,8 @@ rte_stack_free(struct rte_stack *s);
* - ENOENT - Stack with name *name* not found.
* - EINVAL - *name* pointer is NULL.
*/
-__rte_experimental struct rte_stack *
+__rte_experimental
+struct rte_stack *
rte_stack_lookup(const char *name);
#ifdef __cplusplus
diff --git a/lib/librte_stack/rte_stack_lf.h b/lib/librte_stack/rte_stack_lf.h
index 28702b2b9..f5581f0c2 100644
--- a/lib/librte_stack/rte_stack_lf.h
+++ b/lib/librte_stack/rte_stack_lf.h
@@ -23,7 +23,8 @@
* @return
* Actual number of objects enqueued.
*/
-__rte_experimental static __rte_always_inline unsigned int
+__rte_experimental
+static __rte_always_inline unsigned int
__rte_stack_lf_push(struct rte_stack *s,
void * const *obj_table,
unsigned int n)
@@ -61,7 +62,8 @@ __rte_stack_lf_push(struct rte_stack *s,
* @return
* - Actual number of objects popped.
*/
-__rte_experimental static __rte_always_inline unsigned int
+__rte_experimental
+static __rte_always_inline unsigned int
__rte_stack_lf_pop(struct rte_stack *s, void **obj_table, unsigned int n)
{
struct rte_stack_lf_elem *first, *last = NULL;
diff --git a/lib/librte_stack/rte_stack_std.h b/lib/librte_stack/rte_stack_std.h
index 1306ea3a6..7142cbf8e 100644
--- a/lib/librte_stack/rte_stack_std.h
+++ b/lib/librte_stack/rte_stack_std.h
@@ -19,7 +19,8 @@
* @return
* Actual number of objects pushed (either 0 or *n*).
*/
-__rte_experimental static __rte_always_inline unsigned int
+__rte_experimental
+static __rte_always_inline unsigned int
__rte_stack_std_push(struct rte_stack *s, void * const *obj_table,
unsigned int n)
{
@@ -58,7 +59,8 @@ __rte_stack_std_push(struct rte_stack *s, void * const *obj_table,
* @return
* Actual number of objects popped (either 0 or *n*).
*/
-__rte_experimental static __rte_always_inline unsigned int
+__rte_experimental
+static __rte_always_inline unsigned int
__rte_stack_std_pop(struct rte_stack *s, void **obj_table, unsigned int n)
{
struct rte_stack_std *stack = &s->stack_std;
@@ -92,7 +94,8 @@ __rte_stack_std_pop(struct rte_stack *s, void **obj_table, unsigned int n)
* @return
* The number of used entries in the stack.
*/
-__rte_experimental static __rte_always_inline unsigned int
+__rte_experimental
+static __rte_always_inline unsigned int
__rte_stack_std_count(struct rte_stack *s)
{
return (unsigned int)s->stack_std.len;
diff --git a/lib/librte_table/rte_table_hash_func.h b/lib/librte_table/rte_table_hash_func.h
index 6c7db1cad..350c79564 100644
--- a/lib/librte_table/rte_table_hash_func.h
+++ b/lib/librte_table/rte_table_hash_func.h
@@ -14,7 +14,8 @@ extern "C" {
#include <rte_compat.h>
#include <rte_common.h>
-__rte_experimental static inline uint64_t
+__rte_experimental
+static inline uint64_t
rte_crc32_u64_generic(uint64_t crc, uint64_t value)
{
int i;
@@ -52,7 +53,8 @@ rte_crc32_u64(uint64_t crc, uint64_t v)
#endif
-__rte_experimental static inline uint64_t
+__rte_experimental
+static inline uint64_t
rte_table_hash_crc_key8(void *key, void *mask, __rte_unused uint32_t key_size,
uint64_t seed)
{
@@ -65,7 +67,8 @@ rte_table_hash_crc_key8(void *key, void *mask, __rte_unused uint32_t key_size,
return crc0;
}
-__rte_experimental static inline uint64_t
+__rte_experimental
+static inline uint64_t
rte_table_hash_crc_key16(void *key, void *mask, __rte_unused uint32_t key_size,
uint64_t seed)
{
@@ -83,7 +86,8 @@ rte_table_hash_crc_key16(void *key, void *mask, __rte_unused uint32_t key_size,
return crc0;
}
-__rte_experimental static inline uint64_t
+__rte_experimental
+static inline uint64_t
rte_table_hash_crc_key24(void *key, void *mask, __rte_unused uint32_t key_size,
uint64_t seed)
{
@@ -104,7 +108,8 @@ rte_table_hash_crc_key24(void *key, void *mask, __rte_unused uint32_t key_size,
return crc0;
}
-__rte_experimental static inline uint64_t
+__rte_experimental
+static inline uint64_t
rte_table_hash_crc_key32(void *key, void *mask, __rte_unused uint32_t key_size,
uint64_t seed)
{
@@ -129,7 +134,8 @@ rte_table_hash_crc_key32(void *key, void *mask, __rte_unused uint32_t key_size,
return crc0;
}
-__rte_experimental static inline uint64_t
+__rte_experimental
+static inline uint64_t
rte_table_hash_crc_key40(void *key, void *mask, __rte_unused uint32_t key_size,
uint64_t seed)
{
@@ -154,7 +160,8 @@ rte_table_hash_crc_key40(void *key, void *mask, __rte_unused uint32_t key_size,
return crc0;
}
-__rte_experimental static inline uint64_t
+__rte_experimental
+static inline uint64_t
rte_table_hash_crc_key48(void *key, void *mask, __rte_unused uint32_t key_size,
uint64_t seed)
{
@@ -180,7 +187,8 @@ rte_table_hash_crc_key48(void *key, void *mask, __rte_unused uint32_t key_size,
return crc0;
}
-__rte_experimental static inline uint64_t
+__rte_experimental
+static inline uint64_t
rte_table_hash_crc_key56(void *key, void *mask, __rte_unused uint32_t key_size,
uint64_t seed)
{
@@ -209,7 +217,8 @@ rte_table_hash_crc_key56(void *key, void *mask, __rte_unused uint32_t key_size,
return crc0;
}
-__rte_experimental static inline uint64_t
+__rte_experimental
+static inline uint64_t
rte_table_hash_crc_key64(void *key, void *mask, __rte_unused uint32_t key_size,
uint64_t seed)
{
diff --git a/lib/librte_telemetry/rte_telemetry.h b/lib/librte_telemetry/rte_telemetry.h
index 0c54ca43f..aedb31859 100644
--- a/lib/librte_telemetry/rte_telemetry.h
+++ b/lib/librte_telemetry/rte_telemetry.h
@@ -31,7 +31,8 @@
* @return
* -EALREADY if Telemetry is already initialised.
*/
-__rte_experimental int32_t
+__rte_experimental
+int32_t
rte_telemetry_init(void);
/**
@@ -45,7 +46,8 @@ rte_telemetry_init(void);
* @return
* -EPERM on failure
*/
-__rte_experimental int32_t
+__rte_experimental
+int32_t
rte_telemetry_cleanup(void);
/**
@@ -60,7 +62,8 @@ rte_telemetry_cleanup(void);
* @return
* -1 on failure when the test has failed
*/
-__rte_experimental int32_t
+__rte_experimental
+int32_t
rte_telemetry_selftest(void);
#endif
diff --git a/lib/librte_telemetry/rte_telemetry_parser.h b/lib/librte_telemetry/rte_telemetry_parser.h
index 85040b8cc..28b808d8a 100644
--- a/lib/librte_telemetry/rte_telemetry_parser.h
+++ b/lib/librte_telemetry/rte_telemetry_parser.h
@@ -8,7 +8,8 @@
#ifndef _RTE_TELEMETRY_PARSER_H_
#define _RTE_TELEMETRY_PARSER_H_
-__rte_experimental int32_t
+__rte_experimental
+int32_t
rte_telemetry_parse(struct telemetry_impl *telemetry, char *socket_rx_data);
#endif
diff --git a/lib/librte_timer/rte_timer.h b/lib/librte_timer/rte_timer.h
index 39fc1d5f1..1b0d5f6a5 100644
--- a/lib/librte_timer/rte_timer.h
+++ b/lib/librte_timer/rte_timer.h
@@ -147,7 +147,8 @@ struct rte_timer
* - 0: Success
* - -ENOSPC: maximum number of timer data instances already allocated
*/
-__rte_experimental int rte_timer_data_alloc(uint32_t *id_ptr);
+__rte_experimental
+int rte_timer_data_alloc(uint32_t *id_ptr);
/**
* @warning
@@ -162,7 +163,8 @@ __rte_experimental int rte_timer_data_alloc(uint32_t *id_ptr);
* - 0: Success
* - -EINVAL: invalid timer data instance identifier
*/
-__rte_experimental int rte_timer_data_dealloc(uint32_t id);
+__rte_experimental
+int rte_timer_data_dealloc(uint32_t id);
/**
* Initialize the timer library.
@@ -187,7 +189,8 @@ void rte_timer_subsystem_init_v20(void);
*
* Free timer subsystem resources.
*/
-__rte_experimental void rte_timer_subsystem_finalize(void);
+__rte_experimental
+void rte_timer_subsystem_finalize(void);
/**
* Initialize a timer handle.
@@ -408,7 +411,8 @@ void rte_timer_dump_stats_v20(FILE *f);
* - (-1): Timer is in the RUNNING or CONFIG state.
* - -EINVAL: invalid timer_data_id
*/
-__rte_experimental int
+__rte_experimental
+int
rte_timer_alt_reset(uint32_t timer_data_id, struct rte_timer *tim,
uint64_t ticks, enum rte_timer_type type,
unsigned int tim_lcore, rte_timer_cb_t fct, void *arg);
@@ -433,7 +437,8 @@ rte_timer_alt_reset(uint32_t timer_data_id, struct rte_timer *tim,
* - (-1): The timer is in the RUNNING or CONFIG state.
* - -EINVAL: invalid timer_data_id
*/
-__rte_experimental int
+__rte_experimental
+int
rte_timer_alt_stop(uint32_t timer_data_id, struct rte_timer *tim);
/**
@@ -469,7 +474,8 @@ typedef void (*rte_timer_alt_manage_cb_t)(struct rte_timer *tim);
* - 0: success
* - -EINVAL: invalid timer_data_id
*/
-__rte_experimental int
+__rte_experimental
+int
rte_timer_alt_manage(uint32_t timer_data_id, unsigned int *poll_lcores,
int n_poll_lcores, rte_timer_alt_manage_cb_t f);
@@ -501,7 +507,8 @@ typedef void (*rte_timer_stop_all_cb_t)(struct rte_timer *tim, void *arg);
* - 0: success
* - EINVAL: invalid timer_data_id
*/
-__rte_experimental int
+__rte_experimental
+int
rte_timer_stop_all(uint32_t timer_data_id, unsigned int *walk_lcores,
int nb_walk_lcores, rte_timer_stop_all_cb_t f, void *f_arg);
@@ -523,7 +530,8 @@ rte_timer_stop_all(uint32_t timer_data_id, unsigned int *walk_lcores,
* - 0: success
* - -EINVAL: invalid timer_data_id
*/
-__rte_experimental int
+__rte_experimental
+int
rte_timer_alt_dump_stats(uint32_t timer_data_id, FILE *f);
#ifdef __cplusplus
diff --git a/lib/librte_vhost/rte_vdpa.h b/lib/librte_vhost/rte_vdpa.h
index f3a51a88d..9a3deb31d 100644
--- a/lib/librte_vhost/rte_vdpa.h
+++ b/lib/librte_vhost/rte_vdpa.h
@@ -100,7 +100,8 @@ struct rte_vdpa_device {
* @return
* device id on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vdpa_register_device(struct rte_vdpa_dev_addr *addr,
struct rte_vdpa_dev_ops *ops);
@@ -115,7 +116,8 @@ rte_vdpa_register_device(struct rte_vdpa_dev_addr *addr,
* @return
* device id on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vdpa_unregister_device(int did);
/**
@@ -129,7 +131,8 @@ rte_vdpa_unregister_device(int did);
* @return
* device id on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vdpa_find_device_id(struct rte_vdpa_dev_addr *addr);
/**
@@ -143,7 +146,8 @@ rte_vdpa_find_device_id(struct rte_vdpa_dev_addr *addr);
* @return
* rte_vdpa_device on success, NULL on failure
*/
-__rte_experimental struct rte_vdpa_device *
+__rte_experimental
+struct rte_vdpa_device *
rte_vdpa_get_device(int did);
/**
@@ -155,7 +159,8 @@ rte_vdpa_get_device(int did);
* @return
* available vdpa device number
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vdpa_get_device_num(void);
/**
@@ -171,7 +176,8 @@ rte_vdpa_get_device_num(void);
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_host_notifier_ctrl(int vid, bool enable);
/**
@@ -191,6 +197,7 @@ rte_vhost_host_notifier_ctrl(int vid, bool enable);
* @return
* number of synced used entries on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vdpa_relay_vring_used(int vid, uint16_t qid, void *vring_m);
#endif /* _RTE_VDPA_H_ */
diff --git a/lib/librte_vhost/rte_vhost.h b/lib/librte_vhost/rte_vhost.h
index 66bdbf49f..7fb172912 100644
--- a/lib/librte_vhost/rte_vhost.h
+++ b/lib/librte_vhost/rte_vhost.h
@@ -313,7 +313,8 @@ int rte_vhost_driver_unregister(const char *path);
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_driver_attach_vdpa_device(const char *path, int did);
/**
@@ -324,7 +325,8 @@ rte_vhost_driver_attach_vdpa_device(const char *path, int did);
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_driver_detach_vdpa_device(const char *path);
/**
@@ -335,7 +337,8 @@ rte_vhost_driver_detach_vdpa_device(const char *path);
* @return
* Device id, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_driver_get_vdpa_device_id(const char *path);
/**
@@ -403,7 +406,8 @@ int rte_vhost_driver_get_features(const char *path, uint64_t *features);
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_driver_set_protocol_features(const char *path,
uint64_t protocol_features);
@@ -417,7 +421,8 @@ rte_vhost_driver_set_protocol_features(const char *path,
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_driver_get_protocol_features(const char *path,
uint64_t *protocol_features);
@@ -431,7 +436,8 @@ rte_vhost_driver_get_protocol_features(const char *path,
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_driver_get_queue_num(const char *path, uint32_t *queue_num);
/**
@@ -656,7 +662,8 @@ uint32_t rte_vhost_rx_queue_count(int vid, uint16_t qid);
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_get_log_base(int vid, uint64_t *log_base, uint64_t *log_size);
/**
@@ -673,7 +680,8 @@ rte_vhost_get_log_base(int vid, uint64_t *log_base, uint64_t *log_size);
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_get_vring_base(int vid, uint16_t queue_id,
uint16_t *last_avail_idx, uint16_t *last_used_idx);
@@ -691,7 +699,8 @@ rte_vhost_get_vring_base(int vid, uint16_t queue_id,
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_set_vring_base(int vid, uint16_t queue_id,
uint16_t last_avail_idx, uint16_t last_used_idx);
@@ -707,7 +716,8 @@ rte_vhost_set_vring_base(int vid, uint16_t queue_id,
* @return
* 0 on success, -1 on failure
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_extern_callback_register(int vid,
struct rte_vhost_user_extern_ops const * const ops, void *ctx);
@@ -719,7 +729,8 @@ rte_vhost_extern_callback_register(int vid,
* @return
* device id
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_get_vdpa_device_id(int vid);
#ifdef __cplusplus
diff --git a/lib/librte_vhost/rte_vhost_crypto.h b/lib/librte_vhost/rte_vhost_crypto.h
index 5014295c6..d29871c7e 100644
--- a/lib/librte_vhost/rte_vhost_crypto.h
+++ b/lib/librte_vhost/rte_vhost_crypto.h
@@ -35,7 +35,8 @@ enum rte_vhost_crypto_zero_copy {
* 0 if the Vhost Crypto Instance is created successfully.
* Negative integer if otherwise
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_crypto_create(int vid, uint8_t cryptodev_id,
struct rte_mempool *sess_pool,
struct rte_mempool *sess_priv_pool,
@@ -50,7 +51,8 @@ rte_vhost_crypto_create(int vid, uint8_t cryptodev_id,
* 0 if the Vhost Crypto Instance is created successfully.
* Negative integer if otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_crypto_free(int vid);
/**
@@ -64,7 +66,8 @@ rte_vhost_crypto_free(int vid);
* 0 if completed successfully.
* Negative integer if otherwise.
*/
-__rte_experimental int
+__rte_experimental
+int
rte_vhost_crypto_set_zero_copy(int vid, enum rte_vhost_crypto_zero_copy option);
/**
@@ -84,7 +87,8 @@ rte_vhost_crypto_set_zero_copy(int vid, enum rte_vhost_crypto_zero_copy option);
* @return
* The number of fetched and processed vhost crypto request operations.
*/
-__rte_experimental uint16_t
+__rte_experimental
+uint16_t
rte_vhost_crypto_fetch_requests(int vid, uint32_t qid,
struct rte_crypto_op **ops, uint16_t nb_ops);
/**
@@ -105,7 +109,8 @@ rte_vhost_crypto_fetch_requests(int vid, uint32_t qid,
* @return
* The number of ops processed.
*/
-__rte_experimental uint16_t
+__rte_experimental
+uint16_t
rte_vhost_crypto_finalize_requests(struct rte_crypto_op **ops,
uint16_t nb_ops, int *callfds, uint16_t *nb_callfds);
--
2.11.0
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [dpdk-dev] [PATCH 1/2] eal: fix duplicate experimental tag
2019-06-28 15:56 ` [dpdk-dev] [PATCH 1/2] eal: fix duplicate experimental tag Adrien Mazarguil
@ 2019-06-28 16:05 ` Stephen Hemminger
2019-06-28 16:23 ` David Marchand
1 sibling, 0 replies; 7+ messages in thread
From: Stephen Hemminger @ 2019-06-28 16:05 UTC (permalink / raw)
To: Adrien Mazarguil
Cc: Thomas Monjalon, dev, David Marchand, Mattias Rönnblom
On Fri, 28 Jun 2019 17:56:34 +0200
Adrien Mazarguil <adrien.mazarguil@6wind.com> wrote:
> Its presence on the function prototype in the header file is enough.
>
> Fixes: 5f4ed3f05849 ("eal: introduce random generator with upper bound")
> Cc: Mattias Rönnblom <mattias.ronnblom@ericsson.com>
>
> Signed-off-by: Adrien Mazarguil <adrien.mazarguil@6wind.com>
> ---
> lib/librte_eal/common/rte_random.c | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/lib/librte_eal/common/rte_random.c b/lib/librte_eal/common/rte_random.c
> index 3d9b9b7d8..f85119048 100644
> --- a/lib/librte_eal/common/rte_random.c
> +++ b/lib/librte_eal/common/rte_random.c
> @@ -137,7 +137,7 @@ rte_rand(void)
> return __rte_rand_lfsr258(state);
> }
>
> -uint64_t __rte_experimental
> +uint64_t
> rte_rand_max(uint64_t upper_bound)
> {
> struct rte_rand_state *state;
Almost any __rte_experimental in a .c file is wrong.
The experimental tag is supposed to be on the prototype in the header.
This seems to be a common problem:
./drivers/net/atlantic/rte_pmd_atlantic.c
./drivers/net/dpaa2/dpaa2_ethdev.c
./drivers/net/ixgbe/rte_pmd_ixgbe.c
./lib/librte_bbdev/rte_bbdev.c
./lib/librte_bpf/bpf.c
./lib/librte_bpf/bpf_exec.c
./lib/librte_bpf/bpf_load.c
./lib/librte_bpf/bpf_load_elf.c
./lib/librte_bpf/bpf_pkt.c
./lib/librte_compressdev/rte_comp.c
./lib/librte_compressdev/rte_compressdev.c
./lib/librte_compressdev/rte_compressdev_pmd.c
./lib/librte_cryptodev/rte_cryptodev.c
./lib/librte_eal/common/eal_common_class.c
./lib/librte_eal/common/eal_common_dev.c
./lib/librte_eal/common/eal_common_fbarray.c
./lib/librte_eal/common/eal_common_log.c
./lib/librte_eal/common/eal_common_memory.c
./lib/librte_eal/common/eal_common_proc.c
./lib/librte_eal/common/eal_common_timer.c
./lib/librte_eal/common/rte_malloc.c
./lib/librte_eal/common/rte_option.c
./lib/librte_eal/common/rte_random.c
./lib/librte_eal/common/rte_service.c
./lib/librte_eal/freebsd/eal/eal.c
./lib/librte_eal/freebsd/eal/eal_dev.c
./lib/librte_eal/freebsd/eal/eal_interrupts.c
./lib/librte_eal/linux/eal/eal_dev.c
./lib/librte_eal/linux/eal/eal_interrupts.c
./lib/librte_eal/linux/eal/eal_vfio.c
./lib/librte_ethdev/rte_ethdev.c
./lib/librte_ethdev/rte_flow.c
./lib/librte_ethdev/rte_mtr.c
./lib/librte_eventdev/rte_event_eth_rx_adapter.c
./lib/librte_flow_classify/rte_flow_classify.c
./lib/librte_hash/rte_cuckoo_hash.c
./lib/librte_ip_frag/rte_ip_frag_common.c
./lib/librte_ipsec/sa.c
./lib/librte_ipsec/ses.c
./lib/librte_kni/rte_kni.c
./lib/librte_kvargs/rte_kvargs.c
./lib/librte_mbuf/rte_mbuf.c
./lib/librte_meter/rte_meter.c
./lib/librte_net/rte_arp.c
./lib/librte_net/rte_net.c
./lib/librte_power/rte_power_empty_poll.c
./lib/librte_rcu/rte_rcu_qsbr.c
./lib/librte_sched/rte_sched.c
./lib/librte_security/rte_security.c
./lib/librte_telemetry/rte_telemetry.c
./lib/librte_telemetry/rte_telemetry_parser.c
./lib/librte_timer/rte_timer.c
./lib/librte_vhost/vdpa.c
./lib/librte_vhost/vhost_crypto.c
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [dpdk-dev] [PATCH 1/2] eal: fix duplicate experimental tag
2019-06-28 15:56 ` [dpdk-dev] [PATCH 1/2] eal: fix duplicate experimental tag Adrien Mazarguil
2019-06-28 16:05 ` Stephen Hemminger
@ 2019-06-28 16:23 ` David Marchand
2019-07-01 8:39 ` Adrien Mazarguil
1 sibling, 1 reply; 7+ messages in thread
From: David Marchand @ 2019-06-28 16:23 UTC (permalink / raw)
To: Adrien Mazarguil; +Cc: Thomas Monjalon, dev, Mattias Rönnblom
On Fri, Jun 28, 2019 at 5:57 PM Adrien Mazarguil <adrien.mazarguil@6wind.com>
wrote:
> Its presence on the function prototype in the header file is enough.
>
> Fixes: 5f4ed3f05849 ("eal: introduce random generator with upper bound")
> Cc: Mattias Rönnblom <mattias.ronnblom@ericsson.com>
>
> Signed-off-by: Adrien Mazarguil <adrien.mazarguil@6wind.com>
> ---
> lib/librte_eal/common/rte_random.c | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/lib/librte_eal/common/rte_random.c
> b/lib/librte_eal/common/rte_random.c
> index 3d9b9b7d8..f85119048 100644
> --- a/lib/librte_eal/common/rte_random.c
> +++ b/lib/librte_eal/common/rte_random.c
> @@ -137,7 +137,7 @@ rte_rand(void)
> return __rte_rand_lfsr258(state);
> }
>
> -uint64_t __rte_experimental
> +uint64_t
> rte_rand_max(uint64_t upper_bound)
> {
> struct rte_rand_state *state;
> --
> 2.11.0
>
I had mentionned to Thomas I would do an extra pass, thanks for already
catching this one.
Do you mind if I squash this in my series ?
--
David Marchand
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [dpdk-dev] [PATCH 2/2] Fix __rte_experimental clutter
2019-06-28 15:56 ` [dpdk-dev] [PATCH 2/2] Fix __rte_experimental clutter Adrien Mazarguil
@ 2019-06-28 19:22 ` David Marchand
0 siblings, 0 replies; 7+ messages in thread
From: David Marchand @ 2019-06-28 19:22 UTC (permalink / raw)
To: Adrien Mazarguil; +Cc: Thomas Monjalon, dev
On Fri, Jun 28, 2019 at 5:57 PM Adrien Mazarguil <adrien.mazarguil@6wind.com>
wrote:
> Rather than prefixing the return type of function prototypes with
> __rte_experimental, move it to a separate line to enhance readability.
>
> Except for checkpatches.sh, this patch was automatically generated by:
>
> sed -i \
> -e '/^\([^#].*\)\?__rte_experimental */{' \
> -e 's//\1/; s/ *$//; i\' \
> -e __rte_experimental \
> -e '/^$/d}' \
> $(git grep -l __rte_experimental -- '*.h')
>
> And applies on top of below commit:
>
> Fixes: 3b45414830ff ("enforce __rte_experimental at the start of symbol
> declarations")
> Cc: David Marchand <david.marchand@redhat.com>
>
> Signed-off-by: Adrien Mazarguil <adrien.mazarguil@6wind.com>
>
Either way is ok for me.
But if we go with yours, we can squash this patch into mine and avoid this
"va-et-vient".
Thomas, what do you want to do?
Adrien patch1 can be caught in my patch8 by re-running the commands from
the commitlog.
Can you handle it?
--
David Marchand
^ permalink raw reply [flat|nested] 7+ messages in thread
* Re: [dpdk-dev] [PATCH 1/2] eal: fix duplicate experimental tag
2019-06-28 16:23 ` David Marchand
@ 2019-07-01 8:39 ` Adrien Mazarguil
0 siblings, 0 replies; 7+ messages in thread
From: Adrien Mazarguil @ 2019-07-01 8:39 UTC (permalink / raw)
To: David Marchand; +Cc: Thomas Monjalon, dev, Mattias Rönnblom
On Fri, Jun 28, 2019 at 06:23:19PM +0200, David Marchand wrote:
> On Fri, Jun 28, 2019 at 5:57 PM Adrien Mazarguil <adrien.mazarguil@6wind.com>
> wrote:
>
> > Its presence on the function prototype in the header file is enough.
> >
> > Fixes: 5f4ed3f05849 ("eal: introduce random generator with upper bound")
> > Cc: Mattias Rönnblom <mattias.ronnblom@ericsson.com>
> >
> > Signed-off-by: Adrien Mazarguil <adrien.mazarguil@6wind.com>
> > ---
> > lib/librte_eal/common/rte_random.c | 2 +-
> > 1 file changed, 1 insertion(+), 1 deletion(-)
> >
> > diff --git a/lib/librte_eal/common/rte_random.c
> > b/lib/librte_eal/common/rte_random.c
> > index 3d9b9b7d8..f85119048 100644
> > --- a/lib/librte_eal/common/rte_random.c
> > +++ b/lib/librte_eal/common/rte_random.c
> > @@ -137,7 +137,7 @@ rte_rand(void)
> > return __rte_rand_lfsr258(state);
> > }
> >
> > -uint64_t __rte_experimental
> > +uint64_t
> > rte_rand_max(uint64_t upper_bound)
> > {
> > struct rte_rand_state *state;
> > --
> > 2.11.0
> >
>
> I had mentionned to Thomas I would do an extra pass, thanks for already
> catching this one.
> Do you mind if I squash this in my series ?
No problem, this series was tailored for this exact purpose, thanks for v2!
--
Adrien Mazarguil
6WIND
^ permalink raw reply [flat|nested] 7+ messages in thread
end of thread, other threads:[~2019-07-01 8:39 UTC | newest]
Thread overview: 7+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-06-28 15:56 [dpdk-dev] [PATCH 0/2] Fix remaining issues with __rte_experimental Adrien Mazarguil
2019-06-28 15:56 ` [dpdk-dev] [PATCH 1/2] eal: fix duplicate experimental tag Adrien Mazarguil
2019-06-28 16:05 ` Stephen Hemminger
2019-06-28 16:23 ` David Marchand
2019-07-01 8:39 ` Adrien Mazarguil
2019-06-28 15:56 ` [dpdk-dev] [PATCH 2/2] Fix __rte_experimental clutter Adrien Mazarguil
2019-06-28 19:22 ` David Marchand
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).