From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 64BA0E7D0CF for ; Fri, 22 Sep 2023 06:31:23 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229921AbjIVGb1 (ORCPT ); Fri, 22 Sep 2023 02:31:27 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45024 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229509AbjIVGbY (ORCPT ); Fri, 22 Sep 2023 02:31:24 -0400 Received: from szxga02-in.huawei.com (szxga02-in.huawei.com [45.249.212.188]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 3494FCE; Thu, 21 Sep 2023 23:31:17 -0700 (PDT) Received: from kwepemm000005.china.huawei.com (unknown [172.30.72.55]) by szxga02-in.huawei.com (SkyGuard) with ESMTP id 4RsMlf2dQXzVl8D; Fri, 22 Sep 2023 14:28:14 +0800 (CST) Received: from [10.67.121.110] (10.67.121.110) by kwepemm000005.china.huawei.com (7.193.23.27) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.31; Fri, 22 Sep 2023 14:31:14 +0800 Subject: Re: [PATCH v15 2/2] Documentation: add debugfs description for vfio To: Alex Williamson CC: , , , , , , References: <20230901023606.47587-1-liulongfang@huawei.com> <20230901023606.47587-3-liulongfang@huawei.com> <20230915150035.0311e9be.alex.williamson@redhat.com> From: liulongfang Message-ID: <29e3517e-0322-7b2e-7232-c1af77f778c3@huawei.com> Date: Fri, 22 Sep 2023 14:31:14 +0800 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.8.0 MIME-Version: 1.0 In-Reply-To: <20230915150035.0311e9be.alex.williamson@redhat.com> Content-Type: text/plain; charset="gbk" Content-Transfer-Encoding: 7bit X-Originating-IP: [10.67.121.110] X-ClientProxiedBy: dggems703-chm.china.huawei.com (10.3.19.180) To kwepemm000005.china.huawei.com (7.193.23.27) X-CFilter-Loop: Reflected Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 2023/9/16 5:00, Alex Williamson wrote: > On Fri, 1 Sep 2023 10:36:06 +0800 > liulongfang wrote: > >> From: Longfang Liu >> >> 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 >> --- >> 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. > OK, I'll modify them all. >> +Contact: Longfang Liu >> +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, > OK, I'll modify it. Thanks, Longfang. > Alex > >> + >> +What: /sys/kernel/debug/vfio//migration >> +Date: Aug 2023 >> +KernelVersion: 6.6 >> +Contact: Longfang Liu >> +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//migration/state >> +Date: Aug 2023 >> +KernelVersion: 6.6 >> +Contact: Longfang Liu >> +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 > > . >