492683527e
Currently, LLDB assumes all minidumps will have unique sections. This is intuitive because almost all of the minidump sections are themselves lists. Exceptions including Signals are unique in that they are all individual sections with their own directory. This means LLDB fails to load minidumps with multiple exceptions due to them not being unique. This behavior is erroneous and this PR introduces support for an arbitrary number of exception streams. Additionally, stop info was calculated only for a single thread before, and now we properly support mapping exceptions to threads. ~~This PR is starting in DRAFT because implementing testing is still required.~~
120 lines
3.9 KiB
C++
120 lines
3.9 KiB
C++
//===-- 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 LLDB_SOURCE_PLUGINS_PROCESS_MINIDUMP_MINIDUMPPARSER_H
|
|
#define LLDB_SOURCE_PLUGINS_PROCESS_MINIDUMP_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/StringRef.h"
|
|
#include "llvm/Object/Minidump.h"
|
|
|
|
// C includes
|
|
|
|
// C++ includes
|
|
#include <cstring>
|
|
#include <optional>
|
|
#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;
|
|
}
|
|
};
|
|
|
|
using FallibleMemory64Iterator = llvm::object::MinidumpFile::FallibleMemory64Iterator;
|
|
using ExceptionStreamsIterator =
|
|
llvm::object::MinidumpFile::ExceptionStreamsIterator;
|
|
|
|
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();
|
|
|
|
std::optional<LinuxProcStatus> GetLinuxProcStatus();
|
|
|
|
std::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();
|
|
|
|
llvm::iterator_range<ExceptionStreamsIterator> GetExceptionStreams();
|
|
|
|
std::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();
|
|
|
|
llvm::iterator_range<FallibleMemory64Iterator> GetMemory64Iterator(llvm::Error &err);
|
|
|
|
static llvm::StringRef GetStreamTypeAsString(StreamType stream_type);
|
|
|
|
llvm::object::MinidumpFile &GetMinidumpFile() { return *m_file; }
|
|
|
|
static MemoryRegionInfo GetMemoryRegionInfo(const MemoryRegionInfos ®ions,
|
|
lldb::addr_t load_addr);
|
|
|
|
private:
|
|
MinidumpParser(lldb::DataBufferSP data_sp,
|
|
std::unique_ptr<llvm::object::MinidumpFile> file);
|
|
|
|
lldb::DataBufferSP m_data_sp;
|
|
std::unique_ptr<llvm::object::MinidumpFile> m_file;
|
|
ArchSpec m_arch;
|
|
};
|
|
|
|
} // end namespace minidump
|
|
} // end namespace lldb_private
|
|
#endif // LLDB_SOURCE_PLUGINS_PROCESS_MINIDUMP_MINIDUMPPARSER_H
|