drivers/firmware/efi/Kconfig v5.13-rc1


Menu: EFI (Extensible Firmware Interface) Support

EFI_VARS

EFI Variable Support via sysfs

If you say Y here, you are able to get EFI (Extensible Firmware
Interface) variable information via sysfs.  You may read,
write, create, and destroy EFI variables through this interface.
Note that this driver is only retained for compatibility with
legacy users: new users should use the efivarfs filesystem
instead.

EFI_VARS_PSTORE

Register efivars backend for pstore

Say Y here to enable use efivars as a backend to pstore. This
will allow writing console messages, crash dumps, or anything
else supported by pstore to EFI variables.

EFI_VARS_PSTORE_DEFAULT_DISABLE

Disable using efivars as a pstore backend by default

Saying Y here will disable the use of efivars as a storage
backend for pstore by default. This setting can be overridden
using the efivars module's pstore_disable parameter.

EFI_RUNTIME_MAP

Export efi runtime maps to sysfs

Export efi runtime memory maps to /sys/firmware/efi/runtime-map.
That memory map is used for example by kexec to set up efi virtual
mapping the 2nd kernel, but can also be used for debugging purposes.

See also Documentation/ABI/testing/sysfs-firmware-efi-runtime-map.

EFI_FAKE_MEMMAP

Enable EFI fake memory map

Saying Y here will enable "efi_fake_mem" boot option.
By specifying this parameter, you can add arbitrary attribute
to specific memory range by updating original (firmware provided)
EFI memmap.
This is useful for debugging of EFI memmap related feature.
e.g. Address Range Mirroring feature.

EFI_MAX_FAKE_MEM

maximum allowable number of ranges in efi_fake_mem boot option

Maximum allowable number of ranges in efi_fake_mem boot option.
Ranges can be set up to this value using comma-separated list.
The default value is 8.

EFI_SOFT_RESERVE

Reserve EFI Specific Purpose Memory

On systems that have mixed performance classes of memory EFI
may indicate specific purpose memory with an attribute (See
EFI_MEMORY_SP in UEFI 2.8). A memory range tagged with this
attribute may have unique performance characteristics compared
to the system's general purpose "System RAM" pool. On the
expectation that such memory has application specific usage,
and its base EFI memory type is "conventional" answer Y to
arrange for the kernel to reserve it as a "Soft Reserved"
resource, and set aside for direct-access (device-dax) by
default. The memory range can later be optionally assigned to
the page allocator by system administrator policy via the
device-dax kmem facility. Say N to have the kernel treat this
memory as "System RAM" by default.

If unsure, say Y.

EFI_PARAMS_FROM_FDT

Select this config option from the architecture Kconfig if
the EFI runtime support gets system table address, memory
map address, and other parameters from the device tree.

EFI_ARMSTUB_DTB_LOADER

Enable the DTB loader

Select this config option to add support for the dtb= command
line parameter, allowing a device tree blob to be loaded into
memory from the EFI System Partition by the stub.

If the device tree is provided by the platform or by
the bootloader this option may not be needed.
But, for various development reasons and to maintain existing
functionality for bootloaders that do not have such support
this option is necessary.

EFI_GENERIC_STUB_INITRD_CMDLINE_LOADER

Enable the command line initrd loader

Select this config option to add support for the initrd= command
line parameter, allowing an initrd that resides on the same volume
as the kernel image to be loaded into memory.

This method is deprecated.

EFI_BOOTLOADER_CONTROL

EFI Bootloader Control

This module installs a reboot hook, such that if reboot() is
invoked with a string argument NNN, "NNN" is copied to the
"LoaderEntryOneShot" EFI variable, to be read by the
bootloader. If the string matches one of the boot labels
defined in its configuration, the bootloader will boot once
to that label. The "LoaderEntryRebootReason" EFI variable is
set with the reboot reason: "reboot" or "shutdown". The
bootloader reads this reboot reason and takes particular
action according to its policy.

EFI_CAPSULE_LOADER

EFI capsule loader

This option exposes a loader interface "/dev/efi_capsule_loader" for
users to load EFI capsules. This driver requires working runtime
capsule support in the firmware, which many OEMs do not provide.

Most users should say N.

EFI_CAPSULE_QUIRK_QUARK_CSH

Add support for Quark capsules with non-standard headers

Add support for processing Quark X1000 EFI capsules, whose header
layout deviates from the layout mandated by the UEFI specification.

EFI_TEST

EFI Runtime Service Tests Support

This driver uses the efi.<service> function pointers directly instead
of going through the efivar API, because it is not trying to test the
kernel subsystem, just for testing the UEFI runtime service
interfaces which are provided by the firmware. This driver is used
by the Firmware Test Suite (FWTS) for testing the UEFI runtime
interfaces readiness of the firmware.
Details for FWTS are available from:
<https://wiki.ubuntu.com/FirmwareTestSuite>

Say Y here to enable the runtime services support via /dev/efi_test.
If unsure, say N.

APPLE_PROPERTIES

Apple Device Properties

Retrieve properties from EFI on Apple Macs and assign them to
devices, allowing for improved support of Apple hardware.
Properties that would otherwise be missing include the
Thunderbolt Device ROM and GPU configuration data.

If unsure, say Y if you have a Mac.  Otherwise N.

RESET_ATTACK_MITIGATION

Reset memory attack mitigation

Request that the firmware clear the contents of RAM after a reboot
using the TCG Platform Reset Attack Mitigation specification. This
protects against an attacker forcibly rebooting the system while it
still contains secrets in RAM, booting another OS and extracting the
secrets. This should only be enabled when userland is configured to
clear the MemoryOverwriteRequest flag on clean shutdown after secrets
have been evicted, since otherwise it will trigger even on clean
reboots.

EFI_RCI2_TABLE

EFI Runtime Configuration Interface Table Version 2 Support

Displays the content of the Runtime Configuration Interface
Table version 2 on Dell EMC PowerEdge systems as a binary
attribute 'rci2' under /sys/firmware/efi/tables directory.

RCI2 table contains BIOS HII in XML format and is used to populate
BIOS setup page in Dell EMC OpenManage Server Administrator tool.
The BIOS setup page contains BIOS tokens which can be configured.

Say Y here for Dell EMC PowerEdge systems.

EFI_DISABLE_PCI_DMA

Clear Busmaster bit on PCI bridges during ExitBootServices()

Disable the busmaster bit in the control register on all PCI bridges
while calling ExitBootServices() and passing control to the runtime
kernel. System firmware may configure the IOMMU to prevent malicious
PCI devices from being able to attack the OS via DMA. However, since
firmware can't guarantee that the OS is IOMMU-aware, it will tear
down IOMMU configuration when ExitBootServices() is called. This
leaves a window between where a hostile device could still cause
damage before Linux configures the IOMMU again.

If you say Y here, the EFI stub will clear the busmaster bit on all
PCI bridges before ExitBootServices() is called. This will prevent
any malicious PCI devices from being able to perform DMA until the
kernel reenables busmastering after configuring the IOMMU.

This option will cause failures with some poorly behaved hardware
and should not be enabled without testing. The kernel commandline
options "efi=disable_early_pci_dma" or "efi=no_disable_early_pci_dma"
may be used to override this option.


EFI_CUSTOM_SSDT_OVERLAYS

Load custom ACPI SSDT overlay from an EFI variable

Allow loading of an ACPI SSDT overlay from an EFI variable specified
by a kernel command line option.

See Documentation/admin-guide/acpi/ssdt-overlays.rst for more
information.