From patchwork Thu Oct 19 16:55:32 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 132990 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 72148431AE; Thu, 19 Oct 2023 18:56:33 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id DBF93410F1; Thu, 19 Oct 2023 18:56:16 +0200 (CEST) Received: from mail-ot1-f53.google.com (mail-ot1-f53.google.com [209.85.210.53]) by mails.dpdk.org (Postfix) with ESMTP id D094240693 for ; Thu, 19 Oct 2023 18:56:12 +0200 (CEST) Received: by mail-ot1-f53.google.com with SMTP id 46e09a7af769-6ce2b6cb933so488900a34.0 for ; Thu, 19 Oct 2023 09:56:12 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697734572; x=1698339372; 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=J/FmhWWeA++34nykw+5IzU1UqtxQ8u5vqbBMK/ItbkI=; b=V/q2/U7jU+RKk7KNca2tbMIAYZYgZYrsO5RuKzUsj17nOUi3iZtfysLw7wqpW9jaLj T2MSnHSB1Lysfc9idANbDn/9K/uwJ7/5w3DZCH0EAlotxrWb7G6sTYv6QkFfZRlzT/UE 5x5UfOKo3/IKUlilCVIv0QSaTFmhkqNFVBLQLpXiKFeYkpZcr41Rb27JaSfyAVPkXuAS twVDLSU1faOncEULiewYa4jDJZRYDmFwiojnqi8AZB7pKO1/VCwtiMvIlx0JkAtn4Lr0 RdBdrzp5MhHHJdlC8BCua9ah2d3XFAq8bK2NC3r3J7EvFoMN14wwOsGRoz18WdhILEK1 2MWg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697734572; x=1698339372; 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=J/FmhWWeA++34nykw+5IzU1UqtxQ8u5vqbBMK/ItbkI=; b=hGdS4T9t5xBcn5lff5iiSM2ux8OUOgvF72xoQfwfehb1jbuv69wRrM+j5yXvkd48Va rjbcc+miQUEt6o6dtWdT0YwwaJag61D4+E09a0A4WyMXe5OdoZKri0Eaqtd2ASR8TFnh duy9UZv9Qsnvv+FWX0m7KuuxmG5E3AISqNn6BpEkhHz0+8Zl3J7eVZI+t6iGW+aiT3pW WeGVYoZVv0r/1ElS8ZPMw389Xc/quj81bB6d9ud4nVVnzvSwccT+LjW2LySzu8pldkOv UDxZ4L1pGVGqSnJyHQ5YWudA/ibhk+VXghIAFTolWABwQSBFvc40hG7yn3u+s2fgpgMP zt1A== X-Gm-Message-State: AOJu0YzutSYf88js3O4VrfWtpWhhZg8dIdn6Fs556zdiQxEf2j35Mnxo pTVCy5r7rRcN1O7adgAKdpL3cqRVnzGpHHXR9E3zHw== X-Google-Smtp-Source: AGHT+IEvTC5sdLXl9cFPyjsRYwX6SMviCS4mKCiyIT+UzrQuDIXaVTY5YdRx4Vqmt+k4BAkHnwTPZw== X-Received: by 2002:a9d:7395:0:b0:6b9:9cc0:537f with SMTP id j21-20020a9d7395000000b006b99cc0537fmr2864605otk.33.1697734571849; Thu, 19 Oct 2023 09:56:11 -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.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 Oct 2023 09:56:11 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Thomas Monjalon , Cristian Dumitrescu , Ferruh Yigit , Andrew Rybchenko Subject: [PATCH v3 03/29] ethdev: mark rte_mtr API's as stable Date: Thu, 19 Oct 2023 09:55:32 -0700 Message-Id: <20231019165559.115742-4-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 These haven't changed in a while, time has come to make them not experimental. Signed-off-by: Stephen Hemminger --- MAINTAINERS | 2 +- lib/ethdev/rte_mtr.h | 25 +------------------------ lib/ethdev/version.map | 34 ++++++++++++++++------------------ 3 files changed, 18 insertions(+), 43 deletions(-) diff --git a/MAINTAINERS b/MAINTAINERS index 4083658697fb..ea03d35dbe5a 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -427,7 +427,7 @@ T: git://dpdk.org/next/dpdk-next-net F: lib/ethdev/rte_tm* F: app/test-pmd/cmdline_tm.* -Traffic Metering and Policing API - EXPERIMENTAL +Traffic Metering and Policing API M: Cristian Dumitrescu T: git://dpdk.org/next/dpdk-next-net F: lib/ethdev/rte_mtr* diff --git a/lib/ethdev/rte_mtr.h b/lib/ethdev/rte_mtr.h index 30e6c6b12e6e..9a20e974bdad 100644 --- a/lib/ethdev/rte_mtr.h +++ b/lib/ethdev/rte_mtr.h @@ -41,10 +41,8 @@ * A) Whether an MTR object is private to a flow or potentially shared by * several flows has to be specified at creation time. * B) Several meter actions can be potentially registered for the same flow. - * - * @warning - * @b EXPERIMENTAL: this API may change without prior notice */ + #include #include #include @@ -569,7 +567,6 @@ struct rte_mtr_error { * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_capabilities_get(uint16_t port_id, struct rte_mtr_capabilities *cap, @@ -593,7 +590,6 @@ rte_mtr_capabilities_get(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_profile_add(uint16_t port_id, uint32_t meter_profile_id, @@ -615,7 +611,6 @@ rte_mtr_meter_profile_add(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_profile_delete(uint16_t port_id, uint32_t meter_profile_id, @@ -635,7 +630,6 @@ rte_mtr_meter_profile_delete(uint16_t port_id, * @return * A valid handle in case of success, NULL otherwise. */ -__rte_experimental struct rte_flow_meter_profile * rte_mtr_meter_profile_get(uint16_t port_id, uint32_t meter_profile_id, @@ -663,7 +657,6 @@ rte_mtr_meter_profile_get(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_policy_validate(uint16_t port_id, struct rte_mtr_meter_policy_params *policy, @@ -690,7 +683,6 @@ rte_mtr_meter_policy_validate(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_policy_add(uint16_t port_id, uint32_t policy_id, @@ -711,7 +703,6 @@ rte_mtr_meter_policy_add(uint16_t port_id, * @return * A valid handle in case of success, NULL otherwise. */ -__rte_experimental struct rte_flow_meter_policy * rte_mtr_meter_policy_get(uint16_t port_id, uint32_t policy_id, @@ -793,7 +784,6 @@ struct rte_mtr_meter_policy_params policy = \ * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_policy_delete(uint16_t port_id, uint32_t policy_id, @@ -822,7 +812,6 @@ rte_mtr_meter_policy_delete(uint16_t port_id, * * @see enum rte_flow_action_type::RTE_FLOW_ACTION_TYPE_METER */ -__rte_experimental int rte_mtr_create(uint16_t port_id, uint32_t mtr_id, @@ -846,7 +835,6 @@ rte_mtr_create(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_destroy(uint16_t port_id, uint32_t mtr_id, @@ -874,7 +862,6 @@ rte_mtr_destroy(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_disable(uint16_t port_id, uint32_t mtr_id, @@ -896,7 +883,6 @@ rte_mtr_meter_disable(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_enable(uint16_t port_id, uint32_t mtr_id, @@ -916,7 +902,6 @@ rte_mtr_meter_enable(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_profile_update(uint16_t port_id, uint32_t mtr_id, @@ -937,7 +922,6 @@ rte_mtr_meter_profile_update(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_policy_update(uint16_t port_id, uint32_t mtr_id, @@ -964,7 +948,6 @@ rte_mtr_meter_policy_update(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_dscp_table_update(uint16_t port_id, uint32_t mtr_id, enum rte_mtr_color_in_protocol proto, @@ -991,7 +974,6 @@ rte_mtr_meter_dscp_table_update(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_meter_vlan_table_update(uint16_t port_id, uint32_t mtr_id, enum rte_mtr_color_in_protocol proto, @@ -1022,7 +1004,6 @@ rte_mtr_meter_vlan_table_update(uint16_t port_id, uint32_t mtr_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_color_in_protocol_set(uint16_t port_id, uint32_t mtr_id, enum rte_mtr_color_in_protocol proto, uint32_t priority, @@ -1042,7 +1023,6 @@ rte_mtr_color_in_protocol_set(uint16_t port_id, uint32_t mtr_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_color_in_protocol_get(uint16_t port_id, uint32_t mtr_id, uint64_t *proto_mask, @@ -1064,7 +1044,6 @@ rte_mtr_color_in_protocol_get(uint16_t port_id, uint32_t mtr_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_mtr_color_in_protocol_priority_get(uint16_t port_id, uint32_t mtr_id, enum rte_mtr_color_in_protocol proto, uint32_t *priority, @@ -1088,7 +1067,6 @@ rte_mtr_color_in_protocol_priority_get(uint16_t port_id, uint32_t mtr_id, * * @see enum rte_mtr_stats_type */ -__rte_experimental int rte_mtr_stats_update(uint16_t port_id, uint32_t mtr_id, @@ -1120,7 +1098,6 @@ rte_mtr_stats_update(uint16_t port_id, * * @see enum rte_mtr_stats_type */ -__rte_experimental int rte_mtr_stats_read(uint16_t port_id, uint32_t mtr_id, diff --git a/lib/ethdev/version.map b/lib/ethdev/version.map index 919ba5b8e65b..3611909eb85a 100644 --- a/lib/ethdev/version.map +++ b/lib/ethdev/version.map @@ -135,26 +135,34 @@ DPDK_24 { rte_flow_pick_transfer_proxy; rte_flow_query; rte_flow_validate; - - local: *; -}; - -EXPERIMENTAL { - global: - - # added in 17.11 rte_mtr_capabilities_get; + rte_mtr_color_in_protocol_get; + rte_mtr_color_in_protocol_priority_get; + rte_mtr_color_in_protocol_set; rte_mtr_create; rte_mtr_destroy; rte_mtr_meter_disable; rte_mtr_meter_dscp_table_update; rte_mtr_meter_enable; + rte_mtr_meter_policy_add; + rte_mtr_meter_policy_delete; + rte_mtr_meter_policy_get; + rte_mtr_meter_policy_update; + rte_mtr_meter_policy_validate; rte_mtr_meter_profile_add; rte_mtr_meter_profile_delete; + rte_mtr_meter_profile_get; rte_mtr_meter_profile_update; + rte_mtr_meter_vlan_table_update; rte_mtr_stats_read; rte_mtr_stats_update; + local: *; +}; + +EXPERIMENTAL { + global: + # added in 18.05 rte_eth_dev_get_module_eeprom; rte_eth_dev_get_module_info; @@ -237,10 +245,6 @@ EXPERIMENTAL { rte_flow_action_handle_destroy; rte_flow_action_handle_update; rte_flow_action_handle_query; - rte_mtr_meter_policy_add; - rte_mtr_meter_policy_delete; - rte_mtr_meter_policy_update; - rte_mtr_meter_policy_validate; # added in 21.11 rte_eth_dev_capability_name; @@ -275,10 +279,6 @@ EXPERIMENTAL { # added in 22.07 rte_eth_rx_avail_thresh_query; rte_eth_rx_avail_thresh_set; - rte_mtr_color_in_protocol_get; - rte_mtr_color_in_protocol_priority_get; - rte_mtr_color_in_protocol_set; - rte_mtr_meter_vlan_table_update; # added in 22.11 rte_eth_buffer_split_get_supported_hdr_ptypes; @@ -290,8 +290,6 @@ EXPERIMENTAL { rte_eth_tx_descriptor_dump; rte_flow_async_action_handle_query; rte_flow_get_q_aged_flows; - rte_mtr_meter_policy_get; - rte_mtr_meter_profile_get; # added in 23.03 rte_eth_dev_count_aggr_ports;