A class to manage flag bits. More...

#include "lldb/Core/Debugger.h"

Inheritance diagram for lldb_private::Debugger:

[legend]

Public Types
enum	{ eBroadcastBitProgress = (1 << 0) , eBroadcastBitWarning = (1 << 1) , eBroadcastBitError = (1 << 2) , eBroadcastSymbolChange = (1 << 3) }
	Broadcaster event bits definitions. More...

enum	StopDisassemblyType { eStopDisassemblyTypeNever = 0 , eStopDisassemblyTypeNoDebugInfo , eStopDisassemblyTypeNoSource , eStopDisassemblyTypeAlways }

Public Member Functions
Broadcaster &	GetBroadcaster ()
	Get the public broadcaster for this debugger.

const Broadcaster &	GetBroadcaster () const

	~Debugger () override

void	Clear ()

bool	GetAsyncExecution ()

void	SetAsyncExecution (bool async)

lldb::FileSP	GetInputFileSP ()

lldb::StreamFileSP	GetOutputStreamSP ()

lldb::StreamFileSP	GetErrorStreamSP ()

File &	GetInputFile ()

File &	GetOutputFile ()

File &	GetErrorFile ()

StreamFile &	GetOutputStream ()

StreamFile &	GetErrorStream ()

repro::DataRecorder *	GetInputRecorder ()

Status	SetInputString (const char *data)

void	SetInputFile (lldb::FileSP file)

void	SetOutputFile (lldb::FileSP file)

void	SetErrorFile (lldb::FileSP file)

void	SaveInputTerminalState ()

void	RestoreInputTerminalState ()

lldb::StreamSP	GetAsyncOutputStream ()

lldb::StreamSP	GetAsyncErrorStream ()

CommandInterpreter &	GetCommandInterpreter ()

ScriptInterpreter *	GetScriptInterpreter (bool can_create=true, std::optional< lldb::ScriptLanguage > language={})

lldb::ListenerSP	GetListener ()

SourceManager &	GetSourceManager ()

lldb::TargetSP	GetSelectedTarget ()

ExecutionContext	GetSelectedExecutionContext ()

TargetList &	GetTargetList ()
	Get accessor for the target list.

PlatformList &	GetPlatformList ()

void	DispatchInputInterrupt ()

void	DispatchInputEndOfFile ()

void	AdoptTopIOHandlerFilesIfInvalid (lldb::FileSP &in, lldb::StreamFileSP &out, lldb::StreamFileSP &err)

void	RunIOHandlerAsync (const lldb::IOHandlerSP &reader_sp, bool cancel_top_handler=true)
	Run the given IO handler and return immediately.

void	RunIOHandlerSync (const lldb::IOHandlerSP &reader_sp)
	Run the given IO handler and block until it's complete.

bool	RemoveIOHandler (const lldb::IOHandlerSP &reader_sp)
	Remove the given IO handler if it's currently active.

bool	IsTopIOHandler (const lldb::IOHandlerSP &reader_sp)

bool	CheckTopIOHandlerTypes (IOHandler::Type top_type, IOHandler::Type second_top_type)

void	PrintAsync (const char *s, size_t len, bool is_stdout)

ConstString	GetTopIOHandlerControlSequence (char ch)

const char *	GetIOHandlerCommandPrefix ()

const char *	GetIOHandlerHelpPrologue ()

void	ClearIOHandlers ()

bool	GetCloseInputOnEOF () const

void	SetCloseInputOnEOF (bool b)

bool	EnableLog (llvm::StringRef channel, llvm::ArrayRef< const char * > categories, llvm::StringRef log_file, uint32_t log_options, size_t buffer_size, LogHandlerKind log_handler_kind, llvm::raw_ostream &error_stream)

void	SetLoggingCallback (lldb::LogOutputCallback log_callback, void *baton)

Status	SetPropertyValue (const ExecutionContext *exe_ctx, VarSetOperationType op, llvm::StringRef property_path, llvm::StringRef value) override

bool	GetAutoConfirm () const

const FormatEntity::Entry *	GetDisassemblyFormat () const

const FormatEntity::Entry *	GetFrameFormat () const

const FormatEntity::Entry *	GetFrameFormatUnique () const

uint64_t	GetStopDisassemblyMaxSize () const

const FormatEntity::Entry *	GetThreadFormat () const

const FormatEntity::Entry *	GetThreadStopFormat () const

lldb::ScriptLanguage	GetScriptLanguage () const

bool	SetScriptLanguage (lldb::ScriptLanguage script_lang)

lldb::LanguageType	GetREPLLanguage () const

bool	SetREPLLanguage (lldb::LanguageType repl_lang)

uint64_t	GetTerminalWidth () const

bool	SetTerminalWidth (uint64_t term_width)

llvm::StringRef	GetPrompt () const

void	SetPrompt (llvm::StringRef p)

void	SetPrompt (const char *)=delete

bool	GetUseExternalEditor () const

bool	SetUseExternalEditor (bool use_external_editor_p)

llvm::StringRef	GetExternalEditor () const

bool	SetExternalEditor (llvm::StringRef editor)

bool	GetUseColor () const

bool	SetUseColor (bool use_color)

bool	GetShowProgress () const

bool	SetShowProgress (bool show_progress)

llvm::StringRef	GetShowProgressAnsiPrefix () const

llvm::StringRef	GetShowProgressAnsiSuffix () const

bool	GetUseAutosuggestion () const

llvm::StringRef	GetAutosuggestionAnsiPrefix () const

llvm::StringRef	GetAutosuggestionAnsiSuffix () const

bool	GetUseSourceCache () const

bool	SetUseSourceCache (bool use_source_cache)

bool	GetHighlightSource () const

lldb::StopShowColumn	GetStopShowColumn () const

llvm::StringRef	GetStopShowColumnAnsiPrefix () const

llvm::StringRef	GetStopShowColumnAnsiSuffix () const

uint64_t	GetStopSourceLineCount (bool before) const

StopDisassemblyType	GetStopDisassemblyDisplay () const

uint64_t	GetDisassemblyLineCount () const

llvm::StringRef	GetStopShowLineMarkerAnsiPrefix () const

llvm::StringRef	GetStopShowLineMarkerAnsiSuffix () const

bool	GetAutoOneLineSummaries () const

bool	GetAutoIndent () const

bool	SetAutoIndent (bool b)

bool	GetPrintDecls () const

bool	SetPrintDecls (bool b)

uint64_t	GetTabSize () const

bool	SetTabSize (uint64_t tab_size)

lldb::DWIMPrintVerbosity	GetDWIMPrintVerbosity () const

bool	GetEscapeNonPrintables () const

bool	GetNotifyVoid () const

const std::string &	GetInstanceName ()

bool	LoadPlugin (const FileSpec &spec, Status &error)

void	RunIOHandlers ()

bool	IsForwardingEvents ()

void	EnableForwardEvents (const lldb::ListenerSP &listener_sp)

void	CancelForwardEvents (const lldb::ListenerSP &listener_sp)

bool	IsHandlingEvents () const

Status	RunREPL (lldb::LanguageType language, const char *repl_options)

void	RequestInterrupt ()
	Interruption in LLDB:

void	CancelInterruptRequest ()
	Decrement the "interrupt requested" counter.

bool	InterruptRequested ()
	This is the correct way to query the state of Interruption.

Target &	GetSelectedOrDummyTarget (bool prefer_dummy=false)

Target &	GetDummyTarget ()

lldb::BroadcasterManagerSP	GetBroadcasterManager ()

void	SetDestroyCallback (lldb_private::DebuggerDestroyCallback destroy_callback, void *baton)

bool	StartEventHandlerThread ()
	Manually start the global event handler thread.

void	StopEventHandlerThread ()
	Manually stop the debugger's default event handler.

void	FlushProcessOutput (Process &process, bool flush_stdout, bool flush_stderr)
	Force flushing the process's pending stdout and stderr to the debugger's asynchronous stdout and stderr streams.

Public Member Functions inherited from lldb_private::UserID
	UserID (lldb::user_id_t uid=LLDB_INVALID_UID)
	Construct with optional user ID.

	~UserID ()=default
	Destructor.

void	Clear ()
	Clears the object state.

lldb::user_id_t	GetID () const
	Get accessor for the user ID.

void	SetID (lldb::user_id_t uid)
	Set accessor for the user ID.

Public Member Functions inherited from lldb_private::Properties
	Properties ()=default

	Properties (const lldb::OptionValuePropertiesSP &collection_sp)

virtual	~Properties ()=default

virtual 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

lldb::OptionValuePropertiesSP	GetSubProperty (const ExecutionContext *exe_ctx, ConstString name)

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

Static Public Member Functions
static ConstString	GetStaticBroadcasterClass ()

static lldb::DebuggerSP	CreateInstance (lldb::LogOutputCallback log_callback=nullptr, void *baton=nullptr)

static lldb::TargetSP	FindTargetWithProcessID (lldb::pid_t pid)

static lldb::TargetSP	FindTargetWithProcess (Process *process)

static void	Initialize (LoadPluginCallbackType load_plugin_callback)

static void	Terminate ()

static void	SettingsInitialize ()

static void	SettingsTerminate ()

static void	Destroy (lldb::DebuggerSP &debugger_sp)

static lldb::DebuggerSP	FindDebuggerWithID (lldb::user_id_t id)

static lldb::DebuggerSP	FindDebuggerWithInstanceName (llvm::StringRef instance_name)

static size_t	GetNumDebuggers ()

static lldb::DebuggerSP	GetDebuggerAtIndex (size_t index)

static bool	FormatDisassemblerAddress (const FormatEntity::Entry format, const SymbolContext sc, const SymbolContext prev_sc, const ExecutionContext exe_ctx, const Address *addr, Stream &s)

static llvm::ThreadPool &	GetThreadPool ()
	Shared thread poll. Use only with ThreadPoolTaskGroup.

static void	ReportWarning (std::string message, std::optional< lldb::user_id_t > debugger_id=std::nullopt, std::once_flag *once=nullptr)
	Report warning events.

static void	ReportError (std::string message, std::optional< lldb::user_id_t > debugger_id=std::nullopt, std::once_flag *once=nullptr)
	Report error events.

static void	ReportInfo (std::string message, std::optional< lldb::user_id_t > debugger_id=std::nullopt, std::once_flag *once=nullptr)
	Report info events.

static void	ReportSymbolChange (const ModuleSpec &module_spec)

Static Public Member Functions inherited from lldb_private::Properties
static const char *	GetExperimentalSettingsName ()

static bool	IsSettingExperimental (llvm::StringRef setting)

Protected Types
enum	{ eBroadcastBitEventThreadIsListening = (1 << 0) }

typedef std::vector< llvm::sys::DynamicLibrary >	LoadedPluginsList

Protected Member Functions
void	HandleDestroyCallback ()

void	PrintProgress (const ProgressEventData &data)

void	PushIOHandler (const lldb::IOHandlerSP &reader_sp, bool cancel_top_handler=true)

bool	PopIOHandler (const lldb::IOHandlerSP &reader_sp)

bool	HasIOHandlerThread () const

bool	StartIOHandlerThread ()

void	StopIOHandlerThread ()

HostThread	SetIOHandlerThread (HostThread &new_thread)

void	JoinIOHandlerThread ()

bool	IsIOHandlerThreadCurrentThread () const

lldb::thread_result_t	IOHandlerThread ()

lldb::thread_result_t	DefaultEventHandler ()

void	HandleBreakpointEvent (const lldb::EventSP &event_sp)

void	HandleProcessEvent (const lldb::EventSP &event_sp)

void	HandleThreadEvent (const lldb::EventSP &event_sp)

