PowerPC hv_24x7 PMU sysfs ABI | Linux 6.18.37

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

1. 요약·해설

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

hv_24x7 event format

sysfs-bus-event_source-devices-hv_24x7:1-24

format group은 domain·lpar·chip/core/vcpu·offset fields를 perf_event_attr.config bit ranges에 mapping하고 ? parameter를 userspace value로 받습니다.

Hypervisor 24x7 catalog

sysfs-bus-event_source-devices-hv_24x7:26-48

POWER7·8 hypervisor가 제공하는 binary catalog, byte length와 version field를 노출합니다.

System topology와 HCALL CPU mask

sysfs-bus-event_source-devices-hv_24x7:50-76

System 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-98

Firmware가 제공하는 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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>

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 <linuxppc-dev@lists.ozlabs.org>
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 <linuxppc-dev@lists.ozlabs.org>	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 <linuxppc-dev@lists.ozlabs.org>	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 <linuxppc-dev@lists.ozlabs.org>	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 <linuxppc-dev@lists.ozlabs.org>	Read-only입니다. System에 있는 sockets 수를 노출합니다.
/sys/devices/hv_24x7/interface/chipspersocket	2020년 5월 / Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>	Read-only입니다. System에 있는 socket당 chips 수를 노출합니다.
/sys/devices/hv_24x7/interface/coresperchip	2020년 5월 / Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>	Read-only입니다. System에 있는 chip당 cores 수를 노출합니다.
/sys/devices/hv_24x7/cpumask	2020년 7월 / Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>	Read-only입니다. hv-24x7 PMU event counter data를 가져오는 HCALLs를 수행하도록 지정된 cpumask를 노출합니다.

hv_24x7 topology와 counter retrieval

Systemsocketschips per socketcores per chip

Designated cpumaskHCALLHypervisor 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 <linuxppc-dev@lists.ozlabs.org>	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 <linuxppc-dev@lists.ozlabs.org>	Firmware가 제공하는 특정 event의 long description을 제공합니다. Firmware가 description을 제공하지 않으면 file을 만들지 않습니다. Event-name에는 events/ directory의 events에 붙는 domain suffix가 없습니다.