요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Hypervisor 24x7 catalog
sysfs-bus-event_source-devices-hv_24x7:26-48POWER7·8 hypervisor가 제공하는 binary catalog, byte length와 version field를 노출합니다.
System topology와 HCALL CPU mask
sysfs-bus-event_source-devices-hv_24x7:50-76System sockets, chips per socket, cores per chip과 hv-24x7 counter data retrieval HCALL을 수행하도록 지정된 cpumask를 제공합니다.
Firmware event descriptions
sysfs-bus-event_source-devices-hv_24x7:78-98Firmware가 제공하는 short·long event descriptions를 노출하며 file names에는 events directory의 domain suffix가 없습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/event_source/devices/hv_24x7/format
2
Date: September 2020
3
Contact: Linux on PowerPC Developer List <[email protected]>
4
Description: Read-only. Attribute group to describe the magic bits
5
that go into perf_event_attr.config for a particular pmu.
6
(See ABI/testing/sysfs-bus-event_source-devices-format).
8
Each attribute under this group defines a bit range of the
9
perf_event_attr.config. All supported attributes are listed
10
below::
12
chip = "config:16-31"
13
core = "config:16-31"
14
domain = "config:0-3"
15
lpar = "config:0-15"
16
offset = "config:32-63"
17
vcpu = "config:16-31"
19
For example::
21
PM_PB_CYC = "domain=1,offset=0x80,chip=?,lpar=0x0"
23
In this event, '?' after chip specifies that
24
this value will be provided by user while running this event.
26
What: /sys/bus/event_source/devices/hv_24x7/interface/catalog
27
Date: February 2014
28
Contact: Linux on PowerPC Developer List <[email protected]>
29
Description:
30
Provides access to the binary "24x7 catalog" provided by the
31
hypervisor on POWER7 and 8 systems. This catalog lists events
32
available from the powerpc "hv_24x7" pmu. Its format is
33
documented here:
34
https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h
36
What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_length
37
Date: February 2014
38
Contact: Linux on PowerPC Developer List <[email protected]>
39
Description:
40
A number equal to the length in bytes of the catalog. This is
41
also extractable from the provided binary "catalog" sysfs entry.
43
What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_version
44
Date: February 2014
45
Contact: Linux on PowerPC Developer List <[email protected]>
46
Description:
47
Exposes the "version" field of the 24x7 catalog. This is also
48
extractable from the provided binary "catalog" sysfs entry.
50
What: /sys/devices/hv_24x7/interface/sockets
51
Date: May 2020
52
Contact: Linux on PowerPC Developer List <[email protected]>
53
Description: read only
54
This sysfs interface exposes the number of sockets present in the
55
system.
57
What: /sys/devices/hv_24x7/interface/chipspersocket
58
Date: May 2020
59
Contact: Linux on PowerPC Developer List <[email protected]>
60
Description: read only
61
This sysfs interface exposes the number of chips per socket
62
present in the system.
64
What: /sys/devices/hv_24x7/interface/coresperchip
65
Date: May 2020
66
Contact: Linux on PowerPC Developer List <[email protected]>
67
Description: read only
68
This sysfs interface exposes the number of cores per chip
69
present in the system.
71
What: /sys/devices/hv_24x7/cpumask
72
Date: July 2020
73
Contact: Linux on PowerPC Developer List <[email protected]>
74
Description: read only
75
This sysfs file exposes the cpumask which is designated to make
76
HCALLs to retrieve hv-24x7 pmu event counter data.
78
What: /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>
79
Date: February 2014
80
Contact: Linux on PowerPC Developer List <[email protected]>
81
Description:
82
Provides the description of a particular event as provided by
83
the firmware. If firmware does not provide a description, no
84
file will be created.
86
Note that the event-name lacks the domain suffix appended for
87
events in the events/ dir.
89
What: /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
90
Date: February 2014
91
Contact: Linux on PowerPC Developer List <[email protected]>
92
Description:
93
Provides the "long" description of a particular event as
94
provided by the firmware. If firmware does not provide a
95
description, no file will be created.
97
Note that the event-name lacks the domain suffix appended for
98
events in the events/ dir.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
hv_24x7 perf event format
1-24| 항목 | 전문 번역 |
|---|---|
| What | /sys/bus/event_source/devices/hv_24x7/format |
| Date | 2020년 9월 |
| Contact | Linux on PowerPC Developer List <[email protected]> |
| Description | Read-only입니다. 특정 PMU의 perf_event_attr.config에 들어가는 magic bits를 설명하는 attribute group입니다. ABI/testing/sysfs-bus-event_source-devices-format을 참조합니다. 이 group 아래 각 attribute는 perf_event_attr.config bit range를 정의합니다. |
| Attribute | Bit range |
|---|---|
| chip | config:16-31 |
| core | config:16-31 |
| domain | config:0-3 |
| lpar | config:0-15 |
| offset | config:32-63 |
| vcpu | config:16-31 |
PM_PB_CYC = "domain=1,offset=0x80,chip=?,lpar=0x0"이 event에서 chip 뒤의 ?는 event 실행 중 user가 해당 값을 제공한다는 뜻입니다.
POWER hypervisor 24x7 catalog
26-48| What | Date / Contact | 전문 번역 |
|---|---|---|
| /sys/bus/event_source/devices/hv_24x7/interface/catalog | 2014년 2월 / Linux on PowerPC Developer List <[email protected]> | POWER7과 POWER8 systems에서 hypervisor가 제공하는 binary "24x7 catalog"에 접근합니다. 이 catalog는 PowerPC hv_24x7 PMU에서 사용할 수 있는 events를 나열합니다. Format은 https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h 에 문서화되어 있습니다. |
| /sys/bus/event_source/devices/hv_24x7/interface/catalog_length | 2014년 2월 / Linux on PowerPC Developer List <[email protected]> | Catalog byte length와 같은 number입니다. 제공된 binary catalog sysfs entry에서도 추출할 수 있습니다. |
| /sys/bus/event_source/devices/hv_24x7/interface/catalog_version | 2014년 2월 / Linux on PowerPC Developer List <[email protected]> | 24x7 catalog의 version field를 노출합니다. 제공된 binary catalog sysfs entry에서도 추출할 수 있습니다. |
hv_24x7 topology와 HCALL cpumask
50-76| What | Date / Contact | 전문 번역 |
|---|---|---|
| /sys/devices/hv_24x7/interface/sockets | 2020년 5월 / Linux on PowerPC Developer List <[email protected]> | Read-only입니다. System에 있는 sockets 수를 노출합니다. |
| /sys/devices/hv_24x7/interface/chipspersocket | 2020년 5월 / Linux on PowerPC Developer List <[email protected]> | Read-only입니다. System에 있는 socket당 chips 수를 노출합니다. |
| /sys/devices/hv_24x7/interface/coresperchip | 2020년 5월 / Linux on PowerPC Developer List <[email protected]> | Read-only입니다. System에 있는 chip당 cores 수를 노출합니다. |
| /sys/devices/hv_24x7/cpumask | 2020년 7월 / Linux on PowerPC Developer List <[email protected]> | Read-only입니다. hv-24x7 PMU event counter data를 가져오는 HCALLs를 수행하도록 지정된 cpumask를 노출합니다. |
System→sockets→chips per socket→cores per chip
Designated cpumask→HCALL→Hypervisor hv-24x7 counter data
Topology counts가 socket·chip·core 계층을 나타내고 지정된 CPUs가 hypervisor HCALL로 counters를 가져옵니다.
Firmware-provided event descriptions
78-98| What | Date / Contact | 전문 번역 |
|---|---|---|
| /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name> | 2014년 2월 / Linux on PowerPC Developer List <[email protected]> | Firmware가 제공하는 특정 event description을 제공합니다. Firmware가 description을 제공하지 않으면 file을 만들지 않습니다. Event-name에는 events/ directory의 events에 붙는 domain suffix가 없습니다. |
| /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name> | 2014년 2월 / Linux on PowerPC Developer List <[email protected]> | Firmware가 제공하는 특정 event의 long description을 제공합니다. Firmware가 description을 제공하지 않으면 file을 만들지 않습니다. Event-name에는 events/ directory의 events에 붙는 domain suffix가 없습니다. |
hv_24x7 event format
sysfs-bus-event_source-devices-hv_24x7:1-24format group은 domain·lpar·chip/core/vcpu·offset fields를 perf_event_attr.config bit ranges에 mapping하고 ? parameter를 userspace value로 받습니다.