Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/130061/?format=api
http://patchwork.dpdk.org/api/patches/130061/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20230809164312.308093-13-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": "<20230809164312.308093-13-stephen@networkplumber.org>", "list_archive_url": "https://inbox.dpdk.org/dev/20230809164312.308093-13-stephen@networkplumber.org", "date": "2023-08-09T16:43:04", "name": "[12/15] eal: make most rte_thread API's stable", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "06204b1a577a2b69412961d89bc78520fb7c1cd6", "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/20230809164312.308093-13-stephen@networkplumber.org/mbox/", "series": [ { "id": 29148, "url": "http://patchwork.dpdk.org/api/series/29148/?format=api", "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=29148", "date": "2023-08-09T16:42:52", "name": "eal: mark older API's stable", "version": 1, "mbox": "http://patchwork.dpdk.org/series/29148/mbox/" } ], "comments": "http://patchwork.dpdk.org/api/patches/130061/comments/", "check": "success", "checks": "http://patchwork.dpdk.org/api/patches/130061/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 4929B4301A;\n\tWed, 9 Aug 2023 18:46:01 +0200 (CEST)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 756C943294;\n\tWed, 9 Aug 2023 18:44:53 +0200 (CEST)", "from mail-pl1-f178.google.com (mail-pl1-f178.google.com\n [209.85.214.178])\n by mails.dpdk.org (Postfix) with ESMTP id 48F1F43283\n for <dev@dpdk.org>; Wed, 9 Aug 2023 18:44:50 +0200 (CEST)", "by mail-pl1-f178.google.com with SMTP id\n d9443c01a7336-1bb893e6365so501735ad.2\n for <dev@dpdk.org>; Wed, 09 Aug 2023 09:44:50 -0700 (PDT)", "from hermes.local (204-195-127-207.wavecable.com. [204.195.127.207])\n by smtp.gmail.com with ESMTPSA id\n i8-20020a17090332c800b001b8b0ac2258sm11426394plr.174.2023.08.09.09.44.48\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Wed, 09 Aug 2023 09:44:48 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=networkplumber-org.20221208.gappssmtp.com; s=20221208; t=1691599489;\n x=1692204289;\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=Vp81gVBBZBKOV8LKne5JfWqII6Dw/Hq5ty7FEWxkB74=;\n b=bvr7rVcOvZf3NJN79syB0ZuoQNpOZZzcwhZjkQbOtDxwwyicXGez8PpjzG9AoGNubo\n G0U+JZt5RGZ49fHMNgay73LBZLIAk5cCRFIBE4Tr11Ot/6qquU827IqaCYZP7XDeWiOh\n m8FDPYg5LVcKjYM3dvDXeKzt6vPzvc5yhEyUVcPO2I1cqsGlHi1G1woqTFe5FgooiU0V\n lUS9WN1rjTgOa+BX+aKh8Zg0UllQh0gVtgtzbQnBvgj308TH8UkfZd5XoWge//2TwjZP\n ekdq3aF+2di7HDFJWuNlOeSrK+kmWK3te+KKjacr51rWars6nh7ldWxCqHljUJz3Jybl\n m1gw==", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20221208; t=1691599489; x=1692204289;\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=Vp81gVBBZBKOV8LKne5JfWqII6Dw/Hq5ty7FEWxkB74=;\n b=AMEOwVKxl6X1+nD+UqRqT3x+zL9r238WOpXp7ACHPfT8H9643kc6TtYuxYv62wK5Ob\n TmsY7a7tKimAB9SY/+aLKNRI89lNuB3ss6/luakEHnPtSLzEwLzNrDw5AeJakiMvaCa4\n OeiwKUDjnEAjnGgSEtWZhwOHopBIxnO/mz1w53Mb+WiG02PfhEjy+1J/DzNmPfiSQS2n\n carg8qVRW7l6z1F28lf+L95+nMz0rMwLlFQE7yH1K+USzVkVB+3s3OollUQ/e3D6Odon\n MR7t6aSlFPZGi7TDqYrQ2Vh/EgHfK3Z8y66Ht7Ip9TnR8gmosSX7K/nIG2tNjhSxjZhj\n JmmA==", "X-Gm-Message-State": "AOJu0YwUXHVJp6scFhsRt1+k3APEjodK2La2YPN5WmHaThDUoHfxfrZm\n sy7nkyr2gb3DDsIFksahzhzDAOK07nBBQrUV+PPHeg==", "X-Google-Smtp-Source": "\n AGHT+IGY2eBo6a0R2HGKWnlrFgkiKd3xNFF0/bKD1F5KB7s7w9vJ5CllzLYKWRMOhSjBvNxVOJTJLA==", "X-Received": "by 2002:a17:902:ea01:b0:1b9:e8a5:3699 with SMTP id\n s1-20020a170902ea0100b001b9e8a53699mr3503628plg.21.1691599489126;\n Wed, 09 Aug 2023 09:44:49 -0700 (PDT)", "From": "Stephen Hemminger <stephen@networkplumber.org>", "To": "dev@dpdk.org", "Cc": "Stephen Hemminger <stephen@networkplumber.org>", "Subject": "[PATCH 12/15] eal: make most rte_thread API's stable", "Date": "Wed, 9 Aug 2023 09:43:04 -0700", "Message-Id": "<20230809164312.308093-13-stephen@networkplumber.org>", "X-Mailer": "git-send-email 2.39.2", "In-Reply-To": "<20230809164312.308093-1-stephen@networkplumber.org>", "References": "<20230809164312.308093-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": "All rte_thread API's added before 23.03 release should be\nmarked as not experimental.\n\nSigned-off-by: Stephen Hemminger <stephen@networkplumber.org>\n---\n lib/eal/include/rte_thread.h | 57 ------------------------------------\n lib/eal/version.map | 41 +++++++++++---------------\n 2 files changed, 17 insertions(+), 81 deletions(-)", "diff": "diff --git a/lib/eal/include/rte_thread.h b/lib/eal/include/rte_thread.h\nindex 369e2375f6a0..7da5794fc258 100644\n--- a/lib/eal/include/rte_thread.h\n+++ b/lib/eal/include/rte_thread.h\n@@ -68,9 +68,6 @@ typedef struct {\n typedef struct eal_tls_key *rte_thread_key;\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Create a new thread that will invoke the 'thread_func' routine.\n *\n * @param thread_id\n@@ -89,7 +86,6 @@ typedef struct eal_tls_key *rte_thread_key;\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_create(rte_thread_t *thread_id,\n \t\tconst rte_thread_attr_t *thread_attr,\n \t\trte_thread_func thread_func, void *arg);\n@@ -128,9 +124,6 @@ rte_thread_create_control(rte_thread_t *thread, const char *name,\n \tvoid *arg);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Waits for the thread identified by 'thread_id' to terminate\n *\n * @param thread_id\n@@ -143,13 +136,9 @@ rte_thread_create_control(rte_thread_t *thread, const char *name,\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_join(rte_thread_t thread_id, uint32_t *value_ptr);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Indicate that the return value of the thread is not needed and\n * all thread resources should be release when the thread terminates.\n *\n@@ -160,19 +149,14 @@ int rte_thread_join(rte_thread_t thread_id, uint32_t *value_ptr);\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_detach(rte_thread_t thread_id);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Get the id of the calling thread.\n *\n * @return\n * Return the thread id of the calling thread.\n */\n-__rte_experimental\n rte_thread_t rte_thread_self(void);\n \n /**\n@@ -196,9 +180,6 @@ void\n rte_thread_set_name(rte_thread_t thread_id, const char *thread_name);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Check if 2 thread ids are equal.\n *\n * @param t1\n@@ -211,13 +192,9 @@ rte_thread_set_name(rte_thread_t thread_id, const char *thread_name);\n * If the ids are equal, return nonzero.\n * Otherwise, return 0.\n */\n-__rte_experimental\n int rte_thread_equal(rte_thread_t t1, rte_thread_t t2);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Initialize the attributes of a thread.\n * These attributes can be passed to the rte_thread_create() function\n * that will create a new thread and set its attributes according to attr.\n@@ -229,13 +206,9 @@ int rte_thread_equal(rte_thread_t t1, rte_thread_t t2);\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_attr_init(rte_thread_attr_t *attr);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Set the thread priority value in the thread attributes pointed to\n * by 'thread_attr'.\n *\n@@ -249,16 +222,12 @@ int rte_thread_attr_init(rte_thread_attr_t *attr);\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_attr_set_priority(rte_thread_attr_t *thread_attr,\n \t\tenum rte_thread_priority priority);\n \n #ifdef RTE_HAS_CPUSET\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Set the CPU affinity value in the thread attributes pointed to\n * by 'thread_attr'.\n *\n@@ -272,14 +241,10 @@ int rte_thread_attr_set_priority(rte_thread_attr_t *thread_attr,\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_attr_set_affinity(rte_thread_attr_t *thread_attr,\n \t\trte_cpuset_t *cpuset);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Get the value of CPU affinity that is set in the thread attributes pointed\n * to by 'thread_attr'.\n *\n@@ -293,14 +258,10 @@ int rte_thread_attr_set_affinity(rte_thread_attr_t *thread_attr,\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_attr_get_affinity(rte_thread_attr_t *thread_attr,\n \t\trte_cpuset_t *cpuset);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Set the affinity of thread 'thread_id' to the cpu set\n * specified by 'cpuset'.\n *\n@@ -314,14 +275,10 @@ int rte_thread_attr_get_affinity(rte_thread_attr_t *thread_attr,\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_set_affinity_by_id(rte_thread_t thread_id,\n \t\tconst rte_cpuset_t *cpuset);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Get the affinity of thread 'thread_id' and store it\n * in 'cpuset'.\n *\n@@ -335,7 +292,6 @@ int rte_thread_set_affinity_by_id(rte_thread_t thread_id,\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_get_affinity_by_id(rte_thread_t thread_id,\n \t\trte_cpuset_t *cpuset);\n \n@@ -362,9 +318,6 @@ void rte_thread_get_affinity(rte_cpuset_t *cpusetp);\n #endif /* RTE_HAS_CPUSET */\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Get the priority of a thread.\n *\n * @param thread_id\n@@ -377,14 +330,10 @@ void rte_thread_get_affinity(rte_cpuset_t *cpusetp);\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_get_priority(rte_thread_t thread_id,\n \t\tenum rte_thread_priority *priority);\n \n /**\n- * @warning\n- * @b EXPERIMENTAL: this API may change without prior notice.\n- *\n * Set the priority of a thread.\n *\n * @param thread_id\n@@ -397,7 +346,6 @@ int rte_thread_get_priority(rte_thread_t thread_id,\n * On success, return 0.\n * On failure, return a positive errno-style error number.\n */\n-__rte_experimental\n int rte_thread_set_priority(rte_thread_t thread_id,\n \t\tenum rte_thread_priority priority);\n \n@@ -418,8 +366,6 @@ int rte_thread_set_priority(rte_thread_t thread_id,\n * rte_errno can be: ENOMEM - Memory allocation error.\n * ENOEXEC - Specific OS error.\n */\n-\n-__rte_experimental\n int rte_thread_key_create(rte_thread_key *key,\n \t\t\tvoid (*destructor)(void *));\n \n@@ -435,7 +381,6 @@ int rte_thread_key_create(rte_thread_key *key,\n * rte_errno can be: EINVAL - Invalid parameter passed.\n * ENOEXEC - Specific OS error.\n */\n-__rte_experimental\n int rte_thread_key_delete(rte_thread_key key);\n \n /**\n@@ -452,7 +397,6 @@ int rte_thread_key_delete(rte_thread_key key);\n * rte_errno can be: EINVAL - Invalid parameter passed.\n * ENOEXEC - Specific OS error.\n */\n-__rte_experimental\n int rte_thread_value_set(rte_thread_key key, const void *value);\n \n /**\n@@ -467,7 +411,6 @@ int rte_thread_value_set(rte_thread_key key, const void *value);\n * rte_errno can be: EINVAL - Invalid parameter passed.\n * ENOEXEC - Specific OS error.\n */\n-__rte_experimental\n void *rte_thread_value_get(rte_thread_key key);\n \n #ifdef __cplusplus\ndiff --git a/lib/eal/version.map b/lib/eal/version.map\nindex d75a7379cbdf..a71147aec83f 100644\n--- a/lib/eal/version.map\n+++ b/lib/eal/version.map\n@@ -298,12 +298,29 @@ DPDK_24 {\n \trte_strscpy;\n \trte_strsplit;\n \trte_sys_gettid;\n+\trte_thread_attr_get_affinity;\n+\trte_thread_attr_init;\n+\trte_thread_attr_set_affinity;\n+\trte_thread_attr_set_priority;\n+\trte_thread_create;\n+\trte_thread_detach;\n+\trte_thread_equal;\n \trte_thread_get_affinity;\n+\trte_thread_get_affinity_by_id;\n+\trte_thread_get_priority;\n \trte_thread_is_intr;\n+\trte_thread_join;\n+\trte_thread_key_create;\n+\trte_thread_key_delete;\n \trte_thread_register;\n+\trte_thread_self;\n \trte_thread_set_affinity;\n+\trte_thread_set_affinity_by_id;\n+\trte_thread_set_priority;\n \trte_thread_setname;\n \trte_thread_unregister;\n+\trte_thread_value_get;\n+\trte_thread_value_set;\n \trte_uuid_compare;\n \trte_uuid_is_null;\n \trte_uuid_parse;\n@@ -389,34 +406,10 @@ EXPERIMENTAL {\n \trte_power_monitor_wakeup; # WINDOWS_NO_EXPORT\n \trte_power_pause; # WINDOWS_NO_EXPORT\n \n-\t# added in 21.05\n-\trte_thread_key_create;\n-\trte_thread_key_delete;\n-\trte_thread_value_get;\n-\trte_thread_value_set;\n \n \t# added in 21.08\n \trte_power_monitor_multi; # WINDOWS_NO_EXPORT\n \n-\t# added in 21.11\n-\n-\t# added in 22.07\n-\trte_thread_get_affinity_by_id;\n-\trte_thread_get_priority;\n-\trte_thread_self;\n-\trte_thread_set_affinity_by_id;\n-\trte_thread_set_priority;\n-\n-\t# added in 22.11\n-\trte_thread_attr_get_affinity;\n-\trte_thread_attr_init;\n-\trte_thread_attr_set_affinity;\n-\trte_thread_attr_set_priority;\n-\trte_thread_create;\n-\trte_thread_detach;\n-\trte_thread_equal;\n-\trte_thread_join;\n-\n \t# added in 23.03\n \trte_lcore_register_usage_cb;\n \trte_thread_create_control;\n", "prefixes": [ "12/15" ] }{ "id": 130061, "url": "