Training courses

Kernel and Embedded Linux

Bootlin training courses

Embedded Linux, kernel,
Yocto Project, Buildroot, real-time,
graphics, boot time, debugging...

Bootlin logo

Elixir Cross Referencer

# SPDX-License-Identifier: GPL-2.0-only
menu "Xen driver support"
	depends on CONFIG_XEN

config CONFIG_XEN_BALLOON
	bool "Xen memory balloon driver"
	default y
	help
	  The balloon driver allows the Xen domain to request more memory from
	  the system to expand the domain's memory allocation, or alternatively
	  return unneeded memory to the system.

config CONFIG_XEN_BALLOON_MEMORY_HOTPLUG
	bool "Memory hotplug support for Xen balloon driver"
	depends on CONFIG_XEN_BALLOON && CONFIG_MEMORY_HOTPLUG
	help
	  Memory hotplug support for Xen balloon driver allows expanding memory
	  available for the system above limit declared at system startup.
	  It is very useful on critical systems which require long
	  run without rebooting.

	  Memory could be hotplugged in following steps:

	    1) target domain: ensure that memory auto online policy is in
	       effect by checking /sys/devices/system/memory/auto_online_blocks
	       file (should be 'online').

	    2) control domain: xl mem-max <target-domain> <maxmem>
	       where <maxmem> is >= requested memory size,

	    3) control domain: xl mem-set <target-domain> <memory>
	       where <memory> is requested memory size; alternatively memory
	       could be added by writing proper value to
	       /sys/devices/system/xen_memory/xen_memory0/target or
	       /sys/devices/system/xen_memory/xen_memory0/target_kb on the
	       target domain.

	  Alternatively, if memory auto onlining was not requested at step 1
	  the newly added memory can be manually onlined in the target domain
	  by doing the following:

		for i in /sys/devices/system/memory/memory*/state; do \
		  [ "`cat "$i"`" = offline ] && echo online > "$i"; done

	  or by adding the following line to udev rules:

	  SUBSYSTEM=="memory", ACTION=="add", RUN+="/bin/sh -c '[ -f /sys$devpath/state ] && echo online > /sys$devpath/state'"

config CONFIG_XEN_BALLOON_MEMORY_HOTPLUG_LIMIT
	int "Hotplugged memory limit (in GiB) for a PV guest"
	default 512 if CONFIG_X86_64
	default 4 if CONFIG_X86_32
	range 0 64 if CONFIG_X86_32
	depends on CONFIG_XEN_HAVE_PVMMU
	depends on CONFIG_XEN_BALLOON_MEMORY_HOTPLUG
	help
	  Maxmium amount of memory (in GiB) that a PV guest can be
	  expanded to when using memory hotplug.

	  CONFIG_A PV guest can have more memory than this limit if is
	  started with a larger maximum.

	  This value is used to allocate enough space in internal
	  tables needed for physical memory administration.

config CONFIG_XEN_SCRUB_PAGES_DEFAULT
	bool "Scrub pages before returning them to system by default"
	depends on CONFIG_XEN_BALLOON
	default y
	help
	  Scrub pages before returning them to the system for reuse by
	  other domains.  This makes sure that any confidential data
	  is not accidentally visible to other domains.  It is more
	  secure, but slightly less efficient. This can be controlled with
	  xen_scrub_pages=0 parameter and
	  /sys/devices/system/xen_memory/xen_memory0/scrub_pages.
	  This option only sets the default value.

	  If in doubt, say yes.

config CONFIG_XEN_DEV_EVTCHN
	tristate "Xen /dev/xen/evtchn device"
	default y
	help
	  The evtchn driver allows a userspace process to trigger event
	  channels and to receive notification of an event channel
	  firing.
	  If in doubt, say yes.

config CONFIG_XEN_BACKEND
	bool "Backend driver support"
	default CONFIG_XEN_DOM0
	help
	  Support for backend device drivers that provide I/O services
	  to other virtual machines.

config CONFIG_XENFS
	tristate "Xen filesystem"
	select CONFIG_XEN_PRIVCMD
	default y
	help
	  The xen filesystem provides a way for domains to share
	  information with each other and with the hypervisor.
	  For example, by reading and writing the "xenbus" file, guests
	  may pass arbitrary information to the initial domain.
	  If in doubt, say yes.

config CONFIG_XEN_COMPAT_XENFS
       bool "Create compatibility mount point /proc/xen"
       depends on CONFIG_XENFS
       default y
       help
         The old xenstore userspace tools expect to find "xenbus"
         under /proc/xen, but "xenbus" is now found at the root of the
         xenfs filesystem.  Selecting this causes the kernel to create
         the compatibility mount point /proc/xen if it is running on
         a xen platform.
         If in doubt, say yes.

