contrib/llvm/tools/lldb/include/lldb/Target/SectionLoadHistory.h

   1 //===-- SectionLoadHistory.h ------------------------------------*- C++ -*-===//
   2 //
   3 //                     The LLVM Compiler Infrastructure
   4 //
   5 // This file is distributed under the University of Illinois Open Source
   6 // License. See LICENSE.TXT for details.
   7 //
   8 //===----------------------------------------------------------------------===//
   9
  10 #ifndef liblldb_SectionLoadHistory_h_
  11 #define liblldb_SectionLoadHistory_h_
  12
  13 // C Includes
  14 // C++ Includes
  15 #include <map>
  16
  17 // Project includes
  18 #include "lldb/lldb-public.h"
  19 #include "lldb/Host/Mutex.h"
  20
  21 namespace lldb_private {
  22
  23 class SectionLoadHistory
  24 {
  25 public:
  26     enum {
  27         // Pass eStopIDNow to any function that takes a stop ID to get
  28         // the current value.
  29         eStopIDNow = UINT32_MAX
  30     };
  31     //------------------------------------------------------------------
  32     // Constructors and Destructors
  33     //------------------------------------------------------------------
  34     SectionLoadHistory () :
  35         m_stop_id_to_section_load_list(),
  36         m_mutex (Mutex::eMutexTypeRecursive)
  37     {
  38     }
  39
  40     ~SectionLoadHistory()
  41     {
  42         // Call clear since this takes a lock and clears the section load list
  43         // in case another thread is currently using this section load list
  44         Clear();
  45     }
  46
  47     SectionLoadList &
  48     GetCurrentSectionLoadList ();
  49
  50     bool
  51     IsEmpty() const;
  52
  53     void
  54     Clear ();
  55
  56     uint32_t
  57     GetLastStopID() const;
  58
  59     // Get the section load address given a process stop ID
  60     lldb::addr_t
  61     GetSectionLoadAddress (uint32_t stop_id,
  62                            const lldb::SectionSP &section_sp);
  63
  64     bool
  65     ResolveLoadAddress (uint32_t stop_id,
  66                         lldb::addr_t load_addr,
  67                         Address &so_addr);
  68
  69     bool
  70     SetSectionLoadAddress (uint32_t stop_id,
  71                            const lldb::SectionSP &section_sp,
  72                            lldb::addr_t load_addr,
  73                            bool warn_multiple = false);
  74
  75     // The old load address should be specified when unloading to ensure we get
  76     // the correct instance of the section as a shared library could be loaded
  77     // at more than one location.
  78     bool
  79     SetSectionUnloaded (uint32_t stop_id,
  80                         const lldb::SectionSP &section_sp,
  81                         lldb::addr_t load_addr);
  82
  83     // Unload all instances of a section. This function can be used on systems
  84     // that don't support multiple copies of the same shared library to be
  85     // loaded at the same time.
  86     size_t
  87     SetSectionUnloaded (uint32_t stop_id,
  88                         const lldb::SectionSP &section_sp);
  89
  90     void
  91     Dump (Stream &s,
  92           Target *target);
  93
  94 protected:
  95
  96     SectionLoadList *
  97     GetSectionLoadListForStopID (uint32_t stop_id, bool read_only);
  98
  99     typedef std::map<uint32_t, lldb::SectionLoadListSP> StopIDToSectionLoadList;
 100     StopIDToSectionLoadList m_stop_id_to_section_load_list;
 101     mutable Mutex m_mutex;
 102
 103 private:
 104     DISALLOW_COPY_AND_ASSIGN (SectionLoadHistory);
 105 };
 106
 107 } // namespace lldb_private
 108
 109 #endif  // liblldb_SectionLoadHistory_h_