1 //===-- ProcessMinidump.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_ProcessMinidump_h_
11 #define liblldb_ProcessMinidump_h_
12 
13 #include "MinidumpParser.h"
14 #include "MinidumpTypes.h"
15 
16 #include "lldb/Target/Process.h"
17 #include "lldb/Target/StopInfo.h"
18 #include "lldb/Target/Target.h"
19 #include "lldb/Utility/ConstString.h"
20 #include "lldb/Utility/Status.h"
21 
22 #include "llvm/Support/Format.h"
23 #include "llvm/Support/raw_ostream.h"
24 
25 
26 namespace lldb_private {
27 
28 namespace minidump {
29 
30 class ProcessMinidump : public Process {
31 public:
32   static lldb::ProcessSP CreateInstance(lldb::TargetSP target_sp,
33                                         lldb::ListenerSP listener_sp,
34                                         const FileSpec *crash_file_path);
35 
36   static void Initialize();
37 
38   static void Terminate();
39 
40   static ConstString GetPluginNameStatic();
41 
42   static const char *GetPluginDescriptionStatic();
43 
44   ProcessMinidump(lldb::TargetSP target_sp, lldb::ListenerSP listener_sp,
45                   const FileSpec &core_file, MinidumpParser minidump_parser);
46 
47   ~ProcessMinidump() override;
48 
49   bool CanDebug(lldb::TargetSP target_sp,
50                 bool plugin_specified_by_name) override;
51 
52   CommandObject *GetPluginCommandObject() override;
53 
54   Status DoLoadCore() override;
55 
GetDynamicLoader()56   DynamicLoader *GetDynamicLoader() override { return nullptr; }
57 
58   ConstString GetPluginName() override;
59 
60   uint32_t GetPluginVersion() override;
61 
GetSystemRuntime()62   SystemRuntime *GetSystemRuntime() override { return nullptr; }
63 
64   Status DoDestroy() override;
65 
66   void RefreshStateAfterStop() override;
67 
68   bool IsAlive() override;
69 
70   bool WarnBeforeDetach() const override;
71 
72   size_t ReadMemory(lldb::addr_t addr, void *buf, size_t size,
73                     Status &error) override;
74 
75   size_t DoReadMemory(lldb::addr_t addr, void *buf, size_t size,
76                       Status &error) override;
77 
78   ArchSpec GetArchitecture();
79 
80   Status GetMemoryRegionInfo(lldb::addr_t load_addr,
81                              MemoryRegionInfo &range_info) override;
82 
83   Status GetMemoryRegions(
84       lldb_private::MemoryRegionInfos &region_list) override;
85 
86   bool GetProcessInfo(ProcessInstanceInfo &info) override;
87 
WillResume()88   Status WillResume() override {
89     Status error;
90     error.SetErrorStringWithFormat(
91         "error: %s does not support resuming processes",
92         GetPluginName().GetCString());
93     return error;
94   }
95 
96   MinidumpParser m_minidump_parser;
97 
98 protected:
99   void Clear();
100 
101   bool UpdateThreadList(ThreadList &old_thread_list,
102                         ThreadList &new_thread_list) override;
103 
104   void ReadModuleList();
105 
106   JITLoaderList &GetJITLoaders() override;
107 
108 private:
109   FileSpec m_core_file;
110   llvm::ArrayRef<MinidumpThread> m_thread_list;
111   const MinidumpExceptionStream *m_active_exception;
112   lldb::CommandObjectSP m_command_sp;
113   bool m_is_wow64;
114 };
115 
116 } // namespace minidump
117 } // namespace lldb_private
118 
119 #endif // liblldb_ProcessMinidump_h_
120