From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
by inbox.dpdk.org (Postfix) with ESMTP id D91C1431BE;
Fri, 20 Oct 2023 23:01:24 +0200 (CEST)
Received: from mails.dpdk.org (localhost [127.0.0.1])
by mails.dpdk.org (Postfix) with ESMTP id 18A9642E38;
Fri, 20 Oct 2023 22:58:42 +0200 (CEST)
Received: from mail-pl1-f172.google.com (mail-pl1-f172.google.com
[209.85.214.172])
by mails.dpdk.org (Postfix) with ESMTP id D3AE842DE0
for <dev@dpdk.org>; Fri, 20 Oct 2023 22:58:33 +0200 (CEST)
Received: by mail-pl1-f172.google.com with SMTP id
d9443c01a7336-1c0ecb9a075so10062575ad.2
for <dev@dpdk.org>; Fri, 20 Oct 2023 13:58:33 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697835513;
x=1698440313; darn=dpdk.org;
h=content-transfer-encoding:mime-version:references:in-reply-to
:message-id:date:subject:cc:to:from:from:to:cc:subject:date
:message-id:reply-to;
bh=oydX3GmM0T808P1CLSjGJhn0TW9xrnCOf196fWiSxbg=;
b=a2u8gJPNwQHp8Vwc9R4yJlw2xQQVz+u9b6+xFl+aw8U4+MqkLgxkVfDz4hiIzJ10ES
AwrLcslmcU8gxLdL4smlS5Y6vOAaHfXhwS4bh8fKCuIFcag3lg98xnConriEAqa/tKZb
S5ByIieJXseWIrOu8p74lQd68TJra1MslGXSldTMSeGIqc1hGkVFqNjuMKZy4XyZ1sQW
hgCykOVEj8OYR+YP1MrvNJvercqHkFuJK+Y+Sd3iXKwh2S1wLgEGg2CvvwmDFOC9mljQ
8WuoV4zMgLvjEwxdSdN+8Vy1K1PldMhOLSWxKLdOUo5s1UOZWbHSxfuv4r8XdfOyENkM
VTSQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=1e100.net; s=20230601; t=1697835513; x=1698440313;
h=content-transfer-encoding:mime-version:references:in-reply-to
:message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc
:subject:date:message-id:reply-to;
bh=oydX3GmM0T808P1CLSjGJhn0TW9xrnCOf196fWiSxbg=;
b=mz58EuW7l4ZUqGxaLKqeK+FdP01y2+1QxX/H7Q7cqgAAw9YSns2cX/DwhB9sRUXfWU
KOSySFmRA6FSXAsTsywitSL7vzdha5DENS8btNsl47qfjLN1je1kkCriY6OegdK8IRvL
yNr0BOJMux9zGAWdYsVtRWKVP456QQ+nhA2hKNS4iR2PIUHRZ8M4zMgrG81h+2QuU58i
d184hRcYf2iDr33p/KKbB15Kq0yKXj8FbAd+QsoWW+4jYq1mll82OiNfm4dmqr8HREd+
6/EGSNoS00CSayj96ZuHCxz83URTDhlXZnNb7v0Zof6jXv6Z30oGqBvjCXHA9mSvoWQt
qBnw==
X-Gm-Message-State: AOJu0YyxrShoWY8+EKuSuOexMJ2jp8R5X09Y26OCh0am1QY+1dE0ATaC
F1PzTaYd4uL2V4a56XOXGKAHJu+Kn2aNyjwOTJOhMQ==
X-Google-Smtp-Source: AGHT+IFnOTdxTUDfPtv5VcPAFL0HtN4s86DmEG7hPKbfm7j1OrT7JXGsk+P7IawoPxShIMf+5wwezg==
X-Received: by 2002:a17:902:ea0d:b0:1c3:bc2a:f6b4 with SMTP id
s13-20020a170902ea0d00b001c3bc2af6b4mr3869916plg.42.1697835512700;
Fri, 20 Oct 2023 13:58:32 -0700 (PDT)
Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68])
by smtp.gmail.com with ESMTPSA id
u17-20020a170902e5d100b001c61512f2a6sm1930961plf.220.2023.10.20.13.58.31
(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
Fri, 20 Oct 2023 13:58:32 -0700 (PDT)
From: Stephen Hemminger <stephen@networkplumber.org>
To: dev@dpdk.org
Cc: Stephen Hemminger <stephen@networkplumber.org>, Ori Kam <orika@nvidia.com>
Subject: [PATCH v5 23/26] regexdev: remove experimental tag
Date: Fri, 20 Oct 2023 13:57:56 -0700
Message-Id: <20231020205759.195126-24-stephen@networkplumber.org>
X-Mailer: git-send-email 2.39.2
In-Reply-To: <20231020205759.195126-1-stephen@networkplumber.org>
References: <20230808173527.186042-1-stephen@networkplumber.org>
<20231020205759.195126-1-stephen@networkplumber.org>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
<mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
<mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
This library was added in 22.11.
Time to make it not experimental.
Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
---
lib/regexdev/rte_regexdev.h | 92 -------------------------------------
lib/regexdev/version.map | 2 +-
2 files changed, 1 insertion(+), 93 deletions(-)
diff --git a/lib/regexdev/rte_regexdev.h b/lib/regexdev/rte_regexdev.h
index d50af775b551..3ea1f0c061a0 100644
--- a/lib/regexdev/rte_regexdev.h
+++ b/lib/regexdev/rte_regexdev.h
@@ -226,9 +226,6 @@ extern int rte_regexdev_logtype;
} while (0)
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Check if dev_id is ready.
*
* @param dev_id
@@ -238,27 +235,19 @@ extern int rte_regexdev_logtype;
* - 0 if device state is not in ready state.
* - 1 if device state is ready state.
*/
-__rte_experimental
int rte_regexdev_is_valid_dev(uint16_t dev_id);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Get the total number of RegEx devices that have been successfully
* initialised.
*
* @return
* The total number of usable RegEx devices.
*/
-__rte_experimental
uint8_t
rte_regexdev_count(void);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Get the device identifier for the named RegEx device.
*
* @param name
@@ -268,7 +257,6 @@ rte_regexdev_count(void);
* Returns RegEx device identifier on success.
* - <0: Failure to find named RegEx device.
*/
-__rte_experimental
int
rte_regexdev_get_dev_id(const char *name);
@@ -628,9 +616,6 @@ struct rte_regexdev_info {
};
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Retrieve the contextual information of a RegEx device.
*
* @param dev_id
@@ -644,7 +629,6 @@ struct rte_regexdev_info {
* - 0: Success, driver updates the contextual information of the RegEx device
* - <0: Error code returned by the driver info get function.
*/
-__rte_experimental
int
rte_regexdev_info_get(uint8_t dev_id, struct rte_regexdev_info *dev_info);
@@ -723,9 +707,6 @@ struct rte_regexdev_config {
};
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Configure a RegEx device.
*
* This function must be invoked first before any other function in the
@@ -743,7 +724,6 @@ struct rte_regexdev_config {
* @return
* - 0: Success, device configured. Otherwise negative errno is returned.
*/
-__rte_experimental
int
rte_regexdev_configure(uint8_t dev_id, const struct rte_regexdev_config *cfg);
@@ -782,9 +762,6 @@ struct rte_regexdev_qp_conf {
};
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Allocate and set up a RegEx queue pair for a RegEx device.
*
* @param dev_id
@@ -799,15 +776,11 @@ struct rte_regexdev_qp_conf {
* @return
* 0 on success. Otherwise negative errno is returned.
*/
-__rte_experimental
int
rte_regexdev_queue_pair_setup(uint8_t dev_id, uint16_t queue_pair_id,
const struct rte_regexdev_qp_conf *qp_conf);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Start a RegEx device.
*
* The device start step is the last one and consists of setting the RegEx
@@ -822,14 +795,10 @@ rte_regexdev_queue_pair_setup(uint8_t dev_id, uint16_t queue_pair_id,
* @return
* 0 on success. Otherwise negative errno is returned.
*/
-__rte_experimental
int
rte_regexdev_start(uint8_t dev_id);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Stop a RegEx device.
*
* Stop a RegEx device. The device can be restarted with a call to
@@ -845,14 +814,10 @@ rte_regexdev_start(uint8_t dev_id);
* @return
* 0 on success. Otherwise negative errno is returned.
*/
-__rte_experimental
int
rte_regexdev_stop(uint8_t dev_id);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Close a RegEx device. The device cannot be restarted!
*
* @param dev_id
@@ -861,7 +826,6 @@ rte_regexdev_stop(uint8_t dev_id);
* @return
* 0 on success. Otherwise negative errno is returned.
*/
-__rte_experimental
int
rte_regexdev_close(uint8_t dev_id);
@@ -897,9 +861,6 @@ enum rte_regexdev_attr_id {
};
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Get an attribute from a RegEx device.
*
* @param dev_id
@@ -915,15 +876,11 @@ enum rte_regexdev_attr_id {
* - -EINVAL: Invalid device or *attr_id* provided, or *attr_value* is NULL.
* - -ENOTSUP: if the device doesn't support specific *attr_id*.
*/
-__rte_experimental
int
rte_regexdev_attr_get(uint8_t dev_id, enum rte_regexdev_attr_id attr_id,
void *attr_value);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Set an attribute to a RegEx device.
*
* @param dev_id
@@ -939,7 +896,6 @@ rte_regexdev_attr_get(uint8_t dev_id, enum rte_regexdev_attr_id attr_id,
* - -EINVAL: Invalid device or *attr_id* provided, or *attr_value* is NULL.
* - -ENOTSUP: if the device doesn't support specific *attr_id*.
*/
-__rte_experimental
int
rte_regexdev_attr_set(uint8_t dev_id, enum rte_regexdev_attr_id attr_id,
const void *attr_value);
@@ -975,9 +931,6 @@ struct rte_regexdev_rule {
};
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Update the local rule set.
* This functions only modify the rule set in memory.
* In order for the changes to take effect, the function
@@ -1008,16 +961,12 @@ struct rte_regexdev_rule {
* @see rte_regexdev_rule_db_import(), rte_regexdev_rule_db_export(),
* rte_regexdev_rule_db_compile_activate()
*/
-__rte_experimental
int
rte_regexdev_rule_db_update(uint8_t dev_id,
const struct rte_regexdev_rule *rules,
uint32_t nb_rules);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Compile local rule set and burn the complied result to the
* RegEx device.
*
@@ -1030,14 +979,10 @@ rte_regexdev_rule_db_update(uint8_t dev_id,
* @see rte_regexdev_rule_db_import(), rte_regexdev_rule_db_export(),
* rte_regexdev_rule_db_update()
*/
-__rte_experimental
int
rte_regexdev_rule_db_compile_activate(uint8_t dev_id);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Import a prebuilt rule database from a buffer to a RegEx device.
*
* @param dev_id
@@ -1055,15 +1000,11 @@ rte_regexdev_rule_db_compile_activate(uint8_t dev_id);
*
* @see rte_regexdev_rule_db_update(), rte_regexdev_rule_db_export()
*/
-__rte_experimental
int
rte_regexdev_rule_db_import(uint8_t dev_id, const char *rule_db,
uint32_t rule_db_len);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Export the prebuilt rule database from a RegEx device to the buffer.
*
* @param dev_id
@@ -1080,7 +1021,6 @@ rte_regexdev_rule_db_import(uint8_t dev_id, const char *rule_db,
*
* @see rte_regexdev_rule_db_update(), rte_regexdev_rule_db_import()
*/
-__rte_experimental
int
rte_regexdev_rule_db_export(uint8_t dev_id, char *rule_db);
@@ -1102,9 +1042,6 @@ struct rte_regexdev_xstats_map {
};
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Retrieve names of extended statistics of a regex device.
*
* @param dev_id
@@ -1120,15 +1057,11 @@ struct rte_regexdev_xstats_map {
* -ENODEV for invalid *dev_id*
* -ENOTSUP if the device doesn't support this function.
*/
-__rte_experimental
int
rte_regexdev_xstats_names_get(uint8_t dev_id,
struct rte_regexdev_xstats_map *xstats_map);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Retrieve extended statistics of an regex device.
*
* @param dev_id
@@ -1147,15 +1080,11 @@ rte_regexdev_xstats_names_get(uint8_t dev_id,
* -ENODEV for invalid *dev_id*
* -ENOTSUP if the device doesn't support this function.
*/
-__rte_experimental
int
rte_regexdev_xstats_get(uint8_t dev_id, const uint16_t *ids,
uint64_t *values, uint16_t nb_values);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Retrieve the value of a single stat by requesting it by name.
*
* @param dev_id
@@ -1174,15 +1103,11 @@ rte_regexdev_xstats_get(uint8_t dev_id, const uint16_t *ids,
* - -EINVAL: invalid parameters
* - -ENOTSUP: if not supported.
*/
-__rte_experimental
int
rte_regexdev_xstats_by_name_get(uint8_t dev_id, const char *name,
uint16_t *id, uint64_t *value);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Reset the values of the xstats of the selected component in the device.
*
* @param dev_id
@@ -1198,15 +1123,11 @@ rte_regexdev_xstats_by_name_get(uint8_t dev_id, const char *name,
* - -EINVAL: invalid parameters.
* - -ENOTSUP: if not supported.
*/
-__rte_experimental
int
rte_regexdev_xstats_reset(uint8_t dev_id, const uint16_t *ids,
uint16_t nb_ids);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Trigger the RegEx device self test.
*
* @param dev_id
@@ -1216,14 +1137,10 @@ rte_regexdev_xstats_reset(uint8_t dev_id, const uint16_t *ids,
* - -ENOTSUP if the device doesn't support selftest.
* - other values < 0 on failure.
*/
-__rte_experimental
int
rte_regexdev_selftest(uint8_t dev_id);
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Dump internal information about *dev_id* to the FILE* provided in *f*.
*
* @param dev_id
@@ -1234,7 +1151,6 @@ rte_regexdev_selftest(uint8_t dev_id);
* @return
* 0 on success, negative errno on failure.
*/
-__rte_experimental
int
rte_regexdev_dump(uint8_t dev_id, FILE *f);
@@ -1428,9 +1344,6 @@ struct rte_regex_ops {
#include "rte_regexdev_core.h"
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Enqueue a burst of scan request on a RegEx device.
*
* The rte_regexdev_enqueue_burst() function is invoked to place
@@ -1464,7 +1377,6 @@ struct rte_regex_ops {
* remaining ops at the end of *ops* are not consumed and the caller has
* to take care of them.
*/
-__rte_experimental
static inline uint16_t
rte_regexdev_enqueue_burst(uint8_t dev_id, uint16_t qp_id,
struct rte_regex_ops **ops, uint16_t nb_ops)
@@ -1483,9 +1395,6 @@ rte_regexdev_enqueue_burst(uint8_t dev_id, uint16_t qp_id,
}
/**
- * @warning
- * @b EXPERIMENTAL: this API may change without prior notice.
- *
* Dequeue a burst of scan response from a queue on the RegEx device.
* The dequeued operation are stored in *rte_regexdev_op* structures
* whose pointers are supplied in the *ops* array.
@@ -1524,7 +1433,6 @@ rte_regexdev_enqueue_burst(uint8_t dev_id, uint16_t qp_id,
* ops at the end of *ops* are not consumed and the caller has to take care
* of them.
*/
-__rte_experimental
static inline uint16_t
rte_regexdev_dequeue_burst(uint8_t dev_id, uint16_t qp_id,
struct rte_regex_ops **ops, uint16_t nb_ops)
diff --git a/lib/regexdev/version.map b/lib/regexdev/version.map
index 3c6e9fffa1f5..914bd19dfd94 100644
--- a/lib/regexdev/version.map
+++ b/lib/regexdev/version.map
@@ -1,4 +1,4 @@
-EXPERIMENTAL {
+DPDK_24 {
global:
rte_regex_devices;
--
2.39.2