← Documents Documentation/ABI/testing/sysfs-firmware-efi-esrt GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

EFI System Resource Table sysfs ABI

UpdateCapsule 대상 firmware resources, installed·minimum versions, capsule flags와 마지막 update 결과를 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-firmware-efi-esrt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

Firmware resource catalog

sysfs-firmware-efi-esrt:1-33

ESRT table metadata와 GUID별 entry directories를 통해 userspace updater가 update 가능한 firmware resources를 발견합니다.

Per-resource update metadata

sysfs-firmware-efi-esrt:34-87

각 resource는 type, class GUID, version floor, capsule flags와 마지막 시도의 version·status를 제공합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/firmware/efi/esrt/
2 Date: February 2015
3 Contact: Peter Jones <[email protected]>
4 Description: 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.
8 Users: fwupdate - https://github.com/rhinstaller/fwupdate
9
10 What: /sys/firmware/efi/esrt/fw_resource_count
11 Date: February 2015
12 Contact: Peter Jones <[email protected]>
13 Description: The number of entries in the ESRT
14
15 What: /sys/firmware/efi/esrt/fw_resource_count_max
16 Date: February 2015
17 Contact: Peter Jones <[email protected]>
18 Description: 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
22 What: /sys/firmware/efi/esrt/fw_resource_version
23 Date: February 2015
24 Contact: Peter Jones <[email protected]>
25 Description: The version of the ESRT structure provided by the firmware.
26
27 What: /sys/firmware/efi/esrt/entries/entry<N>/
28 Date: February 2015
29 Contact: Peter Jones <[email protected]>
30 Description: 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
34 What: /sys/firmware/efi/esrt/entries/entry<N>/fw_type
35 Date: February 2015
36 Contact: Peter Jones <[email protected]>
37 Description: 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
46 What: /sys/firmware/efi/esrt/entries/entry<N>/fw_class
47 Date: February 2015
48 Contact: Peter Jones <[email protected]>
49 Description: This is the entry's guid, and will match the directory name.
50
51 What: /sys/firmware/efi/esrt/entries/entry<N>/fw_version
52 Date: February 2015
53 Contact: Peter Jones <[email protected]>
54 Description: The version of the firmware currently installed. This is a
55 32-bit unsigned integer.
56
57 What: /sys/firmware/efi/esrt/entries/entry<N>/lowest_supported_fw_version
58 Date: February 2015
59 Contact: Peter Jones <[email protected]>
60 Description: The lowest version of the firmware that can be installed.
61
62 What: /sys/firmware/efi/esrt/entries/entry<N>/capsule_flags
63 Date: February 2015
64 Contact: Peter Jones <[email protected]>
65 Description: Flags that must be passed to UpdateCapsule()
66
67 What: /sys/firmware/efi/esrt/entries/entry<N>/last_attempt_version
68 Date: February 2015
69 Contact: Peter Jones <[email protected]>
70 Description: The last firmware version for which an update was attempted.
71
72 What: /sys/firmware/efi/esrt/entries/entry<N>/last_attempt_status
73 Date: February 2015
74 Contact: Peter Jones <[email protected]>
75 Description: 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

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

EFI System Resource Table

1-9
항목한국어 전문 번역
What/sys/firmware/efi/esrt/
Date2015년 2월
ContactPeter Jones <[email protected]>
DescriptionUserspace가 EFI System Resource Table(ESRT)을 읽도록 합니다. ESRT는 UEFI Standard section 7.5의 `UpdateCapsule` mechanism으로 update할 수 있는 firmware resource catalog입니다.
Usersfwupdate - https://github.com/rhinstaller/fwupdate
ESRT firmware-update discovery
Firmware publishes ESRTKernel exposes ESRT in sysfsUserspace discovers updateable resourcesUpdater uses UEFI UpdateCapsule mechanism

Firmware resource catalog에서 capsule update로 이어지는 흐름입니다.

ESRT resource count

10-14
항목한국어 전문 번역
What/sys/firmware/efi/esrt/fw_resource_count
Date2015년 2월
ContactPeter Jones <[email protected]>
DescriptionESRT에 들어 있는 entry 수입니다.

ESRT allocation capacity

