#include <SBProcess.h>

Collaboration diagram for lldb::SBProcess:

Public Member Functions
	FLAGS_ANONYMOUS_ENUM ()
	Broadcaster event bits definitions. More...

	SBProcess ()

	SBProcess (const lldb::SBProcess &rhs)

const lldb::SBProcess &	operator= (const lldb::SBProcess &rhs)

	SBProcess (const lldb::ProcessSP &process_sp)

	~SBProcess ()

const char *	GetPluginName ()

const char *	GetShortPluginName ()

void	Clear ()

	operator bool () const

bool	IsValid () const

lldb::SBTarget	GetTarget () const

lldb::ByteOrder	GetByteOrder () const

size_t	PutSTDIN (const char *src, size_t src_len)

size_t	GetSTDOUT (char *dst, size_t dst_len) const

size_t	GetSTDERR (char *dst, size_t dst_len) const

size_t	GetAsyncProfileData (char *dst, size_t dst_len) const

void	ReportEventState (const lldb::SBEvent &event, FILE *out) const

void	AppendEventStateReport (const lldb::SBEvent &event, lldb::SBCommandReturnObject &result)

bool	RemoteAttachToProcessWithID (lldb::pid_t pid, lldb::SBError &error)
	Remote connection related functions. More...

bool	RemoteLaunch (char const argv, char const envp, const char stdin_path, const char stdout_path, const char stderr_path, const char working_directory, uint32_t launch_flags, bool stop_at_entry, lldb::SBError &error)

uint32_t	GetNumThreads ()

lldb::SBThread	GetThreadAtIndex (size_t index)

lldb::SBThread	GetThreadByID (lldb::tid_t sb_thread_id)

lldb::SBThread	GetThreadByIndexID (uint32_t index_id)

lldb::SBThread	GetSelectedThread () const

lldb::SBThread	CreateOSPluginThread (lldb::tid_t tid, lldb::addr_t context)

bool	SetSelectedThread (const lldb::SBThread &thread)

bool	SetSelectedThreadByID (lldb::tid_t tid)

bool	SetSelectedThreadByIndexID (uint32_t index_id)

uint32_t	GetNumQueues ()

lldb::SBQueue	GetQueueAtIndex (size_t index)

lldb::StateType	GetState ()

int	GetExitStatus ()

const char *	GetExitDescription ()

lldb::pid_t	GetProcessID ()
	Gets the process ID. More...

uint32_t	GetUniqueID ()
	Gets the unique ID associated with this process object. More...

uint32_t	GetAddressByteSize () const

lldb::SBError	Destroy ()

lldb::SBError	Continue ()

lldb::SBError	Stop ()

lldb::SBError	Kill ()

lldb::SBError	Detach ()

lldb::SBError	Detach (bool keep_stopped)

lldb::SBError	Signal (int signal)

lldb::SBUnixSignals	GetUnixSignals ()

void	SendAsyncInterrupt ()

uint32_t	GetStopID (bool include_expression_stops=false)

lldb::SBEvent	GetStopEventForStopID (uint32_t stop_id)
	Gets the stop event corresponding to stop ID. More...

size_t	ReadMemory (addr_t addr, void *buf, size_t size, lldb::SBError &error)

size_t	WriteMemory (addr_t addr, const void *buf, size_t size, lldb::SBError &error)

size_t	ReadCStringFromMemory (addr_t addr, void *buf, size_t size, lldb::SBError &error)

uint64_t	ReadUnsignedFromMemory (addr_t addr, uint32_t byte_size, lldb::SBError &error)

lldb::addr_t	ReadPointerFromMemory (addr_t addr, lldb::SBError &error)

lldb::SBBroadcaster	GetBroadcaster () const

bool	GetDescription (lldb::SBStream &description)

lldb::SBTrace	StartTrace (SBTraceOptions &options, lldb::SBError &error)
	Start Tracing with the given SBTraceOptions. More...

uint32_t	GetNumSupportedHardwareWatchpoints (lldb::SBError &error) const

uint32_t	LoadImage (lldb::SBFileSpec &remote_image_spec, lldb::SBError &error)
	Load a shared library into this process. More...

uint32_t	LoadImage (const lldb::SBFileSpec &local_image_spec, const lldb::SBFileSpec &remote_image_spec, lldb::SBError &error)
	Load a shared library into this process. More...

uint32_t	LoadImageUsingPaths (const lldb::SBFileSpec &image_spec, SBStringList &paths, lldb::SBFileSpec &loaded_path, lldb::SBError &error)
	Load a shared library into this process, starting with a library name and a list of paths, searching along the list of paths till you find a matching library. More...

lldb::SBError	UnloadImage (uint32_t image_token)

lldb::SBError	SendEventData (const char *data)

uint32_t	GetNumExtendedBacktraceTypes ()
	Return the number of different thread-origin extended backtraces this process can support. More...

const char *	GetExtendedBacktraceTypeAtIndex (uint32_t idx)
	Return the name of one of the thread-origin extended backtrace methods. More...

