From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by dpdk.org (Postfix) with ESMTP id DA445B62 for ; Fri, 26 Apr 2019 18:34:32 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga006.jf.intel.com ([10.7.209.51]) by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 26 Apr 2019 09:34:31 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.60,398,1549958400"; d="scan'208";a="139099401" Received: from unknown (HELO broadwell-dev-4.localdomain) ([10.224.122.193]) by orsmga006.jf.intel.com with ESMTP; 26 Apr 2019 09:34:29 -0700 From: Nikhil Rao To: thomas@monjalon.net Cc: dev@dpdk.org, Nikhil Rao , jerinj@marvell.com Date: Fri, 26 Apr 2019 22:03:36 +0530 Message-Id: <1556296416-38785-1-git-send-email-nikhil.rao@intel.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1555998614-35566-1-git-send-email-nikhil.rao@intel.com> References: <1555998614-35566-1-git-send-email-nikhil.rao@intel.com> Subject: [dpdk-dev] [PATCH v4] eventdev: add experimental tag back 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: , X-List-Received-Date: Fri, 26 Apr 2019 16:34:33 -0000 Add the experimental tag back to the Rx event adapter callback, the Rx event callback register and the Rx event adapter statistics retrieval functions due to an API change to be proposed in a future patch. This patch also adds the experimental tag to these function definitions and adds the functions to the EXPERIMENTAL section of the map file, these were missing previously. Fixes: 80bdf91dc8ee ("eventdev: promote adapter functions as stable") Cc: jerinj@marvell.com Signed-off-by: Nikhil Rao --- v4: * move rte_event_eth_rx_adapter_cb_register to the experimental section of the map file * add EXPERIMENTAL to the MAINTAINERS file v3: * add experimental tag to the Rx event adapter stats retrieval function v2: * add patch explanation to commit message lib/librte_eventdev/rte_event_eth_rx_adapter.h | 17 +++++++++++++++-- lib/librte_eventdev/rte_event_eth_rx_adapter.c | 11 ++++++----- lib/librte_eventdev/rte_eventdev_version.map | 9 +++++++-- MAINTAINERS | 2 +- 4 files changed, 29 insertions(+), 10 deletions(-) diff --git a/lib/librte_eventdev/rte_event_eth_rx_adapter.h b/lib/librte_eventdev/rte_event_eth_rx_adapter.h index cf23cde..176f8ca 100644 --- a/lib/librte_eventdev/rte_event_eth_rx_adapter.h +++ b/lib/librte_eventdev/rte_event_eth_rx_adapter.h @@ -173,6 +173,9 @@ struct rte_event_eth_rx_adapter_queue_conf { }; /** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * * A structure used to retrieve statistics for an eth rx adapter instance. */ struct rte_event_eth_rx_adapter_stats { @@ -201,6 +204,9 @@ struct rte_event_eth_rx_adapter_stats { }; /** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * * Callback function invoked by the SW adapter before it continues * to process packets. The callback is passed the size of the enqueue * buffer in the SW adapter and the occupancy of the buffer. The @@ -392,6 +398,9 @@ int rte_event_eth_rx_adapter_queue_del(uint8_t id, uint16_t eth_dev_id, int rte_event_eth_rx_adapter_stop(uint8_t id); /** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * * Retrieve statistics for an adapter * * @param id @@ -404,7 +413,8 @@ int rte_event_eth_rx_adapter_queue_del(uint8_t id, uint16_t eth_dev_id, * - 0: Success, retrieved successfully. * - <0: Error code on failure. */ -int rte_event_eth_rx_adapter_stats_get(uint8_t id, +int __rte_experimental +rte_event_eth_rx_adapter_stats_get(uint8_t id, struct rte_event_eth_rx_adapter_stats *stats); /** @@ -437,6 +447,9 @@ int rte_event_eth_rx_adapter_stats_get(uint8_t id, int rte_event_eth_rx_adapter_service_id_get(uint8_t id, uint32_t *service_id); /** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * * Register callback to process Rx packets, this is supported for * SW based packet transfers. * @see rte_event_eth_rx_cb_fn @@ -453,7 +466,7 @@ int rte_event_eth_rx_adapter_stats_get(uint8_t id, * - 0: Success * - <0: Error code on failure. */ -int +int __rte_experimental 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_eventdev/rte_event_eth_rx_adapter.c b/lib/librte_eventdev/rte_event_eth_rx_adapter.c index 8d178be..27e0fe7 100644 --- a/lib/librte_eventdev/rte_event_eth_rx_adapter.c +++ b/lib/librte_eventdev/rte_event_eth_rx_adapter.c @@ -2296,7 +2296,7 @@ static int rxa_sw_add(struct rte_event_eth_rx_adapter *rx_adapter, return rxa_ctrl(id, 0); } -int +int __rte_experimental rte_event_eth_rx_adapter_stats_get(uint8_t id, struct rte_event_eth_rx_adapter_stats *stats) { @@ -2383,10 +2383,11 @@ static int rxa_sw_add(struct rte_event_eth_rx_adapter *rx_adapter, return rx_adapter->service_inited ? 0 : -ESRCH; } -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, - void *cb_arg) +int __rte_experimental +rte_event_eth_rx_adapter_cb_register(uint8_t id, + uint16_t eth_dev_id, + rte_event_eth_rx_adapter_cb_fn cb_fn, + void *cb_arg) { struct rte_event_eth_rx_adapter *rx_adapter; struct eth_device_info *dev_info; diff --git a/lib/librte_eventdev/rte_eventdev_version.map b/lib/librte_eventdev/rte_eventdev_version.map index 88c3ce5..95fd089 100644 --- a/lib/librte_eventdev/rte_eventdev_version.map +++ b/lib/librte_eventdev/rte_eventdev_version.map @@ -63,7 +63,6 @@ DPDK_17.11 { rte_event_eth_rx_adapter_queue_del; rte_event_eth_rx_adapter_service_id_get; rte_event_eth_rx_adapter_start; - rte_event_eth_rx_adapter_stats_get; rte_event_eth_rx_adapter_stats_reset; rte_event_eth_rx_adapter_stop; } DPDK_17.08; @@ -95,7 +94,6 @@ DPDK_19.05 { rte_event_crypto_adapter_stats_get; rte_event_crypto_adapter_stats_reset; rte_event_crypto_adapter_stop; - rte_event_eth_rx_adapter_cb_register; rte_event_port_unlinks_in_progress; rte_event_eth_tx_adapter_caps_get; rte_event_eth_tx_adapter_create; @@ -124,3 +122,10 @@ DPDK_19.05 { rte_event_timer_arm_tmo_tick_burst; rte_event_timer_cancel_burst; } DPDK_18.05; + +EXPERIMENTAL { + global: + + rte_event_eth_rx_adapter_cb_register; + rte_event_eth_rx_adapter_stats_get; +}; diff --git a/MAINTAINERS b/MAINTAINERS index 4493aa6..59192bc 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -398,7 +398,7 @@ F: lib/librte_eventdev/ F: drivers/event/skeleton/ F: app/test/test_eventdev.c -Eventdev Ethdev Rx Adapter API +Eventdev Ethdev Rx Adapter API - EXPERIMENTAL M: Nikhil Rao T: git://dpdk.org/next/dpdk-next-eventdev F: lib/librte_eventdev/*eth_rx_adapter* -- 1.8.3.1 From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by dpdk.space (Postfix) with ESMTP id 2E0D7A05D3 for ; Fri, 26 Apr 2019 18:34:35 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 6CC9A1B70B; Fri, 26 Apr 2019 18:34:34 +0200 (CEST) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by dpdk.org (Postfix) with ESMTP id DA445B62 for ; Fri, 26 Apr 2019 18:34:32 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga006.jf.intel.com ([10.7.209.51]) by fmsmga102.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 26 Apr 2019 09:34:31 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.60,398,1549958400"; d="scan'208";a="139099401" Received: from unknown (HELO broadwell-dev-4.localdomain) ([10.224.122.193]) by orsmga006.jf.intel.com with ESMTP; 26 Apr 2019 09:34:29 -0700 From: Nikhil Rao To: thomas@monjalon.net Cc: dev@dpdk.org, Nikhil Rao , jerinj@marvell.com Date: Fri, 26 Apr 2019 22:03:36 +0530 Message-Id: <1556296416-38785-1-git-send-email-nikhil.rao@intel.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1555998614-35566-1-git-send-email-nikhil.rao@intel.com> References: <1555998614-35566-1-git-send-email-nikhil.rao@intel.com> Subject: [dpdk-dev] [PATCH v4] eventdev: add experimental tag back 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" Content-Type: text/plain; charset="UTF-8" Message-ID: <20190426163336.VEqbmCQL2l2Zr4aT0G0rP-GPG435qzDajYWFJWtXdP8@z> Add the experimental tag back to the Rx event adapter callback, the Rx event callback register and the Rx event adapter statistics retrieval functions due to an API change to be proposed in a future patch. This patch also adds the experimental tag to these function definitions and adds the functions to the EXPERIMENTAL section of the map file, these were missing previously. Fixes: 80bdf91dc8ee ("eventdev: promote adapter functions as stable") Cc: jerinj@marvell.com Signed-off-by: Nikhil Rao --- v4: * move rte_event_eth_rx_adapter_cb_register to the experimental section of the map file * add EXPERIMENTAL to the MAINTAINERS file v3: * add experimental tag to the Rx event adapter stats retrieval function v2: * add patch explanation to commit message lib/librte_eventdev/rte_event_eth_rx_adapter.h | 17 +++++++++++++++-- lib/librte_eventdev/rte_event_eth_rx_adapter.c | 11 ++++++----- lib/librte_eventdev/rte_eventdev_version.map | 9 +++++++-- MAINTAINERS | 2 +- 4 files changed, 29 insertions(+), 10 deletions(-) diff --git a/lib/librte_eventdev/rte_event_eth_rx_adapter.h b/lib/librte_eventdev/rte_event_eth_rx_adapter.h index cf23cde..176f8ca 100644 --- a/lib/librte_eventdev/rte_event_eth_rx_adapter.h +++ b/lib/librte_eventdev/rte_event_eth_rx_adapter.h @@ -173,6 +173,9 @@ struct rte_event_eth_rx_adapter_queue_conf { }; /** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * * A structure used to retrieve statistics for an eth rx adapter instance. */ struct rte_event_eth_rx_adapter_stats { @@ -201,6 +204,9 @@ struct rte_event_eth_rx_adapter_stats { }; /** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * * Callback function invoked by the SW adapter before it continues * to process packets. The callback is passed the size of the enqueue * buffer in the SW adapter and the occupancy of the buffer. The @@ -392,6 +398,9 @@ int rte_event_eth_rx_adapter_queue_del(uint8_t id, uint16_t eth_dev_id, int rte_event_eth_rx_adapter_stop(uint8_t id); /** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * * Retrieve statistics for an adapter * * @param id @@ -404,7 +413,8 @@ int rte_event_eth_rx_adapter_queue_del(uint8_t id, uint16_t eth_dev_id, * - 0: Success, retrieved successfully. * - <0: Error code on failure. */ -int rte_event_eth_rx_adapter_stats_get(uint8_t id, +int __rte_experimental +rte_event_eth_rx_adapter_stats_get(uint8_t id, struct rte_event_eth_rx_adapter_stats *stats); /** @@ -437,6 +447,9 @@ int rte_event_eth_rx_adapter_stats_get(uint8_t id, int rte_event_eth_rx_adapter_service_id_get(uint8_t id, uint32_t *service_id); /** + * @warning + * @b EXPERIMENTAL: this API may change without prior notice + * * Register callback to process Rx packets, this is supported for * SW based packet transfers. * @see rte_event_eth_rx_cb_fn @@ -453,7 +466,7 @@ int rte_event_eth_rx_adapter_stats_get(uint8_t id, * - 0: Success * - <0: Error code on failure. */ -int +int __rte_experimental 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_eventdev/rte_event_eth_rx_adapter.c b/lib/librte_eventdev/rte_event_eth_rx_adapter.c index 8d178be..27e0fe7 100644 --- a/lib/librte_eventdev/rte_event_eth_rx_adapter.c +++ b/lib/librte_eventdev/rte_event_eth_rx_adapter.c @@ -2296,7 +2296,7 @@ static int rxa_sw_add(struct rte_event_eth_rx_adapter *rx_adapter, return rxa_ctrl(id, 0); } -int +int __rte_experimental rte_event_eth_rx_adapter_stats_get(uint8_t id, struct rte_event_eth_rx_adapter_stats *stats) { @@ -2383,10 +2383,11 @@ static int rxa_sw_add(struct rte_event_eth_rx_adapter *rx_adapter, return rx_adapter->service_inited ? 0 : -ESRCH; } -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, - void *cb_arg) +int __rte_experimental +rte_event_eth_rx_adapter_cb_register(uint8_t id, + uint16_t eth_dev_id, + rte_event_eth_rx_adapter_cb_fn cb_fn, + void *cb_arg) { struct rte_event_eth_rx_adapter *rx_adapter; struct eth_device_info *dev_info; diff --git a/lib/librte_eventdev/rte_eventdev_version.map b/lib/librte_eventdev/rte_eventdev_version.map index 88c3ce5..95fd089 100644 --- a/lib/librte_eventdev/rte_eventdev_version.map +++ b/lib/librte_eventdev/rte_eventdev_version.map @@ -63,7 +63,6 @@ DPDK_17.11 { rte_event_eth_rx_adapter_queue_del; rte_event_eth_rx_adapter_service_id_get; rte_event_eth_rx_adapter_start; - rte_event_eth_rx_adapter_stats_get; rte_event_eth_rx_adapter_stats_reset; rte_event_eth_rx_adapter_stop; } DPDK_17.08; @@ -95,7 +94,6 @@ DPDK_19.05 { rte_event_crypto_adapter_stats_get; rte_event_crypto_adapter_stats_reset; rte_event_crypto_adapter_stop; - rte_event_eth_rx_adapter_cb_register; rte_event_port_unlinks_in_progress; rte_event_eth_tx_adapter_caps_get; rte_event_eth_tx_adapter_create; @@ -124,3 +122,10 @@ DPDK_19.05 { rte_event_timer_arm_tmo_tick_burst; rte_event_timer_cancel_burst; } DPDK_18.05; + +EXPERIMENTAL { + global: + + rte_event_eth_rx_adapter_cb_register; + rte_event_eth_rx_adapter_stats_get; +}; diff --git a/MAINTAINERS b/MAINTAINERS index 4493aa6..59192bc 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -398,7 +398,7 @@ F: lib/librte_eventdev/ F: drivers/event/skeleton/ F: app/test/test_eventdev.c -Eventdev Ethdev Rx Adapter API +Eventdev Ethdev Rx Adapter API - EXPERIMENTAL M: Nikhil Rao T: git://dpdk.org/next/dpdk-next-eventdev F: lib/librte_eventdev/*eth_rx_adapter* -- 1.8.3.1