1 //===-- MinidumpParser.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 LLDB_SOURCE_PLUGINS_PROCESS_MINIDUMP_MINIDUMPPARSER_H 10 #define LLDB_SOURCE_PLUGINS_PROCESS_MINIDUMP_MINIDUMPPARSER_H 11 12 #include "MinidumpTypes.h" 13 14 #include "lldb/Target/MemoryRegionInfo.h" 15 #include "lldb/Utility/ArchSpec.h" 16 #include "lldb/Utility/DataBuffer.h" 17 #include "lldb/Utility/Status.h" 18 #include "lldb/Utility/UUID.h" 19 20 #include "llvm/ADT/ArrayRef.h" 21 #include "llvm/ADT/DenseMap.h" 22 #include "llvm/ADT/StringRef.h" 23 #include "llvm/Object/Minidump.h" 24 25 // C includes 26 27 // C++ includes 28 #include <cstring> 29 #include <optional> 30 #include <unordered_map> 31 32 namespace lldb_private { 33 34 namespace minidump { 35 36 // Describes a range of memory captured in the Minidump 37 struct Range { 38 lldb::addr_t start; // virtual address of the beginning of the range 39 // range_ref - absolute pointer to the first byte of the range and size 40 llvm::ArrayRef<uint8_t> range_ref; 41 42 Range(lldb::addr_t start, llvm::ArrayRef<uint8_t> range_ref) 43 : start(start), range_ref(range_ref) {} 44 45 friend bool operator==(const Range &lhs, const Range &rhs) { 46 return lhs.start == rhs.start && lhs.range_ref == rhs.range_ref; 47 } 48 }; 49 50 using FallibleMemory64Iterator = llvm::object::MinidumpFile::FallibleMemory64Iterator; 51 using ExceptionStreamsIterator = 52 llvm::object::MinidumpFile::ExceptionStreamsIterator; 53 54 class MinidumpParser { 55 public: 56 static llvm::Expected<MinidumpParser> 57 Create(const lldb::DataBufferSP &data_buf_sp); 58 59 llvm::ArrayRef<uint8_t> GetData(); 60 61 llvm::ArrayRef<uint8_t> GetStream(StreamType stream_type); 62 std::optional<llvm::ArrayRef<uint8_t>> GetRawStream(StreamType stream_type); 63 64 UUID GetModuleUUID(const minidump::Module *module); 65 66 llvm::ArrayRef<minidump::Thread> GetThreads(); 67 68 llvm::ArrayRef<uint8_t> GetThreadContext(const LocationDescriptor &location); 69 70 llvm::ArrayRef<uint8_t> GetThreadContext(const minidump::Thread &td); 71 72 llvm::ArrayRef<uint8_t> GetThreadContextWow64(const minidump::Thread &td); 73 74 ArchSpec GetArchitecture(); 75 76 const MinidumpMiscInfo *GetMiscInfo(); 77 78 std::optional<LinuxProcStatus> GetLinuxProcStatus(); 79 80 std::optional<lldb::pid_t> GetPid(); 81 82 llvm::ArrayRef<minidump::Module> GetModuleList(); 83 84 // There are cases in which there is more than one record in the ModuleList 85 // for the same module name.(e.g. when the binary has non contiguous segments) 86 // So this function returns a filtered module list - if it finds records that 87 // have the same name, it keeps the copy with the lowest load address. 88 std::vector<const minidump::Module *> GetFilteredModuleList(); 89 90 llvm::iterator_range<ExceptionStreamsIterator> GetExceptionStreams(); 91 92 std::optional<Range> FindMemoryRange(lldb::addr_t addr); 93 94 llvm::ArrayRef<uint8_t> GetMemory(lldb::addr_t addr, size_t size); 95 96 /// Returns a list of memory regions and a flag indicating whether the list is 97 /// complete (includes all regions mapped into the process memory). 98 std::pair<MemoryRegionInfos, bool> BuildMemoryRegions(); 99 100 llvm::iterator_range<FallibleMemory64Iterator> GetMemory64Iterator(llvm::Error &err); 101 102 static llvm::StringRef GetStreamTypeAsString(StreamType stream_type); 103 104 llvm::object::MinidumpFile &GetMinidumpFile() { return *m_file; } 105 106 static MemoryRegionInfo GetMemoryRegionInfo(const MemoryRegionInfos ®ions, 107 lldb::addr_t load_addr); 108 109 private: 110 MinidumpParser(lldb::DataBufferSP data_sp, 111 std::unique_ptr<llvm::object::MinidumpFile> file); 112 113 lldb::DataBufferSP m_data_sp; 114 std::unique_ptr<llvm::object::MinidumpFile> m_file; 115 ArchSpec m_arch; 116 }; 117 118 } // end namespace minidump 119 } // end namespace lldb_private 120 #endif // LLDB_SOURCE_PLUGINS_PROCESS_MINIDUMP_MINIDUMPPARSER_H 121