void	HandleProgressEvent (const lldb::EventSP &event_sp)

void	HandleDiagnosticEvent (const lldb::EventSP &event_sp)

SourceManager::SourceFileCache &	GetSourceFileCache ()

void	InstanceInitialize ()

Static Protected Member Functions
static void	ReportProgress (uint64_t progress_id, std::string title, std::string details, uint64_t completed, uint64_t total, std::optional< lldb::user_id_t > debugger_id)
	Report progress events.

static void	ReportDiagnosticImpl (DiagnosticEventData::Type type, std::string message, std::optional< lldb::user_id_t > debugger_id, std::once_flag *once)

Protected Attributes
std::mutex	m_output_flush_mutex

lldb::FileSP	m_input_file_sp

lldb::StreamFileSP	m_output_stream_sp

lldb::StreamFileSP	m_error_stream_sp

repro::DataRecorder *	m_input_recorder
	Used for shadowing the input file when capturing a reproducer.

lldb::BroadcasterManagerSP	m_broadcaster_manager_sp

TerminalState	m_terminal_state

TargetList	m_target_list

PlatformList	m_platform_list

lldb::ListenerSP	m_listener_sp

std::unique_ptr< SourceManager >	m_source_manager_up

SourceManager::SourceFileCache	m_source_file_cache

std::unique_ptr< CommandInterpreter >	m_command_interpreter_up

std::recursive_mutex	m_script_interpreter_mutex

std::array< lldb::ScriptInterpreterSP, lldb::eScriptLanguageUnknown >	m_script_interpreters

IOHandlerStack	m_io_handler_stack

std::recursive_mutex	m_io_handler_synchronous_mutex

std::optional< uint64_t >	m_current_event_id

llvm::StringMap< std::weak_ptr< LogHandler > >	m_stream_handlers

std::shared_ptr< CallbackLogHandler >	m_callback_handler_sp

const std::string	m_instance_name

LoadedPluginsList	m_loaded_plugins

HostThread	m_event_handler_thread

HostThread	m_io_handler_thread

Broadcaster	m_sync_broadcaster
	Private debugger synchronization.

Broadcaster	m_broadcaster
	Public Debugger event broadcaster.

lldb::ListenerSP	m_forward_listener_sp

llvm::once_flag	m_clear_once

lldb::TargetSP	m_dummy_target_sp

Diagnostics::CallbackID	m_diagnostics_callback_id

lldb_private::DebuggerDestroyCallback	m_destroy_callback = nullptr

void *	m_destroy_callback_baton = nullptr

uint32_t	m_interrupt_requested = 0
	Tracks interrupt requests.

std::mutex	m_interrupt_mutex

Protected Attributes inherited from lldb_private::UserID
lldb::user_id_t	m_uid
	The user ID that uniquely identifies an object.

Protected Attributes inherited from lldb_private::Properties
lldb::OptionValuePropertiesSP	m_collection_sp

Static Protected Attributes
static LoadPluginCallbackType	g_load_plugin_callback = nullptr

Private Member Functions
	Debugger (lldb::LogOutputCallback m_log_callback, void *baton)

	Debugger (const Debugger &)=delete

const Debugger &	operator= (const Debugger &)=delete

Friends
class	SourceManager

class	CommandInterpreter

class	REPL

class	Progress

Detailed Description

A class to manage flag bits.

Provides a global root objects for the debugger core.

Definition at line 76 of file Debugger.h.

Member Typedef Documentation

◆ LoadedPluginsList

typedef std::vector<llvm::sys::DynamicLibrary> lldb_private::Debugger::LoadedPluginsList

protected

Definition at line 649 of file Debugger.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Broadcaster event bits definitions.

Enumerator
eBroadcastBitProgress
eBroadcastBitWarning
eBroadcastBitError
eBroadcastSymbolChange

Definition at line 83 of file Debugger.h.

◆ anonymous enum

anonymous enum

protected

Enumerator
eBroadcastBitEventThreadIsListening

Definition at line 667 of file Debugger.h.

◆ StopDisassemblyType

enum lldb_private::Debugger::StopDisassemblyType

Enumerator
eStopDisassemblyTypeNever
eStopDisassemblyTypeNoDebugInfo
eStopDisassemblyTypeNoSource
eStopDisassemblyTypeAlways

Definition at line 253 of file Debugger.h.

Constructor & Destructor Documentation

◆ ~Debugger()

Debugger::~Debugger ( )

override

Definition at line 888 of file Debugger.cpp.

References Clear().

◆ Debugger() [1/2]

Debugger::Debugger	(	lldb::LogOutputCallback	m_log_callback,
		void *	baton
	)

private

Definition at line 792 of file Debugger.cpp.

References lldb_private::Diagnostics::AddCallback(), lldb_private::PlatformList::Append(), lldb_private::FileSpec::CopyByAppendingPathComponent(), lldb_private::Diagnostics::Enabled(), lldb_private::Target::GetDefaultArchitecture(), lldb_private::ModuleList::GetGlobalModuleListProperties(), lldb_private::Platform::GetGlobalPlatformProperties(), lldb_private::Target::GetGlobalProperties(), lldb_private::Platform::GetHostPlatform(), GetOutputFile(), lldb_private::FileSpec::GetPath(), lldb_private::Properties::GetValueProperties(), lldb_private::Diagnostics::Instance(), lldb_private::ArchSpec::IsValid(), m_callback_handler_sp, lldb_private::Properties::m_collection_sp, m_command_interpreter_up, m_diagnostics_callback_id, m_dummy_target_sp, m_platform_list, m_stream_handlers, lldb_private::OptionValueSInt64::SetMaximumValue(), lldb_private::OptionValueSInt64::SetMinimumValue(), and SetUseColor().

◆ Debugger() [2/2]

lldb_private::Debugger::Debugger ( const Debugger & )

privatedelete

Member Function Documentation

◆ AdoptTopIOHandlerFilesIfInvalid()

void Debugger::AdoptTopIOHandlerFilesIfInvalid	(	lldb::FileSP &	in,
		lldb::StreamFileSP &	out,
		lldb::StreamFileSP &	err
	)

Definition at line 1151 of file Debugger.cpp.

References GetErrorStreamSP(), GetInputFileSP(), lldb_private::IOHandlerStack::GetMutex(), GetOutputStreamSP(), m_io_handler_stack, and lldb_private::IOHandlerStack::Top().

Referenced by lldb_private::IOHandler::IOHandler(), and lldb_private::ScriptInterpreterIORedirect::ScriptInterpreterIORedirect().

◆ CancelForwardEvents()

void Debugger::CancelForwardEvents ( const lldb::ListenerSP & listener_sp )

Definition at line 1780 of file Debugger.cpp.

References m_forward_listener_sp.

◆ CancelInterruptRequest()

void Debugger::CancelInterruptRequest ( )

Decrement the "interrupt requested" counter.

Definition at line 1259 of file Debugger.cpp.

References m_interrupt_mutex, and m_interrupt_requested.

◆ CheckTopIOHandlerTypes()

bool Debugger::CheckTopIOHandlerTypes	(	IOHandler::Type	top_type,
		IOHandler::Type	second_top_type
	)

Definition at line 1116 of file Debugger.cpp.

References lldb_private::IOHandlerStack::CheckTopIOHandlerTypes(), and m_io_handler_stack.

Referenced by lldb_private::REPL::IOHandlerInputComplete().

◆ Clear()

void Debugger::Clear ( )

Definition at line 890 of file Debugger.cpp.

References ClearIOHandlers(), lldb_private::File::Close(), lldb_private::Diagnostics::Enabled(), GetInputFile(), lldb_private::Diagnostics::Instance(), m_broadcaster_manager_sp, m_clear_once, m_command_interpreter_up, m_diagnostics_callback_id, m_listener_sp, m_target_list, m_terminal_state, lldb_private::Diagnostics::RemoveCallback(), StopEventHandlerThread(), StopIOHandlerThread(), and lldb_private::TargetList::Targets().

Referenced by ~Debugger().

◆ ClearIOHandlers()

void Debugger::ClearIOHandlers ( )

Definition at line 1042 of file Debugger.cpp.

References lldb_private::IOHandlerStack::GetMutex(), lldb_private::IOHandlerStack::GetSize(), m_io_handler_stack, PopIOHandler(), and lldb_private::IOHandlerStack::Top().

Referenced by Clear(), and RunIOHandlers().

◆ CreateInstance()

DebuggerSP Debugger::CreateInstance	(	lldb::LogOutputCallback	log_callback = `nullptr`,
		void *	baton = `nullptr`
	)

static

Definition at line 695 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, and g_debugger_list_ptr.

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

◆ DefaultEventHandler()

lldb::thread_result_t Debugger::DefaultEventHandler ( )

protected

Definition at line 1784 of file Debugger.cpp.

References lldb_private::Broadcaster::BroadcastEvent(), lldb_private::CommandInterpreter::eBroadcastBitAsynchronousErrorData, lldb_private::CommandInterpreter::eBroadcastBitAsynchronousOutputData, lldb_private::Target::eBroadcastBitBreakpointChanged, eBroadcastBitError, eBroadcastBitEventThreadIsListening, eBroadcastBitProgress, lldb_private::CommandInterpreter::eBroadcastBitQuitCommandReceived, lldb_private::Thread::eBroadcastBitStackChanged, lldb_private::Process::eBroadcastBitStateChanged, lldb_private::Process::eBroadcastBitSTDERR, lldb_private::Process::eBroadcastBitSTDOUT, lldb_private::Process::eBroadcastBitStructuredData, lldb_private::Thread::eBroadcastBitThreadSelected, eBroadcastBitWarning, eBroadcastSymbolChange, GetAsyncErrorStream(), GetAsyncOutputStream(), lldb_private::Broadcaster::GetBroadcasterClass(), lldb_private::EventDataBytes::GetBytesFromEvent(), lldb_private::Breakpoint::BreakpointEventData::GetEventDataFromEvent(), GetListener(), lldb_private::Process::GetStaticBroadcasterClass(), lldb_private::Target::GetStaticBroadcasterClass(), lldb_private::Thread::GetStaticBroadcasterClass(), HandleBreakpointEvent(), HandleDiagnosticEvent(), HandleProcessEvent(), HandleProgressEvent(), HandleThreadEvent(), m_broadcaster, m_broadcaster_manager_sp, m_command_interpreter_up, m_forward_listener_sp, and m_sync_broadcaster.

Referenced by StartEventHandlerThread().

◆ Destroy()

void Debugger::Destroy ( lldb::DebuggerSP & debugger_sp )

static

Definition at line 713 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, g_debugger_list_ptr, lldb_private::CommandReturnObject::GetErrorData(), lldb_private::CommandReturnObject::GetOutputData(), lldb_private::CommandInterpreter::GetSaveSessionOnQuit(), lldb_private::CommandInterpreter::SaveTranscript(), and lldb_private::CommandReturnObject::Succeeded().

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

◆ DispatchInputEndOfFile()

void Debugger::DispatchInputEndOfFile ( )

Definition at line 1035 of file Debugger.cpp.

References lldb_private::IOHandlerStack::GetMutex(), m_io_handler_stack, and lldb_private::IOHandlerStack::Top().

◆ DispatchInputInterrupt()

void Debugger::DispatchInputInterrupt ( )

Definition at line 1028 of file Debugger.cpp.

References lldb_private::IOHandlerStack::GetMutex(), m_io_handler_stack, and lldb_private::IOHandlerStack::Top().

◆ EnableForwardEvents()

void Debugger::EnableForwardEvents ( const lldb::ListenerSP & listener_sp )

Definition at line 1776 of file Debugger.cpp.

References m_forward_listener_sp.

◆ EnableLog()

