Loading...
1What: /sys/bus/event_source/devices/hv_24x7/format
2Date: September 2020
3Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
4Description: 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).
7
8 Each attribute under this group defines a bit range of the
9 perf_event_attr.config. All supported attributes are listed
10 below::
11
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"
18
19 For example::
20
21 PM_PB_CYC = "domain=1,offset=0x80,chip=?,lpar=0x0"
22
23 In this event, '?' after chip specifies that
24 this value will be provided by user while running this event.
25
26What: /sys/bus/event_source/devices/hv_24x7/interface/catalog
27Date: February 2014
28Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
29Description:
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
35
36What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_length
37Date: February 2014
38Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
39Description:
40 A number equal to the length in bytes of the catalog. This is
41 also extractable from the provided binary "catalog" sysfs entry.
42
43What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_version
44Date: February 2014
45Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
46Description:
47 Exposes the "version" field of the 24x7 catalog. This is also
48 extractable from the provided binary "catalog" sysfs entry.
49
50What: /sys/devices/hv_24x7/interface/sockets
51Date: May 2020
52Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
53Description: read only
54 This sysfs interface exposes the number of sockets present in the
55 system.
56
57What: /sys/devices/hv_24x7/interface/chipspersocket
58Date: May 2020
59Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
60Description: read only
61 This sysfs interface exposes the number of chips per socket
62 present in the system.
63
64What: /sys/devices/hv_24x7/interface/coresperchip
65Date: May 2020
66Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
67Description: read only
68 This sysfs interface exposes the number of cores per chip
69 present in the system.
70
71What: /sys/devices/hv_24x7/cpumask
72Date: July 2020
73Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
74Description: read only
75 This sysfs file exposes the cpumask which is designated to make
76 HCALLs to retrieve hv-24x7 pmu event counter data.
77
78What: /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>
79Date: February 2014
80Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
81Description:
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.
85
86 Note that the event-name lacks the domain suffix appended for
87 events in the events/ dir.
88
89What: /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
90Date: February 2014
91Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
92Description:
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.
96
97 Note that the event-name lacks the domain suffix appended for
98 events in the events/ dir.
1What: /sys/bus/event_source/devices/hv_24x7/interface/catalog
2Date: February 2014
3Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
4Description:
5 Provides access to the binary "24x7 catalog" provided by the
6 hypervisor on POWER7 and 8 systems. This catalog lists events
7 available from the powerpc "hv_24x7" pmu. Its format is
8 documented here:
9 https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h
10
11What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_length
12Date: February 2014
13Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
14Description:
15 A number equal to the length in bytes of the catalog. This is
16 also extractable from the provided binary "catalog" sysfs entry.
17
18What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_version
19Date: February 2014
20Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
21Description:
22 Exposes the "version" field of the 24x7 catalog. This is also
23 extractable from the provided binary "catalog" sysfs entry.
24
25What: /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>
26Date: February 2014
27Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
28Description:
29 Provides the description of a particular event as provided by
30 the firmware. If firmware does not provide a description, no
31 file will be created.
32
33 Note that the event-name lacks the domain suffix appended for
34 events in the events/ dir.
35
36What: /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
37Date: February 2014
38Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
39Description:
40 Provides the "long" description of a particular event as
41 provided by the firmware. If firmware does not provide a
42 description, no file will be created.
43
44 Note that the event-name lacks the domain suffix appended for
45 events in the events/ dir.