SWAMPy

✎ CARVE FLESH

EDITING: device.py

# SPDX-License-Identifier: GPL-2.0
#
# Copyright (c) NXP 2019

import gdb

from linux.utils import CachedType
from linux.utils import container_of
from linux.lists import list_for_each_entry

device_private_type = CachedType('struct device_private')
device_type = CachedType('struct device')

subsys_private_type = CachedType('struct subsys_private')
kobject_type = CachedType('struct kobject')
kset_type = CachedType('struct kset')

bus_type = CachedType('struct bus_type')
class_type = CachedType('struct class')

def dev_name(dev):
    dev_init_name = dev['init_name']
    if dev_init_name:
        return dev_init_name.string()
    return dev['kobj']['name'].string()

def kset_for_each_object(kset):
    return list_for_each_entry(kset['list'],
            kobject_type.get_type().pointer(), "entry")

def for_each_bus():
    for kobj in kset_for_each_object(gdb.parse_and_eval('bus_kset')):
        subsys = container_of(kobj, kset_type.get_type().pointer(), 'kobj')
        subsys_priv = container_of(subsys, subsys_private_type.get_type().pointer(), 'subsys')
        yield subsys_priv

def for_each_class():
    for kobj in kset_for_each_object(gdb.parse_and_eval('class_kset')):
        subsys = container_of(kobj, kset_type.get_type().pointer(), 'kobj')
        subsys_priv = container_of(subsys, subsys_private_type.get_type().pointer(), 'subsys')
        yield subsys_priv

def get_bus_by_name(name):
    for item in for_each_bus():
        if item['bus']['name'].string() == name:
            return item
    raise gdb.GdbError("Can't find bus type {!r}".format(name))

def get_class_by_name(name):
    for item in for_each_class():
        if item['class']['name'].string() == name:
            return item
    raise gdb.GdbError("Can't find device class {!r}".format(name))

klist_type = CachedType('struct klist')
klist_node_type = CachedType('struct klist_node')

def klist_for_each(klist):
    return list_for_each_entry(klist['k_list'],
                klist_node_type.get_type().pointer(), 'n_node')

def bus_for_each_device(bus):
    for kn in klist_for_each(bus['klist_devices']):
        dp = container_of(kn, device_private_type.get_type().pointer(), 'knode_bus')
        yield dp['device']

def class_for_each_device(cls):
    for kn in klist_for_each(cls['klist_devices']):
        dp = container_of(kn, device_private_type.get_type().pointer(), 'knode_class')
        yield dp['device']

def device_for_each_child(dev):
    for kn in klist_for_each(dev['p']['klist_children']):
        dp = container_of(kn, device_private_type.get_type().pointer(), 'knode_parent')
        yield dp['device']

def _show_device(dev, level=0, recursive=False):
    gdb.write('{}dev {}:\t{}\n'.format('\t' * level, dev_name(dev), dev))
    if recursive:
        for child in device_for_each_child(dev):
            _show_device(child, level + 1, recursive)

class LxDeviceListBus(gdb.Command):
    '''Print devices on a bus (or all buses if not specified)'''

def __init__(self):
        super(LxDeviceListBus, self).__init__('lx-device-list-bus', gdb.COMMAND_DATA)

def invoke(self, arg, from_tty):
        if not arg:
            for bus in for_each_bus():
                gdb.write('bus {}:\t{}\n'.format(bus['bus']['name'].string(), bus))
                for dev in bus_for_each_device(bus):
                    _show_device(dev, level=1)
        else:
            bus = get_bus_by_name(arg)
            if not bus:
                raise gdb.GdbError("Can't find bus {!r}".format(arg))
            for dev in bus_for_each_device(bus):
                _show_device(dev)

class LxDeviceListClass(gdb.Command):
    '''Print devices in a class (or all classes if not specified)'''

def __init__(self):
        super(LxDeviceListClass, self).__init__('lx-device-list-class', gdb.COMMAND_DATA)

def invoke(self, arg, from_tty):
        if not arg:
            for cls in for_each_class():
                gdb.write("class {}:\t{}\n".format(cls['class']['name'].string(), cls))
                for dev in class_for_each_device(cls):
                    _show_device(dev, level=1)
        else:
            cls = get_class_by_name(arg)
            for dev in class_for_each_device(cls):
                _show_device(dev)

