[tsan] Add more interface functions into tsan_interface.h

[dvyukov]

compiler-rt/lib/tsan/rtl/tsan_interface.h

40

I don't think we want these test-only interfaces here.
That's just an implementation detail for unit-tests. There are also:

__tsan_testonly_barrier_init
__tsan_testonly_barrier_wait
__tsan_testonly_shadow_stack_current_size

But we don't want any external users to depend on them.
E.g. at least to rename them consistently to "test_only" or "testonly" :)

[vitalybuka]

compiler-rt/lib/tsan/rtl/tsan_interface.h

40

yes, that's probably me readin prefix and suffix and missed the "test"

compiler-rt/lib/tsan/rtl/tsan_interface.h

 #if !SANITIZER_GO
 
 // This function should be called at the very beginning of the process,
 // before any instrumented code is executed and before any call to malloc.
 SANITIZER_INTERFACE_ATTRIBUTE void __tsan_init();
 
 SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE const char *
 __tsan_default_options();
+SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE const char *
+__tsan_default_suppressions();
+SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE void
+__tsan_test_only_on_fork();
 
 SANITIZER_INTERFACE_ATTRIBUTE void __tsan_flush_memory();
 
 SANITIZER_INTERFACE_ATTRIBUTE void __tsan_read1(void *addr);
 SANITIZER_INTERFACE_ATTRIBUTE void __tsan_read2(void *addr);
 SANITIZER_INTERFACE_ATTRIBUTE void __tsan_read4(void *addr);
 SANITIZER_INTERFACE_ATTRIBUTE void __tsan_read8(void *addr);
 SANITIZER_INTERFACE_ATTRIBUTE void __tsan_read16(void *addr);

 SANITIZER_INTERFACE_ATTRIBUTE
 void __tsan_write_range(void *addr, unsigned long size);
 
 SANITIZER_INTERFACE_ATTRIBUTE
 void __tsan_read_range_pc(void *addr, unsigned long size, void *pc);
 SANITIZER_INTERFACE_ATTRIBUTE
 void __tsan_write_range_pc(void *addr, unsigned long size, void *pc);
 
-// User may provide function that would be called right when TSan detects
-// an error. The argument 'report' is an opaque pointer that can be used to
-// gather additional information using other TSan report API functions.
-SANITIZER_INTERFACE_ATTRIBUTE
-void __tsan_on_report(void *report);
-
 // If TSan is currently reporting a detected issue on the current thread,
 // returns an opaque pointer to the current report. Otherwise returns NULL.
 SANITIZER_INTERFACE_ATTRIBUTE
 void *__tsan_get_current_report();
 
 // Returns a report's description (issue type), number of duplicate issues
 // found, counts of array data (stack traces, memory operations, locations,
 // mutexes, threads, unique thread IDs) and a stack trace of a sleep() call (if

 const char *__tsan_locate_address(uptr addr, char *name, uptr name_size,
                                   uptr *region_address, uptr *region_size);
 
 // Returns the allocation stack for a heap pointer.
 SANITIZER_INTERFACE_ATTRIBUTE
 int __tsan_get_alloc_stack(uptr addr, uptr *trace, uptr size, int *thread_id,
                            tid_t *os_id);
 
+// May be overriden by JIT/JAVA/etc, whatever produces PCs marked with
+// kExternalPCBit.
+SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE void
+__tsan_symbolize_external_ex(uptr pc,
+                             void (*add_frame)(void *, const char *,
+                                               const char *, int, int),
+                             void *ctx);
+
+// Legacy API. May be overriden by JIT/JAVA/etc, whatever produces PCs marked
+// with kExternalPCBit.
+SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE
+bool __tsan_symbolize_external(uptr pc, char *func_buf, uptr func_siz,
+                               char *file_buf, uptr file_siz, int *line,
+                               int *col);
+
 #endif  // SANITIZER_GO
 
 #ifdef __cplusplus
 }  // extern "C"
 #endif
 
 namespace __tsan {
 
typedef enum {
   mo_relaxed,
   mo_consume,
   mo_acquire,
   mo_release,
   mo_acq_rel,
   mo_seq_cst
 } morder;
 
+#if !SANITIZER_GO
+class ReportDesc;
+extern "C++" SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE void
+OnPotentiallyBlockingRegionBegin();
+extern "C++" SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE void
+OnPotentiallyBlockingRegionEnd();
+extern "C++" SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE void
+OnInitialize();
+extern "C++" SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE bool
+OnFinalize(bool failed);
+extern "C++" SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE bool
+OnReport(const ReportDesc *rep, bool suppressed);
+// User may provide function that would be called right when TSan detects
+// an error. The argument 'report' is an opaque pointer that can be used to
+// gather additional information using other TSan report API functions.
+extern "C" SANITIZER_INTERFACE_ATTRIBUTE SANITIZER_WEAK_ATTRIBUTE void
+__tsan_on_report(const ReportDesc *report);
+#endif  // SANITIZER_GO
+
 struct ThreadState;
 
 extern "C" {
 SANITIZER_INTERFACE_ATTRIBUTE
 a8 __tsan_atomic8_load(const volatile a8 *a, morder mo);
 SANITIZER_INTERFACE_ATTRIBUTE
 a16 __tsan_atomic16_load(const volatile a16 *a, morder mo);
 SANITIZER_INTERFACE_ATTRIBUTE

compiler-rt/lib/tsan/rtl/tsan_rtl_report.cpp

 
 #include "sanitizer_common/sanitizer_common.h"
 #include "sanitizer_common/sanitizer_libc.h"
 #include "sanitizer_common/sanitizer_placement_new.h"
 #include "sanitizer_common/sanitizer_stackdepot.h"
 #include "sanitizer_common/sanitizer_stacktrace.h"
 #include "tsan_fd.h"
 #include "tsan_flags.h"
+#include "tsan_interface.h"
 #include "tsan_mman.h"
 #include "tsan_platform.h"
 #include "tsan_report.h"
 #include "tsan_rtl.h"
 #include "tsan_suppressions.h"
 #include "tsan_symbolize.h"
 #include "tsan_sync.h"
 

compiler-rt/lib/tsan/rtl/tsan_suppressions.cpp

 
 #include "tsan_suppressions.h"
 
 #include "sanitizer_common/sanitizer_common.h"
 #include "sanitizer_common/sanitizer_libc.h"
 #include "sanitizer_common/sanitizer_placement_new.h"
 #include "sanitizer_common/sanitizer_suppressions.h"
 #include "tsan_flags.h"
+#include "tsan_interface.h"
 #include "tsan_mman.h"
 #include "tsan_platform.h"
 #include "tsan_rtl.h"
 
 #if !SANITIZER_GO
 // Suppressions for true/false positives in standard libraries.
 static const char *const std_suppressions =
 // Libstdc++ 4.4 has data races in std::string.

compiler-rt/lib/tsan/rtl/tsan_symbolize.cpp

 //===----------------------------------------------------------------------===//
 
 #include "tsan_symbolize.h"
 
 #include "sanitizer_common/sanitizer_common.h"
 #include "sanitizer_common/sanitizer_placement_new.h"
 #include "sanitizer_common/sanitizer_symbolizer.h"
 #include "tsan_flags.h"
+#include "tsan_interface.h"
 #include "tsan_report.h"
 #include "tsan_rtl.h"
 
 namespace __tsan {
 
 void EnterSymbolizer() {
   ThreadState *thr = cur_thread();
   CHECK(!thr->in_symbolizer);