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