요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/event_source/devices/<dev>/format
2
Date: January 2012
3
KernelVersion: 3.3
4
Contact: Jiri Olsa <[email protected]>
5
Description:
6
Attribute group to describe the magic bits that go into
7
perf_event_attr::config[012] for a particular pmu.
8
Each attribute of this group defines the 'hardware' bitmask
9
we want to export, so that userspace can deal with sane
10
name/value pairs.
12
Userspace must be prepared for the possibility that attributes
13
define overlapping bit ranges. For example::
15
attr1 = 'config:0-23'
16
attr2 = 'config:0-7'
17
attr3 = 'config:12-35'
19
Example: 'config1:1,6-10,44'
20
Defines contents of attribute that occupies bits 1,6-10,44 of
21
perf_event_attr::config1.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
perf_event_attr config bitmask format
1-21| 항목 | 전문 번역 |
|---|---|
| What | /sys/bus/event_source/devices/<dev>/format |
| Date | 2012년 1월 |
| KernelVersion | 3.3 |
| Contact | Jiri Olsa <[email protected]> |
| Description | 특정 PMU의 perf_event_attr::config[012]에 들어가는 magic bits를 설명하는 attribute group입니다. 이 group의 각 attribute는 export할 hardware bitmask를 정의하여 userspace가 이해하기 쉬운 name/value pairs를 다룰 수 있게 합니다. |
Userspace는 attributes가 overlapping bit ranges를 정의할 가능성에 대비해야 합니다.
attr1 = 'config:0-23'
attr2 = 'config:0-7'
attr3 = 'config:12-35'다음 example은 attribute 내용이 perf_event_attr::config1의 bits 1, 6-10, 44를 차지함을 정의합니다.
config1:1,6-10,44
PMU term bitmask definitions
sysfs-bus-event_source-devices-format:1-21format group의 각 attribute는 userspace용 name/value pair를 config[012] hardware bits에 mapping하며 서로 겹치는 ranges도 허용합니다.