plucky (2) thr_self.2freebsd.gz

Provided by: freebsd-manpages_12.2-2_all bug

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
     The thr_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
     The thr_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
     The thr_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.