blob: ec27c6c9e7377ad4a2ee90fcae01497d0d47b35d [file] [log] [blame]
Cody P Schaferad0a02b2014-03-14 16:00:44 +11001What: /sys/bus/event_source/devices/hv_24x7/interface/catalog
2Date: February 2014
sukadev@linux.vnet.ibm.comdfdac392014-09-30 23:03:21 -07003Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
Cody P Schaferad0a02b2014-03-14 16:00:44 +11004Description:
5 Provides access to the binary "24x7 catalog" provided by the
6 hypervisor on POWER7 and 8 systems. This catalog lists events
Kees Cook08559652016-04-26 16:41:21 -07007 available from the powerpc "hv_24x7" pmu. Its format is
Cody P Schaferad0a02b2014-03-14 16:00:44 +11008 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
sukadev@linux.vnet.ibm.comdfdac392014-09-30 23:03:21 -070013Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
Cody P Schaferad0a02b2014-03-14 16:00:44 +110014Description:
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
sukadev@linux.vnet.ibm.comdfdac392014-09-30 23:03:21 -070020Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
Cody P Schaferad0a02b2014-03-14 16:00:44 +110021Description:
22 Exposes the "version" field of the 24x7 catalog. This is also
23 extractable from the provided binary "catalog" sysfs entry.
Cody P Schafer5c656702015-01-30 13:46:03 -080024
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.