lldb::SBThreadCollection	GetHistoryThreads (addr_t addr)

bool	IsInstrumentationRuntimePresent (InstrumentationRuntimeType type)

lldb::SBError	SaveCore (const char *file_name)
	Save the state of the process in a core file (or mini dump on Windows). More...

lldb::SBError	GetMemoryRegionInfo (lldb::addr_t load_addr, lldb::SBMemoryRegionInfo &region_info)
	Query the address load_addr and store the details of the memory region that contains it in the supplied SBMemoryRegionInfo object. More...

lldb::SBMemoryRegionInfoList	GetMemoryRegions ()
	Return the list of memory regions within the process. More...

lldb::SBProcessInfo	GetProcessInfo ()
	Return information about the process. More...

Static Public Member Functions
static const char *	GetBroadcasterClassName ()

static lldb::StateType	GetStateFromEvent (const lldb::SBEvent &event)

static bool	GetRestartedFromEvent (const lldb::SBEvent &event)

static size_t	GetNumRestartedReasonsFromEvent (const lldb::SBEvent &event)

static const char *	GetRestartedReasonAtIndexFromEvent (const lldb::SBEvent &event, size_t idx)

static lldb::SBProcess	GetProcessFromEvent (const lldb::SBEvent &event)

static bool	GetInterruptedFromEvent (const lldb::SBEvent &event)

static lldb::SBStructuredData	GetStructuredDataFromEvent (const lldb::SBEvent &event)

static bool	EventIsProcessEvent (const lldb::SBEvent &event)

static bool	EventIsStructuredDataEvent (const lldb::SBEvent &event)

static const char *	GetBroadcasterClass ()

Protected Member Functions
lldb::ProcessSP	GetSP () const

void	SetSP (const lldb::ProcessSP &process_sp)

Protected Attributes
lldb::ProcessWP	m_opaque_wp

Friends
class	SBAddress

class	SBBreakpoint

class	SBBreakpointLocation

class	SBCommandInterpreter

class	SBDebugger

class	SBExecutionContext

class	SBFunction

class	SBModule

class	SBTarget

class	SBThread

class	SBValue

class	lldb_private::QueueImpl

Detailed Description

Definition at line 23 of file SBProcess.h.

Constructor & Destructor Documentation

◆ SBProcess() [1/3]

SBProcess::SBProcess ( )

Definition at line 52 of file SBProcess.cpp.

References LLDB_RECORD_CONSTRUCTOR_NO_ARGS.

Referenced by GetProcessFromEvent().

◆ SBProcess() [2/3]

SBProcess::SBProcess ( const lldb::SBProcess & rhs )

Definition at line 58 of file SBProcess.cpp.

References LLDB_RECORD_CONSTRUCTOR.

◆ SBProcess() [3/3]

SBProcess::SBProcess ( const lldb::ProcessSP & process_sp )

Definition at line 62 of file SBProcess.cpp.

References LLDB_RECORD_CONSTRUCTOR.

◆ ~SBProcess()

SBProcess::~SBProcess ( )

Definition at line 77 of file SBProcess.cpp.

Member Function Documentation

◆ AppendEventStateReport()

void SBProcess::AppendEventStateReport	(	const lldb::SBEvent &	event,
		lldb::SBCommandReturnObject &	result
	)

Definition at line 354 of file SBProcess.cpp.

References lldb::SBCommandReturnObject::AppendMessage(), GetSP(), GetStateFromEvent(), LLDB_RECORD_METHOD, and lldb::SBDebugger::StateAsCString().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ Clear()

void SBProcess::Clear ( )

Definition at line 110 of file SBProcess.cpp.

References LLDB_RECORD_METHOD_NO_ARGS, and m_opaque_wp.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ Continue()

SBError SBProcess::Continue ( )

Definition at line 592 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_NO_ARGS, LLDB_RECORD_RESULT, lldb::SBError::ref(), and lldb::SBError::SetErrorString().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ CreateOSPluginThread()

SBThread SBProcess::CreateOSPluginThread	(	lldb::tid_t	tid,
		lldb::addr_t	context
	)

Definition at line 226 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, and LLDB_RECORD_RESULT.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ Destroy()

SBError SBProcess::Destroy ( )

Definition at line 612 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_NO_ARGS, LLDB_RECORD_RESULT, lldb::SBError::SetError(), and lldb::SBError::SetErrorString().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ Detach() [1/2]

SBError SBProcess::Detach ( )

Definition at line 657 of file SBProcess.cpp.

References LLDB_RECORD_METHOD_NO_ARGS, and LLDB_RECORD_RESULT.

