table of contents
THR_SELF(2) | System Calls Manual | THR_SELF(2) |
NAME¶
thr_self
—
return thread identifier for the calling thread
LIBRARY¶
Standard C Library (libc, -lc)SYNOPSIS¶
#include <sys/thr.h>
int
thr_self
(long
*id);
DESCRIPTION¶
Thethr_self
() system call stores the system-wide thread
identifier for the current kernel-scheduled thread in the variable pointed by
the argument id.
The thread identifier is an integer in the range from
PID_MAX + 2
(10002) to
INT_MAX
. The thread identifier is guaranteed to be
unique at any given time, for each running thread in the system. After the
thread exits, the identifier may be reused.
RETURN VALUES¶
If successful,thr_self
() will return zero, otherwise -1
is returned, and errno is set to indicate the error.
ERRORS¶
Thethr_self
() operation may return the following
errors:
- [
EFAULT
] - The memory pointed to by the id argument is not valid.
SEE ALSO¶
thr_exit(2), thr_kill(2), thr_kill2(2), thr_new(2), thr_set_name(2), _umtx_op(2), pthread_getthreadid_np(3), pthread_self(3)STANDARDS¶
Thethr_self
() system call is non-standard and is used
by 1:1 Threading Library (libthr, -lthr) to implement
IEEE Std 1003.1-2001 (“POSIX.1”)
pthread(3) functionality.
June 1, 2016 | Linux 4.19.0-10-amd64 |