1 //===-- asan_thread.cc ----------------------------------------------------===//
3 // This file is distributed under the University of Illinois Open Source
4 // License. See LICENSE.TXT for details.
6 //===----------------------------------------------------------------------===//
8 // This file is a part of AddressSanitizer, an address sanity checker.
10 // Thread-related code.
11 //===----------------------------------------------------------------------===//
12 #include "asan_allocator.h"
13 #include "asan_interceptors.h"
14 #include "asan_poisoning.h"
15 #include "asan_stack.h"
16 #include "asan_thread.h"
17 #include "asan_mapping.h"
18 #include "sanitizer_common/sanitizer_common.h"
19 #include "sanitizer_common/sanitizer_placement_new.h"
20 #include "sanitizer_common/sanitizer_stackdepot.h"
21 #include "sanitizer_common/sanitizer_tls_get_addr.h"
22 #include "lsan/lsan_common.h"
26 // AsanThreadContext implementation.
28 void AsanThreadContext::OnCreated(void *arg
) {
29 CreateThreadContextArgs
*args
= static_cast<CreateThreadContextArgs
*>(arg
);
31 stack_id
= StackDepotPut(*args
->stack
);
32 thread
= args
->thread
;
33 thread
->set_context(this);
36 void AsanThreadContext::OnFinished() {
37 // Drop the link to the AsanThread object.
41 // MIPS requires aligned address
42 static ALIGNED(16) char thread_registry_placeholder
[sizeof(ThreadRegistry
)];
43 static ThreadRegistry
*asan_thread_registry
;
45 static BlockingMutex
mu_for_thread_context(LINKER_INITIALIZED
);
46 static LowLevelAllocator allocator_for_thread_context
;
48 static ThreadContextBase
*GetAsanThreadContext(u32 tid
) {
49 BlockingMutexLock
lock(&mu_for_thread_context
);
50 return new(allocator_for_thread_context
) AsanThreadContext(tid
);
53 ThreadRegistry
&asanThreadRegistry() {
54 static bool initialized
;
55 // Don't worry about thread_safety - this should be called when there is
58 // Never reuse ASan threads: we store pointer to AsanThreadContext
59 // in TSD and can't reliably tell when no more TSD destructors will
60 // be called. It would be wrong to reuse AsanThreadContext for another
61 // thread before all TSD destructors will be called for it.
62 asan_thread_registry
= new(thread_registry_placeholder
) ThreadRegistry(
63 GetAsanThreadContext
, kMaxNumberOfThreads
, kMaxNumberOfThreads
);
66 return *asan_thread_registry
;
69 AsanThreadContext
*GetThreadContextByTidLocked(u32 tid
) {
70 return static_cast<AsanThreadContext
*>(
71 asanThreadRegistry().GetThreadLocked(tid
));
74 // AsanThread implementation.
76 AsanThread
*AsanThread::Create(thread_callback_t start_routine
,
78 uptr PageSize
= GetPageSizeCached();
79 uptr size
= RoundUpTo(sizeof(AsanThread
), PageSize
);
80 AsanThread
*thread
= (AsanThread
*)MmapOrDie(size
, __func__
);
81 thread
->start_routine_
= start_routine
;
87 void AsanThread::TSDDtor(void *tsd
) {
88 AsanThreadContext
*context
= (AsanThreadContext
*)tsd
;
89 VReport(1, "T%d TSDDtor\n", context
->tid
);
91 context
->thread
->Destroy();
94 void AsanThread::Destroy() {
95 int tid
= this->tid();
96 VReport(1, "T%d exited\n", tid
);
98 malloc_storage().CommitBack();
99 if (common_flags()->use_sigaltstack
) UnsetAlternateSignalStack();
100 asanThreadRegistry().FinishThread(tid
);
101 FlushToDeadThreadStats(&stats_
);
102 // We also clear the shadow on thread destruction because
103 // some code may still be executing in later TSD destructors
104 // and we don't want it to have any poisoned stack.
105 ClearShadowForThreadStackAndTLS();
106 DeleteFakeStack(tid
);
107 uptr size
= RoundUpTo(sizeof(AsanThread
), GetPageSizeCached());
108 UnmapOrDie(this, size
);
112 // We want to create the FakeStack lazyly on the first use, but not eralier
113 // than the stack size is known and the procedure has to be async-signal safe.
114 FakeStack
*AsanThread::AsyncSignalSafeLazyInitFakeStack() {
115 uptr stack_size
= this->stack_size();
116 if (stack_size
== 0) // stack_size is not yet available, don't use FakeStack.
119 // fake_stack_ has 3 states:
120 // 0 -- not initialized
121 // 1 -- being initialized
122 // ptr -- initialized
123 // This CAS checks if the state was 0 and if so changes it to state 1,
124 // if that was successful, it initializes the pointer.
125 if (atomic_compare_exchange_strong(
126 reinterpret_cast<atomic_uintptr_t
*>(&fake_stack_
), &old_val
, 1UL,
127 memory_order_relaxed
)) {
128 uptr stack_size_log
= Log2(RoundUpToPowerOfTwo(stack_size
));
129 CHECK_LE(flags()->min_uar_stack_size_log
, flags()->max_uar_stack_size_log
);
131 Min(stack_size_log
, static_cast<uptr
>(flags()->max_uar_stack_size_log
));
133 Max(stack_size_log
, static_cast<uptr
>(flags()->min_uar_stack_size_log
));
134 fake_stack_
= FakeStack::Create(stack_size_log
);
135 SetTLSFakeStack(fake_stack_
);
141 void AsanThread::Init() {
142 fake_stack_
= 0; // Will be initialized lazily if needed.
143 CHECK_EQ(this->stack_size(), 0U);
144 SetThreadStackAndTls();
145 CHECK_GT(this->stack_size(), 0U);
146 CHECK(AddrIsInMem(stack_bottom_
));
147 CHECK(AddrIsInMem(stack_top_
- 1));
148 ClearShadowForThreadStackAndTLS();
150 VReport(1, "T%d: stack [%p,%p) size 0x%zx; local=%p\n", tid(),
151 (void *)stack_bottom_
, (void *)stack_top_
, stack_top_
- stack_bottom_
,
153 AsanPlatformThreadInit();
156 thread_return_t
AsanThread::ThreadStart(uptr os_id
) {
158 asanThreadRegistry().StartThread(tid(), os_id
, 0);
159 if (common_flags()->use_sigaltstack
) SetAlternateSignalStack();
161 if (!start_routine_
) {
162 // start_routine_ == 0 if we're on the main thread or on one of the
163 // OS X libdispatch worker threads. But nobody is supposed to call
164 // ThreadStart() for the worker threads.
169 thread_return_t res
= start_routine_(arg_
);
171 // On POSIX systems we defer this to the TSD destructor. LSan will consider
172 // the thread's memory as non-live from the moment we call Destroy(), even
173 // though that memory might contain pointers to heap objects which will be
174 // cleaned up by a user-defined TSD destructor. Thus, calling Destroy() before
175 // the TSD destructors have run might cause false positives in LSan.
176 if (!SANITIZER_POSIX
)
182 void AsanThread::SetThreadStackAndTls() {
184 GetThreadStackAndTls(tid() == 0, &stack_bottom_
, &stack_size_
, &tls_begin_
,
186 stack_top_
= stack_bottom_
+ stack_size_
;
187 tls_end_
= tls_begin_
+ tls_size
;
190 CHECK(AddrIsInStack((uptr
)&local
));
193 void AsanThread::ClearShadowForThreadStackAndTLS() {
194 PoisonShadow(stack_bottom_
, stack_top_
- stack_bottom_
, 0);
195 if (tls_begin_
!= tls_end_
)
196 PoisonShadow(tls_begin_
, tls_end_
- tls_begin_
, 0);
199 bool AsanThread::GetStackFrameAccessByAddr(uptr addr
,
200 StackFrameAccess
*access
) {
202 if (AddrIsInStack(addr
)) {
203 bottom
= stack_bottom();
204 } else if (has_fake_stack()) {
205 bottom
= fake_stack()->AddrIsInFakeStack(addr
);
207 access
->offset
= addr
- bottom
;
208 access
->frame_pc
= ((uptr
*)bottom
)[2];
209 access
->frame_descr
= (const char *)((uptr
*)bottom
)[1];
212 uptr aligned_addr
= addr
& ~(SANITIZER_WORDSIZE
/8 - 1); // align addr.
213 u8
*shadow_ptr
= (u8
*)MemToShadow(aligned_addr
);
214 u8
*shadow_bottom
= (u8
*)MemToShadow(bottom
);
216 while (shadow_ptr
>= shadow_bottom
&&
217 *shadow_ptr
!= kAsanStackLeftRedzoneMagic
) {
221 while (shadow_ptr
>= shadow_bottom
&&
222 *shadow_ptr
== kAsanStackLeftRedzoneMagic
) {
226 if (shadow_ptr
< shadow_bottom
) {
230 uptr
* ptr
= (uptr
*)SHADOW_TO_MEM((uptr
)(shadow_ptr
+ 1));
231 CHECK(ptr
[0] == kCurrentStackFrameMagic
);
232 access
->offset
= addr
- (uptr
)ptr
;
233 access
->frame_pc
= ptr
[2];
234 access
->frame_descr
= (const char*)ptr
[1];
238 static bool ThreadStackContainsAddress(ThreadContextBase
*tctx_base
,
240 AsanThreadContext
*tctx
= static_cast<AsanThreadContext
*>(tctx_base
);
241 AsanThread
*t
= tctx
->thread
;
242 if (!t
) return false;
243 if (t
->AddrIsInStack((uptr
)addr
)) return true;
244 if (t
->has_fake_stack() && t
->fake_stack()->AddrIsInFakeStack((uptr
)addr
))
249 AsanThread
*GetCurrentThread() {
250 AsanThreadContext
*context
=
251 reinterpret_cast<AsanThreadContext
*>(AsanTSDGet());
253 if (SANITIZER_ANDROID
) {
254 // On Android, libc constructor is called _after_ asan_init, and cleans up
255 // TSD. Try to figure out if this is still the main thread by the stack
256 // address. We are not entirely sure that we have correct main thread
257 // limits, so only do this magic on Android, and only if the found thread
258 // is the main thread.
259 AsanThreadContext
*tctx
= GetThreadContextByTidLocked(0);
260 if (ThreadStackContainsAddress(tctx
, &context
)) {
261 SetCurrentThread(tctx
->thread
);
267 return context
->thread
;
270 void SetCurrentThread(AsanThread
*t
) {
272 VReport(2, "SetCurrentThread: %p for thread %p\n", t
->context(),
273 (void *)GetThreadSelf());
274 // Make sure we do not reset the current AsanThread.
275 CHECK_EQ(0, AsanTSDGet());
276 AsanTSDSet(t
->context());
277 CHECK_EQ(t
->context(), AsanTSDGet());
280 u32
GetCurrentTidOrInvalid() {
281 AsanThread
*t
= GetCurrentThread();
282 return t
? t
->tid() : kInvalidTid
;
285 AsanThread
*FindThreadByStackAddress(uptr addr
) {
286 asanThreadRegistry().CheckLocked();
287 AsanThreadContext
*tctx
= static_cast<AsanThreadContext
*>(
288 asanThreadRegistry().FindThreadContextLocked(ThreadStackContainsAddress
,
290 return tctx
? tctx
->thread
: 0;
293 void EnsureMainThreadIDIsCorrect() {
294 AsanThreadContext
*context
=
295 reinterpret_cast<AsanThreadContext
*>(AsanTSDGet());
296 if (context
&& (context
->tid
== 0))
297 context
->os_id
= GetTid();
300 __asan::AsanThread
*GetAsanThreadByOsIDLocked(uptr os_id
) {
301 __asan::AsanThreadContext
*context
= static_cast<__asan::AsanThreadContext
*>(
302 __asan::asanThreadRegistry().FindThreadContextByOsIDLocked(os_id
));
303 if (!context
) return 0;
304 return context
->thread
;
306 } // namespace __asan
308 // --- Implementation of LSan-specific functions --- {{{1
310 bool GetThreadRangesLocked(uptr os_id
, uptr
*stack_begin
, uptr
*stack_end
,
311 uptr
*tls_begin
, uptr
*tls_end
,
312 uptr
*cache_begin
, uptr
*cache_end
) {
313 __asan::AsanThread
*t
= __asan::GetAsanThreadByOsIDLocked(os_id
);
314 if (!t
) return false;
315 *stack_begin
= t
->stack_bottom();
316 *stack_end
= t
->stack_top();
317 *tls_begin
= t
->tls_begin();
318 *tls_end
= t
->tls_end();
319 // ASan doesn't keep allocator caches in TLS, so these are unused.
325 void ForEachExtraStackRange(uptr os_id
, RangeIteratorCallback callback
,
327 __asan::AsanThread
*t
= __asan::GetAsanThreadByOsIDLocked(os_id
);
328 if (t
&& t
->has_fake_stack())
329 t
->fake_stack()->ForEachFakeFrame(callback
, arg
);
332 void LockThreadRegistry() {
333 __asan::asanThreadRegistry().Lock();
336 void UnlockThreadRegistry() {
337 __asan::asanThreadRegistry().Unlock();
340 void EnsureMainThreadIDIsCorrect() {
341 __asan::EnsureMainThreadIDIsCorrect();
343 } // namespace __lsan