From ff2ce8dc9ccc699704329fe7aadd9e6eed4df0a2 Mon Sep 17 00:00:00 2001
From: Andrew Halaney <andrew@amutable.com>
Date: Mon, 26 Oct 2026 15:02:11 -0500
Subject: [PATCH] man: document COREDUMP_TID= and COREDUMP_THREAD_NAME=

These journal fields and the matching user.coredump.tid and
user.coredump.thread_name xattrs were added in v261 by 4c7af7d9d1
("coredump: capture crashing thread ID and name"), but never
documented.
---
 man/systemd-coredump.xml | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/man/systemd-coredump.xml b/man/systemd-coredump.xml
index 891edd1fe94..30b67055df9 100644
--- a/man/systemd-coredump.xml
+++ b/man/systemd-coredump.xml
@@ -416,6 +416,19 @@ COREDUMP_FILENAME=/var/lib/systemd/coredump/core.Web….552351.….zst
         </listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><varname>COREDUMP_TID=</varname></term>
+        <term><varname>COREDUMP_THREAD_NAME=</varname></term>
+        <listitem><para>The thread number (TID) and name
+        (<filename>/proc/<replaceable>pid</replaceable>/task/<replaceable>tid</replaceable>/comm</filename>)
+        of the thread that triggered the core dump. For single-threaded processes the TID is the same as
+        the PID. Like <varname>COREDUMP_PID=</varname>, the TID is the value as seen in the namespace where
+        <filename>systemd-coredump</filename> is running.</para>
+
+        <xi:include href="version-info.xml" xpointer="v261"/>
+        </listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><varname>COREDUMP_BY_PIDFD=</varname></term>
         <listitem><para>If the crashed process was analyzed using a PIDFD provided by the kernel (requires
@@ -725,6 +738,16 @@ flags:   ...
 
         <xi:include href="version-info.xml" xpointer="v248"/></listitem>
       </varlistentry>
+
+      <varlistentry>
+        <term><varname>user.coredump.tid</varname></term>
+        <term><varname>user.coredump.thread_name</varname></term>
+
+        <listitem><para>Those are the same as <varname>COREDUMP_TID=</varname> and
+        <varname>COREDUMP_THREAD_NAME=</varname>, described above.</para>
+
+        <xi:include href="version-info.xml" xpointer="v261"/></listitem>
+      </varlistentry>
     </variablelist>
 
     <para>Those can be viewed using