1ad0a02b8SCody P SchaferWhat:		/sys/bus/event_source/devices/hv_24x7/interface/catalog
2ad0a02b8SCody P SchaferDate:		February 2014
3dfdac393Ssukadev@linux.vnet.ibm.comContact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
4ad0a02b8SCody P SchaferDescription:
5ad0a02b8SCody P Schafer		Provides access to the binary "24x7 catalog" provided by the
6ad0a02b8SCody P Schafer		hypervisor on POWER7 and 8 systems. This catalog lists events
708559657SKees Cook		available from the powerpc "hv_24x7" pmu. Its format is
8ad0a02b8SCody P Schafer		documented here:
9ad0a02b8SCody P Schafer		https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h
10ad0a02b8SCody P Schafer
11ad0a02b8SCody P SchaferWhat:		/sys/bus/event_source/devices/hv_24x7/interface/catalog_length
12ad0a02b8SCody P SchaferDate:		February 2014
13dfdac393Ssukadev@linux.vnet.ibm.comContact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
14ad0a02b8SCody P SchaferDescription:
15ad0a02b8SCody P Schafer		A number equal to the length in bytes of the catalog. This is
16ad0a02b8SCody P Schafer		also extractable from the provided binary "catalog" sysfs entry.
17ad0a02b8SCody P Schafer
18ad0a02b8SCody P SchaferWhat:		/sys/bus/event_source/devices/hv_24x7/interface/catalog_version
19ad0a02b8SCody P SchaferDate:		February 2014
20dfdac393Ssukadev@linux.vnet.ibm.comContact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
21ad0a02b8SCody P SchaferDescription:
22ad0a02b8SCody P Schafer		Exposes the "version" field of the 24x7 catalog. This is also
23ad0a02b8SCody P Schafer		extractable from the provided binary "catalog" sysfs entry.
245c65670cSCody P Schafer
255c65670cSCody P SchaferWhat:		/sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>
265c65670cSCody P SchaferDate:		February 2014
275c65670cSCody P SchaferContact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
285c65670cSCody P SchaferDescription:
295c65670cSCody P Schafer		Provides the description of a particular event as provided by
305c65670cSCody P Schafer		the firmware. If firmware does not provide a description, no
315c65670cSCody P Schafer		file will be created.
325c65670cSCody P Schafer
335c65670cSCody P Schafer		Note that the event-name lacks the domain suffix appended for
345c65670cSCody P Schafer		events in the events/ dir.
355c65670cSCody P Schafer
365c65670cSCody P SchaferWhat:		/sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
375c65670cSCody P SchaferDate:		February 2014
385c65670cSCody P SchaferContact:	Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
395c65670cSCody P SchaferDescription:
405c65670cSCody P Schafer		Provides the "long" description of a particular event as
415c65670cSCody P Schafer		provided by the firmware. If firmware does not provide a
425c65670cSCody P Schafer		description, no file will be created.
435c65670cSCody P Schafer
445c65670cSCody P Schafer		Note that the event-name lacks the domain suffix appended for
455c65670cSCody P Schafer		events in the events/ dir.
46