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 59537431B1; Thu, 19 Oct 2023 21:10:58 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 9399542686; Thu, 19 Oct 2023 21:10:33 +0200 (CEST) Received: from mail-pl1-f171.google.com (mail-pl1-f171.google.com [209.85.214.171]) by mails.dpdk.org (Postfix) with ESMTP id AEE7940E03 for ; Thu, 19 Oct 2023 21:10:30 +0200 (CEST) Received: by mail-pl1-f171.google.com with SMTP id d9443c01a7336-1ca816f868fso35933215ad.1 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=fMDwrcpBLGz576cfrqLJcGLsmGzmzvALNKxBEKOEWI8=; b=QoYDpwBTMEqS/EcWk8BzejNNd646TZtMRNldRQtRZhlYJlxrZWxGeSy/zx6hSxbFQL m6uTnbGe/H8p/vJ3rgDzwk96jVSrQi7Ndm4U29eUpJz9U80N1HK1NN2LCVrewFhQdO3c KdrWlpXkOHbAK7qgI+xl+K1ptFPKHu3ArFIqpX9wqb7BQbRbPVi4HbmkTaspD64WcVQ8 2I4MbPsmbR9Fv48OhQ4U3pGdlZP4E4V6HpdW/12GAFWCVTt0z02NE3le9mhxG2LuKuAd hXBvCNVK0CtJ0w66PVB/3wANm/Sbvylz6Ct9hx/mR7bi855tEBM+I9fJTQLZNMXXfXAb b3aA== 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=fMDwrcpBLGz576cfrqLJcGLsmGzmzvALNKxBEKOEWI8=; b=pPfdbIgR6gn9WVy8iTUGJrNBbObudVCtJkPBo02XmBv4JSlbEsfqO7pFQyLctBn2Fj FITwwWMsNgIzrc/H8icEnrdK6UNf6I45oUYDWSiWdGSsD8T1WjQNlcjPCZSomQ2Tzb+B uEFQoN44n+7AuH3RnmrySnnKc2Ut4+fZyn8GrXwZD9F6NAoZH+Nzt78UVl6fyRaLX/MQ Iof6y6CYQk00L5YTdfnXCyDKgtqC1hUR3N4guPc1YubukEOBgkg9FdR/hMmc+EiHuGZC KXG2Qr/5M3NG6E7hs/huQDKY90F9k6l2+GuFrhOnZiGxEOiy/w5hXIjNZQ/HdfBJD7/l YoJQ== X-Gm-Message-State: AOJu0YytlH3xyUpqdPbvWRzgkAbj3oPplptC4WpSQHkaoRrLLEkqmaom 0VvPJgVL03bdj0LKA2OqF70U+Yjhaleq+kDf/AUsqw== X-Google-Smtp-Source: AGHT+IEamGegliM4NKDRX6e7tJ0tL+NOEgGuzIxHX4nd/LKFauAveuWs91lnCgMLw1Qg2r5WNyjoGQ== X-Received: by 2002:a17:902:f945:b0:1ca:86db:1d39 with SMTP id kx5-20020a170902f94500b001ca86db1d39mr3592383plb.30.1697742629456; Thu, 19 Oct 2023 12:10:29 -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.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 Oct 2023 12:10:29 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Thomas Monjalon , Cristian Dumitrescu , Ferruh Yigit , Andrew Rybchenko Subject: [PATCH v4 04/28] ethdev: mark rte_tm API's as stable Date: Thu, 19 Oct 2023 12:09:52 -0700 Message-Id: <20231019191016.156430-5-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 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 API's have been around since 20.11, mark them as not experimental. Signed-off-by: Stephen Hemminger --- 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 ea03d35dbe5a..f77597571633 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 3611909eb85a..a976f06483b2 100644 --- a/lib/ethdev/version.map +++ b/lib/ethdev/version.map @@ -156,6 +156,36 @@ DPDK_24 { rte_mtr_meter_vlan_table_update; rte_mtr_stats_read; rte_mtr_stats_update; + 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: *; }; @@ -189,38 +219,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; -- 2.39.2