#ifndef liblldb_Disassembler_h_
#define liblldb_Disassembler_h_
#include <vector>
#include "lldb/lldb-private.h"
#include "lldb/Core/Address.h"
#include "lldb/Core/ArchSpec.h"
#include "lldb/Core/EmulateInstruction.h"
#include "lldb/Core/Opcode.h"
#include "lldb/Core/PluginInterface.h"
#include "lldb/Interpreter/NamedOptionValue.h"
namespace lldb_private {
class Instruction
{
public:
Instruction (const Address &address,
AddressClass addr_class = eAddressClassInvalid);
virtual
~Instruction();
const Address &
GetAddress () const
{
return m_address;
}
AddressClass
GetAddressClass ();
void
SetAddress (const Address &addr)
{
m_address_class = eAddressClassInvalid;
m_address = addr;
}
virtual void
Dump (Stream *s,
uint32_t max_opcode_byte_size,
bool show_address,
bool show_bytes,
const ExecutionContext *exe_ctx,
bool raw) = 0;
virtual bool
DoesBranch () const = 0;
virtual size_t
Decode (const Disassembler &disassembler,
const DataExtractor& data,
uint32_t data_offset) = 0;
virtual void
SetDescription (const char *) {};
lldb::OptionValueSP
ReadArray (FILE *in_file, Stream *out_stream, OptionValue::Type data_type);
lldb::OptionValueSP
ReadDictionary (FILE *in_file, Stream *out_stream);
bool
DumpEmulation (const ArchSpec &arch);
virtual bool
TestEmulation (Stream *stream, const char *test_file_name);
bool
Emulate (const ArchSpec &arch,
uint32_t evaluate_options,
void *baton,
EmulateInstruction::ReadMemoryCallback read_mem_callback,
EmulateInstruction::WriteMemoryCallback write_mem_calback,
EmulateInstruction::ReadRegisterCallback read_reg_callback,
EmulateInstruction::WriteRegisterCallback write_reg_callback);
const Opcode &
GetOpcode () const
{
return m_opcode;
}
protected:
Address m_address; AddressClass m_address_class;
Opcode m_opcode; };
class InstructionList
{
public:
InstructionList();
~InstructionList();
size_t
GetSize() const;
uint32_t
GetMaxOpcocdeByteSize () const;
lldb::InstructionSP
GetInstructionAtIndex (uint32_t idx) const;
void
Clear();
void
Append (lldb::InstructionSP &inst_sp);
private:
typedef std::vector<lldb::InstructionSP> collection;
typedef collection::iterator iterator;
typedef collection::const_iterator const_iterator;
collection m_instructions;
};
class PseudoInstruction :
public lldb_private::Instruction
{
public:
PseudoInstruction ();
virtual
~PseudoInstruction ();
virtual void
Dump (lldb_private::Stream *s,
uint32_t max_opcode_byte_size,
bool show_address,
bool show_bytes,
const lldb_private::ExecutionContext* exe_ctx,
bool raw);
virtual bool
DoesBranch () const;
virtual size_t
Decode (const lldb_private::Disassembler &disassembler,
const lldb_private::DataExtractor &data,
uint32_t data_offset);
void
SetOpcode (size_t opcode_size, void *opcode_data);
virtual void
SetDescription (const char *description);
protected:
std::string m_description;
DISALLOW_COPY_AND_ASSIGN (PseudoInstruction);
};
class Disassembler :
public PluginInterface
{
public:
enum
{
eOptionNone = 0u,
eOptionShowBytes = (1u << 0),
eOptionRawOuput = (1u << 1),
eOptionMarkPCSourceLine = (1u << 2), eOptionMarkPCAddress = (1u << 3) };
static Disassembler*
FindPlugin (const ArchSpec &arch, const char *plugin_name);
static lldb::DisassemblerSP
DisassembleRange (const ArchSpec &arch,
const char *plugin_name,
const ExecutionContext &exe_ctx,
const AddressRange &disasm_range);
static bool
Disassemble (Debugger &debugger,
const ArchSpec &arch,
const char *plugin_name,
const ExecutionContext &exe_ctx,
const AddressRange &range,
uint32_t num_instructions,
uint32_t num_mixed_context_lines,
uint32_t options,
Stream &strm);
static bool
Disassemble (Debugger &debugger,
const ArchSpec &arch,
const char *plugin_name,
const ExecutionContext &exe_ctx,
const Address &start,
uint32_t num_instructions,
uint32_t num_mixed_context_lines,
uint32_t options,
Stream &strm);
static size_t
Disassemble (Debugger &debugger,
const ArchSpec &arch,
const char *plugin_name,
const ExecutionContext &exe_ctx,
SymbolContextList &sc_list,
uint32_t num_instructions,
uint32_t num_mixed_context_lines,
uint32_t options,
Stream &strm);
static bool
Disassemble (Debugger &debugger,
const ArchSpec &arch,
const char *plugin_name,
const ExecutionContext &exe_ctx,
const ConstString &name,
Module *module,
uint32_t num_instructions,
uint32_t num_mixed_context_lines,
uint32_t options,
Stream &strm);
static bool
Disassemble (Debugger &debugger,
const ArchSpec &arch,
const char *plugin_name,
const ExecutionContext &exe_ctx,
uint32_t num_instructions,
uint32_t num_mixed_context_lines,
uint32_t options,
Stream &strm);
Disassembler(const ArchSpec &arch);
virtual ~Disassembler();
typedef const char * (*SummaryCallback)(const Instruction& inst, ExecutionContext *exe_context, void *user_data);
static bool
PrintInstructions (Disassembler *disasm_ptr,
Debugger &debugger,
const ArchSpec &arch,
const ExecutionContext &exe_ctx,
uint32_t num_instructions,
uint32_t num_mixed_context_lines,
uint32_t options,
Stream &strm);
size_t
ParseInstructions (const ExecutionContext *exe_ctx,
const AddressRange &range);
size_t
ParseInstructions (const ExecutionContext *exe_ctx,
const Address &range,
uint32_t num_instructions);
virtual size_t
DecodeInstructions (const Address &base_addr,
const DataExtractor& data,
uint32_t data_offset,
uint32_t num_instructions,
bool append) = 0;
InstructionList &
GetInstructionList ();
const InstructionList &
GetInstructionList () const;
const ArchSpec &
GetArchitecture () const
{
return m_arch;
}
protected:
const ArchSpec m_arch;
InstructionList m_instruction_list;
lldb::addr_t m_base_addr;
private:
DISALLOW_COPY_AND_ASSIGN (Disassembler);
};
}
#endif // liblldb_Disassembler_h_