class LxDeviceListTree(gdb.Command):
    '''Print a device and its children recursively'''

def __init__(self):
        super(LxDeviceListTree, self).__init__('lx-device-list-tree', gdb.COMMAND_DATA)

def invoke(self, arg, from_tty):
        if not arg:
            raise gdb.GdbError('Please provide pointer to struct device')
        dev = gdb.parse_and_eval(arg)
        if dev.type != device_type.get_type().pointer():
            raise gdb.GdbError('Please provide pointer to struct device')
        _show_device(dev, level=0, recursive=True)

class LxDeviceFindByBusName(gdb.Function):
    '''Find struct device by bus and name (both strings)'''

def __init__(self):
        super(LxDeviceFindByBusName, self).__init__('lx_device_find_by_bus_name')

def invoke(self, bus, name):
        name = name.string()
        bus = get_bus_by_name(bus.string())
        for dev in bus_for_each_device(bus):
            if dev_name(dev) == name:
                return dev

class LxDeviceFindByClassName(gdb.Function):
    '''Find struct device by class and name (both strings)'''

def __init__(self):
        super(LxDeviceFindByClassName, self).__init__('lx_device_find_by_class_name')

def invoke(self, cls, name):
        name = name.string()
        cls = get_class_by_name(cls.string())
        for dev in class_for_each_device(cls):
            if dev_name(dev) == name:
                return dev

LxDeviceListBus()
LxDeviceListClass()
LxDeviceListTree()
LxDeviceFindByBusName()
LxDeviceFindByClassName()

CANCEL

Name	Type	Size	Modified	Actions
↩ ..	DIR	—	—
📄 .gitignore	GITIGNORE	65 B	2024-03-10 20:38	EDIT
📄 __init__.py	PY	55 B	2024-03-10 20:38	EDIT
📄 clk.py	PY	2.6 KB	2024-03-10 20:38	EDIT
📄 config.py	PY	1.3 KB	2024-03-10 20:38	EDIT
📄 constants.py.in	IN	4.1 KB	2024-03-10 20:38	EDIT
📄 cpus.py	PY	6.3 KB	2025-11-21 22:00	EDIT
📄 device.py	PY	5.7 KB	2024-03-10 20:38	EDIT
📄 dmesg.py	PY	5.7 KB	2024-03-10 20:38	EDIT
📄 genpd.py	PY	2.7 KB	2024-03-10 20:38	EDIT
📄 interrupts.py	PY	7.6 KB	2024-03-10 20:38	EDIT
📄 lists.py	PY	4.2 KB	2024-03-10 20:38	EDIT
📄 Makefile	?	667 B	2024-03-10 20:38	EDIT
📄 mm.py	PY	13.8 KB	2024-03-10 20:38	EDIT
📄 modules.py	PY	3.8 KB	2024-03-10 20:38	EDIT
📄 page_owner.py	PY	6.8 KB	2024-03-10 20:38	EDIT
📄 pgtable.py	PY	10.1 KB	2024-03-10 20:38	EDIT
📄 proc.py	PY	8.6 KB	2025-11-21 22:00	EDIT
📄 radixtree.py	PY	2.5 KB	2024-03-10 20:38	EDIT
📄 rbtree.py	PY	4.6 KB	2025-11-21 22:00	EDIT
📄 slab.py	PY	11.3 KB	2024-03-10 20:38	EDIT
📄 stackdepot.py	PY	1.7 KB	2024-03-10 20:38	EDIT
📄 symbols.py	PY	7.1 KB	2024-03-10 20:38	EDIT
📄 tasks.py	PY	3.2 KB	2024-03-10 20:38	EDIT
📄 timerlist.py	PY	7.6 KB	2024-03-10 20:38	EDIT
📄 utils.py	PY	5.9 KB	2024-03-10 20:38	EDIT
📄 vfs.py	PY	1.4 KB	2024-03-10 20:38	EDIT
📄 vmalloc.py	PY	2.1 KB	2024-03-10 20:38	EDIT