From patchwork Thu Oct 19 19:09:51 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133032 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 22203431B1; Thu, 19 Oct 2023 21:10:50 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3FB27410F1; Thu, 19 Oct 2023 21:10:32 +0200 (CEST) Received: from mail-pf1-f172.google.com (mail-pf1-f172.google.com [209.85.210.172]) by mails.dpdk.org (Postfix) with ESMTP id 46DF340E03 for ; Thu, 19 Oct 2023 21:10:30 +0200 (CEST) Received: by mail-pf1-f172.google.com with SMTP id d2e1a72fcca58-6b9af7d41d2so87253b3a.0 for ; Thu, 19 Oct 2023 12:10:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697742629; x=1698347429; 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=PiP780zrN6wxhRQL3xD0F77KfXcQHQdeEPJy+C1SaJr9GRPB2COfyX6ke9YIcc9/pP mMzNDFbDUvump9lYMnpg8SEE4tOcRlSxvgtuItMO+2qhWjNTBd+myZ7ttr7gGeSl37KP U/xHAQnqQCylomFhnT8eechkC4SubNQ1XIuqY1LoqogPREhw0m+SgM1y4i18x45oGWPT UdUd0HmdCoUU98KZAWmmeftSjq324cCm57hNQMTock9CBmkMV7zurX9NBMI1MOT+Pz+h Li4nL3gmShqAStfKCR4BJ90SP2eUwBCWxzHAlvVH73DooFNIP5cVGdQURgfv+u+SMDK8 0wNA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697742629; x=1698347429; 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=HGOL3UgJsvW4uiD2kgw/Ad40jxF2DNR9gPrXJHw4QFNT5QPsIp1H/SUz9ZZmIAuZ0c +EixjXQ34L/nbaS0ealHIhidq9p+wX4393+mQUhg3aWP+K+RpJ48IfjZfUZTaWSpscku u0yVqHRQEPW6ErC55w41OfmTxp9IspMIatL7dcDYQNY7AA2fLP0EonlU2riYqHm7l4bg DHYFb5lxFKDR3NO8++CakUQHlzdcngHFfx6OVz2X6gCkGTtPEBtUFIuYQfOTP7MgHdze sRzG18NF8JbethOD0rWQg+jCLtjSCTPCZxIqpoQ/fZi/9NBRNl5tQskJiiZgwIyysICM l71w== X-Gm-Message-State: AOJu0YyKWs9y/Hk4pyjrN4E1a0oFxi76CGmizR544pVU6bBnuXTAGMwe IO9ZuA8xqC+etw1BY0ilnN324BmsPcta/7jlRh+8Sg== X-Google-Smtp-Source: AGHT+IEAWFHz/X6obj2gNpTq1xQ8IEU/HnxFQnh4JTN1lwySSZWJtfDhr7WNiyeIq4kiDtzrSu696Q== X-Received: by 2002:a05:6a21:4987:b0:15e:9c2f:5294 with SMTP id ax7-20020a056a21498700b0015e9c2f5294mr2802141pzc.56.1697742628656; Thu, 19 Oct 2023 12:10:28 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id h12-20020a170902eecc00b001a9b29b6759sm52464plb.183.2023.10.19.12.10.27 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 Oct 2023 12:10:28 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Thomas Monjalon , Cristian Dumitrescu , Ferruh Yigit , Andrew Rybchenko Subject: [PATCH v4 03/28] ethdev: mark rte_mtr API's as stable Date: Thu, 19 Oct 2023 12:09:51 -0700 Message-Id: <20231019191016.156430-4-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231019191016.156430-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20231019191016.156430-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;