Referenced by Detach(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ Detach() [2/2]

SBError SBProcess::Detach ( bool keep_stopped )

Definition at line 665 of file SBProcess.cpp.

References Detach(), GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, lldb::SBError::SetError(), and lldb::SBError::SetErrorString().

◆ EventIsProcessEvent()

bool SBProcess::EventIsProcessEvent ( const lldb::SBEvent & event )

static

Definition at line 817 of file SBProcess.cpp.

References EventIsStructuredDataEvent(), lldb::SBEvent::GetBroadcasterClass(), GetBroadcasterClass(), and LLDB_RECORD_STATIC_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ EventIsStructuredDataEvent()

bool SBProcess::EventIsStructuredDataEvent ( const lldb::SBEvent & event )

static

Definition at line 825 of file SBProcess.cpp.

References lldb_private::EventData::GetFlavor(), and LLDB_RECORD_STATIC_METHOD.

Referenced by EventIsProcessEvent(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ FLAGS_ANONYMOUS_ENUM()

lldb::SBProcess::FLAGS_ANONYMOUS_ENUM ( )

inline

Broadcaster event bits definitions.

Definition at line 26 of file SBProcess.h.

References ReadCStringFromMemory(), and lldb::SBProcess.

◆ GetAddressByteSize()

uint32_t SBProcess::GetAddressByteSize ( ) const

Definition at line 580 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_CONST_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetAsyncProfileData()

size_t SBProcess::GetAsyncProfileData	(	char *	dst,
		size_t	dst_len
	)		const

Definition at line 300 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_CONST.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetBroadcaster()

SBBroadcaster SBProcess::GetBroadcaster ( ) const

Definition at line 835 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_CONST_NO_ARGS, and LLDB_RECORD_RESULT.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetBroadcasterClass()

const char * SBProcess::GetBroadcasterClass ( )

static

Definition at line 848 of file SBProcess.cpp.

References LLDB_RECORD_STATIC_METHOD_NO_ARGS.

Referenced by EventIsProcessEvent(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetBroadcasterClassName()

const char * SBProcess::GetBroadcasterClassName ( )

static

Definition at line 79 of file SBProcess.cpp.

References LLDB_RECORD_STATIC_METHOD_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetByteOrder()

ByteOrder SBProcess::GetByteOrder ( ) const

Definition at line 568 of file SBProcess.cpp.

References lldb::eByteOrderInvalid, GetSP(), and LLDB_RECORD_METHOD_CONST_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetDescription()

bool SBProcess::GetDescription ( lldb::SBStream & description )

Definition at line 977 of file SBProcess.cpp.

References lldb_private::ConstString::AsCString(), lldb::SBTarget::GetExecutable(), lldb_private::FileSpec::GetFilename(), lldb_private::Module::GetFileSpec(), GetNumThreads(), lldb::SBFileSpec::GetPath(), GetSP(), GetState(), GetTarget(), LLDB_RECORD_METHOD, PATH_MAX, lldb_private::Stream::Printf(), lldb_private::Stream::PutCString(), lldb::SBStream::ref(), and lldb_private::StateAsCString().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetExitDescription()

const char * SBProcess::GetExitDescription ( )

Definition at line 534 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetExitStatus()

int SBProcess::GetExitStatus ( )

Definition at line 520 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetExtendedBacktraceTypeAtIndex()

const char * SBProcess::GetExtendedBacktraceTypeAtIndex ( uint32_t idx )

Return the name of one of the thread-origin extended backtrace methods.

Parameters

[in] idx The index of the name to return. They will be returned in the order that the user will most likely want to see them. e.g. if the type at index 0 is not available for a thread, see if the type at index 1 provides an extended backtrace.

Returns: The name at that index.

Definition at line 1146 of file SBProcess.cpp.

References lldb_private::SystemRuntime::GetExtendedBacktraceTypes(), GetSP(), and LLDB_RECORD_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetHistoryThreads()

SBThreadCollection SBProcess::GetHistoryThreads ( addr_t addr )

Definition at line 1162 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, and lldb::SBThreadCollection.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetInterruptedFromEvent()

bool SBProcess::GetInterruptedFromEvent ( const lldb::SBEvent & event )

static

Definition at line 801 of file SBProcess.cpp.

References lldb::SBEvent::get(), and LLDB_RECORD_STATIC_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetMemoryRegionInfo()

lldb::SBError SBProcess::GetMemoryRegionInfo	(	lldb::addr_t	load_addr,
		lldb::SBMemoryRegionInfo &	region_info
	)

Query the address load_addr and store the details of the memory region that contains it in the supplied SBMemoryRegionInfo object.

To iterate over all memory regions use GetMemoryRegionList.

Parameters

[in]	load_addr	The address to be queried.
[out]	region_info	A reference to an SBMemoryRegionInfo object that will contain the details of the memory region containing load_addr.

Returns: An error object describes any errors that occurred while querying load_addr.

Definition at line 1217 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, lldb::SBError::ref(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetMemoryRegions()

lldb::SBMemoryRegionInfoList SBProcess::GetMemoryRegions ( )

Return the list of memory regions within the process.

Returns: A list of all witin the process memory regions.

Definition at line 1242 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_NO_ARGS, LLDB_RECORD_RESULT, and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetNumExtendedBacktraceTypes()

uint32_t SBProcess::GetNumExtendedBacktraceTypes ( )

Return the number of different thread-origin extended backtraces this process can support.

When the process is stopped and you have an SBThread, lldb may be able to show a backtrace of when that thread was originally created, or the work item was enqueued to it (in the case of a libdispatch queue).

Returns: The number of thread-origin extended backtrace types that may be available.

Definition at line 1135 of file SBProcess.cpp.

References lldb_private::SystemRuntime::GetExtendedBacktraceTypes(), GetSP(), and LLDB_RECORD_METHOD_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetNumQueues()

uint32_t SBProcess::GetNumQueues ( )

Definition at line 436 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_NO_ARGS, and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetNumRestartedReasonsFromEvent()

size_t SBProcess::GetNumRestartedReasonsFromEvent ( const lldb::SBEvent & event )

static

Definition at line 770 of file SBProcess.cpp.

References lldb::SBEvent::get(), and LLDB_RECORD_STATIC_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetNumSupportedHardwareWatchpoints()

uint32_t SBProcess::GetNumSupportedHardwareWatchpoints ( lldb::SBError & error ) const

Definition at line 1003 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_CONST, lldb::SBError::SetError(), and lldb::SBError::SetErrorString().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetNumThreads()

uint32_t SBProcess::GetNumThreads ( )

Definition at line 192 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_NO_ARGS, and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by GetDescription(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetPluginName()

const char * SBProcess::GetPluginName ( )

Definition at line 86 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetProcessFromEvent()

SBProcess SBProcess::GetProcessFromEvent ( const lldb::SBEvent & event )

static

Definition at line 787 of file SBProcess.cpp.

References lldb::SBEvent::get(), LLDB_RECORD_RESULT, LLDB_RECORD_STATIC_METHOD, and SBProcess().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetProcessID()

lldb::pid_t SBProcess::GetProcessID ( )

Gets the process ID.

Returns the process identifier for the process as it is known on the system on which the process is running. For unix systems this is typically the same as if you called "getpid()" in the process.

Returns: Returns LLDB_INVALID_PROCESS_ID if this object does not contain a valid process object, or if the process has not been launched. Returns a valid process ID if the process is valid.

Definition at line 547 of file SBProcess.cpp.

References GetSP(), LLDB_INVALID_PROCESS_ID, and LLDB_RECORD_METHOD_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetProcessInfo()

lldb::SBProcessInfo SBProcess::GetProcessInfo ( )

Return information about the process.

Valid process info will only be returned when the process is alive, use SBProcessInfo::IsValid() to check returned info is valid.

Definition at line 1260 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_NO_ARGS, and LLDB_RECORD_RESULT.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetQueueAtIndex()

SBQueue SBProcess::GetQueueAtIndex ( size_t index )

Definition at line 453 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, lldb::SBQueue::SetQueue(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetRestartedFromEvent()

bool SBProcess::GetRestartedFromEvent ( const lldb::SBEvent & event )

static

Definition at line 761 of file SBProcess.cpp.

References lldb::SBEvent::get(), and LLDB_RECORD_STATIC_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetRestartedReasonAtIndexFromEvent()

const char * SBProcess::GetRestartedReasonAtIndexFromEvent	(	const lldb::SBEvent &	event,
		size_t	idx
	)

static

Definition at line 778 of file SBProcess.cpp.

References lldb::SBEvent::get(), and LLDB_RECORD_STATIC_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetSelectedThread()

SBThread SBProcess::GetSelectedThread ( ) const

Definition at line 209 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_CONST_NO_ARGS, and LLDB_RECORD_RESULT.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetShortPluginName()

const char * SBProcess::GetShortPluginName ( )

Definition at line 96 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetSP()

lldb::ProcessSP SBProcess::GetSP ( ) const

protected

Definition at line 106 of file SBProcess.cpp.

References m_opaque_wp.

Referenced by AppendEventStateReport(), Continue(), CreateOSPluginThread(), Destroy(), Detach(), GetAddressByteSize(), GetAsyncProfileData(), GetBroadcaster(), GetByteOrder(), GetDescription(), GetExitDescription(), GetExitStatus(), GetExtendedBacktraceTypeAtIndex(), GetHistoryThreads(), GetMemoryRegionInfo(), GetMemoryRegions(), GetNumExtendedBacktraceTypes(), GetNumQueues(), GetNumSupportedHardwareWatchpoints(), GetNumThreads(), GetPluginName(), GetProcessID(), GetProcessInfo(), GetQueueAtIndex(), GetSelectedThread(), GetShortPluginName(), GetState(), GetSTDERR(), GetSTDOUT(), GetStopEventForStopID(), GetStopID(), GetTarget(), GetThreadAtIndex(), GetThreadByID(), GetThreadByIndexID(), GetUniqueID(), GetUnixSignals(), lldb::SBDebugger::HandleCommand(), IsInstrumentationRuntimePresent(), Kill(), LoadImage(), LoadImageUsingPaths(), PutSTDIN(), ReadCStringFromMemory(), ReadMemory(), ReadPointerFromMemory(), ReadUnsignedFromMemory(), RemoteAttachToProcessWithID(), RemoteLaunch(), ReportEventState(), SaveCore(), lldb::SBExecutionContext::SBExecutionContext(), lldb::SBModule::SBModule(), SendAsyncInterrupt(), SendEventData(), SetSelectedThread(), SetSelectedThreadByID(), SetSelectedThreadByIndexID(), Signal(), StartTrace(), Stop(), UnloadImage(), and WriteMemory().

◆ GetState()

StateType SBProcess::GetState ( )

Definition at line 506 of file SBProcess.cpp.

References lldb::eStateInvalid, GetSP(), and LLDB_RECORD_METHOD_NO_ARGS.

Referenced by GetDescription(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetStateFromEvent()

StateType SBProcess::GetStateFromEvent ( const lldb::SBEvent & event )

static

Definition at line 752 of file SBProcess.cpp.

References lldb::SBEvent::get(), and LLDB_RECORD_STATIC_METHOD.

Referenced by AppendEventStateReport(), lldb::SBDebugger::HandleProcessEvent(), lldb_private::repro::RegisterMethods< SBProcess >(), and ReportEventState().

◆ GetSTDERR()

size_t SBProcess::GetSTDERR	(	char *	dst,
		size_t	dst_len
	)		const

Definition at line 286 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_CONST.

Referenced by lldb::SBDebugger::HandleProcessEvent(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetSTDOUT()

size_t SBProcess::GetSTDOUT	(	char *	dst,
		size_t	dst_len
	)		const

Definition at line 272 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_CONST.

Referenced by lldb::SBDebugger::HandleProcessEvent(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetStopEventForStopID()

SBEvent SBProcess::GetStopEventForStopID ( uint32_t stop_id )

Gets the stop event corresponding to stop ID.

Note that it wasn't fully implemented and tracks only the stop event for the last natural stop ID.

Parameters

[in] stop_id The ID of the stop event to return.

Returns: The stop event corresponding to stop ID.

Definition at line 489 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, and lldb::SBEvent::reset().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetStopID()

uint32_t SBProcess::GetStopID ( bool include_expression_stops = false )

Definition at line 473 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetStructuredDataFromEvent()

lldb::SBStructuredData SBProcess::GetStructuredDataFromEvent ( const lldb::SBEvent & event )

static

Definition at line 809 of file SBProcess.cpp.

References lldb::SBEvent::GetSP(), LLDB_RECORD_RESULT, LLDB_RECORD_STATIC_METHOD, and lldb::SBStructuredData.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetTarget()

SBTarget SBProcess::GetTarget ( ) const

Definition at line 244 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_CONST_NO_ARGS, LLDB_RECORD_RESULT, and lldb::SBTarget::SetSP().

Referenced by GetDescription(), lldb::SBDebugger::HandleProcessEvent(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetThreadAtIndex()

SBThread SBProcess::GetThreadAtIndex ( size_t index )

Definition at line 417 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetThreadByID()

SBThread SBProcess::GetThreadByID ( lldb::tid_t sb_thread_id )

Definition at line 713 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetThreadByIndexID()

SBThread SBProcess::GetThreadByIndexID ( uint32_t index_id )

Definition at line 732 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetUniqueID()

uint32_t SBProcess::GetUniqueID ( )

Gets the unique ID associated with this process object.

Unique IDs start at 1 and increment up with each new process instance. Since starting a process on a system might always create a process with the same process ID, there needs to be a way to tell two process instances apart.

Returns: Returns a non-zero integer ID if this object contains a valid process object, zero if this object does not contain a valid process object.

Definition at line 558 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ GetUnixSignals()

SBUnixSignals SBProcess::GetUnixSignals ( )

Definition at line 695 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_NO_ARGS, and LLDB_RECORD_RESULT.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ IsInstrumentationRuntimePresent()

bool SBProcess::IsInstrumentationRuntimePresent ( InstrumentationRuntimeType type )

Definition at line 1174 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ IsValid()

bool SBProcess::IsValid ( ) const

Definition at line 116 of file SBProcess.cpp.

References LLDB_RECORD_METHOD_CONST_NO_ARGS.

Referenced by lldb::SBDebugger::HandleProcessEvent(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ Kill()

SBError SBProcess::Kill ( )

Definition at line 642 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_NO_ARGS, LLDB_RECORD_RESULT, lldb::SBError::SetError(), and lldb::SBError::SetErrorString().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ LoadImage() [1/2]

uint32_t SBProcess::LoadImage	(	lldb::SBFileSpec &	remote_image_spec,
		lldb::SBError &	error
	)

Load a shared library into this process.

Parameters

[in]	remote_image_spec	The path for the shared library on the target what you want to load.
[out]	error	An error object that gets filled in with any errors that might occur when trying to load the shared library.

Returns: A token that represents the shared library that can be later used to unload the shared library. A value of LLDB_INVALID_IMAGE_TOKEN will be returned if the shared library can't be opened.

Definition at line 1020 of file SBProcess.cpp.

References LLDB_RECORD_METHOD, and lldb::SBFileSpec.

Referenced by LoadImage(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ LoadImage() [2/2]

uint32_t SBProcess::LoadImage	(	const lldb::SBFileSpec &	local_image_spec,
		const lldb::SBFileSpec &	remote_image_spec,
		lldb::SBError &	error
	)

Load a shared library into this process.

Parameters

[in]	local_image_spec	The file spec that points to the shared library that you want to load if the library is located on the host. The library will be copied over to the location specified by remote_image_spec or into the current working directory with the same filename if the remote_image_spec isn't specified.
[in]	remote_image_spec	If local_image_spec is specified then the location where the library should be copied over from the host. If local_image_spec isn't specified, then the path for the shared library on the target what you want to load.
[out]	error	An error object that gets filled in with any errors that might occur when trying to load the shared library.

Returns: A token that represents the shared library that can be later used to unload the shared library. A value of LLDB_INVALID_IMAGE_TOKEN will be returned if the shared library can't be opened.

Definition at line 1029 of file SBProcess.cpp.

References GetSP(), LLDB_INVALID_IMAGE_TOKEN, LLDB_RECORD_METHOD, LoadImage(), lldb::SBError::ref(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

◆ LoadImageUsingPaths()

uint32_t SBProcess::LoadImageUsingPaths	(	const lldb::SBFileSpec &	image_spec,
		SBStringList &	paths,
		lldb::SBFileSpec &	loaded_path,
		lldb::SBError &	error
	)

Load a shared library into this process, starting with a library name and a list of paths, searching along the list of paths till you find a matching library.

Parameters

[in]	image_spec	The name of the shared library that you want to load. If image_spec is a relative path, the relative path will be appended to the search paths. If the image_spec is an absolute path, just the basename is used.
[in]	paths	A list of paths to search for the library whose basename is local_spec.
[out]	loaded_path	If the library was found along the paths, this will store the full path to the found library.
[out]	error	An error object that gets filled in with any errors that might occur when trying to search for the shared library.

Returns: A token that represents the shared library that can be later passed to UnloadImage. A value of LLDB_INVALID_IMAGE_TOKEN will be returned if the shared library can't be opened.

Definition at line 1055 of file SBProcess.cpp.

References lldb::SBStringList::GetSize(), GetSP(), lldb::SBStringList::GetStringAtIndex(), LLDB_INVALID_IMAGE_TOKEN, LLDB_RECORD_METHOD, lldb::SBError::ref(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ operator bool()

SBProcess::operator bool ( ) const

explicit

Definition at line 120 of file SBProcess.cpp.

References LLDB_RECORD_METHOD_CONST_NO_ARGS, and m_opaque_wp.

◆ operator=()

const SBProcess & SBProcess::operator= ( const lldb::SBProcess & rhs )

Definition at line 67 of file SBProcess.cpp.

References LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, and m_opaque_wp.

◆ PutSTDIN()

size_t SBProcess::PutSTDIN	(	const char *	src,
		size_t	src_len
	)

Definition at line 258 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ ReadCStringFromMemory()

size_t SBProcess::ReadCStringFromMemory	(	addr_t	addr,
		void *	buf,
		size_t	size,
		lldb::SBError &	error
	)

Definition at line 882 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_DUMMY, lldb::SBError::ref(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

◆ ReadMemory()

size_t SBProcess::ReadMemory	(	addr_t	addr,
		void *	buf,
		size_t	size,
		lldb::SBError &	error
	)

Definition at line 855 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_DUMMY, lldb::SBError::ref(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

◆ ReadPointerFromMemory()

lldb::addr_t SBProcess::ReadPointerFromMemory	(	addr_t	addr,
		lldb::SBError &	error
	)

Definition at line 930 of file SBProcess.cpp.

References GetSP(), LLDB_INVALID_ADDRESS, LLDB_RECORD_METHOD, lldb::SBError::ref(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ ReadUnsignedFromMemory()

uint64_t SBProcess::ReadUnsignedFromMemory	(	addr_t	addr,
		uint32_t	byte_size,
		lldb::SBError &	error
	)

Definition at line 906 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, lldb::SBError::ref(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ RemoteAttachToProcessWithID()

bool SBProcess::RemoteAttachToProcessWithID	(	lldb::pid_t	pid,
		lldb::SBError &	error
	)

Remote connection related functions.

These will fail if the process is not in eStateConnected. They are intended for use when connecting to an externally managed debugserver instance.

Definition at line 168 of file SBProcess.cpp.

References lldb::eStateConnected, GetSP(), LLDB_RECORD_METHOD, lldb::SBError::SetError(), lldb::SBError::SetErrorString(), lldb_private::ProcessInfo::SetProcessID(), and lldb::SBError::Success().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ RemoteLaunch()

bool SBProcess::RemoteLaunch	(	char const **	argv,
		char const **	envp,
		const char *	stdin_path,
		const char *	stdout_path,
		const char *	stderr_path,
		const char *	working_directory,
		uint32_t	launch_flags,
		bool	stop_at_entry,
		lldb::SBError &	error
	)

Definition at line 127 of file SBProcess.cpp.

References lldb_private::Args::AppendArguments(), lldb::eStateConnected, lldb_private::ProcessInfo::GetArguments(), lldb_private::ProcessInfo::GetEnvironment(), lldb_private::Module::GetPlatformFileSpec(), GetSP(), LLDB_RECORD_METHOD, lldb::SBError::SetError(), lldb::SBError::SetErrorString(), lldb_private::ProcessInfo::SetExecutableFile(), and lldb::SBError::Success().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ ReportEventState()

void SBProcess::ReportEventState	(	const lldb::SBEvent &	event,
		FILE *	out
	)		const

Definition at line 334 of file SBProcess.cpp.

References GetSP(), GetStateFromEvent(), LLDB_RECORD_METHOD_CONST, and lldb::SBDebugger::StateAsCString().

Referenced by lldb::SBDebugger::HandleProcessEvent(), and lldb_private::repro::RegisterMethods< SBProcess >().

◆ SaveCore()

lldb::SBError SBProcess::SaveCore ( const char * file_name )

Save the state of the process in a core file (or mini dump on Windows).

Definition at line 1192 of file SBProcess.cpp.

References lldb::eStateStopped, GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, lldb::SBError::ref(), and lldb::SBError::SetErrorString().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ SendAsyncInterrupt()

void SBProcess::SendAsyncInterrupt ( )

Definition at line 704 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD_NO_ARGS.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ SendEventData()

lldb::SBError SBProcess::SendEventData ( const char * data )

Definition at line 1115 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, lldb::SBError::SetError(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ SetSelectedThread()

bool SBProcess::SetSelectedThread ( const lldb::SBThread & thread )

Definition at line 371 of file SBProcess.cpp.

References GetSP(), lldb::SBThread::GetThreadID(), and LLDB_RECORD_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ SetSelectedThreadByID()

bool SBProcess::SetSelectedThreadByID ( lldb::tid_t tid )

Definition at line 385 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ SetSelectedThreadByIndexID()

bool SBProcess::SetSelectedThreadByIndexID ( uint32_t index_id )

Definition at line 401 of file SBProcess.cpp.

References GetSP(), and LLDB_RECORD_METHOD.

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ SetSP()

void SBProcess::SetSP ( const lldb::ProcessSP & process_sp )

protected

Definition at line 108 of file SBProcess.cpp.

References m_opaque_wp.

Referenced by lldb::SBTarget::Attach(), lldb::SBTarget::AttachToProcessWithID(), lldb::SBTarget::AttachToProcessWithName(), lldb::SBTarget::ConnectRemote(), lldb::SBExecutionContext::GetProcess(), lldb::SBTarget::GetProcess(), lldb::SBCommandInterpreter::GetProcess(), lldb::SBThread::GetProcess(), lldb_private::QueueImpl::GetProcess(), lldb::SBValue::GetProcess(), lldb::SBTarget::Launch(), and lldb::SBTarget::LoadCore().

◆ Signal()

SBError SBProcess::Signal ( int signal )

Definition at line 680 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, lldb::SBError::SetError(), and lldb::SBError::SetErrorString().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ StartTrace()

lldb::SBTrace SBProcess::StartTrace	(	SBTraceOptions &	options,
		lldb::SBError &	error
	)

Start Tracing with the given SBTraceOptions.

Parameters

[in]	options	Class containing trace options like trace buffer size, meta data buffer size, TraceType and any custom parameters {formatted as a JSON Dictionary}. In case of errors in formatting, an error would be reported. It must be noted that tracing options such as buffer sizes or other custom parameters passed maybe invalid for some trace technologies. In such cases the trace implementations could choose to either throw an error or could round off to the nearest valid options to start tracing if the passed value is not supported. To obtain the actual used trace options please use the GetTraceConfig API. For the custom parameters, only the parameters recognized by the target would be used and others would be ignored.
[out]	error	An error explaining what went wrong.

Returns: A SBTrace instance, which should be used to get the trace data or other trace related operations.

Definition at line 314 of file SBProcess.cpp.

References lldb::SBError::Clear(), GetSP(), LLDB_INVALID_UID, LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, lldb::SBTraceOptions::m_traceoptions_sp, lldb::SBError::ref(), lldb::SBError::SetErrorString(), lldb::SBTrace::SetSP(), and lldb::SBTrace::SetTraceUID().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ Stop()

SBError SBProcess::Stop ( )

Definition at line 627 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD_NO_ARGS, LLDB_RECORD_RESULT, lldb::SBError::SetError(), and lldb::SBError::SetErrorString().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ UnloadImage()

lldb::SBError SBProcess::UnloadImage ( uint32_t image_token )

Definition at line 1093 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_METHOD, LLDB_RECORD_RESULT, lldb::SBError::SetError(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Referenced by lldb_private::repro::RegisterMethods< SBProcess >().

◆ WriteMemory()

size_t SBProcess::WriteMemory	(	addr_t	addr,
		const void *	buf,
		size_t	size,
		lldb::SBError &	error
	)

Definition at line 952 of file SBProcess.cpp.

References GetSP(), LLDB_RECORD_DUMMY, lldb::SBError::ref(), lldb::SBError::SetErrorString(), and lldb_private::ProcessRunLock::ProcessRunLocker::TryLock().

Friends And Related Function Documentation

◆ lldb_private::QueueImpl

friend class lldb_private::QueueImpl

friend

Definition at line 404 of file SBProcess.h.

◆ SBAddress

friend class SBAddress

friend

Definition at line 393 of file SBProcess.h.

◆ SBBreakpoint

friend class SBBreakpoint

friend

Definition at line 394 of file SBProcess.h.

◆ SBBreakpointLocation

friend class SBBreakpointLocation

friend

Definition at line 395 of file SBProcess.h.

◆ SBCommandInterpreter

friend class SBCommandInterpreter

friend

Definition at line 396 of file SBProcess.h.

◆ SBDebugger

friend class SBDebugger

friend

Definition at line 397 of file SBProcess.h.

◆ SBExecutionContext

friend class SBExecutionContext

friend

Definition at line 398 of file SBProcess.h.

◆ SBFunction

friend class SBFunction

friend

Definition at line 399 of file SBProcess.h.

◆ SBModule

friend class SBModule

friend

Definition at line 400 of file SBProcess.h.

◆ SBTarget

friend class SBTarget

friend

Definition at line 401 of file SBProcess.h.

◆ SBThread

friend class SBThread

friend

Definition at line 402 of file SBProcess.h.

◆ SBValue

friend class SBValue

friend

Definition at line 403 of file SBProcess.h.

Member Data Documentation

◆ m_opaque_wp

lldb::ProcessWP lldb::SBProcess::m_opaque_wp

protected

Definition at line 410 of file SBProcess.h.

Referenced by Clear(), GetSP(), operator bool(), operator=(), and SetSP().

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Constructor & Destructor Documentation

◆ SBProcess() [1/3]

◆ SBProcess() [2/3]

◆ SBProcess() [3/3]

◆ ~SBProcess()

Member Function Documentation

◆ AppendEventStateReport()

◆ Clear()

◆ Continue()

◆ CreateOSPluginThread()

◆ Destroy()

◆ Detach() [1/2]

◆ Detach() [2/2]

◆ EventIsProcessEvent()

◆ EventIsStructuredDataEvent()

◆ FLAGS_ANONYMOUS_ENUM()

◆ GetAddressByteSize()

◆ GetAsyncProfileData()

◆ GetBroadcaster()

◆ GetBroadcasterClass()

◆ GetBroadcasterClassName()

◆ GetByteOrder()

◆ GetDescription()

◆ GetExitDescription()

◆ GetExitStatus()

◆ GetExtendedBacktraceTypeAtIndex()

◆ GetHistoryThreads()

◆ GetInterruptedFromEvent()

◆ GetMemoryRegionInfo()

◆ GetMemoryRegions()

◆ GetNumExtendedBacktraceTypes()

◆ GetNumQueues()

◆ GetNumRestartedReasonsFromEvent()

◆ GetNumSupportedHardwareWatchpoints()

◆ GetNumThreads()

◆ GetPluginName()

◆ GetProcessFromEvent()

◆ GetProcessID()

◆ GetProcessInfo()

◆ GetQueueAtIndex()

◆ GetRestartedFromEvent()

◆ GetRestartedReasonAtIndexFromEvent()

◆ GetSelectedThread()

◆ GetShortPluginName()

◆ GetSP()

◆ GetState()

◆ GetStateFromEvent()

◆ GetSTDERR()

◆ GetSTDOUT()

◆ GetStopEventForStopID()

◆ GetStopID()

◆ GetStructuredDataFromEvent()

◆ GetTarget()

◆ GetThreadAtIndex()

◆ GetThreadByID()

◆ GetThreadByIndexID()

◆ GetUniqueID()

◆ GetUnixSignals()

◆ IsInstrumentationRuntimePresent()

◆ IsValid()

◆ Kill()

◆ LoadImage() [1/2]

◆ LoadImage() [2/2]

◆ LoadImageUsingPaths()

◆ operator bool()

◆ operator=()

◆ PutSTDIN()

◆ ReadCStringFromMemory()

◆ ReadMemory()

◆ ReadPointerFromMemory()

◆ ReadUnsignedFromMemory()

◆ RemoteAttachToProcessWithID()

◆ RemoteLaunch()

◆ ReportEventState()