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.
99