1 //===-- sanitizer_libignore.h -----------------------------------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // LibIgnore allows to ignore all interceptors called from a particular set
11 // of dynamic libraries. LibIgnore can be initialized with several templates
12 // of names of libraries to be ignored. It finds code ranges for the libraries;
13 // and checks whether the provided PC value belongs to the code ranges.
15 //===----------------------------------------------------------------------===//
17 #ifndef SANITIZER_LIBIGNORE_H
18 #define SANITIZER_LIBIGNORE_H
20 #include "sanitizer_internal_defs.h"
21 #include "sanitizer_common.h"
22 #include "sanitizer_atomic.h"
23 #include "sanitizer_mutex.h"
25 namespace __sanitizer {
29 explicit LibIgnore(LinkerInitialized);
31 // Must be called during initialization.
32 void AddIgnoredLibrary(const char *name_templ);
33 void IgnoreNoninstrumentedModules(bool enable) {
34 track_instrumented_libs_ = enable;
37 // Must be called after a new dynamic library is loaded.
38 void OnLibraryLoaded(const char *name);
40 // Must be called after a dynamic library is unloaded.
41 void OnLibraryUnloaded();
43 // Checks whether the provided PC belongs to one of the ignored libraries or
44 // the PC should be ignored because it belongs to an non-instrumented module
45 // (when ignore_noninstrumented_modules=1). Also returns true via
46 // "pc_in_ignored_lib" if the PC is in an ignored library, false otherwise.
47 bool IsIgnored(uptr pc, bool *pc_in_ignored_lib) const;
49 // Checks whether the provided PC belongs to an instrumented module.
50 bool IsPcInstrumented(uptr pc) const;
56 char *real_name; // target of symlink
65 inline bool IsInRange(uptr pc, const LibCodeRange &range) const {
66 return (pc >= range.begin && pc < range.end);
69 static const uptr kMaxLibs = 128;
72 atomic_uintptr_t ignored_ranges_count_;
73 LibCodeRange ignored_code_ranges_[kMaxLibs];
75 atomic_uintptr_t instrumented_ranges_count_;
76 LibCodeRange instrumented_code_ranges_[kMaxLibs];
82 bool track_instrumented_libs_;
84 // Disallow copying of LibIgnore objects.
85 LibIgnore(const LibIgnore&); // not implemented
86 void operator = (const LibIgnore&); // not implemented
89 inline bool LibIgnore::IsIgnored(uptr pc, bool *pc_in_ignored_lib) const {
90 const uptr n = atomic_load(&ignored_ranges_count_, memory_order_acquire);
91 for (uptr i = 0; i < n; i++) {
92 if (IsInRange(pc, ignored_code_ranges_[i])) {
93 *pc_in_ignored_lib = true;
97 *pc_in_ignored_lib = false;
98 if (track_instrumented_libs_ && !IsPcInstrumented(pc))
103 inline bool LibIgnore::IsPcInstrumented(uptr pc) const {
104 const uptr n = atomic_load(&instrumented_ranges_count_, memory_order_acquire);
105 for (uptr i = 0; i < n; i++) {
106 if (IsInRange(pc, instrumented_code_ranges_[i]))
112 } // namespace __sanitizer
114 #endif // SANITIZER_LIBIGNORE_H