From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S940846AbdEZNcO (ORCPT ); Fri, 26 May 2017 09:32:14 -0400 Received: from smtp.ctxuk.citrix.com ([185.25.65.24]:36436 "EHLO SMTP.EU.CITRIX.COM" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1763266AbdEZNcN (ORCPT ); Fri, 26 May 2017 09:32:13 -0400 X-IronPort-AV: E=Sophos;i="5.38,397,1491264000"; d="scan'208";a="46790127" Subject: Re: [Xen-devel] [PATCH v2 1/2] doc, xen: document hypervisor sysfs nodes for xen To: Juergen Gross , , References: <20170526125657.24505-1-jgross@suse.com> <20170526125657.24505-2-jgross@suse.com> CC: , From: Andrew Cooper Message-ID: Date: Fri, 26 May 2017 14:32:10 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0 MIME-Version: 1.0 In-Reply-To: <20170526125657.24505-2-jgross@suse.com> Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit X-ClientProxiedBy: AMSPEX02CAS01.citrite.net (10.69.22.112) To AMSPEX02CL02.citrite.net (10.69.22.126) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 26/05/17 13:56, Juergen Gross wrote: > Today only a few sysfs nodes under /sys/hypervisor/ are documented > for Xen in Documentation/ABI/testing/sysfs-hypervisor-pmu. > > Add the remaining Xen sysfs nodes under /sys/hypervisor/ in a new > file Documentation/ABI/stable/sysfs-hypervisor-xen and add the Xen > specific sysfs docs to the MAINTAINERS file. > > Signed-off-by: Juergen Gross > --- > V2: > - rename file to Documentation/ABI/stable/sysfs-hypervisor-xen in > order to reflect Xen dependency > - leave pmu entries in old file under testing (Boris Ostrovsky) > --- > Documentation/ABI/stable/sysfs-hypervisor-xen | 107 ++++++++++++++++++++++++++ > MAINTAINERS | 2 + > 2 files changed, 109 insertions(+) > create mode 100644 Documentation/ABI/stable/sysfs-hypervisor-xen > > diff --git a/Documentation/ABI/stable/sysfs-hypervisor-xen b/Documentation/ABI/stable/sysfs-hypervisor-xen > new file mode 100644 > index 000000000000..97e4171508c4 > --- /dev/null > +++ b/Documentation/ABI/stable/sysfs-hypervisor-xen > @@ -0,0 +1,107 @@ > +What: /sys/hypervisor/compilation/compile_date > +Date: March 2009 > +KernelVersion: 2.6.30 > +Contact: xen-devel@lists.xenproject.org > +Description: If running under Xen: > + Contains the build time stamp of the Xen hypervisor > + > +What: /sys/hypervisor/compilation/compiled_by > +Date: March 2009 > +KernelVersion: 2.6.30 > +Contact: xen-devel@lists.xenproject.org > +Description: If running under Xen: > + Contains information who built the Xen hypervisor > + > +What: /sys/hypervisor/compilation/compiler > +Date: March 2009 > +KernelVersion: 2.6.30 > +Contact: xen-devel@lists.xenproject.org > +Description: If running under Xen: > + Compiler which was used to build the Xen hypervisor > + > +What: /sys/hypervisor/properties/capabilities > +Date: March 2009 > +KernelVersion: 2.6.30 > +Contact: xen-devel@lists.xenproject.org > +Description: If running under Xen: > + Space separated list of supported guest system types. Each type > + is in the format: -.- > + With: > + : "xen" -- x86: paravirtualized, arm: standard > + "hvm" -- x86 only: full virtualized > + : major guest interface version > + : minor guest interface version > + : architecture, e.g.: > + "x86_32": 32 bit x86 guest without PAE > + "x86_32p": 32 bit x86 guest with PAE > + "x86_64": 64 bit x86 guest > + "armv7l": 32 bit arm guest > + "aarch64": 64 bit arm guest > + > +What: /sys/hypervisor/properties/changeset > +Date: March 2009 > +KernelVersion: 2.6.30 > +Contact: xen-devel@lists.xenproject.org > +Description: If running under Xen: > + Changeset of the hypervisor (git commit) > + > +What: /sys/hypervisor/properties/features > +Date: March 2009 > +KernelVersion: 2.6.30 > +Contact: xen-devel@lists.xenproject.org > +Description: If running under Xen: > + Features the Xen hypervisor supports for the guest as defined > + in include/xen/interface/features.h printed as a hex value. > + > +What: /sys/hypervisor/properties/pagesize > +Date: March 2009 > +KernelVersion: 2.6.30 > +Contact: xen-devel@lists.xenproject.org > +Description: If running under Xen: > + Default page size of the hypervisor printed as a hex value. > + > +What: /sys/hypervisor/properties/virtual_start > +Date: March 2009 > +KernelVersion: 2.6.30 > +Contact: xen-devel@lists.xenproject.org > +Description: If running under Xen: > + Virtual address of the hypervisor as a hex value. All properties above here, as well as "extra" below, may be deliberately elided by Xen. Is it perhaps worth having a general note to this effect at the top of the file? ~Andrew