From nobody Thu Sep 11 19:33:48 2025 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 CE755C05027 for ; Fri, 17 Feb 2023 08:51:24 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229952AbjBQIvX (ORCPT ); Fri, 17 Feb 2023 03:51:23 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53854 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229936AbjBQIvN (ORCPT ); Fri, 17 Feb 2023 03:51:13 -0500 Received: from szxga08-in.huawei.com (szxga08-in.huawei.com [45.249.212.255]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 221195FBF6 for ; Fri, 17 Feb 2023 00:50:48 -0800 (PST) Received: from kwepemm600005.china.huawei.com (unknown [172.30.72.57]) by szxga08-in.huawei.com (SkyGuard) with ESMTP id 4PJ57W3zYMz16NlJ; Fri, 17 Feb 2023 16:48:23 +0800 (CST) Received: from huawei.com (10.50.163.32) by kwepemm600005.china.huawei.com (7.193.23.191) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.17; Fri, 17 Feb 2023 16:50:46 +0800 From: Longfang Liu To: , , , CC: , , , Subject: [PATCH v8 4/5] Documentation: add debugfs description for vfio Date: Fri, 17 Feb 2023 16:48:30 +0800 Message-ID: <20230217084831.35783-5-liulongfang@huawei.com> X-Mailer: git-send-email 2.24.0 In-Reply-To: <20230217084831.35783-1-liulongfang@huawei.com> References: <20230217084831.35783-1-liulongfang@huawei.com> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Originating-IP: [10.50.163.32] X-ClientProxiedBy: dggems702-chm.china.huawei.com (10.3.19.179) To kwepemm600005.china.huawei.com (7.193.23.191) X-CFilter-Loop: Reflected Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Add two debugfs document description file to help users understand how to use the accelerator live migration driver's debugfs. Signed-off-by: Longfang Liu --- .../ABI/testing/debugfs-hisi-migration | 28 +++++++++++++++++++ Documentation/ABI/testing/debugfs-vfio | 17 +++++++++++ 2 files changed, 45 insertions(+) create mode 100644 Documentation/ABI/testing/debugfs-hisi-migration create mode 100644 Documentation/ABI/testing/debugfs-vfio diff --git a/Documentation/ABI/testing/debugfs-hisi-migration b/Documentati= on/ABI/testing/debugfs-hisi-migration new file mode 100644 index 000000000000..0f45f30ff6d4 --- /dev/null +++ b/Documentation/ABI/testing/debugfs-hisi-migration @@ -0,0 +1,28 @@ +What: /sys/kernel/debug/vfio//migration_data +Date: Feb 2023 +KernelVersion: 6.2 +Contact: linux-kernel@vger.kernel.org +Description: Read the live migration data of the vfio device. + The output format of the data is defined by the live + migration driver. + +What: /sys/kernel/debug/vfio//migration_attr +Date: Feb 2023 +KernelVersion: 6.2 +Contact: linux-kernel@vger.kernel.org +Description: Read the live migration attributes of the vfio device. + The output format of the attributes is defined by the live + migration driver. + +What: /sys/kernel/debug/vfio//migration_debug +Date: Feb 2023 +KernelVersion: 6.2 +Contact: linux-kernel@vger.kernel.org +Description: This debug file supports "echo" command write operations. + The command is actually represented by an integer number, and the + specific meaning is defined by the corresponding device driver. + For example, three commands are defined in the HiSilicon accelerator + live migration driver: + 0: State save + 1: State resume + 2: IO test diff --git a/Documentation/ABI/testing/debugfs-vfio b/Documentation/ABI/tes= ting/debugfs-vfio new file mode 100644 index 000000000000..e22531d16674 --- /dev/null +++ b/Documentation/ABI/testing/debugfs-vfio @@ -0,0 +1,17 @@ +What: /sys/kernel/debug/vfio +Date: Feb 2023 +KernelVersion: 6.2 +Contact: linux-kernel@vger.kernel.org +Description: This debugfs file directory is used for debugging + of vfio devices that support live migration. + Each device that supports live migration can create a device + subdirectory under this directory by referencing the public + registration interface. + +What: /sys/kernel/debug/vfio//migration_state +Date: Feb 2023 +KernelVersion: 6.2 +Contact: linux-kernel@vger.kernel.org +Description: Read the live migration status of the vfio device. + The status of these live migrations includes: + ERROR, RUNNING, STOP, STOP_COPY, RESUMING. --=20 2.24.0