0001 What: /sys/firmware/efi/esrt/
0002 Date: February 2015
0003 Contact: Peter Jones <pjones@redhat.com>
0004 Description: Provides userland access to read the EFI System Resource Table
0005 (ESRT), a catalog of firmware for which can be updated with
0006 the UEFI UpdateCapsule mechanism described in section 7.5 of
0007 the UEFI Standard.
0008 Users: fwupdate - https://github.com/rhinstaller/fwupdate
0009
0010 What: /sys/firmware/efi/esrt/fw_resource_count
0011 Date: February 2015
0012 Contact: Peter Jones <pjones@redhat.com>
0013 Description: The number of entries in the ESRT
0014
0015 What: /sys/firmware/efi/esrt/fw_resource_count_max
0016 Date: February 2015
0017 Contact: Peter Jones <pjones@redhat.com>
0018 Description: The maximum number of entries that /could/ be registered
0019 in the allocation the table is currently in. This is
0020 really only useful to the system firmware itself.
0021
0022 What: /sys/firmware/efi/esrt/fw_resource_version
0023 Date: February 2015
0024 Contact: Peter Jones <pjones@redhat.com>
0025 Description: The version of the ESRT structure provided by the firmware.
0026
0027 What: /sys/firmware/efi/esrt/entries/entry<N>/
0028 Date: February 2015
0029 Contact: Peter Jones <pjones@redhat.com>
0030 Description: Each ESRT entry is identified by a GUID, and each gets a
0031 subdirectory under entries/ .
0032 example: /sys/firmware/efi/esrt/entries/entry0/
0033
0034 What: /sys/firmware/efi/esrt/entries/entry<N>/fw_type
0035 Date: February 2015
0036 Contact: Peter Jones <pjones@redhat.com>
0037 Description: What kind of firmware entry this is:
0038
0039 == ===============
0040 0 Unknown
0041 1 System Firmware
0042 2 Device Firmware
0043 3 UEFI Driver
0044 == ===============
0045
0046 What: /sys/firmware/efi/esrt/entries/entry<N>/fw_class
0047 Date: February 2015
0048 Contact: Peter Jones <pjones@redhat.com>
0049 Description: This is the entry's guid, and will match the directory name.
0050
0051 What: /sys/firmware/efi/esrt/entries/entry<N>/fw_version
0052 Date: February 2015
0053 Contact: Peter Jones <pjones@redhat.com>
0054 Description: The version of the firmware currently installed. This is a
0055 32-bit unsigned integer.
0056
0057 What: /sys/firmware/efi/esrt/entries/entry<N>/lowest_supported_fw_version
0058 Date: February 2015
0059 Contact: Peter Jones <pjones@redhat.com>
0060 Description: The lowest version of the firmware that can be installed.
0061
0062 What: /sys/firmware/efi/esrt/entries/entry<N>/capsule_flags
0063 Date: February 2015
0064 Contact: Peter Jones <pjones@redhat.com>
0065 Description: Flags that must be passed to UpdateCapsule()
0066
0067 What: /sys/firmware/efi/esrt/entries/entry<N>/last_attempt_version
0068 Date: February 2015
0069 Contact: Peter Jones <pjones@redhat.com>
0070 Description: The last firmware version for which an update was attempted.
0071
0072 What: /sys/firmware/efi/esrt/entries/entry<N>/last_attempt_status
0073 Date: February 2015
0074 Contact: Peter Jones <pjones@redhat.com>
0075 Description: The result of the last firmware update attempt for the
0076 firmware resource entry.
0077
0078 == ======================
0079 0 Success
0080 1 Insufficient resources
0081 2 Incorrect version
0082 3 Invalid format
0083 4 Authentication error
0084 5 AC power event
0085 6 Battery power event
0086 == ======================
0087