bool Debugger::EnableLog	(	llvm::StringRef	channel,
		llvm::ArrayRef< const char * >	categories,
		llvm::StringRef	log_file,
		uint32_t	log_options,
		size_t	buffer_size,
		LogHandlerKind	log_handler_kind,
		llvm::raw_ostream &	error_stream
	)

Definition at line 1530 of file Debugger.cpp.

References CreateLogHandler(), lldb_private::Log::EnableLogChannel(), lldb_private::File::eOpenOptionAppend, lldb_private::File::eOpenOptionCanCreate, lldb_private::File::eOpenOptionTruncate, lldb_private::File::eOpenOptionWriteOnly, GetOutputFile(), lldb_private::FileSystem::Instance(), LLDB_LOG_OPTION_APPEND, LLDB_LOG_OPTION_PREPEND_THREAD_NAME, LLDB_LOG_OPTION_PREPEND_TIMESTAMP, m_callback_handler_sp, m_stream_handlers, and lldb_private::FileSystem::Open().

Referenced by CommandObjectLogEnable::DoExecute().

◆ FindDebuggerWithID()

DebuggerSP Debugger::FindDebuggerWithID ( lldb::user_id_t id )

static

Definition at line 1297 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, and g_debugger_list_ptr.

Referenced by lldb::SBDebugger::FindDebuggerWithID(), ReportDiagnosticImpl(), and ReportProgress().

◆ FindDebuggerWithInstanceName()

DebuggerSP Debugger::FindDebuggerWithInstanceName ( llvm::StringRef instance_name )

static

Definition at line 744 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, and g_debugger_list_ptr.

Referenced by lldb::SBDebugger::GetInternalVariableValue(), and lldb::SBDebugger::SetInternalVariable().

◆ FindTargetWithProcess()

TargetSP Debugger::FindTargetWithProcess ( Process * process )

static

Definition at line 773 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, and g_debugger_list_ptr.

◆ FindTargetWithProcessID()

TargetSP Debugger::FindTargetWithProcessID ( lldb::pid_t pid )

static

Definition at line 759 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, and g_debugger_list_ptr.

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

◆ FlushProcessOutput()

void Debugger::FlushProcessOutput	(	Process &	process,
		bool	flush_stdout,
		bool	flush_stderr
	)

Force flushing the process's pending stdout and stderr to the debugger's asynchronous stdout and stderr streams.

Definition at line 1651 of file Debugger.cpp.

References error(), lldb_private::Stream::Flush(), GetAsyncErrorStream(), GetAsyncOutputStream(), lldb_private::Process::GetSTDERR(), lldb_private::Process::GetSTDOUT(), m_output_flush_mutex, and lldb_private::Stream::Write().

Referenced by lldb_private::CommandInterpreter::GetProcessOutput(), and HandleProcessEvent().

◆ FormatDisassemblerAddress()

bool Debugger::FormatDisassemblerAddress	(	const FormatEntity::Entry *	format,
		const SymbolContext *	sc,
		const SymbolContext *	prev_sc,
		const ExecutionContext *	exe_ctx,
		const Address *	addr,
		Stream &	s
	)

static

Definition at line 1313 of file Debugger.cpp.

References lldb_private::Symbol::Compare(), lldb_private::FormatEntity::Format(), lldb_private::SymbolContext::function, lldb_private::Target::GetDebugger(), GetDisassemblyFormat(), lldb_private::Function::GetMangled(), lldb_private::Symbol::GetName(), lldb_private::ExecutionContext::GetTargetRef(), lldb_private::Symbol::GetType(), lldb_private::ExecutionContext::HasTargetScope(), lldb_private::FormatEntity::Parse(), and lldb_private::SymbolContext::symbol.

Referenced by lldb_private::Instruction::Dump(), and lldb_private::Disassembler::PrintInstructions().

◆ GetAsyncErrorStream()

StreamSP Debugger::GetAsyncErrorStream ( )

Definition at line 1250 of file Debugger.cpp.

References GetUseColor().

Referenced by lldb_private::BreakpointOptions::BreakpointOptionsCallbackFunction(), lldb_private::Process::CompleteAttach(), DefaultEventHandler(), FlushProcessOutput(), HandleDiagnosticEvent(), HandleProcessEvent(), lldb_private::Process::LaunchPrivate(), and PrivateReportDiagnostic().

◆ GetAsyncExecution()

bool Debugger::GetAsyncExecution ( )

Definition at line 934 of file Debugger.cpp.

References m_command_interpreter_up.

Referenced by CommandObjectProcessContinue::DoExecute(), CommandObjectProcessConnect::DoExecute(), lldb_private::CommandInterpreter::HandleCommands(), lldb_private::CommandInterpreter::HandleCommandsFromFile(), lldb_private::Target::StopHookCommandLine::HandleStop(), lldb_private::StopInfoBreakpoint::PerformAction(), lldb_private::StopInfoWatchpoint::PerformAction(), and lldb::SBThread::ResumeNewPlan().

◆ GetAsyncOutputStream()

StreamSP Debugger::GetAsyncOutputStream ( )

Definition at line 1246 of file Debugger.cpp.

References GetUseColor().

Referenced by lldb_private::ClangUserExpression::AddArguments(), lldb_private::BreakpointOptions::BreakpointOptionsCallbackFunction(), DefaultEventHandler(), ProcessKDP::DoConnectRemote(), FlushProcessOutput(), HandleBreakpointEvent(), HandleProcessEvent(), HandleProgressEvent(), HandleThreadEvent(), lldb_private::StopInfoWatchpoint::PerformAction(), lldb_private::Target::RunStopHooks(), and ObjectFileMachO::SaveCore().

◆ GetAutoConfirm()

bool Debugger::GetAutoConfirm ( ) const

Definition at line 264 of file Debugger.cpp.

Referenced by lldb_private::CommandInterpreter::Confirm().

◆ GetAutoIndent()

bool Debugger::GetAutoIndent ( ) const

Definition at line 519 of file Debugger.cpp.

Referenced by lldb_private::REPL::GetIOHandler().

◆ GetAutoOneLineSummaries()

bool Debugger::GetAutoOneLineSummaries ( ) const

Definition at line 507 of file Debugger.cpp.

◆ GetAutosuggestionAnsiPrefix()

llvm::StringRef Debugger::GetAutosuggestionAnsiPrefix ( ) const

Definition at line 424 of file Debugger.cpp.

Referenced by lldb_private::IOHandlerEditline::IOHandlerEditline().

◆ GetAutosuggestionAnsiSuffix()

llvm::StringRef Debugger::GetAutosuggestionAnsiSuffix ( ) const

Definition at line 430 of file Debugger.cpp.

Referenced by lldb_private::IOHandlerEditline::IOHandlerEditline().

◆ GetBroadcaster() [1/2]

Broadcaster & lldb_private::Debugger::GetBroadcaster ( )

inline

Get the public broadcaster for this debugger.

Definition at line 93 of file Debugger.h.

References m_broadcaster.

Referenced by PrivateReportDiagnostic(), and PrivateReportProgress().

◆ GetBroadcaster() [2/2]

const Broadcaster & lldb_private::Debugger::GetBroadcaster ( ) const

inline

Definition at line 94 of file Debugger.h.

References m_broadcaster.

◆ GetBroadcasterManager()

lldb::BroadcasterManagerSP lldb_private::Debugger::GetBroadcasterManager ( )

inline

Definition at line 426 of file Debugger.h.

References m_broadcaster_manager_sp.

Referenced by lldb::SBListener::StartListeningForEventClass(), and lldb::SBListener::StopListeningForEventClass().

◆ GetCloseInputOnEOF()

bool Debugger::GetCloseInputOnEOF ( ) const

Definition at line 925 of file Debugger.cpp.

◆ GetCommandInterpreter()

CommandInterpreter & lldb_private::Debugger::GetCommandInterpreter ( )

inline

Definition at line 171 of file Debugger.h.

References m_command_interpreter_up.

Referenced by lldb_private::BreakpointOptions::BreakpointOptionsCallbackFunction(), lldb_private::StructuredDataDarwinLog::DebuggerInitialize(), CommandObjectCommandsSource::DoExecute(), CommandObjectCommandsScriptImport::DoExecute(), CommandObjectCommandsScriptAdd::DoExecute(), lldb_private::Target::StopHookCommandLine::HandleStop(), lldb_private::StructuredDataPlugin::InitializeBasePluginForDebugger(), InterruptRequested(), lldb_private::IOHandlerDelegate::IOHandlerComplete(), lldb_private::REPL::IOHandlerComplete(), lldb_private::REPL::IOHandlerInputComplete(), lldb_private::IOHandlerDelegate::IOHandlerSuggestion(), lldb_private::Target::Launch(), lldb_private::REPL::REPL(), lldb_private::REPL::RunLoop(), SetPrompt(), SetPropertyValue(), and StopEventHandlerThread().

◆ GetDebuggerAtIndex()

lldb::DebuggerSP Debugger::GetDebuggerAtIndex ( size_t index )

static

Definition at line 1285 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, and g_debugger_list_ptr.

Referenced by lldb::SBTypeCategory::AddTypeSummary(), lldb::SBTypeCategory::AddTypeSynthetic(), and lldb_private::CommandObjectQuit::ShouldAskForConfirmation().

◆ GetDisassemblyFormat()

const FormatEntity::Entry * Debugger::GetDisassemblyFormat ( ) const

Definition at line 270 of file Debugger.cpp.

Referenced by lldb_private::InstructionList::Dump(), FormatDisassemblerAddress(), lldb_private::ThreadPlanAssemblyTracer::Log(), and lldb_private::Disassembler::PrintInstructions().

◆ GetDisassemblyLineCount()

uint64_t Debugger::GetDisassemblyLineCount ( ) const

Definition at line 501 of file Debugger.cpp.

Referenced by lldb_private::StackFrame::GetStatus().

◆ GetDummyTarget()

Target & lldb_private::Debugger::GetDummyTarget ( )

inline

Definition at line 424 of file Debugger.h.

References m_dummy_target_sp.

Referenced by lldb_private::TargetList::CreateTargetInternal(), lldb_private::CommandObject::GetDummyTarget(), GetSelectedOrDummyTarget(), and lldb_private::CommandInterpreter::PreprocessToken().

◆ GetDWIMPrintVerbosity()

lldb::DWIMPrintVerbosity Debugger::GetDWIMPrintVerbosity ( ) const

Definition at line 552 of file Debugger.cpp.

Referenced by lldb_private::CommandObjectDWIMPrint::DoExecute().

◆ GetErrorFile()

File & lldb_private::Debugger::GetErrorFile ( )

inline

Definition at line 147 of file Debugger.h.

References m_error_stream_sp.

Referenced by IOHandlerLuaInterpreter::IOHandlerLuaInterpreter().

◆ GetErrorStream()

StreamFile & lldb_private::Debugger::GetErrorStream ( )

inline

Definition at line 151 of file Debugger.h.

References m_error_stream_sp.

Referenced by lldb_private::ScriptInterpreterLua::BreakpointCallbackFunction(), lldb_private::Process::CreateBreakpointSite(), lldb_private::ScriptInterpreterNone::ExecuteInterpreterLoop(), lldb_private::ScriptInterpreterNone::ExecuteOneLine(), LoadScriptingResourceForModule(), lldb_private::ScriptInterpreterIORedirect::ScriptInterpreterIORedirect(), SetPropertyValue(), and lldb_private::ScriptInterpreterLua::WatchpointCallbackFunction().

◆ GetErrorStreamSP()

lldb::StreamFileSP lldb_private::Debugger::GetErrorStreamSP ( )

inline

Definition at line 141 of file Debugger.h.

References m_error_stream_sp.

