LLDB mainline
lldb_private::process_gdb_remote::GDBRemoteRegisterContext Class Reference

#include <GDBRemoteRegisterContext.h>

Inheritance diagram for lldb_private::process_gdb_remote::GDBRemoteRegisterContext:
[legend]

Public Member Functions

 GDBRemoteRegisterContext (ThreadGDBRemote &thread, uint32_t concrete_frame_idx, GDBRemoteDynamicRegisterInfoSP reg_info_sp, bool read_all_at_once, bool write_all_at_once)
 ~GDBRemoteRegisterContext () override
void InvalidateAllRegisters () override
size_t GetRegisterCount () override
const RegisterInfoGetRegisterInfoAtIndex (size_t reg) override
size_t GetRegisterSetCount () override
const RegisterSetGetRegisterSet (size_t reg_set) override
bool ReadRegister (const RegisterInfo *reg_info, RegisterValue &value) override
bool WriteRegister (const RegisterInfo *reg_info, const RegisterValue &value) override
bool ReadAllRegisterValues (lldb::WritableDataBufferSP &data_sp) override
bool WriteAllRegisterValues (const lldb::DataBufferSP &data_sp) override
bool ReadAllRegisterValues (RegisterCheckpoint &reg_checkpoint) override
bool WriteAllRegisterValues (const RegisterCheckpoint &reg_checkpoint) override
uint32_t ConvertRegisterKindToRegisterNumber (lldb::RegisterKind kind, uint32_t num) override
 Convert from a given register numbering scheme to the lldb register numbering scheme.
bool RegisterWriteCausesReconfigure (const llvm::StringRef name) override
bool ReconfigureRegisterInfo () override
Public Member Functions inherited from lldb_private::RegisterContext
 RegisterContext (Thread &thread, uint32_t concrete_frame_idx)
 ~RegisterContext () override
void InvalidateIfNeeded (bool force)
virtual lldb::ByteOrder GetByteOrder ()
bool CopyFromRegisterContext (lldb::RegisterContextSP context)
virtual uint32_t NumSupportedHardwareBreakpoints ()
virtual uint32_t SetHardwareBreakpoint (lldb::addr_t addr, size_t size)
virtual bool ClearHardwareBreakpoint (uint32_t hw_idx)
virtual uint32_t NumSupportedHardwareWatchpoints ()
virtual uint32_t SetHardwareWatchpoint (lldb::addr_t addr, size_t size, bool read, bool write)
virtual bool ClearHardwareWatchpoint (uint32_t hw_index)
virtual bool HardwareSingleStep (bool enable)
virtual Status ReadRegisterValueFromMemory (const lldb_private::RegisterInfo *reg_info, lldb::addr_t src_addr, uint32_t src_len, RegisterValue &reg_value)
virtual Status WriteRegisterValueToMemory (const lldb_private::RegisterInfo *reg_info, lldb::addr_t dst_addr, uint32_t dst_len, const RegisterValue &reg_value)
virtual lldb::tid_t GetThreadID () const
virtual ThreadGetThread ()
const RegisterInfoGetRegisterInfoByName (llvm::StringRef reg_name, uint32_t start_idx=0)
const RegisterInfoGetRegisterInfo (lldb::RegisterKind reg_kind, uint32_t reg_num)
uint64_t GetPC (uint64_t fail_value=LLDB_INVALID_ADDRESS)
uint64_t GetThreadPointer (uint64_t fail_value=LLDB_INVALID_ADDRESS)
bool GetPCForSymbolication (Address &address)
 Get an address suitable for symbolication.
bool SetPC (uint64_t pc)
bool SetPC (Address addr)
uint64_t GetSP (uint64_t fail_value=LLDB_INVALID_ADDRESS)
bool SetSP (uint64_t sp)
uint64_t GetFP (uint64_t fail_value=LLDB_INVALID_ADDRESS)
bool SetFP (uint64_t fp)
const char * GetRegisterName (uint32_t reg)
uint64_t GetReturnAddress (uint64_t fail_value=LLDB_INVALID_ADDRESS)
uint64_t GetFlags (uint64_t fail_value=0)
uint64_t ReadRegisterAsUnsigned (uint32_t reg, uint64_t fail_value)
uint64_t ReadRegisterAsUnsigned (const RegisterInfo *reg_info, uint64_t fail_value)
bool WriteRegisterFromUnsigned (uint32_t reg, uint64_t uval)
bool WriteRegisterFromUnsigned (const RegisterInfo *reg_info, uint64_t uval)
bool ConvertBetweenRegisterKinds (lldb::RegisterKind source_rk, uint32_t source_regnum, lldb::RegisterKind target_rk, uint32_t &target_regnum)
lldb::TargetSP CalculateTarget () override
lldb::ProcessSP CalculateProcess () override
lldb::ThreadSP CalculateThread () override
lldb::StackFrameSP CalculateStackFrame () override
void CalculateExecutionContext (ExecutionContext &exe_ctx) override
 Reconstruct the object's execution context into sc.
