1 //===-- sanitizer_platform.h ------------------------------------*- 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 // Common platform macros.
10 //===----------------------------------------------------------------------===//
12 #ifndef SANITIZER_PLATFORM_H
13 #define SANITIZER_PLATFORM_H
15 #if !defined(__linux__) && !defined(__FreeBSD__) && !defined(__NetBSD__) && \
16 !defined(__APPLE__) && !defined(_WIN32) && !defined(__Fuchsia__) && \
17 !(defined(__sun__) && defined(__svr4__))
18 # error "This operating system is not supported"
21 // Get __GLIBC__ on a glibc platform. Exclude Android: features.h includes C
22 // function declarations into a .S file which doesn't compile.
23 // https://crbug.com/1162741
24 #if __has_include(<features.h>) && !defined(__ANDROID__)
25 # include <features.h>
28 #if defined(__linux__)
29 # define SANITIZER_LINUX 1
31 # define SANITIZER_LINUX 0
34 #if defined(__GLIBC__)
35 # define SANITIZER_GLIBC 1
37 # define SANITIZER_GLIBC 0
40 #if defined(__FreeBSD__)
41 # define SANITIZER_FREEBSD 1
43 # define SANITIZER_FREEBSD 0
46 #if defined(__NetBSD__)
47 # define SANITIZER_NETBSD 1
49 # define SANITIZER_NETBSD 0
52 #if defined(__sun__) && defined(__svr4__)
53 # define SANITIZER_SOLARIS 1
55 # define SANITIZER_SOLARIS 0
58 // - SANITIZER_APPLE: all Apple code
59 // - TARGET_OS_OSX: macOS
60 // - SANITIZER_IOS: devices (iOS and iOS-like)
61 // - SANITIZER_WATCHOS
63 // - SANITIZER_IOSSIM: simulators (iOS and iOS-like)
64 // - SANITIZER_DRIVERKIT
65 #if defined(__APPLE__)
66 # define SANITIZER_APPLE 1
67 # include <TargetConditionals.h>
69 # define SANITIZER_OSX 1
71 # define SANITIZER_OSX 0
74 # define SANITIZER_IOS 1
76 # define SANITIZER_IOS 0
79 # define SANITIZER_WATCHOS 1
81 # define SANITIZER_WATCHOS 0
84 # define SANITIZER_TVOS 1
86 # define SANITIZER_TVOS 0
88 # if TARGET_OS_SIMULATOR
89 # define SANITIZER_IOSSIM 1
91 # define SANITIZER_IOSSIM 0
93 # if defined(TARGET_OS_DRIVERKIT) && TARGET_OS_DRIVERKIT
94 # define SANITIZER_DRIVERKIT 1
96 # define SANITIZER_DRIVERKIT 0
99 # define SANITIZER_APPLE 0
100 # define SANITIZER_OSX 0
101 # define SANITIZER_IOS 0
102 # define SANITIZER_WATCHOS 0
103 # define SANITIZER_TVOS 0
104 # define SANITIZER_IOSSIM 0
105 # define SANITIZER_DRIVERKIT 0
109 # define SANITIZER_WINDOWS 1
111 # define SANITIZER_WINDOWS 0
115 # define SANITIZER_WINDOWS64 1
117 # define SANITIZER_WINDOWS64 0
120 #if defined(__ANDROID__)
121 # define SANITIZER_ANDROID 1
123 # define SANITIZER_ANDROID 0
126 #if defined(__Fuchsia__)
127 # define SANITIZER_FUCHSIA 1
129 # define SANITIZER_FUCHSIA 0
132 // Assume linux that is not glibc or android is musl libc.
133 #if SANITIZER_LINUX && !SANITIZER_GLIBC && !SANITIZER_ANDROID
134 # define SANITIZER_MUSL 1
136 # define SANITIZER_MUSL 0
139 #define SANITIZER_POSIX \
140 (SANITIZER_FREEBSD || SANITIZER_LINUX || SANITIZER_APPLE || \
141 SANITIZER_NETBSD || SANITIZER_SOLARIS)
143 #if __LP64__ || defined(_WIN64)
144 # define SANITIZER_WORDSIZE 64
146 # define SANITIZER_WORDSIZE 32
149 #if SANITIZER_WORDSIZE == 64
150 # define FIRST_32_SECOND_64(a, b) (b)
152 # define FIRST_32_SECOND_64(a, b) (a)
155 #if defined(__x86_64__) && !defined(_LP64)
156 # define SANITIZER_X32 1
158 # define SANITIZER_X32 0
161 #if defined(__x86_64__) || defined(_M_X64)
162 # define SANITIZER_X64 1
164 # define SANITIZER_X64 0
167 #if defined(__i386__) || defined(_M_IX86)
168 # define SANITIZER_I386 1
170 # define SANITIZER_I386 0
173 #if defined(__mips__)
174 # define SANITIZER_MIPS 1
175 # if defined(__mips64) && _MIPS_SIM == _ABI64
176 # define SANITIZER_MIPS32 0
177 # define SANITIZER_MIPS64 1
179 # define SANITIZER_MIPS32 1
180 # define SANITIZER_MIPS64 0
183 # define SANITIZER_MIPS 0
184 # define SANITIZER_MIPS32 0
185 # define SANITIZER_MIPS64 0
188 #if defined(__s390__)
189 # define SANITIZER_S390 1
190 # if defined(__s390x__)
191 # define SANITIZER_S390_31 0
192 # define SANITIZER_S390_64 1
194 # define SANITIZER_S390_31 1
195 # define SANITIZER_S390_64 0
198 # define SANITIZER_S390 0
199 # define SANITIZER_S390_31 0
200 # define SANITIZER_S390_64 0
203 #if defined(__sparc__)
204 # define SANITIZER_SPARC 1
205 # if defined(__arch64__)
206 # define SANITIZER_SPARC32 0
207 # define SANITIZER_SPARC64 1
209 # define SANITIZER_SPARC32 1
210 # define SANITIZER_SPARC64 0
213 # define SANITIZER_SPARC 0
214 # define SANITIZER_SPARC32 0
215 # define SANITIZER_SPARC64 0
218 #if defined(__powerpc__)
219 # define SANITIZER_PPC 1
220 # if defined(__powerpc64__)
221 # define SANITIZER_PPC32 0
222 # define SANITIZER_PPC64 1
223 // 64-bit PPC has two ABIs (v1 and v2). The old powerpc64 target is
224 // big-endian, and uses v1 ABI (known for its function descriptors),
225 // while the new powerpc64le target is little-endian and uses v2.
226 // In theory, you could convince gcc to compile for their evil twins
227 // (eg. big-endian v2), but you won't find such combinations in the wild
228 // (it'd require bootstrapping a whole system, which would be quite painful
229 // - there's no target triple for that). LLVM doesn't support them either.
231 # define SANITIZER_PPC64V1 0
232 # define SANITIZER_PPC64V2 1
234 # define SANITIZER_PPC64V1 1
235 # define SANITIZER_PPC64V2 0
238 # define SANITIZER_PPC32 1
239 # define SANITIZER_PPC64 0
240 # define SANITIZER_PPC64V1 0
241 # define SANITIZER_PPC64V2 0
244 # define SANITIZER_PPC 0
245 # define SANITIZER_PPC32 0
246 # define SANITIZER_PPC64 0
247 # define SANITIZER_PPC64V1 0
248 # define SANITIZER_PPC64V2 0
251 #if defined(__arm__) || defined(_M_ARM)
252 # define SANITIZER_ARM 1
254 # define SANITIZER_ARM 0
257 #if defined(__aarch64__) || defined(_M_ARM64)
258 # define SANITIZER_ARM64 1
260 # define SANITIZER_ARM64 0
263 #if SANITIZER_WINDOWS64 && SANITIZER_ARM64
264 # define SANITIZER_WINDOWS_ARM64 1
265 # define SANITIZER_WINDOWS_x64 0
266 #elif SANITIZER_WINDOWS64 && !SANITIZER_ARM64
267 # define SANITIZER_WINDOWS_ARM64 0
268 # define SANITIZER_WINDOWS_x64 1
270 # define SANITIZER_WINDOWS_ARM64 0
271 # define SANITIZER_WINDOWS_x64 0
274 #if SANITIZER_SOLARIS && SANITIZER_WORDSIZE == 32
275 # define SANITIZER_SOLARIS32 1
277 # define SANITIZER_SOLARIS32 0
280 #if defined(__riscv) && (__riscv_xlen == 64)
281 # define SANITIZER_RISCV64 1
283 # define SANITIZER_RISCV64 0
286 #if defined(__loongarch_lp64)
287 # define SANITIZER_LOONGARCH64 1
289 # define SANITIZER_LOONGARCH64 0
292 // By default we allow to use SizeClassAllocator64 on 64-bit platform.
293 // But in some cases SizeClassAllocator64 does not work well and we need to
294 // fallback to SizeClassAllocator32.
295 // For such platforms build this code with -DSANITIZER_CAN_USE_ALLOCATOR64=0 or
296 // change the definition of SANITIZER_CAN_USE_ALLOCATOR64 here.
297 #ifndef SANITIZER_CAN_USE_ALLOCATOR64
298 # if (SANITIZER_RISCV64 && !SANITIZER_FUCHSIA && !SANITIZER_LINUX) || \
299 SANITIZER_IOS || SANITIZER_DRIVERKIT
300 # define SANITIZER_CAN_USE_ALLOCATOR64 0
301 # elif defined(__mips64) || defined(__hexagon__)
302 # define SANITIZER_CAN_USE_ALLOCATOR64 0
304 # define SANITIZER_CAN_USE_ALLOCATOR64 (SANITIZER_WORDSIZE == 64)
308 // The range of addresses which can be returned my mmap.
309 // FIXME: this value should be different on different platforms. Larger values
310 // will still work but will consume more memory for TwoLevelByteMap.
311 #if defined(__mips__)
312 # if SANITIZER_GO && defined(__mips64)
313 # define SANITIZER_MMAP_RANGE_SIZE FIRST_32_SECOND_64(1ULL << 32, 1ULL << 47)
315 # define SANITIZER_MMAP_RANGE_SIZE FIRST_32_SECOND_64(1ULL << 32, 1ULL << 40)
317 #elif SANITIZER_RISCV64
318 // FIXME: Rather than hardcoding the VMA here, we should rely on
319 // GetMaxUserVirtualAddress(). This will require some refactoring though since
320 // many places either hardcode some value or SANITIZER_MMAP_RANGE_SIZE is
321 // assumed to be some constant integer.
322 # if SANITIZER_FUCHSIA
323 # define SANITIZER_MMAP_RANGE_SIZE (1ULL << 38)
325 # define SANITIZER_MMAP_RANGE_SIZE FIRST_32_SECOND_64(1ULL << 32, 1ULL << 56)
327 #elif defined(__aarch64__)
329 # if SANITIZER_OSX || SANITIZER_IOSSIM
330 # define SANITIZER_MMAP_RANGE_SIZE \
331 FIRST_32_SECOND_64(1ULL << 32, 1ULL << 47)
333 // Darwin iOS/ARM64 has a 36-bit VMA, 64GiB VM
334 # define SANITIZER_MMAP_RANGE_SIZE \
335 FIRST_32_SECOND_64(1ULL << 32, 1ULL << 36)
338 # define SANITIZER_MMAP_RANGE_SIZE FIRST_32_SECOND_64(1ULL << 32, 1ULL << 48)
340 #elif defined(__sparc__)
341 # define SANITIZER_MMAP_RANGE_SIZE FIRST_32_SECOND_64(1ULL << 32, 1ULL << 52)
343 # define SANITIZER_MMAP_RANGE_SIZE FIRST_32_SECOND_64(1ULL << 32, 1ULL << 47)
346 // Whether the addresses are sign-extended from the VMA range to the word.
347 // The SPARC64 Linux port implements this to split the VMA space into two
348 // non-contiguous halves with a huge hole in the middle.
349 #if defined(__sparc__) && SANITIZER_WORDSIZE == 64
350 # define SANITIZER_SIGN_EXTENDED_ADDRESSES 1
352 # define SANITIZER_SIGN_EXTENDED_ADDRESSES 0
355 // udi16 syscalls can only be used when the following conditions are
357 // * target is one of arm32, x86-32, sparc32, sh or m68k
358 // * libc version is libc5, glibc-2.0, glibc-2.1 or glibc-2.2 to 2.15
359 // built against > linux-2.2 kernel headers
360 // Since we don't want to include libc headers here, we check the
362 #if defined(__arm__) || SANITIZER_X32 || defined(__sparc__)
363 # define SANITIZER_USES_UID16_SYSCALLS 1
365 # define SANITIZER_USES_UID16_SYSCALLS 0
368 #if defined(__mips__)
369 # define SANITIZER_POINTER_FORMAT_LENGTH FIRST_32_SECOND_64(8, 10)
371 # define SANITIZER_POINTER_FORMAT_LENGTH FIRST_32_SECOND_64(8, 12)
374 /// \macro MSC_PREREQ
375 /// \brief Is the compiler MSVC of at least the specified version?
376 /// The common \param version values to check for are:
377 /// * 1800: Microsoft Visual Studio 2013 / 12.0
378 /// * 1900: Microsoft Visual Studio 2015 / 14.0
380 # define MSC_PREREQ(version) (_MSC_VER >= (version))
382 # define MSC_PREREQ(version) 0
385 #if SANITIZER_APPLE && defined(__x86_64__)
386 # define SANITIZER_NON_UNIQUE_TYPEINFO 0
388 # define SANITIZER_NON_UNIQUE_TYPEINFO 1
391 // On linux, some architectures had an ABI transition from 64-bit long double
392 // (ie. same as double) to 128-bit long double. On those, glibc symbols
393 // involving long doubles come in two versions, and we need to pass the
394 // correct one to dlvsym when intercepting them.
395 #if SANITIZER_LINUX && (SANITIZER_S390 || SANITIZER_PPC32 || SANITIZER_PPC64V1)
396 # define SANITIZER_NLDBL_VERSION "GLIBC_2.4"
399 #if SANITIZER_GO == 0
400 # define SANITIZER_GO 0
403 // On PowerPC and ARM Thumb, calling pthread_exit() causes LSan to detect leaks.
404 // pthread_exit() performs unwinding that leads to dlopen'ing libgcc_s.so.
405 // dlopen mallocs "libgcc_s.so" string which confuses LSan, it fails to realize
406 // that this allocation happens in dynamic linker and should be ignored.
407 #if SANITIZER_PPC || defined(__thumb__)
408 # define SANITIZER_SUPPRESS_LEAK_ON_PTHREAD_EXIT 1
410 # define SANITIZER_SUPPRESS_LEAK_ON_PTHREAD_EXIT 0
413 #if SANITIZER_FREEBSD || SANITIZER_APPLE || SANITIZER_NETBSD || SANITIZER_SOLARIS
414 # define SANITIZER_MADVISE_DONTNEED MADV_FREE
416 # define SANITIZER_MADVISE_DONTNEED MADV_DONTNEED
419 // Older gcc have issues aligning to a constexpr, and require an integer.
420 // See https://gcc.gnu.org/bugzilla/show_bug.cgi?id=56859 among others.
421 #if defined(__powerpc__) || defined(__powerpc64__)
422 # define SANITIZER_CACHE_LINE_SIZE 128
424 # define SANITIZER_CACHE_LINE_SIZE 64
427 // Enable offline markup symbolizer for Fuchsia.
428 #if SANITIZER_FUCHSIA
429 # define SANITIZER_SYMBOLIZER_MARKUP 1
431 # define SANITIZER_SYMBOLIZER_MARKUP 0
434 // Enable ability to support sanitizer initialization that is
435 // compatible with the sanitizer library being loaded via
438 # define SANITIZER_SUPPORTS_INIT_FOR_DLOPEN 1
440 # define SANITIZER_SUPPORTS_INIT_FOR_DLOPEN 0
443 // SANITIZER_SUPPORTS_THREADLOCAL
444 // 1 - THREADLOCAL macro is supported by target
445 // 0 - THREADLOCAL macro is not supported by target
446 #ifndef __has_feature
447 // TODO: Support other compilers here
448 # define SANITIZER_SUPPORTS_THREADLOCAL 1
450 # if __has_feature(tls)
451 # define SANITIZER_SUPPORTS_THREADLOCAL 1
453 # define SANITIZER_SUPPORTS_THREADLOCAL 0
457 #if defined(__thumb__) && defined(__linux__)
459 // https://lab.llvm.org/buildbot/#/builders/clang-thumbv7-full-2stage
461 // https://lab.llvm.org/staging/#/builders/clang-thumbv7-full-2stage
462 // It fails *rss_limit_mb_test* without meaningful errors.
463 # define SANITIZER_START_BACKGROUND_THREAD_IN_ASAN_INTERNAL 1
465 # define SANITIZER_START_BACKGROUND_THREAD_IN_ASAN_INTERNAL 0
468 #endif // SANITIZER_PLATFORM_H