config CONFIG_XEN_SYS_HYPERVISOR
       bool "Create xen entries under /sys/hypervisor"
       depends on CONFIG_SYSFS
       select CONFIG_SYS_HYPERVISOR
       default y
       help
         Create entries under /sys/hypervisor describing the Xen
	 hypervisor environment.  When running native or in another
	 virtual environment, /sys/hypervisor will still be present,
	 but will have no xen contents.

config CONFIG_XEN_XENBUS_FRONTEND
	tristate

config CONFIG_XEN_GNTDEV
	tristate "userspace grant access device driver"
	depends on CONFIG_XEN
	default m
	select CONFIG_MMU_NOTIFIER
	help
	  Allows userspace processes to use grants.

config CONFIG_XEN_GNTDEV_DMABUF
	bool "Add support for dma-buf grant access device driver extension"
	depends on CONFIG_XEN_GNTDEV && CONFIG_XEN_GRANT_DMA_ALLOC && CONFIG_DMA_SHARED_BUFFER
	help
	  Allows userspace processes and kernel modules to use Xen backed
	  dma-buf implementation. With this extension grant references to
	  the pages of an imported dma-buf can be exported for other domain
	  use and grant references coming from a foreign domain can be
	  converted into a local dma-buf for local export.

config CONFIG_XEN_GRANT_DEV_ALLOC
	tristate "User-space grant reference allocator driver"
	depends on CONFIG_XEN
	default m
	help
	  Allows userspace processes to create pages with access granted
	  to other domains. This can be used to implement frontend drivers
	  or as part of an inter-domain shared memory channel.

config CONFIG_XEN_GRANT_DMA_ALLOC
	bool "Allow allocating DMA capable buffers with grant reference module"
	depends on CONFIG_XEN && CONFIG_HAS_DMA
	help
	  Extends grant table module API to allow allocating DMA capable
	  buffers and mapping foreign grant references on top of it.
	  The resulting buffer is similar to one allocated by the balloon
	  driver in that proper memory reservation is made by
	  ({increase|decrease}_reservation and VA mappings are updated if
	  needed).
	  This is useful for sharing foreign buffers with HW drivers which
	  cannot work with scattered buffers provided by the balloon driver,
	  but require DMAable memory instead.

config CONFIG_SWIOTLB_XEN
	def_bool y
	select CONFIG_SWIOTLB

config CONFIG_XEN_PCIDEV_BACKEND
	tristate "Xen PCI-device backend driver"
	depends on CONFIG_PCI && CONFIG_X86 && CONFIG_XEN
	depends on CONFIG_XEN_BACKEND
	default m
	help
	  The CONFIG_PCI device backend driver allows the kernel to export arbitrary
	  CONFIG_PCI devices to other guests. If you select this to be a module, you
	  will need to make sure no other driver has bound to the device(s)
	  you want to make visible to other guests.

	  The parameter "passthrough" allows you specify how you want the CONFIG_PCI
	  devices to appear in the guest. You can choose the default (0) where
	  CONFIG_PCI topology starts at 00.00.0, or (1) for passthrough if you want
	  the CONFIG_PCI devices topology appear the same as in the host.

	  The "hide" parameter (only applicable if backend driver is compiled
	  into the kernel) allows you to bind the CONFIG_PCI devices to this module
	  from the default device drivers. The argument is the list of CONFIG_PCI BDFs:
	  xen-pciback.hide=(03:00.0)(04:00.0)

	  If in doubt, say m.

