← Documents Documentation/ABI/testing/sysfs-class-intel_pmt GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Intel Platform Monitoring Technology sysfs ABI

Intel PMT telemetry·crashlog instance의 data mapping, GUID 기반 XML layout, size·offset와 enable·trigger control을 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-class-intel_pmt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

PMT class and telemetry mapping

sysfs-class-intel_pmt:1-54

PCI device id·GUID와 일치하는 XML로 telemetry register layout을 해석하고 telem file을 map·read합니다.

Crashlog buffer metadata

sysfs-class-intel_pmt:56-100

Crash recording instance의 buffer, GUID·size·offset mapping metadata를 제공합니다.

Crashlog enable and trigger

sysfs-class-intel_pmt:102-119

Boolean enable과 trigger 상태 읽기, false clear 및 새 event trigger 동작을 정의합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/class/intel_pmt/
2 Date: October 2020
3 KernelVersion: 5.10
4 Contact: David Box <david.e.box@linux.intel.com>
5 Description:
6 The intel_pmt/ class directory contains information for
7 devices that expose hardware telemetry using Intel Platform
8 Monitoring Technology (PMT)
9
10 What: /sys/class/intel_pmt/telem<x>
11 Date: October 2020
12 KernelVersion: 5.10
13 Contact: David Box <david.e.box@linux.intel.com>
14 Description:
15 The telem<x> directory contains files describing an instance of
16 a PMT telemetry device that exposes hardware telemetry. Each
17 telem<x> directory has an associated telem file. This file
18 may be opened and mapped or read to access the telemetry space
19 of the device. The register layout of the telemetry space is
20 determined from an XML file that matches the PCI device id and
21 GUID for the device.
22
23 What: /sys/class/intel_pmt/telem<x>/telem
24 Date: October 2020
25 KernelVersion: 5.10
26 Contact: David Box <david.e.box@linux.intel.com>
27 Description:
28 (RO) The telemetry data for this telemetry device. This file
29 may be mapped or read to obtain the data.
30
31 What: /sys/class/intel_pmt/telem<x>/guid
32 Date: October 2020
33 KernelVersion: 5.10
34 Contact: David Box <david.e.box@linux.intel.com>
35 Description:
36 (RO) The GUID for this telemetry device. The GUID identifies
37 the version of the XML file for the parent device that is to
38 be used to get the register layout.
39
40 What: /sys/class/intel_pmt/telem<x>/size
41 Date: October 2020
42 KernelVersion: 5.10
43 Contact: David Box <david.e.box@linux.intel.com>
44 Description:
45 (RO) The size of telemetry region in bytes that corresponds to
46 the mapping size for the telem file.
47
48 What: /sys/class/intel_pmt/telem<x>/offset
49 Date: October 2020
50 KernelVersion: 5.10
51 Contact: David Box <david.e.box@linux.intel.com>
52 Description:
53 (RO) The offset of telemetry region in bytes that corresponds to
54 the mapping for the telem file.
55
56 What: /sys/class/intel_pmt/crashlog<x>
57 Date: October 2020
58 KernelVersion: 5.10
59 Contact: Alexander Duyck <alexander.h.duyck@linux.intel.com>
60 Description:
61 The crashlog<x> directory contains files for configuring an
62 instance of a PMT crashlog device that can perform crash data
63 recording. Each crashlog<x> device has an associated crashlog
64 file. This file can be opened and mapped or read to access the
65 resulting crashlog buffer. The register layout for the buffer
66 can be determined from an XML file of specified GUID for the
67 parent device.
68
69 What: /sys/class/intel_pmt/crashlog<x>/crashlog
70 Date: October 2020
71 KernelVersion: 5.10
72 Contact: David Box <david.e.box@linux.intel.com>
73 Description:
74 (RO) The crashlog buffer for this crashlog device. This file
75 may be mapped or read to obtain the data.
76
77 What: /sys/class/intel_pmt/crashlog<x>/guid
78 Date: October 2020
79 KernelVersion: 5.10
80 Contact: Alexander Duyck <alexander.h.duyck@linux.intel.com>
81 Description:
82 (RO) The GUID for this crashlog device. The GUID identifies the
83 version of the XML file for the parent device that should be
84 used to determine the register layout.
85
86 What: /sys/class/intel_pmt/crashlog<x>/size
87 Date: October 2020
88 KernelVersion: 5.10
89 Contact: Alexander Duyck <alexander.h.duyck@linux.intel.com>
90 Description:
91 (RO) The length of the result buffer in bytes that corresponds
92 to the size for the crashlog buffer.
93
94 What: /sys/class/intel_pmt/crashlog<x>/offset
95 Date: October 2020
96 KernelVersion: 5.10
97 Contact: Alexander Duyck <alexander.h.duyck@linux.intel.com>
98 Description:
99 (RO) The offset of the buffer in bytes that corresponds
100 to the mapping for the crashlog device.
101
102 What: /sys/class/intel_pmt/crashlog<x>/enable
103 Date: October 2020
104 KernelVersion: 5.10
105 Contact: Alexander Duyck <alexander.h.duyck@linux.intel.com>
106 Description:
107 (RW) Boolean value controlling if the crashlog functionality
108 is enabled for the crashlog device.
109
110 What: /sys/class/intel_pmt/crashlog<x>/trigger
111 Date: October 2020
112 KernelVersion: 5.10
113 Contact: Alexander Duyck <alexander.h.duyck@linux.intel.com>
114 Description:
115 (RW) Boolean value controlling the triggering of the crashlog
116 device node. When read it provides data on if the crashlog has
117 been triggered. When written to it can be used to either clear
118 the current trigger by writing false, or to trigger a new
119 event if the trigger is not currently set.
120

