#include <UnwindLLDB.h>

Inheritance diagram for lldb_private::UnwindLLDB:

Classes
struct	ConcreteRegisterLocation
	An UnwindPlan::Row::AbstractRegisterLocation, combined with the register context and memory for a specific stop point, is used to create a ConcreteRegisterLocation. More...
struct	Cursor

Public Types
enum	RegisterSearchResult { eRegisterFound = 0 , eRegisterNotFound , eRegisterIsVolatile }

Public Member Functions
	UnwindLLDB (lldb_private::Thread &thread)
	~UnwindLLDB () override=default
Public Member Functions inherited from lldb_private::Unwind
virtual	~Unwind ()=default
void	Clear ()
uint32_t	GetFrameCount ()
uint32_t	GetFramesUpTo (uint32_t end_idx)
bool	GetFrameInfoAtIndex (uint32_t frame_idx, lldb::addr_t &cfa, lldb::addr_t &pc, bool &behaves_like_zeroth_frame)
lldb::RegisterContextSP	CreateRegisterContextForFrame (StackFrame *frame)
Thread &	GetThread ()

Protected Types
typedef std::shared_ptr< RegisterContextUnwind >	RegisterContextLLDBSP

Protected Member Functions
void	DoClear () override
uint32_t	DoGetFrameCount () override
bool	DoGetFrameInfoAtIndex (uint32_t frame_idx, lldb::addr_t &cfa, lldb::addr_t &start_pc, bool &behaves_like_zeroth_frame) override
lldb::RegisterContextSP	DoCreateRegisterContextForFrame (lldb_private::StackFrame *frame) override
RegisterContextLLDBSP	GetRegisterContextForFrameNum (uint32_t frame_num)
bool	SearchForSavedLocationForRegister (uint32_t lldb_regnum, lldb_private::UnwindLLDB::ConcreteRegisterLocation &regloc, uint32_t starting_frame_num, bool pc_register)
const std::vector< ConstString > &	GetUserSpecifiedTrapHandlerFunctionNames ()
	Provide the list of user-specified trap handler functions.
Protected Member Functions inherited from lldb_private::Unwind
	Unwind (Thread &thread)

Private Types
typedef std::shared_ptr< Cursor >	CursorSP

Private Member Functions
void	UpdateUnwindPlanForFirstFrameIfInvalid (ABI *abi)
CursorSP	GetOneMoreFrame (ABI *abi)
bool	AddOneMoreFrame (ABI *abi)
bool	AddFirstFrame ()
	UnwindLLDB (const UnwindLLDB &)=delete
const UnwindLLDB &	operator= (const UnwindLLDB &)=delete

Private Attributes
std::vector< CursorSP >	m_frames
CursorSP	m_candidate_frame
bool	m_unwind_complete
std::vector< ConstString >	m_user_supplied_trap_handler_functions

Friends
class	lldb_private::RegisterContextUnwind
class	lldb_private::ArchitectureArm

Additional Inherited Members
Protected Attributes inherited from lldb_private::Unwind
Thread &	m_thread
std::recursive_mutex	m_unwind_mutex

Detailed Description

Definition at line 27 of file UnwindLLDB.h.

Member Typedef Documentation

◆ CursorSP

typedef std::shared_ptr<Cursor> lldb_private::UnwindLLDB::CursorSP

private

Definition at line 143 of file UnwindLLDB.h.

◆ RegisterContextLLDBSP

typedef std::shared_ptr<RegisterContextUnwind> lldb_private::UnwindLLDB::RegisterContextLLDBSP

protected

Definition at line 95 of file UnwindLLDB.h.

Member Enumeration Documentation

◆ RegisterSearchResult

enum lldb_private::UnwindLLDB::RegisterSearchResult

Enumerator
eRegisterFound
eRegisterNotFound
eRegisterIsVolatile

Definition at line 33 of file UnwindLLDB.h.

Constructor & Destructor Documentation

◆ UnwindLLDB() [1/2]

UnwindLLDB::UnwindLLDB ( lldb_private::Thread & thread )

Definition at line 26 of file UnwindLLDB.cpp.

References lldb_private::Args::GetArgumentAtIndex(), lldb_private::Args::GetArgumentCount(), m_frames, m_unwind_complete, m_user_supplied_trap_handler_functions, and lldb_private::Unwind::Unwind().

Referenced by operator=(), and UnwindLLDB().

◆ ~UnwindLLDB()

lldb_private::UnwindLLDB::~UnwindLLDB ( )

overridedefault

◆ UnwindLLDB() [2/2]

