요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/firmware/gsmi
2
Date: March 2011
3
Contact: Mike Waychison <[email protected]>
4
Description:
5
Some servers used internally at Google have firmware
6
that provides callback functionality via explicit SMI
7
triggers. Some of the callbacks are similar to those
8
provided by the EFI runtime services page, but due to
9
historical reasons this different entry-point has been
10
used.
12
The gsmi driver implements the kernel's abstraction for
13
these firmware callbacks. Currently, this functionality
14
is limited to handling the system event log and getting
15
access to EFI-style variables stored in nvram.
17
Layout:
19
/sys/firmware/gsmi/vars:
21
This directory has the same layout (and
22
underlying implementation as /sys/firmware/efi/vars.
23
See `Documentation/ABI/*/sysfs-firmware-efi-vars`
24
for more information on how to interact with
25
this structure.
27
/sys/firmware/gsmi/append_to_eventlog - write-only:
29
This file takes a binary blob and passes it onto
30
the firmware to be timestamped and appended to
31
the system eventlog. The binary format is
32
interpreted by the firmware and may change from
33
platform to platform. The only kernel-enforced
34
requirement is that the blob be prefixed with a
35
32bit host-endian type used as part of the
36
firmware call.
38
/sys/firmware/gsmi/clear_config - write-only:
40
Writing any value to this file will cause the
41
entire firmware configuration to be reset to
42
"factory defaults". Callers should assume that
43
a reboot is required for the configuration to be
44
cleared.
46
/sys/firmware/gsmi/clear_eventlog - write-only:
48
This file is used to clear out a portion/the
49
whole of the system event log. Values written
50
should be values between 1 and 100 inclusive (in
51
ASCII) representing the fraction of the log to
52
clear. Not all platforms support fractional
53
clearing though, and this writes to this file
54
will error out if the firmware doesn't like your
55
submitted fraction.
57
Callers should assume that a reboot is needed
58
for this operation to complete.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Google SMI firmware callbacks
1-58| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/firmware/gsmi |
| Date | 2011년 3월 |
| Contact | Mike Waychison <[email protected]> |
| Description | Google 내부의 일부 servers는 explicit SMI triggers를 통해 callback 기능을 제공하는 firmware를 사용합니다. 일부 callbacks는 EFI runtime services page의 기능과 비슷하지만 역사적 이유로 다른 entry point를 사용합니다. `gsmi` driver는 이 firmware callbacks에 대한 kernel abstraction을 구현하며 현재는 system event log 처리와 NVRAM에 저장된 EFI-style variables 접근으로 범위가 제한됩니다. `/sys/firmware/gsmi/vars`는 `/sys/firmware/efi/vars`와 같은 layout과 underlying implementation을 사용하므로 상호작용 방법은 `Documentation/ABI/*/sysfs-firmware-efi-vars`를 참조합니다. Write-only `append_to_eventlog`는 firmware가 timestamp를 붙여 system event log에 추가할 binary blob을 받습니다. Binary format은 platform마다 달라질 수 있고 kernel은 blob 앞에 firmware call에 사용하는 32-bit host-endian type을 붙이도록 요구합니다. Write-only `clear_config`에 어떤 값이든 쓰면 전체 firmware configuration을 factory defaults로 reset하며 caller는 완료에 reboot가 필요하다고 가정해야 합니다. Write-only `clear_eventlog`에는 지울 log 비율을 나타내는 ASCII 1부터 100까지의 값을 씁니다. 모든 platform이 fractional clearing을 지원하지는 않으므로 firmware가 비율을 받아들이지 않으면 write가 error로 끝나며, 이 작업도 완료에 reboot가 필요하다고 가정해야 합니다. |
PathAccessOperation
varsEFI-vars layoutRead and manage NVRAM variables
append_to_eventlogWrite-onlyTimestamp and append binary event
clear_configWrite-onlyReset all firmware configuration
clear_eventlogWrite-onlyClear ASCII percentage 1..100
Variables, event append와 destructive write-only controls입니다.
Prefix 32-bit host-endian type→Append platform-specific binary blob→Write to append_to_eventlog→Firmware timestamps and records the event
Kernel이 강제하는 prefix와 platform-specific payload 순서입니다.
SMI callbacks and write-only controls
sysfs-firmware-gsmi:1-58GSMI는 EFI-style variables와 event log를 다루며 destructive clear operations는 firmware 지원과 reboot 요구를 고려해야 합니다.