1 //===-- sanitizer_procmaps.h ------------------------------------*- C++ -*-===// 2 // 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 6 // 7 //===----------------------------------------------------------------------===// 8 // 9 // This file is shared between AddressSanitizer and ThreadSanitizer. 10 // 11 // Information about the process mappings. 12 //===----------------------------------------------------------------------===// 13 #ifndef SANITIZER_PROCMAPS_H 14 #define SANITIZER_PROCMAPS_H 15 16 #include "sanitizer_platform.h" 17 18 #if SANITIZER_LINUX || SANITIZER_FREEBSD || SANITIZER_NETBSD || \ 19 SANITIZER_OPENBSD || SANITIZER_MAC || SANITIZER_SOLARIS || \ 20 SANITIZER_FUCHSIA 21 22 #include "sanitizer_common.h" 23 #include "sanitizer_internal_defs.h" 24 #include "sanitizer_fuchsia.h" 25 #include "sanitizer_linux.h" 26 #include "sanitizer_mac.h" 27 #include "sanitizer_mutex.h" 28 29 namespace __sanitizer { 30 31 // Memory protection masks. 32 static const uptr kProtectionRead = 1; 33 static const uptr kProtectionWrite = 2; 34 static const uptr kProtectionExecute = 4; 35 static const uptr kProtectionShared = 8; 36 37 struct MemoryMappedSegmentData; 38 39 class MemoryMappedSegment { 40 public: 41 explicit MemoryMappedSegment(char *buff = nullptr, uptr size = 0) 42 : filename(buff), filename_size(size), data_(nullptr) {} 43 ~MemoryMappedSegment() {} 44 45 bool IsReadable() const { return protection & kProtectionRead; } 46 bool IsWritable() const { return protection & kProtectionWrite; } 47 bool IsExecutable() const { return protection & kProtectionExecute; } 48 bool IsShared() const { return protection & kProtectionShared; } 49 50 void AddAddressRanges(LoadedModule *module); 51 52 uptr start; 53 uptr end; 54 uptr offset; 55 char *filename; // owned by caller 56 uptr filename_size; 57 uptr protection; 58 ModuleArch arch; 59 u8 uuid[kModuleUUIDSize]; 60 61 private: 62 friend class MemoryMappingLayout; 63 64 // This field is assigned and owned by MemoryMappingLayout if needed 65 MemoryMappedSegmentData *data_; 66 }; 67 68 class MemoryMappingLayout { 69 public: 70 explicit MemoryMappingLayout(bool cache_enabled); 71 ~MemoryMappingLayout(); 72 bool Next(MemoryMappedSegment *segment); 73 bool Error() const; 74 void Reset(); 75 // In some cases, e.g. when running under a sandbox on Linux, ASan is unable 76 // to obtain the memory mappings. It should fall back to pre-cached data 77 // instead of aborting. 78 static void CacheMemoryMappings(); 79 80 // Adds all mapped objects into a vector. 81 void DumpListOfModules(InternalMmapVectorNoCtor<LoadedModule> *modules); 82 83 private: 84 void LoadFromCache(); 85 86 MemoryMappingLayoutData data_; 87 }; 88 89 // Returns code range for the specified module. 90 bool GetCodeRangeForFile(const char *module, uptr *start, uptr *end); 91 92 bool IsDecimal(char c); 93 uptr ParseDecimal(const char **p); 94 bool IsHex(char c); 95 uptr ParseHex(const char **p); 96 97 } // namespace __sanitizer 98 99 #endif 100 #endif // SANITIZER_PROCMAPS_H 101