From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <stable-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
by inbox.dpdk.org (Postfix) with ESMTP id 20BA3A0557
for <public@inbox.dpdk.org>; Thu, 26 May 2022 05:25:56 +0200 (CEST)
Received: from [217.70.189.124] (localhost [127.0.0.1])
by mails.dpdk.org (Postfix) with ESMTP id 04E1C427F0;
Thu, 26 May 2022 05:25:56 +0200 (CEST)
Received: from mga05.intel.com (mga05.intel.com [192.55.52.43])
by mails.dpdk.org (Postfix) with ESMTP id 523F340146;
Thu, 26 May 2022 05:25:51 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple;
d=intel.com; i=@intel.com; q=dns/txt; s=Intel;
t=1653535551; x=1685071551;
h=from:to:cc:subject:date:message-id:in-reply-to: references;
bh=rX1xlBF8Bj4zKSKnkXIubPsQUVo2gPXA1xeg3ZSTmiQ=;
b=g/vxQf4nLXmUNIBhfqr9C0BEdjleiQUfScp3y9WZ7f4/u7AsD8Ufh4l/
GWZGv836GUyXnCPyXGGD2Lrvf4Nj7U61WZGAnFaBHDS5VFbpu/K4ZeRBU
Y246w2ZQz59WCefX0BimFxtvQpFD0cmvKHVEa3uaMDKIXa0vj7ADH4yYD
qDjPxsZb8YOY3PUGWXabqJSSriFsMNhioXH+YsAy6ZtDvWmaQ+ikXdK1a
G7oQPM/b58A4cx/2fGWWKaub3PTKvHKhxAzwft8SY4C731IiaOxFx3Kca
LG95tDkvKN3cLEU3QkUE/FxrNlrr/DmsFrniFJlnttsIZPUXt3K/G4hYG g==;
X-IronPort-AV: E=McAfee;i="6400,9594,10358"; a="360406170"
X-IronPort-AV: E=Sophos;i="5.91,252,1647327600"; d="scan'208";a="360406170"
Received: from orsmga005.jf.intel.com ([10.7.209.41])
by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;
25 May 2022 20:25:50 -0700
X-ExtLoop1: 1
X-IronPort-AV: E=Sophos;i="5.91,252,1647327600"; d="scan'208";a="746084649"
Received: from unknown (HELO zj-fpga-amt.sh.intel.com) ([10.238.175.102])
by orsmga005.jf.intel.com with ESMTP; 25 May 2022 20:25:48 -0700
From: Wei Huang <wei.huang@intel.com>
To: dev@dpdk.org, thomas@monjalon.net, nipun.gupta@nxp.com,
hemant.agrawal@nxp.com
Cc: stable@dpdk.org, rosen.xu@intel.com, tianfei.zhang@intel.com,
qi.z.zhang@intel.com, Wei Huang <wei.huang@intel.com>
Subject: [PATCH v3 1/5] raw/ifpga: remove experimental tag from ifpga APIs
Date: Wed, 25 May 2022 23:32:50 -0400
Message-Id: <1653535974-1379-2-git-send-email-wei.huang@intel.com>
X-Mailer: git-send-email 1.8.3.1
In-Reply-To: <1653535974-1379-1-git-send-email-wei.huang@intel.com>
References: <1652862549-13131-1-git-send-email-wei.huang@intel.com>
<1653535974-1379-1-git-send-email-wei.huang@intel.com>
X-BeenThere: stable@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: patches for DPDK stable branches <stable.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/stable>,
<mailto:stable-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/stable/>
List-Post: <mailto:stable@dpdk.org>
List-Help: <mailto:stable-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/stable>,
<mailto:stable-request@dpdk.org?subject=subscribe>
Errors-To: stable-bounces@dpdk.org
These APIs are introduced in DPDK 21.05 and have been tested in several
release, experimental tag can be formally removed.
Signed-off-by: Wei Huang <wei.huang@intel.com>
Acked-by: Tianfei Zhang <tianfei.zhang@intel.com>
---
drivers/raw/ifpga/rte_pmd_ifpga.h | 48 ---------------------------------------
drivers/raw/ifpga/version.map | 7 ++----
2 files changed, 2 insertions(+), 53 deletions(-)
diff --git a/drivers/raw/ifpga/rte_pmd_ifpga.h b/drivers/raw/ifpga/rte_pmd_ifpga.h
index 47d66ba..3fa5d34 100644
--- a/drivers/raw/ifpga/rte_pmd_ifpga.h
+++ b/drivers/raw/ifpga/rte_pmd_ifpga.h
@@ -68,9 +68,6 @@
} rte_pmd_ifpga_phy_info;
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get raw device ID from PCI address string like 'Domain:Bus:Dev.Func'
*
* @param pci_addr
@@ -82,14 +79,10 @@
* - (-EINVAL) if bad parameter.
* - (-ENODEV) if FPGA is not probed by ifpga driver.
*/
-__rte_experimental
int
rte_pmd_ifpga_get_dev_id(const char *pci_addr, uint16_t *dev_id);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get current RSU status of the specified Intel FPGA device
*
* @param dev_id
@@ -103,14 +96,10 @@
* - (-ENODEV) if dev_id is invalid.
* - (-ENOMEM) if share data is not initialized.
*/
-__rte_experimental
int
rte_pmd_ifpga_get_rsu_status(uint16_t dev_id, uint32_t *stat, uint32_t *prog);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Set current RSU status of the specified Intel FPGA device
*
* @param dev_id
@@ -124,14 +113,10 @@
* - (-ENODEV) if dev_id is invalid.
* - (-ENOMEM) if share data is not initialized.
*/
-__rte_experimental
int
rte_pmd_ifpga_set_rsu_status(uint16_t dev_id, uint32_t stat, uint32_t prog);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get FPGA property of specified Intel FPGA device
*
* @param dev_id
@@ -144,14 +129,10 @@
* - (-EBUSY) if FPGA is rebooting.
* - (-EIO) if failed to access hardware.
*/
-__rte_experimental
int
rte_pmd_ifpga_get_property(uint16_t dev_id, rte_pmd_ifpga_prop *prop);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get PHY information of specified Intel FPGA device
*
* @param dev_id
@@ -164,14 +145,10 @@
* - (-EBUSY) if FPGA is rebooting.
* - (-EIO) if failed to access hardware.
*/
-__rte_experimental
int
rte_pmd_ifpga_get_phy_info(uint16_t dev_id, rte_pmd_ifpga_phy_info *info);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Update image flash of specified Intel FPGA device
*
* @param dev_id
@@ -187,15 +164,11 @@
* - (-EBUSY) if FPGA is updating or rebooting.
* - (-EIO) if failed to open image file.
*/
-__rte_experimental
int
rte_pmd_ifpga_update_flash(uint16_t dev_id, const char *image,
uint64_t *status);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Stop flash update of specified Intel FPGA device
*
* @param dev_id
@@ -208,14 +181,10 @@
* - (-EINVAL) if bad parameter.
* - (-EAGAIN) if failed with force.
*/
-__rte_experimental
int
rte_pmd_ifpga_stop_update(uint16_t dev_id, int force);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Check current Intel FPGA status and change it to reboot status if it is idle
*
* @param dev_id
@@ -226,14 +195,10 @@
* - (-ENOMEM) if share data is not initialized.
* - (-EBUSY) if FPGA is updating or rebooting.
*/
-__rte_experimental
int
rte_pmd_ifpga_reboot_try(uint16_t dev_id);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Trigger full reconfiguration of specified Intel FPGA device
*
* @param dev_id
@@ -252,28 +217,20 @@
* - (-EINVAL) if bad parameter.
* - (-EBUSY) if failed to access BMC register.
*/
-__rte_experimental
int
rte_pmd_ifpga_reload(uint16_t dev_id, int type, int page);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Get PCI bus the Intel FPGA driver register to
*
* @return
* - (valid pointer) if successful.
* - (NULL) if the Intel FPGA driver is not registered to any PCI bus.
*/
-__rte_experimental
const struct rte_pci_bus *
rte_pmd_ifpga_get_pci_bus(void);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Perform PR (partial reconfiguration) on specified Intel FPGA device
*
* @param dev_id
@@ -287,17 +244,12 @@
* - (-EINVAL) if bad parameter or operation failed.
* - (-ENOMEM) if failed to allocate memory.
*/
-__rte_experimental
int
rte_pmd_ifpga_partial_reconfigure(uint16_t dev_id, int port, const char *file);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change, or be removed, without prior notice
- *
* Free software resources allocated by Intel FPGA PMD
*/
-__rte_experimental
void
rte_pmd_ifpga_cleanup(void);
diff --git a/drivers/raw/ifpga/version.map b/drivers/raw/ifpga/version.map
index a1a6be2..ff71a45 100644
--- a/drivers/raw/ifpga/version.map
+++ b/drivers/raw/ifpga/version.map
@@ -1,11 +1,6 @@
DPDK_22 {
- local: *;
-};
-
-EXPERIMENTAL {
global:
- # added in 21.05
rte_pmd_ifpga_get_dev_id;
rte_pmd_ifpga_get_rsu_status;
rte_pmd_ifpga_set_rsu_status;
@@ -18,4 +13,6 @@ EXPERIMENTAL {
rte_pmd_ifpga_get_pci_bus;
rte_pmd_ifpga_partial_reconfigure;
rte_pmd_ifpga_cleanup;
+
+ local: *;
};
--
1.8.3.1