config CONFIG_XEN_PVCALLS_FRONTEND
	tristate "XEN PV Calls frontend driver"
	depends on CONFIG_INET && CONFIG_XEN
	select CONFIG_XEN_XENBUS_FRONTEND
	help
	  Experimental frontend for the Xen PV Calls protocol
	  (https://xenbits.xen.org/docs/unstable/misc/pvcalls.html). It
	  sends a small set of POSIX calls to the backend, which
	  implements them.

config CONFIG_XEN_PVCALLS_BACKEND
	bool "XEN PV Calls backend driver"
	depends on CONFIG_INET && CONFIG_XEN && CONFIG_XEN_BACKEND
	help
	  Experimental backend for the Xen PV Calls protocol
	  (https://xenbits.xen.org/docs/unstable/misc/pvcalls.html). It
	  allows PV Calls frontends to send POSIX calls to the backend,
	  which implements them.

	  If in doubt, say n.

config CONFIG_XEN_SCSI_BACKEND
	tristate "XEN SCSI backend driver"
	depends on CONFIG_XEN && CONFIG_XEN_BACKEND && CONFIG_TARGET_CORE
	help
	  The CONFIG_SCSI backend driver allows the kernel to export its CONFIG_SCSI Devices
	  to other guests via a high-performance shared-memory interface.
	  Only needed for systems running as CONFIG_XEN driver domains (e.g. Dom0) and
	  if guests need generic access to CONFIG_SCSI devices.

config CONFIG_XEN_PRIVCMD
	tristate
	depends on CONFIG_XEN
	default m

config CONFIG_XEN_STUB
	bool "Xen stub drivers"
	depends on CONFIG_XEN && CONFIG_X86_64 && CONFIG_BROKEN
	help
	  Allow kernel to install stub drivers, to reserve space for Xen drivers,
	  i.e. memory hotplug and cpu hotplug, and to block native drivers loaded,
	  so that real Xen drivers can be modular.

	  To enable Xen features like cpu and memory hotplug, select Y here.

config CONFIG_XEN_ACPI_HOTPLUG_MEMORY
	tristate "Xen ACPI memory hotplug"
	depends on CONFIG_XEN_DOM0 && CONFIG_XEN_STUB && CONFIG_ACPI
	help
	  This is Xen CONFIG_ACPI memory hotplug.

	  Currently Xen only support CONFIG_ACPI memory hot-add. If you want
	  to hot-add memory at runtime (the hot-added memory cannot be
	  removed until machine stop), select Y/CONFIG_M here, otherwise select N.

config CONFIG_XEN_ACPI_HOTPLUG_CPU
	tristate "Xen ACPI cpu hotplug"
	depends on CONFIG_XEN_DOM0 && CONFIG_XEN_STUB && CONFIG_ACPI
	select CONFIG_ACPI_CONTAINER
	help
	  Xen CONFIG_ACPI cpu enumerating and hotplugging

	  For hotplugging, currently Xen only support CONFIG_ACPI cpu hotadd.
	  If you want to hotadd cpu at runtime (the hotadded cpu cannot
	  be removed until machine stop), select Y/CONFIG_M here.

config CONFIG_XEN_ACPI_PROCESSOR
	tristate "Xen ACPI processor"
	depends on CONFIG_XEN && CONFIG_XEN_DOM0 && CONFIG_X86 && CONFIG_ACPI_PROCESSOR && CONFIG_CPU_FREQ
	default m
	help
          This CONFIG_ACPI processor uploads Power Management information to the Xen
	  hypervisor.

	  To do that the driver parses the Power Management data and uploads
	  said information to the Xen hypervisor. Then the Xen hypervisor can
	  select the proper Cx and Pxx states. It also registers itself as the
	  SMM so that other drivers (such as CONFIG_ACPI cpufreq scaling driver) will
	  not load.

          To compile this driver as a module, choose CONFIG_M here: the module will be
	  called xen_acpi_processor  If you do not know what to choose, select
	  CONFIG_M here. If the CPUFREQ drivers are built in, select Y here.

config CONFIG_XEN_MCE_LOG
	bool "Xen platform mcelog"
	depends on CONFIG_XEN_DOM0 && CONFIG_X86_64 && CONFIG_X86_MCE
	help
	  Allow kernel fetching MCE error from Xen platform and
	  converting it into Linux mcelog format for mcelog tools

config CONFIG_XEN_HAVE_PVMMU
       bool

config CONFIG_XEN_EFI
	def_bool y
	depends on (CONFIG_ARM || CONFIG_ARM64 || CONFIG_X86_64) && CONFIG_EFI

config CONFIG_XEN_AUTO_XLATE
	def_bool y
	depends on CONFIG_ARM || CONFIG_ARM64 || CONFIG_XEN_PVHVM
	help
	  Support for auto-translated physmap guests.

config CONFIG_XEN_ACPI
	def_bool y
	depends on CONFIG_X86 && CONFIG_ACPI

config CONFIG_XEN_SYMS
       bool "Xen symbols"
       depends on CONFIG_X86 && CONFIG_XEN_DOM0 && CONFIG_XENFS
       default y if CONFIG_KALLSYMS
       help
          Exports hypervisor symbols (along with their types and addresses) via
          /proc/xen/xensyms file, similar to /proc/kallsyms

config CONFIG_XEN_HAVE_VPMU
       bool

config CONFIG_XEN_FRONT_PGDIR_SHBUF
	tristate

endmenu