[RFC PATCH v2 0/5] Add debugfs support for ARM SMMUv3
Qinxin Xia
xiaqinxin at huawei.com
Sat Mar 28 03:14:33 PDT 2026
Sorry!patch 2 cannot convert from y to UTF-8,I will release a new
version soon; please ignore this one.
On 2026/3/28 18:09:48, Qinxin Xia <xiaqinxin at huawei.com> wrote:
> Add a comprehensive debugfs framework to the ARM SMMUv3 driver,
> providing visibility into internal hardware state for debugging
> and performance analysis. The debugfs entries are organized under
> /sys/kernel/debug/iommu/arm_smmu_v3/, with per-SMMU instance directories
> and per-device stream table entries.
>
> Each SMMU instance provides:
> - capabilities – static SMMU features and queue sizes.
> - registers – SMMU key registers.
> - stream_table/ – a directory per device with subdirectories per Stream ID.
>
> Each Stream ID subdirectory contains:
> - ste – the Stream Table Entry in decoded and raw format.
> - cd – all valid Context Descriptors (Stage 1 translation tables) associated with the device.
> - a symlink named with the device’s BDF/name pointing to its sysfs directory for easy navigation.
>
> /sys/kernel/debug/iommu/arm_smmu_v3/smmu0/stream_table/
> └── <sid>/
> ├─── ste
> ├─── cd
> └─── <dev_name>
>
> Changes since V1:
> Address the comments from Nicolin:
> 1.Fixed the incorrect comments and replaced 'kzalloc' with 'kzalloc_obj'
> 2.'stream_table_create/stream_table_remove' is called in probe_device/release_device
> 3.Reused some functions in the driver
>
> Address the comments from Robin:
> 1.Remove unnecessary CR0*EN extra strings
> 2.Remove the limit on ssid
>
> Address the comments from Robin and Nicolin:
> 1.The directory structure has been changed
> 2.Added lock protection for the ste_show and cd_show
>
> Others:
> 1.'arm_smmu_debugfs_remove' is added to remove the corresponding debugfs when SMMU device is removed
> 2.'arm_smmu_debugfs_remove_stream_table' is added to remove the corresponding stream_dir when device is removed
> 3.Use scoped_guard for locks that include return
> 4.Added 'open' and 'release' operations to prevent the device from being released during dump
> 5.Merged 'stream_table_create' and 'ste_show' into one patch
> 6.Some other clean code
>
> - Link: https://lore.kernel.org/all/20260313104351.3502293-1-xiaqinxin@huawei.com/
>
> Qinxin Xia (5):
> iommu/arm-smmu-v3: Add basic debugfs framework
> iommu/arm-smmu-v3: Add register display to debugfs
> iommu/arm-smmu-v3: Add Stream Table Entry display to debugfs
> iommu/arm-smmu-v3: Add device symlink in stream table debugfs
> iommu/arm-smmu-v3: Add Context Descriptor display to debugfs
>
> drivers/iommu/Kconfig | 11 +
> drivers/iommu/arm/arm-smmu-v3/Makefile | 1 +
> .../arm/arm-smmu-v3/arm-smmu-v3-debugfs.c | 571 ++++++++++++++++++
> drivers/iommu/arm/arm-smmu-v3/arm-smmu-v3.c | 33 +-
> drivers/iommu/arm/arm-smmu-v3/arm-smmu-v3.h | 32 +
> 5 files changed, 646 insertions(+), 2 deletions(-)
> create mode 100644 drivers/iommu/arm/arm-smmu-v3/arm-smmu-v3-debugfs.c
>
--
Thanks,
Qinxin
More information about the linux-arm-kernel
mailing list