//===-- 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 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 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 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