1 //===-- ProcessElfCore.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 // Notes about Linux Process core dumps:
9 //  1) Linux core dump is stored as ELF file.
10 //  2) The ELF file's PT_NOTE and PT_LOAD segments describes the program's
11 //     address space and thread contexts.
12 //  3) PT_NOTE segment contains note entries which describes a thread context.
13 //  4) PT_LOAD segment describes a valid contiguous range of process address
14 //     space.
15 //===----------------------------------------------------------------------===//
16 
17 #ifndef liblldb_ProcessElfCore_h_
18 #define liblldb_ProcessElfCore_h_
19 
20 // C Includes
21 // C++ Includes
22 #include <list>
23 #include <vector>
24 
25 // Other libraries and framework includes
26 // Project includes
27 #include "lldb/Target/Process.h"
28 #include "lldb/Utility/ConstString.h"
29 #include "lldb/Utility/Status.h"
30 
31 #include "Plugins/ObjectFile/ELF/ELFHeader.h"
32 
33 struct ThreadData;
34 
35 class ProcessElfCore : public lldb_private::Process {
36 public:
37   //------------------------------------------------------------------
38   // Constructors and Destructors
39   //------------------------------------------------------------------
40   static lldb::ProcessSP
41   CreateInstance(lldb::TargetSP target_sp, lldb::ListenerSP listener_sp,
42                  const lldb_private::FileSpec *crash_file_path);
43 
44   static void Initialize();
45 
46   static void Terminate();
47 
48   static lldb_private::ConstString GetPluginNameStatic();
49 
50   static const char *GetPluginDescriptionStatic();
51 
52   //------------------------------------------------------------------
53   // Constructors and Destructors
54   //------------------------------------------------------------------
55   ProcessElfCore(lldb::TargetSP target_sp, lldb::ListenerSP listener_sp,
56                  const lldb_private::FileSpec &core_file);
57 
58   ~ProcessElfCore() override;
59 
60   //------------------------------------------------------------------
61   // Check if a given Process
62   //------------------------------------------------------------------
63   bool CanDebug(lldb::TargetSP target_sp,
64                 bool plugin_specified_by_name) override;
65 
66   //------------------------------------------------------------------
67   // Creating a new process, or attaching to an existing one
68   //------------------------------------------------------------------
69   lldb_private::Status DoLoadCore() override;
70 
71   lldb_private::DynamicLoader *GetDynamicLoader() override;
72 
73   //------------------------------------------------------------------
74   // PluginInterface protocol
75   //------------------------------------------------------------------
76   lldb_private::ConstString GetPluginName() override;
77 
78   uint32_t GetPluginVersion() override;
79 
80   //------------------------------------------------------------------
81   // Process Control
82   //------------------------------------------------------------------
83   lldb_private::Status DoDestroy() override;
84 
85   void RefreshStateAfterStop() override;
86 
87   //------------------------------------------------------------------
88   // Process Queries
89   //------------------------------------------------------------------
90   bool IsAlive() override;
91 
92   bool WarnBeforeDetach() const override { return false; }
93 
94   //------------------------------------------------------------------
95   // Process Memory
96   //------------------------------------------------------------------
97   size_t ReadMemory(lldb::addr_t addr, void *buf, size_t size,
98                     lldb_private::Status &error) override;
99 
100   size_t DoReadMemory(lldb::addr_t addr, void *buf, size_t size,
101                       lldb_private::Status &error) override;
102 
103   lldb_private::Status
104   GetMemoryRegionInfo(lldb::addr_t load_addr,
105                       lldb_private::MemoryRegionInfo &region_info) override;
106 
107   lldb::addr_t GetImageInfoAddress() override;
108 
109   lldb_private::ArchSpec GetArchitecture();
110 
111   // Returns AUXV structure found in the core file
112   const lldb::DataBufferSP GetAuxvData() override;
113 
114   bool GetProcessInfo(lldb_private::ProcessInstanceInfo &info) override;
115 
116 protected:
117   void Clear();
118 
119   bool UpdateThreadList(lldb_private::ThreadList &old_thread_list,
120                         lldb_private::ThreadList &new_thread_list) override;
121 
122 private:
123   struct NT_FILE_Entry {
124     lldb::addr_t start;
125     lldb::addr_t end;
126     lldb::addr_t file_ofs;
127     lldb_private::ConstString path;
128   };
129 
130   //------------------------------------------------------------------
131   // For ProcessElfCore only
132   //------------------------------------------------------------------
133   typedef lldb_private::Range<lldb::addr_t, lldb::addr_t> FileRange;
134   typedef lldb_private::RangeDataArray<lldb::addr_t, lldb::addr_t, FileRange, 1>
135       VMRangeToFileOffset;
136   typedef lldb_private::RangeDataVector<lldb::addr_t, lldb::addr_t, uint32_t>
137       VMRangeToPermissions;
138 
139   lldb::ModuleSP m_core_module_sp;
140   lldb_private::FileSpec m_core_file;
141   std::string m_dyld_plugin_name;
142   DISALLOW_COPY_AND_ASSIGN(ProcessElfCore);
143 
144   llvm::Triple::OSType m_os;
145 
146   // True if m_thread_contexts contains valid entries
147   bool m_thread_data_valid;
148 
149   // Contain thread data read from NOTE segments
150   std::vector<ThreadData> m_thread_data;
151 
152   // AUXV structure found from the NOTE segment
153   lldb_private::DataExtractor m_auxv;
154 
155   // Address ranges found in the core
156   VMRangeToFileOffset m_core_aranges;
157 
158   // Permissions for all ranges
159   VMRangeToPermissions m_core_range_infos;
160 
161   // NT_FILE entries found from the NOTE segment
162   std::vector<NT_FILE_Entry> m_nt_file_entries;
163 
164   // Parse thread(s) data structures(prstatus, prpsinfo) from given NOTE segment
165   lldb_private::Status ParseThreadContextsFromNoteSegment(
166       const elf::ELFProgramHeader *segment_header,
167       lldb_private::DataExtractor segment_data);
168 
169   // Returns number of thread contexts stored in the core file
170   uint32_t GetNumThreadContexts();
171 
172   // Parse a contiguous address range of the process from LOAD segment
173   lldb::addr_t
174   AddAddressRangeFromLoadSegment(const elf::ELFProgramHeader *header);
175 };
176 
177 #endif // liblldb_ProcessElfCore_h_
178