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