xref: /linux/Documentation/ABI/testing/debugfs-vfio (revision 826eec5b5efd785dc87638a54d5ecc9f88e5afce)
17b994177SLongfang LiuWhat:		/sys/kernel/debug/vfio
27b994177SLongfang LiuDate:		December 2023
37b994177SLongfang LiuKernelVersion:	6.8
47b994177SLongfang LiuContact:	Longfang Liu <liulongfang@huawei.com>
57b994177SLongfang LiuDescription:	This debugfs file directory is used for debugging
67b994177SLongfang Liu		of vfio devices, it's a common directory for all vfio devices.
77b994177SLongfang Liu		Vfio core will create a device subdirectory under this
87b994177SLongfang Liu		directory.
97b994177SLongfang Liu
107b994177SLongfang LiuWhat:		/sys/kernel/debug/vfio/<device>/migration
117b994177SLongfang LiuDate:		December 2023
127b994177SLongfang LiuKernelVersion:	6.8
137b994177SLongfang LiuContact:	Longfang Liu <liulongfang@huawei.com>
147b994177SLongfang LiuDescription:	This debugfs file directory is used for debugging
157b994177SLongfang Liu		of vfio devices that support live migration.
167b994177SLongfang Liu		The debugfs of each vfio device that supports live migration
177b994177SLongfang Liu		could be created under this directory.
187b994177SLongfang Liu
197b994177SLongfang LiuWhat:		/sys/kernel/debug/vfio/<device>/migration/state
207b994177SLongfang LiuDate:		December 2023
217b994177SLongfang LiuKernelVersion:	6.8
227b994177SLongfang LiuContact:	Longfang Liu <liulongfang@huawei.com>
237b994177SLongfang LiuDescription:	Read the live migration status of the vfio device.
247b994177SLongfang Liu		The contents of the state file reflects the migration state
257b994177SLongfang Liu		relative to those defined in the vfio_device_mig_state enum
26451bb963SCédric Le Goater
27451bb963SCédric Le GoaterWhat:		/sys/kernel/debug/vfio/<device>/migration/features
28451bb963SCédric Le GoaterDate:		Oct 2025
29451bb963SCédric Le GoaterKernelVersion:	6.18
30451bb963SCédric Le GoaterContact:	Cédric Le Goater <clg@redhat.com>
31451bb963SCédric Le GoaterDescription:	Read the migration features of the vfio device.
32*586a989dSAlex Williamson
33*586a989dSAlex WilliamsonWhat:		/sys/kernel/debug/vfio/<device>/pci
34*586a989dSAlex WilliamsonDate:		June 2026
35*586a989dSAlex WilliamsonKernelVersion:	7.2
36*586a989dSAlex WilliamsonContact:	Alex Williamson <alex.williamson@nvidia.com>
37*586a989dSAlex WilliamsonDescription:	This debugfs file directory is used for debugging
38*586a989dSAlex Williamson		VFIO PCI devices.
39*586a989dSAlex Williamson
40*586a989dSAlex WilliamsonWhat:		/sys/kernel/debug/vfio/<device>/pci/nointxmask
41*586a989dSAlex WilliamsonDate:		June 2026
42*586a989dSAlex WilliamsonKernelVersion:	7.2
43*586a989dSAlex WilliamsonContact:	Alex Williamson <alex.williamson@nvidia.com>
44*586a989dSAlex WilliamsonDescription:	Read the nointxmask policy latched for this device.  This
45*586a989dSAlex Williamson		policy governs whether the device may use PCI 2.3 style
46*586a989dSAlex Williamson		INTx masking when supported, reporting a value of "N", or
47*586a989dSAlex Williamson		requires APIC level INTx masking, reporting a value of "Y".
48*586a989dSAlex Williamson
49*586a989dSAlex WilliamsonWhat:		/sys/kernel/debug/vfio/<device>/pci/disable_idle_d3
50*586a989dSAlex WilliamsonDate:		June 2026
51*586a989dSAlex WilliamsonKernelVersion:	7.2
52*586a989dSAlex WilliamsonContact:	Alex Williamson <alex.williamson@nvidia.com>
53*586a989dSAlex WilliamsonDescription:	Read the disable_idle_d3 policy latched for this device.  This
54*586a989dSAlex Williamson		policy governs whether the device PM runtime usage count is
55*586a989dSAlex Williamson		kept elevated while the device is bound to the driver and
56*586a989dSAlex Williamson		unused, reporting a value of "Y", or decremented to allow the
57*586a989dSAlex Williamson		device to enter a low power state, reporting a value of "N".
58