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 92C1243011; Wed, 9 Aug 2023 02:10:51 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id A8CA143267; Wed, 9 Aug 2023 02:10:33 +0200 (CEST) Received: from mail-pl1-f169.google.com (mail-pl1-f169.google.com [209.85.214.169]) by mails.dpdk.org (Postfix) with ESMTP id 29F4A43261 for ; Wed, 9 Aug 2023 02:10:32 +0200 (CEST) Received: by mail-pl1-f169.google.com with SMTP id d9443c01a7336-1bc3d94d40fso54331065ad.3 for ; Tue, 08 Aug 2023 17:10:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20221208.gappssmtp.com; s=20221208; t=1691539831; x=1692144631; 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=x7RQssE84C1nz1MJOlbJsUqdiyCcAindGMsqIkyVmpY=; b=QLj/rN2jX6TdN0H/ZVQrGHz9AoiKteUD61tWpWTID/jPR6FBsfcI65wOkMbJ41yhBR 1j0xiTBZHY2ATn51hjCPvvyClVTuYeD4xSr0TGumf1qVQ6gh2DGmONhfhbOgqChOT5jZ YSRcEhMEtOCmLiB7dIh7++JFGp6sjETf6kIT02Y0L3Ijzu4bF5oYask00kaXByIc+oIs SsIzyFzV9ebdAanbz6AtRqBvA/Rh6psqgCShyMreS5HKVXgIEmv72GunfWtj8RGocqSd sOzQsVk9ska0jO181pAJ/pq41htaJ381X+K7uSTVzhFQPdCSZD3Mo+CimZsNgR8affiJ SfOw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1691539831; x=1692144631; 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=x7RQssE84C1nz1MJOlbJsUqdiyCcAindGMsqIkyVmpY=; b=FZOQa9p/nCasp10EawuYyEyKMaA2hX1wzV8nlE8tQ5eFFpU8BXXlWJTYbPvsVGM5gz L3IpOTLdQqOGmyR0CMxXUeF9QubRLc0t21xUTxNh0IcEKMK9MwQoUMx8v9bxeUAWep7B nT6I1gQSSQkXAXVIctNvbWsncZGm63It3q9fYRgTxeAdZu4MZR10y9/iRc+IC4w0C3yx KSFwE1/W8lk/plnDg4MTPwygG+mItFaYdGYldAig8f2p9J89YQ+NXnKtXkLw82exCG42 CNPDZRq05Gb4DAMVmFadusC2IMUbeUfC3RBAnlz2Jlt+sCgK5FMKdxj23K6WaqUSKtLr nR5A== X-Gm-Message-State: AOJu0Yx9nyDVtwH4oXqV9Cjh4s+LPvaGpIgDhrmdi63iFf52wg3+j/RX JFhfcYZiSbzj3p3Uks6w6nbyiGJSYWrhTtt9GU4DRg== X-Google-Smtp-Source: AGHT+IHCKAou7g7z+Q5LHLeZbwRK84HaRFSbwVXszD/DuVxSQZd8tqIlyZVpGBajgKbrUphqFiGK8Q== X-Received: by 2002:a17:902:dacf:b0:1bb:97d0:c628 with SMTP id q15-20020a170902dacf00b001bb97d0c628mr1440591plx.31.1691539830819; Tue, 08 Aug 2023 17:10:30 -0700 (PDT) Received: from hermes.local (204-195-127-207.wavecable.com. [204.195.127.207]) by smtp.gmail.com with ESMTPSA id ix11-20020a170902f80b00b001bc676df6a9sm5745629plb.132.2023.08.08.17.10.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Aug 2023 17:10:30 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Thomas Monjalon , Cristian Dumitrescu , Ferruh Yigit , Andrew Rybchenko Subject: [PATCH v2 03/29] ethdev: mark rte_mtr API's as stable Date: Tue, 8 Aug 2023 17:09:51 -0700 Message-Id: <20230809001017.293037-4-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20230809001017.293037-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20230809001017.293037-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 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 6345e7f8a65d..decba6b38a31 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -426,7 +426,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 7e6a66b938bf..ed498f36b179 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 @@ -570,7 +568,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, @@ -594,7 +591,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, @@ -616,7 +612,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, @@ -636,7 +631,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, @@ -664,7 +658,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, @@ -691,7 +684,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, @@ -712,7 +704,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, @@ -794,7 +785,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, @@ -823,7 +813,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, @@ -847,7 +836,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, @@ -875,7 +863,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, @@ -897,7 +884,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, @@ -917,7 +903,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, @@ -938,7 +923,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, @@ -965,7 +949,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, @@ -992,7 +975,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, @@ -1023,7 +1005,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, @@ -1043,7 +1024,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, @@ -1065,7 +1045,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, @@ -1089,7 +1068,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, @@ -1121,7 +1099,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 b965d6aa5274..a275cce48164 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; -- 2.39.2