Referenced by AdoptTopIOHandlerFilesIfInvalid(), and lldb_private::CommandInterpreter::GetIOHandler().

◆ GetEscapeNonPrintables()

bool Debugger::GetEscapeNonPrintables ( ) const

Definition at line 513 of file Debugger.cpp.

◆ GetExternalEditor()

llvm::StringRef Debugger::GetExternalEditor ( ) const

Definition at line 371 of file Debugger.cpp.

Referenced by lldb_private::Thread::GetStatus(), lldb_private::CommandInterpreter::SaveTranscript(), and lldb_private::Thread::SetSelectedFrameByIndexNoisily().

◆ GetFrameFormat()

const FormatEntity::Entry * Debugger::GetFrameFormat ( ) const

Definition at line 275 of file Debugger.cpp.

Referenced by lldb_private::StackFrame::DumpUsingSettingsFormat().

◆ GetFrameFormatUnique()

const FormatEntity::Entry * Debugger::GetFrameFormatUnique ( ) const

Definition at line 280 of file Debugger.cpp.

Referenced by lldb_private::StackFrame::DumpUsingSettingsFormat().

◆ GetHighlightSource()

bool Debugger::GetHighlightSource ( ) const

Definition at line 450 of file Debugger.cpp.

◆ GetInputFile()

File & lldb_private::Debugger::GetInputFile ( )

inline

Definition at line 143 of file Debugger.h.

References m_input_file_sp.

Referenced by Clear(), lldb_private::CommandObjectGUI::DoExecute(), lldb_private::ScriptInterpreterLua::ExecuteInterpreterLoop(), SaveInputTerminalState(), and StopIOHandlerThread().

◆ GetInputFileSP()

lldb::FileSP lldb_private::Debugger::GetInputFileSP ( )

inline

Definition at line 137 of file Debugger.h.

References m_input_file_sp.

Referenced by AdoptTopIOHandlerFilesIfInvalid(), lldb_private::CommandInterpreter::GetIOHandler(), and lldb_private::ScriptInterpreterIORedirect::ScriptInterpreterIORedirect().

◆ GetInputRecorder()

repro::DataRecorder * Debugger::GetInputRecorder ( )

Definition at line 942 of file Debugger.cpp.

References m_input_recorder.

◆ GetInstanceName()

const std::string & lldb_private::Debugger::GetInstanceName ( )

inline

Definition at line 362 of file Debugger.h.

References m_instance_name.

◆ GetIOHandlerCommandPrefix()

const char * Debugger::GetIOHandlerCommandPrefix ( )

Definition at line 1134 of file Debugger.cpp.

References lldb_private::IOHandlerStack::GetTopIOHandlerCommandPrefix(), and m_io_handler_stack.

Referenced by lldb_private::CommandInterpreter::GetCommandPrefix().

◆ GetIOHandlerHelpPrologue()

const char * Debugger::GetIOHandlerHelpPrologue ( )

Definition at line 1138 of file Debugger.cpp.

References lldb_private::IOHandlerStack::GetTopIOHandlerHelpPrologue(), and m_io_handler_stack.

◆ GetListener()

lldb::ListenerSP lldb_private::Debugger::GetListener ( )

inline

Definition at line 180 of file Debugger.h.

References m_listener_sp.

Referenced by lldb_private::Target::CreateProcess(), DefaultEventHandler(), lldb_private::Platform::DoConnectProcess(), and lldb_private::ProcessAttachInfo::GetListenerForProcess().

◆ GetNotifyVoid()

bool Debugger::GetNotifyVoid ( ) const

Definition at line 291 of file Debugger.cpp.

Referenced by lldb_private::REPL::IOHandlerInputComplete().

◆ GetNumDebuggers()

size_t Debugger::GetNumDebuggers ( )

static

Definition at line 1277 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, and g_debugger_list_ptr.

Referenced by lldb::SBTypeCategory::AddTypeSummary(), lldb::SBTypeCategory::AddTypeSynthetic(), and lldb_private::CommandObjectQuit::ShouldAskForConfirmation().

◆ GetOutputFile()

File & lldb_private::Debugger::GetOutputFile ( )

inline

Definition at line 145 of file Debugger.h.

References m_output_stream_sp.

Referenced by Debugger(), lldb_private::CommandObjectGUI::DoExecute(), EnableLog(), lldb_private::CommandInterpreter::HandleCommandsFromFile(), HandleProgressEvent(), and IOHandlerLuaInterpreter::IOHandlerLuaInterpreter().

◆ GetOutputStream()

StreamFile & lldb_private::Debugger::GetOutputStream ( )

inline

Definition at line 149 of file Debugger.h.

References m_output_stream_sp.

Referenced by DynamicLoaderDarwinKernel::KextImageInfo::LoadImageUsingMemoryModule(), DynamicLoaderDarwinKernel::ParseKextSummaries(), DynamicLoaderDarwinKernel::ReadKextSummaryHeader(), and lldb_private::ScriptInterpreterIORedirect::ScriptInterpreterIORedirect().

◆ GetOutputStreamSP()

lldb::StreamFileSP lldb_private::Debugger::GetOutputStreamSP ( )

inline

Definition at line 139 of file Debugger.h.

References m_output_stream_sp.

Referenced by AdoptTopIOHandlerFilesIfInvalid(), lldb_private::CommandInterpreter::GetIOHandler(), and lldb_private::InstrumentationRuntimeUBSan::RetrieveReportData().

◆ GetPlatformList()

PlatformList & lldb_private::Debugger::GetPlatformList ( )

inline

Definition at line 203 of file Debugger.h.

References m_platform_list.

Referenced by lldb_private::Target::Attach(), lldb_private::Process::CompleteAttach(), lldb_private::OptionGroupPlatform::CreatePlatformWithOptions(), lldb_private::TargetList::CreateTargetInternal(), CommandObjectPlatformSelect::DoExecute(), CommandObjectPlatformStatus::DoExecute(), CommandObjectPlatformProcessLaunch::DoExecute(), CommandObjectPlatformProcessList::DoExecute(), CommandObjectPlatformProcessInfo::DoExecute(), DynamicLoaderDarwinKernel::DynamicLoaderDarwinKernel(), lldb_private::CommandInterpreter::GetPlatform(), ObjectFileMachO::LoadCoreFileImages(), lldb_private::CommandCompletions::RemoteDiskDirectories(), and lldb_private::CommandCompletions::RemoteDiskFiles().

◆ GetPrintDecls()

bool Debugger::GetPrintDecls ( ) const

Definition at line 530 of file Debugger.cpp.

Referenced by lldb_private::REPL::IOHandlerInputComplete().

◆ GetPrompt()

llvm::StringRef Debugger::GetPrompt ( ) const

Definition at line 297 of file Debugger.cpp.

Referenced by lldb_private::CommandInterpreter::GetIOHandler(), lldb_private::CommandInterpreter::HandleCommands(), lldb_private::CommandInterpreter::HandleCommandsFromFile(), SetPrompt(), SetPropertyValue(), and SetUseColor().

◆ GetREPLLanguage()

lldb::LanguageType Debugger::GetREPLLanguage ( ) const

Definition at line 336 of file Debugger.cpp.

Referenced by lldb_private::Target::GetREPL(), and RunREPL().

◆ GetScriptInterpreter()

ScriptInterpreter * Debugger::GetScriptInterpreter	(	bool	can_create = `true`,
		std::optional< lldb::ScriptLanguage >	language = `{}`
	)

Definition at line 1581 of file Debugger.cpp.

References lldb_private::PluginManager::GetScriptInterpreterForLanguage(), GetScriptLanguage(), m_script_interpreter_mutex, and m_script_interpreters.

Referenced by lldb_private::ScriptInterpreterLua::BreakpointCallbackFunction(), lldb_private::BreakpointOptions::CreateFromStructuredData(), CommandObjectCommandsScriptAdd::DoExecute(), CommandObjectFrameRecognizerAdd::DoExecute(), lldb_private::CommandObjectScript::DoExecute(), CommandObjectPythonFunction::DoExecute(), CommandObjectScriptingObject::DoExecute(), CommandObjectScriptingObject::GetHelp(), CommandObjectPythonFunction::GetHelpLong(), CommandObjectScriptingObject::GetHelpLong(), lldb_private::ThreadPlanPython::GetScriptInterpreter(), CommandObjectCommandsScriptAdd::IOHandlerInputComplete(), CommandObjectTypeSummaryAdd::IOHandlerInputComplete(), CommandObjectTypeSynthAdd::IOHandlerInputComplete(), lldb_private::CommandInterpreter::IOHandlerInterrupt(), lldb_private::Module::LoadScriptingResourceInTarget(), lldb_private::PlatformDarwin::LocateExecutableScriptingResources(), lldb_private::process_gdb_remote::ProcessGDBRemote::ParsePythonTargetDefinition(), RunScriptFormatKeyword(), and lldb_private::ScriptInterpreterLua::WatchpointCallbackFunction().

◆ GetScriptLanguage()

lldb::ScriptLanguage Debugger::GetScriptLanguage ( ) const

Definition at line 324 of file Debugger.cpp.

Referenced by lldb_private::CommandObjectScript::DoExecute(), GetScriptInterpreter(), lldb_private::Module::LoadScriptingResourceInTarget(), and lldb_private::PlatformDarwin::LocateExecutableScriptingResources().

◆ GetSelectedExecutionContext()

ExecutionContext Debugger::GetSelectedExecutionContext ( )

Definition at line 1022 of file Debugger.cpp.

References GetSelectedTarget().

Referenced by lldb_private::CommandInterpreter::GetExecutionContext(), and lldb_private::CommandInterpreter::IOHandlerInputComplete().

◆ GetSelectedOrDummyTarget()

Target & Debugger::GetSelectedOrDummyTarget ( bool prefer_dummy = false )

Definition at line 2078 of file Debugger.cpp.

References GetDummyTarget(), lldb_private::TargetList::GetSelectedTarget(), and m_target_list.

Referenced by lldb_private::CommandObject::GetSelectedOrDummyTarget().

◆ GetSelectedTarget()

lldb::TargetSP lldb_private::Debugger::GetSelectedTarget ( )

inline

Definition at line 188 of file Debugger.h.

References lldb_private::TargetList::GetSelectedTarget(), and m_target_list.

◆ GetShowProgress()

bool Debugger::GetShowProgress ( ) const

Definition at line 395 of file Debugger.cpp.

Referenced by HandleProgressEvent().

◆ GetShowProgressAnsiPrefix()

llvm::StringRef Debugger::GetShowProgressAnsiPrefix ( ) const

Definition at line 406 of file Debugger.cpp.

Referenced by HandleProgressEvent().

◆ GetShowProgressAnsiSuffix()

llvm::StringRef Debugger::GetShowProgressAnsiSuffix ( ) const

Definition at line 412 of file Debugger.cpp.

Referenced by HandleProgressEvent().

◆ GetSourceFileCache()

SourceManager::SourceFileCache & lldb_private::Debugger::GetSourceFileCache ( )

inlineprotected

Definition at line 600 of file Debugger.h.

References m_source_file_cache.

◆ GetSourceManager()

SourceManager & Debugger::GetSourceManager ( )

Definition at line 1597 of file Debugger.cpp.

References m_source_manager_up.

Referenced by lldb_private::Disassembler::PrintInstructions().

◆ GetStaticBroadcasterClass()

ConstString Debugger::GetStaticBroadcasterClass ( )

static

Definition at line 787 of file Debugger.cpp.

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

◆ GetStopDisassemblyDisplay()

Debugger::StopDisassemblyType Debugger::GetStopDisassemblyDisplay ( ) const

Definition at line 494 of file Debugger.cpp.

