1 # SPDX-License-Identifier: GPL-2.0
3 # Copyright (c) NXP 2019
7 from linux.utils import CachedType
8 from linux.utils import container_of
9 from linux.lists import list_for_each_entry
12 device_private_type = CachedType('struct device_private')
13 device_type = CachedType('struct device')
15 subsys_private_type = CachedType('struct subsys_private')
16 kobject_type = CachedType('struct kobject')
17 kset_type = CachedType('struct kset')
19 bus_type = CachedType('struct bus_type')
20 class_type = CachedType('struct class')
24 dev_init_name = dev['init_name']
26 return dev_init_name.string()
27 return dev['kobj']['name'].string()
30 def kset_for_each_object(kset):
31 return list_for_each_entry(kset['list'],
32 kobject_type.get_type().pointer(), "entry")
36 for kobj in kset_for_each_object(gdb.parse_and_eval('bus_kset')):
37 subsys = container_of(kobj, kset_type.get_type().pointer(), 'kobj')
38 subsys_priv = container_of(subsys, subsys_private_type.get_type().pointer(), 'subsys')
39 yield subsys_priv['bus']
43 for kobj in kset_for_each_object(gdb.parse_and_eval('class_kset')):
44 subsys = container_of(kobj, kset_type.get_type().pointer(), 'kobj')
45 subsys_priv = container_of(subsys, subsys_private_type.get_type().pointer(), 'subsys')
46 yield subsys_priv['class']
49 def get_bus_by_name(name):
50 for item in for_each_bus():
51 if item['name'].string() == name:
53 raise gdb.GdbError("Can't find bus type {!r}".format(name))
56 def get_class_by_name(name):
57 for item in for_each_class():
58 if item['name'].string() == name:
60 raise gdb.GdbError("Can't find device class {!r}".format(name))
63 klist_type = CachedType('struct klist')
64 klist_node_type = CachedType('struct klist_node')
67 def klist_for_each(klist):
68 return list_for_each_entry(klist['k_list'],
69 klist_node_type.get_type().pointer(), 'n_node')
72 def bus_for_each_device(bus):
73 for kn in klist_for_each(bus['p']['klist_devices']):
74 dp = container_of(kn, device_private_type.get_type().pointer(), 'knode_bus')
78 def class_for_each_device(cls):
79 for kn in klist_for_each(cls['p']['klist_devices']):
80 dp = container_of(kn, device_private_type.get_type().pointer(), 'knode_class')
84 def device_for_each_child(dev):
85 for kn in klist_for_each(dev['p']['klist_children']):
86 dp = container_of(kn, device_private_type.get_type().pointer(), 'knode_parent')
90 def _show_device(dev, level=0, recursive=False):
91 gdb.write('{}dev {}:\t{}\n'.format('\t' * level, dev_name(dev), dev))
93 for child in device_for_each_child(dev):
94 _show_device(child, level + 1, recursive)
97 class LxDeviceListBus(gdb.Command):
98 '''Print devices on a bus (or all buses if not specified)'''
101 super(LxDeviceListBus, self).__init__('lx-device-list-bus', gdb.COMMAND_DATA)
103 def invoke(self, arg, from_tty):
105 for bus in for_each_bus():
106 gdb.write('bus {}:\t{}\n'.format(bus['name'].string(), bus))
107 for dev in bus_for_each_device(bus):
108 _show_device(dev, level=1)
110 bus = get_bus_by_name(arg)
112 raise gdb.GdbError("Can't find bus {!r}".format(arg))
113 for dev in bus_for_each_device(bus):
117 class LxDeviceListClass(gdb.Command):
118 '''Print devices in a class (or all classes if not specified)'''
121 super(LxDeviceListClass, self).__init__('lx-device-list-class', gdb.COMMAND_DATA)
123 def invoke(self, arg, from_tty):
125 for cls in for_each_class():
126 gdb.write("class {}:\t{}\n".format(cls['name'].string(), cls))
127 for dev in class_for_each_device(cls):
128 _show_device(dev, level=1)
130 cls = get_class_by_name(arg)
131 for dev in class_for_each_device(cls):
135 class LxDeviceListTree(gdb.Command):
136 '''Print a device and its children recursively'''
139 super(LxDeviceListTree, self).__init__('lx-device-list-tree', gdb.COMMAND_DATA)
141 def invoke(self, arg, from_tty):
143 raise gdb.GdbError('Please provide pointer to struct device')
144 dev = gdb.parse_and_eval(arg)
145 if dev.type != device_type.get_type().pointer():
146 raise gdb.GdbError('Please provide pointer to struct device')
147 _show_device(dev, level=0, recursive=True)
150 class LxDeviceFindByBusName(gdb.Function):
151 '''Find struct device by bus and name (both strings)'''
154 super(LxDeviceFindByBusName, self).__init__('lx_device_find_by_bus_name')
156 def invoke(self, bus, name):
158 bus = get_bus_by_name(bus.string())
159 for dev in bus_for_each_device(bus):
160 if dev_name(dev) == name:
164 class LxDeviceFindByClassName(gdb.Function):
165 '''Find struct device by class and name (both strings)'''
168 super(LxDeviceFindByClassName, self).__init__('lx_device_find_by_class_name')
170 def invoke(self, cls, name):
172 cls = get_class_by_name(cls.string())
173 for dev in class_for_each_device(cls):
174 if dev_name(dev) == name:
181 LxDeviceFindByBusName()
182 LxDeviceFindByClassName()