#include <Target.h>

Inheritance diagram for lldb_private::Target:

Classes
class	Arch
struct	DummySignalValues
	Add a signal for the target. More...
class	StopHook
class	StopHookCoded
class	StopHookCommandLine
class	StopHookScripted
class	TargetEventData

Public Types
enum	{ eBroadcastBitBreakpointChanged = (1 << 0) , eBroadcastBitModulesLoaded = (1 << 1) , eBroadcastBitModulesUnloaded = (1 << 2) , eBroadcastBitWatchpointChanged = (1 << 3) , eBroadcastBitSymbolsLoaded = (1 << 4) , eBroadcastBitSymbolsChanged = (1 << 5) , eBroadcastBitNewTargetCreated = (1 << 6) }
	Broadcaster event bits definitions. More...
typedef std::shared_ptr< StopHook >	StopHookSP

Public Member Functions
llvm::StringRef	GetBroadcasterClass () const override
	This needs to be filled in if you are going to register the broadcaster with the broadcaster manager and do broadcaster class matching.
	~Target () override
bool	IsDummyTarget () const
lldb::user_id_t	GetGloballyUniqueID () const
	Get the globally unique ID for this target.
const std::string &	GetLabel () const
llvm::Error	SetLabel (llvm::StringRef label)
	Set a label for a target.
llvm::StringRef	GetTargetSessionName ()
	Get the target session name for this target.
void	SetTargetSessionName (llvm::StringRef target_session_name)
	Set the target session name for this target.
lldb::ModuleSP	GetOrCreateModule (const ModuleSpec &module_spec, bool notify, Status *error_ptr=nullptr)
	Find a binary on the system and return its Module, or return an existing Module that is already in the Target.
std::recursive_mutex &	GetAPIMutex ()
void	DeleteCurrentProcess ()
void	CleanupProcess ()
void	Dump (Stream *s, lldb::DescriptionLevel description_level)
	Dump a description of this object to a Stream.
const lldb::ProcessSP &	CreateProcess (lldb::ListenerSP listener_sp, llvm::StringRef plugin_name, const FileSpec *crash_file, bool can_connect)
const lldb::ProcessSP &	GetProcessSP () const
bool	IsValid ()
void	Destroy ()
Status	Launch (ProcessLaunchInfo &launch_info, Stream *stream)
Status	Attach (ProcessAttachInfo &attach_info, Stream *stream)
llvm::Expected< uint32_t >	AddScriptedFrameProviderDescriptor (const ScriptedFrameProviderDescriptor &descriptor)
	Add or update a scripted frame provider descriptor for this target.
bool	RemoveScriptedFrameProviderDescriptor (uint32_t id)
	Remove a scripted frame provider descriptor by id.
void	ClearScriptedFrameProviderDescriptors ()
	Clear all scripted frame provider descriptors for this target.
const llvm::DenseMap< uint32_t, ScriptedFrameProviderDescriptor > &	GetScriptedFrameProviderDescriptors () const
	Get all scripted frame provider descriptors for this target.
BreakpointList &	GetBreakpointList (bool internal=false)
const BreakpointList &	GetBreakpointList (bool internal=false) const
lldb::BreakpointSP	GetLastCreatedBreakpoint ()
lldb::BreakpointSP	GetBreakpointByID (lldb::break_id_t break_id)
lldb::BreakpointSP	CreateBreakpointAtUserEntry (Status &error)
lldb::BreakpointSP	CreateBreakpoint (const FileSpecList *containingModules, const FileSpec &file, uint32_t line_no, uint32_t column, lldb::addr_t offset, LazyBool check_inlines, LazyBool skip_prologue, bool internal, bool request_hardware, LazyBool move_to_nearest_code)
lldb::BreakpointSP	CreateSourceRegexBreakpoint (const FileSpecList containingModules, const FileSpecList source_file_list, const std::unordered_set< std::string > &function_names, RegularExpression source_regex, bool internal, bool request_hardware, LazyBool move_to_nearest_code)
lldb::BreakpointSP	CreateBreakpoint (lldb::addr_t load_addr, bool internal, bool request_hardware)
lldb::BreakpointSP	CreateAddressInModuleBreakpoint (lldb::addr_t file_addr, bool internal, const FileSpec &file_spec, bool request_hardware)
lldb::BreakpointSP	CreateBreakpoint (const Address &addr, bool internal, bool request_hardware)
lldb::BreakpointSP	CreateFuncRegexBreakpoint (const FileSpecList containingModules, const FileSpecList containingSourceFiles, RegularExpression func_regexp, lldb::LanguageType requested_language, LazyBool skip_prologue, bool internal, bool request_hardware)
lldb::BreakpointSP	CreateBreakpoint (const FileSpecList containingModules, const FileSpecList containingSourceFiles, const char *func_name, lldb::FunctionNameType func_name_type_mask, lldb::LanguageType language, lldb::addr_t offset, bool offset_is_insn_count, LazyBool skip_prologue, bool internal, bool request_hardware)
lldb::BreakpointSP	CreateExceptionBreakpoint (enum lldb::LanguageType language, bool catch_bp, bool throw_bp, bool internal, Args additional_args=nullptr, Status additional_args_error=nullptr)
lldb::BreakpointSP	CreateScriptedBreakpoint (const llvm::StringRef class_name, const FileSpecList containingModules, const FileSpecList containingSourceFiles, bool internal, bool request_hardware, StructuredData::ObjectSP extra_args_sp, Status *creation_error=nullptr)
lldb::BreakpointSP	CreateBreakpoint (const FileSpecList containingModules, const FileSpecList containingSourceFiles, const char *func_names[], size_t num_names, lldb::FunctionNameType func_name_type_mask, lldb::LanguageType language, lldb::addr_t offset, LazyBool skip_prologue, bool internal, bool request_hardware)
lldb::BreakpointSP	CreateBreakpoint (const FileSpecList containingModules, const FileSpecList containingSourceFiles, const std::vector< std::string > &func_names, lldb::FunctionNameType func_name_type_mask, lldb::LanguageType language, lldb::addr_t m_offset, LazyBool skip_prologue, bool internal, bool request_hardware)
lldb::BreakpointSP	CreateBreakpoint (lldb::SearchFilterSP &filter_sp, lldb::BreakpointResolverSP &resolver_sp, bool internal, bool request_hardware, bool resolve_indirect_symbols)
lldb::WatchpointSP	CreateWatchpoint (lldb::addr_t addr, size_t size, const CompilerType *type, uint32_t kind, Status &error)
lldb::WatchpointSP	GetLastCreatedWatchpoint ()
WatchpointList &	GetWatchpointList ()
void	AddNameToBreakpoint (BreakpointID &id, llvm::StringRef name, Status &error)
void	AddNameToBreakpoint (lldb::BreakpointSP &bp_sp, llvm::StringRef name, Status &error)
void	RemoveNameFromBreakpoint (lldb::BreakpointSP &bp_sp, ConstString name)
BreakpointName *	FindBreakpointName (ConstString name, bool can_create, Status &error)
void	DeleteBreakpointName (ConstString name)
void	ConfigureBreakpointName (BreakpointName &bp_name, const BreakpointOptions &options, const BreakpointName::Permissions &permissions)
void	ApplyNameToBreakpoints (BreakpointName &bp_name)
void	AddBreakpointName (std::unique_ptr< BreakpointName > bp_name)
void	GetBreakpointNames (std::vector< std::string > &names)
void	RemoveAllBreakpoints (bool internal_also=false)
void	RemoveAllowedBreakpoints ()
void	DisableAllBreakpoints (bool internal_also=false)
void	DisableAllowedBreakpoints ()
void	EnableAllBreakpoints (bool internal_also=false)
void	EnableAllowedBreakpoints ()
bool	DisableBreakpointByID (lldb::break_id_t break_id)
bool	EnableBreakpointByID (lldb::break_id_t break_id)
bool	RemoveBreakpointByID (lldb::break_id_t break_id)
void	ResetBreakpointHitCounts ()
	Resets the hit count of all breakpoints.
bool	RemoveAllWatchpoints (bool end_to_end=true)
bool	DisableAllWatchpoints (bool end_to_end=true)
bool	EnableAllWatchpoints (bool end_to_end=true)
bool	ClearAllWatchpointHitCounts ()
bool	ClearAllWatchpointHistoricValues ()
bool	IgnoreAllWatchpoints (uint32_t ignore_count)
bool	DisableWatchpointByID (lldb::watch_id_t watch_id)
bool	EnableWatchpointByID (lldb::watch_id_t watch_id)
bool	RemoveWatchpointByID (lldb::watch_id_t watch_id)
bool	IgnoreWatchpointByID (lldb::watch_id_t watch_id, uint32_t ignore_count)
Status	SerializeBreakpointsToFile (const FileSpec &file, const BreakpointIDList &bp_ids, bool append)
Status	CreateBreakpointsFromFile (const FileSpec &file, BreakpointIDList &new_bps)
Status	CreateBreakpointsFromFile (const FileSpec &file, std::vector< std::string > &names, BreakpointIDList &new_bps)
lldb::addr_t	GetCallableLoadAddress (lldb::addr_t load_addr, AddressClass addr_class=AddressClass::eInvalid) const
	Get load_addr as a callable code load address for this target.
lldb::addr_t	GetOpcodeLoadAddress (lldb::addr_t load_addr, AddressClass addr_class=AddressClass::eInvalid) const
	Get load_addr as an opcode for this target.
lldb::addr_t	GetBreakableLoadAddress (lldb::addr_t addr)
void	ModulesDidLoad (ModuleList &module_list)
	This call may preload module symbols, and may do so in parallel depending on the following target settings:
void	ModulesDidUnload (ModuleList &module_list, bool delete_locations)
void	SymbolsDidLoad (ModuleList &module_list)
void	ClearModules (bool delete_locations)
void	DidExec ()
	Called as the last function in Process::DidExec().
lldb::ModuleSP	GetExecutableModule ()
	Gets the module for the main executable.
Module *	GetExecutableModulePointer ()
void	SetExecutableModule (lldb::ModuleSP &module_sp, LoadDependentFiles load_dependent_files=eLoadDependentsDefault)
	Set the main executable module.
bool	LoadScriptingResources (std::list< Status > &errors, Stream &feedback_stream, bool continue_on_error=true)
const ModuleList &	GetImages () const
	Get accessor for the images for this process.
ModuleList &	GetImages ()
bool	ModuleIsExcludedForUnconstrainedSearches (const FileSpec &module_spec)
	Return whether this FileSpec corresponds to a module that should be considered for general searches.
bool	ModuleIsExcludedForUnconstrainedSearches (const lldb::ModuleSP &module_sp)
	Return whether this module should be considered for general searches.
const ArchSpec &	GetArchitecture () const
llvm::StringRef	GetABIName () const
	Returns the name of the target's ABI plugin.
bool	SetArchitecture (const ArchSpec &arch_spec, bool set_platform=false, bool merge=true)
	Set the architecture for this target.
bool	MergeArchitecture (const ArchSpec &arch_spec)
Architecture *	GetArchitecturePlugin () const
Debugger &	GetDebugger () const
size_t	ReadMemoryFromFileCache (const Address &addr, void *dst, size_t dst_len, Status &error)
virtual size_t	ReadMemory (const Address &addr, void dst, size_t dst_len, Status &error, bool force_live_memory=false, lldb::addr_t load_addr_ptr=nullptr, bool *did_read_live_memory=nullptr)
size_t	ReadCStringFromMemory (const Address &addr, std::string &out_str, Status &error, bool force_live_memory=false)
size_t	ReadCStringFromMemory (const Address &addr, char *dst, size_t dst_max_len, Status &result_error, bool force_live_memory=false)
size_t	ReadStringFromMemory (const Address &addr, char *dst, size_t max_bytes, Status &error, size_t type_width, bool force_live_memory=true)
	Read a NULL terminated string from memory.
size_t	ReadScalarIntegerFromMemory (const Address &addr, uint32_t byte_size, bool is_signed, Scalar &scalar, Status &error, bool force_live_memory=false)
int64_t	ReadSignedIntegerFromMemory (const Address &addr, size_t integer_byte_size, int64_t fail_value, Status &error, bool force_live_memory=false)
uint64_t	ReadUnsignedIntegerFromMemory (const Address &addr, size_t integer_byte_size, uint64_t fail_value, Status &error, bool force_live_memory=false)
bool	ReadPointerFromMemory (const Address &addr, Status &error, Address &pointer_addr, bool force_live_memory=false)
bool	HasLoadedSections ()
lldb::addr_t	GetSectionLoadAddress (const lldb::SectionSP &section_sp)
void	ClearSectionLoadList ()
void	DumpSectionLoadList (Stream &s)
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.
PathMappingList &	GetImageSearchPathList ()
llvm::Expected< lldb::TypeSystemSP >	GetScratchTypeSystemForLanguage (lldb::LanguageType language, bool create_on_demand=true)
std::vector< lldb::TypeSystemSP >	GetScratchTypeSystems (bool create_on_demand=true)
PersistentExpressionState *	GetPersistentExpressionStateForLanguage (lldb::LanguageType language)
UserExpression *	GetUserExpressionForLanguage (llvm::StringRef expr, llvm::StringRef prefix, SourceLanguage language, Expression::ResultType desired_type, const EvaluateExpressionOptions &options, ValueObject *ctx_obj, Status &error)
FunctionCaller *	GetFunctionCallerForLanguage (lldb::LanguageType language, const CompilerType &return_type, const Address &function_address, const ValueList &arg_value_list, const char *name, Status &error)
llvm::Expected< std::unique_ptr< UtilityFunction > >	CreateUtilityFunction (std::string expression, std::string name, lldb::LanguageType language, ExecutionContext &exe_ctx)
	Creates and installs a UtilityFunction for the given language.
Status	Install (ProcessLaunchInfo *launch_info)
bool	ResolveFileAddress (lldb::addr_t load_addr, Address &so_addr)
bool	ResolveLoadAddress (lldb::addr_t load_addr, Address &so_addr, uint32_t stop_id=SectionLoadHistory::eStopIDNow, bool allow_section_end=false)
bool	SetSectionLoadAddress (const lldb::SectionSP &section, lldb::addr_t load_addr, bool warn_multiple=false)
size_t	UnloadModuleSections (const lldb::ModuleSP &module_sp)
size_t	UnloadModuleSections (const ModuleList &module_list)
bool	SetSectionUnloaded (const lldb::SectionSP &section_sp)
bool	SetSectionUnloaded (const lldb::SectionSP &section_sp, lldb::addr_t load_addr)
void	ClearAllLoadedSections ()
lldb_private::SummaryStatisticsSP	GetSummaryStatisticsSPForProviderName (lldb_private::TypeSummaryImpl &summary_provider)
lldb_private::SummaryStatisticsCache &	GetSummaryStatisticsCache ()
void	SetTrace (const lldb::TraceSP &trace_sp)
	Set the Trace object containing processor trace information of this target.
lldb::TraceSP	GetTrace ()
	Get the Trace object containing processor trace information of this target.
llvm::Expected< lldb::TraceSP >	CreateTrace ()
	Create a Trace object for the current target using the using the default supported tracing technology for this process.
llvm::Expected< lldb::TraceSP >	GetTraceOrCreate ()
	If a Trace object is present, this returns it, otherwise a new Trace is created with Trace::CreateTrace.
lldb::ExpressionResults	EvaluateExpression (llvm::StringRef expression, ExecutionContextScope exe_scope, lldb::ValueObjectSP &result_valobj_sp, const EvaluateExpressionOptions &options=EvaluateExpressionOptions(), std::string fixed_expression=nullptr, ValueObject *ctx_obj=nullptr)
lldb::ExpressionVariableSP	GetPersistentVariable (ConstString name)
lldb::addr_t	GetPersistentSymbol (ConstString name)
llvm::Expected< lldb_private::Address >	GetEntryPointAddress ()
	This method will return the address of the starting function for this binary, e.g.
CompilerType	GetRegisterType (const std::string &name, const lldb_private::RegisterFlags &flags, uint32_t byte_size)
void	NotifyBreakpointChanged (Breakpoint &bp, lldb::BreakpointEventType event_kind)
	Sends a breakpoint notification event.
void	NotifyBreakpointChanged (Breakpoint &bp, const lldb::EventDataSP &breakpoint_data_sp)
	Sends a breakpoint notification event.
llvm::Expected< lldb::DisassemblerSP >	ReadInstructions (const Address &start_addr, uint32_t count, const char *flavor_string=nullptr)
void	RegisterInternalStopHooks ()
StopHookSP	CreateStopHook (StopHook::StopHookKind kind, bool internal=false)
	Add an empty stop hook to the Target's stop hook list, and returns a shared pointer to the new hook.
void	UndoCreateStopHook (lldb::user_id_t uid)
	If you tried to create a stop hook, and that failed, call this to remove the stop hook, as it will also reset the stop hook counter.
bool	RunStopHooks (bool at_initial_stop=false)
bool	SetSuppresStopHooks (bool suppress)
bool	GetSuppressStopHooks ()
bool	RemoveStopHookByID (lldb::user_id_t uid)
void	RemoveAllStopHooks ()
StopHookSP	GetStopHookByID (lldb::user_id_t uid)
bool	SetStopHookActiveStateByID (lldb::user_id_t uid, bool active_state)
void	SetAllStopHooksActiveState (bool active_state)
const std::vector< StopHookSP >	GetStopHooks (bool internal=false) const
lldb::PlatformSP	GetPlatform ()
void	SetPlatform (const lldb::PlatformSP &platform_sp)
SourceManager &	GetSourceManager ()
lldb::SearchFilterSP	GetSearchFilterForModule (const FileSpec *containingModule)
lldb::SearchFilterSP	GetSearchFilterForModuleList (const FileSpecList *containingModuleList)
lldb::SearchFilterSP	GetSearchFilterForModuleAndCUList (const FileSpecList containingModules, const FileSpecList containingSourceFiles)
lldb::REPLSP	GetREPL (Status &err, lldb::LanguageType language, const char *repl_options, bool can_create)
void	SetREPL (lldb::LanguageType language, lldb::REPLSP repl_sp)
StackFrameRecognizerManager &	GetFrameRecognizerManager ()
void	SaveScriptedLaunchInfo (lldb_private::ProcessInfo &process_info)
void	AddDummySignal (llvm::StringRef name, LazyBool pass, LazyBool print, LazyBool stop)
	Add a signal to the Target's list of stored signals/actions.
void	UpdateSignalsFromDummy (lldb::UnixSignalsSP signals_sp, lldb::StreamSP warning_stream_sp)
	Updates the signals in signals_sp using the stored dummy signals.
void	ClearDummySignals (Args &signal_names)
	Clear the dummy signals in signal_names from the target, or all signals if signal_names is empty.
void	PrintDummySignals (Stream &strm, Args &signals)
	Print all the signals set in this target.
llvm::json::Value	ReportStatistics (const lldb_private::StatisticsOptions &options)
	Get metrics associated with this target in JSON format.
void	ResetStatistics ()
TargetStats &	GetStatistics ()
Public Member Functions inherited from lldb_private::TargetProperties
	TargetProperties (Target *target)
	~TargetProperties () override
ArchSpec	GetDefaultArchitecture () const
void	SetDefaultArchitecture (const ArchSpec &arch)
bool	GetMoveToNearestCode () const
lldb::DynamicValueType	GetPreferDynamicValue () const
bool	SetPreferDynamicValue (lldb::DynamicValueType d)
bool	GetPreloadSymbols () const
void	SetPreloadSymbols (bool b)
bool	GetDisableASLR () const
void	SetDisableASLR (bool b)
bool	GetInheritTCC () const
void	SetInheritTCC (bool b)
bool	GetDetachOnError () const
void	SetDetachOnError (bool b)
bool	GetDisableSTDIO () const
void	SetDisableSTDIO (bool b)
llvm::StringRef	GetLaunchWorkingDirectory () const
bool	GetParallelModuleLoad () const
const char *	GetDisassemblyFlavor () const
const char *	GetDisassemblyCPU () const
const char *	GetDisassemblyFeatures () const
InlineStrategy	GetInlineStrategy () const
RealpathPrefixes	GetSourceRealpathPrefixes () const
llvm::StringRef	GetArg0 () const
void	SetArg0 (llvm::StringRef arg)
bool	GetRunArguments (Args &args) const
void	SetRunArguments (const Args &args)
Environment	GetEnvironment () const
Environment	GetInheritedEnvironment () const
Environment	GetTargetEnvironment () const
void	SetEnvironment (Environment env)
bool	GetSkipPrologue () const
PathMappingList &	GetSourcePathMap () const
PathMappingList &	GetObjectPathMap () const
bool	GetAutoSourceMapRelative () const
FileSpecList	GetExecutableSearchPaths ()
void	AppendExecutableSearchPaths (const FileSpec &)
FileSpecList	GetDebugFileSearchPaths ()
FileSpecList	GetClangModuleSearchPaths ()
bool	GetEnableAutoImportClangModules () const
ImportStdModule	GetImportStdModule () const
DynamicClassInfoHelper	GetDynamicClassInfoHelper () const
bool	GetEnableAutoApplyFixIts () const
uint64_t	GetNumberOfRetriesWithFixits () const
bool	GetEnableNotifyAboutFixIts () const
FileSpec	GetSaveJITObjectsDir () const
bool	GetEnableSyntheticValue () const
bool	ShowHexVariableValuesWithLeadingZeroes () const
uint32_t	GetMaxZeroPaddingInFloatFormat () const
uint32_t	GetMaximumNumberOfChildrenToDisplay () const
std::pair< uint32_t, bool >	GetMaximumDepthOfChildrenToDisplay () const
	Get the max depth value, augmented with a bool to indicate whether the depth is the default.
