blob: 4c2d440487ddcd8e23a5e3b0d2dbf071b8557ba9 [file] [log] [blame]
Peter Jones0bb54902015-04-28 18:44:31 -04001What: /sys/firmware/efi/esrt/
2Date: February 2015
3Contact: Peter Jones <pjones@redhat.com>
4Description: Provides userland access to read the EFI System Resource Table
5 (ESRT), a catalog of firmware for which can be updated with
6 the UEFI UpdateCapsule mechanism described in section 7.5 of
7 the UEFI Standard.
8Users: fwupdate - https://github.com/rhinstaller/fwupdate
9
10What: /sys/firmware/efi/esrt/fw_resource_count
11Date: February 2015
12Contact: Peter Jones <pjones@redhat.com>
13Description: The number of entries in the ESRT
14
15What: /sys/firmware/efi/esrt/fw_resource_count_max
16Date: February 2015
17Contact: Peter Jones <pjones@redhat.com>
18Description: The maximum number of entries that /could/ be registered
19 in the allocation the table is currently in. This is
20 really only useful to the system firmware itself.
21
22What: /sys/firmware/efi/esrt/fw_resource_version
23Date: February 2015
24Contact: Peter Jones <pjones@redhat.com>
25Description: The version of the ESRT structure provided by the firmware.
26
Mauro Carvalho Chehab3d253b92021-09-16 10:59:54 +020027What: /sys/firmware/efi/esrt/entries/entry<N>/
Peter Jones0bb54902015-04-28 18:44:31 -040028Date: February 2015
29Contact: Peter Jones <pjones@redhat.com>
30Description: Each ESRT entry is identified by a GUID, and each gets a
31 subdirectory under entries/ .
32 example: /sys/firmware/efi/esrt/entries/entry0/
33
Mauro Carvalho Chehab3d253b92021-09-16 10:59:54 +020034What: /sys/firmware/efi/esrt/entries/entry<N>/fw_type
Peter Jones0bb54902015-04-28 18:44:31 -040035Date: February 2015
36Contact: Peter Jones <pjones@redhat.com>
37Description: What kind of firmware entry this is:
Mauro Carvalho Chehab54a19b42020-10-30 08:40:50 +010038
39 == ===============
40 0 Unknown
41 1 System Firmware
42 2 Device Firmware
43 3 UEFI Driver
44 == ===============
Peter Jones0bb54902015-04-28 18:44:31 -040045
Mauro Carvalho Chehab3d253b92021-09-16 10:59:54 +020046What: /sys/firmware/efi/esrt/entries/entry<N>/fw_class
Peter Jones0bb54902015-04-28 18:44:31 -040047Date: February 2015
48Contact: Peter Jones <pjones@redhat.com>
49Description: This is the entry's guid, and will match the directory name.
50
Mauro Carvalho Chehab3d253b92021-09-16 10:59:54 +020051What: /sys/firmware/efi/esrt/entries/entry<N>/fw_version
Peter Jones0bb54902015-04-28 18:44:31 -040052Date: February 2015
53Contact: Peter Jones <pjones@redhat.com>
54Description: The version of the firmware currently installed. This is a
55 32-bit unsigned integer.
56
Mauro Carvalho Chehab3d253b92021-09-16 10:59:54 +020057What: /sys/firmware/efi/esrt/entries/entry<N>/lowest_supported_fw_version
Peter Jones0bb54902015-04-28 18:44:31 -040058Date: February 2015
59Contact: Peter Jones <pjones@redhat.com>
60Description: The lowest version of the firmware that can be installed.
61
Mauro Carvalho Chehab3d253b92021-09-16 10:59:54 +020062What: /sys/firmware/efi/esrt/entries/entry<N>/capsule_flags
Peter Jones0bb54902015-04-28 18:44:31 -040063Date: February 2015
64Contact: Peter Jones <pjones@redhat.com>
65Description: Flags that must be passed to UpdateCapsule()
66
Mauro Carvalho Chehab3d253b92021-09-16 10:59:54 +020067What: /sys/firmware/efi/esrt/entries/entry<N>/last_attempt_version
Peter Jones0bb54902015-04-28 18:44:31 -040068Date: February 2015
69Contact: Peter Jones <pjones@redhat.com>
70Description: The last firmware version for which an update was attempted.
71
Mauro Carvalho Chehab3d253b92021-09-16 10:59:54 +020072What: /sys/firmware/efi/esrt/entries/entry<N>/last_attempt_status
Peter Jones0bb54902015-04-28 18:44:31 -040073Date: February 2015
74Contact: Peter Jones <pjones@redhat.com>
75Description: The result of the last firmware update attempt for the
76 firmware resource entry.
Mauro Carvalho Chehab54a19b42020-10-30 08:40:50 +010077
78 == ======================
79 0 Success
80 1 Insufficient resources
81 2 Incorrect version
82 3 Invalid format
83 4 Authentication error
84 5 AC power event
85 6 Battery power event
86 == ======================
Peter Jones0bb54902015-04-28 18:44:31 -040087