7b18dd4f77
Summary: This plugin resembles the already existing Windows-only Minidump plugin. The WinMinidumpPlugin uses the Windows API for parsing Minidumps while this plugin is cross-platform because it includes a Minidump parser (which is already commited) It is able to produce a backtrace, to read the general puprose regiters, inspect local variables, show image list, do memory reads, etc. For now the only arches that this supports are x86_32 and x86_64. This is because I have only written register contexts for those. Others will come in next CLs. I copied the WinMinidump tests and adapted them a little bit for them to work with the new plugin (and they pass) I will add more tests, aiming for better code coverage. There is still functionality to be added, see TODOs in code. Reviewers: labath, zturner Subscribers: beanz, mgorny, modocache, lldb-commits, amccarth Differential Revision: https://reviews.llvm.org/D25905 llvm-svn: 285587
103 lines
3.0 KiB
C++
103 lines
3.0 KiB
C++
//===-- MinidumpParser.h -----------------------------------------*- C++
|
|
//-*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef liblldb_MinidumpParser_h_
|
|
#define liblldb_MinidumpParser_h_
|
|
|
|
// Project includes
|
|
#include "MinidumpTypes.h"
|
|
|
|
// Other libraries and framework includes
|
|
#include "lldb/Core/ArchSpec.h"
|
|
#include "lldb/Core/DataBuffer.h"
|
|
#include "lldb/Core/Error.h"
|
|
|
|
#include "llvm/ADT/ArrayRef.h"
|
|
#include "llvm/ADT/DenseMap.h"
|
|
#include "llvm/ADT/Optional.h"
|
|
#include "llvm/ADT/StringRef.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) {}
|
|
};
|
|
|
|
class MinidumpParser {
|
|
public:
|
|
static llvm::Optional<MinidumpParser>
|
|
Create(const lldb::DataBufferSP &data_buf_sp);
|
|
|
|
llvm::ArrayRef<uint8_t> GetData();
|
|
|
|
llvm::ArrayRef<uint8_t> GetStream(MinidumpStreamType stream_type);
|
|
|
|
llvm::Optional<std::string> GetMinidumpString(uint32_t rva);
|
|
|
|
llvm::ArrayRef<MinidumpThread> GetThreads();
|
|
|
|
llvm::ArrayRef<uint8_t> GetThreadContext(const MinidumpThread &td);
|
|
|
|
llvm::ArrayRef<uint8_t> GetThreadContextWow64(const MinidumpThread &td);
|
|
|
|
const MinidumpSystemInfo *GetSystemInfo();
|
|
|
|
ArchSpec GetArchitecture();
|
|
|
|
const MinidumpMiscInfo *GetMiscInfo();
|
|
|
|
llvm::Optional<LinuxProcStatus> GetLinuxProcStatus();
|
|
|
|
llvm::Optional<lldb::pid_t> GetPid();
|
|
|
|
llvm::ArrayRef<MinidumpModule> 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 MinidumpModule *> GetFilteredModuleList();
|
|
|
|
const MinidumpExceptionStream *GetExceptionStream();
|
|
|
|
llvm::Optional<Range> FindMemoryRange(lldb::addr_t addr);
|
|
|
|
llvm::ArrayRef<uint8_t> GetMemory(lldb::addr_t addr, size_t size);
|
|
|
|
llvm::Optional<MemoryRegionInfo> GetMemoryRegionInfo(lldb::addr_t);
|
|
|
|
private:
|
|
lldb::DataBufferSP m_data_sp;
|
|
const MinidumpHeader *m_header;
|
|
llvm::DenseMap<uint32_t, MinidumpLocationDescriptor> m_directory_map;
|
|
|
|
MinidumpParser(
|
|
const lldb::DataBufferSP &data_buf_sp, const MinidumpHeader *header,
|
|
llvm::DenseMap<uint32_t, MinidumpLocationDescriptor> &&directory_map);
|
|
};
|
|
|
|
} // end namespace minidump
|
|
} // end namespace lldb_private
|
|
#endif // liblldb_MinidumpParser_h_
|