diff options
author | 2020-08-03 14:33:06 +0000 | |
---|---|---|
committer | 2020-08-03 14:33:06 +0000 | |
commit | 061da546b983eb767bad15e67af1174fb0bcf31c (patch) | |
tree | 83c78b820819d70aa40c36d90447978b300078c5 /gnu/llvm/lldb/source/Plugins/Process/minidump/MinidumpParser.h | |
parent | Import LLVM 10.0.0 release including clang, lld and lldb. (diff) | |
download | wireguard-openbsd-061da546b983eb767bad15e67af1174fb0bcf31c.tar.xz wireguard-openbsd-061da546b983eb767bad15e67af1174fb0bcf31c.zip |
Import LLVM 10.0.0 release including clang, lld and lldb.
ok hackroom
tested by plenty
Diffstat (limited to 'gnu/llvm/lldb/source/Plugins/Process/minidump/MinidumpParser.h')
-rw-r--r-- | gnu/llvm/lldb/source/Plugins/Process/minidump/MinidumpParser.h | 111 |
1 files changed, 111 insertions, 0 deletions
diff --git a/gnu/llvm/lldb/source/Plugins/Process/minidump/MinidumpParser.h b/gnu/llvm/lldb/source/Plugins/Process/minidump/MinidumpParser.h new file mode 100644 index 00000000000..4bcb2b47d45 --- /dev/null +++ b/gnu/llvm/lldb/source/Plugins/Process/minidump/MinidumpParser.h @@ -0,0 +1,111 @@ +//===-- MinidumpParser.h -----------------------------------------*- C++-*-===// +// +// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. +// See https://llvm.org/LICENSE.txt for license information. +// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception +// +//===----------------------------------------------------------------------===// + +#ifndef liblldb_MinidumpParser_h_ +#define liblldb_MinidumpParser_h_ + +#include "MinidumpTypes.h" + +#include "lldb/Target/MemoryRegionInfo.h" +#include "lldb/Utility/ArchSpec.h" +#include "lldb/Utility/DataBuffer.h" +#include "lldb/Utility/Status.h" +#include "lldb/Utility/UUID.h" + +#include "llvm/ADT/ArrayRef.h" +#include "llvm/ADT/DenseMap.h" +#include "llvm/ADT/Optional.h" +#include "llvm/ADT/StringRef.h" +#include "llvm/Object/Minidump.h" + +// C includes + +// C++ includes +#include <cstring> +#include <unordered_map> + +namespace lldb_private { + +namespace minidump { + +// Describes a range of memory captured in the Minidump +struct Range { + lldb::addr_t start; // virtual address of the beginning of the range + // range_ref - absolute pointer to the first byte of the range and size + llvm::ArrayRef<uint8_t> range_ref; + + Range(lldb::addr_t start, llvm::ArrayRef<uint8_t> range_ref) + : start(start), range_ref(range_ref) {} + + friend bool operator==(const Range &lhs, const Range &rhs) { + return lhs.start == rhs.start && lhs.range_ref == rhs.range_ref; + } +}; + +class MinidumpParser { +public: + static llvm::Expected<MinidumpParser> + Create(const lldb::DataBufferSP &data_buf_sp); + + llvm::ArrayRef<uint8_t> GetData(); + + llvm::ArrayRef<uint8_t> GetStream(StreamType stream_type); + + UUID GetModuleUUID(const minidump::Module *module); + + llvm::ArrayRef<minidump::Thread> GetThreads(); + + llvm::ArrayRef<uint8_t> GetThreadContext(const LocationDescriptor &location); + + llvm::ArrayRef<uint8_t> GetThreadContext(const minidump::Thread &td); + + llvm::ArrayRef<uint8_t> GetThreadContextWow64(const minidump::Thread &td); + + ArchSpec GetArchitecture(); + + const MinidumpMiscInfo *GetMiscInfo(); + + llvm::Optional<LinuxProcStatus> GetLinuxProcStatus(); + + llvm::Optional<lldb::pid_t> GetPid(); + + llvm::ArrayRef<minidump::Module> GetModuleList(); + + // There are cases in which there is more than one record in the ModuleList + // for the same module name.(e.g. when the binary has non contiguous segments) + // So this function returns a filtered module list - if it finds records that + // have the same name, it keeps the copy with the lowest load address. + std::vector<const minidump::Module *> GetFilteredModuleList(); + + const llvm::minidump::ExceptionStream *GetExceptionStream(); + + llvm::Optional<Range> FindMemoryRange(lldb::addr_t addr); + + llvm::ArrayRef<uint8_t> GetMemory(lldb::addr_t addr, size_t size); + + /// Returns a list of memory regions and a flag indicating whether the list is + /// complete (includes all regions mapped into the process memory). + std::pair<MemoryRegionInfos, bool> BuildMemoryRegions(); + + static llvm::StringRef GetStreamTypeAsString(StreamType stream_type); + + llvm::object::MinidumpFile &GetMinidumpFile() { return *m_file; } + +private: + MinidumpParser(lldb::DataBufferSP data_sp, + std::unique_ptr<llvm::object::MinidumpFile> file); + +private: + lldb::DataBufferSP m_data_sp; + std::unique_ptr<llvm::object::MinidumpFile> m_file; + ArchSpec m_arch; +}; + +} // end namespace minidump +} // end namespace lldb_private +#endif // liblldb_MinidumpParser_h_ |