Add a debugfs document description file to help users understand how to use the hisilicon accelerator live migration driver's debugfs. Update the file paths that need to be maintained in MAINTAINERS Signed-off-by: Longfang Liu <liulongfang@xxxxxxxxxx> --- .../ABI/testing/debugfs-hisi-migration | 34 +++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 35 insertions(+) create mode 100644 Documentation/ABI/testing/debugfs-hisi-migration diff --git a/Documentation/ABI/testing/debugfs-hisi-migration b/Documentation/ABI/testing/debugfs-hisi-migration new file mode 100644 index 000000000000..d61255c3bcd9 --- /dev/null +++ b/Documentation/ABI/testing/debugfs-hisi-migration @@ -0,0 +1,34 @@ +What: /sys/kernel/debug/vfio/<device>/migration/hisi_acc/data +Date: JAN 2024 +KernelVersion: 6.8 +Contact: Longfang Liu <liulongfang@xxxxxxxxxx> +Description: Read the live migration data of the vfio device. + These data include device status data, queue configuration + data and some task configuration data. + The output format of the data is defined by the live + migration driver. + +What: /sys/kernel/debug/vfio/<device>/migration/hisi_acc/attr +Date: JAN 2024 +KernelVersion: 6.8 +Contact: Longfang Liu <liulongfang@xxxxxxxxxx> +Description: Read the live migration attributes of the vfio device. + it include device status attributes and data length attributes + The output format of the attributes is defined by the live + migration driver. + +What: /sys/kernel/debug/vfio/<device>/migration/hisi_acc/cmd_state +Date: JAN 2024 +KernelVersion: 6.8 +Contact: Longfang Liu <liulongfang@xxxxxxxxxx> +Description: Used to obtain the device command sending and receiving + channel status. If successful, returns the command value. + If failed, return error log. + +What: /sys/kernel/debug/vfio/<device>/migration/hisi_acc/save +Date: JAN 2024 +KernelVersion: 6.8 +Contact: Longfang Liu <liulongfang@xxxxxxxxxx> +Description: Trigger the Hisilicon accelerator device to perform + the state saving operation of live migration through the read + operation, and output the operation log results. diff --git a/MAINTAINERS b/MAINTAINERS index 20f8e9872deb..115d43d307e8 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -22856,6 +22856,7 @@ M: Longfang Liu <liulongfang@xxxxxxxxxx> M: Shameer Kolothum <shameerali.kolothum.thodi@xxxxxxxxxx> L: kvm@xxxxxxxxxxxxxxx S: Maintained +F: Documentation/ABI/testing/debugfs-hisi-migration F: drivers/vfio/pci/hisilicon/ VFIO MEDIATED DEVICE DRIVERS -- 2.24.0