uint32_t	GetMaximumSizeOfStringSummary () const
uint32_t	GetMaximumMemReadSize () const
FileSpec	GetStandardInputPath () const
FileSpec	GetStandardErrorPath () const
FileSpec	GetStandardOutputPath () const
void	SetStandardInputPath (llvm::StringRef path)
void	SetStandardOutputPath (llvm::StringRef path)
void	SetStandardErrorPath (llvm::StringRef path)
void	SetStandardInputPath (const char *path)=delete
void	SetStandardOutputPath (const char *path)=delete
void	SetStandardErrorPath (const char *path)=delete
bool	GetBreakpointsConsultPlatformAvoidList ()
SourceLanguage	GetLanguage () const
llvm::StringRef	GetExpressionPrefixContents ()
uint64_t	GetExprErrorLimit () const
uint64_t	GetExprAllocAddress () const
uint64_t	GetExprAllocSize () const
uint64_t	GetExprAllocAlign () const
bool	GetUseHexImmediates () const
bool	GetUseFastStepping () const
bool	GetDisplayExpressionsInCrashlogs () const
LoadScriptFromSymFile	GetLoadScriptFromSymbolFile () const
LoadCWDlldbinitFile	GetLoadCWDlldbinitFile () const
Disassembler::HexImmediateStyle	GetHexImmediateStyle () const
MemoryModuleLoadLevel	GetMemoryModuleLoadLevel () const
bool	GetUserSpecifiedTrapHandlerNames (Args &args) const
void	SetUserSpecifiedTrapHandlerNames (const Args &args)
bool	GetDisplayRuntimeSupportValues () const
void	SetDisplayRuntimeSupportValues (bool b)
bool	GetDisplayRecognizedArguments () const
void	SetDisplayRecognizedArguments (bool b)
const ProcessLaunchInfo &	GetProcessLaunchInfo () const
void	SetProcessLaunchInfo (const ProcessLaunchInfo &launch_info)
bool	GetInjectLocalVariables (ExecutionContext *exe_ctx) const
bool	GetUseDIL (ExecutionContext *exe_ctx) const
void	SetUseDIL (ExecutionContext *exe_ctx, bool b)
void	SetRequireHardwareBreakpoints (bool b)
bool	GetRequireHardwareBreakpoints () const
bool	GetAutoInstallMainExecutable () const
void	UpdateLaunchInfoFromProperties ()
void	SetDebugUtilityExpression (bool debug)
bool	GetDebugUtilityExpression () const
Public Member Functions inherited from lldb_private::Properties
	Properties ()
	Properties (const lldb::OptionValuePropertiesSP &collection_sp)
virtual	~Properties ()
lldb::OptionValuePropertiesSP	GetValueProperties () const
virtual lldb::OptionValueSP	GetPropertyValue (const ExecutionContext *exe_ctx, llvm::StringRef property_path, Status &error) const
virtual Status	SetPropertyValue (const ExecutionContext *exe_ctx, VarSetOperationType op, llvm::StringRef property_path, llvm::StringRef value)
virtual Status	DumpPropertyValue (const ExecutionContext *exe_ctx, Stream &strm, llvm::StringRef property_path, uint32_t dump_mask, bool is_json=false)
virtual void	DumpAllPropertyValues (const ExecutionContext *exe_ctx, Stream &strm, uint32_t dump_mask, bool is_json=false)
virtual void	DumpAllDescriptions (CommandInterpreter &interpreter, Stream &strm) const
size_t	Apropos (llvm::StringRef keyword, std::vector< const Property * > &matching_properties) const
template<typename T>
T	GetPropertyAtIndexAs (uint32_t idx, T default_value, const ExecutionContext *exe_ctx=nullptr) const
template<typename T, typename U = typename std::remove_pointer<T>::type, std::enable_if_t< std::is_pointer_v< T >, bool > = true>
const U *	GetPropertyAtIndexAs (uint32_t idx, const ExecutionContext *exe_ctx=nullptr) const
template<typename T>
bool	SetPropertyAtIndex (uint32_t idx, T t, const ExecutionContext *exe_ctx=nullptr) const
Public Member Functions inherited from lldb_private::Broadcaster
	Broadcaster (lldb::BroadcasterManagerSP manager_sp, std::string name)
	Construct with a broadcaster with a name.
virtual	~Broadcaster ()
	Destructor.
void	CheckInWithManager ()
void	BroadcastEvent (lldb::EventSP &event_sp)
	Broadcast an event which has no associated data.
void	BroadcastEventIfUnique (lldb::EventSP &event_sp)
void	BroadcastEvent (uint32_t event_type, const lldb::EventDataSP &event_data_sp)
void	BroadcastEvent (uint32_t event_type)
void	BroadcastEventIfUnique (uint32_t event_type)
void	Clear ()
virtual void	AddInitialEventsToListener (const lldb::ListenerSP &listener_sp, uint32_t requested_events)
uint32_t	AddListener (const lldb::ListenerSP &listener_sp, uint32_t event_mask)
	Listen for any events specified by event_mask.
const std::string &	GetBroadcasterName ()
	Get this broadcaster's name.
bool	GetEventNames (Stream &s, const uint32_t event_mask, bool prefix_with_broadcaster_name) const
	Get the event name(s) for one or more event bits.
void	SetEventName (uint32_t event_mask, const char *name)
	Set the name for an event bit.
const char *	GetEventName (uint32_t event_mask) const
bool	EventTypeHasListeners (uint32_t event_type)
bool	RemoveListener (const lldb::ListenerSP &listener_sp, uint32_t event_mask=UINT32_MAX)
	Removes a Listener from this broadcasters list and frees the event bits specified by event_mask that were previously acquired by listener (assuming listener was listening to this object) for other listener objects to use.
bool	HijackBroadcaster (const lldb::ListenerSP &listener_sp, uint32_t event_mask=UINT32_MAX)
	Provides a simple mechanism to temporarily redirect events from broadcaster.
bool	IsHijackedForEvent (uint32_t event_mask)
void	RestoreBroadcaster ()
	Restore the state of the Broadcaster from a previous hijack attempt.
lldb::BroadcasterManagerSP	GetManager ()
void	SetPrimaryListener (lldb::ListenerSP listener_sp)
lldb::ListenerSP	GetPrimaryListener ()
Public Member Functions inherited from lldb_private::ExecutionContextScope
virtual	~ExecutionContextScope ()=default
Public Member Functions inherited from lldb_private::ModuleList::Notifier
virtual	~Notifier ()=default

Static Public Member Functions
static llvm::StringRef	GetStaticBroadcasterClass ()
static void	SettingsInitialize ()
static void	SettingsTerminate ()
static FileSpecList	GetDefaultExecutableSearchPaths ()
static FileSpecList	GetDefaultDebugFileSearchPaths ()
static ArchSpec	GetDefaultArchitecture ()
static void	SetDefaultArchitecture (const ArchSpec &arch)
static TargetProperties &	GetGlobalProperties ()
static Target *	GetTargetFromContexts (const ExecutionContext exe_ctx_ptr, const SymbolContext sc_ptr)
Static Public Member Functions inherited from lldb_private::Properties
static llvm::StringRef	GetExperimentalSettingsName ()
static bool	IsSettingExperimental (llvm::StringRef setting)

Protected Types
using	DummySignalElement = llvm::StringMapEntry<DummySignalValues>
using	BreakpointNameList
typedef std::map< lldb::LanguageType, lldb::REPLSP >	REPLMap
typedef std::map< lldb::user_id_t, StopHookSP >	StopHookCollection
Protected Types inherited from lldb_private::Broadcaster
typedef std::shared_ptr< BroadcasterImpl >	BroadcasterImplSP
typedef std::weak_ptr< BroadcasterImpl >	BroadcasterImplWP

Protected Member Functions
void	InvalidateThreadFrameProviders ()
	Invalidate all potentially cached frame providers for all threads and trigger a stack changed event for all threads.
void	NotifyModuleAdded (const ModuleList &module_list, const lldb::ModuleSP &module_sp) override
	Implementing of ModuleList::Notifier.
void	NotifyModuleRemoved (const ModuleList &module_list, const lldb::ModuleSP &module_sp) override
void	NotifyModuleUpdated (const ModuleList &module_list, const lldb::ModuleSP &old_module_sp, const lldb::ModuleSP &new_module_sp) override
void	NotifyWillClearList (const ModuleList &module_list) override
void	NotifyModulesRemoved (lldb_private::ModuleList &module_list) override
	Target (Debugger &debugger, const ArchSpec &target_arch, const lldb::PlatformSP &platform_sp, bool is_dummy_target)
	Construct with optional file and arch.
bool	ProcessIsValid ()
void	PrimeFromDummyTarget (Target &target)
void	AddBreakpoint (lldb::BreakpointSP breakpoint_sp, bool internal)
void	FinalizeFileActions (ProcessLaunchInfo &info)
lldb::addr_t	GetReasonableReadSize (const Address &addr)
	Return a recommended size for memory reads at addr, optimizing for cache usage.
	Target (const Target &)=delete
const Target &	operator= (const Target &)=delete
SectionLoadList &	GetSectionLoadList ()
Protected Member Functions inherited from lldb_private::Broadcaster
BroadcasterImplSP	GetBroadcasterImpl ()
const char *	GetHijackingListenerName ()

Static Protected Member Functions
static bool	UpdateSignalFromDummy (lldb::UnixSignalsSP signals_sp, const DummySignalElement &element)
static bool	ResetSignalFromDummy (lldb::UnixSignalsSP signals_sp, const DummySignalElement &element)
static void	ImageSearchPathsChanged (const PathMappingList &path_list, void *baton)

Protected Attributes
Debugger &	m_debugger
lldb::PlatformSP	m_platform_sp
	The platform for this target.
std::recursive_mutex	m_mutex
	An API mutex that is used by the lldb::SB* classes make the SB interface thread safe.
std::recursive_mutex	m_private_mutex
	When the private state thread calls SB API's - usually because it is running OS plugin or Python ThreadPlan code - it should not block on the API mutex that is held by the code that kicked off the sequence of events that led us to run the code.
Arch	m_arch
std::string	m_label
ModuleList	m_images
	The list of images for this process (shared libraries and anything dynamically loaded).
SummaryStatisticsCache	m_summary_statistics_cache
SectionLoadHistory	m_section_load_history
BreakpointList	m_breakpoint_list
BreakpointList	m_internal_breakpoint_list
BreakpointNameList	m_breakpoint_names
lldb::BreakpointSP	m_last_created_breakpoint
WatchpointList	m_watchpoint_list
lldb::WatchpointSP	m_last_created_watchpoint
lldb::ProcessSP	m_process_sp
lldb::SearchFilterSP	m_search_filter_sp
PathMappingList	m_image_search_paths
TypeSystemMap	m_scratch_type_system_map
llvm::DenseMap< uint32_t, ScriptedFrameProviderDescriptor >	m_frame_provider_descriptors
	Map of scripted frame provider descriptors for this target.
std::recursive_mutex	m_frame_provider_descriptors_mutex
REPLMap	m_repl_map
lldb::SourceManagerUP	m_source_manager_up
StopHookCollection	m_stop_hooks
lldb::user_id_t	m_stop_hook_next_id
std::vector< StopHookSP >	m_internal_stop_hooks
uint32_t	m_latest_stop_hook_id
bool	m_valid
	This records the last natural stop at which we ran a stop-hook.
bool	m_suppress_stop_hooks
bool	m_is_dummy_target
	Used to not run stop hooks for expressions.
unsigned	m_next_persistent_variable_index = 0
lldb::user_id_t	m_target_unique_id
	The globally unique ID assigned to this target.
std::string	m_target_session_name
	The target session name for this target, used to name debugging sessions in DAP.
lldb::TraceSP	m_trace_sp
	An optional lldb_private::Trace object containing processor trace information of this target.
lldb::StackFrameRecognizerManagerUP	m_frame_recognizer_manager_up
	Stores the frame recognizers of this target.
llvm::StringMap< DummySignalValues >	m_dummy_signals
	These are used to set the signal state when you don't have a process and more usefully in the Dummy target where you can't know exactly what signals you will have.
Protected Attributes inherited from lldb_private::Properties
lldb::OptionValuePropertiesSP	m_collection_sp

Private Attributes
TargetStats	m_stats

Friends
class	TargetList
class	Debugger

Detailed Description

Definition at line 548 of file Target.h.

Member Typedef Documentation

◆ BreakpointNameList

using lldb_private::Target::BreakpointNameList

protected

Initial value:

std::map<ConstString, std::unique_ptr<BreakpointName>>

Definition at line 1793 of file Target.h.

◆ DummySignalElement

using lldb_private::Target::DummySignalElement = llvm::StringMapEntry<DummySignalValues>

protected

Definition at line 1720 of file Target.h.

◆ REPLMap

typedef std::map<lldb::LanguageType, lldb::REPLSP> lldb_private::Target::REPLMap

protected

Definition at line 1815 of file Target.h.

◆ StopHookCollection

typedef std::map<lldb::user_id_t, StopHookSP> lldb_private::Target::StopHookCollection

protected

Definition at line 1820 of file Target.h.

◆ StopHookSP

typedef std::shared_ptr<StopHook> lldb_private::Target::StopHookSP

Definition at line 1642 of file Target.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Broadcaster event bits definitions.

Enumerator
eBroadcastBitBreakpointChanged
eBroadcastBitModulesLoaded
eBroadcastBitModulesUnloaded
eBroadcastBitWatchpointChanged
eBroadcastBitSymbolsLoaded
eBroadcastBitSymbolsChanged
eBroadcastBitNewTargetCreated

Definition at line 558 of file Target.h.

Constructor & Destructor Documentation

◆ ~Target()

Target::~Target ( )

override

Definition at line 214 of file Target.cpp.

References DeleteCurrentProcess(), lldb_private::GetLog(), LLDB_LOG, and lldb_private::Object.

◆ Target() [1/2]

Target::Target	(	Debugger &	debugger,
		const ArchSpec &	target_arch,
		const lldb::PlatformSP &	platform_sp,
		bool	is_dummy_target )

protected

Construct with optional file and arch.

This member is private. Clients must use TargetList::CreateTarget(const FileSpec*, const ArchSpec*) so all targets can be tracked from the central target list.

See also: TargetList::CreateTarget(const FileSpec*, const ArchSpec*)

Definition at line 175 of file Target.cpp.

References lldb_private::Broadcaster::Broadcaster(), lldb_private::Broadcaster::CheckInWithManager(), Debugger, eBroadcastBitBreakpointChanged, eBroadcastBitModulesLoaded, eBroadcastBitModulesUnloaded, eBroadcastBitNewTargetCreated, eBroadcastBitSymbolsLoaded, eBroadcastBitWatchpointChanged, g_target_unique_id, lldb_private::ArchSpec::GetArchitectureName(), lldb_private::GetLog(), GetStaticBroadcasterClass(), lldb_private::ArchSpec::GetTriple(), ImageSearchPathsChanged(), lldb_private::ArchSpec::IsValid(), LLDB_LOG, m_arch, m_breakpoint_list, m_debugger, m_frame_recognizer_manager_up, m_image_search_paths, m_images, m_internal_breakpoint_list, m_internal_stop_hooks, m_is_dummy_target, m_latest_stop_hook_id, m_mutex, m_platform_sp, m_process_sp, m_search_filter_sp, m_section_load_history, m_source_manager_up, m_stop_hook_next_id, m_stop_hooks, m_suppress_stop_hooks, m_target_session_name, m_target_unique_id, m_valid, m_watchpoint_list, lldb_private::Object, lldb_private::Broadcaster::SetEventName(), lldb_private::Target, Target(), lldb_private::TargetProperties::TargetProperties(), and lldb_private::TargetProperties::UpdateLaunchInfoFromProperties().

Referenced by GetTargetFromContexts(), ImageSearchPathsChanged(), operator=(), PrimeFromDummyTarget(), Target(), and Target().

◆ Target() [2/2]

lldb_private::Target::Target ( const Target & )

protecteddelete

References Target().

Member Function Documentation

◆ AddBreakpoint()

void Target::AddBreakpoint	(	lldb::BreakpointSP	breakpoint_sp,
		bool	internal )

protected

Definition at line 806 of file Target.cpp.

References lldb_private::Breakpoints, lldb::eDescriptionLevelVerbose, lldb_private::StreamString::GetData(), lldb_private::GetLog(), LLDB_LOGF, m_breakpoint_list, m_internal_breakpoint_list, and m_last_created_breakpoint.

Referenced by CreateBreakpoint(), and PrimeFromDummyTarget().

◆ AddBreakpointName()

void Target::AddBreakpointName ( std::unique_ptr< BreakpointName > bp_name )

Definition at line 856 of file Target.cpp.

References m_breakpoint_names.

Referenced by PrimeFromDummyTarget().

◆ AddDummySignal()

void Target::AddDummySignal	(	llvm::StringRef	name,
		LazyBool	pass,
		LazyBool	print,
		LazyBool	stop )

Add a signal to the Target's list of stored signals/actions.

These values will get copied into any processes launched from this target.

Definition at line 3869 of file Target.cpp.

References lldb_private::eLazyBoolCalculate, and m_dummy_signals.

Referenced by CommandObjectProcessHandle::DoExecute().

◆ AddNameToBreakpoint() [1/2]

void Target::AddNameToBreakpoint	(	BreakpointID &	id,
		llvm::StringRef	name,
		Status &	error )

Definition at line 829 of file Target.cpp.

