1 //===-- asan_mac.cc -------------------------------------------------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file is a part of AddressSanitizer, an address sanity checker.
12 // Mac-specific details.
13 //===----------------------------------------------------------------------===//
15 #include "sanitizer_common/sanitizer_platform.h"
18 #include "asan_interceptors.h"
19 #include "asan_internal.h"
20 #include "asan_mapping.h"
21 #include "asan_stack.h"
22 #include "asan_thread.h"
23 #include "sanitizer_common/sanitizer_atomic.h"
24 #include "sanitizer_common/sanitizer_libc.h"
25 #include "sanitizer_common/sanitizer_mac.h"
29 #include <libkern/OSAtomic.h>
30 #include <mach-o/dyld.h>
31 #include <mach-o/getsect.h>
32 #include <mach-o/loader.h>
34 #include <stdlib.h> // for free()
36 #include <sys/resource.h>
37 #include <sys/sysctl.h>
38 #include <sys/ucontext.h>
41 // from <crt_externs.h>, but we don't have that file on iOS
43 extern char ***_NSGetArgv(void);
44 extern char ***_NSGetEnviron(void);
49 void InitializePlatformInterceptors() {}
50 void InitializePlatformExceptionHandlers() {}
51 bool IsSystemHeapAddress (uptr addr) { return false; }
53 // No-op. Mac does not support static linkage anyway.
54 void *AsanDoesNotSupportStaticLinkage() {
58 // No-op. Mac does not support static linkage anyway.
59 void AsanCheckDynamicRTPrereqs() {}
61 // No-op. Mac does not support static linkage anyway.
62 void AsanCheckIncompatibleRT() {}
64 void AsanApplyToGlobals(globals_op_fptr op, const void *needle) {
65 // Find the Mach-O header for the image containing the needle
67 int err = dladdr(needle, &info);
71 const struct mach_header_64 *mh = (struct mach_header_64 *)info.dli_fbase;
73 const struct mach_header *mh = (struct mach_header *)info.dli_fbase;
76 // Look up the __asan_globals section in that image and register its globals
77 unsigned long size = 0;
78 __asan_global *globals = (__asan_global *)getsectiondata(
80 "__DATA", "__asan_globals",
84 if (size % sizeof(__asan_global) != 0) return;
85 op(globals, size / sizeof(__asan_global));
88 void ReadContextStack(void *context, uptr *stack, uptr *ssize) {
92 // Support for the following functions from libdispatch on Mac OS:
99 // dispatch_group_async_f()
100 // dispatch_group_async()
101 // TODO(glider): libdispatch API contains other functions that we don't support
104 // dispatch_sync() and dispatch_sync_f() are synchronous, although chances are
105 // they can cause jobs to run on a thread different from the current one.
106 // TODO(glider): if so, we need a test for this (otherwise we should remove
109 // The following functions use dispatch_barrier_async_f() (which isn't a library
110 // function but is exported) and are thus supported:
111 // dispatch_source_set_cancel_handler_f()
112 // dispatch_source_set_cancel_handler()
113 // dispatch_source_set_event_handler_f()
114 // dispatch_source_set_event_handler()
116 // The reference manual for Grand Central Dispatch is available at
117 // http://developer.apple.com/library/mac/#documentation/Performance/Reference/GCD_libdispatch_Ref/Reference/reference.html
118 // The implementation details are at
119 // http://libdispatch.macosforge.org/trac/browser/trunk/src/queue.c
121 typedef void* dispatch_group_t;
122 typedef void* dispatch_queue_t;
123 typedef void* dispatch_source_t;
124 typedef u64 dispatch_time_t;
125 typedef void (*dispatch_function_t)(void *block);
126 typedef void* (*worker_t)(void *block);
128 // A wrapper for the ObjC blocks used to support libdispatch.
131 dispatch_function_t func;
133 } asan_block_context_t;
136 void asan_register_worker_thread(int parent_tid, StackTrace *stack) {
137 AsanThread *t = GetCurrentThread();
139 t = AsanThread::Create(/* start_routine */ nullptr, /* arg */ nullptr,
140 parent_tid, stack, /* detached */ true);
142 asanThreadRegistry().StartThread(t->tid(), GetTid(),
143 /* workerthread */ true, 0);
148 // For use by only those functions that allocated the context via
149 // alloc_asan_context().
151 void asan_dispatch_call_block_and_release(void *block) {
152 GET_STACK_TRACE_THREAD;
153 asan_block_context_t *context = (asan_block_context_t*)block;
155 "asan_dispatch_call_block_and_release(): "
156 "context: %p, pthread_self: %p\n",
157 block, pthread_self());
158 asan_register_worker_thread(context->parent_tid, &stack);
159 // Call the original dispatcher for the block.
160 context->func(context->block);
161 asan_free(context, &stack, FROM_MALLOC);
164 } // namespace __asan
166 using namespace __asan; // NOLINT
168 // Wrap |ctxt| and |func| into an asan_block_context_t.
169 // The caller retains control of the allocated context.
171 asan_block_context_t *alloc_asan_context(void *ctxt, dispatch_function_t func,
172 BufferedStackTrace *stack) {
173 asan_block_context_t *asan_ctxt =
174 (asan_block_context_t*) asan_malloc(sizeof(asan_block_context_t), stack);
175 asan_ctxt->block = ctxt;
176 asan_ctxt->func = func;
177 asan_ctxt->parent_tid = GetCurrentTidOrInvalid();
181 // Define interceptor for dispatch_*_f function with the three most common
182 // parameters: dispatch_queue_t, context, dispatch_function_t.
183 #define INTERCEPT_DISPATCH_X_F_3(dispatch_x_f) \
184 INTERCEPTOR(void, dispatch_x_f, dispatch_queue_t dq, void *ctxt, \
185 dispatch_function_t func) { \
186 GET_STACK_TRACE_THREAD; \
187 asan_block_context_t *asan_ctxt = alloc_asan_context(ctxt, func, &stack); \
188 if (Verbosity() >= 2) { \
189 Report(#dispatch_x_f "(): context: %p, pthread_self: %p\n", \
190 asan_ctxt, pthread_self()); \
191 PRINT_CURRENT_STACK(); \
193 return REAL(dispatch_x_f)(dq, (void*)asan_ctxt, \
194 asan_dispatch_call_block_and_release); \
197 INTERCEPT_DISPATCH_X_F_3(dispatch_async_f)
198 INTERCEPT_DISPATCH_X_F_3(dispatch_sync_f)
199 INTERCEPT_DISPATCH_X_F_3(dispatch_barrier_async_f)
201 INTERCEPTOR(void, dispatch_after_f, dispatch_time_t when,
202 dispatch_queue_t dq, void *ctxt,
203 dispatch_function_t func) {
204 GET_STACK_TRACE_THREAD;
205 asan_block_context_t *asan_ctxt = alloc_asan_context(ctxt, func, &stack);
206 if (Verbosity() >= 2) {
207 Report("dispatch_after_f: %p\n", asan_ctxt);
208 PRINT_CURRENT_STACK();
210 return REAL(dispatch_after_f)(when, dq, (void*)asan_ctxt,
211 asan_dispatch_call_block_and_release);
214 INTERCEPTOR(void, dispatch_group_async_f, dispatch_group_t group,
215 dispatch_queue_t dq, void *ctxt,
216 dispatch_function_t func) {
217 GET_STACK_TRACE_THREAD;
218 asan_block_context_t *asan_ctxt = alloc_asan_context(ctxt, func, &stack);
219 if (Verbosity() >= 2) {
220 Report("dispatch_group_async_f(): context: %p, pthread_self: %p\n",
221 asan_ctxt, pthread_self());
222 PRINT_CURRENT_STACK();
224 REAL(dispatch_group_async_f)(group, dq, (void*)asan_ctxt,
225 asan_dispatch_call_block_and_release);
228 #if !defined(MISSING_BLOCKS_SUPPORT)
230 void dispatch_async(dispatch_queue_t dq, void(^work)(void));
231 void dispatch_group_async(dispatch_group_t dg, dispatch_queue_t dq,
233 void dispatch_after(dispatch_time_t when, dispatch_queue_t queue,
235 void dispatch_source_set_cancel_handler(dispatch_source_t ds,
237 void dispatch_source_set_event_handler(dispatch_source_t ds, void(^work)(void));
240 #define GET_ASAN_BLOCK(work) \
241 void (^asan_block)(void); \
242 int parent_tid = GetCurrentTidOrInvalid(); \
243 asan_block = ^(void) { \
244 GET_STACK_TRACE_THREAD; \
245 asan_register_worker_thread(parent_tid, &stack); \
249 INTERCEPTOR(void, dispatch_async,
250 dispatch_queue_t dq, void(^work)(void)) {
251 ENABLE_FRAME_POINTER;
252 GET_ASAN_BLOCK(work);
253 REAL(dispatch_async)(dq, asan_block);
256 INTERCEPTOR(void, dispatch_group_async,
257 dispatch_group_t dg, dispatch_queue_t dq, void(^work)(void)) {
258 ENABLE_FRAME_POINTER;
259 GET_ASAN_BLOCK(work);
260 REAL(dispatch_group_async)(dg, dq, asan_block);
263 INTERCEPTOR(void, dispatch_after,
264 dispatch_time_t when, dispatch_queue_t queue, void(^work)(void)) {
265 ENABLE_FRAME_POINTER;
266 GET_ASAN_BLOCK(work);
267 REAL(dispatch_after)(when, queue, asan_block);
270 INTERCEPTOR(void, dispatch_source_set_cancel_handler,
271 dispatch_source_t ds, void(^work)(void)) {
273 REAL(dispatch_source_set_cancel_handler)(ds, work);
276 ENABLE_FRAME_POINTER;
277 GET_ASAN_BLOCK(work);
278 REAL(dispatch_source_set_cancel_handler)(ds, asan_block);
281 INTERCEPTOR(void, dispatch_source_set_event_handler,
282 dispatch_source_t ds, void(^work)(void)) {
283 ENABLE_FRAME_POINTER;
284 GET_ASAN_BLOCK(work);
285 REAL(dispatch_source_set_event_handler)(ds, asan_block);
289 #endif // SANITIZER_MAC