LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

pthreads.7: Add a section describing thread IDs 

In particular, note that in each pthreads function that takes
a thread ID argument, that ID by definition refers to a thread
in the same process as the caller.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2008-11-06 09:37:23 -05:00
parent 3ba07ec788
commit 84ee6c22e3
1 changed files with 15 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
man7/pthreads.7
View File

@ -21,7 +21,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by .\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.TH PTHREADS 7 2008-10-16 "Linux" "Linux Programmer's Manual" .TH PTHREADS 7 2008-11-07 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
pthreads \- POSIX threads pthreads \- POSIX threads
.SH DESCRIPTION .SH DESCRIPTION
@ -113,6 +113,20 @@ Note that the pthreads functions do not set
For each of the pthreads functions that can return an error, For each of the pthreads functions that can return an error,
POSIX.1-2001 specifies that the function can never fail with the error POSIX.1-2001 specifies that the function can never fail with the error
.BR EINTR . .BR EINTR .
.SS Thread IDs
Each of the threads in a process has a unique thread identifier
(stored in the type
.IR pthread_t ).
This identifier is returned to the caller of
.BR pthread_create (3),
and a thread can obtain its own thread identifier using
.BR pthread_self (3).
Thread IDs are only guaranteed to be unique within a process.
A thread ID may be reused after a terminated thread has been joined,
or a detached thread has terminated.
In all pthreads functions that accept a thread ID as an argument,
that ID by definition refers to a thread in
the same process as the caller.
.SS "Thread-safe functions" .SS "Thread-safe functions"
A thread-safe function is one that can be safely A thread-safe function is one that can be safely
(i.e., it will deliver the same results regardless of whether it is) (i.e., it will deliver the same results regardless of whether it is)