From patchwork Thu Oct 19 16:55:55 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133013 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id CE7B1431AE; Thu, 19 Oct 2023 18:59:32 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 05F5D42E7F; Thu, 19 Oct 2023 18:56:45 +0200 (CEST) Received: from mail-oo1-f50.google.com (mail-oo1-f50.google.com [209.85.161.50]) by mails.dpdk.org (Postfix) with ESMTP id 5C43942DF2 for ; Thu, 19 Oct 2023 18:56:33 +0200 (CEST) Received: by mail-oo1-f50.google.com with SMTP id 006d021491bc7-5840bb16101so215716eaf.3 for ; Thu, 19 Oct 2023 09:56:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697734592; x=1698339392; 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=H3sJaXDQxmwYHO9B7patUeRmDvFtKiz7YaLjTCRBKA1ofiMxKgeKWAhg3IqOJF6V5P 0HOk7tTDXT/FVCzhLZV1PEEsmuA2/qbIbjpCKgZLaDD6gzDL/50dN9uh61WW2ZOXbUpL keGh0i+6YarzAjurPD6IzxIc610d3VgZp5gMdL4WK20yNFfsNGlY7aTn8QhB7JmbyKy+ dQaEC8NKMTuMXSq2n/XY4UsxQfTFBMtxr+DNVfdcHrrPCVYYpXn6J31C0vmwQCxtBUXb /FiCf4pU7sGpsfrBYnQ3DpDzxghD01M3I+4PSqiQorC3KxdVLEHmW2KQEIjFg+w/0Sns RtAg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697734592; x=1698339392; 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=MhGqqMdIw9UDql+vCegIRSrEUpfI/VZchxgehCd/A1B+w+Z1JQwP9hAOSJ4n0GDG/I qTEZH2agEufiTpNpsF/GaGcEcz85V47O+swkOis7qUg08EkvmBk/g8vvhxJV1UTxHmQU NPVcvsswB9e1GY6kSPyXs2xDPcZj/2VolcrR44ubVIBoqQw4i4bILa/2ZmP8GXnvdmHh 39xaXykzrYFxs4X+1OX1Sfjo19ZaRIZgh3+CjuSKqHS65XZeJ731NiwTd6qglwiv5HaH 8b0M+F/jmpCDR+DuknrTm580pThKCFCZMmHgnkdWHttbli/vmHzo7JmD61ZAxOKuZGT6 BQzg== X-Gm-Message-State: AOJu0YxxjcpB9kXdsRItb2lpez6fGM9F0xMuqE2eWDZSiOwO3/TNrSKc +WPB5kYKnwzMUKDkUqp13uhpUvTRgBr8FHLN+zGkzQ== X-Google-Smtp-Source: AGHT+IGWbDiwJh01N9jwD5m8LypkgXESjz0bJ3Z80h6d1sMTihlBIDPM3abyxF4FdYaoWLNoHfqElg== X-Received: by 2002:a05:6358:cb27:b0:166:d4ec:f616 with SMTP id gr39-20020a056358cb2700b00166d4ecf616mr2242364rwb.4.1697734592290; Thu, 19 Oct 2023 09:56:32 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id y22-20020aa79436000000b00672ea40b8a9sm13988pfo.170.2023.10.19.09.56.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 Oct 2023 09:56:31 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Ori Kam Subject: [PATCH v3 26/29] regexdev: remove experimental tag Date: Thu, 19 Oct 2023 09:55:55 -0700 Message-Id: <20231019165559.115742-27-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231019165559.115742-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20231019165559.115742-1-stephen@networkplumber.org> MIME-Version: 1.0 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;