1What:		/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
27What:		/sys/firmware/efi/esrt/entries/entry$N/
28Date:		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
34What:		/sys/firmware/efi/esrt/entries/entry$N/fw_type
35Date:		February 2015
36Contact:	Peter Jones <pjones@redhat.com>
37Description:	What kind of firmware entry this is:
38
39		==  ===============
40		0   Unknown
41		1   System Firmware
42		2   Device Firmware
43		3   UEFI Driver
44		==  ===============
45
46What:		/sys/firmware/efi/esrt/entries/entry$N/fw_class
47Date:		February 2015
48Contact:	Peter Jones <pjones@redhat.com>
49Description:	This is the entry's guid, and will match the directory name.
50
51What:		/sys/firmware/efi/esrt/entries/entry$N/fw_version
52Date:		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
57What:		/sys/firmware/efi/esrt/entries/entry$N/lowest_supported_fw_version
58Date:		February 2015
59Contact:	Peter Jones <pjones@redhat.com>
60Description:	The lowest version of the firmware that can be installed.
61
62What:		/sys/firmware/efi/esrt/entries/entry$N/capsule_flags
63Date:		February 2015
64Contact:	Peter Jones <pjones@redhat.com>
65Description:	Flags that must be passed to UpdateCapsule()
66
67What:		/sys/firmware/efi/esrt/entries/entry$N/last_attempt_version
68Date:		February 2015
69Contact:	Peter Jones <pjones@redhat.com>
70Description:	The last firmware version for which an update was attempted.
71
72What:		/sys/firmware/efi/esrt/entries/entry$N/last_attempt_status
73Date:		February 2015
74Contact:	Peter Jones <pjones@redhat.com>
75Description:	The result of the last firmware update attempt for the
76		firmware resource entry.
77
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		==  ======================
87
88