lldb_private::UnwindLLDB::UnwindLLDB ( const UnwindLLDB & )

privatedelete

References UnwindLLDB().

Member Function Documentation

◆ AddFirstFrame()

bool UnwindLLDB::AddFirstFrame ( )

private

Definition at line 71 of file UnwindLLDB.cpp.

References lldb_private::GetLog(), LLDB_LOGF, lldb_private::RegisterContextUnwind, m_frames, lldb_private::Unwind::m_thread, m_unwind_complete, lldb_private::Unwind, and UpdateUnwindPlanForFirstFrameIfInvalid().

Referenced by DoCreateRegisterContextForFrame(), DoGetFrameCount(), and DoGetFrameInfoAtIndex().

◆ AddOneMoreFrame()

bool UnwindLLDB::AddOneMoreFrame ( ABI * abi )

private

Definition at line 323 of file UnwindLLDB.cpp.

References lldb_private::GetLog(), GetOneMoreFrame(), LLDB_LOGF, m_candidate_frame, m_frames, lldb_private::Unwind::m_thread, m_unwind_complete, and lldb_private::Unwind.

Referenced by DoCreateRegisterContextForFrame(), DoGetFrameCount(), DoGetFrameInfoAtIndex(), and UpdateUnwindPlanForFirstFrameIfInvalid().

◆ DoClear()

void lldb_private::UnwindLLDB::DoClear ( )

inlineoverrideprotectedvirtual

Implements lldb_private::Unwind.

Definition at line 80 of file UnwindLLDB.h.

References m_candidate_frame, m_frames, and m_unwind_complete.

◆ DoCreateRegisterContextForFrame()

lldb::RegisterContextSP UnwindLLDB::DoCreateRegisterContextForFrame ( lldb_private::StackFrame * frame )

overrideprotectedvirtual

Implements lldb_private::Unwind.

Definition at line 439 of file UnwindLLDB.cpp.

References AddFirstFrame(), AddOneMoreFrame(), lldb_private::StackFrame::GetConcreteFrameIndex(), m_frames, lldb_private::Unwind::m_thread, and lldb_private::UnwindLLDB::Cursor::reg_ctx_lldb_sp.

◆ DoGetFrameCount()

uint32_t UnwindLLDB::DoGetFrameCount ( )

overrideprotectedvirtual

Implements lldb_private::Unwind.

Definition at line 41 of file UnwindLLDB.cpp.

References AddFirstFrame(), AddOneMoreFrame(), m_frames, lldb_private::Unwind::m_thread, and m_unwind_complete.

◆ DoGetFrameInfoAtIndex()

bool UnwindLLDB::DoGetFrameInfoAtIndex	(	uint32_t	frame_idx,
		lldb::addr_t &	cfa,
		lldb::addr_t &	start_pc,
		bool &	behaves_like_zeroth_frame )

overrideprotectedvirtual

Implements lldb_private::Unwind.

Definition at line 397 of file UnwindLLDB.cpp.

References AddFirstFrame(), AddOneMoreFrame(), m_frames, lldb_private::Unwind::m_thread, and pc.

◆ GetOneMoreFrame()

UnwindLLDB::CursorSP UnwindLLDB::GetOneMoreFrame ( ABI * abi )

private

Definition at line 114 of file UnwindLLDB.cpp.

References lldb_private::ABI::CallFrameAddressIsValid(), lldb_private::ABI::CodeAddressIsValid(), lldb_private::GetLog(), GetOneMoreFrame(), LLDB_LOGF, lldb_private::RegisterContextUnwind, m_frames, lldb_private::Unwind::m_thread, m_unwind_complete, and lldb_private::Unwind.

Referenced by AddOneMoreFrame(), and GetOneMoreFrame().

◆ GetRegisterContextForFrameNum()

UnwindLLDB::RegisterContextLLDBSP UnwindLLDB::GetRegisterContextForFrameNum ( uint32_t frame_num )

protected

Definition at line 469 of file UnwindLLDB.cpp.

References m_frames.

◆ GetUserSpecifiedTrapHandlerFunctionNames()

const std::vector< ConstString > & lldb_private::UnwindLLDB::GetUserSpecifiedTrapHandlerFunctionNames ( )

inlineprotected

Provide the list of user-specified trap handler functions.

The Platform is one source of trap handler function names; that may be augmented via a setting. The setting needs to be converted into an array of ConstStrings before it can be used - we only want to do that once per thread so it's here in the UnwindLLDB object.

Returns: Vector of ConstStrings of trap handler function names. May be empty.

Definition at line 120 of file UnwindLLDB.h.

References m_user_supplied_trap_handler_functions.

