home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | VERSIONS | CONFORMING TO | NOTES | SEE ALSO | COLOPHONThe Linux Programming Interface


GETTID(2)                     Linux Programmer's Manual                     GETTID(2)

NAME         top

       gettid - get thread identification

SYNOPSIS         top

       #include <sys/types.h>

       pid_t gettid(void);

DESCRIPTION         top

       gettid() returns the caller's thread ID (TID).  In a single-threaded process,
       the thread ID is equal to the process ID (PID, as returned by getpid(2)).  In
       a multithreaded process, all threads have the same PID, but each one has a
       unique TID.  For further details, see the discussion of CLONE_THREAD in
       clone(2).

RETURN VALUE         top

       On success, returns the thread ID of the calling process.

ERRORS         top

       This call is always successful.

VERSIONS         top

       The gettid() system call first appeared on Linux in kernel 2.4.11.

CONFORMING TO         top

       gettid() is Linux-specific and should not be used in programs that are
       intended to be portable.

NOTES         top

       Glibc does not provide a wrapper for this system call; call it using
       syscall(2).

       The thread ID returned by this call is not the same thing as a POSIX thread ID
       (i.e., the opaque value returned by pthread_self(3)).

SEE ALSO         top

       clone(2), fork(2), getpid(2)

COLOPHON         top

       This page is part of release 3.32 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

Linux                                 2008-04-14                            GETTID(2)

HTML rendering created 2010-12-03 by Michael Kerrisk, author of The Linux Programming Interface

customisable counter