forked from OSchip/llvm-project
				
			
		
			
				
	
	
		
			313 lines
		
	
	
		
			9.0 KiB
		
	
	
	
		
			Python
		
	
	
	
			
		
		
	
	
			313 lines
		
	
	
		
			9.0 KiB
		
	
	
	
		
			Python
		
	
	
	
import gdb.printing
 | 
						|
class SmallStringPrinter:
 | 
						|
  """Print an llvm::SmallString object."""
 | 
						|
 | 
						|
  def __init__(self, val):
 | 
						|
    self.val = val
 | 
						|
 | 
						|
  def to_string(self):
 | 
						|
    begin = self.val['BeginX']
 | 
						|
    end = self.val['EndX']
 | 
						|
    return begin.cast(gdb.lookup_type("char").pointer()).string(length = end - begin)
 | 
						|
 | 
						|
  def display_hint (self):
 | 
						|
    return 'string'
 | 
						|
 | 
						|
class StringRefPrinter:
 | 
						|
  """Print an llvm::StringRef object."""
 | 
						|
 | 
						|
  def __init__(self, val):
 | 
						|
    self.val = val
 | 
						|
 | 
						|
  def to_string(self):
 | 
						|
    return self.val['Data'].string(length =  self.val['Length'])
 | 
						|
 | 
						|
  def display_hint (self):
 | 
						|
    return 'string'
 | 
						|
 | 
						|
class SmallVectorPrinter:
 | 
						|
  """Print an llvm::SmallVector object."""
 | 
						|
 | 
						|
  class _iterator:
 | 
						|
    def __init__(self, begin, end):
 | 
						|
      self.cur = begin
 | 
						|
      self.end = end
 | 
						|
      self.count = 0
 | 
						|
 | 
						|
    def __iter__(self):
 | 
						|
      return self
 | 
						|
 | 
						|
    def next(self):
 | 
						|
      if self.cur == self.end:
 | 
						|
        raise StopIteration
 | 
						|
      count = self.count
 | 
						|
      self.count = self.count + 1
 | 
						|
      cur = self.cur
 | 
						|
      self.cur = self.cur + 1
 | 
						|
      return '[%d]' % count, cur.dereference()
 | 
						|
 | 
						|
    __next__ = next
 | 
						|
 | 
						|
  def __init__(self, val):
 | 
						|
    self.val = val
 | 
						|
 | 
						|
  def children(self):
 | 
						|
    t = self.val.type.template_argument(0).pointer()
 | 
						|
    begin = self.val['BeginX'].cast(t)
 | 
						|
    end = self.val['EndX'].cast(t)
 | 
						|
    return self._iterator(begin, end)
 | 
						|
 | 
						|
  def to_string(self):
 | 
						|
    t = self.val.type.template_argument(0).pointer()
 | 
						|
    begin = self.val['BeginX'].cast(t)
 | 
						|
    end = self.val['EndX'].cast(t)
 | 
						|
    capacity = self.val['CapacityX'].cast(t)
 | 
						|
    return 'llvm::SmallVector of length %d, capacity %d' % (end - begin, capacity - begin)
 | 
						|
 | 
						|
  def display_hint (self):
 | 
						|
    return 'array'
 | 
						|
 | 
						|
class ArrayRefPrinter:
 | 
						|
  """Print an llvm::ArrayRef object."""
 | 
						|
 | 
						|
  class _iterator:
 | 
						|
    def __init__(self, begin, end):
 | 
						|
      self.cur = begin
 | 
						|
      self.end = end
 | 
						|
      self.count = 0
 | 
						|
 | 
						|
    def __iter__(self):
 | 
						|
      return self
 | 
						|
 | 
						|
    def next(self):
 | 
						|
      if self.cur == self.end:
 | 
						|
        raise StopIteration
 | 
						|
      count = self.count
 | 
						|
      self.count = self.count + 1
 | 
						|
      cur = self.cur
 | 
						|
      self.cur = self.cur + 1
 | 
						|
      return '[%d]' % count, cur.dereference()
 | 
						|
 | 
						|
    __next__ = next
 | 
						|
 | 
						|
  def __init__(self, val):
 | 
						|
    self.val = val
 | 
						|
 | 
						|
  def children(self):
 | 
						|
    data = self.val['Data']
 | 
						|
    return self._iterator(data, data + self.val['Length'])
 | 
						|
 | 
						|
  def to_string(self):
 | 
						|
    return 'llvm::ArrayRef of length %d' % (self.val['Length'])
 | 
						|
 | 
						|
  def display_hint (self):
 | 
						|
    return 'array'
 | 
						|
 | 
						|
