From patchwork Tue Oct 24 02:39:25 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 133233 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 CA347431EB; Tue, 24 Oct 2023 04:40:18 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id A5C2140EE5; Tue, 24 Oct 2023 04:40:06 +0200 (CEST) Received: from mail-pj1-f48.google.com (mail-pj1-f48.google.com [209.85.216.48]) by mails.dpdk.org (Postfix) with ESMTP id 2B1FC40A71 for ; Tue, 24 Oct 2023 04:40:03 +0200 (CEST) Received: by mail-pj1-f48.google.com with SMTP id 98e67ed59e1d1-27d0e3d823fso2629678a91.1 for ; Mon, 23 Oct 2023 19:40:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1698115202; x=1698720002; 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=aNiacr4sI9lAjf5IyQK9ua1Gq0ZTlILC7hLd53OljjRfJ10VLBJG0olnFPjVqHpNsd V3IcgWbjTvM3uYlgYFrKIQBv5u48lbkndF3BgGCXOrrFGwlTFi6EoKKNZ9apUSd5SR9e Wyaazs2krYzc7fdj8xi8+3yFibzqTR63MbIQBa1Ct3ejFhpD6+YYN+h9qFDhEPa+qbfu VUGO7/wXlQibpEdaV/QDJZbvHb+YSc/+bE2n0jPKErH/Kiwq4uxGSeW7K4O2KhzUtDVe w0mzlCc+gZvvY6k87EHijyv0XS99/WdfjO0MezmZQSQ6gN4Evnifp5GKURuFKyLxBIn4 smhg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1698115202; x=1698720002; 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=H8HaOFcX6YKtfM0raSdDKm18+yEfhu7NijtkrQgx8FktXnh3PBGLulo3q6iNxtiwL5 MNSDpPG9l0ZmXOBgR2hpCEetUYdAHWR0i6A8IWC7oCRLfaKpbzmbXfOysIXR4vYtzsdu ODoX/SpE3nSF1BMzaZ+k/+N2jgQe0tfro//2UQpv8ZxqWAa3JjB6xw94pKk//Q8ac/a7 5UpF63cquBg/zu+r5pB5VmD1YofYkYl6FI2NenXA1M3JbP9Ox6zUK3sUGyuvJ2fCLVtr Z2z4XX+vxmnlwMASON82BOIqK4P4f415JASVsc7WMgT46zH8Uindf1oqhdlTuxIBPKiS 44rQ== X-Gm-Message-State: AOJu0YxHk8ZyDEjgcHK0fZlP+v9z2VhXBGxKAy/WShKDvKKotYpZOn9t 3YaH5l9MAFB0C3Cae2tl6H/WIxPe8nSeOs11RAZO8g== X-Google-Smtp-Source: AGHT+IErMh2nKMtlBVpvAqZAdOx+g2jDET5J8hNlSkvLu4uYFS3rWIoyGL9Asg+WCWGDwLDb48XSug== X-Received: by 2002:a17:90a:b38c:b0:27c:f80a:2c8a with SMTP id e12-20020a17090ab38c00b0027cf80a2c8amr1267223pjr.0.1698115202076; Mon, 23 Oct 2023 19:40:02 -0700 (PDT) Received: from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68]) by smtp.gmail.com with ESMTPSA id 21-20020a17090a01d500b0027732eb24bbsm9069186pjd.4.2023.10.23.19.40.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 23 Oct 2023 19:40:01 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger , Cristian Dumitrescu , Thomas Monjalon , Ferruh Yigit , Andrew Rybchenko Subject: [PATCH v6 03/25] ethdev: mark rte_tm API's as stable Date: Mon, 23 Oct 2023 19:39:25 -0700 Message-Id: <20231024023947.15859-4-stephen@networkplumber.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20231024023947.15859-1-stephen@networkplumber.org> References: <20230808173527.186042-1-stephen@networkplumber.org> <20231024023947.15859-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;