Referenced by lldb_private::StackFrame::GetStatus().

◆ GetStopDisassemblyMaxSize()

uint64_t Debugger::GetStopDisassemblyMaxSize ( ) const

Definition at line 285 of file Debugger.cpp.

◆ GetStopShowColumn()

StopShowColumn Debugger::GetStopShowColumn ( ) const

Definition at line 456 of file Debugger.cpp.

Referenced by CommandObjectSourceList::DoExecute().

◆ GetStopShowColumnAnsiPrefix()

llvm::StringRef Debugger::GetStopShowColumnAnsiPrefix ( ) const

Definition at line 463 of file Debugger.cpp.

◆ GetStopShowColumnAnsiSuffix()

llvm::StringRef Debugger::GetStopShowColumnAnsiSuffix ( ) const

Definition at line 469 of file Debugger.cpp.

◆ GetStopShowLineMarkerAnsiPrefix()

llvm::StringRef Debugger::GetStopShowLineMarkerAnsiPrefix ( ) const

Definition at line 475 of file Debugger.cpp.

◆ GetStopShowLineMarkerAnsiSuffix()

llvm::StringRef Debugger::GetStopShowLineMarkerAnsiSuffix ( ) const

Definition at line 481 of file Debugger.cpp.

◆ GetStopSourceLineCount()

uint64_t Debugger::GetStopSourceLineCount ( bool before ) const

Definition at line 487 of file Debugger.cpp.

Referenced by lldb_private::StackFrame::GetStatus().

◆ GetTabSize()

uint64_t Debugger::GetTabSize ( ) const

Definition at line 541 of file Debugger.cpp.

Referenced by lldb_private::REPL::GetIOHandler(), and lldb_private::REPL::IOHandlerFixIndentation().

◆ GetTargetList()

TargetList & lldb_private::Debugger::GetTargetList ( )

inline

Get accessor for the target list.

The target list is part of the global debugger object. This the single debugger shared instance to control where targets get created and to allow for tracking and searching for targets based on certain criteria.

Returns: A global shared target list.

Definition at line 201 of file Debugger.h.

References m_target_list.

Referenced by PlatformPOSIX::Attach(), lldb_private::PlatformWindows::Attach(), lldb_private::platform_gdb_server::PlatformRemoteGDBServer::Attach(), lldb_private::trace_intel_pt::TraceIntelPTBundleLoader::CreateEmptyProcess(), lldb_private::Platform::DoConnectProcess(), CommandObjectTargetSelect::DoExecute(), CommandObjectTargetDelete::DoExecute(), CommandObjectProcessAttach::DoExecute(), CommandObjectTargetCreate::DoExecute(), lldb_private::Process::HandleProcessStateChangedEvent(), lldb_private::trace_intel_pt::TraceIntelPTBundleLoader::LoadBundle(), and lldb_private::DebuggerStats::ReportStatistics().

◆ GetTerminalWidth()

uint64_t Debugger::GetTerminalWidth ( ) const

Definition at line 346 of file Debugger.cpp.

Referenced by lldb_private::CommandObjectDisassemble::DoExecute(), HandleProgressEvent(), lldb_private::CommandInterpreter::OutputFormattedHelpText(), and lldb_private::CommandInterpreter::OutputHelpText().

◆ GetThreadFormat()

const FormatEntity::Entry * Debugger::GetThreadFormat ( ) const

Definition at line 314 of file Debugger.cpp.

Referenced by lldb_private::Thread::DumpUsingSettingsFormat().

◆ GetThreadPool()

llvm::ThreadPool & Debugger::GetThreadPool ( )

static

Shared thread poll. Use only with ThreadPoolTaskGroup.

Definition at line 2130 of file Debugger.cpp.

References g_thread_pool.

Referenced by lldb_private::Symbols::DownloadSymbolFileAsync(), and lldb_private::ManualDWARFIndex::Index().

◆ GetThreadStopFormat()

const FormatEntity::Entry * Debugger::GetThreadStopFormat ( ) const

Definition at line 319 of file Debugger.cpp.

Referenced by lldb_private::Thread::DumpUsingSettingsFormat().

◆ GetTopIOHandlerControlSequence()

ConstString Debugger::GetTopIOHandlerControlSequence ( char ch )

Definition at line 1130 of file Debugger.cpp.

References lldb_private::IOHandlerStack::GetTopIOHandlerControlSequence(), and m_io_handler_stack.

Referenced by lldb::SBCommandInterpreter::GetIOHandlerControlSequence().

◆ GetUseAutosuggestion()

bool Debugger::GetUseAutosuggestion ( ) const

Definition at line 418 of file Debugger.cpp.

Referenced by lldb_private::IOHandlerEditline::IOHandlerEditline().

◆ GetUseColor()

bool Debugger::GetUseColor ( ) const

Definition at line 382 of file Debugger.cpp.

◆ GetUseExternalEditor()

bool Debugger::GetUseExternalEditor ( ) const

Definition at line 360 of file Debugger.cpp.

Referenced by lldb_private::Thread::GetStatus(), and lldb_private::Thread::SetSelectedFrameByIndexNoisily().

◆ GetUseSourceCache()

bool Debugger::GetUseSourceCache ( ) const

Definition at line 436 of file Debugger.cpp.

Referenced by SetPropertyValue().

◆ HandleBreakpointEvent()

void Debugger::HandleBreakpointEvent ( const lldb::EventSP & event_sp )

protected

Definition at line 1604 of file Debugger.cpp.

References GetAsyncOutputStream(), lldb_private::Breakpoint::BreakpointEventData::GetBreakpointEventTypeFromEvent(), lldb_private::Breakpoint::BreakpointEventData::GetBreakpointFromEvent(), and lldb_private::Breakpoint::BreakpointEventData::GetNumBreakpointLocationsFromEvent().

Referenced by DefaultEventHandler().

◆ HandleDestroyCallback()

void Debugger::HandleDestroyCallback ( )

protected

Definition at line 706 of file Debugger.cpp.

References lldb_private::UserID::GetID(), m_destroy_callback, and m_destroy_callback_baton.

◆ HandleDiagnosticEvent()

void Debugger::HandleDiagnosticEvent ( const lldb::EventSP & event_sp )

protected

Definition at line 2023 of file Debugger.cpp.

References GetAsyncErrorStream(), and lldb_private::DiagnosticEventData::GetEventDataFromEvent().

Referenced by DefaultEventHandler().

◆ HandleProcessEvent()

void Debugger::HandleProcessEvent ( const lldb::EventSP & event_sp )

protected

Definition at line 1671 of file Debugger.cpp.

References lldb_private::Process::eBroadcastBitStateChanged, lldb_private::Process::eBroadcastBitSTDERR, lldb_private::Process::eBroadcastBitSTDOUT, lldb_private::Process::eBroadcastBitStructuredData, error(), lldb_private::StreamString::Flush(), FlushProcessOutput(), GetAsyncErrorStream(), GetAsyncOutputStream(), lldb_private::EventDataStructuredData::GetObjectFromEvent(), lldb_private::EventDataStructuredData::GetPluginFromEvent(), lldb_private::Process::ProcessEventData::GetProcessFromEvent(), lldb_private::EventDataStructuredData::GetProcessFromEvent(), lldb_private::Process::ProcessEventData::GetStateFromEvent(), lldb_private::StreamString::GetString(), lldb_private::Process::HandleProcessStateChangedEvent(), IsForwardingEvents(), lldb_private::Stream::PutChar(), SelectMostRelevantFrame, and lldb_private::StateIsStoppedState().

Referenced by DefaultEventHandler().

◆ HandleProgressEvent()

void Debugger::HandleProgressEvent ( const lldb::EventSP & event_sp )

protected

◆ HandleThreadEvent()

void Debugger::HandleThreadEvent ( const lldb::EventSP & event_sp )

protected

Definition at line 1758 of file Debugger.cpp.

References lldb_private::Thread::eBroadcastBitStackChanged, lldb_private::Thread::eBroadcastBitThreadSelected, GetAsyncOutputStream(), and lldb_private::Thread::ThreadEventData::GetThreadFromEvent().

Referenced by DefaultEventHandler().

◆ HasIOHandlerThread()

bool Debugger::HasIOHandlerThread ( ) const

protected

Definition at line 2032 of file Debugger.cpp.

References lldb_private::HostThread::IsJoinable(), and m_io_handler_thread.

Referenced by IsIOHandlerThreadCurrentThread(), JoinIOHandlerThread(), and lldb_private::REPL::RunLoop().

◆ Initialize()

void Debugger::Initialize ( LoadPluginCallbackType load_plugin_callback )

static

Definition at line 568 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, g_debugger_list_ptr, g_load_plugin_callback, and g_thread_pool.

Referenced by lldb_private::SystemLifetimeManager::Initialize().

◆ InstanceInitialize()

void Debugger::InstanceInitialize ( )

protected

Definition at line 669 of file Debugger.cpp.

References lldb_private::PluginManager::DebuggerInitialize(), lldb_private::FileSystem::EnumerateDirectory(), lldb_private::FileSystem::Instance(), LoadPluginCallback(), and PATH_MAX.

◆ InterruptRequested()

bool Debugger::InterruptRequested ( )

This is the correct way to query the state of Interruption.

If you are on the RunCommandInterpreter thread, it will check the command interpreter state, and if it is on another thread it will check the debugger Interrupt Request state.

Returns: A boolean value, if true an interruptible operation should interrupt itself.

Definition at line 1265 of file Debugger.cpp.

References GetCommandInterpreter(), IsIOHandlerThreadCurrentThread(), m_interrupt_mutex, m_interrupt_requested, and lldb_private::CommandInterpreter::WasInterrupted().

Referenced by lldb_private::CommandCompletions::FrameIndexes(), lldb_private::StackFrameList::GetFramesUpTo(), lldb_private::StackFrameList::GetStatus(), lldb::SBFrame::GetVariables(), and lldb::SBCommandInterpreter::WasInterrupted().

◆ IOHandlerThread()

lldb::thread_result_t Debugger::IOHandlerThread ( )

protected

Definition at line 1932 of file Debugger.cpp.

References RunIOHandlers(), and StopEventHandlerThread().

Referenced by StartIOHandlerThread().

◆ IsForwardingEvents()

bool Debugger::IsForwardingEvents ( )

Definition at line 1774 of file Debugger.cpp.

References m_forward_listener_sp.

Referenced by HandleProcessEvent().

◆ IsHandlingEvents()

bool lldb_private::Debugger::IsHandlingEvents ( ) const

inline

Definition at line 374 of file Debugger.h.

References lldb_private::HostThread::IsJoinable(), and m_event_handler_thread.

◆ IsIOHandlerThreadCurrentThread()

bool Debugger::IsIOHandlerThreadCurrentThread ( ) const

protected

Definition at line 2072 of file Debugger.cpp.

References lldb_private::HostThread::EqualsThread(), lldb_private::Host::GetCurrentThread(), HasIOHandlerThread(), and m_io_handler_thread.

Referenced by InterruptRequested(), and lldb_private::CommandInterpreter::WasInterrupted().

◆ IsTopIOHandler()

bool Debugger::IsTopIOHandler ( const lldb::IOHandlerSP & reader_sp )

Definition at line 1112 of file Debugger.cpp.

References lldb_private::IOHandlerStack::IsTop(), and m_io_handler_stack.

Referenced by lldb_private::CommandInterpreter::IsActive(), and lldb_private::Process::ProcessIOHandlerIsActive().

◆ JoinIOHandlerThread()

void Debugger::JoinIOHandlerThread ( )

protected

Definition at line 2064 of file Debugger.cpp.

