Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/132990/?format=api
{ "id": 132990, "url": "http://patchwork.dpdk.org/api/patches/132990/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20231019165559.115742-4-stephen@networkplumber.org/", "project": { "id": 1, "url": "http://patchwork.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20231019165559.115742-4-stephen@networkplumber.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20231019165559.115742-4-stephen@networkplumber.org", "date": "2023-10-19T16:55:32", "name": "[v3,03/29] ethdev: mark rte_mtr API's as stable", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "a36e0cb66f9355ebcb587ff703ca65770b557406", "submitter": { "id": 27, "url": "http://patchwork.dpdk.org/api/people/27/?format=api", "name": "Stephen Hemminger", "email": "stephen@networkplumber.org" }, "delegate": { "id": 1, "url": "http://patchwork.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20231019165559.115742-4-stephen@networkplumber.org/mbox/", "series": [ { "id": 29922, "url": "http://patchwork.dpdk.org/api/series/29922/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=29922", "date": "2023-10-19T16:55:29", "name": "Promote experimental API's to stable.", "version": 3, "mbox": "http://patchwork.dpdk.org/series/29922/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/patches/132990/comments/", "check": "success", "checks": "http://patchwork.dpdk.org/api/patches/132990/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "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])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 72148431AE;\n\tThu, 19 Oct 2023 18:56:33 +0200 (CEST)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id DBF93410F1;\n\tThu, 19 Oct 2023 18:56:16 +0200 (CEST)", "from mail-ot1-f53.google.com (mail-ot1-f53.google.com\n [209.85.210.53]) by mails.dpdk.org (Postfix) with ESMTP id D094240693\n for <dev@dpdk.org>; Thu, 19 Oct 2023 18:56:12 +0200 (CEST)", "by mail-ot1-f53.google.com with SMTP id\n 46e09a7af769-6ce2b6cb933so488900a34.0\n for <dev@dpdk.org>; Thu, 19 Oct 2023 09:56:12 -0700 (PDT)", "from hermes.local (204-195-126-68.wavecable.com. [204.195.126.68])\n by smtp.gmail.com with ESMTPSA id\n y22-20020aa79436000000b00672ea40b8a9sm13988pfo.170.2023.10.19.09.56.11\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Thu, 19 Oct 2023 09:56:11 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=networkplumber-org.20230601.gappssmtp.com; s=20230601; t=1697734572;\n x=1698339372; darn=dpdk.org;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:from:to:cc:subject:date\n :message-id:reply-to;\n bh=J/FmhWWeA++34nykw+5IzU1UqtxQ8u5vqbBMK/ItbkI=;\n b=V/q2/U7jU+RKk7KNca2tbMIAYZYgZYrsO5RuKzUsj17nOUi3iZtfysLw7wqpW9jaLj\n T2MSnHSB1Lysfc9idANbDn/9K/uwJ7/5w3DZCH0EAlotxrWb7G6sTYv6QkFfZRlzT/UE\n 5x5UfOKo3/IKUlilCVIv0QSaTFmhkqNFVBLQLpXiKFeYkpZcr41Rb27JaSfyAVPkXuAS\n twVDLSU1faOncEULiewYa4jDJZRYDmFwiojnqi8AZB7pKO1/VCwtiMvIlx0JkAtn4Lr0\n RdBdrzp5MhHHJdlC8BCua9ah2d3XFAq8bK2NC3r3J7EvFoMN14wwOsGRoz18WdhILEK1\n 2MWg==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20230601; t=1697734572; x=1698339372;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc\n :subject:date:message-id:reply-to;\n bh=J/FmhWWeA++34nykw+5IzU1UqtxQ8u5vqbBMK/ItbkI=;\n b=hGdS4T9t5xBcn5lff5iiSM2ux8OUOgvF72xoQfwfehb1jbuv69wRrM+j5yXvkd48Va\n rjbcc+miQUEt6o6dtWdT0YwwaJag61D4+E09a0A4WyMXe5OdoZKri0Eaqtd2ASR8TFnh\n duy9UZv9Qsnvv+FWX0m7KuuxmG5E3AISqNn6BpEkhHz0+8Zl3J7eVZI+t6iGW+aiT3pW\n WeGVYoZVv0r/1ElS8ZPMw389Xc/quj81bB6d9ud4nVVnzvSwccT+LjW2LySzu8pldkOv\n UDxZ4L1pGVGqSnJyHQ5YWudA/ibhk+VXghIAFTolWABwQSBFvc40hG7yn3u+s2fgpgMP\n zt1A==", "X-Gm-Message-State": "AOJu0YzutSYf88js3O4VrfWtpWhhZg8dIdn6Fs556zdiQxEf2j35Mnxo\n pTVCy5r7rRcN1O7adgAKdpL3cqRVnzGpHHXR9E3zHw==", "X-Google-Smtp-Source": "\n AGHT+IEvTC5sdLXl9cFPyjsRYwX6SMviCS4mKCiyIT+UzrQuDIXaVTY5YdRx4Vqmt+k4BAkHnwTPZw==", "X-Received": "by 2002:a9d:7395:0:b0:6b9:9cc0:537f with SMTP id\n j21-20020a9d7395000000b006b99cc0537fmr2864605otk.33.1697734571849;\n Thu, 19 Oct 2023 09:56:11 -0700 (PDT)", "From": "Stephen Hemminger <stephen@networkplumber.org>", "To": "dev@dpdk.org", "Cc": "Stephen Hemminger <stephen@networkplumber.org>,\n Thomas Monjalon <thomas@monjalon.net>,\n Cristian Dumitrescu <cristian.dumitrescu@intel.com>,\n Ferruh Yigit <ferruh.yigit@amd.com>,\n Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>", "Subject": "[PATCH v3 03/29] ethdev: mark rte_mtr API's as stable", "Date": "Thu, 19 Oct 2023 09:55:32 -0700", "Message-Id": "<20231019165559.115742-4-stephen@networkplumber.org>", "X-Mailer": "git-send-email 2.39.2", "In-Reply-To": "<20231019165559.115742-1-stephen@networkplumber.org>", "References": "<20230808173527.186042-1-stephen@networkplumber.org>\n <20231019165559.115742-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 <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "These haven't changed in a while, time has come to make them\nnot experimental.\n\nSigned-off-by: Stephen Hemminger <stephen@networkplumber.org>\n---\n MAINTAINERS | 2 +-\n lib/ethdev/rte_mtr.h | 25 +------------------------\n lib/ethdev/version.map | 34 ++++++++++++++++------------------\n 3 files changed, 18 insertions(+), 43 deletions(-)", "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 4083658697fb..ea03d35dbe5a 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -427,7 +427,7 @@ T: git://dpdk.org/next/dpdk-next-net\n F: lib/ethdev/rte_tm*\n F: app/test-pmd/cmdline_tm.*\n \n-Traffic Metering and Policing API - EXPERIMENTAL\n+Traffic Metering and Policing API\n M: Cristian Dumitrescu <cristian.dumitrescu@intel.com>\n T: git://dpdk.org/next/dpdk-next-net\n F: lib/ethdev/rte_mtr*\ndiff --git a/lib/ethdev/rte_mtr.h b/lib/ethdev/rte_mtr.h\nindex 30e6c6b12e6e..9a20e974bdad 100644\n--- a/lib/ethdev/rte_mtr.h\n+++ b/lib/ethdev/rte_mtr.h\n@@ -41,10 +41,8 @@\n * A) Whether an MTR object is private to a flow or potentially shared by\n * several flows has to be specified at creation time.\n * B) Several meter actions can be potentially registered for the same flow.\n- *\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice\n */\n+\n #include <stdint.h>\n #include <rte_compat.h>\n #include <rte_common.h>\n@@ -569,7 +567,6 @@ struct rte_mtr_error {\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_capabilities_get(uint16_t port_id,\n \tstruct rte_mtr_capabilities *cap,\n@@ -593,7 +590,6 @@ rte_mtr_capabilities_get(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_profile_add(uint16_t port_id,\n \tuint32_t meter_profile_id,\n@@ -615,7 +611,6 @@ rte_mtr_meter_profile_add(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_profile_delete(uint16_t port_id,\n \tuint32_t meter_profile_id,\n@@ -635,7 +630,6 @@ rte_mtr_meter_profile_delete(uint16_t port_id,\n * @return\n * A valid handle in case of success, NULL otherwise.\n */\n-__rte_experimental\n struct rte_flow_meter_profile *\n rte_mtr_meter_profile_get(uint16_t port_id,\n \tuint32_t meter_profile_id,\n@@ -663,7 +657,6 @@ rte_mtr_meter_profile_get(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_policy_validate(uint16_t port_id,\n \tstruct rte_mtr_meter_policy_params *policy,\n@@ -690,7 +683,6 @@ rte_mtr_meter_policy_validate(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_policy_add(uint16_t port_id,\n \tuint32_t policy_id,\n@@ -711,7 +703,6 @@ rte_mtr_meter_policy_add(uint16_t port_id,\n * @return\n * A valid handle in case of success, NULL otherwise.\n */\n-__rte_experimental\n struct rte_flow_meter_policy *\n rte_mtr_meter_policy_get(uint16_t port_id,\n \tuint32_t policy_id,\n@@ -793,7 +784,6 @@ struct rte_mtr_meter_policy_params policy = \\\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_policy_delete(uint16_t port_id,\n \tuint32_t policy_id,\n@@ -822,7 +812,6 @@ rte_mtr_meter_policy_delete(uint16_t port_id,\n *\n * @see enum rte_flow_action_type::RTE_FLOW_ACTION_TYPE_METER\n */\n-__rte_experimental\n int\n rte_mtr_create(uint16_t port_id,\n \tuint32_t mtr_id,\n@@ -846,7 +835,6 @@ rte_mtr_create(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_destroy(uint16_t port_id,\n \tuint32_t mtr_id,\n@@ -874,7 +862,6 @@ rte_mtr_destroy(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_disable(uint16_t port_id,\n \tuint32_t mtr_id,\n@@ -896,7 +883,6 @@ rte_mtr_meter_disable(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_enable(uint16_t port_id,\n \tuint32_t mtr_id,\n@@ -916,7 +902,6 @@ rte_mtr_meter_enable(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_profile_update(uint16_t port_id,\n \tuint32_t mtr_id,\n@@ -937,7 +922,6 @@ rte_mtr_meter_profile_update(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_policy_update(uint16_t port_id,\n \tuint32_t mtr_id,\n@@ -964,7 +948,6 @@ rte_mtr_meter_policy_update(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_dscp_table_update(uint16_t port_id,\n \tuint32_t mtr_id, enum rte_mtr_color_in_protocol proto,\n@@ -991,7 +974,6 @@ rte_mtr_meter_dscp_table_update(uint16_t port_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_meter_vlan_table_update(uint16_t port_id, uint32_t mtr_id,\n \t\t\t\tenum rte_mtr_color_in_protocol proto,\n@@ -1022,7 +1004,6 @@ rte_mtr_meter_vlan_table_update(uint16_t port_id, uint32_t mtr_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_color_in_protocol_set(uint16_t port_id, uint32_t mtr_id,\n \tenum rte_mtr_color_in_protocol proto, uint32_t priority,\n@@ -1042,7 +1023,6 @@ rte_mtr_color_in_protocol_set(uint16_t port_id, uint32_t mtr_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_color_in_protocol_get(uint16_t port_id, uint32_t mtr_id,\n \tuint64_t *proto_mask,\n@@ -1064,7 +1044,6 @@ rte_mtr_color_in_protocol_get(uint16_t port_id, uint32_t mtr_id,\n * @return\n * 0 on success, non-zero error code otherwise.\n */\n-__rte_experimental\n int\n rte_mtr_color_in_protocol_priority_get(uint16_t port_id, uint32_t mtr_id,\n \tenum rte_mtr_color_in_protocol proto, uint32_t *priority,\n@@ -1088,7 +1067,6 @@ rte_mtr_color_in_protocol_priority_get(uint16_t port_id, uint32_t mtr_id,\n *\n * @see enum rte_mtr_stats_type\n */\n-__rte_experimental\n int\n rte_mtr_stats_update(uint16_t port_id,\n \tuint32_t mtr_id,\n@@ -1120,7 +1098,6 @@ rte_mtr_stats_update(uint16_t port_id,\n *\n * @see enum rte_mtr_stats_type\n */\n-__rte_experimental\n int\n rte_mtr_stats_read(uint16_t port_id,\n \tuint32_t mtr_id,\ndiff --git a/lib/ethdev/version.map b/lib/ethdev/version.map\nindex 919ba5b8e65b..3611909eb85a 100644\n--- a/lib/ethdev/version.map\n+++ b/lib/ethdev/version.map\n@@ -135,26 +135,34 @@ DPDK_24 {\n \trte_flow_pick_transfer_proxy;\n \trte_flow_query;\n \trte_flow_validate;\n-\n-\tlocal: *;\n-};\n-\n-EXPERIMENTAL {\n-\tglobal:\n-\n-\t# added in 17.11\n \trte_mtr_capabilities_get;\n+\trte_mtr_color_in_protocol_get;\n+\trte_mtr_color_in_protocol_priority_get;\n+\trte_mtr_color_in_protocol_set;\n \trte_mtr_create;\n \trte_mtr_destroy;\n \trte_mtr_meter_disable;\n \trte_mtr_meter_dscp_table_update;\n \trte_mtr_meter_enable;\n+\trte_mtr_meter_policy_add;\n+\trte_mtr_meter_policy_delete;\n+\trte_mtr_meter_policy_get;\n+\trte_mtr_meter_policy_update;\n+\trte_mtr_meter_policy_validate;\n \trte_mtr_meter_profile_add;\n \trte_mtr_meter_profile_delete;\n+\trte_mtr_meter_profile_get;\n \trte_mtr_meter_profile_update;\n+\trte_mtr_meter_vlan_table_update;\n \trte_mtr_stats_read;\n \trte_mtr_stats_update;\n \n+\tlocal: *;\n+};\n+\n+EXPERIMENTAL {\n+\tglobal:\n+\n \t# added in 18.05\n \trte_eth_dev_get_module_eeprom;\n \trte_eth_dev_get_module_info;\n@@ -237,10 +245,6 @@ EXPERIMENTAL {\n \trte_flow_action_handle_destroy;\n \trte_flow_action_handle_update;\n \trte_flow_action_handle_query;\n-\trte_mtr_meter_policy_add;\n-\trte_mtr_meter_policy_delete;\n-\trte_mtr_meter_policy_update;\n-\trte_mtr_meter_policy_validate;\n \n \t# added in 21.11\n \trte_eth_dev_capability_name;\n@@ -275,10 +279,6 @@ EXPERIMENTAL {\n \t# added in 22.07\n \trte_eth_rx_avail_thresh_query;\n \trte_eth_rx_avail_thresh_set;\n-\trte_mtr_color_in_protocol_get;\n-\trte_mtr_color_in_protocol_priority_get;\n-\trte_mtr_color_in_protocol_set;\n-\trte_mtr_meter_vlan_table_update;\n \n \t# added in 22.11\n \trte_eth_buffer_split_get_supported_hdr_ptypes;\n@@ -290,8 +290,6 @@ EXPERIMENTAL {\n \trte_eth_tx_descriptor_dump;\n \trte_flow_async_action_handle_query;\n \trte_flow_get_q_aged_flows;\n-\trte_mtr_meter_policy_get;\n-\trte_mtr_meter_profile_get;\n \n \t# added in 23.03\n \trte_eth_dev_count_aggr_ports;\n", "prefixes": [ "v3", "03/29" ] }