|
LLDB mainline
|
#include <SBLaunchInfo.h>
Public Member Functions | |
| SBLaunchInfo (const char **argv) | |
| ~SBLaunchInfo () | |
| SBLaunchInfo (const SBLaunchInfo &rhs) | |
| SBLaunchInfo & | operator= (const SBLaunchInfo &rhs) |
| lldb::pid_t | GetProcessID () |
| uint32_t | GetUserID () |
| uint32_t | GetGroupID () |
| bool | UserIDIsValid () |
| bool | GroupIDIsValid () |
| void | SetUserID (uint32_t uid) |
| void | SetGroupID (uint32_t gid) |
| SBFileSpec | GetExecutableFile () |
| void | SetExecutableFile (SBFileSpec exe_file, bool add_as_first_arg) |
| Set the executable file that will be used to launch the process and optionally set it as the first argument in the argument vector. | |
| SBListener | GetListener () |
| Get the listener that will be used to receive process events. | |
| void | SetListener (SBListener &listener) |
| Set the listener that will be used to receive process events. | |
| SBListener | GetShadowListener () |
| Get the shadow listener that receive public process events, additionally to the default process event listener. | |
| void | SetShadowListener (SBListener &listener) |
| Set the shadow listener that will receive public process events, additionally to the default process event listener. | |
| uint32_t | GetNumArguments () |
| const char * | GetArgumentAtIndex (uint32_t idx) |
| void | SetArguments (const char **argv, bool append) |
| uint32_t | GetNumEnvironmentEntries () |
| const char * | GetEnvironmentEntryAtIndex (uint32_t idx) |
| void | SetEnvironmentEntries (const char **envp, bool append) |
| Update this object with the given environment variables. | |
| void | SetEnvironment (const SBEnvironment &env, bool append) |
| Update this object with the given environment variables. | |
| SBEnvironment | GetEnvironment () |
| Return the environment variables of this object. | |
| void | Clear () |
| const char * | GetWorkingDirectory () const |
| void | SetWorkingDirectory (const char *working_dir) |
| uint32_t | GetLaunchFlags () |
| void | SetLaunchFlags (uint32_t flags) |
| const char * | GetProcessPluginName () |
| void | SetProcessPluginName (const char *plugin_name) |
| const char * | GetShell () |
| void | SetShell (const char *path) |
| bool | GetShellExpandArguments () |
| void | SetShellExpandArguments (bool expand) |
| uint32_t | GetResumeCount () |
| void | SetResumeCount (uint32_t c) |
| bool | AddCloseFileAction (int fd) |
| bool | AddDuplicateFileAction (int fd, int dup_fd) |
| bool | AddOpenFileAction (int fd, const char *path, bool read, bool write) |
| bool | AddSuppressFileAction (int fd, bool read, bool write) |
| void | SetLaunchEventData (const char *data) |
| const char * | GetLaunchEventData () const |
| bool | GetDetachOnError () const |
| void | SetDetachOnError (bool enable) |
| const char * | GetScriptedProcessClassName () const |
| void | SetScriptedProcessClassName (const char *class_name) |
| lldb::SBStructuredData | GetScriptedProcessDictionary () const |
| void | SetScriptedProcessDictionary (lldb::SBStructuredData dict) |
Protected Member Functions | |
| const lldb_private::ProcessLaunchInfo & | ref () const |
| void | set_ref (const lldb_private::ProcessLaunchInfo &info) |
Protected Attributes | |
| std::shared_ptr< lldb_private::SBLaunchInfoImpl > | m_opaque_sp |
Friends | |
| class | SBPlatform |
| class | SBTarget |
| class | lldb_private::ScriptInterpreterBridge |
Definition at line 24 of file SBLaunchInfo.h.
| SBLaunchInfo::SBLaunchInfo | ( | const char ** | argv | ) |
Definition at line 45 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by operator=(), SBLaunchInfo(), and ~SBLaunchInfo().
|
default |
References AddCloseFileAction(), AddDuplicateFileAction(), AddOpenFileAction(), AddSuppressFileAction(), Clear(), GetArgumentAtIndex(), GetDetachOnError(), GetEnvironment(), GetEnvironmentEntryAtIndex(), GetExecutableFile(), GetGroupID(), GetLaunchEventData(), GetLaunchFlags(), GetListener(), GetNumArguments(), GetNumEnvironmentEntries(), GetProcessID(), GetProcessPluginName(), GetResumeCount(), GetScriptedProcessClassName(), GetScriptedProcessDictionary(), GetShadowListener(), GetShell(), GetShellExpandArguments(), GetUserID(), GetWorkingDirectory(), GroupIDIsValid(), operator=(), SBLaunchInfo(), SetArguments(), SetDetachOnError(), SetEnvironment(), SetEnvironmentEntries(), SetExecutableFile(), SetGroupID(), SetLaunchEventData(), SetLaunchFlags(), SetListener(), SetProcessPluginName(), SetResumeCount(), SetScriptedProcessClassName(), SetScriptedProcessDictionary(), SetShadowListener(), SetShell(), SetShellExpandArguments(), SetUserID(), SetWorkingDirectory(), and UserIDIsValid().
| SBLaunchInfo::SBLaunchInfo | ( | const SBLaunchInfo & | rhs | ) |
Definition at line 54 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and SBLaunchInfo().
| bool SBLaunchInfo::AddCloseFileAction | ( | int | fd | ) |
Definition at line 289 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| bool SBLaunchInfo::AddDuplicateFileAction | ( | int | fd, |
| int | dup_fd ) |
Definition at line 295 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
Definition at line 301 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
Definition at line 308 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::Clear | ( | ) |
Definition at line 206 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| const char * SBLaunchInfo::GetArgumentAtIndex | ( | uint32_t | idx | ) |
Definition at line 150 of file SBLaunchInfo.cpp.
References lldb_private::StringPool::GetSystemPool(), lldb_private::StringPoolRef::Intern(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| bool SBLaunchInfo::GetDetachOnError | ( | ) | const |
Definition at line 332 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| SBEnvironment SBLaunchInfo::GetEnvironment | ( | ) |
Return the environment variables of this object.
Definition at line 201 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBEnvironment.
Referenced by ~SBLaunchInfo().
| const char * SBLaunchInfo::GetEnvironmentEntryAtIndex | ( | uint32_t | idx | ) |
Definition at line 177 of file SBLaunchInfo.cpp.
References GetNumEnvironmentEntries(), lldb_private::StringPool::GetSystemPool(), lldb_private::StringPoolRef::Intern(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| SBFileSpec SBLaunchInfo::GetExecutableFile | ( | ) |
Definition at line 119 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBFileSpec.
Referenced by ~SBLaunchInfo().
| uint32_t SBLaunchInfo::GetGroupID | ( | ) |
Definition at line 89 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| const char * SBLaunchInfo::GetLaunchEventData | ( | ) | const |
Definition at line 320 of file SBLaunchInfo.cpp.
References lldb_private::StringPool::GetSystemPool(), lldb_private::StringPoolRef::Intern(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| uint32_t SBLaunchInfo::GetLaunchFlags | ( | ) |
Definition at line 225 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| SBListener SBLaunchInfo::GetListener | ( | ) |
Get the listener that will be used to receive process events.
If no listener has been set via a call to SBLaunchInfo::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.
Definition at line 132 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBListener.
Referenced by ~SBLaunchInfo().
| uint32_t SBLaunchInfo::GetNumArguments | ( | ) |
Definition at line 144 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| uint32_t SBLaunchInfo::GetNumEnvironmentEntries | ( | ) |
Definition at line 171 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by GetEnvironmentEntryAtIndex(), and ~SBLaunchInfo().
| lldb::pid_t SBLaunchInfo::GetProcessID | ( | ) |
Definition at line 77 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| const char * SBLaunchInfo::GetProcessPluginName | ( | ) |
Definition at line 237 of file SBLaunchInfo.cpp.
References lldb_private::StringPool::GetSystemPool(), lldb_private::StringPoolRef::Intern(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| uint32_t SBLaunchInfo::GetResumeCount | ( | ) |
Definition at line 277 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| const char * SBLaunchInfo::GetScriptedProcessClassName | ( | ) | const |
Definition at line 338 of file SBLaunchInfo.cpp.
References lldb_private::ConstString::AsCString(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| lldb::SBStructuredData SBLaunchInfo::GetScriptedProcessDictionary | ( | ) | const |
Definition at line 361 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, lldb::SBStructuredData::m_impl_up, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| SBListener SBLaunchInfo::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.
Definition at line 397 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBListener.
Referenced by ~SBLaunchInfo().
| const char * SBLaunchInfo::GetShell | ( | ) |
Definition at line 250 of file SBLaunchInfo.cpp.
References lldb_private::ConstString::AsCString(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| bool SBLaunchInfo::GetShellExpandArguments | ( | ) |
Definition at line 265 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| uint32_t SBLaunchInfo::GetUserID | ( | ) |
Definition at line 83 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| const char * SBLaunchInfo::GetWorkingDirectory | ( | ) | const |
Definition at line 212 of file SBLaunchInfo.cpp.
References lldb_private::StringPool::GetSystemPool(), lldb_private::StringPoolRef::InternNonEmpty(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| bool SBLaunchInfo::GroupIDIsValid | ( | ) |
Definition at line 101 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| SBLaunchInfo & SBLaunchInfo::operator= | ( | const SBLaunchInfo & | rhs | ) |
Definition at line 60 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and SBLaunchInfo().
Referenced by ~SBLaunchInfo().
|
protected |
Definition at line 69 of file SBLaunchInfo.cpp.
References m_opaque_sp.
Referenced by lldb::SBPlatform::Launch(), lldb::SBTarget::Launch(), lldb_private::ScriptInterpreterBridge, and lldb::SBTarget::SetLaunchInfo().
|
protected |
Definition at line 73 of file SBLaunchInfo.cpp.
References m_opaque_sp.
Referenced by lldb::SBTarget::GetLaunchInfo(), lldb::SBPlatform::Launch(), lldb::SBTarget::Launch(), and lldb_private::ScriptInterpreterBridge.
| void SBLaunchInfo::SetArguments | ( | const char ** | argv, |
| bool | append ) |
Definition at line 157 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by lldb::SBTarget::LaunchSimple(), and ~SBLaunchInfo().
| void SBLaunchInfo::SetDetachOnError | ( | bool | enable | ) |
Definition at line 326 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetEnvironment | ( | const SBEnvironment & | env, |
| bool | append ) |
Update this object with the given environment variables.
If append is false, the provided environment will replace the existing environment. Otherwise, existing values will be updated of left untouched accordingly.
| [in] | env | The new environment variables. |
| [in] | append | Flag that controls whether to replace the existing environment. |
Definition at line 190 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBEnvironment::ref().
Referenced by SetEnvironmentEntries(), and ~SBLaunchInfo().
| void SBLaunchInfo::SetEnvironmentEntries | ( | const char ** | envp, |
| bool | append ) |
Update this object with the given environment variables.
If append is false, the provided environment will replace the existing environment. Otherwise, existing values will be updated of left untouched accordingly.
| [in] | envp | The new environment variables as a list of strings with the following format name=value |
| [in] | append | Flag that controls whether to replace the existing environment. |
Definition at line 185 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, lldb::SBEnvironment, and SetEnvironment().
Referenced by lldb::SBTarget::LaunchSimple(), and ~SBLaunchInfo().
| void SBLaunchInfo::SetExecutableFile | ( | SBFileSpec | exe_file, |
| bool | add_as_first_arg ) |
Set the executable file that will be used to launch the process and optionally set it as the first argument in the argument vector.
This only needs to be specified if clients wish to carefully control the exact path will be used to launch a binary. If you create a target with a symlink, that symlink will get resolved in the target and the resolved path will get used to launch the process. Calling this function can help you still launch your process using the path of your choice.
If this function is not called prior to launching with SBTarget::Launch(...), the target will use the resolved executable path that was used to create the target.
| [in] | exe_file | The override path to use when launching the executable. |
| [in] | add_as_first_arg | If true, then the path will be inserted into the argument vector prior to launching. Otherwise the argument vector will be left alone. |
Definition at line 125 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, m_opaque_sp, and lldb::SBFileSpec::ref().
Referenced by lldb::SBTarget::LaunchSimple(), and ~SBLaunchInfo().
| void SBLaunchInfo::SetGroupID | ( | uint32_t | gid | ) |
Definition at line 113 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetLaunchEventData | ( | const char * | data | ) |
Definition at line 314 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetLaunchFlags | ( | uint32_t | flags | ) |
Definition at line 231 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetListener | ( | SBListener & | 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.
Definition at line 138 of file SBLaunchInfo.cpp.
References lldb::SBListener::GetSP(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetProcessPluginName | ( | const char * | plugin_name | ) |
Definition at line 244 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetResumeCount | ( | uint32_t | c | ) |
Definition at line 283 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetScriptedProcessClassName | ( | const char * | class_name | ) |
Definition at line 352 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetScriptedProcessDictionary | ( | lldb::SBStructuredData | dict | ) |
Definition at line 376 of file SBLaunchInfo.cpp.
References lldb::eStructuredDataTypeInvalid, lldb::SBStructuredData::IsValid(), LLDB_INSTRUMENT_VA, lldb::SBStructuredData::m_impl_up, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetShadowListener | ( | SBListener & | 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.
Definition at line 406 of file SBLaunchInfo.cpp.
References lldb::SBListener::GetSP(), LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetShell | ( | const char * | path | ) |
Definition at line 259 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetShellExpandArguments | ( | bool | expand | ) |
Definition at line 271 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetUserID | ( | uint32_t | uid | ) |
Definition at line 107 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
| void SBLaunchInfo::SetWorkingDirectory | ( | const char * | working_dir | ) |
Definition at line 219 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by lldb::SBTarget::LaunchSimple(), and ~SBLaunchInfo().
| bool SBLaunchInfo::UserIDIsValid | ( | ) |
Definition at line 95 of file SBLaunchInfo.cpp.
References LLDB_INSTRUMENT_VA, and m_opaque_sp.
Referenced by ~SBLaunchInfo().
|
friend |
Definition at line 213 of file SBLaunchInfo.h.
|
friend |
|
friend |
|
protected |
Definition at line 218 of file SBLaunchInfo.h.
Referenced by AddCloseFileAction(), AddDuplicateFileAction(), AddOpenFileAction(), AddSuppressFileAction(), Clear(), GetArgumentAtIndex(), GetDetachOnError(), GetEnvironment(), GetEnvironmentEntryAtIndex(), GetExecutableFile(), GetGroupID(), GetLaunchEventData(), GetLaunchFlags(), GetListener(), GetNumArguments(), GetNumEnvironmentEntries(), GetProcessID(), lldb_private::ScriptInterpreterBridge::GetProcessLaunchInfo(), GetProcessPluginName(), GetResumeCount(), GetScriptedProcessClassName(), GetScriptedProcessDictionary(), GetShadowListener(), GetShell(), GetShellExpandArguments(), GetUserID(), GetWorkingDirectory(), GroupIDIsValid(), operator=(), ref(), SBLaunchInfo(), SBLaunchInfo(), set_ref(), SetArguments(), SetDetachOnError(), SetEnvironment(), SetExecutableFile(), SetGroupID(), SetLaunchEventData(), SetLaunchFlags(), SetListener(), SetProcessPluginName(), SetResumeCount(), SetScriptedProcessClassName(), SetScriptedProcessDictionary(), SetShadowListener(), SetShell(), SetShellExpandArguments(), SetUserID(), SetWorkingDirectory(), and UserIDIsValid().