summaryrefslogtreecommitdiff
path: root/lib/librte_bbdev
diff options
context:
space:
mode:
authorNeil Horman <nhorman@tuxdriver.com>2018-01-21 20:48:06 -0500
committerThomas Monjalon <thomas@monjalon.net>2018-01-29 23:35:29 +0100
commit77b7b81e32e94e79d2a65b259769ae11725be8bf (patch)
tree27388665cc66e0d3ee858ae230efa566e8f895b5 /lib/librte_bbdev
parent7d540a3e735dd4d3e5b57d281f079ecbf0a8f9fc (diff)
downloaddpdk-77b7b81e32e94e79d2a65b259769ae11725be8bf.zip
dpdk-77b7b81e32e94e79d2a65b259769ae11725be8bf.tar.gz
dpdk-77b7b81e32e94e79d2a65b259769ae11725be8bf.tar.xz
add experimental tag to appropriate functions
Append the __rte_experimental tag to api calls appearing in the EXPERIMENTAL section of their libraries version map Signed-off-by: Neil Horman <nhorman@tuxdriver.com> Acked-by: Thomas Monjalon <thomas@monjalon.net>
Diffstat (limited to 'lib/librte_bbdev')
-rw-r--r--lib/librte_bbdev/rte_bbdev.c53
-rw-r--r--lib/librte_bbdev/rte_bbdev.h41
-rw-r--r--lib/librte_bbdev/rte_bbdev_pmd.h8
3 files changed, 52 insertions, 50 deletions
diff --git a/lib/librte_bbdev/rte_bbdev.c b/lib/librte_bbdev/rte_bbdev.c
index 8a053e3..db1c00a 100644
--- a/lib/librte_bbdev/rte_bbdev.c
+++ b/lib/librte_bbdev/rte_bbdev.c
@@ -6,6 +6,7 @@
#include <string.h>
#include <stdbool.h>
+#include <rte_compat.h>
#include <rte_common.h>
#include <rte_errno.h>
#include <rte_log.h>
@@ -160,7 +161,7 @@ find_free_dev_id(void)
return RTE_BBDEV_MAX_DEVS;
}
-struct rte_bbdev *
+struct rte_bbdev * __rte_experimental
rte_bbdev_allocate(const char *name)
{
int ret;
@@ -219,7 +220,7 @@ rte_bbdev_allocate(const char *name)
return bbdev;
}
-int
+int __rte_experimental
rte_bbdev_release(struct rte_bbdev *bbdev)
{
uint16_t dev_id;
@@ -253,7 +254,7 @@ rte_bbdev_release(struct rte_bbdev *bbdev)
return 0;
}
-struct rte_bbdev *
+struct rte_bbdev * __rte_experimental
rte_bbdev_get_named_dev(const char *name)
{
unsigned int i;
@@ -273,13 +274,13 @@ rte_bbdev_get_named_dev(const char *name)
return NULL;
}
-uint16_t
+uint16_t __rte_experimental
rte_bbdev_count(void)
{
return num_devs;
}
-bool
+bool __rte_experimental
rte_bbdev_is_valid(uint16_t dev_id)
{
if ((dev_id < RTE_BBDEV_MAX_DEVS) &&
@@ -288,7 +289,7 @@ rte_bbdev_is_valid(uint16_t dev_id)
return false;
}
-uint16_t
+uint16_t __rte_experimental
rte_bbdev_find_next(uint16_t dev_id)
{
dev_id++;
@@ -298,7 +299,7 @@ rte_bbdev_find_next(uint16_t dev_id)
return dev_id;
}
-int
+int __rte_experimental
rte_bbdev_setup_queues(uint16_t dev_id, uint16_t num_queues, int socket_id)
{
unsigned int i;
@@ -388,7 +389,7 @@ error:
return ret;
}
-int
+int __rte_experimental
rte_bbdev_intr_enable(uint16_t dev_id)
{
int ret;
@@ -420,7 +421,7 @@ rte_bbdev_intr_enable(uint16_t dev_id)
return -ENOTSUP;
}
-int
+int __rte_experimental
rte_bbdev_queue_configure(uint16_t dev_id, uint16_t queue_id,
const struct rte_bbdev_queue_conf *conf)
{
@@ -529,7 +530,7 @@ rte_bbdev_queue_configure(uint16_t dev_id, uint16_t queue_id,
return 0;
}
-int
+int __rte_experimental
rte_bbdev_start(uint16_t dev_id)
{
int i;
@@ -561,7 +562,7 @@ rte_bbdev_start(uint16_t dev_id)
return 0;
}
-int
+int __rte_experimental
rte_bbdev_stop(uint16_t dev_id)
{
struct rte_bbdev *dev = get_dev(dev_id);
@@ -582,7 +583,7 @@ rte_bbdev_stop(uint16_t dev_id)
return 0;
}
-int
+int __rte_experimental
rte_bbdev_close(uint16_t dev_id)
{
int ret;
@@ -627,7 +628,7 @@ rte_bbdev_close(uint16_t dev_id)
return 0;
}
-int
+int __rte_experimental
rte_bbdev_queue_start(uint16_t dev_id, uint16_t queue_id)
{
struct rte_bbdev *dev = get_dev(dev_id);
@@ -657,7 +658,7 @@ rte_bbdev_queue_start(uint16_t dev_id, uint16_t queue_id)
return 0;
}
-int
+int __rte_experimental
rte_bbdev_queue_stop(uint16_t dev_id, uint16_t queue_id)
{
struct rte_bbdev *dev = get_dev(dev_id);
@@ -717,7 +718,7 @@ reset_stats_in_queues(struct rte_bbdev *dev)
rte_bbdev_log_debug("Reset stats on %u", dev->data->dev_id);
}
-int
+int __rte_experimental
rte_bbdev_stats_get(uint16_t dev_id, struct rte_bbdev_stats *stats)
{
struct rte_bbdev *dev = get_dev(dev_id);
@@ -740,7 +741,7 @@ rte_bbdev_stats_get(uint16_t dev_id, struct rte_bbdev_stats *stats)
return 0;
}
-int
+int __rte_experimental
rte_bbdev_stats_reset(uint16_t dev_id)
{
struct rte_bbdev *dev = get_dev(dev_id);
@@ -757,7 +758,7 @@ rte_bbdev_stats_reset(uint16_t dev_id)
return 0;
}
-int
+int __rte_experimental
rte_bbdev_info_get(uint16_t dev_id, struct rte_bbdev_info *dev_info)
{
struct rte_bbdev *dev = get_dev(dev_id);
@@ -785,7 +786,7 @@ rte_bbdev_info_get(uint16_t dev_id, struct rte_bbdev_info *dev_info)
return 0;
}
-int
+int __rte_experimental
rte_bbdev_queue_info_get(uint16_t dev_id, uint16_t queue_id,
struct rte_bbdev_queue_info *queue_info)
{
@@ -850,7 +851,7 @@ bbdev_op_init(struct rte_mempool *mempool, void *arg, void *element,
}
}
-struct rte_mempool *
+struct rte_mempool * __rte_experimental
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)
@@ -897,7 +898,7 @@ rte_bbdev_op_pool_create(const char *name, enum rte_bbdev_op_type type,
return mp;
}
-int
+int __rte_experimental
rte_bbdev_callback_register(uint16_t dev_id, enum rte_bbdev_event_type event,
rte_bbdev_cb_fn cb_fn, void *cb_arg)
{
@@ -942,7 +943,7 @@ rte_bbdev_callback_register(uint16_t dev_id, enum rte_bbdev_event_type event,
return (user_cb == NULL) ? -ENOMEM : 0;
}
-int
+int __rte_experimental
rte_bbdev_callback_unregister(uint16_t dev_id, enum rte_bbdev_event_type event,
rte_bbdev_cb_fn cb_fn, void *cb_arg)
{
@@ -987,7 +988,7 @@ rte_bbdev_callback_unregister(uint16_t dev_id, enum rte_bbdev_event_type event,
return ret;
}
-void
+void __rte_experimental
rte_bbdev_pmd_callback_process(struct rte_bbdev *dev,
enum rte_bbdev_event_type event, void *ret_param)
{
@@ -1029,7 +1030,7 @@ rte_bbdev_pmd_callback_process(struct rte_bbdev *dev,
rte_spinlock_unlock(&rte_bbdev_cb_lock);
}
-int
+int __rte_experimental
rte_bbdev_queue_intr_enable(uint16_t dev_id, uint16_t queue_id)
{
struct rte_bbdev *dev = get_dev(dev_id);
@@ -1040,7 +1041,7 @@ rte_bbdev_queue_intr_enable(uint16_t dev_id, uint16_t queue_id)
return dev->dev_ops->queue_intr_enable(dev, queue_id);
}
-int
+int __rte_experimental
rte_bbdev_queue_intr_disable(uint16_t dev_id, uint16_t queue_id)
{
struct rte_bbdev *dev = get_dev(dev_id);
@@ -1051,7 +1052,7 @@ rte_bbdev_queue_intr_disable(uint16_t dev_id, uint16_t queue_id)
return dev->dev_ops->queue_intr_disable(dev, queue_id);
}
-int
+int __rte_experimental
rte_bbdev_queue_intr_ctl(uint16_t dev_id, uint16_t queue_id, int epfd, int op,
void *data)
{
@@ -1088,7 +1089,7 @@ rte_bbdev_queue_intr_ctl(uint16_t dev_id, uint16_t queue_id, int epfd, int op,
}
-const char *
+const char * __rte_experimental
rte_bbdev_op_type_str(enum rte_bbdev_op_type op_type)
{
static const char * const op_types[] = {
diff --git a/lib/librte_bbdev/rte_bbdev.h b/lib/librte_bbdev/rte_bbdev.h
index 37a0d05..767a1e1 100644
--- a/lib/librte_bbdev/rte_bbdev.h
+++ b/lib/librte_bbdev/rte_bbdev.h
@@ -31,6 +31,7 @@ extern "C" {
#include <stdbool.h>
#include <string.h>
+#include <rte_compat.h>
#include <rte_atomic.h>
#include <rte_bus.h>
#include <rte_cpuflags.h>
@@ -54,7 +55,7 @@ enum rte_bbdev_state {
* @return
* The total number of usable devices.
*/
-uint16_t
+uint16_t __rte_experimental
rte_bbdev_count(void);
/**
@@ -66,7 +67,7 @@ rte_bbdev_count(void);
* @return
* true if device ID is valid and device is attached, false otherwise.
*/
-bool
+bool __rte_experimental
rte_bbdev_is_valid(uint16_t dev_id);
/**
@@ -79,7 +80,7 @@ rte_bbdev_is_valid(uint16_t dev_id);
* - The next device, or
* - RTE_BBDEV_MAX_DEVS if none found
*/
-uint16_t
+uint16_t __rte_experimental
rte_bbdev_find_next(uint16_t dev_id);
/** Iterate through all enabled devices */
@@ -108,7 +109,7 @@ rte_bbdev_find_next(uint16_t dev_id);
* - -EBUSY if the identified device has already started
* - -ENOMEM if unable to allocate memory
*/
-int
+int __rte_experimental
rte_bbdev_setup_queues(uint16_t dev_id, uint16_t num_queues, int socket_id);
/**
@@ -125,7 +126,7 @@ 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
*/
-int
+int __rte_experimental
rte_bbdev_intr_enable(uint16_t dev_id);
/** Device queue configuration structure */
@@ -154,7 +155,7 @@ 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
*/
-int
+int __rte_experimental
rte_bbdev_queue_configure(uint16_t dev_id, uint16_t queue_id,
const struct rte_bbdev_queue_conf *conf);
@@ -169,7 +170,7 @@ rte_bbdev_queue_configure(uint16_t dev_id, uint16_t queue_id,
* - 0 on success
* - negative value on failure - as returned from PMD driver
*/
-int
+int __rte_experimental
rte_bbdev_start(uint16_t dev_id);
/**
@@ -182,7 +183,7 @@ rte_bbdev_start(uint16_t dev_id);
* @return
* - 0 on success
*/
-int
+int __rte_experimental
rte_bbdev_stop(uint16_t dev_id);
/**
@@ -195,7 +196,7 @@ rte_bbdev_stop(uint16_t dev_id);
* @return
* - 0 on success
*/
-int
+int __rte_experimental
rte_bbdev_close(uint16_t dev_id);
/**
@@ -212,7 +213,7 @@ rte_bbdev_close(uint16_t dev_id);
* - 0 on success
* - negative value on failure - as returned from PMD driver
*/
-int
+int __rte_experimental
rte_bbdev_queue_start(uint16_t dev_id, uint16_t queue_id);
/**
@@ -227,7 +228,7 @@ rte_bbdev_queue_start(uint16_t dev_id, uint16_t queue_id);
* - 0 on success
* - negative value on failure - as returned from PMD driver
*/
-int
+int __rte_experimental
rte_bbdev_queue_stop(uint16_t dev_id, uint16_t queue_id);
/** Device statistics. */
@@ -253,7 +254,7 @@ struct rte_bbdev_stats {
* - 0 on success
* - EINVAL if invalid parameter pointer is provided
*/
-int
+int __rte_experimental
rte_bbdev_stats_get(uint16_t dev_id, struct rte_bbdev_stats *stats);
/**
@@ -264,7 +265,7 @@ rte_bbdev_stats_get(uint16_t dev_id, struct rte_bbdev_stats *stats);
* @return
* - 0 on success
*/
-int
+int __rte_experimental
rte_bbdev_stats_reset(uint16_t dev_id);
/** Device information supplied by the device's driver */
@@ -322,7 +323,7 @@ struct rte_bbdev_info {
* - 0 on success
* - EINVAL if invalid parameter pointer is provided
*/
-int
+int __rte_experimental
rte_bbdev_info_get(uint16_t dev_id, struct rte_bbdev_info *dev_info);
/** Queue information */
@@ -348,7 +349,7 @@ struct rte_bbdev_queue_info {
* - 0 on success
* - EINVAL if invalid parameter pointer is provided
*/
-int
+int __rte_experimental
rte_bbdev_queue_info_get(uint16_t dev_id, uint16_t queue_id,
struct rte_bbdev_queue_info *queue_info);
@@ -618,7 +619,7 @@ typedef void (*rte_bbdev_cb_fn)(uint16_t dev_id,
* @return
* Zero on success, negative value on failure.
*/
-int
+int __rte_experimental
rte_bbdev_callback_register(uint16_t dev_id, enum rte_bbdev_event_type event,
rte_bbdev_cb_fn cb_fn, void *cb_arg);
@@ -641,7 +642,7 @@ 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
*/
-int
+int __rte_experimental
rte_bbdev_callback_unregister(uint16_t dev_id, enum rte_bbdev_event_type event,
rte_bbdev_cb_fn cb_fn, void *cb_arg);
@@ -661,7 +662,7 @@ 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
*/
-int
+int __rte_experimental
rte_bbdev_queue_intr_enable(uint16_t dev_id, uint16_t queue_id);
/**
@@ -677,7 +678,7 @@ 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
*/
-int
+int __rte_experimental
rte_bbdev_queue_intr_disable(uint16_t dev_id, uint16_t queue_id);
/**
@@ -704,7 +705,7 @@ 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
*/
-int
+int __rte_experimental
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_pmd.h b/lib/librte_bbdev/rte_bbdev_pmd.h
index 7d1b240..db9a04c 100644
--- a/lib/librte_bbdev/rte_bbdev_pmd.h
+++ b/lib/librte_bbdev/rte_bbdev_pmd.h
@@ -43,7 +43,7 @@ extern "C" {
* @return
* - Slot in the rte_bbdev array for a new device;
*/
-struct rte_bbdev *
+struct rte_bbdev * __rte_experimental
rte_bbdev_allocate(const char *name);
/**
@@ -55,7 +55,7 @@ rte_bbdev_allocate(const char *name);
* @return
* - 0 on success, negative on error
*/
-int
+int __rte_experimental
rte_bbdev_release(struct rte_bbdev *bbdev);
/**
@@ -69,7 +69,7 @@ rte_bbdev_release(struct rte_bbdev *bbdev);
* - NULL otherwise
*
*/
-struct rte_bbdev *
+struct rte_bbdev * __rte_experimental
rte_bbdev_get_named_dev(const char *name);
/**
@@ -187,7 +187,7 @@ struct rte_bbdev_ops {
* @param ret_param
* To pass data back to user application.
*/
-void
+void __rte_experimental
rte_bbdev_pmd_callback_process(struct rte_bbdev *dev,
enum rte_bbdev_event_type event, void *ret_param);