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/devices/hv_24x7/interface/sockets
26Date:		May 2020
27Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
28Description:	read only
29		This sysfs interface exposes the number of sockets present in the
30		system.
31
32What:		/sys/devices/hv_24x7/interface/chipspersocket
33Date:		May 2020
34Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
35Description:	read only
36		This sysfs interface exposes the number of chips per socket
37		present in the system.
38
39What:		/sys/devices/hv_24x7/interface/coresperchip
40Date:		May 2020
41Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
42Description:	read only
43		This sysfs interface exposes the number of cores per chip
44		present in the system.
45
46What:		/sys/devices/hv_24x7/cpumask
47Date:		July 2020
48Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
49Description:	read only
50		This sysfs file exposes the cpumask which is designated to make
51		HCALLs to retrieve hv-24x7 pmu event counter data.
52
53What:		/sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>
54Date:		February 2014
55Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
56Description:
57		Provides the description of a particular event as provided by
58		the firmware. If firmware does not provide a description, no
59		file will be created.
60
61		Note that the event-name lacks the domain suffix appended for
62		events in the events/ dir.
63
64What:		/sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
65Date:		February 2014
66Contact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
67Description:
68		Provides the "long" description of a particular event as
69		provided by the firmware. If firmware does not provide a
70		description, no file will be created.
71
72		Note that the event-name lacks the domain suffix appended for
73		events in the events/ dir.
74