xref: /qemu/scripts/qemu-gdb.py (revision 72ac97cd) 
1#!/usr/bin/python
2
3# GDB debugging support
4#
5# Copyright 2012 Red Hat, Inc. and/or its affiliates
6#
7# Authors:
8#  Avi Kivity <avi@redhat.com>
9#
10# This work is licensed under the terms of the GNU GPL, version 2.  See
11# the COPYING file in the top-level directory.
12#
13# Contributions after 2012-01-13 are licensed under the terms of the
14# GNU GPL, version 2 or (at your option) any later version.
15
16
17import gdb
18
19def isnull(ptr):
20    return ptr == gdb.Value(0).cast(ptr.type)
21
22def int128(p):
23    return long(p['lo']) + (long(p['hi']) << 64)
24
25class QemuCommand(gdb.Command):
26    '''Prefix for QEMU debug support commands'''
27    def __init__(self):
28        gdb.Command.__init__(self, 'qemu', gdb.COMMAND_DATA,
29                             gdb.COMPLETE_NONE, True)
30
31class MtreeCommand(gdb.Command):
32    '''Display the memory tree hierarchy'''
33    def __init__(self):
34        gdb.Command.__init__(self, 'qemu mtree', gdb.COMMAND_DATA,
35                             gdb.COMPLETE_NONE)
36        self.queue = []
37    def invoke(self, arg, from_tty):
38        self.seen = set()
39        self.queue_root('address_space_memory')
40        self.queue_root('address_space_io')
41        self.process_queue()
42    def queue_root(self, varname):
43        ptr = gdb.parse_and_eval(varname)['root']
44        self.queue.append(ptr)
45    def process_queue(self):
46        while self.queue:
47            ptr = self.queue.pop(0)
48            if long(ptr) in self.seen:
49                continue
50            self.print_item(ptr)
51    def print_item(self, ptr, offset = gdb.Value(0), level = 0):
52        self.seen.add(long(ptr))
53        addr = ptr['addr']
54        addr += offset
55        size = int128(ptr['size'])
56        alias = ptr['alias']
57        klass = ''
58        if not isnull(alias):
59            klass = ' (alias)'
60        elif not isnull(ptr['ops']):
61            klass = ' (I/O)'
62        elif bool(ptr['ram']):
63            klass = ' (RAM)'
64        gdb.write('%s%016x-%016x %s%s (@ %s)\n'
65                  % ('  ' * level,
66                     long(addr),
67                     long(addr + (size - 1)),
68                     ptr['name'].string(),
69                     klass,
70                     ptr,
71                     ),
72                  gdb.STDOUT)
73        if not isnull(alias):
74            gdb.write('%s    alias: %s@%016x (@ %s)\n' %
75                      ('  ' * level,
76                       alias['name'].string(),
77                       ptr['alias_offset'],
78                       alias,
79                       ),
80                      gdb.STDOUT)
81            self.queue.append(alias)
82        subregion = ptr['subregions']['tqh_first']
83        level += 1
84        while not isnull(subregion):
85            self.print_item(subregion, addr, level)
86            subregion = subregion['subregions_link']['tqe_next']
87
88QemuCommand()
89MtreeCommand()
90