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 21E88CD37AE for ; Fri, 15 Sep 2023 21:03:28 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S237740AbjIOVDB (ORCPT ); Fri, 15 Sep 2023 17:03:01 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48324 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S237859AbjIOVCr (ORCPT ); Fri, 15 Sep 2023 17:02:47 -0400 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id 8986ACF0 for ; Fri, 15 Sep 2023 14:00:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1694811640; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=Hz2Gr4W8krSahXjUxPdr3jXTt0H0e/3KkApHp87Hn88=; b=KF3UnaGIBRIgf3/lRtMwsNRVrcWsFwmHNT3Lv1owseKsj/WOv9GpeGVSTFXIek3QRbxWds sh8EX5Lqiz+bELvYeilDU+IS/tIqteNaiEQ5AqV+nrEyKuwcgj4dVxwVIbWWaYmJ844mHe ss1ezCZRQejAAWxvWgdhYq8dfvEUHDQ= Received: from mail-io1-f72.google.com (mail-io1-f72.google.com [209.85.166.72]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-281-W29VB7FdMniVs732whRm7w-1; Fri, 15 Sep 2023 17:00:38 -0400 X-MC-Unique: W29VB7FdMniVs732whRm7w-1 Received: by mail-io1-f72.google.com with SMTP id ca18e2360f4ac-7834a155749so236091539f.0 for ; Fri, 15 Sep 2023 14:00:38 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1694811637; x=1695416437; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Hz2Gr4W8krSahXjUxPdr3jXTt0H0e/3KkApHp87Hn88=; b=DszOc0R2A+3No6Z0Xtn4mn3JUF0n49Q4IEj+L+zcOa9u42C8tW+4vpAuQO2K+9JGZc RrNptqT3YQv2gm+xzV7Dx4t2cuNKwwutKk34+6kIAkLxcwUhWQzjPjmYDk8YpgW5XF1Z tL89zQVnJjATFx6KZztdRqfH6hh4yORki+Z+heCDreC9munV+1QdsVfbbkk2W45H/zQq QH7eOZYpVhh9/Nj+l3/YbBuaf7n7Y+6bQvQ+hCxfzYsjZsxO6HDQJmAhnOEH+hZ3dyql S26fd7qijSditO1OVamQ4jdxVGgGZKBl/+Ct8Gk6ZjMW1s/VAuJf6BF2Z4nzmKVq496N B6ig== X-Gm-Message-State: AOJu0Yw3papSTVF4FkbtAE0FC1hX1vH0v7PcvqbPiuHf+D8xHocM2sQl fEwthmHobq4tzCt8WKATJfbSp5KLrdzD3BnoX512/mj31NscGiqYzHtp2owG0EJrtCwVUMyfqtz bSQJOsI+vKrw8Hmxcoq1sVl// X-Received: by 2002:a05:6e02:f93:b0:34c:bc10:2573 with SMTP id v19-20020a056e020f9300b0034cbc102573mr2826210ilo.3.1694811637255; Fri, 15 Sep 2023 14:00:37 -0700 (PDT) X-Google-Smtp-Source: AGHT+IF9HCbfJQ/A+CS+mqNbZ0uTH9Ez7eEcwa2DwlwrqMSm/zQsyvnIZbEpIPB3VbM+zyq1iQfSFQ== X-Received: by 2002:a05:6e02:f93:b0:34c:bc10:2573 with SMTP id v19-20020a056e020f9300b0034cbc102573mr2826200ilo.3.1694811637006; Fri, 15 Sep 2023 14:00:37 -0700 (PDT) Received: from redhat.com ([38.15.60.12]) by smtp.gmail.com with ESMTPSA id y25-20020a02ce99000000b0042b4e2fc546sm1296952jaq.140.2023.09.15.14.00.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 15 Sep 2023 14:00:36 -0700 (PDT) Date: Fri, 15 Sep 2023 15:00:35 -0600 From: Alex Williamson To: liulongfang Cc: , , , , , , Subject: Re: [PATCH v15 2/2] Documentation: add debugfs description for vfio Message-ID: <20230915150035.0311e9be.alex.williamson@redhat.com> In-Reply-To: <20230901023606.47587-3-liulongfang@huawei.com> References: <20230901023606.47587-1-liulongfang@huawei.com> <20230901023606.47587-3-liulongfang@huawei.com> X-Mailer: Claws Mail 4.1.1 (GTK 3.24.35; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org 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. > +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, 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