xref: /openbmc/linux/scripts/gdb/linux/utils.py (revision 4d040cbc)
1#
2# gdb helper commands and functions for Linux kernel debugging
3#
4#  common utilities
5#
6# Copyright (c) Siemens AG, 2011-2013
7#
8# Authors:
9#  Jan Kiszka <jan.kiszka@siemens.com>
10#
11# This work is licensed under the terms of the GNU GPL version 2.
12#
13
14import gdb
15
16
17class CachedType:
18    def __init__(self, name):
19        self._type = None
20        self._name = name
21
22    def _new_objfile_handler(self, event):
23        self._type = None
24        gdb.events.new_objfile.disconnect(self._new_objfile_handler)
25
26    def get_type(self):
27        if self._type is None:
28            self._type = gdb.lookup_type(self._name)
29            if self._type is None:
30                raise gdb.GdbError(
31                    "cannot resolve type '{0}'".format(self._name))
32            if hasattr(gdb, 'events') and hasattr(gdb.events, 'new_objfile'):
33                gdb.events.new_objfile.connect(self._new_objfile_handler)
34        return self._type
35
36
37long_type = CachedType("long")
38ulong_type = CachedType("unsigned long")
39uint_type = CachedType("unsigned int")
40atomic_long_type = CachedType("atomic_long_t")
41size_t_type = CachedType("size_t")
42struct_page_type = CachedType("struct page")
43
44def get_uint_type():
45    global uint_type
46    return uint_type.get_type()
47
48def get_page_type():
49    global struct_page_type
50    return struct_page_type.get_type()
51
52def get_long_type():
53    global long_type
54    return long_type.get_type()
55
56def get_ulong_type():
57    global ulong_type
58    return ulong_type.get_type()
59
60def get_size_t_type():
61    global size_t_type
62    return size_t_type.get_type()
63
64def offset_of(typeobj, field):
65    element = gdb.Value(0).cast(typeobj)
66    return int(str(element[field].address).split()[0], 16)
67
68
69def container_of(ptr, typeobj, member):
70    return (ptr.cast(get_long_type()) -
71            offset_of(typeobj, member)).cast(typeobj)
72
73
74class ContainerOf(gdb.Function):
75    """Return pointer to containing data structure.
76
77$container_of(PTR, "TYPE", "ELEMENT"): Given PTR, return a pointer to the
78data structure of the type TYPE in which PTR is the address of ELEMENT.
79Note that TYPE and ELEMENT have to be quoted as strings."""
80
81    def __init__(self):
82        super(ContainerOf, self).__init__("container_of")
83
84    def invoke(self, ptr, typename, elementname):
85        return container_of(ptr, gdb.lookup_type(typename.string()).pointer(),
86                            elementname.string())
87
88
89ContainerOf()
90
91
92BIG_ENDIAN = 0
93LITTLE_ENDIAN = 1
94target_endianness = None
95
96
97def get_target_endianness():
98    global target_endianness
99    if target_endianness is None:
100        endian = gdb.execute("show endian", to_string=True)
101        if "little endian" in endian:
102            target_endianness = LITTLE_ENDIAN
103        elif "big endian" in endian:
104            target_endianness = BIG_ENDIAN
105        else:
106            raise gdb.GdbError("unknown endianness '{0}'".format(str(endian)))
107    return target_endianness
108
109
110def read_memoryview(inf, start, length):
111    m = inf.read_memory(start, length)
112    if type(m) is memoryview:
113        return m
114    return memoryview(m)
115
116
117def read_u16(buffer, offset):
118    buffer_val = buffer[offset:offset + 2]
119    value = [0, 0]
120
121    if type(buffer_val[0]) is str:
122        value[0] = ord(buffer_val[0])
123        value[1] = ord(buffer_val[1])
124    else:
125        value[0] = buffer_val[0]
126        value[1] = buffer_val[1]
127
128    if get_target_endianness() == LITTLE_ENDIAN:
129        return value[0] + (value[1] << 8)
130    else:
131        return value[1] + (value[0] << 8)
132
133
134def read_u32(buffer, offset):
135    if get_target_endianness() == LITTLE_ENDIAN:
136        return read_u16(buffer, offset) + (read_u16(buffer, offset + 2) << 16)
137    else:
138        return read_u16(buffer, offset + 2) + (read_u16(buffer, offset) << 16)
139
140
141def read_u64(buffer, offset):
142    if get_target_endianness() == LITTLE_ENDIAN:
143        return read_u32(buffer, offset) + (read_u32(buffer, offset + 4) << 32)
144    else:
145        return read_u32(buffer, offset + 4) + (read_u32(buffer, offset) << 32)
146
147
148def read_ulong(buffer, offset):
149    if get_long_type().sizeof == 8:
150        return read_u64(buffer, offset)
151    else:
152        return read_u32(buffer, offset)
153
154atomic_long_counter_offset = atomic_long_type.get_type()['counter'].bitpos
155atomic_long_counter_sizeof = atomic_long_type.get_type()['counter'].type.sizeof
156
157def read_atomic_long(buffer, offset):
158    global atomic_long_counter_offset
159    global atomic_long_counter_sizeof
160
161    if atomic_long_counter_sizeof == 8:
162        return read_u64(buffer, offset + atomic_long_counter_offset)
163    else:
164        return read_u32(buffer, offset + atomic_long_counter_offset)
165
166target_arch = None
167
168
169def is_target_arch(arch):
170    if hasattr(gdb.Frame, 'architecture'):
171        return arch in gdb.newest_frame().architecture().name()
172    else:
173        global target_arch
174        if target_arch is None:
175            target_arch = gdb.execute("show architecture", to_string=True)
176        return arch in target_arch
177
178
179GDBSERVER_QEMU = 0
180GDBSERVER_KGDB = 1
181gdbserver_type = None
182
183
184def get_gdbserver_type():
185    def exit_handler(event):
186        global gdbserver_type
187        gdbserver_type = None
188        gdb.events.exited.disconnect(exit_handler)
189
190    def probe_qemu():
191        try:
192            return gdb.execute("monitor info version", to_string=True) != ""
193        except gdb.error:
194            return False
195
196    def probe_kgdb():
197        try:
198            thread_info = gdb.execute("info thread 2", to_string=True)
199            return "shadowCPU0" in thread_info
200        except gdb.error:
201            return False
202
203    global gdbserver_type
204    if gdbserver_type is None:
205        if probe_qemu():
206            gdbserver_type = GDBSERVER_QEMU
207        elif probe_kgdb():
208            gdbserver_type = GDBSERVER_KGDB
209        if gdbserver_type is not None and hasattr(gdb, 'events'):
210            gdb.events.exited.connect(exit_handler)
211    return gdbserver_type
212
213
214def gdb_eval_or_none(expresssion):
215    try:
216        return gdb.parse_and_eval(expresssion)
217    except gdb.error:
218        return None
219