uint32_t GetStopID () const
void SetStopID (uint32_t stop_id)
Public Member Functions inherited from lldb_private::ExecutionContextScope
virtual ~ExecutionContextScope ()=default

Protected Member Functions

bool ReadRegisterBytes (const RegisterInfo *reg_info)
bool WriteRegisterBytes (const RegisterInfo *reg_info, DataExtractor &data, uint32_t data_offset)
bool PrivateSetRegisterValue (uint32_t reg, llvm::ArrayRef< uint8_t > data)
bool PrivateSetRegisterValue (uint32_t reg, uint64_t val)
void SetAllRegisterValid (bool b)
bool GetRegisterIsValid (uint32_t reg) const
void SetRegisterIsValid (const RegisterInfo *reg_info, bool valid)
void SetRegisterIsValid (uint32_t reg, bool valid)
Protected Member Functions inherited from lldb_private::RegisterContext
virtual bool BehavesLikeZerothFrame () const
 Indicates that this frame is currently executing code, that the PC value is not a return-pc but an actual executing instruction.

Protected Attributes

GDBRemoteDynamicRegisterInfoSP m_reg_info_sp
std::vector< boolm_reg_valid
DataExtractor m_reg_data
bool m_read_all_at_once
bool m_write_all_at_once
bool m_gpacket_cached
Protected Attributes inherited from lldb_private::RegisterContext
Threadm_thread
uint32_t m_concrete_frame_idx
uint32_t m_stop_id

Private Member Functions

bool GetPrimordialRegister (const RegisterInfo *reg_info, GDBRemoteCommunicationClient &gdb_comm)
bool SetPrimordialRegister (const RegisterInfo *reg_info, GDBRemoteCommunicationClient &gdb_comm)
 GDBRemoteRegisterContext (const GDBRemoteRegisterContext &)=delete
const GDBRemoteRegisterContextoperator= (const GDBRemoteRegisterContext &)=delete

Friends

class ThreadGDBRemote

Detailed Description

Definition at line 45 of file GDBRemoteRegisterContext.h.

Constructor & Destructor Documentation

◆ GDBRemoteRegisterContext() [1/2]

◆ ~GDBRemoteRegisterContext()

GDBRemoteRegisterContext::~GDBRemoteRegisterContext ( )
overridedefault

◆ GDBRemoteRegisterContext() [2/2]

lldb_private::process_gdb_remote::GDBRemoteRegisterContext::GDBRemoteRegisterContext ( const GDBRemoteRegisterContext & )
privatedelete

Member Function Documentation

◆ ConvertRegisterKindToRegisterNumber()

uint32_t GDBRemoteRegisterContext::ConvertRegisterKindToRegisterNumber ( lldb::RegisterKind kind,
uint32_t num )
overridevirtual

Convert from a given register numbering scheme to the lldb register numbering scheme.

There may be multiple ways to enumerate the registers for a given architecture. ABI references will specify one to be used with DWARF, the register numberings from process plugin, there may be a variation used for eh_frame unwind instructions (e.g. on Darwin), and so on. Register 5 by itself is meaningless - RegisterKind enumeration tells you what context that number should be translated as.

Inside lldb, register numbers are in the eRegisterKindLLDB scheme; arguments which take a register number should take one in that scheme.

eRegisterKindGeneric is a special numbering scheme which gives us constant values for the pc, frame register, stack register, etc., for use within lldb. They may not be defined for all architectures but it allows generic code to translate these common registers into the lldb numbering scheme.

This method translates a given register kind + register number into the eRegisterKindLLDB register numbering.

Parameters
[in]kindThe register numbering scheme (RegisterKind) that the following register number is in.
[in]numA register number in the 'kind' register numbering scheme.
Returns
The equivalent register number in the eRegisterKindLLDB numbering scheme, if possible, else LLDB_INVALID_REGNUM.

Reimplemented from lldb_private::RegisterContext.

Reimplemented in lldb_private::wasm::RegisterContextWasm.

Definition at line 756 of file GDBRemoteRegisterContext.cpp.

