pypy / pypy / tool /

Some convenience macros for gdb.  If you have pypy in your path, you can simply do:

(gdb) python import pypy.tool.gdb_pypy

Or, alternatively:

(gdb) python execfile('/path/to/')

from __future__ import with_statement

import re
import sys
import os.path

    # when running inside gdb
    from gdb import Command
except ImportError:
    # whenn running outside gdb: mock class for testing
    class Command(object):
        def __init__(self, name, command_class):

MAX_DISPLAY_LENGTH = 100 # maximum number of characters displayed in rpy_string

def find_field_with_suffix(val, suffix):
    Return ``val[field]``, where ``field`` is the only one whose name ends
    with ``suffix``.  If there is no such field, or more than one, raise KeyError.
    names = []
    for field in val.type.fields():
    if len(names) == 1:
        return val[names[0]]
    elif len(names) == 0:
        raise KeyError, "cannot find field *%s" % suffix
        raise KeyError, "too many matching fields: %s" % ', '.join(names)

def lookup(val, suffix):
    Lookup a field which ends with ``suffix`` following the rpython struct
    inheritance hierarchy (i.e., looking both at ``val`` and
    ``val['*_super']``, recursively.
        return find_field_with_suffix(val, suffix)
    except KeyError:
        baseobj = find_field_with_suffix(val, '_super')
        return lookup(baseobj, suffix)

class RPyType(Command):
    Prints the RPython type of the expression (remember to dereference it!)
    It assumes to find ``typeids.txt`` in the current directory.

    (gdb) rpy_type *l_v123
    GcStruct { super, inst_xxx, inst_yyy }

    prog2typeids = {}

    def __init__(self, gdb=None):
        # dependency injection, for tests
        if gdb is None:
            import gdb
        self.gdb = gdb
        Command.__init__(self, "rpy_type", self.gdb.COMMAND_NONE)

    def invoke(self, arg, from_tty):
        # some magic code to automatically reload the python file while developing
        ## from pypy.tool import gdb_pypy
        ## reload(gdb_pypy)
        ## gdb_pypy.RPyType.prog2typeids = self.prog2typeids # persist the cache
        ## self.__class__ = gdb_pypy.RPyType
        print self.do_invoke(arg, from_tty)

    def do_invoke(self, arg, from_tty):
        obj = self.gdb.parse_and_eval(arg)
        hdr = lookup(obj, '_gcheader')
        tid = hdr['h_tid']
        offset = tid & 0xFFFFFFFF # 64bit only
        offset = int(offset) # convert from gdb.Value to python int
        typeids = self.get_typeids()
        if offset in typeids:
            return typeids[offset]
            return 'Cannot find the type with offset %d' % offset

    def get_typeids(self):
        progspace = self.gdb.current_progspace()
            return self.prog2typeids[progspace]
        except KeyError:
            typeids = self.load_typeids(progspace)
            self.prog2typeids[progspace] = typeids
            return typeids

    def load_typeids(self, progspace):
        Returns a mapping offset --> description
        exename = progspace.filename
        root = os.path.dirname(exename)
        typeids_txt = os.path.join(root, 'typeids.txt')
        if not os.path.exists(typeids_txt):
            newroot = os.path.dirname(root)
            typeids_txt = os.path.join(newroot, 'typeids.txt')
        print 'loading', typeids_txt
        typeids = {}
        with open(typeids_txt) as f:
            for line in f:
                member, descr = map(str.strip, line.split(None, 1))
                expr = "((char*)(&pypy_g_typeinfo.%s)) - (char*)&pypy_g_typeinfo" % member
                offset = int(self.gdb.parse_and_eval(expr))
                typeids[offset] = descr
        return typeids

def is_ptr(type, gdb):
    if gdb is None:
        import gdb # so we can pass a fake one from the tests
    return type.code == gdb.TYPE_CODE_PTR

class RPyStringPrinter(object):
    Pretty printer for rpython strings.

    Note that this pretty prints *pointers* to strings: this way you can do "p
    val" and see the nice string, and "p *val" to see the underyling struct

    def __init__(self, val):
        self.val = val

    def lookup(cls, val, gdb=None):
        t = val.type
        if is_ptr(t, gdb) and == 'pypy_rpy_string0':
            return cls(val)
        return None

    def to_string(self):
        chars = self.val['rs_chars']
        length = int(chars['length'])
        items = chars['items']
        res = []
        for i in range(min(length, MAX_DISPLAY_LENGTH)):
            except ValueError:
                # it's a gdb.Value so it has "121 'y'" as repr
                res.append(chr(int(str(items[0]).split(" ")[0])))
        if length > MAX_DISPLAY_LENGTH:
        string = ''.join(res)
        return 'r' + repr(string)

class RPyListPrinter(object):
    Pretty printer for rpython lists

    Note that this pretty prints *pointers* to lists: this way you can do "p
    val" and see the nice repr, and "p *val" to see the underyling struct

    def __init__(self, val):
        self.val = val

    def lookup(cls, val, gdb=None):
        t = val.type
        if (is_ptr(t, gdb) and is not None and
            return cls(val)
        return None

    def to_string(self):
        length = int(self.val['l_length'])
        array = self.val['l_items']
        allocated = int(array['length'])
        items = array['items']
        itemlist = []
        for i in range(length):
            item = items[i]
        str_items = ', '.join(itemlist)
        return 'r[%s] (len=%d, alloc=%d)' % (str_items, length, allocated)

    import gdb
    RPyType() # side effects
    gdb.pretty_printers += [
except ImportError: