From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 ; Fri, 20 Oct 2023 22:58:33 +0200 (CEST) Received: by mail-pl1-f172.google.com with SMTP id d9443c01a7336-1c0ecb9a075so10062575ad.2 for ; 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 To: dev@dpdk.org Cc: Stephen Hemminger , Ori Kam 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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 --- 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