In a Linux C program, how do I print the thread id of a thread created by the pthread library? For example like how we can get pid of a process by getpid()
.
-
See also: Difference between __NR_gettid and SYS_gettid and getting error in c program "undefined reference to gettid".– Gabriel StaplesSep 22, 2021 at 21:34
12 Answers
What? The person asked for Linux specific, and the equivalent of getpid()
. Not BSD or Apple. The answer is gettid()
and returns an integral type. You will have to call it using syscall()
, like this:
#include <sys/types.h>
#include <unistd.h>
#include <sys/syscall.h>
....
pid_t x = syscall(__NR_gettid);
While this may not be portable to non-linux systems, the threadid is directly comparable and very fast to acquire. It can be printed (such as for LOGs) like a normal integer.
-
18
-
2The person asked about something that worked on Linux. Doing so in a portable way seems to me like the preferable way to do it. If portability doesn't count for anything then I guess Linux is really becoming the new Windows... Dec 19, 2019 at 11:26
-
4@Jasper Siepkes You are missing the point. He asked for a LINUX call that was the equivalent of getpid() for threads. That is gettid(). The question didn't ask about portability or POSIX. Too many people want to show off and try and teach rather than asking the question as asked. pthread_self() does not return the kernel thread id and it not manipulatable in a way that makes for easy printing. Also, pthread_self is likely a pointer and should not be manipulated, only compared with pthread_equal(). The question asked for an ID you can print, and that's gettid(). Dec 20, 2019 at 12:39
-
4@EvanLanglois He's working with the pthread library, literally the POSIX thread library. Making a POSIX compatible answer not that weird. "He asked for a LINUX call that was the equivalent of getpid() for threads." No,
getpid()
was given as an example. It didn't say the semantics were a hard specification. Making people aware of doing things in a POSIX compatible way so other communities besides Linux (like FreeBSD, Illumos, OS X, etc.) can benefit from them is not "showing off". Like I said I guess Linux has really become the next Windows. Mar 30, 2020 at 16:20 -
2On Linux Ubuntu 18.04 with
gcc --version
gcc (Ubuntu 8.4.0-1ubuntu1~18.04) 8.4.0
I had to also add#define _GNU_SOURCE
above all of the includes in order forsyscall()
to be defined. I learned that from the example at the bottom of this documentation here: man7.org/linux/man-pages/man2/syscall.2.html. Sep 24, 2021 at 0:56
pthread_self()
function will give the thread id of current thread.
pthread_t pthread_self(void);
The pthread_self()
function returns the Pthread handle of the calling thread. The pthread_self() function does NOT return the integral thread of the calling thread. You must use pthread_getthreadid_np()
to return an integral identifier for the thread.
NOTE:
pthread_id_np_t tid;
tid = pthread_getthreadid_np();
is significantly faster than these calls, but provides the same behavior.
pthread_id_np_t tid;
pthread_t self;
self = pthread_self();
pthread_getunique_np(&self, &tid);
-
45The original question was about Linux. Linux does not include the _np functions. (It doesn't include their man pages, I didn't check any further than that.) Apr 24, 2014 at 4:30
-
-
@Bleater Can you please provide the official documentation for
pthread_threadid_np
. Am in need to use for a project, so need to check on the reliability of that API in iOS and OSX platforms. Referred the link at opensource.apple.com/source/Libc/Libc-583/pthreads/pthread.h but not sure if they are the right one. Feb 23, 2015 at 14:26 -
15@Trade-IdeasPhilip - To clarify,
_np
means non-portable. Linux has its own_np
stuff, but it doesn't include Apple'spthread_getthreadid_np
. Oct 28, 2015 at 17:18 -
1Some important note: A
pthread_t
is a kind of pointer in Linux. So if you run the same program multiple times, you may see the samepthread_t
, while the actual threads are different. Thus printing thepthread_t
does not help very much.– U. WindlAug 10, 2020 at 10:37
As noted in other answers, pthreads does not define a platform-independent way to retrieve an integral thread ID.
On Linux systems, you can get thread ID thus:
#include <sys/types.h>
pid_t tid = gettid();
On many BSD-based platforms, this answer https://stackoverflow.com/a/21206357/316487 gives a non-portable way.
However, if the reason you think you need a thread ID is to know whether you're running on the same or different thread to another thread you control, you might find some utility in this approach
static pthread_t threadA;
// On thread A...
threadA = pthread_self();
// On thread B...
pthread_t threadB = pthread_self();
if (pthread_equal(threadA, threadB)) printf("Thread B is same as thread A.\n");
else printf("Thread B is NOT same as thread A.\n");
If you just need to know if you're on the main thread, there are additional ways, documented in answers to this question how can I tell if pthread_self is the main (first) thread in the process?.
pid_t tid = syscall(SYS_gettid);
Linux provides such system call to allow you get id of a thread.
-
3As per this answer, you need
#include <unistd.h>
and#include <sys/syscall.h>
for this.– ComFreekDec 1, 2020 at 13:49
You can use pthread_self()
The parent gets to know the thread id after the pthread_create()
is executed sucessfully, but while executing the thread if we want to access the thread id we have to use the function pthread_self()
.
This single line gives you pid , each threadid and spid.
printf("before calling pthread_create getpid: %d getpthread_self: %lu tid:%lu\n",getpid(), pthread_self(), syscall(SYS_gettid));
I think not only is the question not clear but most people also are not cognizant of the difference. Examine the following saying,
POSIX thread IDs are not the same as the thread IDs returned by the Linux specific
gettid()
system call. POSIX thread IDs are assigned and maintained by the threading implementation. The thread ID returned bygettid()
is a number (similar to a process ID) that is assigned by the kernel. Although each POSIX thread has a unique kernel thread ID in the Linux NPTL threading implementation, an application generally doesn’t need to know about the kernel IDs (and won’t be portable if it depends on knowing them).Excerpted from: The Linux Programming Interface: A Linux and UNIX System Programming Handbook, Michael Kerrisk
IMHO, there is only one portable way that pass a structure in which define a variable holding numbers in an ascending manner e.g. 1,2,3...
to per thread. By doing this, threads' id can be kept track. Nonetheless, int pthread_equal(tid1, tid2)
function should be used.
if (pthread_equal(tid1, tid2)) printf("Thread 2 is same as thread 1.\n");
else printf("Thread 2 is NOT same as thread 1.\n");
-
The
gettid()
is actually a good suggestion, thank you! However, I needed to follow the answer by Sergey L. here: stackoverflow.com/a/21280941/2430526– SRGMar 27, 2019 at 22:06
pthread_getthreadid_np
wasn't on my Mac os x. pthread_t
is an opaque type. Don't beat your head over it. Just assign it to void*
and call it good. If you need to printf
use %p
.
-
1Yes, this works. All I need is to print it for debugging so 0x23423423423abcdef is as helpful as tid=1234. Thank you!– Qi FanJul 29, 2016 at 23:22
There is also another way of getting thread id. While creating threads with
int pthread_create(pthread_t * thread, const pthread_attr_t * attr, void * (*start_routine)(void *), void *arg);
function call; the first parameter pthread_t * thread
is actually a thread id (that is an unsigned long int defined in bits/pthreadtypes.h). Also, the last argument void *arg
is the argument that is passed to void * (*start_routine)
function to be threaded.
You can create a structure to pass multiple arguments and send a pointer to a structure.
typedef struct thread_info {
pthread_t thread;
//...
} thread_info;
//...
tinfo = malloc(sizeof(thread_info) * NUMBER_OF_THREADS);
//...
pthread_create (&tinfo[i].thread, NULL, handler, (void*)&tinfo[i]);
//...
void *handler(void *targs) {
thread_info *tinfo = targs;
// here you get the thread id with tinfo->thread
}
For different OS there is different answer. I find a helper here.
You can try this:
#include <unistd.h>
#include <sys/syscall.h>
int get_thread_id() {
#if defined(__linux__)
return syscall(SYS_gettid);
#elif defined(__FreeBSD__)
long tid;
thr_self(&tid);
return (int)tid;
#elif defined(__NetBSD__)
return _lwp_self();
#elif defined(__OpenBSD__)
return getthrid();
#else
return getpid();
#endif
}
Platform-independent way (starting from c++11) is:
#include <thread>
std::this_thread::get_id();
-
1this probably isnt as "platform independent" as you think. on my implementation it resolves to a
pthread_t
. On a mac that will be a pointer and on Linux an integer. It also doesn't reflect the "native" id you might see intop
for example. Something to be aware of, but maybe its fine for some uses. Sep 28, 2018 at 22:20 -
1In C11 (the question was about C) you would use thrd_current() from threads.h– jerryDec 5, 2018 at 13:58
You can also write in this manner and it does the same. For eg:
for(int i=0;i < total; i++)
{
pthread_join(pth[i],NULL);
cout << "SUM of thread id " << pth[i] << " is " << args[i].sum << endl;
}
This program sets up an array of pthread_t and calculate sum on each. So it is printing the sum of each thread with thread id.
-
It does not answer the question, and even the description for the code is wrong!– U. WindlAug 10, 2020 at 10:41