From patchwork Fri Oct 20 20:57:36 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133081 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 3ED0F431BE; Fri, 20 Oct 2023 22:58:34 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id E0D8640A7A; Fri, 20 Oct 2023 22:58:15 +0200 (CEST) Received: from mail-pl1-f176.google.com (mail-pl1-f176.google.com [209.85.214.176]) by mails.dpdk.org (Postfix) with ESMTP id 818C4402EC for ; Fri, 20 Oct 2023 22:58:13 +0200 (CEST) Received: by mail-pl1-f176.google.com with SMTP id d9443c01a7336-1c9c5a1b87bso8990445ad.3 for ; Fri, 20 Oct 2023 13:58:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697835492; x=1698440292; 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=iIT7nMm49dyv4Xz0D7v+7wWbb62qH3k7w7V5zb4zaD8=; b=Ya8WJAlwO6F3zSCtzLD/aQZorRw4ruPEajZ6LV/q8+1fZHAuF1cQzj2qEWQpYQtYYK GEOXrN8q6A14nzZmxexFCwhmJfsGEi2/A4lXxIug7BPHIeItg74hUjjcbr9WS7cO7FLu G7mGUxyvtcGciuX+Q1Wd6nZ/+w5tgp5CbEOWsiGn5K2ckAc1kfeDh1bXrBPxLYmuwedL /Z6bo9HhYvsO2Oak3BP1i9SNbRzjFz+fkJ5zj4TOtlHAacBHta8ssUrui+bwyqKh9H24 /gA6mpqSxfTt14iPtDKz7RCkgrV+eFe7RHcYCTjD6RVLB+EDFltGoc3MDF+vEHqg+d8w Ayxg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1697835492; x=1698440292; 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=iIT7nMm49dyv4Xz0D7v+7wWbb62qH3k7w7V5zb4zaD8=; b=F0cvVPwHNtn+9vHDPh8PcMDK++bezCmeMALrink6unz6UkuHok7czUA1bb/9DLqCJ+ zMRxpkftgQDXa7J8xE7Xpe6HIvzUFMdUkkWoxCjOap8zAcyj0/XKE9Mo7EMuuNPkblIc mLhD9+9uYq0g0Jkb/0JN1o8vIa8LQyIWg3oiu1pXOpabK5uKlXzXJk49KsyzssbVHq+O M22Co1gH07NI3rGoj8VOlre7M3x/HyA7hWO7dlnB8tzcF2bvc+uQKLoF443NMDcqBYCt BUbA81eP1a/uc6Ag3zxulnaLh1ZgzI18Jt1MDxRDgWjiifTrDhjNRMrgOdYTxeU/lyph UEEg== X-Gm-Message-State: AOJu0Yx1Y+iETMIAiDcB6n8ptoSgkreg88DArwUYxRD6pGVHdnk8FKgL AGFaIplZnOrs+LaAsjvjy8KyayIwaYAsXZivMCR/EA== X-Google-Smtp-Source: AGHT+IF74OjRUdKncLP1u5LmcfM78bxpegjJ91O3dDFhPF27KtfTkm2+ol20QQhehHjA8Fg9X0eRvQ== X-Received: by 2002:a17:903:2342:b0:1c9:dff6:58f2 with SMTP id c2-20020a170903234200b001c9dff658f2mr3167856plh.59.1697835492411; Fri, 20 Oct 2023 13:58:12 -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.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 20 Oct 2023 13:58:11 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Cristian Dumitrescu , Thomas Monjalon , Ferruh Yigit , Andrew Rybchenko Subject: [PATCH v5 03/26] ethdev: mark rte_tm API's as stable Date: Fri, 20 Oct 2023 13:57:36 -0700 Message-Id: <20231020205759.195126-4-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 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 API's have been around since 20.11, mark them as not experimental. Signed-off-by: Stephen Hemminger Acked-by: Cristian Dumitrescu --- MAINTAINERS | 2 +- lib/ethdev/rte_tm.h | 34 ----------------------- lib/ethdev/version.map | 62 ++++++++++++++++++++---------------------- 3 files changed, 31 insertions(+), 67 deletions(-) diff --git a/MAINTAINERS b/MAINTAINERS index 4083658697fb..e5d92aa74926 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -421,7 +421,7 @@ F: app/test-pmd/cmdline_flow.c F: doc/guides/prog_guide/rte_flow.rst F: lib/ethdev/rte_flow* -Traffic Management API - EXPERIMENTAL +Traffic Management API M: Cristian Dumitrescu T: git://dpdk.org/next/dpdk-next-net F: lib/ethdev/rte_tm* diff --git a/lib/ethdev/rte_tm.h b/lib/ethdev/rte_tm.h index 08c5fafecdf3..799b92aadaa9 100644 --- a/lib/ethdev/rte_tm.h +++ b/lib/ethdev/rte_tm.h @@ -14,10 +14,6 @@ * This interface provides the ability to configure the traffic manager in a * generic way. It includes features such as: hierarchical scheduling, * traffic shaping, congestion management, packet marking, etc. - * - * @warning - * @b EXPERIMENTAL: - * All functions in this file may be changed or removed without prior notice. */ #include @@ -1242,7 +1238,6 @@ struct rte_tm_error { * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_tm_get_number_of_leaf_nodes(uint16_t port_id, uint32_t *n_leaf_nodes, @@ -1267,7 +1262,6 @@ rte_tm_get_number_of_leaf_nodes(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_tm_node_type_get(uint16_t port_id, uint32_t node_id, @@ -1286,7 +1280,6 @@ rte_tm_node_type_get(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_tm_capabilities_get(uint16_t port_id, struct rte_tm_capabilities *cap, @@ -1307,7 +1300,6 @@ rte_tm_capabilities_get(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_tm_level_capabilities_get(uint16_t port_id, uint32_t level_id, @@ -1328,7 +1320,6 @@ rte_tm_level_capabilities_get(uint16_t port_id, * @return * 0 on success, non-zero error code otherwise. */ -__rte_experimental int rte_tm_node_capabilities_get(uint16_t port_id, uint32_t node_id, @@ -1354,7 +1345,6 @@ rte_tm_node_capabilities_get(uint16_t port_id, * * @see struct rte_tm_capabilities::cman_wred_context_n_max */ -__rte_experimental int rte_tm_wred_profile_add(uint16_t port_id, uint32_t wred_profile_id, @@ -1378,7 +1368,6 @@ rte_tm_wred_profile_add(uint16_t port_id, * * @see struct rte_tm_capabilities::cman_wred_context_n_max */ -__rte_experimental int rte_tm_wred_profile_delete(uint16_t port_id, uint32_t wred_profile_id, @@ -1410,7 +1399,6 @@ rte_tm_wred_profile_delete(uint16_t port_id, * * @see struct rte_tm_capabilities::cman_wred_context_shared_n_max */ -__rte_experimental int rte_tm_shared_wred_context_add_update(uint16_t port_id, uint32_t shared_wred_context_id, @@ -1435,7 +1423,6 @@ rte_tm_shared_wred_context_add_update(uint16_t port_id, * * @see struct rte_tm_capabilities::cman_wred_context_shared_n_max */ -__rte_experimental int rte_tm_shared_wred_context_delete(uint16_t port_id, uint32_t shared_wred_context_id, @@ -1460,7 +1447,6 @@ rte_tm_shared_wred_context_delete(uint16_t port_id, * * @see struct rte_tm_capabilities::shaper_n_max */ -__rte_experimental int rte_tm_shaper_profile_add(uint16_t port_id, uint32_t shaper_profile_id, @@ -1484,7 +1470,6 @@ rte_tm_shaper_profile_add(uint16_t port_id, * * @see struct rte_tm_capabilities::shaper_n_max */ -__rte_experimental int rte_tm_shaper_profile_delete(uint16_t port_id, uint32_t shaper_profile_id, @@ -1514,7 +1499,6 @@ rte_tm_shaper_profile_delete(uint16_t port_id, * * @see struct rte_tm_capabilities::shaper_shared_n_max */ -__rte_experimental int rte_tm_shared_shaper_add_update(uint16_t port_id, uint32_t shared_shaper_id, @@ -1538,7 +1522,6 @@ rte_tm_shared_shaper_add_update(uint16_t port_id, * * @see struct rte_tm_capabilities::shaper_shared_n_max */ -__rte_experimental int rte_tm_shared_shaper_delete(uint16_t port_id, uint32_t shared_shaper_id, @@ -1607,7 +1590,6 @@ rte_tm_shared_shaper_delete(uint16_t port_id, * @see RTE_TM_NODE_LEVEL_ID_ANY * @see struct rte_tm_capabilities */ -__rte_experimental int rte_tm_node_add(uint16_t port_id, uint32_t node_id, @@ -1641,7 +1623,6 @@ rte_tm_node_add(uint16_t port_id, * * @see RTE_TM_UPDATE_NODE_ADD_DELETE */ -__rte_experimental int rte_tm_node_delete(uint16_t port_id, uint32_t node_id, @@ -1666,7 +1647,6 @@ rte_tm_node_delete(uint16_t port_id, * @see rte_tm_node_resume() * @see RTE_TM_UPDATE_NODE_SUSPEND_RESUME */ -__rte_experimental int rte_tm_node_suspend(uint16_t port_id, uint32_t node_id, @@ -1690,7 +1670,6 @@ rte_tm_node_suspend(uint16_t port_id, * @see rte_tm_node_suspend() * @see RTE_TM_UPDATE_NODE_SUSPEND_RESUME */ -__rte_experimental int rte_tm_node_resume(uint16_t port_id, uint32_t node_id, @@ -1732,7 +1711,6 @@ rte_tm_node_resume(uint16_t port_id, * @see rte_tm_node_add() * @see rte_tm_node_delete() */ -__rte_experimental int rte_tm_hierarchy_commit(uint16_t port_id, int clear_on_fail, @@ -1773,7 +1751,6 @@ rte_tm_hierarchy_commit(uint16_t port_id, * @see RTE_TM_UPDATE_NODE_PARENT_KEEP_LEVEL * @see RTE_TM_UPDATE_NODE_PARENT_CHANGE_LEVEL */ -__rte_experimental int rte_tm_node_parent_update(uint16_t port_id, uint32_t node_id, @@ -1803,7 +1780,6 @@ rte_tm_node_parent_update(uint16_t port_id, * * @see struct rte_tm_capabilities::shaper_private_n_max */ -__rte_experimental int rte_tm_node_shaper_update(uint16_t port_id, uint32_t node_id, @@ -1831,7 +1807,6 @@ rte_tm_node_shaper_update(uint16_t port_id, * * @see struct rte_tm_capabilities::shaper_shared_n_max */ -__rte_experimental int rte_tm_node_shared_shaper_update(uint16_t port_id, uint32_t node_id, @@ -1859,7 +1834,6 @@ rte_tm_node_shared_shaper_update(uint16_t port_id, * @see enum rte_tm_stats_type * @see RTE_TM_UPDATE_NODE_STATS */ -__rte_experimental int rte_tm_node_stats_update(uint16_t port_id, uint32_t node_id, @@ -1888,7 +1862,6 @@ rte_tm_node_stats_update(uint16_t port_id, * @see RTE_TM_UPDATE_NODE_WFQ_WEIGHT_MODE * @see RTE_TM_UPDATE_NODE_N_SP_PRIORITIES */ -__rte_experimental int rte_tm_node_wfq_weight_mode_update(uint16_t port_id, uint32_t node_id, @@ -1912,7 +1885,6 @@ rte_tm_node_wfq_weight_mode_update(uint16_t port_id, * * @see RTE_TM_UPDATE_NODE_CMAN */ -__rte_experimental int rte_tm_node_cman_update(uint16_t port_id, uint32_t node_id, @@ -1937,7 +1909,6 @@ rte_tm_node_cman_update(uint16_t port_id, * * @see struct rte_tm_capabilities::cman_wred_context_private_n_max */ -__rte_experimental int rte_tm_node_wred_context_update(uint16_t port_id, uint32_t node_id, @@ -1963,7 +1934,6 @@ rte_tm_node_wred_context_update(uint16_t port_id, * * @see struct rte_tm_capabilities::cman_wred_context_shared_n_max */ -__rte_experimental int rte_tm_node_shared_wred_context_update(uint16_t port_id, uint32_t node_id, @@ -1996,7 +1966,6 @@ rte_tm_node_shared_wred_context_update(uint16_t port_id, * * @see enum rte_tm_stats_type */ -__rte_experimental int rte_tm_node_stats_read(uint16_t port_id, uint32_t node_id, @@ -2034,7 +2003,6 @@ rte_tm_node_stats_read(uint16_t port_id, * * @see struct rte_tm_capabilities::mark_vlan_dei_supported */ -__rte_experimental int rte_tm_mark_vlan_dei(uint16_t port_id, int mark_green, @@ -2085,7 +2053,6 @@ rte_tm_mark_vlan_dei(uint16_t port_id, * @see struct rte_tm_capabilities::mark_ip_ecn_tcp_supported * @see struct rte_tm_capabilities::mark_ip_ecn_sctp_supported */ -__rte_experimental int rte_tm_mark_ip_ecn(uint16_t port_id, int mark_green, @@ -2134,7 +2101,6 @@ rte_tm_mark_ip_ecn(uint16_t port_id, * * @see struct rte_tm_capabilities::mark_ip_dscp_supported */ -__rte_experimental int rte_tm_mark_ip_dscp(uint16_t port_id, int mark_green, diff --git a/lib/ethdev/version.map b/lib/ethdev/version.map index 919ba5b8e65b..072ad3401235 100644 --- a/lib/ethdev/version.map +++ b/lib/ethdev/version.map @@ -135,6 +135,36 @@ DPDK_24 { rte_flow_pick_transfer_proxy; rte_flow_query; rte_flow_validate; + rte_tm_capabilities_get; + rte_tm_get_number_of_leaf_nodes; + rte_tm_hierarchy_commit; + rte_tm_level_capabilities_get; + rte_tm_mark_ip_dscp; + rte_tm_mark_ip_ecn; + rte_tm_mark_vlan_dei; + rte_tm_node_add; + rte_tm_node_capabilities_get; + rte_tm_node_cman_update; + rte_tm_node_delete; + rte_tm_node_parent_update; + rte_tm_node_resume; + rte_tm_node_shaper_update; + rte_tm_node_shared_shaper_update; + rte_tm_node_shared_wred_context_update; + rte_tm_node_stats_read; + rte_tm_node_stats_update; + rte_tm_node_suspend; + rte_tm_node_type_get; + rte_tm_node_wfq_weight_mode_update; + rte_tm_node_wred_context_update; + rte_tm_shaper_profile_add; + rte_tm_shaper_profile_delete; + rte_tm_shared_shaper_add_update; + rte_tm_shared_shaper_delete; + rte_tm_shared_wred_context_add_update; + rte_tm_shared_wred_context_delete; + rte_tm_wred_profile_add; + rte_tm_wred_profile_delete; local: *; }; @@ -181,38 +211,6 @@ EXPERIMENTAL { __rte_ethdev_trace_tx_burst; rte_flow_get_aged_flows; - # Marked as experimental in 20.11 - rte_tm_capabilities_get; - rte_tm_get_number_of_leaf_nodes; - rte_tm_hierarchy_commit; - rte_tm_level_capabilities_get; - rte_tm_mark_ip_dscp; - rte_tm_mark_ip_ecn; - rte_tm_mark_vlan_dei; - rte_tm_node_add; - rte_tm_node_capabilities_get; - rte_tm_node_cman_update; - rte_tm_node_delete; - rte_tm_node_parent_update; - rte_tm_node_resume; - rte_tm_node_shaper_update; - rte_tm_node_shared_shaper_update; - rte_tm_node_shared_wred_context_update; - rte_tm_node_stats_read; - rte_tm_node_stats_update; - rte_tm_node_suspend; - rte_tm_node_type_get; - rte_tm_node_wfq_weight_mode_update; - rte_tm_node_wred_context_update; - rte_tm_shaper_profile_add; - rte_tm_shaper_profile_delete; - rte_tm_shared_shaper_add_update; - rte_tm_shared_shaper_delete; - rte_tm_shared_wred_context_add_update; - rte_tm_shared_wred_context_delete; - rte_tm_wred_profile_add; - rte_tm_wred_profile_delete; - # added in 20.11 rte_eth_hairpin_bind; rte_eth_hairpin_get_peer_ports;