From: Stephen Hemminger <stephen@networkplumber.org>
To: dev@dpdk.org
Cc: Stephen Hemminger <stephen@networkplumber.org>
Subject: [PATCH v2 02/14] eal: mark rte_dev API's as stable
Date: Fri, 20 Oct 2023 14:41:07 -0700 [thread overview]
Message-ID: <20231020214119.255491-3-stephen@networkplumber.org> (raw)
In-Reply-To: <20231020214119.255491-1-stephen@networkplumber.org>
These have been around since 2020.
Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
---
lib/eal/include/rte_dev.h | 32 --------------------------------
lib/eal/version.map | 28 +++++++++++-----------------
2 files changed, 11 insertions(+), 49 deletions(-)
diff --git a/lib/eal/include/rte_dev.h b/lib/eal/include/rte_dev.h
index 8568535ac04b..86ef2f54235d 100644
--- a/lib/eal/include/rte_dev.h
+++ b/lib/eal/include/rte_dev.h
@@ -341,7 +341,6 @@ typedef void *(*rte_dev_iterate_t)(const void *start,
* 0 on successful initialization.
* <0 on error.
*/
-__rte_experimental
int
rte_dev_iterator_init(struct rte_dev_iterator *it, const char *str);
@@ -361,7 +360,6 @@ rte_dev_iterator_init(struct rte_dev_iterator *it, const char *str);
* NULL if an error occurred (rte_errno is set).
* NULL if no device could be found (rte_errno is not set).
*/
-__rte_experimental
struct rte_device *
rte_dev_iterator_next(struct rte_dev_iterator *it);
@@ -372,9 +370,6 @@ rte_dev_iterator_next(struct rte_dev_iterator *it);
dev = rte_dev_iterator_next(it))
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* It registers the callback for the specific device.
* Multiple callbacks can be registered at the same time.
*
@@ -390,16 +385,12 @@ rte_dev_iterator_next(struct rte_dev_iterator *it);
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental
int
rte_dev_event_callback_register(const char *device_name,
rte_dev_event_cb_fn cb_fn,
void *cb_arg);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* It unregisters the callback according to the specified device.
*
* @param device_name
@@ -415,16 +406,12 @@ 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_dev_event_callback_unregister(const char *device_name,
rte_dev_event_cb_fn cb_fn,
void *cb_arg);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Executes all the user application registered callbacks for
* the specific device.
*
@@ -433,64 +420,47 @@ rte_dev_event_callback_unregister(const char *device_name,
* @param event
* the device event type.
*/
-__rte_experimental
void
rte_dev_event_callback_process(const char *device_name,
enum rte_dev_event_type event);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Start the device event monitoring.
*
* @return
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental
int
rte_dev_event_monitor_start(void);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Stop the device event monitoring.
*
* @return
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental
int
rte_dev_event_monitor_stop(void);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Enable hotplug handling for devices.
*
* @return
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental
int
rte_dev_hotplug_handle_enable(void);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice
- *
* Disable hotplug handling for devices.
*
* @return
* - On success, zero.
* - On failure, a negative value.
*/
-__rte_experimental
int
rte_dev_hotplug_handle_disable(void);
@@ -514,7 +484,6 @@ rte_dev_hotplug_handle_disable(void);
* 0 if mapping was successful.
* Negative value and rte_errno is set otherwise.
*/
-__rte_experimental
int
rte_dev_dma_map(struct rte_device *dev, void *addr, uint64_t iova, size_t len);
@@ -538,7 +507,6 @@ 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_dev_dma_unmap(struct rte_device *dev, void *addr, uint64_t iova,
size_t len);
diff --git a/lib/eal/version.map b/lib/eal/version.map
index e00a844805bb..01ff887358fa 100644
--- a/lib/eal/version.map
+++ b/lib/eal/version.map
@@ -28,8 +28,19 @@ DPDK_24 {
rte_dev_bus;
rte_dev_bus_info;
rte_dev_devargs;
+ rte_dev_dma_map;
+ rte_dev_dma_unmap;
rte_dev_driver;
+ rte_dev_event_callback_process;
+ rte_dev_event_callback_register;
+ rte_dev_event_callback_unregister;
+ rte_dev_event_monitor_start;
+ rte_dev_event_monitor_stop;
+ rte_dev_hotplug_handle_disable;
+ rte_dev_hotplug_handle_enable;
rte_dev_is_probed;
+ rte_dev_iterator_init;
+ rte_dev_iterator_next;
rte_dev_name;
rte_dev_numa_node;
rte_dev_probe;
@@ -309,28 +320,11 @@ DPDK_24 {
EXPERIMENTAL {
global:
- # added in 18.05
- rte_dev_event_callback_register;
- rte_dev_event_callback_unregister;
- rte_dev_event_monitor_start;
- rte_dev_event_monitor_stop;
-
# added in 18.08
rte_class_find;
rte_class_find_by_name;
rte_class_register;
rte_class_unregister;
- rte_dev_iterator_init;
- rte_dev_iterator_next;
-
- # added in 18.11
- rte_dev_event_callback_process;
- rte_dev_hotplug_handle_disable;
- rte_dev_hotplug_handle_enable;
-
- # added in 19.05
- rte_dev_dma_map;
- rte_dev_dma_unmap;
# added in 20.05
__rte_eal_trace_generic_double;
--
2.39.2
next prev parent reply other threads:[~2023-10-20 21:41 UTC|newest]
Thread overview: 47+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-08-09 16:42 [PATCH 00/15] eal: mark older API's stable Stephen Hemminger
2023-08-09 16:42 ` [PATCH 01/15] eal: make bitops a stable API Stephen Hemminger
2023-08-09 17:58 ` Tyler Retzlaff
2023-08-09 20:07 ` Stephen Hemminger
2023-08-09 21:59 ` Tyler Retzlaff
2023-08-09 16:42 ` [PATCH 02/15] eal: mark rte_dev API's as stable Stephen Hemminger
2023-08-09 16:42 ` [PATCH 03/15] eal: make rte_class API's stable Stephen Hemminger
2023-08-09 16:42 ` [PATCH 04/15] eal: make rte_version_XXX " Stephen Hemminger
2023-08-10 8:24 ` Bruce Richardson
2023-08-09 16:42 ` [PATCH 05/15] eal: make rte_drand a stable API Stephen Hemminger
2023-08-09 16:42 ` [PATCH 06/15] eal: make rte_service_lcore_may_be_active stable Stephen Hemminger
2023-08-10 9:08 ` Van Haaren, Harry
2023-08-09 16:42 ` [PATCH 07/15] eal: make rte_devargs_reset stable Stephen Hemminger
2023-08-09 16:43 ` [PATCH 08/15] eal: make pflock API stable Stephen Hemminger
2023-08-09 16:43 ` [PATCH 09/15] eal: make seqcount and seqlock stable Stephen Hemminger
2023-08-09 19:47 ` Mattias Rönnblom
2023-08-09 16:43 ` [PATCH 10/15] eal: mark rte_intr_XXX API's as stable Stephen Hemminger
2023-08-09 16:43 ` [PATCH 11/15] eal: mark rte_atomic128_cmp_exchange " Stephen Hemminger
2023-08-09 17:50 ` Tyler Retzlaff
2023-08-09 16:43 ` [PATCH 12/15] eal: make most rte_thread API's stable Stephen Hemminger
2023-08-09 17:53 ` Tyler Retzlaff
2023-08-09 16:43 ` [PATCH 13/15] eal: mark rte_power " Stephen Hemminger
2023-08-09 16:43 ` [PATCH 14/15] eal: mark rte_eal_vfio_get_token stable Stephen Hemminger
2023-08-09 17:55 ` Tyler Retzlaff
2023-08-09 16:43 ` [PATCH 15/15] eal: mark rte_vect simd bandwidth API as stable Stephen Hemminger
2023-10-18 19:29 ` [PATCH 00/15] eal: mark older API's stable David Marchand
2023-10-20 21:41 ` [PATCH v2 00/14] eal: mark older API's as stable Stephen Hemminger
2023-10-20 21:41 ` [PATCH v2 01/14] eal: make bitops a stable API Stephen Hemminger
2023-10-23 2:31 ` Joyce Kong
2023-10-20 21:41 ` Stephen Hemminger [this message]
2023-10-20 21:41 ` [PATCH v2 03/14] eal: make rte_class API's stable Stephen Hemminger
2023-10-20 21:41 ` [PATCH v2 04/14] eal: make rte_drand a stable API Stephen Hemminger
2023-10-23 16:12 ` Mattias Rönnblom
2023-10-20 21:41 ` [PATCH v2 05/14] eal: make rte_service_lcore_may_be_active stable Stephen Hemminger
2023-10-20 21:41 ` [PATCH v2 06/14] eal: make rte_devargs_reset stable Stephen Hemminger
2023-10-20 21:41 ` [PATCH v2 07/14] eal: make pflock API stable Stephen Hemminger
2023-10-20 21:41 ` [PATCH v2 08/14] eal: make seqcount and seqlock stable Stephen Hemminger
2023-10-23 16:14 ` Mattias Rönnblom
2023-10-20 21:41 ` [PATCH v2 09/14] eal: mark rte_intr_XXX API's as stable Stephen Hemminger
2023-10-20 21:41 ` [PATCH v2 10/14] eal: mark rte_atomic128_cmp_exchange " Stephen Hemminger
2023-10-23 3:00 ` Ruifeng Wang
2023-10-20 21:41 ` [PATCH v2 11/14] eal: mark rte_power API's stable Stephen Hemminger
2023-10-20 21:41 ` [PATCH v2 12/14] eal: mark rte_eal_vfio_get_token stable Stephen Hemminger
2023-10-20 21:41 ` [PATCH v2 13/14] eal: mark rte_vect simd bandwidth API as stable Stephen Hemminger
2023-10-20 21:41 ` [PATCH v2 14/14] eal: make rte_version API's stable Stephen Hemminger
2023-10-23 9:13 ` [PATCH v2 00/14] eal: mark older API's as stable Bruce Richardson
2023-11-14 13:10 ` David Marchand
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20231020214119.255491-3-stephen@networkplumber.org \
--to=stephen@networkplumber.org \
--cc=dev@dpdk.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).