contrib/llvm-project/lldb/include/lldb/Target/SectionLoadList.h

   1 //===-- SectionLoadList.h -----------------------------------------------*- C++
   2 //-*-===//
   3 //
   4 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
   5 // See https://llvm.org/LICENSE.txt for license information.
   6 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
   7 //
   8 //===----------------------------------------------------------------------===//
   9
  10 #ifndef liblldb_SectionLoadList_h_
  11 #define liblldb_SectionLoadList_h_
  12
  13 #include <map>
  14 #include <mutex>
  15
  16 #include "llvm/ADT/DenseMap.h"
  17 #include "lldb/Core/Section.h"
  18 #include "lldb/lldb-public.h"
  19
  20 namespace lldb_private {
  21
  22 class SectionLoadList {
  23 public:
  24   // Constructors and Destructors
  25   SectionLoadList() : m_addr_to_sect(), m_sect_to_addr(), m_mutex() {}
  26
  27   SectionLoadList(const SectionLoadList &rhs);
  28
  29   ~SectionLoadList() {
  30     // Call clear since this takes a lock and clears the section load list in
  31     // case another thread is currently using this section load list
  32     Clear();
  33   }
  34
  35   void operator=(const SectionLoadList &rhs);
  36
  37   bool IsEmpty() const;
  38
  39   void Clear();
  40
  41   lldb::addr_t GetSectionLoadAddress(const lldb::SectionSP &section_sp) const;
  42
  43   bool ResolveLoadAddress(lldb::addr_t load_addr, Address &so_addr,
  44                           bool allow_section_end = false) const;
  45
  46   bool SetSectionLoadAddress(const lldb::SectionSP &section_sp,
  47                              lldb::addr_t load_addr,
  48                              bool warn_multiple = false);
  49
  50   // The old load address should be specified when unloading to ensure we get
  51   // the correct instance of the section as a shared library could be loaded at
  52   // more than one location.
  53   bool SetSectionUnloaded(const lldb::SectionSP &section_sp,
  54                           lldb::addr_t load_addr);
  55
  56   // Unload all instances of a section. This function can be used on systems
  57   // that don't support multiple copies of the same shared library to be loaded
  58   // at the same time.
  59   size_t SetSectionUnloaded(const lldb::SectionSP &section_sp);
  60
  61   void Dump(Stream &s, Target *target);
  62
  63 protected:
  64   typedef std::map<lldb::addr_t, lldb::SectionSP> addr_to_sect_collection;
  65   typedef llvm::DenseMap<const Section *, lldb::addr_t> sect_to_addr_collection;
  66   addr_to_sect_collection m_addr_to_sect;
  67   sect_to_addr_collection m_sect_to_addr;
  68   mutable std::recursive_mutex m_mutex;
  69 };
  70
  71 } // namespace lldb_private
  72
  73 #endif // liblldb_SectionLoadList_h_