Messages in this thread | | | Date | Fri, 15 Sep 2023 15:00:35 -0600 | From | Alex Williamson <> | Subject | Re: [PATCH v15 2/2] Documentation: add debugfs description for vfio |
| |
On Fri, 1 Sep 2023 10:36:06 +0800 liulongfang <liulongfang@huawei.com> wrote:
> From: Longfang Liu <liulongfang@huawei.com> > > 1.Add an debugfs document description file to help users understand > how to use the accelerator live migration driver's debugfs. > 2.Update the file paths that need to be maintained in MAINTAINERS > > Signed-off-by: Longfang Liu <liulongfang@huawei.com> > --- > Documentation/ABI/testing/debugfs-vfio | 25 +++++++++++++++++++++++++ > MAINTAINERS | 1 + > 2 files changed, 26 insertions(+) > create mode 100644 Documentation/ABI/testing/debugfs-vfio > > diff --git a/Documentation/ABI/testing/debugfs-vfio b/Documentation/ABI/testing/debugfs-vfio > new file mode 100644 > index 000000000000..086a8c52df35 > --- /dev/null > +++ b/Documentation/ABI/testing/debugfs-vfio > @@ -0,0 +1,25 @@ > +What: /sys/kernel/debug/vfio > +Date: Aug 2023 > +KernelVersion: 6.6
This is all 6.7 material now and we might be conservative and mark it for Oct 2023.
> +Contact: Longfang Liu <liulongfang@huawei.com> > +Description: This debugfs file directory is used for debugging > + of vfio devices, it's a common directory for all vfio devices. > + Each device should create a device subdirectory under this > + directory by referencing the public registration interface.
The device sub-directory is already provided by the core. Thanks,
Alex
> + > +What: /sys/kernel/debug/vfio/<device>/migration > +Date: Aug 2023 > +KernelVersion: 6.6 > +Contact: Longfang Liu <liulongfang@huawei.com> > +Description: This debugfs file directory is used for debugging > + of vfio devices that support live migration. > + The debugfs of each vfio device that supports live migration > + could be created under this directory. > + > +What: /sys/kernel/debug/vfio/<device>/migration/state > +Date: Aug 2023 > +KernelVersion: 6.6 > +Contact: Longfang Liu <liulongfang@huawei.com> > +Description: Read the live migration status of the vfio device. > + The status of these live migrations includes: > + ERROR, RUNNING, STOP, STOP_COPY, RESUMING. > diff --git a/MAINTAINERS b/MAINTAINERS > index 7b1306615fc0..bd01ca674c60 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -22304,6 +22304,7 @@ L: kvm@vger.kernel.org > S: Maintained > T: git https://github.com/awilliam/linux-vfio.git > F: Documentation/ABI/testing/sysfs-devices-vfio-dev > +F: Documentation/ABI/testing/debugfs-vfio > F: Documentation/driver-api/vfio.rst > F: drivers/vfio/ > F: include/linux/vfio.h
| |