Home | History | Annotate | Download | only in rtl
      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.")
     80