요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
What: /sys/bus/event_source/devices/<pmu>
Date: 2014/02/24
Contact: Linux kernel mailing list <linux-kernel@vger.kernel.org>
Description: Performance Monitoring Unit (<pmu>)
Each <pmu> directory, for a PMU device, is a name
optionally followed by an underscore and then either a
decimal or hexadecimal number. For example, cpu is a
PMU name without a suffix as is intel_bts,
uncore_imc_0 is a PMU name with a 0 numeric suffix,
ddr_pmu_87e1b0000000 is a PMU name with a hex
suffix. The hex suffix must be more than two
characters long to avoid ambiguity with PMUs like the
S390 cpum_cf.
Tools can treat PMUs with the same name that differ by
suffix as instances of the same PMU for the sake of,
for example, opening an event. For example, the PMUs
uncore_imc_free_running_0 and
uncore_imc_free_running_1 have an event data_read;
opening the data_read event on a PMU specified as
uncore_imc_free_running should be treated as opening
the data_read event on PMU uncore_imc_free_running_0
and PMU uncore_imc_free_running_1.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Performance Monitoring Unit directory naming
1-24| 항목 | 전문 번역 |
|---|---|
| What | /sys/bus/event_source/devices/<pmu> |
| Date | 2014/02/24 |
| Contact | Linux kernel mailing list <linux-kernel@vger.kernel.org> |
| Description | Performance Monitoring Unit(<pmu>)입니다. |
PMU device의 각 <pmu> directory는 name과, 선택적으로 그 뒤에 오는 underscore 및 decimal 또는 hexadecimal number로 구성됩니다. 예를 들어 cpu와 intel_bts는 suffix가 없는 PMU name이고, uncore_imc_0은 numeric suffix 0이 있는 PMU name이며, ddr_pmu_87e1b0000000은 hex suffix가 있는 PMU name입니다. S390 cpum_cf 같은 PMU와 모호해지는 것을 피하려면 hex suffix는 두 characters보다 길어야 합니다.
Tools는 name은 같고 suffix만 다른 PMUs를, 예를 들어 event를 open할 때 동일 PMU의 instances로 취급할 수 있습니다. uncore_imc_free_running_0과 uncore_imc_free_running_1에는 data_read event가 있습니다. PMU를 uncore_imc_free_running으로 지정해 data_read event를 open하면 PMU uncore_imc_free_running_0과 uncore_imc_free_running_1 모두에서 data_read를 open하는 것으로 처리해야 합니다.
| Example | 구조 |
|---|---|
| cpu | Suffix 없는 PMU name |
| intel_bts | Suffix 없는 PMU name |
| uncore_imc_0 | Base name + decimal suffix |
| ddr_pmu_87e1b0000000 | Base name + 2자보다 긴 hex suffix |
Tool이 base PMU name으로 event를 열면 suffix가 다른 각 instance의 같은 event를 대상으로 처리할 수 있습니다.
PMU names와 instance suffixes
sysfs-bus-event_source-devices:1-24PMU directory는 name 뒤에 optional underscore와 decimal 또는 2자보다 긴 hexadecimal suffix를 붙이며, tools는 suffix만 다른 names를 동일 PMU의 instances로 취급할 수 있습니다.