From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 5E251A046B for ; Fri, 28 Jun 2019 17:56:56 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A0A844CC0; Fri, 28 Jun 2019 17:56:41 +0200 (CEST) Received: from mail-wm1-f48.google.com (mail-wm1-f48.google.com [209.85.128.48]) by dpdk.org (Postfix) with ESMTP id 3F4A249DF for ; Fri, 28 Jun 2019 17:56:40 +0200 (CEST) Received: by mail-wm1-f48.google.com with SMTP id u8so9456186wmm.1 for ; Fri, 28 Jun 2019 08:56:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=6wind.com; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=4jtpGdqYI8AHvnSm7UbGIf6DER4IxNjreFHqey3QmeA=; b=cro1SQfry+F78497+GyRBIs699qBCmN0GmAWGY+IdwNmzPbgBvYA/30omZn8LTmGO5 n17zCLB4UWt4NEgf9GYfTl5SlV4q2WT+i3paPHzEbgmisvteH4MpSdvSVRb9FlmdhA8x sD9Q2s0SinRI7u1e74JUTIh6A2NMcvhJx4avzXfnPGcGxc6Zu5tbK2LW4j3W7Uqd+EED YIsSu6x3xHF3LkMpvE3F0aAOiqmjOWjx5MxCdL3nw4ATxrw6WrdNIQ2Poqiv/FDsWxBV nbtWA8cIgMSssvxD63NR09SbQzKWjqTZUzyKE2JXJqtZjCL6C95V7oAkLT1CWUJuZfi4 f2nA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=4jtpGdqYI8AHvnSm7UbGIf6DER4IxNjreFHqey3QmeA=; b=B+YYcAAtd4HbI9JFmYte9O6njJqGinKfNRNXZ2hCp8F1L1eLvmq39SR3hIUJWowDdZ tPV92D5wUa87jeApCuTR8bwGzgwa86mTAXyX/KNBCbIaSEoEV4T9RzwD7GyKkaMZjWn7 ysDz6YX7zVFzTtZF+alHVaYUxRjn//jJFCjbNNyqc44ONyQ9qWSusNECIYdtcxeWG+Rt YX6dpaOQrzAAp4AcJHOVWDpR/2ZXM/hkHDFSolMN79auSNWaxBRCiD/HqO8hUNlFUTTp 2ukcAMz0pL4FH4odALV/ocZb3udUNYbQBJu/yw9vx85Lpu7mR2VTCY7Xi0HWbtZ4j13r Qgmg== X-Gm-Message-State: APjAAAXmVwaLXUNGy4apEUkl19NjSHNXHUd/0OvHuuiLwwOE7acfcJgs tz0SDJJonYig0r0QJLTHdKS7tGXMfF3Xyg== X-Google-Smtp-Source: APXvYqxx57B3BrkFzaI5dUe/Gu3ngWJg9+pgLxy8qyQzyt+btoUh8uFEQnFkiXiEW8imDjK/cBJEpg== X-Received: by 2002:a1c:dc07:: with SMTP id t7mr8110232wmg.164.1561737398329; Fri, 28 Jun 2019 08:56:38 -0700 (PDT) Received: from 6wind.com (host.78.145.23.62.rev.coltfrance.com. [62.23.145.78]) by smtp.gmail.com with ESMTPSA id a81sm2701311wmh.3.2019.06.28.08.56.37 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 28 Jun 2019 08:56:37 -0700 (PDT) Date: Fri, 28 Jun 2019 17:56:36 +0200 From: Adrien Mazarguil To: Thomas Monjalon Cc: dev@dpdk.org, David Marchand Message-ID: <20190628155056.28884-3-adrien.mazarguil@6wind.com> References: <20190628155056.28884-1-adrien.mazarguil@6wind.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20190628155056.28884-1-adrien.mazarguil@6wind.com> X-Mailer: git-send-email 2.11.0 Subject: [dpdk-dev] [PATCH 2/2] Fix __rte_experimental clutter X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" 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 Signed-off-by: Adrien Mazarguil --- 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() { # 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 #include -__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