References HasIOHandlerThread(), lldb_private::HostThread::Join(), LLDB_INVALID_HOST_THREAD, and m_io_handler_thread.

Referenced by lldb_private::REPL::RunLoop().

◆ LoadPlugin()

bool Debugger::LoadPlugin	(	const FileSpec &	spec,
		Status &	error
	)

Definition at line 607 of file Debugger.cpp.

References error(), g_load_plugin_callback, and m_loaded_plugins.

Referenced by LoadPluginCallback().

◆ operator=()

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

privatedelete

◆ PopIOHandler()

bool Debugger::PopIOHandler ( const lldb::IOHandlerSP & reader_sp )

protected

Definition at line 1219 of file Debugger.cpp.

References lldb_private::IOHandlerStack::GetMutex(), lldb_private::IOHandlerStack::IsEmpty(), m_io_handler_stack, lldb_private::IOHandlerStack::Pop(), and lldb_private::IOHandlerStack::Top().

Referenced by ClearIOHandlers(), RemoveIOHandler(), RunIOHandlers(), and RunIOHandlerSync().

◆ PrintAsync()

void Debugger::PrintAsync	(	const char *	s,
		size_t	len,
		bool	is_stdout
	)

Definition at line 1121 of file Debugger.cpp.

References m_error_stream_sp, m_io_handler_stack, m_output_stream_sp, and lldb_private::IOHandlerStack::PrintAsync().

Referenced by lldb_private::StreamAsynchronousIO::Flush().

◆ PrintProgress()

void lldb_private::Debugger::PrintProgress ( const ProgressEventData & data )

protected

◆ PushIOHandler()

void Debugger::PushIOHandler	(	const lldb::IOHandlerSP &	reader_sp,
		bool	cancel_top_handler = `true`
	)

protected

Definition at line 1192 of file Debugger.cpp.

References lldb_private::IOHandlerStack::GetMutex(), m_io_handler_stack, lldb_private::IOHandlerStack::Push(), and lldb_private::IOHandlerStack::Top().

Referenced by RunIOHandlerAsync(), and RunIOHandlerSync().

◆ RemoveIOHandler()

bool Debugger::RemoveIOHandler ( const lldb::IOHandlerSP & reader_sp )

Remove the given IO handler if it's currently active.

Definition at line 1142 of file Debugger.cpp.

References PopIOHandler().

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

◆ ReportDiagnosticImpl()

void Debugger::ReportDiagnosticImpl	(	DiagnosticEventData::Type	type,
		std::string	message,
		std::optional< lldb::user_id_t >	debugger_id,
		std::once_flag *	once
	)

staticprotected

Definition at line 1443 of file Debugger.cpp.

References lldb_private::Diagnostics::Enabled(), FindDebuggerWithID(), g_debugger_list_mutex_ptr, g_debugger_list_ptr, lldb_private::DiagnosticEventData::Info, lldb_private::Diagnostics::Instance(), PrivateReportDiagnostic(), and lldb_private::Diagnostics::Report().

Referenced by ReportError(), ReportInfo(), and ReportWarning().

◆ ReportError()

void Debugger::ReportError	(	std::string	message,
		std::optional< lldb::user_id_t >	debugger_id = `std::nullopt`,
		std::once_flag *	once = `nullptr`
	)

static

Report error events.

Error events will be delivered to any debuggers that have listeners for the eBroadcastBitError.

Parameters

[in]	message	The error message to be reported.
[in]	debugger_id	If this optional parameter has a value, it indicates the unique debugger identifier that this diagnostic should be delivered to. If this optional parameter does not have a value, the diagnostic event will be delivered to all debuggers.
[in]	once	If a pointer is passed to a std::once_flag, then it will be used to ensure the given error is only broadcast once.

Definition at line 1488 of file Debugger.cpp.

References lldb_private::DiagnosticEventData::Error, and ReportDiagnosticImpl().

Referenced by lldb_private::process_gdb_remote::ProcessGDBRemote::BuildDynamicRegisterInfo(), lldb_private::TargetProperties::CheckJITObjectsDir(), lldb_private::StructuredDataDarwinLog::EnableNow(), lldb_private::Function::GetBlock(), lldb_private::DWARFCallFrameInfo::GetFDEIndex(), lldb_private::Options::GetLongOptions(), lldb_private::PlatformMacOSX::GetSDKDirectory(), MachSymtabSectionInfo::GetSection(), GetXcodeSDKDir(), lldb_private::DWARFCallFrameInfo::ParseCIE(), ObjectFileMachO::ParseSymtab(), lldb_private::StopInfoBreakpoint::PerformAction(), lldb_private::StopInfoWatchpoint::PerformAction(), lldb_private::Module::RegisterXcodeSDK(), lldb_private::Module::ReportError(), lldb_private::Module::ReportErrorIfModifyDetected(), and lldb_private::CompactUnwindInfo::ScanIndex().

◆ ReportInfo()

void Debugger::ReportInfo	(	std::string	message,
		std::optional< lldb::user_id_t >	debugger_id = `std::nullopt`,
		std::once_flag *	once = `nullptr`
	)

static

Report info events.

Unlike warning and error events, info events are not broadcast but are logged for diagnostic purposes.

Parameters

[in]	message	The info message to be reported.
[in]	debugger_id	If this optional parameter has a value, it indicates this diagnostic is associated with a unique debugger instance.
[in]	once	If a pointer is passed to a std::once_flag, then it will be used to ensure the given info is only logged once.

Definition at line 1495 of file Debugger.cpp.

References lldb_private::DiagnosticEventData::Info, and ReportDiagnosticImpl().

◆ ReportProgress()

void Debugger::ReportProgress	(	uint64_t	progress_id,
		std::string	title,
		std::string	details,
		uint64_t	completed,
		uint64_t	total,
		std::optional< lldb::user_id_t >	debugger_id
	)

staticprotected

Report progress events.

Progress events will be delivered to any debuggers that have listeners for the eBroadcastBitProgress. This function is called by the lldb_private::Progress class to deliver the events to any debuggers that qualify.

Parameters

[in]	progress_id	The unique integer identifier for the progress to report.
[in]	message	The title of the progress dialog to display in the UI.
[in]	completed	The amount of work completed. If completed is zero, then this event is a progress started event. If completed is equal to total, then this event is a progress end event. Otherwise completed indicates the current progress compare to the total value.
[in]	total	The total amount of work units that need to be completed. If this value is UINT64_MAX, then an indeterminate progress indicator should be displayed.
[in]	debugger_id	If this optional parameter has a value, it indicates the unique debugger identifier that this progress should be delivered to. If this optional parameter does not have a value, the progress will be delivered to all debuggers.

Definition at line 1385 of file Debugger.cpp.

References FindDebuggerWithID(), g_debugger_list_mutex_ptr, g_debugger_list_ptr, and PrivateReportProgress().

Referenced by lldb_private::Progress::ReportProgress().

◆ ReportSymbolChange()

void Debugger::ReportSymbolChange ( const ModuleSpec & module_spec )

static

Definition at line 1502 of file Debugger.cpp.

References eBroadcastSymbolChange, g_debugger_list_mutex_ptr, and g_debugger_list_ptr.

Referenced by lldb_private::Symbols::DownloadSymbolFileAsync().

◆ ReportWarning()

void Debugger::ReportWarning	(	std::string	message,
		std::optional< lldb::user_id_t >	debugger_id = `std::nullopt`,
		std::once_flag *	once = `nullptr`
	)

static

Report warning events.

Warning events will be delivered to any debuggers that have listeners for the eBroadcastBitWarning.

Parameters

[in]	message	The warning message to be reported.
[in]	debugger_id	If this optional parameter has a value, it indicates the unique debugger identifier that this diagnostic should be delivered to. If this optional parameter does not have a value, the diagnostic event will be delivered to all debuggers.
[in]	once	If a pointer is passed to a std::once_flag, then it will be used to ensure the given warning is only broadcast once.

Definition at line 1481 of file Debugger.cpp.

References ReportDiagnosticImpl(), and lldb_private::DiagnosticEventData::Warning.

Referenced by lldb_private::minidump::ProcessMinidump::DoLoadCore(), lldb_private::MemoryHistoryASan::GetHistoryThreads(), lldb_private::SymbolContext::GetParentOfInlinedScope(), DynamicLoaderMacOS::NotifyBreakpointHit(), DynamicLoaderMacOSXDYLD::NotifyBreakpointHit(), lldb_private::StopInfoBreakpoint::PerformAction(), lldb_private::Module::ReportWarning(), lldb_private::Module::ReportWarningOptimization(), lldb_private::Module::ReportWarningUnsupportedLanguage(), lldb_private::InstrumentationRuntimeASan::RetrieveReportData(), lldb_private::InstrumentationRuntimeTSan::RetrieveReportData(), lldb_private::InstrumentationRuntimeUBSan::RetrieveReportData(), lldb_private::DynamicLoaderDarwin::UnloadModuleSections(), lldb_private::AppleObjCRuntimeV2::WarnIfNoClassesCached(), and lldb_private::AppleObjCRuntimeV2::WarnIfNoExpandedSharedCache().

◆ RequestInterrupt()

void Debugger::RequestInterrupt ( )

Interruption in LLDB:

This is a voluntary interruption mechanism, not preemptive. Parts of lldb that do work that can be safely interrupted call Debugger::InterruptRequested and if that returns true, they should return at a safe point, shortcutting the rest of the work they were to do.

lldb clients can both offer a CommandInterpreter (through RunCommandInterpreter) and use the SB API's for their own purposes, so it is convenient to separate "interrupting the CommandInterpreter execution" and interrupting the work it is doing with the SB API's. So there are two ways to cause an interrupt:

CommandInterpreter::InterruptCommand: Interrupts the command currently running in the command interpreter IOHandler thread
Debugger::RequestInterrupt: Interrupts are active on anything but the CommandInterpreter thread till CancelInterruptRequest is called.

Since the two checks are mutually exclusive, however, it's also convenient to have just one function to check the interrupt state. Bump the "interrupt requested" count on the debugger to support cooperative interruption. If this is non-zero, InterruptRequested will return true. Interruptible operations are expected to query the InterruptRequested API periodically, and interrupt what they were doing if it returns true.

Definition at line 1254 of file Debugger.cpp.

References m_interrupt_mutex, and m_interrupt_requested.

◆ RestoreInputTerminalState()

void Debugger::RestoreInputTerminalState ( )

Definition at line 1020 of file Debugger.cpp.

References m_terminal_state.

◆ RunIOHandlerAsync()

void Debugger::RunIOHandlerAsync	(	const lldb::IOHandlerSP &	reader_sp,
		bool	cancel_top_handler = `true`
	)

Run the given IO handler and return immediately.

Definition at line 1146 of file Debugger.cpp.

References PushIOHandler().

Referenced by lldb_private::ScriptInterpreterLua::CollectDataForBreakpointCommandCallback(), lldb_private::ScriptInterpreterLua::CollectDataForWatchpointCommandCallback(), lldb_private::CommandObjectGUI::DoExecute(), lldb_private::ScriptInterpreterLua::ExecuteInterpreterLoop(), lldb_private::CommandInterpreter::GetLLDBCommandsFromIOHandler(), lldb_private::CommandInterpreter::GetPythonCommandsFromIOHandler(), lldb_private::REPL::IOHandlerInputComplete(), lldb_private::Process::PushProcessIOHandler(), lldb_private::CommandInterpreter::RunCommandInterpreter(), and lldb_private::REPL::RunLoop().

◆ RunIOHandlers()

void Debugger::RunIOHandlers ( )

Definition at line 1053 of file Debugger.cpp.

References ClearIOHandlers(), m_io_handler_stack, m_io_handler_synchronous_mutex, PopIOHandler(), and lldb_private::IOHandlerStack::Top().