class OptionalPrinter:
 | 
						|
  """Print an llvm::Optional object."""
 | 
						|
 | 
						|
  def __init__(self, value):
 | 
						|
    self.value = value
 | 
						|
 | 
						|
  class _iterator:
 | 
						|
    def __init__(self, member, empty):
 | 
						|
      self.member = member
 | 
						|
      self.done = empty
 | 
						|
 | 
						|
    def __iter__(self):
 | 
						|
      return self
 | 
						|
 | 
						|
    def next(self):
 | 
						|
      if self.done:
 | 
						|
        raise StopIteration
 | 
						|
      self.done = True
 | 
						|
      return ('value', self.member.dereference())
 | 
						|
 | 
						|
  def children(self):
 | 
						|
    if not self.value['hasVal']:
 | 
						|
      return self._iterator('', True)
 | 
						|
    return self._iterator(self.value['storage']['buffer'].address.cast(self.value.type.template_argument(0).pointer()), False)
 | 
						|
 | 
						|
  def to_string(self):
 | 
						|
    return 'llvm::Optional is %sinitialized' % ('' if self.value['hasVal'] else 'not ')
 | 
						|
 | 
						|
class DenseMapPrinter:
 | 
						|
  "Print a DenseMap"
 | 
						|
 | 
						|
  class _iterator:
 | 
						|
    def __init__(self, key_info_t, begin, end):
 | 
						|
      self.key_info_t = key_info_t
 | 
						|
      self.cur = begin
 | 
						|
      self.end = end
 | 
						|
      self.advancePastEmptyBuckets()
 | 
						|
      self.first = True
 | 
						|
 | 
						|
    def __iter__(self):
 | 
						|
      return self
 | 
						|
 | 
						|
    def advancePastEmptyBuckets(self):
 | 
						|
      # disabled until the comments below can be addressed
 | 
						|
      # keeping as notes/posterity/hints for future contributors
 | 
						|
      return
 | 
						|
      n = self.key_info_t.name
 | 
						|
      is_equal = gdb.parse_and_eval(n + '::isEqual')
 | 
						|
      empty = gdb.parse_and_eval(n + '::getEmptyKey()')
 | 
						|
      tombstone = gdb.parse_and_eval(n + '::getTombstoneKey()')
 | 
						|
      # the following is invalid, GDB fails with:
 | 
						|
      #   Python Exception <class 'gdb.error'> Attempt to take address of value
 | 
						|
      #   not located in memory.
 | 
						|
      # because isEqual took parameter (for the unsigned long key I was testing)
 | 
						|
      # by const ref, and GDB
 | 
						|
      # It's also not entirely general - we should be accessing the "getFirst()"
 | 
						|
      # member function, not the 'first' member variable, but I've yet to figure
 | 
						|
      # out how to find/call member functions (especially (const) overloaded
 | 
						|
      # ones) on a gdb.Value.
 | 
						|
      while self.cur != self.end and (is_equal(self.cur.dereference()['first'], empty) or is_equal(self.cur.dereference()['first'], tombstone)):
 | 
						|
        self.cur = self.cur + 1
 | 
						|
 | 
						|
    def next(self):
 | 
						|
      if self.cur == self.end:
 | 
						|
        raise StopIteration
 | 
						|
      cur = self.cur
 | 
						|
      v = cur.dereference()['first' if self.first else 'second']
 | 
						|
      if not self.first:
 | 
						|
        self.cur = self.cur + 1
 | 
						|
        self.advancePastEmptyBuckets()
 | 
						|
        self.first = True
 | 
						|
      else:
 | 
						|
        self.first = False
 | 
						|
      return 'x', v
 | 
						|
 | 
						|
  def __init__(self, val):
 | 
						|
    self.val = val
 | 
						|
 | 
						|
  def children(self):
 | 
						|
    t = self.val.type.template_argument(3).pointer()
 | 
						|
    begin = self.val['Buckets'].cast(t)
 | 
						|
    end = (begin + self.val['NumBuckets']).cast(t)
 | 
						|
    return self._iterator(self.val.type.template_argument(2), begin, end)
 | 
						|
 | 
						|
  def to_string(self):
 | 
						|
    return 'llvm::DenseMap with %d elements' % (self.val['NumEntries'])
 | 
						|
 | 
						|
  def display_hint(self):
 | 
						|
    return 'map'
 | 
						|
 | 
						|
