about summary refs log tree commit diff
path: root/manual/process.texi
diff options
context:
space:
mode:
authorFlorian Weimer <fweimer@redhat.com>2019-02-02 15:17:02 +0100
committerFlorian Weimer <fweimer@redhat.com>2019-02-08 11:27:55 +0100
commit1d0fc213824eaa2a8f8c4385daaa698ee8fb7c92 (patch)
treea1979a3d4ef860e9f4565aab20cb2549b0a3303e /manual/process.texi
parentf289e656ec8221756519a601042bc9fbe1b310fb (diff)
downloadglibc-1d0fc213824eaa2a8f8c4385daaa698ee8fb7c92.tar.gz
glibc-1d0fc213824eaa2a8f8c4385daaa698ee8fb7c92.tar.xz
glibc-1d0fc213824eaa2a8f8c4385daaa698ee8fb7c92.zip
Linux: Add gettid system call wrapper [BZ #6399]
This commit adds gettid to <unistd.h> on Linux, and not to the
kernel-independent GNU API.

gettid is now supportable on Linux because too many things assume a
1:1 mapping between libpthread threads and kernel threads.

Reviewed-by: Carlos O'Donell <carlos@redhat.com>
Diffstat (limited to 'manual/process.texi')
-rw-r--r--manual/process.texi11
1 files changed, 11 insertions, 0 deletions
diff --git a/manual/process.texi b/manual/process.texi
index 652b0001b5..5728bde2cb 100644
--- a/manual/process.texi
+++ b/manual/process.texi
@@ -228,6 +228,17 @@ The @code{getppid} function returns the process ID of the parent of the
 current process.
 @end deftypefun
 
+@deftypefun pid_t gettid (void)
+@standards{Linux, unistd.h}
+@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
+The @code{gettid} function returns the thread ID of the current
+thread.  The returned value is obtained from the Linux kernel and is
+not subject to caching.  See the discussion of thread IDs above,
+especially regarding reuse of the IDs of threads which have exited.
+
+This function is specific to Linux.
+@end deftypefun
+
 @node Creating a Process
 @section Creating a Process