요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/kernel/debug/msi-wmi-platform-<wmi_device_name>/*
2
Date: April 2024
3
KernelVersion: 6.10
4
Contact: Armin Wolf <[email protected]>
5
Description:
6
This file allows to execute the associated WMI method with the same name.
8
To start the execution, write a buffer containing the method arguments
9
at file offset 0. Partial writes or writes at a different offset are not
10
supported.
12
The buffer returned by the WMI method can then be read from the file.
14
See Documentation/wmi/devices/msi-wmi-platform.rst for details.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
MSI WMI method 실행 interface
1-14| 항목 | 내용 |
|---|---|
| What | /sys/kernel/debug/msi-wmi-platform-<wmi_device_name>/* |
| Date | 2024년 4월 |
| KernelVersion | 6.10 |
| Contact | Armin Wolf <[email protected]> |
| Description | 각 파일은 그 파일과 같은 이름에 연결된 WMI method를 실행할 수 있게 합니다. |
실행을 시작하려면 method argument가 든 buffer를 file offset 0에 씁니다. Partial write 또는 다른 offset에 대한 write는 지원하지 않습니다.
그런 다음 WMI method가 반환한 buffer를 이 파일에서 읽을 수 있습니다.
자세한 내용은 Documentation/wmi/devices/msi-wmi-platform.rst를 참조하십시오.
Select same-name debugfs file→Write complete argument buffer at offset 0→Execute associated WMI method→Read returned buffer
Partial write or nonzero offset→Unsupported
파일명은 method를 선택하고, offset 0의 완전한 buffer가 호출 인자가 되며 같은 파일의 read가 반환값을 전달한다.
파일 기반 WMI method 실행
debugfs-msi-wmi-platform:1-14각 파일은 같은 이름의 WMI method에 대응합니다. Offset 0에 전체 argument buffer를 쓴 뒤 method 반환 buffer를 읽으며 partial write와 다른 offset write는 지원하지 않습니다.