class TwinePrinter:
 | 
						|
  "Print a Twine"
 | 
						|
 | 
						|
  def __init__(self, val):
 | 
						|
    self._val = val
 | 
						|
 | 
						|
  def display_hint(self):
 | 
						|
    return 'string'
 | 
						|
 | 
						|
  def string_from_pretty_printer_lookup(self, val):
 | 
						|
    '''Lookup the default pretty-printer for val and use it.
 | 
						|
 | 
						|
    If no pretty-printer is defined for the type of val, print an error and
 | 
						|
    return a placeholder string.'''
 | 
						|
 | 
						|
    pp = gdb.default_visualizer(val)
 | 
						|
    if pp:
 | 
						|
      s = pp.to_string()
 | 
						|
 | 
						|
      # The pretty-printer may return a LazyString instead of an actual Python
 | 
						|
      # string.  Convert it to a Python string.  However, GDB doesn't seem to
 | 
						|
      # register the LazyString type, so we can't check
 | 
						|
      # "type(s) == gdb.LazyString".
 | 
						|
      if 'LazyString' in type(s).__name__:
 | 
						|
        s = s.value().address.string()
 | 
						|
 | 
						|
    else:
 | 
						|
      print(('No pretty printer for {} found. The resulting Twine ' +
 | 
						|
             'representation will be incomplete.').format(val.type.name))
 | 
						|
      s = '(missing {})'.format(val.type.name)
 | 
						|
 | 
						|
    return s
 | 
						|
 | 
						|
  def string_from_child(self, child, kind):
 | 
						|
    '''Return the string representation of the Twine::Child child.'''
 | 
						|
 | 
						|
    if kind in ('llvm::Twine::EmptyKind', 'llvm::Twine::NullKind'):
 | 
						|
      return ''
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::TwineKind':
 | 
						|
      return self.string_from_twine_object(child['twine'].dereference())
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::CStringKind':
 | 
						|
      return child['cString'].string()
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::StdStringKind':
 | 
						|
      val = child['stdString'].dereference()
 | 
						|
      return self.string_from_pretty_printer_lookup(val)
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::StringRefKind':
 | 
						|
      val = child['stringRef'].dereference()
 | 
						|
      pp = StringRefPrinter(val)
 | 
						|
      return pp.to_string()
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::SmallStringKind':
 | 
						|
      val = child['smallString'].dereference()
 | 
						|
      pp = SmallStringPrinter(val)
 | 
						|
      return pp.to_string()
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::CharKind':
 | 
						|
      return chr(child['character'])
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::DecUIKind':
 | 
						|
      return str(child['decUI'])
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::DecIKind':
 | 
						|
      return str(child['decI'])
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::DecULKind':
 | 
						|
      return str(child['decUL'].dereference())
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::DecLKind':
 | 
						|
      return str(child['decL'].dereference())
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::DecULLKind':
 | 
						|
      return str(child['decULL'].dereference())
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::DecLLKind':
 | 
						|
      return str(child['decLL'].dereference())
 | 
						|
 | 
						|
    if kind == 'llvm::Twine::UHexKind':
 | 
						|
      val = child['uHex'].dereference()
 | 
						|
      return hex(int(val))
 | 
						|
 | 
						|
    print(('Unhandled NodeKind {} in Twine pretty-printer. The result will be '
 | 
						|
           'incomplete.').format(kind))
 | 
						|
 | 
						|
    return '(unhandled {})'.format(kind)
 | 
						|
 | 
						|
  def string_from_twine_object(self, twine):
 | 
						|
    '''Return the string representation of the Twine object twine.'''
 | 
						|
 | 
						|
    lhs_str = ''
 | 
						|
    rhs_str = ''
 | 
						|
 | 
						|
    lhs = twine['LHS']
 | 
						|
    rhs = twine['RHS']
 | 
						|
    lhs_kind = str(twine['LHSKind'])
 | 
						|
    rhs_kind = str(twine['RHSKind'])
 | 
						|
 | 
						|
    lhs_str = self.string_from_child(lhs, lhs_kind)
 | 
						|
    rhs_str = self.string_from_child(rhs, rhs_kind)
 | 
						|
 | 
						|
    return lhs_str + rhs_str
 | 
						|
 | 
						|
  def to_string(self):
 | 
						|
    return self.string_from_twine_object(self._val)
 | 
						|
 | 
						|
pp = gdb.printing.RegexpCollectionPrettyPrinter("LLVMSupport")
 | 
						|
pp.add_printer('llvm::SmallString', '^llvm::SmallString<.*>$', SmallStringPrinter)
 | 
						|
pp.add_printer('llvm::StringRef', '^llvm::StringRef$', StringRefPrinter)
 | 
						|
pp.add_printer('llvm::SmallVectorImpl', '^llvm::SmallVector(Impl)?<.*>$', SmallVectorPrinter)
 | 
						|
pp.add_printer('llvm::ArrayRef', '^llvm::(Const)?ArrayRef<.*>$', ArrayRefPrinter)
 | 
						|
pp.add_printer('llvm::Optional', '^llvm::Optional<.*>$', OptionalPrinter)
 | 
						|
pp.add_printer('llvm::DenseMap', '^llvm::DenseMap<.*>$', DenseMapPrinter)
 | 
						|
pp.add_printer('llvm::Twine', '^llvm::Twine$', TwinePrinter)
 | 
						|
gdb.printing.register_pretty_printer(gdb.current_objfile(), pp)
 |