#ifdef SWIGPYTHON %pythoncode%{ # ================================== # Helper function for SBModule class # ================================== def in_range(symbol, section): """Test whether a symbol is within the range of a section.""" symSA = symbol.GetStartAddress().GetFileAddress() symEA = symbol.GetEndAddress().GetFileAddress() secSA = section.GetFileAddress() secEA = secSA + section.GetByteSize() if symEA != LLDB_INVALID_ADDRESS: if secSA <= symSA and symEA <= secEA: return True else: return False else: if secSA <= symSA and symSA < secEA: return True else: return False %} #endif STRING_EXTENSION_OUTSIDE(SBModule) %extend lldb::SBModule { #ifdef SWIGPYTHON %pythoncode %{ # operator== is a free function, which swig does not handle, so we inject # our own equality operator here def __eq__(self, other): return not self.__ne__(other) def __len__(self): '''Return the number of symbols in a lldb.SBModule object.''' return self.GetNumSymbols() def __iter__(self): '''Iterate over all symbols in a lldb.SBModule object.''' return lldb_iter(self, 'GetNumSymbols', 'GetSymbolAtIndex') def section_iter(self): '''Iterate over all sections in a lldb.SBModule object.''' return lldb_iter(self, 'GetNumSections', 'GetSectionAtIndex') def compile_unit_iter(self): '''Iterate over all compile units in a lldb.SBModule object.''' return lldb_iter(self, 'GetNumCompileUnits', 'GetCompileUnitAtIndex') def symbol_in_section_iter(self, section): '''Given a module and its contained section, returns an iterator on the symbols within the section.''' for sym in self: if in_range(sym, section): yield sym class symbols_access(object): re_compile_type = type(re.compile('.')) '''A helper object that will lazily hand out lldb.SBSymbol objects for a module when supplied an index, name, or regular expression.''' def __init__(self, sbmodule): self.sbmodule = sbmodule def __len__(self): if self.sbmodule: return int(self.sbmodule.GetNumSymbols()) return 0 def __getitem__(self, key): count = len(self) if type(key) is int: if -count <= key < count: key %= count return self.sbmodule.GetSymbolAtIndex(key) elif type(key) is str: matches = [] sc_list = self.sbmodule.FindSymbols(key) for sc in sc_list: symbol = sc.symbol if symbol: matches.append(symbol) return matches elif isinstance(key, self.re_compile_type): matches = [] for idx in range(count): symbol = self.sbmodule.GetSymbolAtIndex(idx) added = False name = symbol.name if name: re_match = key.search(name) if re_match: matches.append(symbol) added = True if not added: mangled = symbol.mangled if mangled: re_match = key.search(mangled) if re_match: matches.append(symbol) return matches else: print("error: unsupported item type: %s" % type(key)) return None def get_symbols_access_object(self): '''An accessor function that returns a symbols_access() object which allows lazy symbol access from a lldb.SBModule object.''' return self.symbols_access (self) def get_compile_units_access_object (self): '''An accessor function that returns a compile_units_access() object which allows lazy compile unit access from a lldb.SBModule object.''' return self.compile_units_access (self) def get_symbols_array(self): '''An accessor function that returns a list() that contains all symbols in a lldb.SBModule object.''' symbols = [] for idx in range(self.num_symbols): symbols.append(self.GetSymbolAtIndex(idx)) return symbols class sections_access(object): re_compile_type = type(re.compile('.')) '''A helper object that will lazily hand out lldb.SBSection objects for a module when supplied an index, name, or regular expression.''' def __init__(self, sbmodule): self.sbmodule = sbmodule def __len__(self): if self.sbmodule: return int(self.sbmodule.GetNumSections()) return 0 def __getitem__(self, key): count = len(self) if type(key) is int: if -count <= key < count: key %= count return self.sbmodule.GetSectionAtIndex(key) elif type(key) is str: for idx in range(count): section = self.sbmodule.GetSectionAtIndex(idx) if section.name == key: return section elif isinstance(key, self.re_compile_type): matches = [] for idx in range(count): section = self.sbmodule.GetSectionAtIndex(idx) name = section.name if name: re_match = key.search(name) if re_match: matches.append(section) return matches else: print("error: unsupported item type: %s" % type(key)) return None class compile_units_access(object): re_compile_type = type(re.compile('.')) '''A helper object that will lazily hand out lldb.SBCompileUnit objects for a module when supplied an index, full or partial path, or regular expression.''' def __init__(self, sbmodule): self.sbmodule = sbmodule def __len__(self): if self.sbmodule: return int(self.sbmodule.GetNumCompileUnits()) return 0 def __getitem__(self, key): count = len(self) if type(key) is int: if -count <= key < count: key %= count return self.sbmodule.GetCompileUnitAtIndex(key) elif type(key) is str: is_full_path = key[0] == '/' for idx in range(count): comp_unit = self.sbmodule.GetCompileUnitAtIndex(idx) if is_full_path: if comp_unit.file.fullpath == key: return comp_unit else: if comp_unit.file.basename == key: return comp_unit elif isinstance(key, self.re_compile_type): matches = [] for idx in range(count): comp_unit = self.sbmodule.GetCompileUnitAtIndex(idx) fullpath = comp_unit.file.fullpath if fullpath: re_match = key.search(fullpath) if re_match: matches.append(comp_unit) return matches else: print("error: unsupported item type: %s" % type(key)) return None def get_sections_access_object(self): '''An accessor function that returns a sections_access() object which allows lazy section array access.''' return self.sections_access (self) def get_sections_array(self): '''An accessor function that returns an array object that contains all sections in this module object.''' if not hasattr(self, 'sections_array'): self.sections_array = [] for idx in range(self.num_sections): self.sections_array.append(self.GetSectionAtIndex(idx)) return self.sections_array def get_compile_units_array(self): '''An accessor function that returns an array object that contains all compile_units in this module object.''' if not hasattr(self, 'compile_units_array'): self.compile_units_array = [] for idx in range(self.GetNumCompileUnits()): self.compile_units_array.append(self.GetCompileUnitAtIndex(idx)) return self.compile_units_array symbols = property(get_symbols_array, None, doc='''A read only property that returns a list() of lldb.SBSymbol objects contained in this module.''') symbol = property(get_symbols_access_object, None, doc='''A read only property that can be used to access symbols by index ("symbol = module.symbol[0]"), name ("symbols = module.symbol['main']"), or using a regular expression ("symbols = module.symbol[re.compile(...)]"). The return value is a single lldb.SBSymbol object for array access, and a list() of lldb.SBSymbol objects for name and regular expression access''') sections = property(get_sections_array, None, doc='''A read only property that returns a list() of lldb.SBSection objects contained in this module.''') compile_units = property(get_compile_units_array, None, doc='''A read only property that returns a list() of lldb.SBCompileUnit objects contained in this module.''') section = property(get_sections_access_object, None, doc='''A read only property that can be used to access symbols by index ("section = module.section[0]"), name ("sections = module.section[\'main\']"), or using a regular expression ("sections = module.section[re.compile(...)]"). The return value is a single lldb.SBSection object for array access, and a list() of lldb.SBSection objects for name and regular expression access''') section = property(get_sections_access_object, None, doc='''A read only property that can be used to access compile units by index ("compile_unit = module.compile_unit[0]"), name ("compile_unit = module.compile_unit[\'main.cpp\']"), or using a regular expression ("compile_unit = module.compile_unit[re.compile(...)]"). The return value is a single lldb.SBCompileUnit object for array access or by full or partial path, and a list() of lldb.SBCompileUnit objects regular expressions.''') def get_uuid(self): return uuid.UUID (self.GetUUIDString()) uuid = property(get_uuid, None, doc='''A read only property that returns a standard python uuid.UUID object that represents the UUID of this module.''') file = property(GetFileSpec, None, doc='''A read only property that returns an lldb object that represents the file (lldb.SBFileSpec) for this object file for this module as it is represented where it is being debugged.''') platform_file = property(GetPlatformFileSpec, None, doc='''A read only property that returns an lldb object that represents the file (lldb.SBFileSpec) for this object file for this module as it is represented on the current host system.''') byte_order = property(GetByteOrder, None, doc='''A read only property that returns an lldb enumeration value (lldb.eByteOrderLittle, lldb.eByteOrderBig, lldb.eByteOrderInvalid) that represents the byte order for this module.''') addr_size = property(GetAddressByteSize, None, doc='''A read only property that returns the size in bytes of an address for this module.''') triple = property(GetTriple, None, doc='''A read only property that returns the target triple (arch-vendor-os) for this module.''') num_symbols = property(GetNumSymbols, None, doc='''A read only property that returns number of symbols in the module symbol table as an integer.''') num_sections = property(GetNumSections, None, doc='''A read only property that returns number of sections in the module as an integer.''') %} #endif }