Documentation / ABI / testing / debugfs-amd-iommu


Based on kernel version 6.17. Page generated on 2025-10-03 10:03 EST.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131
What:		/sys/kernel/debug/iommu/amd/iommu<x>/mmio
Date:		January 2025
Contact:	Dheeraj Kumar Srivastava <dheerajkumar.srivastava@amd.com>
Description:
		This file provides read/write access for user input. Users specify the
		MMIO register offset for iommu<x>, and the file outputs the corresponding
		MMIO register value of iommu<x>

		Example::

		  $ echo "0x18" > /sys/kernel/debug/iommu/amd/iommu00/mmio
		  $ cat /sys/kernel/debug/iommu/amd/iommu00/mmio

		Output::

		  Offset:0x18 Value:0x000c22000003f48d

What:		/sys/kernel/debug/iommu/amd/iommu<x>/capability
Date:		January 2025
Contact:	Dheeraj Kumar Srivastava <dheerajkumar.srivastava@amd.com>
Description:
		This file provides read/write access for user input. Users specify the
		capability register offset for iommu<x>, and the file outputs the
		corresponding capability register value of iommu<x>.

		Example::

		  $ echo "0x10" > /sys/kernel/debug/iommu/amd/iommu00/capability
		  $ cat /sys/kernel/debug/iommu/amd/iommu00/capability

		Output::

		  Offset:0x10 Value:0x00203040

What:		/sys/kernel/debug/iommu/amd/iommu<x>/cmdbuf
Date:		January 2025
Contact:	Dheeraj Kumar Srivastava <dheerajkumar.srivastava@amd.com>
Description:
		This file is a read-only output file containing iommu<x> command
		buffer entries.

		Examples::

		  $ cat /sys/kernel/debug/iommu/amd/iommu<x>/cmdbuf

		Output::

		  CMD Buffer Head Offset:339 Tail Offset:339
		    0: 00835001 10000001 00003c00 00000000
		    1: 00000000 30000005 fffff003 7fffffff
		    2: 00835001 10000001 00003c01 00000000
		    3: 00000000 30000005 fffff003 7fffffff
		    4: 00835001 10000001 00003c02 00000000
		    5: 00000000 30000005 fffff003 7fffffff
		    6: 00835001 10000001 00003c03 00000000
		    7: 00000000 30000005 fffff003 7fffffff
		    8: 00835001 10000001 00003c04 00000000
		    9: 00000000 30000005 fffff003 7fffffff
		   10: 00835001 10000001 00003c05 00000000
		   11: 00000000 30000005 fffff003 7fffffff
		  [...]

What:		/sys/kernel/debug/iommu/amd/devid
Date:		January 2025
Contact:	Dheeraj Kumar Srivastava <dheerajkumar.srivastava@amd.com>
Description:
		This file provides read/write access for user input. Users specify the
		device ID, which can be used to dump IOMMU data structures such as the
		interrupt remapping table and device table.

		Example:

		1.
		  ::

		    $ echo 0000:01:00.0 > /sys/kernel/debug/iommu/amd/devid
		    $ cat /sys/kernel/debug/iommu/amd/devid

		  Output::

		    0000:01:00.0

		2.
		  ::

		    $ echo 01:00.0 > /sys/kernel/debug/iommu/amd/devid
		    $ cat /sys/kernel/debug/iommu/amd/devid

		  Output::

		    0000:01:00.0

What:		/sys/kernel/debug/iommu/amd/devtbl
Date:		January 2025
Contact:	Dheeraj Kumar Srivastava <dheerajkumar.srivastava@amd.com>
Description:
		This file is a read-only output file containing the device table entry
		for the device ID provided in /sys/kernel/debug/iommu/amd/devid.

		Example::

		  $ cat /sys/kernel/debug/iommu/amd/devtbl

		Output::

		  DeviceId             QWORD[3]         QWORD[2]         QWORD[1]         QWORD[0] iommu
		  0000:01:00.0 0000000000000000 20000001373b8013 0000000000000038 6000000114d7b603 iommu3

What:		/sys/kernel/debug/iommu/amd/irqtbl
Date:		January 2025
Contact:	Dheeraj Kumar Srivastava <dheerajkumar.srivastava@amd.com>
Description:
		This file is a read-only output file containing valid IRT table entries
		for the device ID provided in /sys/kernel/debug/iommu/amd/devid.

		Example::

		  $ cat /sys/kernel/debug/iommu/amd/irqtbl

		Output::

		  DeviceId 0000:01:00.0
		  IRT[0000] 0000000000000020 0000000000000241
		  IRT[0001] 0000000000000020 0000000000000841
		  IRT[0002] 0000000000000020 0000000000002041
		  IRT[0003] 0000000000000020 0000000000008041
		  IRT[0004] 0000000000000020 0000000000020041
		  IRT[0005] 0000000000000020 0000000000080041
		  IRT[0006] 0000000000000020 0000000000200041
		  IRT[0007] 0000000000000020 0000000000800041
		  [...]