← Documents Documentation/ABI/testing/debugfs-tpmi GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Intel TPMI debugfs ABI

Intel TPMI의 PM Feature Structure, TPMI ID별 MMIO memory dump·aligned write, die·CPU Performance Limit Reasons sticky status를 제공하는 debugfs ABI를 설명합니다.

Source pathDocumentation/ABI/testing/debugfs-tpmi
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

PM Feature Structure table

debugfs-tpmi:1-10

pfs_dump는 각 power-management feature의 TPMI ID, entry count·size, offset·VSEC offset, lock·disabled status를 보여 줍니다.

TPMI ID MMIO dump와 write

debugfs-tpmi:12-31

mem_dump는 TPMI ID의 MMIO region을 출력하고 mem_write는 instance,offset,contents 형식으로 4의 배수 offset에 씁니다. Read-only 여부는 hardware가 강제합니다.

Sticky Performance Limit Reasons

debugfs-tpmi:33-40

PLR status는 die와 그 아래 CPU들의 현재 active Performance Limit Reasons를 sticky하게 유지하며 0과 newline을 쓰면 모두 지웁니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/kernel/debug/tpmi-<n>/pfs_dump
2 Date: November 2023
3 KernelVersion: 6.6
4 Contact: srinivas.pandruvada@linux.intel.com
5 Description:
6 The PFS (PM Feature Structure) table, shows details of each power
7 management feature. This includes:
8 tpmi_id, number of entries, entry size, offset, vsec offset, lock status
9 and disabled status.
10 Users: Debugging, any user space test suite
11
12 What: /sys/kernel/debug/tpmi-<n>/tpmi-id-<n>/mem_dump
13 Date: November 2023
14 KernelVersion: 6.6
15 Contact: srinivas.pandruvada@linux.intel.com
16 Description:
17 Shows the memory dump of the MMIO region for a TPMI ID.
18 Users: Debugging, any user space test suite
19
20 What: /sys/kernel/debug/tpmi-<n>/tpmi-id-<n>/mem_write
21 Date: November 2023
22 KernelVersion: 6.6
23 Contact: srinivas.pandruvada@linux.intel.com
24 Description:
25 Allows to write at any offset. It doesn't check for Read/Write access
26 as hardware will not allow to write at read-only memory. This write is
27 at offset multiples of 4. The format is instance,offset,contents.
28 Example:
29 echo 0,0x20,0xff > mem_write
30 echo 1,64,64 > mem_write
31 Users: Debugging, any user space test suite
32
33 What: /sys/kernel/debug/tpmi-<n>/plr/domain<n>/status
34 Date: Aug 2024
35 KernelVersion: 6.11
36 Contact: Tero Kristo <tero.kristo@linux.intel.com>
37 Description:
38 Shows the currently active Performance Limit Reasons for die level and the
39 individual CPUs under the die. The contents of this file are sticky, and
40 clearing all the statuses can be done by writing "0\n" to this file.
41

3. 한국어 전문 번역

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

TPMI PM Feature Structure table

1-10
항목내용
What/sys/kernel/debug/tpmi-<n>/pfs_dump
Date2023년 11월
KernelVersion6.6
Contactsrinivas.pandruvada@linux.intel.com
DescriptionPFS(PM Feature Structure) table은 각 power-management feature의 상세 정보를 보여 줍니다. 여기에는 tpmi_id, entry 수, entry size, offset, vsec offset, lock status, disabled status가 포함됩니다.
UsersDebugging, 모든 user space test suite

TPMI ID MMIO memory 접근

12-31
What전문 번역
/sys/kernel/debug/tpmi-<n>/tpmi-id-<n>/mem_dumpTPMI ID에 해당하는 MMIO region의 memory dump를 보여 줍니다.
/sys/kernel/debug/tpmi-<n>/tpmi-id-<n>/mem_write어떤 offset에도 쓸 수 있게 합니다. Hardware가 read-only memory에 대한 write를 허용하지 않으므로 이 interface는 Read/Write access를 검사하지 않습니다. Offset은 4의 배수여야 합니다. 형식은 instance,offset,contents입니다.

mem_write 예:

echo 0,0x20,0xff > mem_write
echo 1,64,64 > mem_write
공통 항목내용
Date2023년 11월
KernelVersion6.6
Contactsrinivas.pandruvada@linux.intel.com
UsersDebugging, 모든 user space test suite

Die·CPU Performance Limit Reasons

33-40
항목내용
What/sys/kernel/debug/tpmi-<n>/plr/domain<n>/status
Date2024년 8월
KernelVersion6.11
ContactTero Kristo <tero.kristo@linux.intel.com>
DescriptionDie level과 die 아래의 개별 CPU에서 현재 active인 Performance Limit Reasons를 보여 줍니다. 이 파일의 내용은 sticky하며, 이 파일에 "0\n"을 쓰면 모든 status를 지울 수 있습니다.
TPMI feature·memory·PLR debugfs 계층
tpmi-<n>pfs_dumptpmi_id, entries, size, offsets, lock, disabled
tpmi-id-<n>mem_dump MMIOmem_write instance,offset,contents4-byte offset alignment
plr/domain<n>/statusDie and CPU active limit reasonsSticky stateWrite 0 newline to clear all

PFS가 feature 구조를 설명하고 각 TPMI ID의 MMIO를 점검하며 PLR domain은 die와 CPU의 sticky limit reason을 유지한다.