3. 한국어 전문 번역

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

Intel PMT class directory

1-8
항목한국어 전문 번역
What/sys/class/intel_pmt/
Date2020년 10월
KernelVersion5.10
ContactDavid Box <david.e.box@linux.intel.com>
Descriptionintel_pmt class directory는 Intel Platform Monitoring Technology(PMT)를 사용해 hardware telemetry를 노출하는 device 정보를 담습니다.

PMT telemetry instance

10-21
항목한국어 전문 번역
What/sys/class/intel_pmt/telem<x>
Date2020년 10월
KernelVersion5.10
ContactDavid Box <david.e.box@linux.intel.com>
Descriptiontelem<x> directory는 hardware telemetry를 노출하는 PMT telemetry device instance를 설명하는 file을 담습니다. 각 directory에는 대응 telem file이 있으며, 이 file을 open한 뒤 map하거나 읽어 device telemetry space에 접근할 수 있습니다. Telemetry space의 register layout은 device의 PCI device id와 GUID에 맞는 XML file로 결정합니다.
PMT telemetry instance files
File역할
telemMap 또는 read하는 telemetry data
guidRegister layout XML version 식별
sizeMapping size(byte)
offsetTelemetry region mapping offset(byte)

Telemetry mapping과 register layout 해석에 필요한 file입니다.

Telemetry data mapping

23-29
항목한국어 전문 번역
What/sys/class/intel_pmt/telem<x>/telem
Date2020년 10월
KernelVersion5.10
ContactDavid Box <david.e.box@linux.intel.com>
DescriptionRead-only telemetry data입니다. File을 map하거나 읽어 data를 가져올 수 있습니다.

Telemetry layout GUID

31-38
항목한국어 전문 번역
What/sys/class/intel_pmt/telem<x>/guid
Date2020년 10월
KernelVersion5.10
ContactDavid Box <david.e.box@linux.intel.com>
DescriptionRead-only telemetry device GUID입니다. Parent device의 register layout을 얻는 데 사용할 XML file version을 식별합니다.

Telemetry mapping size

