github/acrn-hypervisor
1
0
Fork 0
mirror of https://github.com/projectacrn/acrn-hypervisor.git synced 2025-06-19 20:22:46 +00:00
Code Issues Projects Releases Wiki Activity

Documentation: add more Kconfig options documentation

Browse Source 
* Add more Kconfig options documentation for the hypervisor
* Reword some existing one to improve readibility
* Break some help text to not go beyond 80 characters

Tracked-On: #1588
Signed-off-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com>
Co-Authored-By: David B. Kinder <david.b.kinder@intel.com>
This commit is contained in:
Geoffroy Van Cutsem 2018-11-15 10:46:14 +01:00 committed by Xie, Nanlin
parent e1564edda5
commit 7eeeccdfad
1 changed files with 36 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

68
hypervisor/arch/x86/Kconfig
View File

@ -63,7 +63,7 @@ config IOREQ_POLLING
endchoice endchoice
config PLATFORM config PLATFORM
string string "The type of boot firmware (BIOS) on the target platform"
default "uefi" if PLATFORM_UEFI default "uefi" if PLATFORM_UEFI
default "sbl" if PLATFORM_SBL default "sbl" if PLATFORM_SBL
@ -95,7 +95,7 @@ config MAX_VM_NUM
general-purpose builds the maximum of physical cores can be used. general-purpose builds the maximum of physical cores can be used.
config MAX_VCPUS_PER_VM config MAX_VCPUS_PER_VM
int "Maximum number of VCPUS per VM" int "Maximum number of VCPUs per VM"
range 1 8 range 1 8
default 4 if PLATFORM_SBL default 4 if PLATFORM_SBL
default 8 if PLATFORM_UEFI default 8 if PLATFORM_UEFI
@ -109,7 +109,7 @@ config MAX_PCPU_NUM
default 8 default 8
config MAX_EMULATED_MMIO_REGIONS config MAX_EMULATED_MMIO_REGIONS
int "Maximum number of emulated mmio regions" int "Maximum number of emulated MMIO regions"
range 0 128 range 0 128
default 16 default 16
@ -126,7 +126,7 @@ config MAX_IOMMU_NUM
The maximum number of physical IOMMUs the hypervisor can support. The maximum number of physical IOMMUs the hypervisor can support.
config STACK_SIZE config STACK_SIZE
hex "Capacity of one stack, in byte" hex "Capacity of one stack, in bytes"
default 0x2000 default 0x2000
help help
The size of stacks used by physical cores. Each core uses one stack The size of stacks used by physical cores. Each core uses one stack
@ -165,13 +165,13 @@ choice
default. default.
config SERIAL_MMIO config SERIAL_MMIO
bool "MMIO" bool "Access serial port via MMIO"
help help
Select this if the serial port shall be accessed via memory-mapped Select this if the serial port shall be accessed via memory-mapped
registers. registers.
config SERIAL_PIO config SERIAL_PIO
bool "PIO" bool "Access serial port via PIO"
help help
Select this if the serial port shall be accessed via in/out Select this if the serial port shall be accessed via in/out
instructions. instructions.
@ -179,7 +179,7 @@ config SERIAL_PIO
endchoice endchoice
config SERIAL_MMIO_BASE config SERIAL_MMIO_BASE
hex "Base address of serial MMIO region" hex "Base address of serial port MMIO region"
depends on SERIAL_MMIO depends on SERIAL_MMIO
default 0xfc000000 default 0xfc000000
help help
@ -187,7 +187,7 @@ config SERIAL_MMIO_BASE
memory-mapped UART registers. memory-mapped UART registers.
config SERIAL_PIO_BASE config SERIAL_PIO_BASE
hex "Base address of serial PIO region" hex "Base address of serial port PIO region"
depends on SERIAL_PIO depends on SERIAL_PIO
default 0x3f8 default 0x3f8
help help
@ -258,12 +258,13 @@ config HV_RAM_START
default 0x6e000000 if PLATFORM_SBL default 0x6e000000 if PLATFORM_SBL
default 0x00100000 if PLATFORM_UEFI default 0x00100000 if PLATFORM_UEFI
help help
A 64-bit integer indicating the base physical address to where the hypervisor A 64-bit integer indicating the base physical address where the
should be loaded to. If RELOC is disabled the bootloader is required hypervisor should be loaded. If RELOC is disabled, the bootloader
to load the hypervisor to this specific address. Otherwise the is required to load the hypervisor to this specific address.
hypervisor will not boot. With RELOC enabled the hypervisor is capable Otherwise the hypervisor will not boot. With RELOC enabled the
of relocating its symbols to where it is placed at, and thus the hypervisor may relocate its symbols to where it is placed,
bootloader may not place the hypervisor at this specific address. and thus the bootloader might not place the hypervisor at this
specific address.
config HV_RAM_SIZE config HV_RAM_SIZE
hex "Size of the RAM region used by the hypervisor" hex "Size of the RAM region used by the hypervisor"
@ -280,22 +281,23 @@ config PLATFORM_RAM_SIZE
default 0x400000000 if PLATFORM_UEFI default 0x400000000 if PLATFORM_UEFI
help help
A 64-bit integer indicating the size of the physical platform RAM A 64-bit integer indicating the size of the physical platform RAM
(not included the MMIO). (MMIO not included).
config SOS_RAM_SIZE config SOS_RAM_SIZE
hex "Size of the vm0 RAM" hex "Size of the vm0 (SOS) RAM"
default 0x200000000 if PLATFORM_SBL default 0x200000000 if PLATFORM_SBL
default 0x400000000 if PLATFORM_UEFI default 0x400000000 if PLATFORM_UEFI
help help
A 64-bit integer indicating the size of the vm0 RAM (not included the MMIO). A 64-bit integer indicating the size of the vm0 (SOS) RAM (MMIO not
included).
config UOS_RAM_SIZE config UOS_RAM_SIZE
hex "Size of the UOS RAM" hex "Size of the User OS (UOS) RAM"
default 0x100000000 if PLATFORM_SBL default 0x100000000 if PLATFORM_SBL
default 0x200000000 if PLATFORM_UEFI default 0x200000000 if PLATFORM_UEFI
help help
A 64-bit integer indicating the size of the user OS RAM (not included the MMIO). A 64-bit integer indicating the size of the User OS RAM (MMIO not
Now we assume each UOS uses same amount of RAM size. included). Now we assume each UOS uses same amount of RAM size.
config CONSTANT_ACPI config CONSTANT_ACPI
bool "The platform ACPI info is constant" bool "The platform ACPI info is constant"
@ -307,14 +309,14 @@ config CONSTANT_ACPI
built-in tables after parsing the real ACPI tables at runtime. built-in tables after parsing the real ACPI tables at runtime.
config DMAR_PARSE_ENABLED config DMAR_PARSE_ENABLED
bool "Enable DMAR parsing" bool "Enable ACPI DMA Remapping tables parsing"
default n if PLATFORM_SBL default n if PLATFORM_SBL
default y if PLATFORM_UEFI default y if PLATFORM_UEFI
help help
Whether to parse the ACPI DMA Remapping tables at runtime. Whether to parse the ACPI DMA Remapping tables at runtime.
config GPU_SBDF config GPU_SBDF
hex hex "Segment, Bus, Device, and function of the GPU"
depends on DMAR_PARSE_ENABLED depends on DMAR_PARSE_ENABLED
default 0x00000010 default 0x00000010
help help
@ -325,7 +327,7 @@ config GPU_SBDF
(2 << 3) | (0 << 0), i.e. 0x00000010. (2 << 3) | (0 << 0), i.e. 0x00000010.
config EFI_STUB config EFI_STUB
bool bool "Enable EFI stub"
depends on PLATFORM_UEFI depends on PLATFORM_UEFI
default y default y
@ -335,11 +337,11 @@ config UEFI_OS_LOADER_NAME
default "\\EFI\\org.clearlinux\\bootloaderx64.efi" default "\\EFI\\org.clearlinux\\bootloaderx64.efi"
config MTRR_ENABLED config MTRR_ENABLED
bool bool "Memory Type Range Registers (MTRR) enabled"
default y default y
config RELOC config RELOC
bool "Enable relocation" bool "Enable hypervisor relocation"
default n default n
help help
When selected, the hypervisor will relocate itself to where it is When selected, the hypervisor will relocate itself to where it is
@ -348,7 +350,7 @@ config RELOC
image to RAM_START, otherwise the hypervisor will not start up. image to RAM_START, otherwise the hypervisor will not start up.
config IOMMU_BUS_NUM config IOMMU_BUS_NUM
hex "Limit of PCI bus on IOMMU initialization" hex "Highest PCI bus ID used during IOMMU initialization"
default 0x10 if PLATFORM_SBL default 0x10 if PLATFORM_SBL
default 0x100 if PLATFORM_UEFI default 0x100 if PLATFORM_UEFI
help help
@ -356,23 +358,23 @@ config IOMMU_BUS_NUM
the IOMMU domain of the first VM. the IOMMU domain of the first VM.
config MAX_PCI_DEV_NUM config MAX_PCI_DEV_NUM
int "Maximum number of PCI dev" int "Maximum number of PCI devices"
range 1 1024 range 1 1024
default 96 default 96
config MAX_MSIX_TABLE_NUM config MAX_MSIX_TABLE_NUM
int "Maximum number of MSI-X Table per device" int "Maximum number of MSI-X tables per device"
range 1 2048 range 1 2048
default 16 default 16
config ENFORCE_VALIDATED_ACPI_INFO config ENFORCE_VALIDATED_ACPI_INFO
bool "Enforce validated ACPI info table" bool "Enforce the use of validated ACPI info table"
default n default n
help help
When set, validated ACPI info tables is enforced and using offline When set, the use of validated ACPI info tables is enforced and using
tools to generate such data is required. Otherwise a warning will be an offline tool to generate such data is required. Otherwise a
printed when validated ACPI info is unavailable, but a binary can warning will be printed when validated ACPI info is unavailable, but
still be built with the ACPI info template. a binary can still be built with the ACPI info template.
config L1D_FLUSH_VMENTRY_ENABLED config L1D_FLUSH_VMENTRY_ENABLED
bool "Enable L1 cache flush before VM entry" bool "Enable L1 cache flush before VM entry"