LLDB mainline
ObjectFileMinidump.h
Go to the documentation of this file.
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
25
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
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
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,
55
56 // Saves dump in Minidump file format
57 static bool SaveCore(const lldb::ProcessSP &process_sp,
60
61private:
62 ObjectFileMinidump() = default;
63};
64
65#endif // LLDB_SOURCE_PLUGINS_OBJECTFILE_MINIDUMP_OBJECTFILEMINIDUMP_H
static llvm::raw_ostream & error(Stream &strm)
static const char * GetPluginDescriptionStatic()
static lldb_private::ObjectFile * CreateInstance(const lldb::ModuleSP &module_sp, lldb::DataBufferSP data_sp, lldb::offset_t data_offset, const lldb_private::FileSpec *file, lldb::offset_t offset, lldb::offset_t length)
llvm::StringRef GetPluginName() override
static size_t GetModuleSpecifications(const lldb_private::FileSpec &file, lldb::DataBufferSP &data_sp, lldb::offset_t data_offset, lldb::offset_t file_offset, lldb::offset_t length, lldb_private::ModuleSpecList &specs)
static lldb_private::ObjectFile * CreateMemoryInstance(const lldb::ModuleSP &module_sp, lldb::WritableDataBufferSP data_sp, const lldb::ProcessSP &process_sp, lldb::addr_t header_addr)
ObjectFileMinidump()=default
static llvm::StringRef GetPluginNameStatic()
static bool SaveCore(const lldb::ProcessSP &process_sp, lldb_private::SaveCoreOptions &options, lldb_private::Status &error)
A file utility class.
Definition: FileSpec.h:56
A plug-in interface definition class for object file parsers.
Definition: ObjectFile.h:44
An error handling class.
Definition: Status.h:44
uint64_t offset_t
Definition: lldb-types.h:85
std::shared_ptr< lldb_private::Process > ProcessSP
Definition: lldb-forward.h:387
std::shared_ptr< lldb_private::DataBuffer > DataBufferSP
Definition: lldb-forward.h:334
std::shared_ptr< lldb_private::WritableDataBuffer > WritableDataBufferSP
Definition: lldb-forward.h:335
uint64_t addr_t
Definition: lldb-types.h:80
std::shared_ptr< lldb_private::Module > ModuleSP
Definition: lldb-forward.h:371