1 //===- Unix/Threading.inc - Unix Threading Implementation ----- -*- C++ -*-===//
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //===----------------------------------------------------------------------===//
9 // This file provides the Unix specific implementation of Threading functions.
11 //===----------------------------------------------------------------------===//
13 #include "llvm/ADT/SmallString.h"
14 #include "llvm/ADT/Twine.h"
16 #if defined(__APPLE__)
17 #include <mach/mach_init.h>
18 #include <mach/mach_port.h>
23 #if defined(__FreeBSD__) || defined(__OpenBSD__)
24 #include <pthread_np.h> // For pthread_getthreadid_np() / pthread_set_name_np()
27 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
29 #include <sys/sysctl.h>
34 #if defined(__NetBSD__)
35 #include <lwp.h> // For _lwp_self()
38 #if defined(__linux__)
39 #include <sys/syscall.h> // For syscall codes
40 #include <unistd.h> // For syscall()
45 void(*UserFn)(void *);
50 static void *ExecuteOnThread_Dispatch(void *Arg) {
51 ThreadInfo *TI = reinterpret_cast<ThreadInfo*>(Arg);
52 TI->UserFn(TI->UserData);
56 void llvm::llvm_execute_on_thread(void(*Fn)(void*), void *UserData,
57 unsigned RequestedStackSize) {
58 ThreadInfo Info = { Fn, UserData };
62 // Construct the attributes object.
63 if (::pthread_attr_init(&Attr) != 0)
66 // Set the requested stack size, if given.
67 if (RequestedStackSize != 0) {
68 if (::pthread_attr_setstacksize(&Attr, RequestedStackSize) != 0)
72 // Construct and execute the thread.
73 if (::pthread_create(&Thread, &Attr, ExecuteOnThread_Dispatch, &Info) != 0)
76 // Wait for the thread and clean up.
77 ::pthread_join(Thread, nullptr);
80 ::pthread_attr_destroy(&Attr);
84 uint64_t llvm::get_threadid() {
85 #if defined(__APPLE__)
86 // Calling "mach_thread_self()" bumps the reference count on the thread
87 // port, so we need to deallocate it. mach_task_self() doesn't bump the ref
89 thread_port_t Self = mach_thread_self();
90 mach_port_deallocate(mach_task_self(), Self);
92 #elif defined(__FreeBSD__)
93 return uint64_t(pthread_getthreadid_np());
94 #elif defined(__NetBSD__)
95 return uint64_t(_lwp_self());
96 #elif defined(__ANDROID__)
97 return uint64_t(gettid());
98 #elif defined(__linux__)
99 return uint64_t(syscall(SYS_gettid));
101 return uint64_t(pthread_self());
106 static constexpr uint32_t get_max_thread_name_length_impl() {
107 #if defined(__NetBSD__)
108 return PTHREAD_MAX_NAMELEN_NP;
109 #elif defined(__APPLE__)
111 #elif defined(__linux__)
112 #if HAVE_PTHREAD_SETNAME_NP
117 #elif defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
119 #elif defined(__OpenBSD__)
126 uint32_t llvm::get_max_thread_name_length() {
127 return get_max_thread_name_length_impl();
130 void llvm::set_thread_name(const Twine &Name) {
131 // Make sure the input is null terminated.
132 SmallString<64> Storage;
133 StringRef NameStr = Name.toNullTerminatedStringRef(Storage);
135 // Truncate from the beginning, not the end, if the specified name is too
136 // long. For one, this ensures that the resulting string is still null
137 // terminated, but additionally the end of a long thread name will usually
138 // be more unique than the beginning, since a common pattern is for similar
139 // threads to share a common prefix.
140 // Note that the name length includes the null terminator.
141 if (get_max_thread_name_length() > 0)
142 NameStr = NameStr.take_back(get_max_thread_name_length() - 1);
144 #if defined(__linux__)
145 #if (defined(__GLIBC__) && defined(_GNU_SOURCE)) || defined(__ANDROID__)
146 #if HAVE_PTHREAD_SETNAME_NP
147 ::pthread_setname_np(::pthread_self(), NameStr.data());
150 #elif defined(__FreeBSD__) || defined(__OpenBSD__)
151 ::pthread_set_name_np(::pthread_self(), NameStr.data());
152 #elif defined(__NetBSD__)
153 ::pthread_setname_np(::pthread_self(), "%s",
154 const_cast<char *>(NameStr.data()));
155 #elif defined(__APPLE__)
156 ::pthread_setname_np(NameStr.data());
160 void llvm::get_thread_name(SmallVectorImpl<char> &Name) {
163 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
164 int pid = ::getpid();
165 uint64_t tid = get_threadid();
167 struct kinfo_proc *kp = nullptr, *nkp;
170 int ctl[4] = { CTL_KERN, KERN_PROC, KERN_PROC_PID | KERN_PROC_INC_THREAD,
174 error = sysctl(ctl, 4, kp, &len, nullptr, 0);
175 if (kp == nullptr || (error != 0 && errno == ENOMEM)) {
176 // Add extra space in case threads are added before next call.
177 len += sizeof(*kp) + len / 10;
178 nkp = (struct kinfo_proc *)::realloc(kp, len);
179 if (nkp == nullptr) {
191 for (size_t i = 0; i < len / sizeof(*kp); i++) {
192 if (kp[i].ki_tid == (lwpid_t)tid) {
193 Name.append(kp[i].ki_tdname, kp[i].ki_tdname + strlen(kp[i].ki_tdname));
199 #elif defined(__NetBSD__)
200 constexpr uint32_t len = get_max_thread_name_length_impl();
202 ::pthread_getname_np(::pthread_self(), buf, len);
204 Name.append(buf, buf + strlen(buf));
205 #elif defined(__OpenBSD__)
206 constexpr uint32_t len = get_max_thread_name_length_impl();
208 ::pthread_get_name_np(::pthread_self(), buf, len);
210 Name.append(buf, buf + strlen(buf));
211 #elif defined(__linux__)
212 #if HAVE_PTHREAD_GETNAME_NP
213 constexpr uint32_t len = get_max_thread_name_length_impl();
214 char Buffer[len] = {'\0'}; // FIXME: working around MSan false positive.
215 if (0 == ::pthread_getname_np(::pthread_self(), Buffer, len))
216 Name.append(Buffer, Buffer + strlen(Buffer));