From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
by inbox.dpdk.org (Postfix) with ESMTP id 11924A0543;
Wed, 14 Dec 2022 17:47:36 +0100 (CET)
Received: from mails.dpdk.org (localhost [127.0.0.1])
by mails.dpdk.org (Postfix) with ESMTP id 1525442B71;
Wed, 14 Dec 2022 17:47:28 +0100 (CET)
Received: from linux.microsoft.com (linux.microsoft.com [13.77.154.182])
by mails.dpdk.org (Postfix) with ESMTP id 7438B40684
for <dev@dpdk.org>; Wed, 14 Dec 2022 17:47:24 +0100 (CET)
Received: by linux.microsoft.com (Postfix, from userid 1086)
id 9CD0120B87D1; Wed, 14 Dec 2022 08:47:23 -0800 (PST)
DKIM-Filter: OpenDKIM Filter v2.11.0 linux.microsoft.com 9CD0120B87D1
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.microsoft.com;
s=default; t=1671036443;
bh=mS0vfpOXlyWv/ivcbxMisTzucx19NzqjqLTnN1nzBck=;
h=From:To:Cc:Subject:Date:In-Reply-To:References:From;
b=KBW9jITH+c/JjmHO0Ec+fZfPo1ifzB0e2qbw7Ow1h8RXPgEPHvNdBKvbaRLmzlhMq
Lfk2zmO0h0bof+Abg5u1cg4sjWm069DORYDrdoipJbKBVIulRwpV8r3koYqOclff7I
QZ3nOmBiuJc8m9/kTZzSeSnSCOf2gGd0ZuHc5dDE=
From: Tyler Retzlaff <roretzla@linux.microsoft.com>
To: dev@dpdk.org
Cc: thomas@monjalon.net, david.marchand@redhat.com, olivier.matz@6wind.com,
stephen@networkplumber.org, mb@smartsharesystems.com,
Tyler Retzlaff <roretzla@linux.microsoft.com>
Subject: [PATCH v2 3/4] eal: deprecate rte thread setname API
Date: Wed, 14 Dec 2022 08:47:20 -0800
Message-Id: <1671036441-10234-4-git-send-email-roretzla@linux.microsoft.com>
X-Mailer: git-send-email 1.8.3.1
In-Reply-To: <1671036441-10234-1-git-send-email-roretzla@linux.microsoft.com>
References: <1670439617-9054-1-git-send-email-roretzla@linux.microsoft.com>
<1671036441-10234-1-git-send-email-roretzla@linux.microsoft.com>
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>,
<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>,
<mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Notify deprecation of rte_thread_setname API, it is being removed as it
exposes platform-specific thread details. The functionality it provided
is now implicitly provided via the rte_lcore_set_name API if the
underlying platform supports it.
Signed-off-by: Tyler Retzlaff <roretzla@linux.microsoft.com>
---
doc/guides/rel_notes/deprecation.rst | 4 ++++
lib/eal/include/rte_lcore.h | 2 ++
2 files changed, 6 insertions(+)
diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index b9b02dc..b03c935 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -119,3 +119,7 @@ Deprecation Notices
Its removal has been postponed to let potential users report interest
in maintaining it.
In the absence of such interest, this library will be removed in DPDK 23.11.
+
+* eal: The function ``rte_thread_setname`` will be removed, continuing
+ the effort to decouple EAL from platform-specific thread
+ implementations.
diff --git a/lib/eal/include/rte_lcore.h b/lib/eal/include/rte_lcore.h
index 9c78650..2fb3091 100644
--- a/lib/eal/include/rte_lcore.h
+++ b/lib/eal/include/rte_lcore.h
@@ -13,6 +13,7 @@
*/
#include <stdio.h>
+#include <rte_common.h>
#include <rte_compat.h>
#include <rte_config.h>
#include <rte_per_lcore.h>
@@ -349,6 +350,7 @@ enum rte_lcore_role_t {
* @return
* On success, return 0; otherwise return a negative value.
*/
+__rte_deprecated
int rte_thread_setname(pthread_t id, const char *name);
/**
--
1.8.3.1