linux-imx/Documentation/ABI/testing/sysfs-firmware-efi-esrt
Mauro Carvalho Chehab 3d253b9912 ABI: sysfs-firmware-efi-esrt: use wildcards on What definitions
An "N" upper letter is not a wildcard, nor can easily be identified
by script, specially since the USB sysfs define things like.
bNumInterfaces. Use, instead, <N>, in order to let script/get_abi.pl
to convert it into a Regex.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/44f63335333d019490297903609a8a1754a66183.1631782432.git.mchehab+huawei@kernel.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2021-09-21 18:31:17 +02:00

2.9 KiB

What: /sys/firmware/efi/esrt/ Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: Provides userland access to read the EFI System Resource Table (ESRT), a catalog of firmware for which can be updated with the UEFI UpdateCapsule mechanism described in section 7.5 of the UEFI Standard. Users: fwupdate - https://github.com/rhinstaller/fwupdate

What: /sys/firmware/efi/esrt/fw_resource_count Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: The number of entries in the ESRT

What: /sys/firmware/efi/esrt/fw_resource_count_max Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: The maximum number of entries that /could/ be registered in the allocation the table is currently in. This is really only useful to the system firmware itself.

What: /sys/firmware/efi/esrt/fw_resource_version Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: The version of the ESRT structure provided by the firmware.

What: /sys/firmware/efi/esrt/entries/entry/ Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: Each ESRT entry is identified by a GUID, and each gets a subdirectory under entries/ . example: /sys/firmware/efi/esrt/entries/entry0/

What: /sys/firmware/efi/esrt/entries/entry/fw_type Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: What kind of firmware entry this is:

	==  ===============
	0   Unknown
	1   System Firmware
	2   Device Firmware
	3   UEFI Driver
	==  ===============

What: /sys/firmware/efi/esrt/entries/entry/fw_class Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: This is the entry's guid, and will match the directory name.

What: /sys/firmware/efi/esrt/entries/entry/fw_version Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: The version of the firmware currently installed. This is a 32-bit unsigned integer.

What: /sys/firmware/efi/esrt/entries/entry/lowest_supported_fw_version Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: The lowest version of the firmware that can be installed.

What: /sys/firmware/efi/esrt/entries/entry/capsule_flags Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: Flags that must be passed to UpdateCapsule()

What: /sys/firmware/efi/esrt/entries/entry/last_attempt_version Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: The last firmware version for which an update was attempted.

What: /sys/firmware/efi/esrt/entries/entry/last_attempt_status Date: February 2015 Contact: Peter Jones pjones@redhat.com Description: The result of the last firmware update attempt for the firmware resource entry.

	==  ======================
	0   Success
	1   Insufficient resources
	2   Incorrect version
	3   Invalid format
	4   Authentication error
	5   AC power event
	6   Battery power event
	==  ======================