SBAttachInfo#

class lldb.SBAttachInfo(*args)#

Describes how to attach when calling SBTarget.Attach.

Methods Summary

EffectiveGroupIDIsValid(SBAttachInfo self)

EffectiveUserIDIsValid(SBAttachInfo self)

GetEffectiveGroupID(SBAttachInfo self)

GetEffectiveUserID(SBAttachInfo self)

GetGroupID(SBAttachInfo self)

GetIgnoreExisting(SBAttachInfo self)

GetListener()

Get the listener that will be used to receive process events.

GetParentProcessID(SBAttachInfo self)

GetProcessID(SBAttachInfo self)

GetProcessPluginName(SBAttachInfo self)

GetResumeCount(SBAttachInfo self)

GetScriptedProcessClassName(SBAttachInfo self)

GetScriptedProcessDictionary(SBAttachInfo self)

GetShadowListener()

Get the shadow listener that receive public process events, additionally to the default process event listener.

GetUserID(SBAttachInfo self)

GetWaitForLaunch(SBAttachInfo self)

GroupIDIsValid(SBAttachInfo self)

ParentProcessIDIsValid(SBAttachInfo self)

SetEffectiveGroupID(SBAttachInfo self, ...)

SetEffectiveUserID(SBAttachInfo self, ...)

SetExecutable()

SetGroupID(SBAttachInfo self, uint32_t gid)

SetIgnoreExisting(SBAttachInfo self, bool b)

SetListener(listener)

Set the listener that will be used to receive process events.

SetParentProcessID(SBAttachInfo self, lldb)

SetProcessID(SBAttachInfo self, lldb)

SetProcessPluginName(SBAttachInfo self, ...)

SetResumeCount(SBAttachInfo self, uint32_t c)

SetScriptedProcessClassName(...)

SetScriptedProcessDictionary(...)

SetShadowListener(listener)

Set the shadow listener that will receive public process events, additionally to the default process event listener.

SetUserID(SBAttachInfo self, uint32_t uid)

SetWaitForLaunch(*args)

Overload 1: Set attach by process name settings.

UserIDIsValid(SBAttachInfo self)

Methods Documentation

EffectiveGroupIDIsValid(SBAttachInfo self) → bool#
EffectiveUserIDIsValid(SBAttachInfo self) → bool#
GetEffectiveGroupID(SBAttachInfo self) → uint32_t#
GetEffectiveUserID(SBAttachInfo self) → uint32_t#
GetGroupID(SBAttachInfo self) → uint32_t#
GetIgnoreExisting(SBAttachInfo self) → bool#
GetListener()#

Get the listener that will be used to receive process events.

If no listener has been set via a call to SBAttachInfo::SetListener(), then an invalid SBListener will be returned (SBListener::IsValid() will return false). If a listener has been set, then the valid listener object will be returned.

GetParentProcessID(SBAttachInfo self) → lldb::pid_t#
GetProcessID(SBAttachInfo self) → lldb::pid_t#
GetProcessPluginName(SBAttachInfo self) → char const *#
GetResumeCount(SBAttachInfo self) → uint32_t#
GetScriptedProcessClassName(SBAttachInfo self) → char const *#
GetScriptedProcessDictionary(SBAttachInfo self) → SBStructuredData#
GetShadowListener()#

Get the shadow listener that receive public process events, additionally to the default process event listener.

If no listener has been set via a call to SBLaunchInfo::SetShadowListener(), then an invalid SBListener will be returned (SBListener::IsValid() will return false). If a listener has been set, then the valid listener object will be returned.

GetUserID(SBAttachInfo self) → uint32_t#
GetWaitForLaunch(SBAttachInfo self) → bool#
GroupIDIsValid(SBAttachInfo self) → bool#
ParentProcessIDIsValid(SBAttachInfo self) → bool#
SetEffectiveGroupID(SBAttachInfo self, uint32_t gid)#
SetEffectiveUserID(SBAttachInfo self, uint32_t uid)#
SetExecutable(SBAttachInfo self, char const * path)#
SetExecutable(SBAttachInfo self, SBFileSpec exe_file) → None
SetGroupID(SBAttachInfo self, uint32_t gid)#
SetIgnoreExisting(SBAttachInfo self, bool b)#
SetListener(listener)#

Set the listener that will be used to receive process events.

By default the SBDebugger, which has a listener, that the SBTarget belongs to will listen for the process events. Calling this function allows a different listener to be used to listen for process events.

SetParentProcessID(SBAttachInfo self, lldb::pid_t pid)#
SetProcessID(SBAttachInfo self, lldb::pid_t pid)#
SetProcessPluginName(SBAttachInfo self, char const * plugin_name)#
SetResumeCount(SBAttachInfo self, uint32_t c)#
SetScriptedProcessClassName(SBAttachInfo self, char const * class_name)#
SetScriptedProcessDictionary(SBAttachInfo self, SBStructuredData dict)#
SetShadowListener(listener)#

Set the shadow listener that will receive public process events, additionally to the default process event listener.

By default a process have no shadow event listener. Calling this function allows public process events to be broadcasted to an additional listener on top of the default process event listener. If the listener argument is invalid (SBListener::IsValid() will return false), this will clear the shadow listener.

SetUserID(SBAttachInfo self, uint32_t uid)#
SetWaitForLaunch(*args)#

Overload 1: Set attach by process name settings.

Designed to be used after a call to SBAttachInfo::SetExecutable(). This function implies that a call to SBTarget::Attach(…) will be synchronous.

Parameters:

b (boolean, in) – If false, attach to an existing process whose name matches. If true, then wait for the next process whose name matches.


Overload 2: Set attach by process name settings.

Designed to be used after a call to SBAttachInfo::SetExecutable(). Future calls to SBTarget::Attach(…) will be synchronous or asynchronous depending on the async argument.

Parameters:

  • b (boolean, in) – If false, attach to an existing process whose name matches. If true, then wait for the next process whose name matches.

  • async (boolean, in) – If false, then the SBTarget::Attach(…) call will be a synchronous call with no way to cancel the attach in progress. If true, then the SBTarget::Attach(…) function will return immediately and clients are expected to wait for a process eStateStopped event if a suitable process is eventually found. If the client wants to cancel the event, SBProcess::Stop() can be called and an eStateExited process event will be delivered.

UserIDIsValid(SBAttachInfo self) → bool#