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_APPLE || 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
29namespace __sanitizer {
30
31// Memory protection masks.
32static const uptr kProtectionRead = 1;
33static const uptr kProtectionWrite = 2;
34static const uptr kProtectionExecute = 4;
35static const uptr kProtectionShared = 8;
36
37struct MemoryMappedSegmentData;
38
39class 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
68struct ImageHeader;
69
70class MemoryMappingLayoutBase {
71 public:
72  virtual bool Next(MemoryMappedSegment *segment) { UNIMPLEMENTED(); }
73  virtual bool Error() const { UNIMPLEMENTED(); };
74  virtual void Reset() { UNIMPLEMENTED(); }
75
76 protected:
77  ~MemoryMappingLayoutBase() {}
78};
79
80class MemoryMappingLayout : public MemoryMappingLayoutBase {
81 public:
82  explicit MemoryMappingLayout(bool cache_enabled);
83
84// This destructor cannot be virtual, as it would cause an operator new() linking
85// failures in hwasan test cases. However non-virtual destructors emit warnings
86// in macOS build, hence disabling those
87#ifdef __clang__
88#pragma clang diagnostic push
89#pragma clang diagnostic ignored "-Wnon-virtual-dtor"
90#endif
91  ~MemoryMappingLayout();
92#ifdef __clang__
93#pragma clang diagnostic pop
94#endif
95
96  virtual bool Next(MemoryMappedSegment *segment) override;
97  virtual bool Error() const override;
98  virtual void Reset() override;
99  // In some cases, e.g. when running under a sandbox on Linux, ASan is unable
100  // to obtain the memory mappings. It should fall back to pre-cached data
101  // instead of aborting.
102  static void CacheMemoryMappings();
103
104  // Adds all mapped objects into a vector.
105  void DumpListOfModules(InternalMmapVectorNoCtor<LoadedModule> *modules);
106
107 protected:
108#if SANITIZER_APPLE
109  virtual const ImageHeader *CurrentImageHeader();
110#endif
111  MemoryMappingLayoutData data_;
112
113 private:
114  void LoadFromCache();
115};
116
117// Returns code range for the specified module.
118bool GetCodeRangeForFile(const char *module, uptr *start, uptr *end);
119
120bool IsDecimal(char c);
121uptr ParseDecimal(const char **p);
122bool IsHex(char c);
123uptr ParseHex(const char **p);
124
125}  // namespace __sanitizer
126
127#endif
128#endif  // SANITIZER_PROCMAPS_H
129