[Xen-devel] [PATCH v2 1/2] doc, xen: document hypervisor sysfs nodes for xen

[Juergen Gross <jgross@xxxxxxxx>]

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 <jgross@xxxxxxxx>
---
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@xxxxxxxxxxxxxxxxxxxx
+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@xxxxxxxxxxxxxxxxxxxx
+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@xxxxxxxxxxxxxxxxxxxx
+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@xxxxxxxxxxxxxxxxxxxx
+Description:   If running under Xen:
+               Space separated list of supported guest system types. Each type
+               is in the format: <class>-<major>.<minor>-<arch>
+               With:
+                       <class>: "xen" -- x86: paravirtualized, arm: standard
+                                "hvm" -- x86 only: full virtualized
+                       <major>: major guest interface version
+                       <minor>: minor guest interface version
+                       <arch>:  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@xxxxxxxxxxxxxxxxxxxx
+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@xxxxxxxxxxxxxxxxxxxx
+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@xxxxxxxxxxxxxxxxxxxx
+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@xxxxxxxxxxxxxxxxxxxx
+Description:   If running under Xen:
+               Virtual address of the hypervisor as a hex value.
+
+What:          /sys/hypervisor/type
+Date:          March 2009
+KernelVersion: 2.6.30
+Contact:       xen-devel@xxxxxxxxxxxxxxxxxxxx
+Description:   If running under Xen:
+               Type of hypervisor:
+               "xen": Xen hypervisor
+
+What:          /sys/hypervisor/uuid
+Date:          March 2009
+KernelVersion: 2.6.30
+Contact:       xen-devel@xxxxxxxxxxxxxxxxxxxx
+Description:   If running under Xen:
+               UUID of the guest as known to the Xen hypervisor.
+
+What:          /sys/hypervisor/version/extra
+Date:          March 2009
+KernelVersion: 2.6.30
+Contact:       xen-devel@xxxxxxxxxxxxxxxxxxxx
+Description:   If running under Xen:
+               The Xen version is in the format <major>.<minor><extra>
+               This is the <extra> part of it.
+
+What:          /sys/hypervisor/version/major
+Date:          March 2009
+KernelVersion: 2.6.30
+Contact:       xen-devel@xxxxxxxxxxxxxxxxxxxx
+Description:   If running under Xen:
+               The Xen version is in the format <major>.<minor><extra>
+               This is the <major> part of it.
+
+What:          /sys/hypervisor/version/minor
+Date:          March 2009
+KernelVersion: 2.6.30
+Contact:       xen-devel@xxxxxxxxxxxxxxxxxxxx
+Description:   If running under Xen:
+               The Xen version is in the format <major>.<minor><extra>
+               This is the <minor> part of it.
diff --git a/MAINTAINERS b/MAINTAINERS
index 9e984645c4b0..5d10cc33fc41 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -13983,6 +13983,8 @@ F:      drivers/xen/
 F:     arch/x86/include/asm/xen/
 F:     include/xen/
 F:     include/uapi/xen/
+F:     Documentation/ABI/stable/sysfs-hypervisor-xen
+F:     Documentation/ABI/testing/sysfs-hypervisor-pmu
 
 XEN HYPERVISOR ARM
 M:     Stefano Stabellini <sstabellini@xxxxxxxxxx>
-- 
2.12.0


_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
https://lists.xen.org/xen-devel