◆ operator=()

const UnwindLLDB & lldb_private::UnwindLLDB::operator= ( const UnwindLLDB & )

privatedelete

References UnwindLLDB().

◆ SearchForSavedLocationForRegister()

bool UnwindLLDB::SearchForSavedLocationForRegister	(	uint32_t	lldb_regnum,
		lldb_private::UnwindLLDB::ConcreteRegisterLocation &	regloc,
		uint32_t	starting_frame_num,
		bool	pc_register )

protected

Definition at line 476 of file UnwindLLDB.cpp.

References eRegisterFound, lldb_private::UnwindLLDB::ConcreteRegisterLocation::eRegisterInRegister, eRegisterIsVolatile, eRegisterNotFound, lldb_private::UnwindLLDB::ConcreteRegisterLocation::location, m_frames, lldb_private::UnwindLLDB::ConcreteRegisterLocation::register_number, and lldb_private::UnwindLLDB::ConcreteRegisterLocation::type.

◆ UpdateUnwindPlanForFirstFrameIfInvalid()

void UnwindLLDB::UpdateUnwindPlanForFirstFrameIfInvalid ( ABI * abi )

private

Definition at line 301 of file UnwindLLDB.cpp.

References AddOneMoreFrame(), m_candidate_frame, m_frames, and m_unwind_complete.

Referenced by AddFirstFrame().

◆ lldb_private::ArchitectureArm

friend class lldb_private::ArchitectureArm

friend

Definition at line 41 of file UnwindLLDB.h.

◆ lldb_private::RegisterContextUnwind

friend class lldb_private::RegisterContextUnwind

friend

Definition at line 40 of file UnwindLLDB.h.

Referenced by AddFirstFrame(), and GetOneMoreFrame().

Member Data Documentation

◆ m_candidate_frame

CursorSP lldb_private::UnwindLLDB::m_candidate_frame

private

Definition at line 145 of file UnwindLLDB.h.

Referenced by AddOneMoreFrame(), DoClear(), and UpdateUnwindPlanForFirstFrameIfInvalid().

◆ m_frames

std::vector<CursorSP> lldb_private::UnwindLLDB::m_frames

private

Definition at line 144 of file UnwindLLDB.h.

Referenced by AddFirstFrame(), AddOneMoreFrame(), DoClear(), DoCreateRegisterContextForFrame(), DoGetFrameCount(), DoGetFrameInfoAtIndex(), GetOneMoreFrame(), GetRegisterContextForFrameNum(), SearchForSavedLocationForRegister(), UnwindLLDB(), and UpdateUnwindPlanForFirstFrameIfInvalid().

◆ m_unwind_complete

bool lldb_private::UnwindLLDB::m_unwind_complete

private

Definition at line 146 of file UnwindLLDB.h.

Referenced by AddFirstFrame(), AddOneMoreFrame(), DoClear(), DoGetFrameCount(), GetOneMoreFrame(), UnwindLLDB(), and UpdateUnwindPlanForFirstFrameIfInvalid().

◆ m_user_supplied_trap_handler_functions

std::vector<ConstString> lldb_private::UnwindLLDB::m_user_supplied_trap_handler_functions

private

Definition at line 152 of file UnwindLLDB.h.

Referenced by GetUserSpecifiedTrapHandlerFunctionNames(), and UnwindLLDB().

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

Classes

Public Types

Public Member Functions

Protected Types

Protected Member Functions

Private Types

Private Member Functions

Private Attributes

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ CursorSP

◆ RegisterContextLLDBSP

Member Enumeration Documentation

◆ RegisterSearchResult

Constructor & Destructor Documentation

◆ UnwindLLDB() [1/2]

◆ ~UnwindLLDB()

◆ UnwindLLDB() [2/2]

Member Function Documentation

◆ AddFirstFrame()

◆ AddOneMoreFrame()

◆ DoClear()

◆ DoCreateRegisterContextForFrame()

◆ DoGetFrameCount()

◆ DoGetFrameInfoAtIndex()

◆ GetOneMoreFrame()

◆ GetRegisterContextForFrameNum()

◆ GetUserSpecifiedTrapHandlerFunctionNames()

◆ operator=()

◆ SearchForSavedLocationForRegister()

◆ UpdateUnwindPlanForFirstFrameIfInvalid()

Friends And Related Symbol Documentation

◆ lldb_private::ArchitectureArm

◆ lldb_private::RegisterContextUnwind

Member Data Documentation

◆ m_candidate_frame

◆ m_frames

◆ m_unwind_complete

◆ m_user_supplied_trap_handler_functions