15-21
항목한국어 전문 번역
What/sys/firmware/efi/esrt/fw_resource_count_max
Date2015년 2월
ContactPeter Jones <[email protected]>
Description현재 table allocation에 등록할 수 있는 최대 entry 수입니다. 이 값은 사실상 system firmware 자체에만 유용합니다.
ESRT table-level counters
FieldMeaning
fw_resource_countEntries currently in ESRT
fw_resource_count_maxMaximum entries supported by current allocation

현재 사용량과 allocation capacity의 차이입니다.

ESRT structure version

22-26
항목한국어 전문 번역
What/sys/firmware/efi/esrt/fw_resource_version
Date2015년 2월
ContactPeter Jones <[email protected]>
DescriptionFirmware가 제공한 ESRT structure의 version입니다.

ESRT GUID entry directories

27-33
항목한국어 전문 번역
What/sys/firmware/efi/esrt/entries/entry<N>/
Date2015년 2월
ContactPeter Jones <[email protected]>
Description각 ESRT entry는 GUID로 식별하며 `entries/` 아래에 각각 subdirectory를 둡니다. 예시는 `/sys/firmware/efi/esrt/entries/entry0/`입니다.
ESRT entry attributes
AttributeMeaning
fw_typeFirmware resource kind
fw_classEntry GUID
fw_versionInstalled version
lowest_supported_fw_versionMinimum installable version
capsule_flagsFlags for UpdateCapsule()
last_attempt_versionVersion used in last attempt
last_attempt_statusResult of last attempt

각 GUID resource directory에서 제공하는 update metadata입니다.

ESRT firmware resource type

34-45
항목한국어 전문 번역
What/sys/firmware/efi/esrt/entries/entry<N>/fw_type
Date2015년 2월
ContactPeter Jones <[email protected]>
Description해당 ESRT entry가 나타내는 firmware 종류입니다. 값 0은 Unknown, 1은 System Firmware, 2는 Device Firmware, 3은 UEFI Driver입니다.
ESRT fw_type values
ValueFirmware kind
0Unknown
1System Firmware
2Device Firmware
3UEFI Driver

원문의 numeric firmware-kind table을 구조화했습니다.

ESRT firmware class GUID

46-50
항목한국어 전문 번역
What/sys/firmware/efi/esrt/entries/entry<N>/fw_class
Date2015년 2월
ContactPeter Jones <[email protected]>
DescriptionEntry의 GUID이며 해당 entry directory name과 일치합니다.

Installed firmware version

51-56
항목한국어 전문 번역
What/sys/firmware/efi/esrt/entries/entry<N>/fw_version
Date2015년 2월
ContactPeter Jones <[email protected]>
Description현재 설치된 firmware version입니다. 값은 32-bit unsigned integer입니다.

Lowest supported firmware version

57-61
항목한국어 전문 번역
What/sys/firmware/efi/esrt/entries/entry<N>/lowest_supported_fw_version
Date2015년 2월
ContactPeter Jones <[email protected]>
Description설치할 수 있는 가장 낮은 firmware version입니다.

UpdateCapsule flags

62-66
항목한국어 전문 번역
What/sys/firmware/efi/esrt/entries/entry<N>/capsule_flags
Date2015년 2월
ContactPeter Jones <[email protected]>
Description`UpdateCapsule()`에 반드시 전달해야 하는 flags입니다.

Last attempted firmware version

67-71
항목한국어 전문 번역
What/sys/firmware/efi/esrt/entries/entry<N>/last_attempt_version
Date2015년 2월
ContactPeter Jones <[email protected]>
Description가장 최근에 update를 시도한 firmware version입니다.

Last firmware update status

72-87
항목한국어 전문 번역
What/sys/firmware/efi/esrt/entries/entry<N>/last_attempt_status
Date2015년 2월
ContactPeter Jones <[email protected]>
Description해당 firmware resource entry에 대해 마지막으로 시도한 firmware update의 결과입니다. 0은 Success, 1은 Insufficient resources, 2는 Incorrect version, 3은 Invalid format, 4는 Authentication error, 5는 AC power event, 6은 Battery power event를 뜻합니다.
ESRT last_attempt_status values
ValueResult
0Success
1Insufficient resources
2Incorrect version
3Invalid format
4Authentication error
5AC power event
6Battery power event

원문의 update-result table을 구조화했습니다.