xen: add xen sysfs node
Subsystems (5)
Juergen Gross
maintainerv2 cover xen: add xen sysfs node
In order to be able to determine the Xen guest type from within the guest as a user there is currently no stable interface available.
Add a sysfs node for that purpose as the guest type information is available for the kernel.
While doing this document all the other Xen related sysfs nodes.
Juergen Gross (2):
doc,xen: document hypervisor sysfs nodes for xen
xen: add sysfs node for guest type
Documentation/ABI/stable/sysfs-hypervisor-xen | 107 +++++++++++++++++++++
.../{sysfs-hypervisor-pmu => sysfs-hypervisor-xen} | 15 ++-
MAINTAINERS | 2 +
arch/arm/xen/enlighten.c | 3 +
arch/x86/xen/enlighten.c | 3 +
arch/x86/xen/enlighten_hvm.c | 5 +-
arch/x86/xen/enlighten_pv.c | 1 +
drivers/xen/sys-hypervisor.c | 17 ++++
include/xen/xen.h | 2 +
9 files changed, 151 insertions(+), 4 deletions(-)
create mode 100644 Documentation/ABI/stable/sysfs-hypervisor-xen
rename Documentation/ABI/testing/{sysfs-hypervisor-pmu => sysfs-hypervisor-xen} (67%)Signature · 7 lines
2.12.0 _______________________________________________ Xen-devel mailing list [email protected] https://lists.xen.org/xen-devel
Juergen Gross
maintainerPATCH v2 1/2 doc,xen: document hypervisor sysfs nodes for xen
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.
---
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
Documentation/ABI/stable/sysfs-hypervisor-xen new file +107 -0
@@ -0,0 +1,107 @@ +What: /sys/hypervisor/compilation/compile_date +Date: March 2009 +KernelVersion: 2.6.30 +Contact: [email protected] +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: [email protected] +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: [email protected] +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: [email protected] +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: [email protected] +Description: If running under Xen: + Changeset of the hypervisor (git commit) + +What: /sys/hypervisor/properties/features +Date: March 2009 +KernelVersion: 2.6.30 +Contact: [email protected] +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: [email protected] +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: [email protected] +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: [email protected] +Description: If running under Xen: + Type of hypervisor: + "xen": Xen hypervisor + +What: /sys/hypervisor/uuid +Date: March 2009 +KernelVersion: 2.6.30 +Contact: [email protected] +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: [email protected] +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: [email protected] +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: [email protected] +Description: If running under Xen: + The Xen version is in the format <major>.<minor><extra> + This is the <minor> part of it.
MAINTAINERS +2 -0
@@ -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 <[email protected]>
Signature · 7 lines
2.12.0 _______________________________________________ Xen-devel mailing list [email protected] https://lists.xen.org/xen-devel
Re: [Xen-devel] [PATCH v2 1/2] doc, xen: document hypervisor sysfs nodes for xen
Quoted 83 lines · Juergen Gross
Today only a few sysfs nodes under
/sys/hypervisor/are documented for Xen inDocumentation/ABI/testing/sysfs-hypervisor-pmu.Add the remaining Xen sysfs nodes under
/sys/hypervisor/in a new fileDocumentation/ABI/stable/sysfs-hypervisor-xenand add the Xen specific sysfs docs to theMAINTAINERSfile.Signed-off-by Juergen Gross <[email protected]>---
V2:
- rename file toDocumentation/ABI/stable/sysfs-hypervisor-xenin 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-xenDocumentation/ABI/stable/sysfs-hypervisor-xen new file +58
-0@@ -0,0 +1,107 @@ +What: /sys/hypervisor/compilation/compile_date +Date: March 2009 +KernelVersion: 2.6.30 +Contact: [email protected] +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: [email protected] +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: [email protected] +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: [email protected] +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: [email protected] +Description: If running under Xen: + Changeset of the hypervisor (git commit) + +What: /sys/hypervisor/properties/features +Date: March 2009 +KernelVersion: 2.6.30 +Contact: [email protected] +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
Documentation/ABI/stable/sysfs-hypervisor-xen line 68
Quoted 10 lines
Documentation/ABI/stable/sysfs-hypervisor-xen new file +10
-0+Contact: [email protected] +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: [email protected] +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
Re: [PATCH v2 1/2] doc, xen: document hypervisor sysfs nodes for xen
In reply to Juergen GrossQuoted 83 lines · Juergen Gross
Today only a few sysfs nodes under
/sys/hypervisor/are documented for Xen inDocumentation/ABI/testing/sysfs-hypervisor-pmu.Add the remaining Xen sysfs nodes under
/sys/hypervisor/in a new fileDocumentation/ABI/stable/sysfs-hypervisor-xenand add the Xen specific sysfs docs to theMAINTAINERSfile.Signed-off-by Juergen Gross <[email protected]>---
V2:
- rename file toDocumentation/ABI/stable/sysfs-hypervisor-xenin 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-xenDocumentation/ABI/stable/sysfs-hypervisor-xen new file +58
-0@@ -0,0 +1,107 @@ +What: /sys/hypervisor/compilation/compile_date +Date: March 2009 +KernelVersion: 2.6.30 +Contact: [email protected] +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: [email protected] +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: [email protected] +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: [email protected] +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: [email protected] +Description: If running under Xen: + Changeset of the hypervisor (git commit) + +What: /sys/hypervisor/properties/features +Date: March 2009 +KernelVersion: 2.6.30 +Contact: [email protected] +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
Documentation/ABI/stable/sysfs-hypervisor-xen line 68
Quoted 10 lines
Documentation/ABI/stable/sysfs-hypervisor-xen new file +10
-0+Contact: [email protected] +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: [email protected] +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
_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xen.org/xen-devel
Juergen Gross
maintainerPATCH v2 2/2 xen: add sysfs node for guest type
In reply to Juergen GrossCurrently there is no reliable user interface inside a Xen guest to determine its type (e.g. HVM, PV or PVH). Instead of letting user mode try to determine this by various rather hacky mechanisms (parsing of boot messages before they are gone, trying to make use of known subtle differences in behavior of some instructions), add a sysfs node /sys/hypervisor/guest_type to explicitly deliver this information as it is known to the kernel.
---
V2:
- remove PVHVM guest type (Andrew Cooper)
- move description to Documentation/ABI/testing/sysfs-hypervisor-xen (Boris Ostrovsky)
- make xen_guest_type const char * (Jan Beulich)
- modify standard ARM guest type to "Xen"
---
.../{sysfs-hypervisor-pmu => sysfs-hypervisor-xen} | 15 +++++++++++++--
MAINTAINERS | 2 +-
arch/arm/xen/enlighten.c | 3 +++
arch/x86/xen/enlighten.c | 3 +++
arch/x86/xen/enlighten_hvm.c | 5 +++--
arch/x86/xen/enlighten_pv.c | 1 +
drivers/xen/sys-hypervisor.c | 17 +++++++++++++++++
include/xen/xen.h | 2 ++
8 files changed, 43 insertions(+), 5 deletions(-)
rename Documentation/ABI/testing/{sysfs-hypervisor-pmu => sysfs-hypervisor-xen} (67%)Documentation/ABI/testing/sysfs-hypervisor-xen renamed from Documentation/ABI/testing/sysfs-hypervisor-pmu +13 -2
@@ -1,8 +1,19 @@ +What: /sys/hypervisor/guest_type +Date: May 2017 +KernelVersion: 4.13 +Contact: [email protected] +Description: If running under Xen: + Type of guest: + "Xen": standard guest type on arm + "HVM": fully virtualized guest (x86) + "PV": paravirtualized guest (x86) + "PVH": fully virtualized guest without legacy emulation (x86) + What: /sys/hypervisor/pmu/pmu_mode Date: August 2015 KernelVersion: 4.3 Contact: Boris Ostrovsky <[email protected]> -Description: +Description: If running under Xen: Describes mode that Xen's performance-monitoring unit (PMU) uses. Accepted values are "off" -- PMU is disabled
@@ -17,7 +28,7 @@ What: /sys/hypervisor/pmu/pmu_features Date: August 2015 KernelVersion: 4.3 Contact: Boris Ostrovsky <[email protected]> -Description: +Description: If running under Xen: Describes Xen PMU features (as an integer). A set bit indicates that the corresponding feature is enabled. See include/xen/interface/xenpmu.h for available features
MAINTAINERS +1 -1
@@ -13984,7 +13984,7 @@ 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 +F: Documentation/ABI/testing/sysfs-hypervisor-xen XEN HYPERVISOR ARM M: Stefano Stabellini <[email protected]>
arch/arm/xen/enlighten.c +3 -0
@@ -43,6 +43,9 @@ EXPORT_SYMBOL(xen_start_info);enum xen_domain_type xen_domain_type =XEN_NATIVE ;EXPORT_SYMBOL (xen_domain_type); +const char *xen_guest_type ="Xen" ; +EXPORT_SYMBOL_GPL (xen_guest_type); +struct shared_info xen_dummy_shared_info;struct shared_info *HYPERVISOR_shared_info = (void *)&xen_dummy_shared_info;
arch/x86/xen/enlighten.c +3 -0
@@ -47,6 +47,9 @@ EXPORT_PER_CPU_SYMBOL(xen_vcpu_id);enum xen_domain_type xen_domain_type =XEN_NATIVE ;EXPORT_SYMBOL_GPL (xen_domain_type); +const char *xen_guest_type ="HVM" ; +EXPORT_SYMBOL_GPL (xen_guest_type); +unsigned long *machine_to_phys_mapping = (void *)MACH2PHYS_VIRT_START ;EXPORT_SYMBOL (machine_to_phys_mapping);unsigned long machine_to_phys_nr;
arch/x86/xen/enlighten_hvm.c +3 -2
@@ -68,9 +68,10 @@ static void __init init_hvm_pv_info(void) xen_domain_type =XEN_HVM_DOMAIN ;/* PVH set up hypercall page in xen_prepare_pvh(). */ -if (xen_pvh_domain ()) +if (xen_pvh_domain ()) { pv_info.name ="Xen PVH" ; -else { + xen_guest_type ="PVH" ; + }else {u64 pfn;uint32_t msr;
arch/x86/xen/enlighten_pv.c +1 -0
@@ -1255,6 +1255,7 @@ asmlinkage __visible void __init xen_start_kernel(void)return ; xen_domain_type =XEN_PV_DOMAIN ; + xen_guest_type ="PV" ;xen_setup_features ();
drivers/xen/sys-hypervisor.c +17 -0
@@ -50,6 +50,18 @@ static int __init xen_sysfs_type_init(void)return sysfs_create_file (hypervisor_kobj, &type_attr.attr); } +static ssize_t guest_type_show (struct hyp_sysfs_attr *attr,char *buffer) +{ +return sprintf (buffer,"%s\n" , xen_guest_type); +} + +HYPERVISOR_ATTR_RO (guest_type); + +static int __init xen_sysfs_guest_type_init (void ) +{ +return sysfs_create_file (hypervisor_kobj, &guest_type_attr.attr); +} +/* xen version attributes */ static ssize_t major_show (struct hyp_sysfs_attr *attr,char *buffer) {
@@ -471,6 +483,9 @@ static int __init hyper_sysfs_init(void) ret =xen_sysfs_type_init ();if (ret) goto out; + ret =xen_sysfs_guest_type_init (); +if (ret) + goto guest_type_out; ret =xen_sysfs_version_init ();if (ret) goto version_out;
@@ -502,6 +517,8 @@ static int __init hyper_sysfs_init(void) comp_out:sysfs_remove_group (hypervisor_kobj, &version_group); version_out: +sysfs_remove_file (hypervisor_kobj, &guest_type_attr.attr); +guest_type_out:sysfs_remove_file (hypervisor_kobj, &type_attr.attr); out:return ret;
include/xen/xen.h +2 -0
@@ -9,8 +9,10 @@ enum xen_domain_type {#ifdef CONFIG_XEN extern enum xen_domain_type xen_domain_type; +extern const char *xen_guest_type;#else #define xen_domain_type XEN_NATIVE +#define xen_guest_type "native"#endif #define xen_domain () (xen_domain_type != XEN_NATIVE)
Signature · 7 lines
2.12.0 _______________________________________________ Xen-devel mailing list [email protected] https://lists.xen.org/xen-devel
Re: [PATCH v2 2/2] xen: add sysfs node for guest type
Quoted 9 lines · Juergen Gross
Currently there is no reliable user interface inside a Xen guest to determine its type (e.g. HVM, PV or PVH). Instead of letting user mode try to determine this by various rather hacky mechanisms (parsing of boot messages before they are gone, trying to make use of known subtle differences in behavior of some instructions), add a sysfs node
/sys/hypervisor/guest_typeto explicitly deliver this information as it is known to the kernel.Signed-off-by Juergen Gross <[email protected]>
(I would have preferred to have /sys/hypervisor/xen/ but given that some of the other files have been around for ages, and are now declared stable, it's too late).
_______________________________________________
Xen-devel mailing list
[email protected]
https://lists.xen.org/xen-devel
Re: [PATCH v2 2/2] xen: add sysfs node for guest type
In reply to Juergen GrossQuoted 9 lines · Juergen Gross
Currently there is no reliable user interface inside a Xen guest to determine its type (e.g. HVM, PV or PVH). Instead of letting user mode try to determine this by various rather hacky mechanisms (parsing of boot messages before they are gone, trying to make use of known subtle differences in behavior of some instructions), add a sysfs node
/sys/hypervisor/guest_typeto explicitly deliver this information as it is known to the kernel.Signed-off-by Juergen Gross <[email protected]>
(I would have preferred to have /sys/hypervisor/xen/ but given that some of the other files have been around for ages, and are now declared stable, it's too late).