From patchwork Thu Nov 13 12:44:13 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alyssa Ross X-Patchwork-Id: 124137 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 61B213858C98 for ; Thu, 13 Nov 2025 12:45:49 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 61B213858C98 Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=alyssa.is header.i=@alyssa.is header.a=rsa-sha256 header.s=fm2 header.b=LHmJXRIf; dkim=pass (2048-bit key, unprotected) header.d=messagingengine.com header.i=@messagingengine.com header.a=rsa-sha256 header.s=fm3 header.b=07MgzAby X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from fhigh-a2-smtp.messagingengine.com (fhigh-a2-smtp.messagingengine.com [103.168.172.153]) by sourceware.org (Postfix) with ESMTPS id E2CDE3858D20 for ; Thu, 13 Nov 2025 12:45:09 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org E2CDE3858D20 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=alyssa.is Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=alyssa.is ARC-Filter: OpenARC Filter v1.0.0 sourceware.org E2CDE3858D20 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=103.168.172.153 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1763037910; cv=none; b=ZIRNjD49SQmrWA5aEPcGh1neAXaEtRrv9dlbF+Ij0ptTpRZ/eubkU7luxjqr/60qxMwWPD9hbaEmsigpxTIQb9cP37YTT4gF2yWYc0E/Z1vWJqdBGNXla0830jakezuSpXB59h4xKvS+J4PgMfd6TmLR/HtrZfnb4JjDBMgxPDg= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1763037910; c=relaxed/simple; bh=niovNR25UV01xNRwGgmd4HilscMqcJHdYHH14ryuBPc=; h=DKIM-Signature:DKIM-Signature:From:To:Subject:Date:Message-ID: MIME-Version; b=F+/aGVkL2IC+k49Nc9GiPNciK8rzmqMXGJSnCx2qNXwc4S86Bic5yuBhRJ453uYrX+c0PrC4fIynjOV86tjiTiKQYL9NwaDt9hfAD7AaShgRfM5ZSYXXVZdeT2M2kqwYXPh4XbesiF2svp73zuro0AtRIEaUKBYJHK+vyfmwnHs= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org E2CDE3858D20 Received: from phl-compute-03.internal (phl-compute-03.internal [10.202.2.43]) by mailfhigh.phl.internal (Postfix) with ESMTP id ADF471400188; Thu, 13 Nov 2025 07:45:09 -0500 (EST) Received: from phl-mailfrontend-01 ([10.202.2.162]) by phl-compute-03.internal (MEProxy); Thu, 13 Nov 2025 07:45:09 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h=cc :cc:content-transfer-encoding:content-type:date:date:from:from :in-reply-to:message-id:mime-version:reply-to:subject:subject:to :to; s=fm2; t=1763037909; x=1763124309; bh=1hU6PKUVIgVeeM7zfmuM/ /OuiRmA39eoG+zyOo+Rpjs=; b=LHmJXRIf86KPnLD8thb1paJfDLLvqXeE+FjNR L6BoQiuXdjzmF9dkd4ip/8ZQtcSnBsm4Hkj9UOoClzYG9Gt9yM2/pzqb0BiCg/+b 31dBpt0o+NFBbzmqQ6RPPvA8SKYfoe6sBMqKsLnBg2BhmSNg3JuYwOOhRRGqjNvZ Aew7Q3mGMvsBw/1VZLTIZoqF8287iGI+NqQ0jVOkAKJapgdCt9ok3krj+buBFhB7 adWGO3OKHafCMqFiTNx0D4mTvjq3Klsb5uKL7vLwmMg8V6d5SxsQ6bI1q+QasARo zLxkk67YFVT0J9X6BwR1rYgIDT5KtFW5vjWIxZN10/34bB8Hw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:message-id:mime-version:reply-to:subject:subject:to :to:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t= 1763037909; x=1763124309; bh=1hU6PKUVIgVeeM7zfmuM//OuiRmA39eoG+z yOo+Rpjs=; b=07MgzAbyxLXqdWQE5jWt6Y/nKwuY4WvZjLFfYos+MqiHxpBLsK/ mU6m9p/5B8OJOJSXFa4YgF2lyPTDNOKIAjT8rA+YI3fGvT3jNYeigDOusGb/yidW UiwhrPmWxbM1F6OXDOKINzo8QXAv2HJRLXBHZEl8yvOi+s224Pj3cwwUI6Fy8y4s OKx6AMcB+tpnLnRMBjf898WOC2GqiWok+cY9j1BTtdfrwcYpcZDO1WqsEk5anPN1 pAb1bT6hE/+m3O3sL23XwGyJg9cEVt/rzXNH9GLFlfOOjrRRskQopQmH1KcRZkss HnQuaoSeCPqooFhI8zO6A9mGsoWqKzXJQlw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeffedrtdeggddvtdeileekucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfurfetoffkrfgpnffqhgenuceu rghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmnecujf gurhephffvvefufffkofgggfestdekredtredttdenucfhrhhomheptehlhihsshgrucft ohhsshcuoehhihesrghlhihsshgrrdhisheqnecuggftrfgrthhtvghrnhepheejkedtud fhueduueekieejvdfghfekudeftdduieeifeejfefgledukeeuteeinecuffhomhgrihhn peduqddvtddvgedrihhnpdhsohhurhgtvgifrghrvgdrohhrghenucevlhhushhtvghruf hiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehhihesrghlhihsshgrrdhishdp nhgspghrtghpthhtohepfedpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtoheptgholh hlihhnrdhfuhhnkhdusehgmhgrihhlrdgtohhmpdhrtghpthhtoheptggrrhhlohhssehr vgguhhgrthdrtghomhdprhgtphhtthhopehlihgstgdqrghlphhhrgesshhouhhrtggvfi grrhgvrdhorhhg X-ME-Proxy: Feedback-ID: i12284293:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 13 Nov 2025 07:45:09 -0500 (EST) Received: by mbp.qyliss.net (Postfix, from userid 1000) id 3F4E8696B593; Thu, 13 Nov 2025 13:45:08 +0100 (CET) From: Alyssa Ross To: libc-alpha@sourceware.org Cc: Carlos O'Donell , Collin Funk Subject: [PATCH v2] pthread: add PTHREAD_NULL Date: Thu, 13 Nov 2025 13:44:13 +0100 Message-ID: <20251113124412.38651-2-hi@alyssa.is> X-Mailer: git-send-email 2.51.0 MIME-Version: 1.0 X-Spam-Status: No, score=-10.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, JMQ_SPF_NEUTRAL, RCVD_IN_DNSWL_LOW, RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libc-alpha-bounces~patchwork=sourceware.org@sourceware.org New in POSIX.1-2024. In htl, pthread_t values are integers starting at 1, so 0 is a safe null value. In nptl, pthread_t values are non-null pointers, so 0 is a safe null value. --- v2: hide behind __USE_XOPEN2K24 v1: https://inbox.sourceware.org/libc-alpha/20251101193213.684326-2-hi@alyssa.is/ manual/threads.texi | 5 +++++ sysdeps/htl/pthread.h | 4 ++++ sysdeps/nptl/pthread.h | 5 +++++ 3 files changed, 14 insertions(+) base-commit: 2254e871f49b8844a77367318d8b9cd8ca839374 diff --git a/manual/threads.texi b/manual/threads.texi index b9d12479ca..6ccbb0a3ab 100644 --- a/manual/threads.texi +++ b/manual/threads.texi @@ -1112,6 +1112,11 @@ This function gets the kind of mutex @var{mutex} is. @node POSIX Threads Other APIs @subsection POSIX Threads Other APIs +@deftypevr Macro pthread_t PTHREAD_NULL +@standards{POSIX.1-2024, pthread.h} +A value for pthread_t that is not considered equal to any thread ID. +@end deftypevr + @deftypefun int pthread_equal (pthread_t @var{thread1}, pthread_t @var{thread2}) Compares two thread IDs. If they are the same, returns nonzero, else returns zero. @manpagefunctionstub{pthread_equal, 3} diff --git a/sysdeps/htl/pthread.h b/sysdeps/htl/pthread.h index a299fec278..af322e5b8a 100644 --- a/sysdeps/htl/pthread.h +++ b/sysdeps/htl/pthread.h @@ -55,6 +55,10 @@ __BEGIN_DECLS #include +#ifdef __USE_XOPEN2K24 +# define PTHREAD_NULL ((pthread_t)0) +#endif + /* Possible values for the process shared attribute. */ #define PTHREAD_PROCESS_PRIVATE __PTHREAD_PROCESS_PRIVATE #define PTHREAD_PROCESS_SHARED __PTHREAD_PROCESS_SHARED diff --git a/sysdeps/nptl/pthread.h b/sysdeps/nptl/pthread.h index 92957a620d..f3b66d7bf4 100644 --- a/sysdeps/nptl/pthread.h +++ b/sysdeps/nptl/pthread.h @@ -33,6 +33,11 @@ # include #endif +#ifdef __USE_XOPEN2K24 +# define PTHREAD_NULL ((pthread_t)0) +#endif + + /* Detach state. */ enum {