40-46
항목한국어 전문 번역
What/sys/class/intel_pmt/telem<x>/size
Date2020년 10월
KernelVersion5.10
ContactDavid Box <david.e.box@linux.intel.com>
DescriptionRead-only telemetry region 크기(byte)이며 telem file의 mapping size에 대응합니다.

Telemetry mapping offset

48-54
항목한국어 전문 번역
What/sys/class/intel_pmt/telem<x>/offset
Date2020년 10월
KernelVersion5.10
ContactDavid Box <david.e.box@linux.intel.com>
DescriptionRead-only telemetry region offset(byte)이며 telem file mapping에 대응합니다.

PMT crashlog instance

56-67
항목한국어 전문 번역
What/sys/class/intel_pmt/crashlog<x>
Date2020년 10월
KernelVersion5.10
ContactAlexander Duyck <alexander.h.duyck@linux.intel.com>
Descriptioncrashlog<x> directory는 crash data recording을 수행할 수 있는 PMT crashlog device instance를 구성하는 file을 담습니다. 각 device에는 대응 crashlog file이 있으며, open한 뒤 map하거나 읽어 결과 buffer에 접근할 수 있습니다. Buffer register layout은 parent device에 대해 지정된 GUID의 XML file로 결정할 수 있습니다.
PMT crashlog instance files
FileAccess역할
crashlogROMap 또는 read하는 crashlog buffer
guidRORegister layout XML version
sizeROResult buffer length(byte)
offsetROBuffer mapping offset(byte)
enableRWCrashlog 기능 enable
triggerRWTrigger 상태 확인·clear·새 event trigger

Crash data mapping metadata와 동작 control입니다.

Crashlog buffer mapping

69-75
항목한국어 전문 번역
What/sys/class/intel_pmt/crashlog<x>/crashlog
Date2020년 10월
KernelVersion5.10
ContactDavid Box <david.e.box@linux.intel.com>
DescriptionRead-only crashlog buffer입니다. File을 map하거나 읽어 data를 가져올 수 있습니다.

Crashlog layout GUID

77-84
항목한국어 전문 번역
What/sys/class/intel_pmt/crashlog<x>/guid
Date2020년 10월
KernelVersion5.10
ContactAlexander Duyck <alexander.h.duyck@linux.intel.com>
DescriptionRead-only crashlog device GUID입니다. Register layout을 결정할 때 사용할 parent device XML file version을 식별합니다.

Crashlog result size

86-92
항목한국어 전문 번역
What/sys/class/intel_pmt/crashlog<x>/size
Date2020년 10월
KernelVersion5.10
ContactAlexander Duyck <alexander.h.duyck@linux.intel.com>
DescriptionRead-only result buffer 길이(byte)이며 crashlog buffer 크기에 대응합니다.

Crashlog mapping offset

94-100
항목한국어 전문 번역
What/sys/class/intel_pmt/crashlog<x>/offset
Date2020년 10월
KernelVersion5.10
ContactAlexander Duyck <alexander.h.duyck@linux.intel.com>
DescriptionRead-only buffer offset(byte)이며 crashlog device mapping에 대응합니다.

Crashlog 기능 enable

102-108
항목한국어 전문 번역
What/sys/class/intel_pmt/crashlog<x>/enable
Date2020년 10월
KernelVersion5.10
ContactAlexander Duyck <alexander.h.duyck@linux.intel.com>
DescriptionCrashlog device의 crashlog 기능 활성 여부를 제어하는 read/write boolean 값입니다.

Crashlog trigger 제어

110-119
항목한국어 전문 번역
What/sys/class/intel_pmt/crashlog<x>/trigger
Date2020년 10월
KernelVersion5.10
ContactAlexander Duyck <alexander.h.duyck@linux.intel.com>
DescriptionCrashlog device node trigger를 제어하는 read/write boolean 값입니다. 읽으면 crashlog가 trigger되었는지 알 수 있습니다. False를 쓰면 현재 trigger를 clear하고, trigger가 설정되지 않은 상태에서 true를 쓰면 새 event를 trigger합니다.