References AddNameToBreakpoint(), lldb::eDescriptionLevelBrief, error(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::StreamString::GetData(), and m_breakpoint_list.

Referenced by AddNameToBreakpoint(), CopyOverBreakpointOptions(), lldb_private::Breakpoint::CreateFromStructuredData(), CommandObjectBreakpointNameAdd::DoExecute(), and CommandObjectBreakpointSet::DoExecute().

◆ AddNameToBreakpoint() [2/2]

void Target::AddNameToBreakpoint	(	lldb::BreakpointSP &	bp_sp,
		llvm::StringRef	name,
		Status &	error )

Definition at line 843 of file Target.cpp.

References lldb_private::BreakpointName::ConfigureBreakpoint(), error(), and FindBreakpointName().

◆ AddScriptedFrameProviderDescriptor()

llvm::Expected< uint32_t > Target::AddScriptedFrameProviderDescriptor ( const ScriptedFrameProviderDescriptor & descriptor )

Add or update a scripted frame provider descriptor for this target.

All new threads in this target will check if they match any descriptors to create their frame providers.

Parameters

[in] descriptor The descriptor to add or update.

Returns: The descriptor identifier if the registration succeeded, otherwise an llvm::Error.

Definition at line 3722 of file Target.cpp.

References lldb_private::ScriptedFrameProviderDescriptor::GetID(), lldb_private::ScriptedFrameProviderDescriptor::GetName(), InvalidateThreadFrameProviders(), lldb_private::ScriptedFrameProviderDescriptor::IsValid(), m_frame_provider_descriptors, and m_frame_provider_descriptors_mutex.

Referenced by CommandObjectTargetFrameProviderRegister::DoExecute().

◆ ApplyNameToBreakpoints()

void Target::ApplyNameToBreakpoints ( BreakpointName & bp_name )

Definition at line 909 of file Target.cpp.

References lldb_private::ConstString::AsCString(), lldb_private::Breakpoints, lldb_private::BreakpointName::ConfigureBreakpoint(), lldb_private::GetLog(), lldb_private::BreakpointName::GetName(), LLDB_LOG, and m_breakpoint_list.

Referenced by ConfigureBreakpointName().

◆ Attach()

Status Target::Attach	(	ProcessAttachInfo &	attach_info,
		Stream *	stream )

Definition at line 3630 of file Target.cpp.

Referenced by AttachToProcess(), and CommandObjectProcessAttach::DoExecute().

◆ CalculateExecutionContext()

void Target::CalculateExecutionContext ( ExecutionContext & exe_ctx )

overridevirtual

Reconstruct the object's execution context into sc.

The object should fill in as much of the ExecutionContextScope as it can so function calls that require a execution context can be made for the given object.

Parameters

[out] exe_ctx A reference to an execution context object that gets filled in.

Implements lldb_private::ExecutionContextScope.

Definition at line 2597 of file Target.cpp.

References lldb_private::ExecutionContext::Clear(), and lldb_private::ExecutionContext::SetTargetPtr().

Referenced by EvaluateExpression().

◆ CalculateProcess()

ProcessSP Target::CalculateProcess ( )

overridevirtual

Implements lldb_private::ExecutionContextScope.

Definition at line 2591 of file Target.cpp.

References m_process_sp.

Referenced by CommandObjectTargetModulesLoad::DoExecute().

◆ CalculateStackFrame()

StackFrameSP Target::CalculateStackFrame ( )

overridevirtual

Implements lldb_private::ExecutionContextScope.

Definition at line 2595 of file Target.cpp.

◆ CalculateTarget()

TargetSP Target::CalculateTarget ( )

overridevirtual

Implements lldb_private::ExecutionContextScope.

Definition at line 2589 of file Target.cpp.

Referenced by lldb_private::ABI::GetReturnValueObject().

◆ CalculateThread()

ThreadSP Target::CalculateThread ( )

overridevirtual

Implements lldb_private::ExecutionContextScope.

Definition at line 2593 of file Target.cpp.

◆ CleanupProcess()

void Target::CleanupProcess ( )

Definition at line 263 of file Target.cpp.

References ClearAllWatchpointHistoricValues(), ClearAllWatchpointHitCounts(), DisableAllWatchpoints(), lldb_private::WatchpointList::GetListMutex(), GetWatchpointList(), m_breakpoint_list, m_internal_breakpoint_list, m_latest_stop_hook_id, and ResetBreakpointHitCounts().

Referenced by DeleteCurrentProcess(), and lldb_private::Process::DidExec().

◆ ClearAllLoadedSections()

void Target::ClearAllLoadedSections ( )

Definition at line 3404 of file Target.cpp.

References m_section_load_history.

Referenced by lldb_private::Process::Attach(), lldb_private::Process::LaunchPrivate(), and lldb_private::Process::LoadCore().

◆ ClearAllWatchpointHistoricValues()

bool Target::ClearAllWatchpointHistoricValues ( )

Definition at line 1423 of file Target.cpp.

References lldb_private::GetLog(), LLDB_LOGF, m_watchpoint_list, and lldb_private::Watchpoints.

Referenced by CleanupProcess().

◆ ClearAllWatchpointHitCounts()

bool Target::ClearAllWatchpointHitCounts ( )

Definition at line 1409 of file Target.cpp.

References lldb_private::GetLog(), LLDB_LOGF, m_watchpoint_list, and lldb_private::Watchpoints.

Referenced by CleanupProcess().

◆ ClearDummySignals()

void Target::ClearDummySignals ( Args & signal_names )

Clear the dummy signals in signal_names from the target, or all signals if signal_names is empty.

Also remove the behaviors they set from the process's signals if it exists.

Definition at line 3938 of file Target.cpp.

References lldb_private::Args::GetArgumentCount(), GetProcessSP(), m_dummy_signals, and ResetSignalFromDummy().

Referenced by Destroy(), and CommandObjectProcessHandle::DoExecute().

◆ ClearModules()

void Target::ClearModules ( bool delete_locations )

Definition at line 1563 of file Target.cpp.

References m_images, m_scratch_type_system_map, m_section_load_history, and ModulesDidUnload().

Referenced by Destroy(), lldb_private::Process::DidExec(), SetArchitecture(), and SetExecutableModule().

◆ ClearScriptedFrameProviderDescriptors()

void Target::ClearScriptedFrameProviderDescriptors ( )

Clear all scripted frame provider descriptors for this target.

Definition at line 3758 of file Target.cpp.

References InvalidateThreadFrameProviders(), m_frame_provider_descriptors, and m_frame_provider_descriptors_mutex.

Referenced by CommandObjectTargetFrameProviderClear::DoExecute().

◆ ClearSectionLoadList()

void Target::ClearSectionLoadList ( )

Definition at line 5351 of file Target.cpp.

References lldb_private::SectionLoadList::Clear(), and GetSectionLoadList().

Referenced by DynamicLoaderMacOS::NotifyBreakpointHit().

◆ ConfigureBreakpointName()

void Target::ConfigureBreakpointName	(	BreakpointName &	bp_name,
		const BreakpointOptions &	options,
		const BreakpointName::Permissions &	permissions )

Definition at line 901 of file Target.cpp.

References ApplyNameToBreakpoints(), lldb_private::BreakpointOptions::CopyOverSetOptions(), lldb_private::BreakpointName::GetOptions(), lldb_private::BreakpointName::GetPermissions(), and lldb_private::BreakpointName::Permissions::MergeInto().

Referenced by CommandObjectBreakpointNameConfigure::DoExecute(), and lldb::SBBreakpointName::SBBreakpointName().

◆ CreateAddressInModuleBreakpoint()

lldb::BreakpointSP Target::CreateAddressInModuleBreakpoint	(	lldb::addr_t	file_addr,
		bool	internal,
		const FileSpec &	file_spec,
		bool	request_hardware )

Definition at line 578 of file Target.cpp.

References CreateBreakpoint().

Referenced by CommandObjectBreakpointAddAddress::DoExecute(), and CommandObjectBreakpointSet::DoExecute().

◆ CreateBreakpoint() [1/7]

BreakpointSP Target::CreateBreakpoint	(	const Address &	addr,
		bool	internal,
		bool	request_hardware )

Definition at line 567 of file Target.cpp.

References CreateBreakpoint().

◆ CreateBreakpoint() [2/7]

BreakpointSP Target::CreateBreakpoint	(	const FileSpecList *	containingModules,
		const FileSpec &	file,
		uint32_t	line_no,
		uint32_t	column,
		lldb::addr_t	offset,
		LazyBool	check_inlines,
		LazyBool	skip_prologue,
		bool	internal,
		bool	request_hardware,
		LazyBool	move_to_nearest_code )

Definition at line 489 of file Target.cpp.

References lldb_private::FileSpecList::Append(), CreateBreakpoint(), lldb_private::eInlineBreakpointsAlways, lldb_private::eInlineBreakpointsHeaders, lldb_private::eInlineBreakpointsNever, lldb_private::eLazyBoolCalculate, lldb_private::eLazyBoolNo, lldb_private::eLazyBoolYes, lldb_private::TargetProperties::GetInlineStrategy(), lldb_private::TargetProperties::GetMoveToNearestCode(), GetSearchFilterForModuleAndCUList(), GetSearchFilterForModuleList(), lldb_private::TargetProperties::GetSkipPrologue(), lldb_private::TargetProperties::GetSourcePathMap(), lldb_private::FileSpec::IsSourceImplementationFile(), and lldb_private::PathMappingList::ReverseRemapPath().

Referenced by lldb_private::StructuredDataDarwinLog::AddInitCompletionHook(), CreateAddressInModuleBreakpoint(), CreateBreakpoint(), CreateBreakpoint(), CreateBreakpoint(), CreateBreakpointAtUserEntry(), lldb_private::CPPLanguageRuntime::CreateExceptionBreakpoint(), lldb_private::LanguageRuntime::CreateExceptionBreakpoint(), lldb_private::Breakpoint::CreateFromStructuredData(), CreateFuncRegexBreakpoint(), CreateScriptedBreakpoint(), CreateSourceRegexBreakpoint(), CommandObjectBreakpointAddAddress::DoExecute(), CommandObjectBreakpointAddFile::DoExecute(), CommandObjectBreakpointAddName::DoExecute(), CommandObjectBreakpointSet::DoExecute(), lldb_private::AppleObjCTrampolineHandler::AppleObjCVTables::InitializeVTableSymbols(), lldb_private::ThreadPlanRunToAddress::SetInitialBreakpoints(), lldb_private::ThreadPlanStepRange::SetNextBranchBreakpoint(), DynamicLoaderHexagonDYLD::SetRendezvousBreakpoint(), DynamicLoaderPOSIXDYLD::SetRendezvousBreakpoint(), lldb_private::PlatformDarwin::SetThreadCreationBreakpoint(), and lldb_private::ThreadPlanStepOut::SetupReturnAddress().

◆ CreateBreakpoint() [3/7]

lldb::BreakpointSP lldb_private::Target::CreateBreakpoint	(	const FileSpecList *	containingModules,
		const FileSpecList *	containingSourceFiles,
		const char *	func_name,
		lldb::FunctionNameType	func_name_type_mask,
		lldb::LanguageType	language,
		lldb::addr_t	offset,
		bool	offset_is_insn_count,
		LazyBool	skip_prologue,
		bool	internal,
		bool	request_hardware )

◆ CreateBreakpoint() [4/7]

lldb::BreakpointSP lldb_private::Target::CreateBreakpoint	(	const FileSpecList *	containingModules,
		const FileSpecList *	containingSourceFiles,
		const char *	func_names[],
		size_t	num_names,
		lldb::FunctionNameType	func_name_type_mask,
		lldb::LanguageType	language,
		lldb::addr_t	offset,
		LazyBool	skip_prologue,
		bool	internal,
		bool	request_hardware )

◆ CreateBreakpoint() [5/7]

lldb::BreakpointSP lldb_private::Target::CreateBreakpoint	(	const FileSpecList *	containingModules,
		const FileSpecList *	containingSourceFiles,
		const std::vector< std::string > &	func_names,
		lldb::FunctionNameType	func_name_type_mask,
		lldb::LanguageType	language,
		lldb::addr_t	m_offset,
		LazyBool	skip_prologue,
		bool	internal,
		bool	request_hardware )

References error().

◆ CreateBreakpoint() [6/7]

BreakpointSP Target::CreateBreakpoint	(	lldb::addr_t	load_addr,
		bool	internal,
		bool	request_hardware )

Definition at line 547 of file Target.cpp.

References CreateBreakpoint(), GetBreakableLoadAddress(), GetSectionLoadList(), lldb_private::Address::IsValid(), lldb_private::SectionLoadList::ResolveLoadAddress(), and lldb_private::Address::SetOffset().

◆ CreateBreakpoint() [7/7]

BreakpointSP Target::CreateBreakpoint	(	lldb::SearchFilterSP &	filter_sp,
		lldb::BreakpointResolverSP &	resolver_sp,
		bool	internal,
		bool	request_hardware,
		bool	resolve_indirect_symbols )

Definition at line 791 of file Target.cpp.

References AddBreakpoint(), and lldb_private::TargetProperties::GetRequireHardwareBreakpoints().

◆ CreateBreakpointAtUserEntry()

lldb::BreakpointSP lldb_private::Target::CreateBreakpointAtUserEntry ( Status & error )

Definition at line 434 of file Target.cpp.

References lldb_private::FileSpecList::Append(), CreateBreakpoint(), lldb::eLanguageTypeUnknown, lldb_private::eLazyBoolNo, error(), lldb_private::Language::FindPlugin(), lldb_private::Status::FromErrorString(), GetExecutableModule(), lldb_private::Language::GetSupportedLanguages(), and lldb_private::Language::GetUserEntryPointName().

◆ CreateBreakpointsFromFile() [1/2]

Status Target::CreateBreakpointsFromFile	(	const FileSpec &	file,
		BreakpointIDList &	new_bps )

Definition at line 1260 of file Target.cpp.

References CreateBreakpointsFromFile().

Referenced by CreateBreakpointsFromFile(), and CommandObjectBreakpointRead::DoExecute().

◆ CreateBreakpointsFromFile() [2/2]

Status Target::CreateBreakpointsFromFile	(	const FileSpec &	file,
		std::vector< std::string > &	names,
		BreakpointIDList &	new_bps )

Definition at line 1266 of file Target.cpp.

References lldb_private::BreakpointIDList::AddBreakpointID(), lldb_private::Breakpoint::CreateFromStructuredData(), error(), lldb_private::Status::FromErrorStringWithFormat(), GetBreakpointList(), lldb_private::StructuredData::Array::GetItemAtIndex(), lldb_private::BreakpointList::GetListMutex(), lldb_private::FileSpec::GetPath(), lldb_private::Breakpoint::GetSerializationKey(), lldb_private::StructuredData::Array::GetSize(), lldb_private::StructuredData::Dictionary::GetValueForKey(), lldb_private::StructuredData::ParseJSONFromFile(), and lldb_private::Breakpoint::SerializedBreakpointMatchesNames().

◆ CreateExceptionBreakpoint()

lldb::BreakpointSP Target::CreateExceptionBreakpoint	(	enum lldb::LanguageType	language,
		bool	catch_bp,
		bool	throw_bp,
		bool	internal,
		Args *	additional_args = nullptr,
		Status *	additional_args_error = nullptr )

Definition at line 744 of file Target.cpp.

References lldb_private::LanguageRuntime::CreateExceptionBreakpoint(), and error().

Referenced by CommandObjectBreakpointAddException::DoExecute(), and CommandObjectBreakpointSet::DoExecute().

◆ CreateFuncRegexBreakpoint()

BreakpointSP Target::CreateFuncRegexBreakpoint	(	const FileSpecList *	containingModules,
		const FileSpecList *	containingSourceFiles,
		RegularExpression	func_regexp,
		lldb::LanguageType	requested_language,
		LazyBool	skip_prologue,
		bool	internal,
		bool	request_hardware )

Definition at line 727 of file Target.cpp.

References CreateBreakpoint(), lldb_private::eLazyBoolCalculate, GetSearchFilterForModuleAndCUList(), lldb_private::TargetProperties::GetSkipPrologue(), and skip().

Referenced by CommandObjectBreakpointAddName::DoExecute(), and CommandObjectBreakpointSet::DoExecute().

◆ CreateProcess()

const lldb::ProcessSP & Target::CreateProcess	(	lldb::ListenerSP	listener_sp,
		llvm::StringRef	plugin_name,
		const FileSpec *	crash_file,
		bool	can_connect )

Definition at line 301 of file Target.cpp.

References DeleteCurrentProcess(), lldb_private::Process::FindPlugin(), GetDebugger(), lldb_private::Debugger::GetListener(), and m_process_sp.

Referenced by lldb_private::platform_gdb_server::PlatformRemoteGDBServer::Attach(), lldb_private::PlatformWindows::Attach(), Attach(), PlatformPOSIX::Attach(), lldb_private::platform_gdb_server::PlatformRemoteGDBServer::DebugProcess(), lldb_private::PlatformQemuUser::DebugProcess(), lldb_private::PlatformWasm::DebugProcess(), lldb_private::PlatformWindows::DebugProcess(), PlatformPOSIX::DebugProcess(), lldb_private::Platform::DoConnectProcess(), and Launch().

◆ CreateScriptedBreakpoint()

lldb::BreakpointSP Target::CreateScriptedBreakpoint	(	const llvm::StringRef	class_name,
		const FileSpecList *	containingModules,
		const FileSpecList *	containingSourceFiles,
		bool	internal,
		bool	request_hardware,
		StructuredData::ObjectSP	extra_args_sp,
		Status *	creation_error = nullptr )

Definition at line 761 of file Target.cpp.

References CreateBreakpoint(), lldb::eSearchDepthTarget, GetSearchFilterForModuleAndCUList(), GetSearchFilterForModuleList(), and lldb_private::FileSpecList::GetSize().

Referenced by CommandObjectBreakpointAddScripted::DoExecute(), and CommandObjectBreakpointSet::DoExecute().

◆ CreateSourceRegexBreakpoint()

BreakpointSP Target::CreateSourceRegexBreakpoint	(	const FileSpecList *	containingModules,
		const FileSpecList *	source_file_list,
		const std::unordered_set< std::string > &	function_names,
		RegularExpression	source_regex,
		bool	internal,
		bool	request_hardware,
		LazyBool	move_to_nearest_code )

Definition at line 472 of file Target.cpp.

References CreateBreakpoint(), lldb_private::eLazyBoolCalculate, lldb_private::eLazyBoolNo, lldb_private::eLazyBoolYes, lldb_private::TargetProperties::GetMoveToNearestCode(), and GetSearchFilterForModuleAndCUList().

Referenced by CommandObjectBreakpointAddPattern::DoExecute(), and CommandObjectBreakpointSet::DoExecute().

◆ CreateStopHook()

Target::StopHookSP Target::CreateStopHook	(	StopHook::StopHookKind	kind,
		bool	internal = false )

Add an empty stop hook to the Target's stop hook list, and returns a shared pointer to the new hook.

Definition at line 3048 of file Target.cpp.

References lldb_private::Target::StopHook::CodeBased, lldb_private::Target::StopHook::CommandBased, LLDB_INVALID_UID, m_internal_stop_hooks, m_stop_hook_next_id, m_stop_hooks, and lldb_private::Target::StopHook::ScriptBased.

◆ CreateTrace()

llvm::Expected< TraceSP > Target::CreateTrace ( )

Create a Trace object for the current target using the using the default supported tracing technology for this process.

Returns: The new Trace or an llvm::Error if a Trace already exists or the trace couldn't be created.

Definition at line 3599 of file Target.cpp.

References lldb_private::Trace::FindPluginForLiveProcess(), m_process_sp, and m_trace_sp.

Referenced by GetTraceOrCreate().

◆ CreateUtilityFunction()

llvm::Expected< std::unique_ptr< UtilityFunction > > Target::CreateUtilityFunction	(	std::string	expression,
		std::string	name,
		lldb::LanguageType	language,
		ExecutionContext &	exe_ctx )

Creates and installs a UtilityFunction for the given language.

Definition at line 2768 of file Target.cpp.

References lldb::eExpressionSetupError, lldb_private::DiagnosticManager::GetAsError(), lldb_private::Language::GetNameForLanguageType(), and GetScratchTypeSystemForLanguage().

Referenced by lldb_private::AppleObjCRuntimeV1::CreateObjectChecker(), lldb_private::GNUstepObjCRuntime::CreateObjectChecker(), PlatformPOSIX::MakeLoadImageUtilityFunction(), lldb_private::AppleObjCTrampolineHandler::SetupDispatchFunction(), lldb_private::AppleGetItemInfoHandler::SetupGetItemInfoFunction(), lldb_private::AppleGetPendingItemsHandler::SetupGetPendingItemsFunction(), lldb_private::AppleGetQueuesHandler::SetupGetQueuesFunction(), and lldb_private::AppleGetThreadItemInfoHandler::SetupGetThreadItemInfoFunction().

◆ CreateWatchpoint()

WatchpointSP Target::CreateWatchpoint	(	lldb::addr_t	addr,
		size_t	size,
		const CompilerType *	type,
		uint32_t	kind,
		Status &	error )

◆ DeleteBreakpointName()

void Target::DeleteBreakpointName ( ConstString name )

Definition at line 885 of file Target.cpp.

References lldb_private::ConstString::AsCString(), m_breakpoint_list, and m_breakpoint_names.

◆ DeleteCurrentProcess()

void Target::DeleteCurrentProcess ( )

Definition at line 279 of file Target.cpp.

References CleanupProcess(), m_process_sp, m_section_load_history, and m_trace_sp.

Referenced by CreateProcess(), Destroy(), Launch(), and ~Target().

◆ Destroy()

void Target::Destroy ( )

◆ DidExec()

void Target::DidExec ( )

Called as the last function in Process::DidExec().

Process::DidExec() will clear a lot of state in the process, then try to reload a dynamic loader plugin to discover what binaries are currently available and then this function should be called to allow the target to do any cleanup after everything has been figured out. It can remove breakpoints that no longer make sense as the exec might have changed the target architecture, and unloaded some modules that might get deleted.

Definition at line 1570 of file Target.cpp.

References m_arch, m_breakpoint_list, and m_internal_breakpoint_list.

Referenced by lldb_private::Process::DidExec().

◆ DisableAllBreakpoints()

void Target::DisableAllBreakpoints ( bool internal_also = false )

Definition at line 1073 of file Target.cpp.

References lldb_private::Breakpoints, lldb_private::GetLog(), LLDB_LOGF, m_breakpoint_list, and m_internal_breakpoint_list.

◆ DisableAllowedBreakpoints()

void Target::DisableAllowedBreakpoints ( )

Definition at line 1083 of file Target.cpp.

References lldb_private::Breakpoints, lldb_private::GetLog(), LLDB_LOGF, and m_breakpoint_list.

◆ DisableAllWatchpoints()

bool Target::DisableAllWatchpoints ( bool end_to_end = true )

Definition at line 1356 of file Target.cpp.

References lldb_private::Status::Fail(), lldb_private::GetLog(), LLDB_LOGF, m_process_sp, m_watchpoint_list, ProcessIsValid(), and lldb_private::Watchpoints.

Referenced by CleanupProcess(), and CommandObjectWatchpointDisable::DoExecute().

◆ DisableBreakpointByID()

bool Target::DisableBreakpointByID ( lldb::break_id_t break_id )

Definition at line 1127 of file Target.cpp.

References lldb_private::Breakpoints, lldb_private::GetLog(), LLDB_BREAK_ID_IS_INTERNAL, LLDB_LOGF, m_breakpoint_list, and m_internal_breakpoint_list.

Referenced by RemoveBreakpointByID().

◆ DisableWatchpointByID()

bool Target::DisableWatchpointByID ( lldb::watch_id_t watch_id )

Definition at line 1455 of file Target.cpp.

References lldb_private::GetLog(), LLDB_LOGF, m_process_sp, m_watchpoint_list, ProcessIsValid(), lldb_private::Status::Success(), and lldb_private::Watchpoints.

Referenced by CommandObjectWatchpointDisable::DoExecute(), and RemoveWatchpointByID().

◆ Dump()

void Target::Dump	(	Stream *	s,
		lldb::DescriptionLevel	description_level )

Dump a description of this object to a Stream.

Dump a description of the contents of this object to the supplied stream s. The dumped content will be only what has been loaded or parsed up to this point at which this function is called, so this is a good way to see what has been parsed in a target.

Parameters

[in] s The stream to which to dump the object description.

Definition at line 244 of file Target.cpp.

References lldb::eDescriptionLevelBrief, lldb_private::ConstString::GetCString(), GetExecutableModulePointer(), lldb_private::FileSpec::GetFilename(), lldb_private::Module::GetFileSpec(), lldb_private::Stream::Indent(), lldb_private::Stream::IndentLess(), lldb_private::Stream::IndentMore(), m_breakpoint_list, m_images, m_internal_breakpoint_list, and lldb_private::Stream::PutCString().

◆ DumpSectionLoadList()

void Target::DumpSectionLoadList ( Stream & s )

Definition at line 5353 of file Target.cpp.

References lldb_private::SectionLoadList::Dump(), and GetSectionLoadList().

Referenced by CommandObjectTargetDumpSectionLoadList::DoExecute().

◆ EnableAllBreakpoints()

void Target::EnableAllBreakpoints ( bool internal_also = false )

Definition at line 1090 of file Target.cpp.

References lldb_private::Breakpoints, lldb_private::GetLog(), LLDB_LOGF, m_breakpoint_list, and m_internal_breakpoint_list.

◆ EnableAllowedBreakpoints()

void Target::EnableAllowedBreakpoints ( )

Definition at line 1100 of file Target.cpp.

References lldb_private::Breakpoints, lldb_private::GetLog(), LLDB_LOGF, and m_breakpoint_list.

Referenced by CommandObjectBreakpointEnable::DoExecute().

◆ EnableAllWatchpoints()

bool Target::EnableAllWatchpoints ( bool end_to_end = true )

Definition at line 1383 of file Target.cpp.

References lldb_private::Status::Fail(), lldb_private::GetLog(), LLDB_LOGF, m_process_sp, m_watchpoint_list, ProcessIsValid(), and lldb_private::Watchpoints.

Referenced by CommandObjectWatchpointEnable::DoExecute().

◆ EnableBreakpointByID()

bool Target::EnableBreakpointByID ( lldb::break_id_t break_id )

Definition at line 1145 of file Target.cpp.

References lldb_private::Breakpoints, lldb_private::GetLog(), LLDB_BREAK_ID_IS_INTERNAL, LLDB_LOGF, m_breakpoint_list, and m_internal_breakpoint_list.

◆ EnableWatchpointByID()

bool Target::EnableWatchpointByID ( lldb::watch_id_t watch_id )

Definition at line 1474 of file Target.cpp.

References lldb_private::GetLog(), LLDB_LOGF, m_process_sp, m_watchpoint_list, ProcessIsValid(), lldb_private::Status::Success(), and lldb_private::Watchpoints.

Referenced by CommandObjectWatchpointEnable::DoExecute().

◆ EvaluateExpression()

ExpressionResults Target::EvaluateExpression	(	llvm::StringRef	expression,
		ExecutionContextScope *	exe_scope,
		lldb::ValueObjectSP &	result_valobj_sp,
		const EvaluateExpressionOptions &	options = EvaluateExpressionOptions(),
		std::string *	fixed_expression = nullptr,
		ValueObject *	ctx_obj = nullptr )

◆ FinalizeFileActions()

void Target::FinalizeFileActions ( ProcessLaunchInfo & info )

protected

Definition at line 3790 of file Target.cpp.

References lldb_private::ProcessLaunchInfo::AppendOpenFileAction(), lldb_private::ProcessLaunchInfo::AppendSuppressFileAction(), lldb_private::ProcessLaunchInfo::GetFileActionForFD(), lldb_private::ProcessLaunchInfo::GetFlags(), lldb_private::GetLog(), GetPlatform(), lldb_private::TargetProperties::GetStandardErrorPath(), lldb_private::TargetProperties::GetStandardInputPath(), lldb_private::TargetProperties::GetStandardOutputPath(), LLDB_LOG, LLDB_LOG_ERROR, m_platform_sp, lldb_private::Process, lldb_private::ProcessLaunchInfo::SetUpPtyRedirection(), and lldb_private::Flags::Test().

Referenced by Launch().

◆ FindBreakpointName()

BreakpointName * Target::FindBreakpointName	(	ConstString	name,
		bool	can_create,
		Status &	error )

Definition at line 861 of file Target.cpp.

References lldb_private::ConstString::AsCString(), error(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::ConstString::GetStringRef(), m_breakpoint_names, and lldb_private::BreakpointID::StringIsBreakpointName().

Referenced by AddNameToBreakpoint(), CommandObjectBreakpointNameConfigure::DoExecute(), CommandObjectBreakpointNameList::DoExecute(), and lldb_private::BreakpointIDList::FindAndReplaceIDRanges().

◆ GetABIName()

llvm::StringRef Target::GetABIName ( ) const

Returns the name of the target's ABI plugin.

Definition at line 397 of file Target.cpp.

References lldb_private::ABI::FindPlugin(), GetArchitecture(), and m_process_sp.

◆ GetAPIMutex()

std::recursive_mutex & Target::GetAPIMutex ( )

Definition at line 5330 of file Target.cpp.

References GetProcessSP(), m_mutex, and m_private_mutex.

Referenced by AttachToProcess(), lldb_private::CommandObject::CheckRequirements(), lldb_private::ValueImpl::GetSP(), and lldb::SBWatchpoint::SetEnabled().

◆ GetArchitecture()

const ArchSpec & lldb_private::Target::GetArchitecture ( ) const

inline

Definition at line 1183 of file Target.h.

References m_arch.

◆ GetArchitecturePlugin()

Architecture * lldb_private::Target::GetArchitecturePlugin ( ) const

inline

Definition at line 1222 of file Target.h.

References m_arch.

Referenced by GetBreakableLoadAddress(), GetCallableLoadAddress(), lldb_private::Process::GetMemoryTagManager(), GetOpcodeLoadAddress(), lldb_private::process_gdb_remote::GDBRemoteRegisterContext::ReconfigureRegisterInfo(), lldb_private::process_gdb_remote::GDBRemoteRegisterContext::RegisterWriteCausesReconfigure(), lldb_private::BreakpointResolverName::SearchCallback(), and lldb_private::ThreadPlanStepInRange::ShouldStop().

◆ GetBreakableLoadAddress()

lldb::addr_t Target::GetBreakableLoadAddress ( lldb::addr_t addr )

Definition at line 3005 of file Target.cpp.

References GetArchitecturePlugin().

Referenced by CreateBreakpoint().

◆ GetBreakpointByID()

BreakpointSP Target::GetBreakpointByID ( lldb::break_id_t break_id )

Definition at line 422 of file Target.cpp.

References LLDB_BREAK_ID_IS_INTERNAL, m_breakpoint_list, and m_internal_breakpoint_list.

Referenced by lldb_private::ScriptInterpreterLua::BreakpointCallbackFunction(), CommandObjectBreakpointCommandDelete::DoExecute(), CommandObjectBreakpointCommandList::DoExecute(), CommandObjectBreakpointDelete::DoExecute(), CommandObjectBreakpointEnable::DoExecute(), CommandObjectBreakpointList::DoExecute(), CommandObjectBreakpointModify::DoExecute(), CommandObjectBreakpointNameConfigure::DoExecute(), lldb_private::ThreadPlanStepOut::DoWillResume(), lldb_private::ThreadPlanStepUntil::DoWillResume(), DynamicLoaderPOSIXDYLD::EntryBreakpointHit(), lldb_private::BreakpointIDList::FindAndReplaceIDRanges(), lldb_private::ThreadPlanRunToAddress::GetDescription(), SerializeBreakpointsToFile(), DynamicLoaderHexagonDYLD::SetRendezvousBreakpoint(), lldb_private::CommandObjectMultiwordBreakpoint::VerifyIDs(), lldb_private::ThreadPlanStepOut::WillStop(), and lldb_private::ThreadPlanStepUntil::WillStop().

◆ GetBreakpointList() [1/2]

BreakpointList & Target::GetBreakpointList ( bool internal = false )

Definition at line 408 of file Target.cpp.

References m_breakpoint_list, and m_internal_breakpoint_list.

◆ GetBreakpointList() [2/2]

const BreakpointList & Target::GetBreakpointList ( bool internal = false ) const

Definition at line 415 of file Target.cpp.

References m_breakpoint_list, and m_internal_breakpoint_list.

◆ GetBreakpointNames()

void Target::GetBreakpointNames ( std::vector< std::string > & names )

Definition at line 923 of file Target.cpp.

References m_breakpoint_names.

Referenced by CommandObjectBreakpointNameList::DoExecute().

◆ GetBroadcasterClass()

llvm::StringRef lldb_private::Target::GetBroadcasterClass ( ) const

inlineoverridevirtual

This needs to be filled in if you are going to register the broadcaster with the broadcaster manager and do broadcaster class matching.

FIXME: Probably should make a ManagedBroadcaster subclass with all the bits needed to work with the BroadcasterManager, so that it is clearer how to add one.

Reimplemented from lldb_private::Broadcaster.

Definition at line 572 of file Target.h.

References GetStaticBroadcasterClass().

◆ GetCallableLoadAddress()

lldb::addr_t Target::GetCallableLoadAddress	(	lldb::addr_t	load_addr,
		AddressClass	addr_class = AddressClass::eInvalid ) const

Get load_addr as a callable code load address for this target.

Take load_addr and potentially add any address bits that are needed to make the address callable. For ARM this can set bit zero (if it already isn't) if load_addr is a thumb function. If addr_class is set to AddressClass::eInvalid, then the address adjustment will always happen. If it is set to an address class that doesn't have code in it, LLDB_INVALID_ADDRESS will be returned.

Definition at line 2990 of file Target.cpp.

References GetArchitecturePlugin().

Referenced by lldb_private::Address::GetCallableLoadAddress(), and lldb_private::Address::SetCallableLoadAddress().

◆ GetDebugger()

Debugger & lldb_private::Target::GetDebugger ( ) const

inline

Definition at line 1224 of file Target.h.

References Debugger, and m_debugger.

Referenced by lldb_private::ClangUserExpression::AddArguments(), Attach(), lldb_private::ScriptInterpreterLua::BreakpointCallbackFunction(), lldb_private::BreakpointOptions::BreakpointOptionsCallbackFunction(), lldb_private::Process::CompleteAttach(), CompleteLineEntry(), lldb_private::Process::CreateBreakpointSite(), lldb_private::BreakpointOptions::CreateFromStructuredData(), CreateProcess(), ProcessKDP::DoConnectRemote(), lldb_private::InstructionList::Dump(), lldb_private::StackFrame::DumpUsingSettingsFormat(), lldb_private::Thread::DumpUsingSettingsFormat(), lldb_private::UserExpression::Execute(), lldb_private::FunctionCaller::ExecuteFunction(), lldb_private::StructuredDataDarwinLog::FilterLaunchInfo(), lldb_private::Debugger::FormatDisassemblerAddress(), lldb_private::Thread::GetStackFrameStatus(), lldb_private::StackFrame::GetStatus(), lldb_private::Thread::GetStatus(), lldb_private::mcp::DebuggerResourceProvider::GetTargetResource(), lldb_private::StructuredDataDarwinLog::HandleArrivalOfStructuredData(), lldb_private::Target::StopHookCommandLine::HandleStop(), IRInterpreter::Interpret(), Launch(), lldb_private::DynamicLoader::LoadBinaryWithUUIDAndAddress(), ObjectFileMachO::LoadCoreFileImages(), DynamicLoaderDarwinKernel::KextImageInfo::LoadImageUsingMemoryModule(), DynamicLoaderFreeBSDKernel::KModImageInfo::LoadImageUsingMemoryModule(), LoadScriptingResourceForModule(), lldb_private::Module::LoadScriptingResourceInTarget(), lldb_private::PlatformDarwin::LocateExecutableScriptingResources(), lldb_private::PlatformDarwin::LocateExecutableScriptingResourcesFromDSYM(), DynamicLoaderMacOS::NotifyBreakpointHit(), DynamicLoaderMacOSXDYLD::NotifyBreakpointHit(), lldb_private::process_gdb_remote::ProcessGDBRemote::ParsePythonTargetDefinition(), lldb_private::StopInfoBreakpoint::PerformAction(), lldb_private::StopInfoWatchpoint::PerformAction(), lldb_private::Process::PopProcessIOHandler(), lldb_private::Disassembler::PrintInstructions(), ProcessFreeBSDKernelCore::PrintUnreadMessage(), lldb_private::Process::ProcessIOHandlerIsActive(), lldb_private::Process::PushProcessIOHandler(), ResumeNewPlan(), RunScriptFormatKeyword(), ObjectFileMachO::SaveCore(), SetArchitecture(), SetLabel(), and lldb_private::ScriptInterpreterLua::WatchpointCallbackFunction().

◆ GetDefaultArchitecture()

ArchSpec Target::GetDefaultArchitecture ( )

static

Definition at line 2807 of file Target.cpp.

References lldb_private::TargetProperties::GetDefaultArchitecture(), and GetGlobalProperties().

Referenced by lldb_private::Debugger::Debugger(), lldb_private::Platform::DoConnectProcess(), lldb::SBDebugger::GetDefaultArchitecture(), and ObjectContainerUniversalMachO::GetObjectFile().

◆ GetDefaultDebugFileSearchPaths()

FileSpecList Target::GetDefaultDebugFileSearchPaths ( )

static

Definition at line 2803 of file Target.cpp.

References lldb_private::TargetProperties::GetDebugFileSearchPaths(), and GetGlobalProperties().

Referenced by lldb_private::wasm::SymbolVendorWasm::CreateInstance(), SymbolVendorELF::CreateInstance(), SymbolVendorMacOSX::CreateInstance(), SymbolVendorPECOFF::CreateInstance(), ProcessKDP::DoConnectRemote(), findMatchingPDBFilePath(), lldb_private::plugin::dwarf::SymbolFileDWARF::GetDwoSymbolFileForCompileUnit(), lldb_private::plugin::dwarf::SymbolFileDWARF::GetDwpSymbolFile(), and lldb_private::DynamicLoader::LoadBinaryWithUUIDAndAddress().

◆ GetDefaultExecutableSearchPaths()

FileSpecList Target::GetDefaultExecutableSearchPaths ( )

static

Definition at line 2799 of file Target.cpp.

References lldb_private::TargetProperties::GetExecutableSearchPaths(), and GetGlobalProperties().

Referenced by DynamicLoaderPOSIXDYLD::ResolveExecutableModule().

◆ GetEntryPointAddress()

llvm::Expected< lldb_private::Address > Target::GetEntryPointAddress ( )

This method will return the address of the starting function for this binary, e.g.

main() or its equivalent. This can be used as an address of a function that is not called once a binary has started running - e.g. as a return address for inferior function calls that are unambiguous completion of the function call, not called during the course of the inferior function code running.

If no entry point can be found, an invalid address is returned.

Parameters

[out] err This object will be set to failure if no entry address could be found, and may contain a helpful error message.

Returns: Returns the entry address for this program, or an error if none can be found.

Definition at line 2956 of file Target.cpp.

References lldb_private::ObjectFile::GetEntryPointAddress(), GetExecutableModulePointer(), lldb_private::FileSpec::GetFilename(), lldb_private::Module::GetFileSpec(), GetImages(), lldb_private::ModuleList::GetModuleAtIndex(), lldb_private::Module::GetObjectFile(), lldb_private::ModuleList::GetSize(), lldb_private::ConstString::GetStringRef(), and lldb_private::Address::IsValid().

Referenced by lldb_private::ThreadPlanCallFunction::ConstructorSetup().

◆ GetExecutableModule()

ModuleSP Target::GetExecutableModule ( )

Gets the module for the main executable.

Each process has a notion of a main executable that is the file that will be executed or attached to. Executable files can have dependent modules that are discovered from the object files, or discovered at runtime as things are dynamically loaded.

Returns: The shared pointer to the executable module which can contains a nullptr Module object if no executable has been set.

See also: DynamicLoader; ObjectFile::GetDependentModules (FileSpecList&); Process::SetExecutableModule(lldb::ModuleSP&)

Definition at line 1525 of file Target.cpp.

References lldb_private::ObjectFile::eTypeExecutable, lldb_private::ObjectFile::GetType(), and m_images.

Referenced by lldb_private::PlatformDarwin::AddClangModuleCompilationOptionsForSDKType(), Attach(), PlatformPOSIX::Attach(), lldb_private::Process::CompleteAttach(), CreateBreakpointAtUserEntry(), ProcessKDP::DoConnectRemote(), CommandObjectProcessAttach::DoExecute(), CommandObjectProcessLaunch::DoExecute(), ProcessElfCore::DoLoadCore(), ProcessMachCore::DoLoadCore(), ProcessFreeBSDKernelCore::FindSymbol(), GetExecutableModulePointer(), lldb_private::ProcessWindows::GetImageInfoAddress(), ProcessElfCore::GetImageInfoAddress(), lldb_private::minidump::ProcessMinidump::GetProcessInfo(), lldb_private::ProcessTrace::GetProcessInfo(), lldb_private::ScriptedProcess::GetProcessInfo(), ProcessElfCore::GetProcessInfo(), lldb_private::PlatformMacOSX::GetSDKDirectory(), DynamicLoaderHexagonDYLD::GetTargetExecutable(), lldb_private::DynamicLoader::GetTargetExecutable(), ImageSearchPathsChanged(), Install(), lldb_private::process_gdb_remote::ProcessGDBRemote::MaybeLoadExecutableModule(), DYLDRendezvous::ResolveRendezvousAddress(), ResolveSDKPathFromDebugInfo(), SetArchitecture(), ProcessFreeBSDKernelCore::SetKernelDisplacement(), and lldb_private::DynamicLoaderDarwin::UpdateSpecialBinariesFromPreloadedModules().

◆ GetExecutableModulePointer()

Module * Target::GetExecutableModulePointer ( )

Definition at line 1541 of file Target.cpp.

References GetExecutableModule().

Referenced by DynamicLoaderDarwinKernel::CreateInstance(), DynamicLoaderFreeBSDKernel::CreateInstance(), DynamicLoaderMacOS::CreateInstance(), CommandObjectPlatformProcessLaunch::DoExecute(), Dump(), DumpTargetInfo(), DynamicLoaderFreeBSDKernel::FindKernelAtLoadAddress(), lldb_private::FormatEntity::Formatter::Format(), GetEntryPointAddress(), DynamicLoaderHexagonDYLD::GetTargetExecutable(), lldb_private::DynamicLoader::GetTargetExecutable(), lldb_private::mcp::DebuggerResourceProvider::GetTargetResource(), lldb_private::Process::LaunchPrivate(), lldb_private::process_gdb_remote::ProcessGDBRemote::LoadModules(), DynamicLoaderDarwinKernel::SearchForKernelAtSameLoadAddr(), DynamicLoaderMacOSXDYLD::UpdateImageInfosHeaderAndLoadCommands(), and lldb_private::DynamicLoaderDarwin::UpdateSpecialBinariesFromPreloadedModules().

◆ GetFrameRecognizerManager()

StackFrameRecognizerManager & lldb_private::Target::GetFrameRecognizerManager ( )

inline

Definition at line 1702 of file Target.h.

References m_frame_recognizer_manager_up.

Referenced by lldb_private::CPPLanguageRuntime::CPPLanguageRuntime(), CommandObjectFrameRecognizerAdd::DoExecute(), CommandObjectFrameRecognizerClear::DoExecute(), CommandObjectFrameRecognizerInfo::DoExecute(), CommandObjectFrameRecognizerList::DoExecute(), CommandObjectFrameRecognizerDelete::DoExecuteWithId(), CommandObjectFrameRecognizerDisable::DoExecuteWithId(), CommandObjectFrameRecognizerEnable::DoExecuteWithId(), CommandObjectWithFrameRecognizerArg::HandleArgumentCompletion(), lldb_private::RegisterAbortWithPayloadFrameRecognizer(), lldb_private::RegisterAssertFrameRecognizer(), lldb_private::RegisterMSVCRTCFrameRecognizer(), and lldb_private::RegisterVerboseTrapFrameRecognizer().

◆ GetFunctionCallerForLanguage()

FunctionCaller * Target::GetFunctionCallerForLanguage	(	lldb::LanguageType	language,
		const CompilerType &	return_type,
		const Address &	function_address,
		const ValueList &	arg_value_list,
		const char *	name,
		Status &	error )

Definition at line 2738 of file Target.cpp.

References error(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::Language::GetNameForLanguageType(), and GetScratchTypeSystemForLanguage().

◆ GetGloballyUniqueID()

lldb::user_id_t lldb_private::Target::GetGloballyUniqueID ( ) const

inline

Get the globally unique ID for this target.

This ID is unique across all debugger instances and all targets, within the same lldb process. The ID is assigned during target construction and remains constant for the target's lifetime. The first target created (typically the dummy target) gets ID 1.

Returns: The globally unique ID for this target.

Definition at line 654 of file Target.h.

References m_target_unique_id.

◆ GetGlobalProperties()

TargetProperties & Target::GetGlobalProperties ( )

static

Definition at line 3286 of file Target.cpp.

References lldb_private::TargetProperties::TargetProperties().

Referenced by lldb_private::Debugger::Debugger(), lldb_private::DumpDataExtractor(), GetDefaultArchitecture(), GetDefaultDebugFileSearchPaths(), GetDefaultExecutableSearchPaths(), SaveScriptedLaunchInfo(), SetDefaultArchitecture(), lldb_private::FormatManager::ShouldPrintAsOneLiner(), lldb_private::CommandInterpreter::SourceInitFileCwd(), and lldb_private::TargetProperties::TargetProperties().

◆ GetImages() [1/2]

ModuleList & lldb_private::Target::GetImages ( )

inline

Definition at line 1143 of file Target.h.

References m_images.

◆ GetImages() [2/2]

const ModuleList & lldb_private::Target::GetImages ( ) const

inline

Get accessor for the images for this process.

Each process has a notion of a main executable that is the file that will be executed or attached to. Executable files can have dependent modules that are discovered from the object files, or discovered at runtime as things are dynamically loaded. After a main executable has been set, the images will contain a list of all the files that the executable depends upon as far as the object files know. These images will usually contain valid file virtual addresses only. When the process is launched or attached to, the DynamicLoader plug-in will discover where these images were loaded in memory and will resolve the load virtual addresses is each image, and also in images that are loaded by code.

Returns: A list of Module objects in a module list.

Definition at line 1141 of file Target.h.

References m_images.

◆ GetImageSearchPathList()

PathMappingList & Target::GetImageSearchPathList ( )

Definition at line 2602 of file Target.cpp.

References m_image_search_paths.

Referenced by CommandObjectTargetModulesSearchPathsAdd::DoExecute(), CommandObjectTargetModulesSearchPathsClear::DoExecute(), CommandObjectTargetModulesSearchPathsInsert::DoExecute(), CommandObjectTargetModulesSearchPathsList::DoExecute(), CommandObjectTargetModulesSearchPathsQuery::DoExecute(), and CommandObjectTargetModulesSearchPathsInsert::HandleArgumentCompletion().

◆ GetLabel()

const std::string & lldb_private::Target::GetLabel ( ) const

inline

Definition at line 656 of file Target.h.

References m_label.

Referenced by DumpTargetInfo().

◆ GetLastCreatedBreakpoint()

lldb::BreakpointSP lldb_private::Target::GetLastCreatedBreakpoint ( )

inline

Definition at line 815 of file Target.h.

References m_last_created_breakpoint.

Referenced by lldb_private::CommandObjectMultiwordBreakpoint::VerifyIDs().

◆ GetLastCreatedWatchpoint()

lldb::WatchpointSP lldb_private::Target::GetLastCreatedWatchpoint ( )

inline

Definition at line 923 of file Target.h.

References m_last_created_watchpoint.

Referenced by CommandObjectWatchpointModify::DoExecute(), and lldb_private::CommandObjectMultiwordWatchpoint::VerifyWatchpointIDs().

◆ GetOpcodeLoadAddress()

lldb::addr_t Target::GetOpcodeLoadAddress	(	lldb::addr_t	load_addr,
		AddressClass	addr_class = AddressClass::eInvalid ) const

Get load_addr as an opcode for this target.

Take load_addr and potentially strip any address bits that are needed to make the address point to an opcode. For ARM this can clear bit zero (if it already isn't) if load_addr is a thumb function and load_addr is in code. If addr_class is set to AddressClass::eInvalid, then the address adjustment will always happen. If it is set to an address class that doesn't have code in it, LLDB_INVALID_ADDRESS will be returned.

Definition at line 2998 of file Target.cpp.

References GetArchitecturePlugin().

Referenced by lldb_private::Address::GetOpcodeLoadAddress(), lldb::SBFrame::GetPC(), lldb_private::Address::SetOpcodeLoadAddress(), and lldb_private::ThreadPlanRunToAddress::ThreadPlanRunToAddress().

◆ GetOrCreateModule()

ModuleSP Target::GetOrCreateModule	(	const ModuleSpec &	module_spec,
		bool	notify,
		Status *	error_ptr = nullptr )

Find a binary on the system and return its Module, or return an existing Module that is already in the Target.

Given a ModuleSpec, find a binary satisifying that specification, or identify a matching Module already present in the Target, and return a shared pointer to it.

Note that this function previously also preloaded the module's symbols depending on a setting. This function no longer does any module preloading because that can potentially cause deadlocks when called in parallel with this function.

Parameters

[in]	module_spec	The criteria that must be matched for the binary being loaded. e.g. UUID, architecture, file path.
[in]	notify	If notify is true, and the Module is new to this Target, Target::ModulesDidLoad will be called. See note in Target::ModulesDidLoad about thread-safety with Target::GetOrCreateModule. If notify is false, it is assumed that the caller is adding multiple Modules and will call ModulesDidLoad with the full list at the end. ModulesDidLoad must be called when a Module/Modules have been added to the target, one way or the other.
[out]	error_ptr	Optional argument, pointing to a Status object to fill in with any results / messages while attempting to find/load this binary. Many callers will be internal functions that will handle / summarize the failures in a custom way and don't use these messages.

Returns: An empty ModuleSP will be returned if no matching file was found. If error_ptr was non-nullptr, an error message will likely be provided.

A core file that has a checkpoint of a program's execution state

A normal executable

The platform's dynamic linker executable

An intermediate object file

A shared library that can be used during execution

An object file that contains only debug information

A library that can be linked against but not used for execution

Definition at line 2352 of file Target.cpp.

Referenced by lldb_private::DynamicLoaderDarwin::AddModulesUsingPreloadedModules(), CommandObjectTargetModulesAdd::DoExecute(), ProcessElfCore::DoLoadCore(), lldb_private::DynamicLoader::FindModuleViaTarget(), lldb_private::DynamicLoaderDarwin::FindTargetModuleForImageInfo(), lldb_private::ScriptedProcess::GetLoadedDynamicLibrariesInfos(), lldb_private::minidump::ProcessMinidump::GetOrCreateModule(), DynamicLoaderHexagonDYLD::GetTargetExecutable(), lldb_private::DynamicLoader::GetTargetExecutable(), DynamicLoaderDarwinKernel::KextImageInfo::LoadImageUsingMemoryModule(), DynamicLoaderFreeBSDKernel::KModImageInfo::LoadImageUsingMemoryModule(), DynamicLoaderPOSIXDYLD::LoadInterpreterModule(), lldb_private::trace_intel_pt::TraceIntelPTBundleLoader::ParseModule(), lldb_private::minidump::ProcessMinidump::ReadModuleList(), and SetExecutableModule().

◆ GetPersistentExpressionStateForLanguage()

PersistentExpressionState * Target::GetPersistentExpressionStateForLanguage ( lldb::LanguageType language )

Definition at line 2685 of file Target.cpp.

References lldb_private::GetLog(), lldb_private::Language::GetNameForLanguageType(), GetScratchTypeSystemForLanguage(), LLDB_LOG, LLDB_LOG_ERROR, and lldb_private::Target.

Referenced by CommandObjectMemoryRead::DoExecute(), lldb_private::CommandObjectDWIMPrint::DoExecute(), lldb_private::UserExpression::Execute(), lldb_private::ABI::GetReturnValueObject(), lldb_private::ClangExpressionSourceCode::GetText(), lldb_private::ObjCLanguageRuntime::LookupInModulesVendor(), lldb_private::ClangUserExpression::Parse(), SetupDeclVendor(), and lldb_private::ClangExpressionDeclMap::WillParse().

◆ GetPersistentSymbol()

lldb::addr_t Target::GetPersistentSymbol ( ConstString name )

Definition at line 2936 of file Target.cpp.

References LLDB_INVALID_ADDRESS, and m_scratch_type_system_map.

◆ GetPersistentVariable()

lldb::ExpressionVariableSP Target::GetPersistentVariable ( ConstString name )

Definition at line 2917 of file Target.cpp.

References m_scratch_type_system_map.

Referenced by lldb_private::CommandObjectDWIMPrint::DoExecute(), and lldb::SBFrame::FindValue().

◆ GetPlatform()

lldb::PlatformSP lldb_private::Target::GetPlatform ( )

inline

Definition at line 1678 of file Target.h.

References m_platform_sp.

Referenced by lldb_private::process_gdb_remote::ProcessGDBRemote::ConnectToDebugserver(), lldb_private::ClangModulesDeclVendor::Create(), lldb_private::process_gdb_remote::ProcessGDBRemote::DidLaunchOrAttach(), CommandObjectPlatformProcessInfo::DoExecute(), CommandObjectPlatformProcessLaunch::DoExecute(), CommandObjectPlatformProcessList::DoExecute(), CommandObjectPlatformStatus::DoExecute(), CommandObjectProcessLoad::DoExecute(), CommandObjectProcessStatus::DoExecute(), CommandObjectProcessUnload::DoExecute(), CommandObjectTargetModulesShowUnwind::DoExecute(), CommandObjectTargetSymbolsAdd::DoExecute(), DumpTargetInfo(), FinalizeFileActions(), lldb_private::RegisterContextUnwind::GetFullUnwindPlanForFrame(), lldb_private::CommandInterpreter::GetPlatform(), lldb_private::Process::GetProcessInfo(), lldb_private::Thread::GetSiginfoValue(), lldb_private::ClangExpressionSourceCode::GetText(), lldb_private::InferiorCallMmap(), Install(), isLoadBiasIncorrect(), lldb_private::RegisterContextUnwind::IsTrapHandlerSymbol(), Launch(), lldb_private::DynamicLoader::LoadBinaryWithUUIDAndAddress(), DynamicLoaderDarwinKernel::KextImageInfo::LoadImageUsingMemoryModule(), lldb_private::Module::LoadScriptingResourceInTarget(), lldb_private::process_gdb_remote::ProcessGDBRemote::SaveCore(), and SetArchitecture().

◆ GetProcessSP()

const lldb::ProcessSP & Target::GetProcessSP ( ) const

Definition at line 313 of file Target.cpp.

References m_process_sp.

Referenced by Attach(), AttachToProcess(), CheckIfWatchpointsSupported(), CheckTargetForWatchpointOperations(), ClearDummySignals(), lldb_private::StopInfoMachException::CreateStopReasonWithMachException(), lldb_private::CompactUnwindInfo::CreateUnwindPlan_i386(), lldb_private::CompactUnwindInfo::CreateUnwindPlan_x86_64(), CommandObjectProcessAttach::DoExecute(), CommandObjectProcessHandle::DoExecute(), CommandObjectProcessLaunch::DoExecute(), CommandObjectTargetModulesAdd::DoExecute(), CommandObjectWatchpointList::DoExecute(), sddarwinlog_private::EnableCommand::DoExecute(), sddarwinlog_private::StatusCommand::DoExecute(), DumpTargetInfo(), lldb_private::ExecutionContext::ExecutionContext(), GetAPIMutex(), lldb_private::Address::GetCallableLoadAddress(), lldb_private::CompactUnwindInfo::GetCompactUnwindInfoForFunction(), lldb_private::CommandObject::GetDefaultThread(), lldb_private::BreakpointLocation::GetDescription(), lldb_private::CompactUnwindInfo::GetUnwindPlan(), InvalidateThreadFrameProviders(), Launch(), QuitCommandOverrideCallback(), lldb_private::Symbol::ResolveCallableAddress(), lldb::SBWatchpoint::SetEnabled(), SetExecutableModule(), SetSectionLoadAddress(), SetSectionUnloaded(), SetSectionUnloaded(), lldb_private::TargetStats::ToJSON(), and UnloadModuleSections().

◆ GetReasonableReadSize()

addr_t Target::GetReasonableReadSize ( const Address & addr )

protected

Return a recommended size for memory reads at addr, optimizing for cache usage.

Definition at line 2207 of file Target.cpp.

References lldb_private::Address::GetLoadAddress(), LLDB_INVALID_ADDRESS, and m_process_sp.

Referenced by ReadStringFromMemory().

◆ GetRegisterType()

CompilerType Target::GetRegisterType	(	const std::string &	name,
		const lldb_private::RegisterFlags &	flags,
		uint32_t	byte_size )

Definition at line 2642 of file Target.cpp.

References lldb_private::PluginManager::GetRegisterTypeBuilder().

◆ GetREPL()

lldb::REPLSP Target::GetREPL	(	Status &	err,
		lldb::LanguageType	language,
		const char *	repl_options,
		bool	can_create )

Definition at line 315 of file Target.cpp.

References lldb_private::REPL::Create(), Debugger, lldb::eLanguageTypeUnknown, lldb_private::LanguageSet::Empty(), lldb_private::Status::FromErrorString(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::Language::GetLanguagesSupportingREPLs(), lldb_private::Language::GetNameForLanguageType(), lldb_private::LanguageSet::GetSingularLanguage(), m_debugger, m_repl_map, and lldb_private::Status::Success().

◆ GetScratchTypeSystemForLanguage()

llvm::Expected< lldb::TypeSystemSP > Target::GetScratchTypeSystemForLanguage	(	lldb::LanguageType	language,
		bool	create_on_demand = true )

◆ GetScratchTypeSystems()

std::vector< lldb::TypeSystemSP > Target::GetScratchTypeSystems ( bool create_on_demand = true )

Definition at line 2651 of file Target.cpp.

References lldb_private::bit(), lldb_private::LanguageSet::bitvector, lldb_private::Language::GetLanguagesSupportingTypeSystemsForExpressions(), lldb_private::GetLog(), lldb_private::Language::GetNameForLanguageType(), GetScratchTypeSystemForLanguage(), LLDB_LOG_ERROR, m_valid, and lldb_private::Target.

◆ GetScriptedFrameProviderDescriptors()

const llvm::DenseMap< uint32_t, ScriptedFrameProviderDescriptor > & Target::GetScriptedFrameProviderDescriptors ( ) const

Get all scripted frame provider descriptors for this target.

Definition at line 3769 of file Target.cpp.

References m_frame_provider_descriptors, and m_frame_provider_descriptors_mutex.

Referenced by CommandObjectTargetFrameProviderList::DoExecute(), and lldb_private::Thread::GetStackFrameList().

◆ GetSearchFilterForModule()

SearchFilterSP Target::GetSearchFilterForModule ( const FileSpec * containingModule )

Definition at line 672 of file Target.cpp.

References m_search_filter_sp.

◆ GetSearchFilterForModuleAndCUList()

SearchFilterSP Target::GetSearchFilterForModuleAndCUList	(	const FileSpecList *	containingModules,
		const FileSpecList *	containingSourceFiles )

Definition at line 707 of file Target.cpp.

References GetSearchFilterForModuleList(), and lldb_private::FileSpecList::GetSize().

Referenced by CreateBreakpoint(), CreateFuncRegexBreakpoint(), CreateScriptedBreakpoint(), and CreateSourceRegexBreakpoint().

◆ GetSearchFilterForModuleList()

SearchFilterSP Target::GetSearchFilterForModuleList ( const FileSpecList * containingModuleList )

Definition at line 690 of file Target.cpp.

References lldb_private::FileSpecList::GetSize(), and m_search_filter_sp.

Referenced by CreateBreakpoint(), lldb_private::AppleObjCRuntime::CreateExceptionSearchFilter(), lldb_private::CPPLanguageRuntime::CreateExceptionSearchFilter(), CreateScriptedBreakpoint(), and GetSearchFilterForModuleAndCUList().

◆ GetSectionLoadAddress()

lldb::addr_t Target::GetSectionLoadAddress ( const lldb::SectionSP & section_sp )

Definition at line 5347 of file Target.cpp.

References lldb_private::SectionLoadList::GetSectionLoadAddress(), and GetSectionLoadList().

Referenced by lldb_private::minidump::ProcessMinidump::BuildMemoryRegions(), lldb_private::ObjectFile::GetLoadableData(), lldb_private::Section::GetLoadBaseAddress(), and DynamicLoaderStatic::LoadAllImagesAtFileAddresses().

◆ GetSectionLoadList()

SectionLoadList & lldb_private::Target::GetSectionLoadList ( )

inlineprotected

Definition at line 1899 of file Target.h.

References m_section_load_history.

Referenced by ClearSectionLoadList(), CreateBreakpoint(), DumpSectionLoadList(), GetSectionLoadAddress(), HasLoadedSections(), ReadMemory(), and ReadPointerFromMemory().

◆ GetSourceManager()

SourceManager & Target::GetSourceManager ( )

Definition at line 3042 of file Target.cpp.

References m_source_manager_up.

Referenced by CommandObjectSourceList::DisplayFunctionSource(), CommandObjectSourceList::DoExecute(), GetDefaultFile(), and lldb_private::StackFrame::GetStatus().

◆ GetStaticBroadcasterClass()

llvm::StringRef Target::GetStaticBroadcasterClass ( )

static

Definition at line 170 of file Target.cpp.

Referenced by lldb_private::Debugger::DefaultEventHandler(), GetBroadcasterClass(), lldb::SBTarget::GetBroadcasterClassName(), and Target().

◆ GetStatistics()

TargetStats & lldb_private::Target::GetStatistics ( )

inline

Definition at line 1869 of file Target.h.

References m_stats.

Referenced by lldb_private::BreakpointResolverFileLine::DeduceSourceMapping(), lldb_private::BreakpointResolverFileLine::SearchCallback(), lldb_private::Process::SetPrivateState(), and lldb_private::Process::SetPublicState().

◆ GetStopHookByID()

Target::StopHookSP Target::GetStopHookByID ( lldb::user_id_t uid )

Definition at line 3084 of file Target.cpp.

References m_stop_hooks.

◆ GetStopHooks()

const std::vector< Target::StopHookSP > Target::GetStopHooks ( bool internal = false ) const

Definition at line 3118 of file Target.cpp.

References m_internal_stop_hooks, and m_stop_hooks.

Referenced by CommandObjectTargetStopHookList::DoExecute().

◆ GetSummaryStatisticsCache()

SummaryStatisticsCache & Target::GetSummaryStatisticsCache ( )

Definition at line 3412 of file Target.cpp.

References m_summary_statistics_cache.

Referenced by lldb_private::TargetStats::Reset(), and lldb_private::TargetStats::ToJSON().

◆ GetSummaryStatisticsSPForProviderName()

lldb_private::SummaryStatisticsSP Target::GetSummaryStatisticsSPForProviderName ( lldb_private::TypeSummaryImpl & summary_provider )

Definition at line 3406 of file Target.cpp.

References m_summary_statistics_cache.

◆ GetSuppressStopHooks()

bool lldb_private::Target::GetSuppressStopHooks ( )

inline

Definition at line 1664 of file Target.h.

References m_suppress_stop_hooks.

◆ GetTargetFromContexts()

Target * Target::GetTargetFromContexts	(	const ExecutionContext *	exe_ctx_ptr,
		const SymbolContext *	sc_ptr )

static

Definition at line 2835 of file Target.cpp.

References lldb_private::ExecutionContext::GetTargetPtr(), Target(), and lldb_private::SymbolContext::target_sp.

Referenced by DumpAddressAndContent(), DumpAddressOffsetFromFunction(), lldb_private::FormatEntity::Formatter::Format(), and RunScriptFormatKeyword().

◆ GetTargetSessionName()

llvm::StringRef lldb_private::Target::GetTargetSessionName ( )

inline

Get the target session name for this target.

Provides a meaningful name for IDEs or tools to display for dynamically created targets. Defaults to "Session {ID}" based on the globally unique ID.

Returns: The target session name for this target.

Definition at line 675 of file Target.h.

References m_target_session_name.

◆ GetTrace()

TraceSP Target::GetTrace ( )

Get the Trace object containing processor trace information of this target.

Returns: The trace object. It might be undefined.

Definition at line 3597 of file Target.cpp.

References m_trace_sp.

Referenced by BuildThreadsSection(), and lldb_private::CommandObject::CheckRequirements().

◆ GetTraceOrCreate()

llvm::Expected< TraceSP > Target::GetTraceOrCreate ( )

If a Trace object is present, this returns it, otherwise a new Trace is created with Trace::CreateTrace.

Definition at line 3624 of file Target.cpp.

References CreateTrace(), and m_trace_sp.

◆ GetUserExpressionForLanguage()

UserExpression * Target::GetUserExpressionForLanguage	(	llvm::StringRef	expr,
		llvm::StringRef	prefix,
		SourceLanguage	language,
		Expression::ResultType	desired_type,
		const EvaluateExpressionOptions &	options,
		ValueObject *	ctx_obj,
		Status &	error )

Definition at line 2705 of file Target.cpp.

References lldb_private::SourceLanguage::AsLanguageType(), error(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::SourceLanguage::GetDescription(), lldb_private::Language::GetNameForLanguageType(), and GetScratchTypeSystemForLanguage().

Referenced by lldb_private::UserExpression::Evaluate().

◆ GetWatchpointList()

WatchpointList & lldb_private::Target::GetWatchpointList ( )

inline

Definition at line 927 of file Target.h.

References m_watchpoint_list.

◆ HasLoadedSections()

bool Target::HasLoadedSections ( )

Definition at line 5345 of file Target.cpp.

References GetSectionLoadList(), and lldb_private::SectionLoadList::IsEmpty().

Referenced by BuildModulesSection(), lldb_private::formatters::CXXFunctionPointerSummaryProvider(), CommandObjectSourceList::DoExecute(), lldb_private::SectionList::Dump(), lldb_private::CPPLanguageRuntime::FindLibCppStdFunctionCallableInfo(), lldb_private::ArchitectureMips::GetBreakableLoadAddress(), lldb_private::CommandObjectDisassemble::GetContainingAddressRanges(), CommandObjectSourceInfo::GetSymbolContextsForAddress(), lldb_private::Value::GetValueAsData(), LookupAddressInModule(), CommandObjectTargetModulesList::PrintModule(), ReadAddress(), ResolveAddress(), and DisassemblerLLVMC::SymbolLookup().

◆ IgnoreAllWatchpoints()

bool Target::IgnoreAllWatchpoints ( uint32_t ignore_count )

Definition at line 1438 of file Target.cpp.

References lldb_private::GetLog(), LLDB_LOGF, m_watchpoint_list, ProcessIsValid(), and lldb_private::Watchpoints.

Referenced by CommandObjectWatchpointIgnore::DoExecute().

◆ IgnoreWatchpointByID()

bool Target::IgnoreWatchpointByID	(	lldb::watch_id_t	watch_id,
		uint32_t	ignore_count )

Definition at line 1509 of file Target.cpp.

References lldb_private::GetLog(), LLDB_LOGF, m_watchpoint_list, ProcessIsValid(), and lldb_private::Watchpoints.

Referenced by CommandObjectWatchpointIgnore::DoExecute().

◆ ImageSearchPathsChanged()

void Target::ImageSearchPathsChanged	(	const PathMappingList &	path_list,
		void *	baton )

staticprotected

Definition at line 2606 of file Target.cpp.

References lldb_private::eLoadDependentsYes, GetExecutableModule(), SetExecutableModule(), and Target().

Referenced by Target().

◆ Install()

Status Target::Install ( ProcessLaunchInfo * launch_info )

Definition at line 3294 of file Target.cpp.

References error(), GetExecutableModule(), GetImages(), GetPlatform(), installExecutable(), and lldb_private::Modules.

Referenced by lldb_private::Process::LaunchPrivate().

◆ InvalidateThreadFrameProviders()

void Target::InvalidateThreadFrameProviders ( )

protected

Invalidate all potentially cached frame providers for all threads and trigger a stack changed event for all threads.

Definition at line 3775 of file Target.cpp.

References lldb_private::Thread::eBroadcastBitStackChanged, and GetProcessSP().

Referenced by AddScriptedFrameProviderDescriptor(), ClearScriptedFrameProviderDescriptors(), and RemoveScriptedFrameProviderDescriptor().

◆ IsDummyTarget()

bool lldb_private::Target::IsDummyTarget ( ) const

inline

Definition at line 643 of file Target.h.

References m_is_dummy_target.

Referenced by CommandObjectBreakpointAddAddress::DoExecute().

◆ IsValid()

bool lldb_private::Target::IsValid ( )

inline

Definition at line 763 of file Target.h.

References m_valid.

Referenced by lldb_private::TypeSystemClang::CreateInstance().

◆ Launch()

Status Target::Launch	(	ProcessLaunchInfo &	launch_info,
		Stream *	stream )

Definition at line 3427 of file Target.cpp.

Referenced by CommandObjectProcessLaunch::DoExecute().

◆ LoadScriptingResources()

bool lldb_private::Target::LoadScriptingResources	(	std::list< Status > &	errors,
		Stream &	feedback_stream,
		bool	continue_on_error = true )

inline

Definition at line 1117 of file Target.h.

References m_images.

◆ MergeArchitecture()

bool Target::MergeArchitecture ( const ArchSpec & arch_spec )

Definition at line 1796 of file Target.cpp.

References lldb_private::GetLog(), lldb_private::ArchSpec::GetTriple(), lldb_private::ArchSpec::IsValid(), LLDB_LOGF, m_arch, lldb_private::ArchSpec::MergeFrom(), SetArchitecture(), and lldb_private::Target.

Referenced by lldb_private::process_gdb_remote::ProcessGDBRemote::DoLaunch(), lldb_private::minidump::ProcessMinidump::DoLoadCore(), and lldb_private::process_gdb_remote::ProcessGDBRemote::GetGDBServerRegisterInfoXMLAndProcess().

◆ ModuleIsExcludedForUnconstrainedSearches() [1/2]

bool Target::ModuleIsExcludedForUnconstrainedSearches ( const FileSpec & module_spec )

Return whether this FileSpec corresponds to a module that should be considered for general searches.

This API will be consulted by the SearchFilterForUnconstrainedSearches and any module that returns true will not be searched. Note the SearchFilterForUnconstrainedSearches is the search filter that gets used in the CreateBreakpoint calls when no modules is provided.

The target call at present just consults the Platform's call of the same name.

Parameters

[in] module_spec Path to the module.

Returns: true if the module should be excluded, false otherwise.

Definition at line 1938 of file Target.cpp.

References lldb_private::ModuleList::FindModules(), lldb_private::TargetProperties::GetBreakpointsConsultPlatformAvoidList(), GetImages(), lldb_private::ModuleList::GetModuleAtIndex(), lldb_private::ModuleList::GetSize(), and ModuleIsExcludedForUnconstrainedSearches().

Referenced by ModuleIsExcludedForUnconstrainedSearches().

◆ ModuleIsExcludedForUnconstrainedSearches() [2/2]

bool Target::ModuleIsExcludedForUnconstrainedSearches ( const lldb::ModuleSP & module_sp )

Return whether this module should be considered for general searches.

This API will be consulted by the SearchFilterForUnconstrainedSearches and any module that returns true will not be searched. Note the SearchFilterForUnconstrainedSearches is the search filter that gets used in the CreateBreakpoint calls when no modules is provided.

The target call at present just consults the Platform's call of the same name.

FIXME: When we get time we should add a way for the user to set modules that they don't want searched, in addition to or instead of the platform ones.

Parameters

[in] module_sp A shared pointer reference to the module that checked.

Returns: true if the module should be excluded, false otherwise.

Definition at line 1960 of file Target.cpp.

References lldb_private::TargetProperties::GetBreakpointsConsultPlatformAvoidList(), and m_platform_sp.

◆ ModulesDidLoad()

void Target::ModulesDidLoad ( ModuleList & module_list )

This call may preload module symbols, and may do so in parallel depending on the following target settings:

Warning: if preloading is active and this is called in parallel with Target::GetOrCreateModule, this may result in a ABBA deadlock situation.

Definition at line 1859 of file Target.cpp.

References lldb_private::Broadcaster::BroadcastEvent(), eBroadcastBitModulesLoaded, lldb_private::ModuleList::GetModuleAtIndex(), lldb_private::TargetProperties::GetParallelModuleLoad(), lldb_private::TargetProperties::GetPreloadSymbols(), lldb_private::ModuleList::GetSize(), lldb_private::LoadFormattersForModule(), LoadScriptingResourceForModule(), lldb_private::LoadTypeSummariesForModule(), m_breakpoint_list, m_internal_breakpoint_list, m_process_sp, m_valid, and lldb_private::ModuleList::PreloadSymbols().

Referenced by CommandObjectTargetModulesLoad::DoExecute(), lldb_private::ScriptedProcess::GetLoadedDynamicLibrariesInfos(), DynamicLoaderStatic::LoadAllImagesAtFileAddresses(), lldb_private::DynamicLoader::LoadBinaryWithUUIDAndAddress(), ObjectFileMachO::LoadCoreFileImages(), DynamicLoaderDarwinKernel::KextImageInfo::LoadImageUsingMemoryModule(), DynamicLoaderPOSIXDYLD::LoadInterpreterModule(), NotifyModuleAdded(), DynamicLoaderMacOSXDYLD::ReadDYLDInfoFromMemoryAndSetNotificationCallback(), JITLoaderGDB::ReadJITDescriptorImpl(), SetExecutableModule(), and ProcessFreeBSDKernelCore::SetKernelDisplacement().

◆ ModulesDidUnload()

void Target::ModulesDidUnload	(	ModuleList &	module_list,
		bool	delete_locations )

Definition at line 1898 of file Target.cpp.

References lldb_private::ModuleList::AnyOf(), lldb_private::Broadcaster::BroadcastEvent(), eBroadcastBitModulesUnloaded, lldb_private::ModuleList::GetSize(), m_breakpoint_list, m_internal_breakpoint_list, m_scratch_type_system_map, m_valid, and UnloadModuleSections().

Referenced by ClearModules(), NotifyModuleRemoved(), and NotifyModulesRemoved().

◆ NotifyBreakpointChanged() [1/2]

void Target::NotifyBreakpointChanged	(	Breakpoint &	bp,
		const lldb::EventDataSP &	breakpoint_data_sp )

Sends a breakpoint notification event.

Definition at line 5367 of file Target.cpp.

References lldb_private::Broadcaster::BroadcastEvent(), eBroadcastBitBreakpointChanged, and lldb_private::Broadcaster::EventTypeHasListeners().

◆ NotifyBreakpointChanged() [2/2]

void Target::NotifyBreakpointChanged	(	Breakpoint &	bp,
		lldb::BreakpointEventType	event_kind )

Sends a breakpoint notification event.

Definition at line 5357 of file Target.cpp.

References lldb_private::Broadcaster::BroadcastEvent(), eBroadcastBitBreakpointChanged, and lldb_private::Broadcaster::EventTypeHasListeners().

Referenced by lldb_private::Breakpoint::SendBreakpointChangedEvent(), and lldb_private::Breakpoint::SendBreakpointChangedEvent().

◆ NotifyModuleAdded()

void Target::NotifyModuleAdded	(	const ModuleList &	module_list,
		const lldb::ModuleSP &	module_sp )

overrideprotectedvirtual

Implementing of ModuleList::Notifier.

Implements lldb_private::ModuleList::Notifier.

Definition at line 1823 of file Target.cpp.

References lldb_private::ModuleList::Append(), m_valid, and ModulesDidLoad().

◆ NotifyModuleRemoved()

void Target::NotifyModuleRemoved	(	const ModuleList &	module_list,
		const lldb::ModuleSP &	module_sp )

overrideprotectedvirtual

Implements lldb_private::ModuleList::Notifier.

Definition at line 1833 of file Target.cpp.

References lldb_private::ModuleList::Append(), m_valid, and ModulesDidUnload().

◆ NotifyModulesRemoved()

void Target::NotifyModulesRemoved ( lldb_private::ModuleList & module_list )

overrideprotectedvirtual

Implements lldb_private::ModuleList::Notifier.

Definition at line 1855 of file Target.cpp.

References ModulesDidUnload().

◆ NotifyModuleUpdated()

void Target::NotifyModuleUpdated	(	const ModuleList &	module_list,
		const lldb::ModuleSP &	old_module_sp,
		const lldb::ModuleSP &	new_module_sp )

overrideprotectedvirtual

Implements lldb_private::ModuleList::Notifier.

Definition at line 1843 of file Target.cpp.

References m_breakpoint_list, m_internal_breakpoint_list, and m_valid.

◆ NotifyWillClearList()

void Target::NotifyWillClearList ( const ModuleList & module_list )

overrideprotectedvirtual

Implements lldb_private::ModuleList::Notifier.

Definition at line 1821 of file Target.cpp.

◆ operator=()

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

protecteddelete

References Target().

◆ PrimeFromDummyTarget()

void Target::PrimeFromDummyTarget ( Target & target )

protected

Definition at line 220 of file Target.cpp.

References AddBreakpoint(), AddBreakpointName(), lldb_private::BreakpointList::Breakpoints(), lldb_private::Breakpoint::CopyFromBreakpoint(), m_breakpoint_list, m_breakpoint_names, m_dummy_signals, m_frame_recognizer_manager_up, m_internal_stop_hooks, m_stop_hook_next_id, m_stop_hooks, and Target().

◆ PrintDummySignals()

void Target::PrintDummySignals	(	Stream &	strm,
		Args &	signals )

Print all the signals set in this target.

Definition at line 3963 of file Target.cpp.

References lldb_private::eLazyBoolCalculate, lldb_private::eLazyBoolNo, lldb_private::eLazyBoolYes, lldb_private::Args::GetArgumentAtIndex(), lldb_private::Args::GetArgumentCount(), m_dummy_signals, and lldb_private::Stream::Printf().

Referenced by CommandObjectProcessHandle::DoExecute().

◆ ProcessIsValid()

bool Target::ProcessIsValid ( )

protected

Definition at line 931 of file Target.cpp.

References m_process_sp.

Referenced by CreateWatchpoint(), DisableAllWatchpoints(), DisableWatchpointByID(), EnableAllWatchpoints(), EnableWatchpointByID(), IgnoreAllWatchpoints(), IgnoreWatchpointByID(), ReadMemory(), and RemoveAllWatchpoints().

◆ ReadCStringFromMemory() [1/2]

size_t Target::ReadCStringFromMemory	(	const Address &	addr,
		char *	dst,
		size_t	dst_max_len,
		Status &	result_error,
		bool	force_live_memory = false )

Definition at line 2153 of file Target.cpp.

References lldb_private::Status::Clear(), error(), lldb_private::Status::FromErrorString(), lldb_private::Address::GetLoadAddress(), and ReadMemory().

◆ ReadCStringFromMemory() [2/2]

size_t Target::ReadCStringFromMemory	(	const Address &	addr,
		std::string &	out_str,
		Status &	error,
		bool	force_live_memory = false )

Definition at line 2130 of file Target.cpp.

References error(), lldb_private::Address::GetLoadAddress(), and ReadCStringFromMemory().

Referenced by CommandObjectMemoryRead::DoExecute(), ReadCStringFromMemory(), and lldb_private::InstrumentationRuntimeMainThreadChecker::RetrieveReportData().

◆ ReadInstructions()

llvm::Expected< lldb::DisassemblerSP > Target::ReadInstructions	(	const Address &	start_addr,
		uint32_t	count,
		const char *	flavor_string = nullptr )

Definition at line 3011 of file Target.cpp.

References lldb_private::Disassembler::DisassembleBytes(), error(), GetArchitecture(), lldb_private::WritableDataBuffer::GetBytes(), lldb_private::DataBufferHeap::GetByteSize(), lldb_private::TargetProperties::GetDisassemblyCPU(), lldb_private::TargetProperties::GetDisassemblyFeatures(), lldb_private::TargetProperties::GetDisassemblyFlavor(), lldb_private::Address::GetLoadAddress(), lldb_private::ArchSpec::GetTriple(), LLDB_INVALID_ADDRESS, and ReadMemory().

Referenced by lldb_private::BreakpointResolver::AddLocation().

◆ ReadMemory()

size_t Target::ReadMemory	(	const Address &	addr,
		void *	dst,
		size_t	dst_len,
		Status &	error,
		bool	force_live_memory = false,
		lldb::addr_t *	load_addr_ptr = nullptr,
		bool *	did_read_live_memory = nullptr )

virtual

Definition at line 2004 of file Target.cpp.

References error(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::Status::FromErrorStringWithFormatv(), lldb_private::Address::GetFileAddress(), lldb_private::Address::GetLoadAddress(), lldb_private::Address::GetModule(), lldb_private::Address::GetOffset(), lldb_private::Address::GetSection(), GetSectionLoadList(), lldb_private::SectionLoadList::IsEmpty(), lldb_private::Address::IsSectionOffset(), lldb_private::Address::IsValid(), LLDB_INVALID_ADDRESS, m_images, m_process_sp, ProcessIsValid(), ReadMemoryFromFileCache(), lldb_private::SectionLoadList::ResolveLoadAddress(), and lldb_private::Address::SetLoadAddress().

Referenced by lldb_private::Disassembler::AppendInstructions(), CommandObjectMemoryRead::DoExecute(), lldb_private::DWARFExpression::Evaluate(), Evaluate_DW_OP_deref_size(), UnwindAssembly_x86::FirstNonPrologueInsn(), UnwindAssembly_x86::GetFastUnwindPlan(), lldb_private::ValueObject::GetPointeeData(), lldb_private::DynamicLoaderDarwin::GetThreadLocalData(), lldb_private::Value::GetValueAsData(), ReadCStringFromMemory(), ReadInstructions(), ReadScalarIntegerFromMemory(), ReadStringFromMemory(), and EmulateInstructionMIPS::SetInstruction().

◆ ReadMemoryFromFileCache()

size_t Target::ReadMemoryFromFileCache	(	const Address &	addr,
		void *	dst,
		size_t	dst_len,
		Status &	error )

Definition at line 1970 of file Target.cpp.

References error(), lldb_private::Status::FromErrorString(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::Address::GetOffset(), lldb_private::Address::GetSection(), and lldb_private::ObjectFile::ReadSectionData().

Referenced by lldb_private::ProcessTrace::DoReadMemory(), and ReadMemory().

◆ ReadPointerFromMemory()

bool Target::ReadPointerFromMemory	(	const Address &	addr,
		Status &	error,
		Address &	pointer_addr,
		bool	force_live_memory = false )

Definition at line 2322 of file Target.cpp.

References error(), GetSectionLoadList(), lldb_private::SectionLoadList::IsEmpty(), lldb_private::Address::IsValid(), LLDB_INVALID_ADDRESS, m_arch, m_images, ReadScalarIntegerFromMemory(), lldb_private::SectionLoadList::ResolveLoadAddress(), lldb_private::Address::SetOffset(), and lldb_private::Scalar::ULongLong().

Referenced by ObjectFileELF::GetImageInfoAddress().

◆ ReadScalarIntegerFromMemory()

size_t Target::ReadScalarIntegerFromMemory	(	const Address &	addr,
		uint32_t	byte_size,
		bool	is_signed,
		Scalar &	scalar,
		Status &	error,
		bool	force_live_memory = false )

Definition at line 2269 of file Target.cpp.

References error(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::DataExtractor::GetMaxU32(), lldb_private::DataExtractor::GetMaxU64(), m_arch, lldb_private::Scalar::MakeSigned(), ReadMemory(), and lldb_private::Scalar::SignExtend().

Referenced by ReadPointerFromMemory(), ReadSignedIntegerFromMemory(), and ReadUnsignedIntegerFromMemory().

◆ ReadSignedIntegerFromMemory()

int64_t Target::ReadSignedIntegerFromMemory	(	const Address &	addr,
		size_t	integer_byte_size,
		int64_t	fail_value,
		Status &	error,
		bool	force_live_memory = false )

Definition at line 2300 of file Target.cpp.

References error(), ReadScalarIntegerFromMemory(), and lldb_private::Scalar::SLongLong().

Referenced by lldb_private::ItaniumABIRuntime::GetDynamicTypeAndAddress().

◆ ReadStringFromMemory()

size_t Target::ReadStringFromMemory	(	const Address &	addr,
		char *	dst,
		size_t	max_bytes,
		Status &	error,
		size_t	type_width,
		bool	force_live_memory = true )

Read a NULL terminated string from memory.

This function will read a cache page at a time until a NULL string terminator is found. It will stop reading if an aligned sequence of NULL termination type_width bytes is not found before reading cstr_max_len bytes. The results are always guaranteed to be NULL terminated, and that no more than (max_bytes - type_width) bytes will be read.

Parameters

[in]	addr	The address to start the memory read.
[in]	dst	A character buffer containing at least max_bytes.
[in]	max_bytes	The maximum number of bytes to read.
[in]	error	The error status of the read operation.
[in]	type_width	The size of the null terminator (1 to 4 bytes per character). Defaults to 1.

Returns: The error status or the number of bytes prior to the null terminator.

Definition at line 2220 of file Target.cpp.

References error(), GetReasonableReadSize(), ReadMemory(), and lldb_private::Address::Slide().

◆ ReadUnsignedIntegerFromMemory()

uint64_t Target::ReadUnsignedIntegerFromMemory	(	const Address &	addr,
		size_t	integer_byte_size,
		uint64_t	fail_value,
		Status &	error,
		bool	force_live_memory = false )

Definition at line 2311 of file Target.cpp.

References error(), ReadScalarIntegerFromMemory(), and lldb_private::Scalar::ULongLong().

Referenced by DYLDRendezvous::FindMetadata(), and ObjectFileELF::GetImageInfoAddress().

◆ RegisterInternalStopHooks()

void lldb_private::Target::RegisterInternalStopHooks ( )

◆ RemoveAllBreakpoints()

void Target::RemoveAllBreakpoints ( bool internal_also = false )

Definition at line 1061 of file Target.cpp.

References lldb_private::Breakpoints, lldb_private::GetLog(), LLDB_LOGF, m_breakpoint_list, m_internal_breakpoint_list, and m_last_created_breakpoint.

◆ RemoveAllowedBreakpoints()

void Target::RemoveAllowedBreakpoints ( )

Definition at line 1052 of file Target.cpp.

References lldb_private::Breakpoints, lldb_private::GetLog(), LLDB_LOGF, m_breakpoint_list, and m_last_created_breakpoint.

Referenced by CommandObjectBreakpointDelete::DoExecute().

◆ RemoveAllStopHooks()

void Target::RemoveAllStopHooks ( )

Definition at line 3082 of file Target.cpp.

References m_stop_hooks.

◆ RemoveAllWatchpoints()

bool Target::RemoveAllWatchpoints ( bool end_to_end = true )

Definition at line 1327 of file Target.cpp.

References lldb_private::Status::Fail(), lldb_private::GetLog(), LLDB_LOGF, m_last_created_watchpoint, m_process_sp, m_watchpoint_list, ProcessIsValid(), and lldb_private::Watchpoints.

Referenced by CommandObjectWatchpointDelete::DoExecute().

◆ RemoveBreakpointByID()

bool Target::RemoveBreakpointByID ( lldb::break_id_t break_id )

Definition at line 1107 of file Target.cpp.

References lldb_private::Breakpoints, DisableBreakpointByID(), lldb_private::GetLog(), LLDB_BREAK_ID_IS_INTERNAL, LLDB_LOGF, m_breakpoint_list, m_internal_breakpoint_list, and m_last_created_breakpoint.

Referenced by lldb_private::ThreadPlanStepUntil::Clear(), lldb_private::ThreadPlanStepRange::ClearNextBranchBreakpoint(), CopyOverBreakpointOptions(), CommandObjectBreakpointAddException::DoExecute(), CommandObjectBreakpointAddScripted::DoExecute(), CommandObjectBreakpointClear::DoExecute(), CommandObjectBreakpointDelete::DoExecute(), CommandObjectBreakpointSet::DoExecute(), lldb_private::ThreadPlanRunToAddress::MischiefManaged(), lldb_private::ThreadPlanStepOut::MischiefManaged(), DynamicLoaderPOSIXDYLD::SetRendezvousBreakpoint(), lldb_private::AppleThreadPlanStepThroughDirectDispatch::~AppleThreadPlanStepThroughDirectDispatch(), lldb_private::ThreadPlanRunToAddress::~ThreadPlanRunToAddress(), and lldb_private::ThreadPlanStepOut::~ThreadPlanStepOut().

◆ RemoveNameFromBreakpoint()

void Target::RemoveNameFromBreakpoint	(	lldb::BreakpointSP &	bp_sp,
		ConstString	name )

Definition at line 896 of file Target.cpp.

References lldb_private::ConstString::AsCString().

Referenced by CommandObjectBreakpointNameDelete::DoExecute().

◆ RemoveScriptedFrameProviderDescriptor()

bool Target::RemoveScriptedFrameProviderDescriptor ( uint32_t id )

Remove a scripted frame provider descriptor by id.

Parameters

[in] id The id of the descriptor to remove.

Returns: True if a descriptor was removed, false if no descriptor with that id existed.

Definition at line 3745 of file Target.cpp.

References InvalidateThreadFrameProviders(), m_frame_provider_descriptors, and m_frame_provider_descriptors_mutex.

Referenced by CommandObjectTargetFrameProviderRemove::DoExecute().

◆ RemoveStopHookByID()

bool Target::RemoveStopHookByID ( lldb::user_id_t uid )

Definition at line 3077 of file Target.cpp.

References m_stop_hooks.

Referenced by UndoCreateStopHook().

◆ RemoveWatchpointByID()

bool Target::RemoveWatchpointByID ( lldb::watch_id_t watch_id )

Definition at line 1493 of file Target.cpp.

References DisableWatchpointByID(), lldb_private::GetLog(), LLDB_LOGF, m_last_created_watchpoint, m_watchpoint_list, and lldb_private::Watchpoints.

Referenced by CommandObjectWatchpointDelete::DoExecute().

◆ ReportStatistics()

llvm::json::Value Target::ReportStatistics ( const lldb_private::StatisticsOptions & options )

Get metrics associated with this target in JSON format.

Target metrics help measure timings and information that is contained in a target. These are designed to help measure performance of a debug session as well as represent the current state of the target, like information on the currently modules, currently set breakpoints and more.

Returns: Returns a JSON value that contains all target metrics.

Definition at line 5339 of file Target.cpp.

References m_stats.

◆ ResetBreakpointHitCounts()

void Target::ResetBreakpointHitCounts ( )

Resets the hit count of all breakpoints.

Definition at line 1164 of file Target.cpp.

References GetBreakpointList(), and lldb_private::BreakpointList::ResetHitCounts().

Referenced by CleanupProcess().

◆ ResetSignalFromDummy()

bool Target::ResetSignalFromDummy	(	lldb::UnixSignalsSP	signals_sp,
		const DummySignalElement &	element )

staticprotected

Definition at line 3911 of file Target.cpp.

References lldb_private::eLazyBoolCalculate, and LLDB_INVALID_SIGNAL_NUMBER.

Referenced by ClearDummySignals().

◆ ResetStatistics()

void Target::ResetStatistics ( )

Definition at line 5343 of file Target.cpp.

References m_stats.

Referenced by lldb_private::DebuggerStats::ResetStatistics().

◆ ResolveFileAddress()

bool Target::ResolveFileAddress	(	lldb::addr_t	load_addr,
		Address &	so_addr )

Definition at line 3328 of file Target.cpp.

References m_images.

Referenced by lldb_private::ArchitectureMips::GetBreakableLoadAddress().

◆ ResolveLoadAddress()

bool Target::ResolveLoadAddress	(	lldb::addr_t	load_addr,
		Address &	so_addr,
		uint32_t	stop_id = SectionLoadHistory::eStopIDNow,
		bool	allow_section_end = false )

Definition at line 3322 of file Target.cpp.

References m_section_load_history.

Referenced by lldb_private::formatters::CXXFunctionPointerSummaryProvider(), lldb_private::StopInfoMachException::DeterminePtrauthFailure(), CommandObjectSourceList::DoExecute(), CommandObjectTargetModulesShowUnwind::DoExecute(), lldb_private::ProcessTrace::DoReadMemory(), CommandObjectMemoryRegion::DumpRegion(), CommandObjectRegisterRead::DumpRegister(), lldb_private::CPPLanguageRuntime::FindLibCppStdFunctionCallableInfo(), lldb::SBBreakpoint::FindLocationByAddress(), lldb::SBBreakpoint::FindLocationIDByAddress(), lldb_private::ArchitectureMips::GetBreakableLoadAddress(), lldb_private::IndirectCallEdge::GetCallee(), lldb_private::CommandObjectDisassemble::GetContainingAddressRanges(), getModuleFileSize(), lldb_private::AppleObjCTrampolineHandler::GetStepThroughDispatchPlan(), CommandObjectSourceInfo::GetSymbolContextsForAddress(), lldb_private::DynamicLoaderDarwin::GetThreadLocalData(), lldb_private::Value::GetValueAsData(), lldb_private::ItaniumABIRuntime::GetVTableInfo(), line_entry_helper(), LookupAddressInModule(), ReadAddress(), ResolveAddress(), lldb_private::Address::SetLoadAddress(), lldb_private::ThreadPlanStepInRange::ShouldStop(), and DisassemblerLLVMC::SymbolLookup().

◆ RunStopHooks()

bool Target::RunStopHooks ( bool at_initial_stop = false )

◆ SaveScriptedLaunchInfo()

void Target::SaveScriptedLaunchInfo ( lldb_private::ProcessInfo & process_info )

Definition at line 3416 of file Target.cpp.

References GetGlobalProperties(), lldb_private::TargetProperties::GetProcessLaunchInfo(), lldb_private::ProcessInfo::GetScriptedMetadata(), lldb_private::ProcessInfo::IsScriptedProcess(), lldb_private::TargetProperties::SetProcessLaunchInfo(), lldb_private::ProcessLaunchInfo::SetProcessPluginName(), and lldb_private::ProcessInfo::SetScriptedMetadata().

Referenced by Attach(), and Launch().

◆ SerializeBreakpointsToFile()

Status Target::SerializeBreakpointsToFile	(	const FileSpec &	file,
		const BreakpointIDList &	bp_ids,
		bool	append )

Definition at line 1168 of file Target.cpp.

References lldb_private::StructuredData::Array::AddItem(), lldb_private::StructuredData::Object::Dump(), lldb_private::File::eOpenOptionCanCreate, lldb_private::File::eOpenOptionCloseOnExec, lldb_private::File::eOpenOptionTruncate, lldb_private::File::eOpenOptionWriteOnly, error(), lldb_private::Status::FromErrorString(), lldb_private::Status::FromErrorStringWithFormat(), lldb_private::BreakpointList::GetBreakpointAtIndex(), GetBreakpointByID(), lldb_private::BreakpointID::GetBreakpointID(), lldb_private::BreakpointIDList::GetBreakpointIDAtIndex(), GetBreakpointList(), lldb_private::StreamFile::GetFile(), lldb_private::BreakpointList::GetListMutex(), lldb_private::FileSpec::GetPath(), lldb_private::BreakpointIDList::GetSize(), lldb_private::BreakpointList::GetSize(), lldb_private::File::IsValid(), LLDB_INVALID_BREAK_ID, lldb_private::StructuredData::ParseJSONFromFile(), lldb_private::Stream::PutChar(), and lldb_private::Breakpoint::SerializeToStructuredData().

Referenced by CommandObjectBreakpointWrite::DoExecute().

◆ SetAllStopHooksActiveState()

void Target::SetAllStopHooksActiveState ( bool active_state )

Definition at line 3105 of file Target.cpp.

References m_stop_hooks.

Referenced by CommandObjectTargetStopHookEnableDisable::DoExecute().

◆ SetArchitecture()

bool Target::SetArchitecture	(	const ArchSpec &	arch_spec,
		bool	set_platform = false,
		bool	merge = true )

Set the architecture for this target.

If the current target has no Images read in, then this just sets the architecture, which will be used to select the architecture of the ExecutableModule when that is set. If the current target has an ExecutableModule, then calling SetArchitecture with a different architecture from the currently selected one will reset the ExecutableModule to that slice of the file backing the ExecutableModule. If the file backing the ExecutableModule does not contain a fork of this architecture, then this code will return false, and the architecture won't be changed. If the input arch_spec is the same as the already set architecture, this is a no-op.

Parameters

[in]	arch_spec	The new architecture.
[in]	set_platform	If true, then the platform will be adjusted if the currently selected platform is not compatible with the architecture being set. If false, then just the architecture will be set even if the currently selected platform isn't compatible (in case it might be manually set following this function call).
[in]	merged	If true, arch_spec is merged with the current architecture. Otherwise it's replaced.

Returns: true if the architecture was successfully set, false otherwise.

Definition at line 1705 of file Target.cpp.

References ClearModules(), lldb_private::ArchSpec::CompatibleMatch, lldb_private::eLoadDependentsYes, error(), lldb_private::ArchSpec::GetArchitectureName(), GetDebugger(), GetExecutableModule(), lldb_private::GetLog(), GetPlatform(), lldb_private::ModuleList::GetSharedModule(), lldb_private::ArchSpec::GetTriple(), lldb_private::ArchSpec::IsValid(), LLDB_LOG, LLDB_LOGF, m_arch, lldb_private::ArchSpec::MergeFrom(), SetExecutableModule(), SetPlatform(), lldb_private::ModuleSpec::SetTarget(), and lldb_private::Target.

Referenced by DynamicLoaderDarwinKernel::CheckForKernelImageAtAddress(), DynamicLoaderFreeBSDKernel::CheckForKernelImageAtAddress(), lldb_private::Process::CompleteAttach(), lldb_private::process_gdb_remote::ProcessGDBRemote::DidLaunchOrAttach(), lldb_private::process_gdb_remote::ProcessGDBRemote::DoConnectRemote(), ProcessKDP::DoConnectRemote(), lldb_private::minidump::ProcessMinidump::DoLoadCore(), ProcessElfCore::DoLoadCore(), ProcessMachCore::DoLoadCore(), ProcessMachCore::LoadBinariesViaExhaustiveSearch(), lldb_private::DynamicLoader::LoadBinaryWithUUIDAndAddress(), MergeArchitecture(), lldb_private::process_gdb_remote::ProcessGDBRemote::ParsePythonTargetDefinition(), DynamicLoaderDarwinKernel::KextImageInfo::ReadMemoryModule(), DynamicLoaderFreeBSDKernel::KModImageInfo::ReadMemoryModule(), and lldb_private::DynamicLoaderDarwin::UpdateSpecialBinariesFromPreloadedModules().

◆ SetDefaultArchitecture()

void Target::SetDefaultArchitecture ( const ArchSpec & arch )

static

Definition at line 2811 of file Target.cpp.

References lldb_private::ArchSpec::GetArchitectureName(), GetGlobalProperties(), lldb_private::GetLog(), lldb_private::ArchSpec::GetTriple(), LLDB_LOG, lldb_private::TargetProperties::SetDefaultArchitecture(), and lldb_private::Target.

Referenced by lldb::SBDebugger::SetDefaultArchitecture().

◆ SetExecutableModule()

void Target::SetExecutableModule	(	lldb::ModuleSP &	module_sp,
		LoadDependentFiles	load_dependent_files = eLoadDependentsDefault )

Set the main executable module.

Each process has a notion of a main executable that is the file that will be executed or attached to. Executable files can have dependent modules that are discovered from the object files, or discovered at runtime as things are dynamically loaded.

Setting the executable causes any of the current dependent image information to be cleared and replaced with the static dependent image information found by calling ObjectFile::GetDependentModules (FileSpecList&) on the main executable and any modules on which it depends. Calling Process::GetImages() will return the newly found images that were obtained from all of the object files.

Parameters

[in]	module_sp	A shared pointer reference to the module that will become the main executable for this process.
[in]	load_dependent_files	If true then ask the object files to track down any known dependent files.

See also: ObjectFile::GetDependentModules (FileSpecList&); Process::GetImages()

Definition at line 1576 of file Target.cpp.

References lldb_private::ModuleList::AppendIfNeeded(), lldb_private::FileSpecList::AppendIfUnique(), ClearModules(), lldb_private::telemetry::ScopedDispatcher< Info >::DispatchNow(), lldb_private::telemetry::ScopedDispatcher< Info >::DispatchOnExit(), elapsed(), lldb_private::eLoadDependentsDefault, lldb_private::eLoadDependentsNo, lldb_private::eLoadDependentsYes, lldb_private::telemetry::ExecutableModuleInfo::exec_mod, lldb_private::ObjectFile::GetDependentModules(), lldb_private::FileSpecList::GetFileSpecAtIndex(), lldb_private::GetLog(), GetOrCreateModule(), GetProcessSP(), lldb_private::FileSpecList::GetSize(), lldb_private::Debugger::GetThreadPool(), lldb_private::telemetry::ExecutableModuleInfo::is_start_entry, LLDB_INVALID_PROCESS_ID, LLDB_LOG, LLDB_SCOPED_TIMERF, m_arch, m_debugger, m_images, m_platform_sp, m_stats, ModulesDidLoad(), lldb_private::telemetry::ExecutableModuleInfo::pid, lldb_private::Target, lldb_private::telemetry::ExecutableModuleInfo::triple, and lldb_private::telemetry::ExecutableModuleInfo::uuid.

Referenced by lldb_private::Process::CompleteAttach(), ProcessKDP::DoConnectRemote(), ProcessElfCore::DoLoadCore(), DynamicLoaderHexagonDYLD::GetTargetExecutable(), lldb_private::DynamicLoader::GetTargetExecutable(), ImageSearchPathsChanged(), lldb_private::process_gdb_remote::ProcessGDBRemote::LoadModules(), lldb_private::ProcessWindows::OnDebuggerConnected(), lldb_private::minidump::ProcessMinidump::ReadModuleList(), SetArchitecture(), and lldb_private::DynamicLoaderDarwin::UpdateSpecialBinariesFromPreloadedModules().

◆ SetLabel()

llvm::Error Target::SetLabel ( llvm::StringRef label )

Set a label for a target.

The label cannot be used by another target or be only integral.

Returns: The label for this target or an error if the label didn't match the requirements.

Definition at line 2818 of file Target.cpp.

References GetDebugger(), lldb_private::TargetList::GetNumTargets(), lldb_private::TargetList::GetTargetAtIndex(), lldb_private::Debugger::GetTargetList(), LLDB_INVALID_INDEX32, m_label, and TargetList.

◆ SetPlatform()

void lldb_private::Target::SetPlatform ( const lldb::PlatformSP & platform_sp )

inline

Definition at line 1680 of file Target.h.

References m_platform_sp.

Referenced by Attach(), lldb_private::Process::CompleteAttach(), DynamicLoaderDarwinKernel::DynamicLoaderDarwinKernel(), and SetArchitecture().

◆ SetREPL()

void Target::SetREPL	(	lldb::LanguageType	language,
		lldb::REPLSP	repl_sp )

Definition at line 366 of file Target.cpp.

References lldbassert, and m_repl_map.

Referenced by lldb_private::ClangREPL::CreateInstance().

◆ SetSectionLoadAddress()

bool Target::SetSectionLoadAddress	(	const lldb::SectionSP &	section,
		lldb::addr_t	load_addr,
		bool	warn_multiple = false )

Definition at line 3333 of file Target.cpp.

References lldb_private::SectionLoadHistory::eStopIDNow, GetProcessSP(), and m_section_load_history.

Referenced by CommandObjectTargetModulesLoad::DoExecute(), ObjectFileMachO::LoadCoreFileImages(), DynamicLoaderDarwinKernel::KextImageInfo::LoadImageUsingMemoryModule(), DynamicLoaderFreeBSDKernel::KModImageInfo::LoadImageUsingMemoryModule(), lldb_private::ObjectFileJIT::SetLoadAddress(), lldb_private::ObjectFileJSON::SetLoadAddress(), lldb_private::wasm::ObjectFileWasm::SetLoadAddress(), ObjectFileELF::SetLoadAddress(), ObjectFileMachO::SetLoadAddress(), ObjectFilePECOFF::SetLoadAddress(), ObjectFilePlaceholder::SetLoadAddress(), DynamicLoaderHexagonDYLD::UpdateLoadedSections(), and updateSectionLoadAddress().

◆ SetSectionUnloaded() [1/2]

bool Target::SetSectionUnloaded ( const lldb::SectionSP & section_sp )

Definition at line 3382 of file Target.cpp.

References GetProcessSP(), and m_section_load_history.

Referenced by JITLoaderGDB::ReadJITDescriptorImpl(), DynamicLoaderHexagonDYLD::UnloadSections(), and lldb_private::DynamicLoader::UnloadSectionsCommon().

◆ SetSectionUnloaded() [2/2]

bool Target::SetSectionUnloaded	(	const lldb::SectionSP &	section_sp,
		lldb::addr_t	load_addr )

Definition at line 3392 of file Target.cpp.

References GetProcessSP(), and m_section_load_history.

◆ SetStopHookActiveStateByID()

bool Target::SetStopHookActiveStateByID	(	lldb::user_id_t	uid,
		bool	active_state )

Definition at line 3094 of file Target.cpp.

References m_stop_hooks.

Referenced by CommandObjectTargetStopHookEnableDisable::DoExecute().

◆ SetSuppresStopHooks()

bool lldb_private::Target::SetSuppresStopHooks ( bool suppress )

inline

Definition at line 1658 of file Target.h.

References m_suppress_stop_hooks.

◆ SetTargetSessionName()

void lldb_private::Target::SetTargetSessionName ( llvm::StringRef target_session_name )

inline

Set the target session name for this target.

This should typically be set along with the event eBroadcastBitNewTargetCreated. Useful for scripts or triggers that automatically create targets and want to provide meaningful names that IDEs or other tools can display to help users identify the origin and purpose of each target.

Parameters

[in] target_session_name The target session name to set for this target.

Definition at line 687 of file Target.h.

References m_target_session_name.

◆ SettingsInitialize()

void Target::SettingsInitialize ( )

static

Definition at line 2795 of file Target.cpp.

References lldb_private::Process::SettingsInitialize().

Referenced by lldb_private::Debugger::SettingsInitialize().

◆ SettingsTerminate()

void Target::SettingsTerminate ( )

static

Definition at line 2797 of file Target.cpp.

References lldb_private::Process::SettingsTerminate().

Referenced by lldb_private::Debugger::SettingsTerminate().

◆ SetTrace()

void Target::SetTrace ( const lldb::TraceSP & trace_sp )

Set the Trace object containing processor trace information of this target.

Parameters

[in] trace_sp The trace object.

Definition at line 3595 of file Target.cpp.

References m_trace_sp.

Referenced by lldb_private::trace_intel_pt::TraceIntelPT::CreateInstanceForLiveProcess().

◆ SymbolsDidLoad()

void Target::SymbolsDidLoad ( ModuleList & module_list )

Definition at line 1882 of file Target.cpp.

References lldb_private::Broadcaster::BroadcastEvent(), eBroadcastBitSymbolsLoaded, lldb_private::ModuleList::GetSize(), m_breakpoint_list, m_internal_breakpoint_list, m_process_sp, and m_valid.

Referenced by CommandObjectTargetSymbolsAdd::AddModuleSymbols().

◆ UndoCreateStopHook()

void Target::UndoCreateStopHook ( lldb::user_id_t uid )

If you tried to create a stop hook, and that failed, call this to remove the stop hook, as it will also reset the stop hook counter.

Definition at line 3070 of file Target.cpp.

References m_stop_hook_next_id, and RemoveStopHookByID().

◆ UnloadModuleSections() [1/2]

size_t Target::UnloadModuleSections ( const lldb::ModuleSP & module_sp )

Definition at line 3363 of file Target.cpp.

References lldb_private::SectionList::GetNumSections(), GetProcessSP(), lldb_private::SectionList::GetSectionAtIndex(), and m_section_load_history.

Referenced by ModulesDidUnload(), and UnloadModuleSections().

◆ UnloadModuleSections() [2/2]

size_t Target::UnloadModuleSections ( const ModuleList & module_list )

Definition at line 3353 of file Target.cpp.

References lldb_private::ModuleList::GetModuleAtIndex(), lldb_private::ModuleList::GetSize(), and UnloadModuleSections().

◆ UpdateSignalFromDummy()

bool Target::UpdateSignalFromDummy	(	lldb::UnixSignalsSP	signals_sp,
		const DummySignalElement &	element )

staticprotected

Definition at line 3884 of file Target.cpp.

References lldb_private::eLazyBoolNo, lldb_private::eLazyBoolYes, and LLDB_INVALID_SIGNAL_NUMBER.

Referenced by UpdateSignalsFromDummy().

◆ UpdateSignalsFromDummy()

void Target::UpdateSignalsFromDummy	(	lldb::UnixSignalsSP	signals_sp,
		lldb::StreamSP	warning_stream_sp )

Updates the signals in signals_sp using the stored dummy signals.

If warning_stream_sp is not null, if any stored signals are not found in the current process, a warning will be emitted here.

Definition at line 3926 of file Target.cpp.

References m_dummy_signals, and UpdateSignalFromDummy().

Referenced by lldb_private::Process::CompleteAttach(), and lldb_private::Process::LaunchPrivate().

◆ Debugger

friend class Debugger

friend

Definition at line 555 of file Target.h.

References Debugger.

Referenced by Debugger, GetDebugger(), GetREPL(), lldb_private::Target::StopHookCommandLine::HandleStop(), Launch(), and Target().

◆ TargetList

friend class TargetList

friend

Definition at line 554 of file Target.h.

References TargetList.

Referenced by SetLabel(), and TargetList.

Member Data Documentation

◆ m_arch

Arch lldb_private::Target::m_arch

protected

Definition at line 1785 of file Target.h.

Referenced by Destroy(), DidExec(), GetArchitecture(), GetArchitecturePlugin(), MergeArchitecture(), ReadPointerFromMemory(), ReadScalarIntegerFromMemory(), SetArchitecture(), SetExecutableModule(), and Target().

◆ m_breakpoint_list

BreakpointList lldb_private::Target::m_breakpoint_list

protected

◆ m_breakpoint_names

BreakpointNameList lldb_private::Target::m_breakpoint_names

protected

Definition at line 1795 of file Target.h.

Referenced by AddBreakpointName(), DeleteBreakpointName(), FindBreakpointName(), GetBreakpointNames(), and PrimeFromDummyTarget().

◆ m_debugger

Debugger& lldb_private::Target::m_debugger

protected

Definition at line 1775 of file Target.h.

Referenced by GetDebugger(), GetREPL(), RunStopHooks(), SetExecutableModule(), and Target().

◆ m_dummy_signals

llvm::StringMap<DummySignalValues> lldb_private::Target::m_dummy_signals

protected

These are used to set the signal state when you don't have a process and more usefully in the Dummy target where you can't know exactly what signals you will have.

Definition at line 1844 of file Target.h.

Referenced by AddDummySignal(), ClearDummySignals(), PrimeFromDummyTarget(), PrintDummySignals(), and UpdateSignalsFromDummy().

◆ m_frame_provider_descriptors

llvm::DenseMap<uint32_t, ScriptedFrameProviderDescriptor> lldb_private::Target::m_frame_provider_descriptors

protected

Map of scripted frame provider descriptors for this target.

Keys are the provider descriptors ids, values are the descriptors. Used to initialize frame providers for new threads.

Definition at line 1812 of file Target.h.

Referenced by AddScriptedFrameProviderDescriptor(), ClearScriptedFrameProviderDescriptors(), GetScriptedFrameProviderDescriptors(), and RemoveScriptedFrameProviderDescriptor().

◆ m_frame_provider_descriptors_mutex

std::recursive_mutex lldb_private::Target::m_frame_provider_descriptors_mutex

mutableprotected

Definition at line 1813 of file Target.h.

Referenced by AddScriptedFrameProviderDescriptor(), ClearScriptedFrameProviderDescriptors(), GetScriptedFrameProviderDescriptors(), and RemoveScriptedFrameProviderDescriptor().

◆ m_frame_recognizer_manager_up

lldb::StackFrameRecognizerManagerUP lldb_private::Target::m_frame_recognizer_manager_up

protected

Stores the frame recognizers of this target.

Definition at line 1840 of file Target.h.

Referenced by GetFrameRecognizerManager(), PrimeFromDummyTarget(), and Target().

◆ m_image_search_paths

PathMappingList lldb_private::Target::m_image_search_paths

protected

Definition at line 1805 of file Target.h.

Referenced by Destroy(), GetImageSearchPathList(), GetOrCreateModule(), and Target().

◆ m_images

ModuleList lldb_private::Target::m_images

protected

The list of images for this process (shared libraries and anything dynamically loaded).

Definition at line 1787 of file Target.h.

Referenced by ClearModules(), Dump(), GetExecutableModule(), GetImages(), GetImages(), GetOrCreateModule(), LoadScriptingResources(), ReadMemory(), ReadPointerFromMemory(), ResolveFileAddress(), SetExecutableModule(), and Target().

◆ m_internal_breakpoint_list

BreakpointList lldb_private::Target::m_internal_breakpoint_list

protected

Definition at line 1792 of file Target.h.

Referenced by AddBreakpoint(), CleanupProcess(), Destroy(), DidExec(), DisableAllBreakpoints(), DisableBreakpointByID(), Dump(), EnableAllBreakpoints(), EnableBreakpointByID(), GetBreakpointByID(), GetBreakpointList(), GetBreakpointList(), ModulesDidLoad(), ModulesDidUnload(), NotifyModuleUpdated(), RemoveAllBreakpoints(), RemoveBreakpointByID(), SymbolsDidLoad(), and Target().

◆ m_internal_stop_hooks

std::vector<StopHookSP> lldb_private::Target::m_internal_stop_hooks

protected

Definition at line 1823 of file Target.h.

Referenced by CreateStopHook(), Destroy(), GetStopHooks(), PrimeFromDummyTarget(), RunStopHooks(), and Target().

◆ m_is_dummy_target

bool lldb_private::Target::m_is_dummy_target

protected

Used to not run stop hooks for expressions.

Definition at line 1828 of file Target.h.

Referenced by IsDummyTarget(), and Target().

◆ m_label

std::string lldb_private::Target::m_label

protected

Definition at line 1786 of file Target.h.

Referenced by GetLabel(), and SetLabel().

◆ m_last_created_breakpoint

lldb::BreakpointSP lldb_private::Target::m_last_created_breakpoint

protected

Definition at line 1797 of file Target.h.

Referenced by AddBreakpoint(), Destroy(), GetLastCreatedBreakpoint(), RemoveAllBreakpoints(), RemoveAllowedBreakpoints(), and RemoveBreakpointByID().

◆ m_last_created_watchpoint

lldb::WatchpointSP lldb_private::Target::m_last_created_watchpoint

protected

Definition at line 1799 of file Target.h.

Referenced by CreateWatchpoint(), Destroy(), GetLastCreatedWatchpoint(), RemoveAllWatchpoints(), and RemoveWatchpointByID().

◆ m_latest_stop_hook_id

uint32_t lldb_private::Target::m_latest_stop_hook_id

protected

Definition at line 1824 of file Target.h.

Referenced by CleanupProcess(), RunStopHooks(), and Target().

◆ m_mutex

std::recursive_mutex lldb_private::Target::m_mutex

protected

An API mutex that is used by the lldb::SB* classes make the SB interface thread safe.

Definition at line 1777 of file Target.h.

Referenced by Destroy(), GetAPIMutex(), and Target().

◆ m_next_persistent_variable_index

unsigned lldb_private::Target::m_next_persistent_variable_index = 0

protected

Definition at line 1829 of file Target.h.

◆ m_platform_sp

lldb::PlatformSP lldb_private::Target::m_platform_sp

protected

The platform for this target.

Definition at line 1776 of file Target.h.

Referenced by Destroy(), FinalizeFileActions(), GetOrCreateModule(), GetPlatform(), ModuleIsExcludedForUnconstrainedSearches(), SetExecutableModule(), SetPlatform(), and Target().

◆ m_private_mutex

std::recursive_mutex lldb_private::Target::m_private_mutex

protected

When the private state thread calls SB API's - usually because it is running OS plugin or Python ThreadPlan code - it should not block on the API mutex that is held by the code that kicked off the sequence of events that led us to run the code.

We hand out this mutex instead when we detect that code is running on the private state thread.

Definition at line 1784 of file Target.h.

Referenced by GetAPIMutex().

◆ m_process_sp

lldb::ProcessSP lldb_private::Target::m_process_sp

protected

◆ m_repl_map

REPLMap lldb_private::Target::m_repl_map

protected

Definition at line 1816 of file Target.h.

Referenced by Destroy(), GetREPL(), and SetREPL().

◆ m_scratch_type_system_map

TypeSystemMap lldb_private::Target::m_scratch_type_system_map

protected

Definition at line 1806 of file Target.h.

Referenced by ClearModules(), GetPersistentSymbol(), GetPersistentVariable(), GetScratchTypeSystemForLanguage(), and ModulesDidUnload().

◆ m_search_filter_sp

lldb::SearchFilterSP lldb_private::Target::m_search_filter_sp

protected

Definition at line 1804 of file Target.h.

Referenced by Destroy(), GetSearchFilterForModule(), GetSearchFilterForModuleList(), and Target().

◆ m_section_load_history

SectionLoadHistory lldb_private::Target::m_section_load_history

protected

Definition at line 1790 of file Target.h.

Referenced by ClearAllLoadedSections(), ClearModules(), DeleteCurrentProcess(), Destroy(), GetSectionLoadList(), ResolveLoadAddress(), SetSectionLoadAddress(), SetSectionUnloaded(), SetSectionUnloaded(), Target(), and UnloadModuleSections().

◆ m_source_manager_up

lldb::SourceManagerUP lldb_private::Target::m_source_manager_up

protected

Definition at line 1818 of file Target.h.

Referenced by GetSourceManager(), and Target().

◆ m_stats

TargetStats lldb_private::Target::m_stats

private

Definition at line 1852 of file Target.h.

Referenced by Attach(), EvaluateExpression(), GetStatistics(), Launch(), ReportStatistics(), ResetStatistics(), and SetExecutableModule().

◆ m_stop_hook_next_id

lldb::user_id_t lldb_private::Target::m_stop_hook_next_id

protected

Definition at line 1822 of file Target.h.

Referenced by CreateStopHook(), Destroy(), PrimeFromDummyTarget(), Target(), and UndoCreateStopHook().

◆ m_stop_hooks

StopHookCollection lldb_private::Target::m_stop_hooks

protected

Definition at line 1821 of file Target.h.

Referenced by CreateStopHook(), Destroy(), GetStopHookByID(), GetStopHooks(), PrimeFromDummyTarget(), RemoveAllStopHooks(), RemoveStopHookByID(), RunStopHooks(), SetAllStopHooksActiveState(), SetStopHookActiveStateByID(), and Target().

◆ m_summary_statistics_cache

SummaryStatisticsCache lldb_private::Target::m_summary_statistics_cache

protected

Definition at line 1789 of file Target.h.

Referenced by GetSummaryStatisticsCache(), and GetSummaryStatisticsSPForProviderName().

◆ m_suppress_stop_hooks

bool lldb_private::Target::m_suppress_stop_hooks

protected

Definition at line 1827 of file Target.h.

Referenced by Destroy(), EvaluateExpression(), GetSuppressStopHooks(), RunStopHooks(), SetSuppresStopHooks(), and Target().

◆ m_target_session_name

std::string lldb_private::Target::m_target_session_name

protected

The target session name for this target, used to name debugging sessions in DAP.

Definition at line 1833 of file Target.h.

Referenced by GetTargetSessionName(), SetTargetSessionName(), and Target().

◆ m_target_unique_id

lldb::user_id_t lldb_private::Target::m_target_unique_id

protected

Initial value:

=

LLDB_INVALID_GLOBALLY_UNIQUE_TARGET_ID

#define LLDB_INVALID_GLOBALLY_UNIQUE_TARGET_ID

Definition lldb-defines.h:101

The globally unique ID assigned to this target.

Definition at line 1830 of file Target.h.

Referenced by GetGloballyUniqueID(), and Target().

◆ m_trace_sp

lldb::TraceSP lldb_private::Target::m_trace_sp

protected

An optional lldb_private::Trace object containing processor trace information of this target.

Definition at line 1838 of file Target.h.

Referenced by CreateTrace(), DeleteCurrentProcess(), GetTrace(), GetTraceOrCreate(), and SetTrace().

◆ m_valid

bool lldb_private::Target::m_valid

protected

This records the last natural stop at which we ran a stop-hook.

Definition at line 1826 of file Target.h.

Referenced by Destroy(), GetScratchTypeSystemForLanguage(), GetScratchTypeSystems(), IsValid(), ModulesDidLoad(), ModulesDidUnload(), NotifyModuleAdded(), NotifyModuleRemoved(), NotifyModuleUpdated(), SymbolsDidLoad(), and Target().

◆ m_watchpoint_list

WatchpointList lldb_private::Target::m_watchpoint_list

protected

Definition at line 1798 of file Target.h.

Referenced by ClearAllWatchpointHistoricValues(), ClearAllWatchpointHitCounts(), CreateWatchpoint(), Destroy(), DisableAllWatchpoints(), DisableWatchpointByID(), EnableAllWatchpoints(), EnableWatchpointByID(), GetWatchpointList(), IgnoreAllWatchpoints(), IgnoreWatchpointByID(), RemoveAllWatchpoints(), RemoveWatchpointByID(), and Target().

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

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ BreakpointNameList

◆ DummySignalElement

◆ REPLMap

◆ StopHookCollection

◆ StopHookSP

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ ~Target()

◆ Target() [1/2]

◆ Target() [2/2]

Member Function Documentation

◆ AddBreakpoint()

◆ AddBreakpointName()

◆ AddDummySignal()

◆ AddNameToBreakpoint() [1/2]

◆ AddNameToBreakpoint() [2/2]

◆ AddScriptedFrameProviderDescriptor()

◆ ApplyNameToBreakpoints()

◆ Attach()

◆ CalculateExecutionContext()

◆ CalculateProcess()

◆ CalculateStackFrame()

◆ CalculateTarget()

◆ CalculateThread()

◆ CleanupProcess()

◆ ClearAllLoadedSections()

◆ ClearAllWatchpointHistoricValues()

◆ ClearAllWatchpointHitCounts()

◆ ClearDummySignals()

◆ ClearModules()

◆ ClearScriptedFrameProviderDescriptors()

◆ ClearSectionLoadList()

◆ ConfigureBreakpointName()

◆ CreateAddressInModuleBreakpoint()

◆ CreateBreakpoint() [1/7]

◆ CreateBreakpoint() [2/7]

◆ CreateBreakpoint() [3/7]

◆ CreateBreakpoint() [4/7]

◆ CreateBreakpoint() [5/7]

◆ CreateBreakpoint() [6/7]

◆ CreateBreakpoint() [7/7]

◆ CreateBreakpointAtUserEntry()

◆ CreateBreakpointsFromFile() [1/2]

◆ CreateBreakpointsFromFile() [2/2]

◆ CreateExceptionBreakpoint()

◆ CreateFuncRegexBreakpoint()

◆ CreateProcess()

◆ CreateScriptedBreakpoint()

◆ CreateSourceRegexBreakpoint()

◆ CreateStopHook()

◆ CreateTrace()

◆ CreateUtilityFunction()

◆ CreateWatchpoint()

◆ DeleteBreakpointName()

◆ DeleteCurrentProcess()

◆ Destroy()

◆ DidExec()

◆ DisableAllBreakpoints()

◆ DisableAllowedBreakpoints()

◆ DisableAllWatchpoints()

◆ DisableBreakpointByID()

◆ DisableWatchpointByID()

◆ Dump()

◆ DumpSectionLoadList()

◆ EnableAllBreakpoints()

◆ EnableAllowedBreakpoints()

◆ EnableAllWatchpoints()