Referenced by IOHandlerThread(), and lldb_private::CommandInterpreter::RunCommandInterpreter().

◆ RunIOHandlerSync()

void Debugger::RunIOHandlerSync ( const lldb::IOHandlerSP & reader_sp )

Run the given IO handler and block until it's complete.

Definition at line 1078 of file Debugger.cpp.

References m_io_handler_stack, m_io_handler_synchronous_mutex, PopIOHandler(), PushIOHandler(), and lldb_private::IOHandlerStack::Top().

Referenced by lldb_private::CommandInterpreter::Confirm(), and lldb_private::CommandInterpreter::HandleCommandsFromFile().

◆ RunREPL()

Status Debugger::RunREPL	(	lldb::LanguageType	language,
		const char *	repl_options
	)

Definition at line 2086 of file Debugger.cpp.

References lldb_private::REPL::Create(), lldb::eLanguageTypeUnknown, lldb_private::LanguageSet::Empty(), lldb_private::Language::GetLanguagesSupportingREPLs(), lldb_private::Language::GetNameForLanguageType(), GetREPLLanguage(), lldb_private::LanguageSet::GetSingularLanguage(), lldb_private::Status::SetErrorString(), lldb_private::Status::SetErrorStringWithFormat(), and lldb_private::Status::Success().

◆ SaveInputTerminalState()

void Debugger::SaveInputTerminalState ( )

Definition at line 1014 of file Debugger.cpp.

References lldb_private::File::GetDescriptor(), GetInputFile(), lldb_private::File::kInvalidDescriptor, and m_terminal_state.

Referenced by SetInputFile().

◆ SetAsyncExecution()

void Debugger::SetAsyncExecution ( bool async )

Definition at line 938 of file Debugger.cpp.

References m_command_interpreter_up.

Referenced by CommandObjectProcessContinue::DoExecute(), lldb_private::CommandInterpreter::HandleCommands(), lldb_private::CommandInterpreter::HandleCommandsFromFile(), lldb_private::Target::StopHookCommandLine::HandleStop(), lldb_private::StopInfoBreakpoint::PerformAction(), and lldb_private::StopInfoWatchpoint::PerformAction().

◆ SetAutoIndent()

bool Debugger::SetAutoIndent ( bool b )

Definition at line 525 of file Debugger.cpp.

References lldb_private::Properties::SetPropertyAtIndex().

◆ SetCloseInputOnEOF()

void Debugger::SetCloseInputOnEOF ( bool b )

Definition at line 930 of file Debugger.cpp.

◆ SetDestroyCallback()

void Debugger::SetDestroyCallback	(	lldb_private::DebuggerDestroyCallback	destroy_callback,
		void *	baton
	)

Definition at line 1364 of file Debugger.cpp.

References m_destroy_callback, and m_destroy_callback_baton.

◆ SetErrorFile()

void Debugger::SetErrorFile ( lldb::FileSP file )

Definition at line 1009 of file Debugger.cpp.

References m_error_stream_sp.

◆ SetExternalEditor()

bool Debugger::SetExternalEditor ( llvm::StringRef editor )

Definition at line 377 of file Debugger.cpp.

References lldb_private::Properties::SetPropertyAtIndex().

◆ SetInputFile()

void Debugger::SetInputFile ( lldb::FileSP file )

Definition at line 996 of file Debugger.cpp.

References m_input_file_sp, and SaveInputTerminalState().

Referenced by SetInputString().

◆ SetInputString()

Status Debugger::SetInputString ( const char * data )

Definition at line 953 of file Debugger.cpp.

References OpenPipe(), READ, lldb_private::Status::SetErrorString(), lldb_private::Status::SetErrorStringWithFormat(), SetInputFile(), and WRITE.

◆ SetIOHandlerThread()

HostThread Debugger::SetIOHandlerThread ( HostThread & new_thread )

protected

Definition at line 2036 of file Debugger.cpp.

References m_io_handler_thread.

Referenced by lldb_private::CommandInterpreter::RunCommandInterpreter().

◆ SetLoggingCallback()

void Debugger::SetLoggingCallback	(	lldb::LogOutputCallback	log_callback,
		void *	baton
	)

Definition at line 1355 of file Debugger.cpp.

References m_callback_handler_sp.

◆ SetOutputFile()

void Debugger::SetOutputFile ( lldb::FileSP file )

Definition at line 1004 of file Debugger.cpp.

References m_output_stream_sp.

◆ SetPrintDecls()

bool Debugger::SetPrintDecls ( bool b )

Definition at line 536 of file Debugger.cpp.

References lldb_private::Properties::SetPropertyAtIndex().

◆ SetPrompt() [1/2]

void lldb_private::Debugger::SetPrompt ( const char * )

delete

◆ SetPrompt() [2/2]

void Debugger::SetPrompt ( llvm::StringRef p )

Definition at line 303 of file Debugger.cpp.

References lldb_private::ansi::FormatAnsiTerminalCodes(), GetCommandInterpreter(), GetPrompt(), GetUseColor(), lldb_private::Properties::SetPropertyAtIndex(), and lldb_private::CommandInterpreter::UpdatePrompt().

Referenced by SetPropertyValue(), and SetUseColor().

◆ SetPropertyValue()

Status Debugger::SetPropertyValue	(	const ExecutionContext *	exe_ctx,
		VarSetOperationType	op,
		llvm::StringRef	property_path,
		llvm::StringRef	value
	)

overridevirtual

Reimplemented from lldb_private::Properties.

Definition at line 200 of file Debugger.cpp.

References lldb_private::Broadcaster::BroadcastEvent(), lldb_private::SourceManager::SourceFileCache::Clear(), lldb_private::CommandInterpreter::eBroadcastBitResetPrompt, lldb_private::eLoadScriptFromSymFileFalse, lldb_private::eLoadScriptFromSymFileTrue, lldb_private::eLoadScriptFromSymFileWarn, error(), lldb_private::DataVisualization::ForceUpdate(), lldb_private::ansi::FormatAnsiTerminalCodes(), GetCommandInterpreter(), GetErrorStream(), GetPrompt(), lldb_private::StreamString::GetSize(), lldb_private::StreamString::GetString(), lldb_private::ExecutionContext::GetTargetSP(), GetUseColor(), GetUseSourceCache(), m_source_file_cache, lldb_private::Stream::Printf(), lldb_private::Stream::PutCString(), SetPrompt(), lldb_private::Properties::SetPropertyValue(), and lldb_private::CommandInterpreter::UpdatePrompt().

◆ SetREPLLanguage()

bool Debugger::SetREPLLanguage ( lldb::LanguageType repl_lang )

Definition at line 341 of file Debugger.cpp.

References lldb_private::Properties::SetPropertyAtIndex().

◆ SetScriptLanguage()

bool Debugger::SetScriptLanguage ( lldb::ScriptLanguage script_lang )

Definition at line 331 of file Debugger.cpp.

References lldb_private::Properties::SetPropertyAtIndex().

◆ SetShowProgress()

bool Debugger::SetShowProgress ( bool show_progress )

Definition at line 401 of file Debugger.cpp.

References lldb_private::Properties::SetPropertyAtIndex().

Referenced by lldb_private::REPL::REPL().

◆ SetTabSize()

bool Debugger::SetTabSize ( uint64_t tab_size )

Definition at line 547 of file Debugger.cpp.

References lldb_private::Properties::SetPropertyAtIndex().

◆ SetTerminalWidth()

bool Debugger::SetTerminalWidth ( uint64_t term_width )

Definition at line 352 of file Debugger.cpp.

References m_io_handler_stack, lldb_private::Properties::SetPropertyAtIndex(), and lldb_private::IOHandlerStack::Top().

◆ SettingsInitialize()

void Debugger::SettingsInitialize ( )

static

Definition at line 603 of file Debugger.cpp.

References lldb_private::Target::SettingsInitialize().

Referenced by lldb_private::SystemInitializerFull::Initialize().

◆ SettingsTerminate()

void Debugger::SettingsTerminate ( )

static

Definition at line 605 of file Debugger.cpp.

References lldb_private::Target::SettingsTerminate().

Referenced by lldb_private::SystemInitializerFull::Terminate().

◆ SetUseColor()

bool Debugger::SetUseColor ( bool use_color )

Definition at line 388 of file Debugger.cpp.

References GetPrompt(), SetPrompt(), and lldb_private::Properties::SetPropertyAtIndex().

Referenced by Debugger().

◆ SetUseExternalEditor()

bool Debugger::SetUseExternalEditor ( bool use_external_editor_p )

Definition at line 366 of file Debugger.cpp.

References lldb_private::Properties::SetPropertyAtIndex().

◆ SetUseSourceCache()

bool Debugger::SetUseSourceCache ( bool use_source_cache )

Definition at line 442 of file Debugger.cpp.

References lldb_private::SourceManager::SourceFileCache::Clear(), m_source_file_cache, and lldb_private::Properties::SetPropertyAtIndex().

◆ StartEventHandlerThread()

bool Debugger::StartEventHandlerThread ( )

Manually start the global event handler thread.

It is useful to plugins that directly use the lldb_private namespace and want to use the debugger's default event handler thread instead of defining their own.

Definition at line 1884 of file Debugger.cpp.

References lldb_private::ConstString::AsCString(), DefaultEventHandler(), eBroadcastBitEventThreadIsListening, g_debugger_event_thread_stack_bytes, lldb_private::ConstString::GetLength(), lldb_private::GetLog(), lldb_private::ConstString::GetStringRef(), lldb_private::Host, lldb_private::HostThread::IsJoinable(), lldb_private::ThreadLauncher::LaunchThread(), LLDB_LOG, m_event_handler_thread, m_sync_broadcaster, and lldb_private::Listener::MakeListener().

Referenced by lldb_private::CommandInterpreter::RunCommandInterpreter().

◆ StartIOHandlerThread()

bool Debugger::StartIOHandlerThread ( )

protected

Definition at line 2042 of file Debugger.cpp.

References lldb_private::GetLog(), lldb_private::Host, IOHandlerThread(), lldb_private::HostThread::IsJoinable(), lldb_private::ThreadLauncher::LaunchThread(), LLDB_LOG, and m_io_handler_thread.

Referenced by lldb_private::CommandInterpreter::RunCommandInterpreter(), and lldb_private::REPL::RunLoop().

◆ StopEventHandlerThread()

void Debugger::StopEventHandlerThread ( )

Manually stop the debugger's default event handler.

Definition at line 1924 of file Debugger.cpp.

References lldb_private::Broadcaster::BroadcastEvent(), lldb_private::CommandInterpreter::eBroadcastBitQuitCommandReceived, GetCommandInterpreter(), lldb_private::HostThread::IsJoinable(), lldb_private::HostThread::Join(), and m_event_handler_thread.

Referenced by Clear(), IOHandlerThread(), and lldb_private::CommandInterpreter::RunCommandInterpreter().

◆ StopIOHandlerThread()

void Debugger::StopIOHandlerThread ( )

protected

Definition at line 2057 of file Debugger.cpp.

References lldb_private::File::Close(), GetInputFile(), lldb_private::HostThread::IsJoinable(), lldb_private::HostThread::Join(), and m_io_handler_thread.

Referenced by Clear().

◆ Terminate()

void Debugger::Terminate ( )

static

Definition at line 577 of file Debugger.cpp.

References g_debugger_list_mutex_ptr, g_debugger_list_ptr, and g_thread_pool.

Referenced by lldb_private::SystemLifetimeManager::Terminate().

Friends And Related Function Documentation

◆ CommandInterpreter

friend class CommandInterpreter

friend

Definition at line 517 of file Debugger.h.

