xref: /linux/Documentation/ABI/testing/debugfs-vfio (revision ee935e8dc757614006ac29a7d98a15882cdcaeb2)
1What:		/sys/kernel/debug/vfio
2Date:		December 2023
3KernelVersion:	6.8
4Contact:	Longfang Liu <liulongfang@huawei.com>
5Description:	This debugfs file directory is used for debugging
6		of vfio devices, it's a common directory for all vfio devices.
7		Vfio core will create a device subdirectory under this
8		directory.
9
10What:		/sys/kernel/debug/vfio/<device>/migration
11Date:		December 2023
12KernelVersion:	6.8
13Contact:	Longfang Liu <liulongfang@huawei.com>
14Description:	This debugfs file directory is used for debugging
15		of vfio devices that support live migration.
16		The debugfs of each vfio device that supports live migration
17		could be created under this directory.
18
19What:		/sys/kernel/debug/vfio/<device>/migration/state
20Date:		December 2023
21KernelVersion:	6.8
22Contact:	Longfang Liu <liulongfang@huawei.com>
23Description:	Read the live migration status of the vfio device.
24		The contents of the state file reflects the migration state
25		relative to those defined in the vfio_device_mig_state enum
26
27What:		/sys/kernel/debug/vfio/<device>/migration/features
28Date:		Oct 2025
29KernelVersion:	6.18
30Contact:	Cédric Le Goater <clg@redhat.com>
31Description:	Read the migration features of the vfio device.
32
33What:		/sys/kernel/debug/vfio/<device>/pci
34Date:		June 2026
35KernelVersion:	7.2
36Contact:	Alex Williamson <alex.williamson@nvidia.com>
37Description:	This debugfs file directory is used for debugging
38		VFIO PCI devices.
39
40What:		/sys/kernel/debug/vfio/<device>/pci/nointxmask
41Date:		June 2026
42KernelVersion:	7.2
43Contact:	Alex Williamson <alex.williamson@nvidia.com>
44Description:	Read the nointxmask policy latched for this device.  This
45		policy governs whether the device may use PCI 2.3 style
46		INTx masking when supported, reporting a value of "N", or
47		requires APIC level INTx masking, reporting a value of "Y".
48
49What:		/sys/kernel/debug/vfio/<device>/pci/disable_idle_d3
50Date:		June 2026
51KernelVersion:	7.2
52Contact:	Alex Williamson <alex.williamson@nvidia.com>
53Description:	Read the disable_idle_d3 policy latched for this device.  This
54		policy governs whether the device PM runtime usage count is
55		kept elevated while the device is bound to the driver and
56		unused, reporting a value of "Y", or decremented to allow the
57		device to enter a low power state, reporting a value of "N".
58