References m_reg_info_sp.

Referenced by WriteRegisterBytes().

◆ GetPrimordialRegister()

◆ GetRegisterCount()

size_t GDBRemoteRegisterContext::GetRegisterCount ( )
overridevirtual

Implements lldb_private::RegisterContext.

Reimplemented in lldb_private::wasm::RegisterContextWasm.

Definition at line 67 of file GDBRemoteRegisterContext.cpp.

References m_reg_info_sp.

◆ GetRegisterInfoAtIndex()

const RegisterInfo * GDBRemoteRegisterContext::GetRegisterInfoAtIndex ( size_t reg)
overridevirtual

◆ GetRegisterIsValid()

bool lldb_private::process_gdb_remote::GDBRemoteRegisterContext::GetRegisterIsValid ( uint32_t reg) const
inlineprotected

Definition at line 99 of file GDBRemoteRegisterContext.h.

References m_reg_valid.

Referenced by ReadRegisterBytes().

◆ GetRegisterSet()

const RegisterSet * GDBRemoteRegisterContext::GetRegisterSet ( size_t reg_set)
overridevirtual

Implements lldb_private::RegisterContext.

Reimplemented in lldb_private::wasm::RegisterContextWasm.

Definition at line 80 of file GDBRemoteRegisterContext.cpp.

References m_reg_info_sp.

◆ GetRegisterSetCount()

size_t GDBRemoteRegisterContext::GetRegisterSetCount ( )
overridevirtual

Implements lldb_private::RegisterContext.

Reimplemented in lldb_private::wasm::RegisterContextWasm.

Definition at line 76 of file GDBRemoteRegisterContext.cpp.

References m_reg_info_sp.

◆ InvalidateAllRegisters()

void GDBRemoteRegisterContext::InvalidateAllRegisters ( )
overridevirtual

◆ operator=()

const GDBRemoteRegisterContext & lldb_private::process_gdb_remote::GDBRemoteRegisterContext::operator= ( const GDBRemoteRegisterContext & )
privatedelete

◆ PrivateSetRegisterValue() [1/2]

◆ PrivateSetRegisterValue() [2/2]

◆ ReadAllRegisterValues() [1/2]

◆ ReadAllRegisterValues() [2/2]

◆ ReadRegister()

◆ ReadRegisterBytes()

◆ ReconfigureRegisterInfo()

◆ RegisterWriteCausesReconfigure()

◆ SetAllRegisterValid()

void GDBRemoteRegisterContext::SetAllRegisterValid ( bool b)
protected

Definition at line 60 of file GDBRemoteRegisterContext.cpp.

References m_gpacket_cached, and m_reg_valid.

Referenced by InvalidateAllRegisters(), and ReadRegisterBytes().

◆ SetPrimordialRegister()

◆ SetRegisterIsValid() [1/2]

void lldb_private::process_gdb_remote::GDBRemoteRegisterContext::SetRegisterIsValid ( const RegisterInfo * reg_info,
bool valid )
inlineprotected

◆ SetRegisterIsValid() [2/2]

void lldb_private::process_gdb_remote::GDBRemoteRegisterContext::SetRegisterIsValid ( uint32_t reg,
bool valid )
inlineprotected

Definition at line 112 of file GDBRemoteRegisterContext.h.

References m_reg_valid.

◆ WriteAllRegisterValues() [1/2]

◆ WriteAllRegisterValues() [2/2]

◆ WriteRegister()

◆ WriteRegisterBytes()

◆ ThreadGDBRemote

Member Data Documentation

◆ m_gpacket_cached

bool lldb_private::process_gdb_remote::GDBRemoteRegisterContext::m_gpacket_cached
protected

◆ m_read_all_at_once

bool lldb_private::process_gdb_remote::GDBRemoteRegisterContext::m_read_all_at_once
protected

Definition at line 121 of file GDBRemoteRegisterContext.h.

Referenced by GDBRemoteRegisterContext(), and ReadRegisterBytes().

◆ m_reg_data

◆ m_reg_info_sp

◆ m_reg_valid

std::vector<bool> lldb_private::process_gdb_remote::GDBRemoteRegisterContext::m_reg_valid
protected

◆ m_write_all_at_once

bool lldb_private::process_gdb_remote::GDBRemoteRegisterContext::m_write_all_at_once
protected

Definition at line 122 of file GDBRemoteRegisterContext.h.

Referenced by GDBRemoteRegisterContext(), and WriteRegisterBytes().


The documentation for this class was generated from the following files: