linux-imx/Documentation/ABI/stable/sysfs-hypervisor-xen
Per Bilse 415dab3c17 drivers/xen/hypervisor: Expose Xen SIF flags to userspace
/proc/xen is a legacy pseudo filesystem which predates Xen support
getting merged into Linux.  It has largely been replaced with more
normal locations for data (/sys/hypervisor/ for info, /dev/xen/ for
user devices).  We want to compile xenfs support out of the dom0 kernel.

There is one item which only exists in /proc/xen, namely
/proc/xen/capabilities with "control_d" being the signal of "you're in
the control domain".  This ultimately comes from the SIF flags provided
at VM start.

This patch exposes all SIF flags in /sys/hypervisor/start_flags/ as
boolean files, one for each bit, returning '1' if set, '0' otherwise.
Two known flags, 'privileged' and 'initdomain', are explicitly named,
and all remaining flags can be accessed via generically named files,
as suggested by Andrew Cooper.

Signed-off-by: Per Bilse <per.bilse@citrix.com>
Reviewed-by: Juergen Gross <jgross@suse.com>
Link: https://lore.kernel.org/r/20230103130213.2129753-1-per.bilse@citrix.com
Signed-off-by: Juergen Gross <jgross@suse.com>
2023-02-13 06:53:19 +01:00

4.4 KiB

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 Might return "" in case of special security settings in the 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 Might return "" in case of special security settings in the 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 Might return "" in case of special security settings in the 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:

		======== ============================================
		<class>: "xen" -- x86: paravirtualized, arm: standard
			 "hvm" -- x86 only: fully 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@lists.xenproject.org Description: If running under Xen: Changeset of the hypervisor (git commit) Might return "" in case of special security settings in the hypervisor.

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. Might return "0" in case of special security settings in the hypervisor.

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.

What: /sys/hypervisor/type Date: March 2009 KernelVersion: 2.6.30 Contact: xen-devel@lists.xenproject.org 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@lists.xenproject.org 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@lists.xenproject.org Description: If running under Xen: The Xen version is in the format . This is the part of it. Might return "" in case of special security settings in the hypervisor.

What: /sys/hypervisor/version/major Date: March 2009 KernelVersion: 2.6.30 Contact: xen-devel@lists.xenproject.org Description: If running under Xen: The Xen version is in the format . This is the part of it.

What: /sys/hypervisor/version/minor Date: March 2009 KernelVersion: 2.6.30 Contact: xen-devel@lists.xenproject.org Description: If running under Xen: The Xen version is in the format . This is the part of it.

What: /sys/hypervisor/start_flags/* Date: March 2023 KernelVersion: 6.3.0 Contact: xen-devel@lists.xenproject.org Description: If running under Xen: All bits in Xen's start-flags are represented as boolean files, returning '1' if set, '0' otherwise. This takes the place of the defunct /proc/xen/capabilities, which would contain "control_d" on dom0, and be empty otherwise. This flag is now exposed as "initdomain" in addition to the "privileged" flag; all other possible flags are accessible as "unknownXX".