Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
THR_SELF(2)		  FreeBSD 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
     The thr_self() system call	stores the system-wide thread identifier for
     the current kernel-scheduled thread in the	variable pointed by the	argu-
     ment 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.

FreeBSD	Ports 11.2		 June 1, 2016		    FreeBSD Ports 11.2

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | STANDARDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=thr_self&manpath=FreeBSD+Ports+12.0>

home | help