1//===-- ObjectFileMinidump.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/// \file 10/// Placeholder plugin for the save core functionality. 11/// 12/// ObjectFileMinidump is created only to be able to save minidump core files 13/// from existing processes with the ObjectFileMinidump::SaveCore function. 14/// Minidump files are not ObjectFile objects, but they are core files and 15/// currently LLDB's ObjectFile plug-ins handle emitting core files. If the 16/// core file saving ever moves into a new plug-in type within LLDB, this code 17/// should move as well, but for now this is the best place architecturally. 18//===----------------------------------------------------------------------===// 19 20#ifndef LLDB_SOURCE_PLUGINS_OBJECTFILE_MINIDUMP_OBJECTFILEMINIDUMP_H 21#define LLDB_SOURCE_PLUGINS_OBJECTFILE_MINIDUMP_OBJECTFILEMINIDUMP_H 22 23#include "lldb/Symbol/ObjectFile.h" 24#include "lldb/Utility/ArchSpec.h" 25 26class ObjectFileMinidump : public lldb_private::PluginInterface { 27public: 28 // Static Functions 29 static void Initialize(); 30 static void Terminate(); 31 32 static llvm::StringRef GetPluginNameStatic() { return "minidump"; } 33 static const char *GetPluginDescriptionStatic() { 34 return "Minidump object file."; 35 } 36 37 // PluginInterface protocol 38 llvm::StringRef GetPluginName() override { return GetPluginNameStatic(); } 39 40 static lldb_private::ObjectFile * 41 CreateInstance(const lldb::ModuleSP &module_sp, lldb::DataBufferSP data_sp, 42 lldb::offset_t data_offset, const lldb_private::FileSpec *file, 43 lldb::offset_t offset, lldb::offset_t length); 44 45 static lldb_private::ObjectFile *CreateMemoryInstance( 46 const lldb::ModuleSP &module_sp, lldb::WritableDataBufferSP data_sp, 47 const lldb::ProcessSP &process_sp, lldb::addr_t header_addr); 48 49 static size_t GetModuleSpecifications(const lldb_private::FileSpec &file, 50 lldb::DataBufferSP &data_sp, 51 lldb::offset_t data_offset, 52 lldb::offset_t file_offset, 53 lldb::offset_t length, 54 lldb_private::ModuleSpecList &specs); 55 56 // Saves dump in Minidump file format 57 static bool SaveCore(const lldb::ProcessSP &process_sp, 58 const lldb_private::FileSpec &outfile, 59 lldb::SaveCoreStyle &core_style, 60 lldb_private::Status &error); 61 62private: 63 ObjectFileMinidump() = default; 64}; 65 66#endif // LLDB_SOURCE_PLUGINS_OBJECTFILE_MINIDUMP_OBJECTFILEMINIDUMP_H 67