"lldb/Expression/ExternalSymbolResolver.h" Finds the load addresses of symbols that an expression refers to but does not define. More...

#include <ExternalSymbolResolver.h>

Public Member Functions
	ExternalSymbolResolver (const SymbolContext &sym_ctx, bool strip_underscore)
	Constructor.
void	AppendPreferredSymbolContexts (SymbolContextList const &contexts)
	Search the modules of `contexts` before any others, except for the module of the symbol context this resolver was constructed with.
lldb::addr_t	FindSymbol (ConstString name, bool &missing_weak)
	Find the load address of `name`.

Private Member Functions
void	CollectCandidateCNames (std::vector< ConstString > &C_names, ConstString name)
void	CollectCandidateCPlusPlusNames (std::vector< ConstString > &CPP_names, const std::vector< ConstString > &C_names, const SymbolContext &sc)
lldb::addr_t	FindInSymbols (const std::vector< ConstString > &names, const lldb_private::SymbolContext &sc, bool &symbol_was_missing_weak)
lldb::addr_t	FindInRuntimes (const std::vector< ConstString > &names, const lldb_private::SymbolContext &sc)
lldb::addr_t	FindInUserDefinedSymbols (const std::vector< ConstString > &names, const lldb_private::SymbolContext &sc)

Private Attributes
SymbolContext	m_sym_ctx
	Used for symbol lookups.
bool	m_strip_underscore
	True for platforms where global symbols have a _ prefix.
ModuleList	m_preferred_modules
	Any Module in this list will be used for symbol/function lookup before any other module (except for the module corresponding to the current frame).

Detailed Description

"lldb/Expression/ExternalSymbolResolver.h" Finds the load addresses of symbols that an expression refers to but does not define.

An expression's IR refers by name to functions and variables that live outside the expression's own module. Finding the address for such a name is not a simple lookup: the name may be an LLDB function call label, it may need alternate manglings tried, and it may be satisfied by the target's images, by a language runtime, or by a symbol that a previous expression defined (see Target::GetPersistentSymbol).

Definition at line 31 of file ExternalSymbolResolver.h.

Constructor & Destructor Documentation

◆ ExternalSymbolResolver()

ExternalSymbolResolver::ExternalSymbolResolver	(	const SymbolContext &	sym_ctx,
		bool	strip_underscore )

Constructor.

Parameters

[in]	sym_ctx	The symbol context to search from. Its module, if any, is searched before all others.
[in]	strip_underscore	True for platforms where global symbols have a _ prefix, in which case the name with that prefix removed is also tried.

Definition at line 28 of file ExternalSymbolResolver.cpp.

References m_preferred_modules, m_strip_underscore, and m_sym_ctx.

Member Function Documentation

◆ AppendPreferredSymbolContexts()

void lldb_private::ExternalSymbolResolver::AppendPreferredSymbolContexts ( SymbolContextList const & contexts )

inline

Search the modules of contexts before any others, except for the module of the symbol context this resolver was constructed with.

Definition at line 46 of file ExternalSymbolResolver.h.

References m_preferred_modules.

◆ CollectCandidateCNames()

void ExternalSymbolResolver::CollectCandidateCNames	(	std::vector< ConstString > &	C_names,
		ConstString	name )

private

Definition at line 33 of file ExternalSymbolResolver.cpp.

References lldb_private::ConstString::GetCString(), lldb_private::ConstString::GetStringRef(), and m_strip_underscore.

Referenced by FindSymbol().

◆ CollectCandidateCPlusPlusNames()

void ExternalSymbolResolver::CollectCandidateCPlusPlusNames	(	std::vector< ConstString > &	CPP_names,
		const std::vector< ConstString > &	C_names,
		const SymbolContext &	sc )

private

Definition at line 40 of file ExternalSymbolResolver.cpp.

References lldb::eLanguageTypeC_plus_plus, and lldb_private::Language::FindPlugin().

Referenced by FindSymbol().

◆ FindInRuntimes()

lldb::addr_t ExternalSymbolResolver::FindInRuntimes	(	const std::vector< ConstString > &	names,
		const lldb_private::SymbolContext &	sc )

private

Definition at line 280 of file ExternalSymbolResolver.cpp.

References LLDB_INVALID_ADDRESS, and lldb_private::SymbolContext::target_sp.

Referenced by FindSymbol().

◆ FindInSymbols()

lldb::addr_t ExternalSymbolResolver::FindInSymbols	(	const std::vector< ConstString > &	names,
		const lldb_private::SymbolContext &	sc,
		bool &	symbol_was_missing_weak )