요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Conditional MCTP, watcher, and RMID attributes
sysfs-class-intel_pmt-features:37-64Out-of-band MCTP size, watcher 최소 period와 logical entity별 resource usage를 추적하는 RMID 수를 노출합니다.
Directory tree and tracing caps examples
sysfs-class-intel_pmt-features:65-134PCI BDF 0000:00:03.1의 조건부 file 조합과 tracing feature capability availability를 예시로 보여 줍니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/class/intel_pmt/features-<PCI BDF>/
2
Date: 2025-04-24
3
KernelVersion: 6.16
4
Contact: [email protected]
5
Description:
6
The `features-<PCI BDF>/` directory represents the "features"
7
capability exposed by Intel PMT (Platform Monitoring Technology)
8
for the given PCI device.
10
Each directory corresponds to a PMT feature and contains
11
attributes describing the available telemetry, monitoring, or
12
control functionalities.
14
Directory Structure:
16
/sys/class/intel_pmt/features-<PCI BDF>/
17
├── accelerator_telemetry/ # Per-accelerator telemetry data
18
├── crash_log/ # Contains system crash telemetry logs
19
├── per_core_environment_telemetry/ # Environmental telemetry per core
20
├── per_core_performance_telemetry/ # Performance telemetry per core
21
├── per_rmid_energy_telemetry/ # Energy telemetry for RMIDs
22
├── per_rmid_perf_telemetry/ # Performance telemetry for RMIDs
23
├── tpmi_control/ # TPMI-related controls and telemetry
24
├── tracing/ # PMT tracing features
25
└── uncore_telemetry/ # Uncore telemetry data
27
Common Files (Present in all feature directories):
29
caps
30
- Read-only
31
- Lists available capabilities for this feature.
33
guids
34
- Read-only
35
- Lists GUIDs associated with this feature.
37
Additional Attributes (Conditional Presence):
39
max_command_size
40
- Read-only
41
- Present if the feature supports out-of-band MCTP access.
42
- Maximum supported MCTP command size for out-of-band PMT access (bytes).
44
max_stream_size
45
- Read-only
46
- Present if the feature supports out-of-band MCTP access.
47
- Maximum supported MCTP stream size (bytes).
49
min_watcher_period_ms
50
- Read-only
51
- Present if the feature supports the watcher API.
52
The watcher API provides a writable control interface that allows user
53
configuration of monitoring behavior, such as setting the sampling or
54
reporting interval.
55
- Minimum supported time period for the watcher interface (milliseconds).
57
num_rmids
58
- Read-only
59
- Present if the feature supports RMID (Resource Monitoring ID) telemetry.
60
RMIDs are identifiers used by hardware to track and report resource usage,
61
such as memory bandwidth or energy consumption, on a per-logical-entity
62
basis (e.g., per core, thread, or process group).
63
- Maximum number of RMIDs tracked simultaneously.
65
Example:
66
For a device with PCI BDF `0000:00:03.1`, the directory tree could look like:
68
/sys/class/intel_pmt/features-0000:00:03.1/
69
├── accelerator_telemetry/
70
│ ├── caps
71
│ ├── guids
72
│ ├── max_command_size
73
│ ├── max_stream_size
74
│ ├── min_watcher_period_ms
75
├── crash_log/
76
│ ├── caps
77
│ ├── guids
78
│ ├── max_command_size
79
│ ├── max_stream_size
80
├── per_core_environment_telemetry/
81
│ ├── caps
82
│ ├── guids
83
│ ├── max_command_size
84
│ ├── max_stream_size
85
│ ├── min_watcher_period_ms
86
├── per_rmid_energy_telemetry/
87
│ ├── caps
88
│ ├── guids
89
│ ├── max_command_size
90
│ ├── max_stream_size
91
│ ├── min_watcher_period_ms
92
│ ├── num_rmids
93
├── tpmi_control/
94
│ ├── caps
95
│ ├── guids
96
├── tracing/
97
│ ├── caps
98
│ ├── guids
99
├── uncore_telemetry/
100
│ ├── caps
101
│ ├── guids
102
│ ├── max_command_size
103
│ ├── max_stream_size
104
│ ├── min_watcher_period_ms
106
Notes:
107
- Some attributes are only present if the corresponding feature supports
108
the capability (e.g., `max_command_size` for MCTP-capable features).
109
- Features supporting RMIDs include `num_rmids`.
110
- Features supporting the watcher API include `min_watcher_period_ms`.
111
- The `caps` file provides additional information about the functionality
112
of the feature.
114
Example 'caps' content for the 'tracing' feature:
116
/sys/class/intel_pmt/features-0000:00:03.1/
117
├── tracing/
118
│ ├── caps
120
telemetry Available: No
121
watcher Available: Yes
122
crashlog Available: No
123
streaming Available: No
124
threashold Available: No
125
window Available: No
126
config Available: Yes
127
tracing Available: No
128
inband Available: Yes
129
oob Available: Yes
130
secure_chan Available: No
131
pmt_sp Available: Yes
132
pmt_sp_policy Available: Yes
133
mailbox Available: Yes
134
bios_lock Available: Yes
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Intel PMT feature capability directory
1-134| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/intel_pmt/features-<PCI BDF>/ |
| Date | 2025-04-24 |
| KernelVersion | 6.16 |
| Contact | [email protected] |
| Description | features-<PCI BDF> directory는 해당 PCI device가 Intel Platform Monitoring Technology(PMT)로 노출하는 "features" capability를 나타냅니다. 각 하위 directory는 PMT feature에 대응하며 사용 가능한 telemetry·monitoring·control 기능을 설명하는 attribute를 담습니다. |
Directory기능
accelerator_telemetryAccelerator별 telemetry data
crash_logSystem crash telemetry log
per_core_environment_telemetryCore별 environment telemetry
per_core_performance_telemetryCore별 performance telemetry
per_rmid_energy_telemetryRMID별 energy telemetry
per_rmid_perf_telemetryRMID별 performance telemetry
tpmi_controlTPMI 관련 control·telemetry
tracingPMT tracing feature
uncore_telemetryUncore telemetry data
원문 directory tree의 feature와 역할을 구조화했습니다.
FileAccess설명
capsROFeature에서 사용할 수 있는 capability 목록
guidsROFeature와 연결된 GUID 목록
모든 feature가 제공하는 read-only metadata입니다.
Attribute표시 조건설명
max_command_sizeOut-of-band MCTPOOB PMT access의 최대 MCTP command 크기(byte)
max_stream_sizeOut-of-band MCTP최대 MCTP stream 크기(byte)
min_watcher_period_msWatcher APISampling·reporting 동작을 구성하는 watcher interface의 최소 period(ms)
num_rmidsRMID telemetry동시에 추적하는 최대 Resource Monitoring ID 수
대응 capability를 지원할 때만 나타나는 read-only attribute입니다.
RMID는 core·thread·process group 같은 logical entity별 memory bandwidth나 energy consumption을 hardware가 추적·보고할 때 사용하는 identifier입니다.
Feature예시에 표시된 file
accelerator_telemetrycaps, guids, max_command_size, max_stream_size, min_watcher_period_ms
crash_logcaps, guids, max_command_size, max_stream_size
per_core_environment_telemetrycaps, guids, max_command_size, max_stream_size, min_watcher_period_ms
per_rmid_energy_telemetrycaps, guids, max_command_size, max_stream_size, min_watcher_period_ms, num_rmids
tpmi_controlcaps, guids
tracingcaps, guids
uncore_telemetrycaps, guids, max_command_size, max_stream_size, min_watcher_period_ms
원문 예시에서 각 feature directory에 나타난 file을 그대로 정리했습니다.
일부 attribute는 feature가 대응 capability를 지원할 때만 존재합니다. MCTP capable feature에는 max_command_size가, RMID feature에는 num_rmids가, watcher API feature에는 min_watcher_period_ms가 포함됩니다. caps file은 feature 기능에 관한 추가 정보를 제공합니다.
CapabilityAvailable
telemetryNo
watcherYes
crashlogNo
streamingNo
threasholdNo
windowNo
configYes
tracingNo
inbandYes
oobYes
secure_chanNo
pmt_spYes
pmt_sp_policyYes
mailboxYes
bios_lockYes
원문 `caps` 출력의 capability 이름과 Available 값을 보존합니다.
Feature directories and common metadata
sysfs-class-intel_pmt-features:1-36Telemetry·crash log·TPMI·tracing·uncore feature를 directory로 나누고 caps·guids를 공통 제공하는 구조입니다.