diff options
Diffstat (limited to 'lldb/scripts/Python/interface/SBTarget.i')
| -rw-r--r-- | lldb/scripts/Python/interface/SBTarget.i | 778 |
1 files changed, 0 insertions, 778 deletions
diff --git a/lldb/scripts/Python/interface/SBTarget.i b/lldb/scripts/Python/interface/SBTarget.i deleted file mode 100644 index fccecd3b490e..000000000000 --- a/lldb/scripts/Python/interface/SBTarget.i +++ /dev/null @@ -1,778 +0,0 @@ -//===-- SWIG Interface for SBTarget -----------------------------*- C++ -*-===// -// -// The LLVM Compiler Infrastructure -// -// This file is distributed under the University of Illinois Open Source -// License. See LICENSE.TXT for details. -// -//===----------------------------------------------------------------------===// - -namespace lldb { - -class SBLaunchInfo -{ -public: - SBLaunchInfo (const char **argv); - - uint32_t - GetUserID(); - - uint32_t - GetGroupID(); - - bool - UserIDIsValid (); - - bool - GroupIDIsValid (); - - void - SetUserID (uint32_t uid); - - void - SetGroupID (uint32_t gid); - - 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); - - 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); - - 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); -}; - -class SBAttachInfo -{ -public: - SBAttachInfo (); - - SBAttachInfo (lldb::pid_t pid); - - SBAttachInfo (const char *path, bool wait_for); - - SBAttachInfo (const lldb::SBAttachInfo &rhs); - - lldb::pid_t - GetProcessID (); - - void - SetProcessID (lldb::pid_t pid); - - void - SetExecutable (const char *path); - - void - SetExecutable (lldb::SBFileSpec exe_file); - - bool - GetWaitForLaunch (); - - void - SetWaitForLaunch (bool b); - - uint32_t - GetResumeCount (); - - void - SetResumeCount (uint32_t c); - - const char * - GetProcessPluginName (); - - void - SetProcessPluginName (const char *plugin_name); - - uint32_t - GetUserID(); - - uint32_t - GetGroupID(); - - bool - UserIDIsValid (); - - bool - GroupIDIsValid (); - - void - SetUserID (uint32_t uid); - - void - SetGroupID (uint32_t gid); - - uint32_t - GetEffectiveUserID(); - - uint32_t - GetEffectiveGroupID(); - - bool - EffectiveUserIDIsValid (); - - bool - EffectiveGroupIDIsValid (); - - void - SetEffectiveUserID (uint32_t uid); - - void - SetEffectiveGroupID (uint32_t gid); - - lldb::pid_t - GetParentProcessID (); - - void - SetParentProcessID (lldb::pid_t pid); - - bool - ParentProcessIDIsValid(); -}; - - -%feature("docstring", -"Represents the target program running under the debugger. - -SBTarget supports module, breakpoint, and watchpoint iterations. For example, - - for m in target.module_iter(): - print m - -produces: - -(x86_64) /Volumes/data/lldb/svn/trunk/test/python_api/lldbutil/iter/a.out -(x86_64) /usr/lib/dyld -(x86_64) /usr/lib/libstdc++.6.dylib -(x86_64) /usr/lib/libSystem.B.dylib -(x86_64) /usr/lib/system/libmathCommon.A.dylib -(x86_64) /usr/lib/libSystem.B.dylib(__commpage) - -and, - - for b in target.breakpoint_iter(): - print b - -produces: - -SBBreakpoint: id = 1, file ='main.cpp', line = 66, locations = 1 -SBBreakpoint: id = 2, file ='main.cpp', line = 85, locations = 1 - -and, - - for wp_loc in target.watchpoint_iter(): - print wp_loc - -produces: - -Watchpoint 1: addr = 0x1034ca048 size = 4 state = enabled type = rw - declare @ '/Volumes/data/lldb/svn/trunk/test/python_api/watchpoint/main.c:12' - hw_index = 0 hit_count = 2 ignore_count = 0" -) SBTarget; -class SBTarget -{ -public: - //------------------------------------------------------------------ - // Broadcaster bits. - //------------------------------------------------------------------ - enum - { - eBroadcastBitBreakpointChanged = (1 << 0), - eBroadcastBitModulesLoaded = (1 << 1), - eBroadcastBitModulesUnloaded = (1 << 2) - }; - - //------------------------------------------------------------------ - // Constructors - //------------------------------------------------------------------ - SBTarget (); - - SBTarget (const lldb::SBTarget& rhs); - - //------------------------------------------------------------------ - // Destructor - //------------------------------------------------------------------ - ~SBTarget(); - - static const char * - GetBroadcasterClassName (); - - bool - IsValid() const; - - lldb::SBProcess - GetProcess (); - - %feature("docstring", " - //------------------------------------------------------------------ - /// Launch a new process. - /// - /// Launch a new process by spawning a new process using the - /// target object's executable module's file as the file to launch. - /// Arguments are given in \a argv, and the environment variables - /// are in \a envp. Standard input and output files can be - /// optionally re-directed to \a stdin_path, \a stdout_path, and - /// \a stderr_path. - /// - /// @param[in] listener - /// An optional listener that will receive all process events. - /// If \a listener is valid then \a listener will listen to all - /// process events. If not valid, then this target's debugger - /// (SBTarget::GetDebugger()) will listen to all process events. - /// - /// @param[in] argv - /// The argument array. - /// - /// @param[in] envp - /// The environment array. - /// - /// @param[in] launch_flags - /// Flags to modify the launch (@see lldb::LaunchFlags) - /// - /// @param[in] stdin_path - /// The path to use when re-directing the STDIN of the new - /// process. If all stdXX_path arguments are NULL, a pseudo - /// terminal will be used. - /// - /// @param[in] stdout_path - /// The path to use when re-directing the STDOUT of the new - /// process. If all stdXX_path arguments are NULL, a pseudo - /// terminal will be used. - /// - /// @param[in] stderr_path - /// The path to use when re-directing the STDERR of the new - /// process. If all stdXX_path arguments are NULL, a pseudo - /// terminal will be used. - /// - /// @param[in] working_directory - /// The working directory to have the child process run in - /// - /// @param[in] launch_flags - /// Some launch options specified by logical OR'ing - /// lldb::LaunchFlags enumeration values together. - /// - /// @param[in] stop_at_endtry - /// If false do not stop the inferior at the entry point. - /// - /// @param[out] - /// An error object. Contains the reason if there is some failure. - /// - /// @return - /// A process object for the newly created process. - //------------------------------------------------------------------ - - For example, - - process = target.Launch(self.dbg.GetListener(), None, None, - None, '/tmp/stdout.txt', None, - None, 0, False, error) - - launches a new process by passing nothing for both the args and the envs - and redirect the standard output of the inferior to the /tmp/stdout.txt - file. It does not specify a working directory so that the debug server - will use its idea of what the current working directory is for the - inferior. Also, we ask the debugger not to stop the inferior at the - entry point. If no breakpoint is specified for the inferior, it should - run to completion if no user interaction is required. - ") Launch; - lldb::SBProcess - Launch (SBListener &listener, - 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, // See LaunchFlags - bool stop_at_entry, - lldb::SBError& error); - - %feature("docstring", " - //------------------------------------------------------------------ - /// Launch a new process with sensible defaults. - /// - /// @param[in] argv - /// The argument array. - /// - /// @param[in] envp - /// The environment array. - /// - /// @param[in] working_directory - /// The working directory to have the child process run in - /// - /// Default: listener - /// Set to the target's debugger (SBTarget::GetDebugger()) - /// - /// Default: launch_flags - /// Empty launch flags - /// - /// Default: stdin_path - /// Default: stdout_path - /// Default: stderr_path - /// A pseudo terminal will be used. - /// - /// @return - /// A process object for the newly created process. - //------------------------------------------------------------------ - - For example, - - process = target.LaunchSimple(['X', 'Y', 'Z'], None, os.getcwd()) - - launches a new process by passing 'X', 'Y', 'Z' as the args to the - executable. - ") LaunchSimple; - lldb::SBProcess - LaunchSimple (const char **argv, - const char **envp, - const char *working_directory); - - lldb::SBProcess - Launch (lldb::SBLaunchInfo &launch_info, lldb::SBError& error); - - lldb::SBProcess - Attach (lldb::SBAttachInfo &attach_info, lldb::SBError& error); - - - %feature("docstring", " - //------------------------------------------------------------------ - /// Attach to process with pid. - /// - /// @param[in] listener - /// An optional listener that will receive all process events. - /// If \a listener is valid then \a listener will listen to all - /// process events. If not valid, then this target's debugger - /// (SBTarget::GetDebugger()) will listen to all process events. - /// - /// @param[in] pid - /// The process ID to attach to. - /// - /// @param[out] - /// An error explaining what went wrong if attach fails. - /// - /// @return - /// A process object for the attached process. - //------------------------------------------------------------------ - ") AttachToProcessWithID; - lldb::SBProcess - AttachToProcessWithID (SBListener &listener, - lldb::pid_t pid, - lldb::SBError& error); - - %feature("docstring", " - //------------------------------------------------------------------ - /// Attach to process with name. - /// - /// @param[in] listener - /// An optional listener that will receive all process events. - /// If \a listener is valid then \a listener will listen to all - /// process events. If not valid, then this target's debugger - /// (SBTarget::GetDebugger()) will listen to all process events. - /// - /// @param[in] name - /// Basename of process to attach to. - /// - /// @param[in] wait_for - /// If true wait for a new instance of 'name' to be launched. - /// - /// @param[out] - /// An error explaining what went wrong if attach fails. - /// - /// @return - /// A process object for the attached process. - //------------------------------------------------------------------ - ") AttachToProcessWithName; - lldb::SBProcess - AttachToProcessWithName (SBListener &listener, - const char *name, - bool wait_for, - lldb::SBError& error); - - %feature("docstring", " - //------------------------------------------------------------------ - /// Connect to a remote debug server with url. - /// - /// @param[in] listener - /// An optional listener that will receive all process events. - /// If \a listener is valid then \a listener will listen to all - /// process events. If not valid, then this target's debugger - /// (SBTarget::GetDebugger()) will listen to all process events. - /// - /// @param[in] url - /// The url to connect to, e.g., 'connect://localhost:12345'. - /// - /// @param[in] plugin_name - /// The plugin name to be used; can be NULL. - /// - /// @param[out] - /// An error explaining what went wrong if the connect fails. - /// - /// @return - /// A process object for the connected process. - //------------------------------------------------------------------ - ") ConnectRemote; - lldb::SBProcess - ConnectRemote (SBListener &listener, - const char *url, - const char *plugin_name, - SBError& error); - - lldb::SBFileSpec - GetExecutable (); - - bool - AddModule (lldb::SBModule &module); - - lldb::SBModule - AddModule (const char *path, - const char *triple, - const char *uuid); - - uint32_t - GetNumModules () const; - - lldb::SBModule - GetModuleAtIndex (uint32_t idx); - - bool - RemoveModule (lldb::SBModule module); - - lldb::SBDebugger - GetDebugger() const; - - lldb::SBModule - FindModule (const lldb::SBFileSpec &file_spec); - - lldb::ByteOrder - GetByteOrder (); - - uint32_t - GetAddressByteSize(); - - const char * - GetTriple (); - - lldb::SBError - SetSectionLoadAddress (lldb::SBSection section, - lldb::addr_t section_base_addr); - - lldb::SBError - ClearSectionLoadAddress (lldb::SBSection section); - - lldb::SBError - SetModuleLoadAddress (lldb::SBModule module, - int64_t sections_offset); - - lldb::SBError - ClearModuleLoadAddress (lldb::SBModule module); - - %feature("docstring", " - //------------------------------------------------------------------ - /// Find functions by name. - /// - /// @param[in] name - /// The name of the function we are looking for. - /// - /// @param[in] name_type_mask - /// A logical OR of one or more FunctionNameType enum bits that - /// indicate what kind of names should be used when doing the - /// lookup. Bits include fully qualified names, base names, - /// C++ methods, or ObjC selectors. - /// See FunctionNameType for more details. - /// - /// @return - /// A lldb::SBSymbolContextList that gets filled in with all of - /// the symbol contexts for all the matches. - //------------------------------------------------------------------ - ") FindFunctions; - lldb::SBSymbolContextList - FindFunctions (const char *name, - uint32_t name_type_mask = lldb::eFunctionNameTypeAny); - - lldb::SBType - FindFirstType (const char* type); - - lldb::SBTypeList - FindTypes (const char* type); - - lldb::SBSourceManager - GetSourceManager (); - - %feature("docstring", " - //------------------------------------------------------------------ - /// Find global and static variables by name. - /// - /// @param[in] name - /// The name of the global or static variable we are looking - /// for. - /// - /// @param[in] max_matches - /// Allow the number of matches to be limited to \a max_matches. - /// - /// @return - /// A list of matched variables in an SBValueList. - //------------------------------------------------------------------ - ") FindGlobalVariables; - lldb::SBValueList - FindGlobalVariables (const char *name, - uint32_t max_matches); - - void - Clear (); - - lldb::SBAddress - ResolveLoadAddress (lldb::addr_t vm_addr); - - SBSymbolContext - ResolveSymbolContextForAddress (const SBAddress& addr, - uint32_t resolve_scope); - - lldb::SBBreakpoint - BreakpointCreateByLocation (const char *file, uint32_t line); - - lldb::SBBreakpoint - BreakpointCreateByLocation (const lldb::SBFileSpec &file_spec, uint32_t line); - - lldb::SBBreakpoint - BreakpointCreateByName (const char *symbol_name, const char *module_name = NULL); - - lldb::SBBreakpoint - BreakpointCreateByName (const char *symbol_name, - uint32_t func_name_type, // Logical OR one or more FunctionNameType enum bits - const SBFileSpecList &module_list, - const SBFileSpecList &comp_unit_list); - - lldb::SBBreakpoint - BreakpointCreateByNames (const char *symbol_name[], - uint32_t num_names, - uint32_t name_type_mask, // Logical OR one or more FunctionNameType enum bits - const SBFileSpecList &module_list, - const SBFileSpecList &comp_unit_list); - - lldb::SBBreakpoint - BreakpointCreateByRegex (const char *symbol_name_regex, const char *module_name = NULL); - - lldb::SBBreakpoint - BreakpointCreateBySourceRegex (const char *source_regex, const lldb::SBFileSpec &source_file, const char *module_name = NULL); - - lldb::SBBreakpoint - BreakpointCreateForException (lldb::LanguageType language, - bool catch_bp, - bool throw_bp); - - lldb::SBBreakpoint - BreakpointCreateByAddress (addr_t address); - - uint32_t - GetNumBreakpoints () const; - - lldb::SBBreakpoint - GetBreakpointAtIndex (uint32_t idx) const; - - bool - BreakpointDelete (break_id_t break_id); - - lldb::SBBreakpoint - FindBreakpointByID (break_id_t break_id); - - bool - EnableAllBreakpoints (); - - bool - DisableAllBreakpoints (); - - bool - DeleteAllBreakpoints (); - - uint32_t - GetNumWatchpoints () const; - - lldb::SBWatchpoint - GetWatchpointAtIndex (uint32_t idx) const; - - bool - DeleteWatchpoint (lldb::watch_id_t watch_id); - - lldb::SBWatchpoint - FindWatchpointByID (lldb::watch_id_t watch_id); - - bool - EnableAllWatchpoints (); - - bool - DisableAllWatchpoints (); - - bool - DeleteAllWatchpoints (); - - lldb::SBWatchpoint - WatchAddress (lldb::addr_t addr, - size_t size, - bool read, - bool write); - - - lldb::SBBroadcaster - GetBroadcaster () const; - - lldb::SBInstructionList - ReadInstructions (lldb::SBAddress base_addr, uint32_t count); - - lldb::SBInstructionList - GetInstructions (lldb::SBAddress base_addr, const void *buf, size_t size); - - bool - GetDescription (lldb::SBStream &description, lldb::DescriptionLevel description_level); - - %pythoncode %{ - class modules_access(object): - '''A helper object that will lazily hand out lldb.SBModule objects for a target when supplied an index, or by full or partial path.''' - def __init__(self, sbtarget): - self.sbtarget = sbtarget - - def __len__(self): - if self.sbtarget: - return self.sbtarget.GetNumModules() - return 0 - - def __getitem__(self, key): - num_modules = self.sbtarget.GetNumModules() - if type(key) is int: - if key < num_modules: - return self.sbtarget.GetModuleAtIndex(key) - elif type(key) is str: - if key.find('/') == -1: - for idx in range(num_modules): - module = self.sbtarget.GetModuleAtIndex(idx) - if module.file.basename == key: - return module - else: - for idx in range(num_modules): - module = self.sbtarget.GetModuleAtIndex(idx) - if module.file.fullpath == key: - return module - # See if the string is a UUID - the_uuid = uuid.UUID(key) - if the_uuid: - for idx in range(num_modules): - module = self.sbtarget.GetModuleAtIndex(idx) - if module.uuid == the_uuid: - return module - elif type(key) is uuid.UUID: - for idx in range(num_modules): - module = self.sbtarget.GetModuleAtIndex(idx) - if module.uuid == key: - return module - elif type(key) is re.SRE_Pattern: - matching_modules = [] - for idx in range(num_modules): - module = self.sbtarget.GetModuleAtIndex(idx) - re_match = key.search(module.path.fullpath) - if re_match: - matching_modules.append(module) - return matching_modules - else: - print "error: unsupported item type: %s" % type(key) - return None - - def get_modules_access_object(self): - '''An accessor function that returns a modules_access() object which allows lazy module access from a lldb.SBTarget object.''' - return self.modules_access (self) - - def get_modules_array(self): - '''An accessor function that returns a list() that contains all modules in a lldb.SBTarget object.''' - modules = [] - for idx in range(self.GetNumModules()): - modules.append(self.GetModuleAtIndex(idx)) - return modules - - __swig_getmethods__["modules"] = get_modules_array - if _newclass: x = property(get_modules_array, None) - - __swig_getmethods__["module"] = get_modules_access_object - if _newclass: x = property(get_modules_access_object, None) - - __swig_getmethods__["process"] = GetProcess - if _newclass: x = property(GetProcess, None) - - __swig_getmethods__["executable"] = GetExecutable - if _newclass: x = property(GetExecutable, None) - - __swig_getmethods__["debugger"] = GetDebugger - if _newclass: x = property(GetDebugger, None) - - __swig_getmethods__["num_breakpoints"] = GetNumBreakpoints - if _newclass: x = property(GetNumBreakpoints, None) - - __swig_getmethods__["num_watchpoints"] = GetNumWatchpoints - if _newclass: x = property(GetNumWatchpoints, None) - - __swig_getmethods__["broadcaster"] = GetBroadcaster - if _newclass: x = property(GetBroadcaster, None) - - __swig_getmethods__["byte_order"] = GetByteOrder - if _newclass: x = property(GetByteOrder, None) - - __swig_getmethods__["addr_size"] = GetAddressByteSize - if _newclass: x = property(GetAddressByteSize, None) - - __swig_getmethods__["triple"] = GetTriple - if _newclass: x = property(GetTriple, None) - %} - -}; - -} // namespace lldb |