#include <RegisterContextWindows.h>

Inheritance diagram for lldb_private::RegisterContextWindows:

[legend]

Public Member Functions
	RegisterContextWindows (Thread &thread, uint32_t concrete_frame_idx)

virtual	~RegisterContextWindows ()

void	InvalidateAllRegisters () override

bool	ReadAllRegisterValues (lldb::WritableDataBufferSP &data_sp) override

bool	WriteAllRegisterValues (const lldb::DataBufferSP &data_sp) 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	HardwareSingleStep (bool enable) override

bool	AddHardwareBreakpoint (uint32_t slot, lldb::addr_t address, uint32_t size, bool read, bool write)

bool	RemoveHardwareBreakpoint (uint32_t slot)

uint32_t	GetTriggeredHardwareBreakpointSlotId ()

Public Member Functions inherited from lldb_private::RegisterContext
	RegisterContext (Thread &thread, uint32_t concrete_frame_idx)

	~RegisterContext () override

void	InvalidateIfNeeded (bool force)

virtual void	InvalidateAllRegisters ()=0

virtual size_t	GetRegisterCount ()=0

virtual const RegisterInfo *	GetRegisterInfoAtIndex (size_t reg)=0

virtual size_t	GetRegisterSetCount ()=0

virtual const RegisterSet *	GetRegisterSet (size_t reg_set)=0

virtual lldb::ByteOrder	GetByteOrder ()

virtual bool	ReadRegister (const RegisterInfo *reg_info, RegisterValue &reg_value)=0

virtual bool	WriteRegister (const RegisterInfo *reg_info, const RegisterValue &reg_value)=0

virtual bool	ReadAllRegisterValues (lldb::WritableDataBufferSP &data_sp)

virtual bool	WriteAllRegisterValues (const lldb::DataBufferSP &data_sp)

virtual bool	RegisterWriteCausesReconfigure (const llvm::StringRef name)

virtual bool	ReconfigureRegisterInfo ()

virtual bool	ReadAllRegisterValues (lldb_private::RegisterCheckpoint &reg_checkpoint)

virtual bool	WriteAllRegisterValues (const lldb_private::RegisterCheckpoint &reg_checkpoint)

bool	CopyFromRegisterContext (lldb::RegisterContextSP context)

virtual uint32_t	ConvertRegisterKindToRegisterNumber (lldb::RegisterKind kind, uint32_t num)
	Convert from a given register numbering scheme to the lldb register numbering scheme.

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 Thread &	GetThread ()

const RegisterInfo *	GetRegisterInfoByName (llvm::StringRef reg_name, uint32_t start_idx=0)

const RegisterInfo *	GetRegisterInfo (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

virtual lldb::TargetSP	CalculateTarget ()=0

virtual lldb::ProcessSP	CalculateProcess ()=0

virtual lldb::ThreadSP	CalculateThread ()=0

virtual lldb::StackFrameSP	CalculateStackFrame ()=0

virtual void	CalculateExecutionContext (ExecutionContext &exe_ctx)=0
	Reconstruct the object's execution context into sc.

Static Public Member Functions
static constexpr uint32_t	GetNumHardwareBreakpointSlots ()

Protected Member Functions
virtual bool	CacheAllRegisterValues ()

virtual bool	ApplyAllRegisterValues ()

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
CONTEXT	m_context

bool	m_context_stale

Protected Attributes inherited from lldb_private::RegisterContext
Thread &	m_thread

uint32_t	m_concrete_frame_idx

uint32_t	m_stop_id

Static Protected Attributes
static constexpr unsigned	NUM_HARDWARE_BREAKPOINT_SLOTS = 4

Detailed Description

Definition at line 19 of file RegisterContextWindows.h.

Constructor & Destructor Documentation

◆ RegisterContextWindows()

RegisterContextWindows::RegisterContextWindows	(	Thread &	thread,
		uint32_t	concrete_frame_idx
	)

Definition at line 28 of file RegisterContextWindows.cpp.

◆ ~RegisterContextWindows()

RegisterContextWindows::~RegisterContextWindows ( )

virtual

Definition at line 33 of file RegisterContextWindows.cpp.

Member Function Documentation

◆ AddHardwareBreakpoint()

bool RegisterContextWindows::AddHardwareBreakpoint	(	uint32_t	slot,
		lldb::addr_t	address,
		uint32_t	size,
		bool	read,
		bool	write
	)

Definition at line 76 of file RegisterContextWindows.cpp.

References ApplyAllRegisterValues(), CacheAllRegisterValues(), lldb_private::GetLog(), LLDB_LOG, m_context, NUM_HARDWARE_BREAKPOINT_SLOTS, and lldb_private::Registers.

Referenced by lldb_private::ProcessWindows::OnCreateThread().

◆ ApplyAllRegisterValues()

bool RegisterContextWindows::ApplyAllRegisterValues ( )

protectedvirtual

Definition at line 183 of file RegisterContextWindows.cpp.

References lldb_private::TargetThreadWindows::GetHostThread(), lldb_private::HostThread::GetNativeThread(), lldb_private::HostNativeThreadBase::GetSystemHandle(), m_context, and lldb_private::RegisterContext::m_thread.

Referenced by AddHardwareBreakpoint(), RemoveHardwareBreakpoint(), and WriteAllRegisterValues().

◆ CacheAllRegisterValues()

bool RegisterContextWindows::CacheAllRegisterValues ( )

protectedvirtual

Definition at line 151 of file RegisterContextWindows.cpp.

References lldb_private::TargetThreadWindows::GetHostThread(), lldb_private::GetLog(), lldb_private::HostThread::GetNativeThread(), lldb_private::HostNativeThreadBase::GetSystemHandle(), kWinContextFlags, LLDB_LOG, m_context, m_context_stale, lldb_private::RegisterContext::m_thread, and lldb_private::Registers.

Referenced by AddHardwareBreakpoint(), GetTriggeredHardwareBreakpointSlotId(), ReadAllRegisterValues(), and RemoveHardwareBreakpoint().

◆ ConvertRegisterKindToRegisterNumber()

uint32_t RegisterContextWindows::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]	kind	The register numbering scheme (RegisterKind) that the following register number is in.
[in]	num	A register number in the 'kind' register numbering scheme.