◆ Progress

friend class Progress

friend

Definition at line 519 of file Debugger.h.

◆ REPL

friend class REPL

friend

Definition at line 518 of file Debugger.h.

◆ SourceManager

friend class SourceManager

friend

Definition at line 79 of file Debugger.h.

Member Data Documentation

◆ g_load_plugin_callback

LoadPluginCallbackType Debugger::g_load_plugin_callback = nullptr

staticprotected

Definition at line 648 of file Debugger.h.

Referenced by Initialize(), and LoadPlugin().

◆ m_broadcaster

Broadcaster lldb_private::Debugger::m_broadcaster

protected

Public Debugger event broadcaster.

Definition at line 654 of file Debugger.h.

Referenced by DefaultEventHandler(), and GetBroadcaster().

◆ m_broadcaster_manager_sp

lldb::BroadcasterManagerSP lldb_private::Debugger::m_broadcaster_manager_sp

protected

Definition at line 614 of file Debugger.h.

Referenced by Clear(), DefaultEventHandler(), and GetBroadcasterManager().

◆ m_callback_handler_sp

std::shared_ptr<CallbackLogHandler> lldb_private::Debugger::m_callback_handler_sp

protected

Definition at line 646 of file Debugger.h.

Referenced by Debugger(), EnableLog(), and SetLoggingCallback().

◆ m_clear_once

llvm::once_flag lldb_private::Debugger::m_clear_once

protected

Definition at line 656 of file Debugger.h.

Referenced by Clear().

◆ m_command_interpreter_up

std::unique_ptr<CommandInterpreter> lldb_private::Debugger::m_command_interpreter_up

protected

Definition at line 634 of file Debugger.h.

Referenced by Clear(), Debugger(), DefaultEventHandler(), GetAsyncExecution(), GetCommandInterpreter(), and SetAsyncExecution().

◆ m_current_event_id

std::optional<uint64_t> lldb_private::Debugger::m_current_event_id

protected

Definition at line 643 of file Debugger.h.

Referenced by HandleProgressEvent().

◆ m_destroy_callback

lldb_private::DebuggerDestroyCallback lldb_private::Debugger::m_destroy_callback = nullptr

protected

Definition at line 660 of file Debugger.h.

Referenced by HandleDestroyCallback(), and SetDestroyCallback().

◆ m_destroy_callback_baton

void* lldb_private::Debugger::m_destroy_callback_baton = nullptr

protected

Definition at line 661 of file Debugger.h.

Referenced by HandleDestroyCallback(), and SetDestroyCallback().

◆ m_diagnostics_callback_id

Diagnostics::CallbackID lldb_private::Debugger::m_diagnostics_callback_id

protected

Definition at line 658 of file Debugger.h.

Referenced by Clear(), and Debugger().

◆ m_dummy_target_sp

lldb::TargetSP lldb_private::Debugger::m_dummy_target_sp

protected

Definition at line 657 of file Debugger.h.

Referenced by Debugger(), and GetDummyTarget().

◆ m_error_stream_sp

lldb::StreamFileSP lldb_private::Debugger::m_error_stream_sp

protected

Definition at line 609 of file Debugger.h.

Referenced by GetErrorFile(), GetErrorStream(), GetErrorStreamSP(), PrintAsync(), and SetErrorFile().

◆ m_event_handler_thread

HostThread lldb_private::Debugger::m_event_handler_thread

protected

Definition at line 651 of file Debugger.h.

Referenced by IsHandlingEvents(), StartEventHandlerThread(), and StopEventHandlerThread().

◆ m_forward_listener_sp

lldb::ListenerSP lldb_private::Debugger::m_forward_listener_sp

protected

Definition at line 655 of file Debugger.h.

Referenced by CancelForwardEvents(), DefaultEventHandler(), EnableForwardEvents(), and IsForwardingEvents().

◆ m_input_file_sp

lldb::FileSP lldb_private::Debugger::m_input_file_sp

protected

Definition at line 607 of file Debugger.h.

Referenced by GetInputFile(), GetInputFileSP(), and SetInputFile().

◆ m_input_recorder

repro::DataRecorder* lldb_private::Debugger::m_input_recorder

protected

Used for shadowing the input file when capturing a reproducer.

Definition at line 612 of file Debugger.h.

Referenced by GetInputRecorder().

◆ m_instance_name

const std::string lldb_private::Debugger::m_instance_name

protected

Definition at line 647 of file Debugger.h.

Referenced by GetInstanceName().

◆ m_interrupt_mutex

std::mutex lldb_private::Debugger::m_interrupt_mutex

protected

Definition at line 664 of file Debugger.h.

Referenced by CancelInterruptRequest(), InterruptRequested(), and RequestInterrupt().

◆ m_interrupt_requested

uint32_t lldb_private::Debugger::m_interrupt_requested = 0

protected

Tracks interrupt requests.

Definition at line 663 of file Debugger.h.

Referenced by CancelInterruptRequest(), InterruptRequested(), and RequestInterrupt().

◆ m_io_handler_stack

IOHandlerStack lldb_private::Debugger::m_io_handler_stack

protected

Definition at line 640 of file Debugger.h.

Referenced by AdoptTopIOHandlerFilesIfInvalid(), CheckTopIOHandlerTypes(), ClearIOHandlers(), DispatchInputEndOfFile(), DispatchInputInterrupt(), GetIOHandlerCommandPrefix(), GetIOHandlerHelpPrologue(), GetTopIOHandlerControlSequence(), IsTopIOHandler(), PopIOHandler(), PrintAsync(), PushIOHandler(), RunIOHandlers(), RunIOHandlerSync(), and SetTerminalWidth().

◆ m_io_handler_synchronous_mutex

std::recursive_mutex lldb_private::Debugger::m_io_handler_synchronous_mutex

protected

Definition at line 641 of file Debugger.h.

Referenced by RunIOHandlers(), and RunIOHandlerSync().

◆ m_io_handler_thread

HostThread lldb_private::Debugger::m_io_handler_thread

protected

Definition at line 652 of file Debugger.h.

Referenced by HasIOHandlerThread(), IsIOHandlerThreadCurrentThread(), JoinIOHandlerThread(), SetIOHandlerThread(), StartIOHandlerThread(), and StopIOHandlerThread().

◆ m_listener_sp

lldb::ListenerSP lldb_private::Debugger::m_listener_sp

protected

Definition at line 624 of file Debugger.h.

Referenced by Clear(), and GetListener().

◆ m_loaded_plugins

LoadedPluginsList lldb_private::Debugger::m_loaded_plugins

protected

Definition at line 650 of file Debugger.h.

Referenced by LoadPlugin().

◆ m_output_flush_mutex

std::mutex lldb_private::Debugger::m_output_flush_mutex

protected

Definition at line 598 of file Debugger.h.

Referenced by FlushProcessOutput().

◆ m_output_stream_sp

lldb::StreamFileSP lldb_private::Debugger::m_output_stream_sp

protected

Definition at line 608 of file Debugger.h.

Referenced by GetOutputFile(), GetOutputStream(), GetOutputStreamSP(), PrintAsync(), and SetOutputFile().

◆ m_platform_list

PlatformList lldb_private::Debugger::m_platform_list

protected

Definition at line 623 of file Debugger.h.

Referenced by Debugger(), and GetPlatformList().

◆ m_script_interpreter_mutex

std::recursive_mutex lldb_private::Debugger::m_script_interpreter_mutex

protected

Definition at line 636 of file Debugger.h.

Referenced by GetScriptInterpreter().

◆ m_script_interpreters

std::array<lldb::ScriptInterpreterSP, lldb::eScriptLanguageUnknown> lldb_private::Debugger::m_script_interpreters

protected

Definition at line 638 of file Debugger.h.

Referenced by GetScriptInterpreter().

◆ m_source_file_cache

SourceManager::SourceFileCache lldb_private::Debugger::m_source_file_cache

protected

Definition at line 629 of file Debugger.h.

Referenced by GetSourceFileCache(), SetPropertyValue(), and SetUseSourceCache().

◆ m_source_manager_up

std::unique_ptr<SourceManager> lldb_private::Debugger::m_source_manager_up

protected

Definition at line 625 of file Debugger.h.

Referenced by GetSourceManager().

◆ m_stream_handlers

llvm::StringMap<std::weak_ptr<LogHandler> > lldb_private::Debugger::m_stream_handlers

protected

Definition at line 645 of file Debugger.h.

Referenced by Debugger(), and EnableLog().

◆ m_sync_broadcaster

Broadcaster lldb_private::Debugger::m_sync_broadcaster

protected

Private debugger synchronization.

Definition at line 653 of file Debugger.h.

Referenced by DefaultEventHandler(), and StartEventHandlerThread().

◆ m_target_list

TargetList lldb_private::Debugger::m_target_list

protected

Definition at line 621 of file Debugger.h.

Referenced by Clear(), GetSelectedOrDummyTarget(), GetSelectedTarget(), and GetTargetList().

◆ m_terminal_state

TerminalState lldb_private::Debugger::m_terminal_state

protected

Definition at line 620 of file Debugger.h.

Referenced by Clear(), RestoreInputTerminalState(), and SaveInputTerminalState().

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

Public Types

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Friends

Detailed Description

Member Typedef Documentation

◆ LoadedPluginsList

Member Enumeration Documentation

◆ anonymous enum

◆ anonymous enum

◆ StopDisassemblyType

Constructor & Destructor Documentation

◆ ~Debugger()

◆ Debugger() [1/2]

◆ Debugger() [2/2]

Member Function Documentation

◆ AdoptTopIOHandlerFilesIfInvalid()

◆ CancelForwardEvents()

◆ CancelInterruptRequest()

◆ CheckTopIOHandlerTypes()

◆ Clear()

◆ ClearIOHandlers()

◆ CreateInstance()

◆ DefaultEventHandler()

◆ Destroy()

◆ DispatchInputEndOfFile()

◆ DispatchInputInterrupt()

◆ EnableForwardEvents()

◆ EnableLog()

◆ FindDebuggerWithID()

◆ FindDebuggerWithInstanceName()

◆ FindTargetWithProcess()

◆ FindTargetWithProcessID()

◆ FlushProcessOutput()

◆ FormatDisassemblerAddress()

◆ GetAsyncErrorStream()

◆ GetAsyncExecution()

◆ GetAsyncOutputStream()

◆ GetAutoConfirm()

◆ GetAutoIndent()

◆ GetAutoOneLineSummaries()

◆ GetAutosuggestionAnsiPrefix()

◆ GetAutosuggestionAnsiSuffix()

◆ GetBroadcaster() [1/2]

◆ GetBroadcaster() [2/2]

◆ GetBroadcasterManager()

◆ GetCloseInputOnEOF()

◆ GetCommandInterpreter()

◆ GetDebuggerAtIndex()

◆ GetDisassemblyFormat()

◆ GetDisassemblyLineCount()

◆ GetDummyTarget()

◆ GetDWIMPrintVerbosity()

◆ GetErrorFile()

◆ GetErrorStream()

◆ GetErrorStreamSP()

◆ GetEscapeNonPrintables()

◆ GetExternalEditor()

◆ GetFrameFormat()

◆ GetFrameFormatUnique()

◆ GetHighlightSource()

◆ GetInputFile()

◆ GetInputFileSP()

◆ GetInputRecorder()

◆ GetInstanceName()

◆ GetIOHandlerCommandPrefix()

◆ GetIOHandlerHelpPrologue()

◆ GetListener()

◆ GetNotifyVoid()

◆ GetNumDebuggers()

◆ GetOutputFile()

◆ GetOutputStream()

◆ GetOutputStreamSP()

◆ GetPlatformList()