111
|
1 //===-- tsan_flags.inc ------------------------------------------*- C++ -*-===//
|
|
2 //
|
145
|
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
|
111
|
6 //
|
|
7 //===----------------------------------------------------------------------===//
|
|
8 //
|
|
9 // TSan runtime flags.
|
|
10 //
|
|
11 //===----------------------------------------------------------------------===//
|
|
12 #ifndef TSAN_FLAG
|
|
13 # error "Define TSAN_FLAG prior to including this file!"
|
|
14 #endif
|
|
15
|
|
16 // TSAN_FLAG(Type, Name, DefaultValue, Description)
|
|
17 // See COMMON_FLAG in sanitizer_flags.inc for more details.
|
|
18
|
|
19 TSAN_FLAG(bool, enable_annotations, true,
|
|
20 "Enable dynamic annotations, otherwise they are no-ops.")
|
|
21 // Suppress a race report if we've already output another race report
|
|
22 // with the same stack.
|
|
23 TSAN_FLAG(bool, suppress_equal_stacks, true,
|
|
24 "Suppress a race report if we've already output another race report "
|
|
25 "with the same stack.")
|
|
26 TSAN_FLAG(bool, suppress_equal_addresses, true,
|
|
27 "Suppress a race report if we've already output another race report "
|
|
28 "on the same address.")
|
|
29
|
|
30 TSAN_FLAG(bool, report_bugs, true,
|
|
31 "Turns off bug reporting entirely (useful for benchmarking).")
|
|
32 TSAN_FLAG(bool, report_thread_leaks, true, "Report thread leaks at exit?")
|
|
33 TSAN_FLAG(bool, report_destroy_locked, true,
|
|
34 "Report destruction of a locked mutex?")
|
|
35 TSAN_FLAG(bool, report_mutex_bugs, true,
|
|
36 "Report incorrect usages of mutexes and mutex annotations?")
|
|
37 TSAN_FLAG(bool, report_signal_unsafe, true,
|
|
38 "Report violations of async signal-safety "
|
|
39 "(e.g. malloc() call from a signal handler).")
|
|
40 TSAN_FLAG(bool, report_atomic_races, true,
|
|
41 "Report races between atomic and plain memory accesses.")
|
|
42 TSAN_FLAG(
|
|
43 bool, force_seq_cst_atomics, false,
|
|
44 "If set, all atomics are effectively sequentially consistent (seq_cst), "
|
|
45 "regardless of what user actually specified.")
|
|
46 TSAN_FLAG(bool, print_benign, false, "Print matched \"benign\" races at exit.")
|
|
47 TSAN_FLAG(bool, halt_on_error, false, "Exit after first reported error.")
|
|
48 TSAN_FLAG(int, atexit_sleep_ms, 1000,
|
|
49 "Sleep in main thread before exiting for that many ms "
|
|
50 "(useful to catch \"at exit\" races).")
|
|
51 TSAN_FLAG(const char *, profile_memory, "",
|
|
52 "If set, periodically write memory profile to that file.")
|
|
53 TSAN_FLAG(int, flush_memory_ms, 0, "Flush shadow memory every X ms.")
|
|
54 TSAN_FLAG(int, flush_symbolizer_ms, 5000, "Flush symbolizer caches every X ms.")
|
|
55 TSAN_FLAG(
|
|
56 int, memory_limit_mb, 0,
|
|
57 "Resident memory limit in MB to aim at."
|
|
58 "If the process consumes more memory, then TSan will flush shadow memory.")
|
|
59 TSAN_FLAG(bool, stop_on_start, false,
|
|
60 "Stops on start until __tsan_resume() is called (for debugging).")
|
|
61 TSAN_FLAG(bool, running_on_valgrind, false,
|
|
62 "Controls whether RunningOnValgrind() returns true or false.")
|
|
63 // There are a lot of goroutines in Go, so we use smaller history.
|
|
64 TSAN_FLAG(
|
|
65 int, history_size, SANITIZER_GO ? 1 : 3,
|
|
66 "Per-thread history size, controls how many previous memory accesses "
|
|
67 "are remembered per thread. Possible values are [0..7]. "
|
|
68 "history_size=0 amounts to 32K memory accesses. Each next value doubles "
|
|
69 "the amount of memory accesses, up to history_size=7 that amounts to "
|
|
70 "4M memory accesses. The default value is 2 (128K memory accesses).")
|
|
71 TSAN_FLAG(int, io_sync, 1,
|
|
72 "Controls level of synchronization implied by IO operations. "
|
|
73 "0 - no synchronization "
|
|
74 "1 - reasonable level of synchronization (write->read)"
|
|
75 "2 - global synchronization of all IO operations.")
|
|
76 TSAN_FLAG(bool, die_after_fork, true,
|
|
77 "Die after multi-threaded fork if the child creates new threads.")
|
|
78 TSAN_FLAG(const char *, suppressions, "", "Suppressions file name.")
|
|
79 TSAN_FLAG(bool, ignore_noninstrumented_modules, SANITIZER_MAC ? true : false,
|
|
80 "Interceptors should only detect races when called from instrumented "
|
|
81 "modules.")
|
|
82 TSAN_FLAG(bool, shared_ptr_interceptor, true,
|
|
83 "Track atomic reference counting in libc++ shared_ptr and weak_ptr.")
|