0001 What: /sys/bus/event_source/devices/hv_24x7/format
0002 Date: September 2020
0003 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0004 Description: Read-only. Attribute group to describe the magic bits
0005 that go into perf_event_attr.config for a particular pmu.
0006 (See ABI/testing/sysfs-bus-event_source-devices-format).
0007
0008 Each attribute under this group defines a bit range of the
0009 perf_event_attr.config. All supported attributes are listed
0010 below::
0011
0012 chip = "config:16-31"
0013 core = "config:16-31"
0014 domain = "config:0-3"
0015 lpar = "config:0-15"
0016 offset = "config:32-63"
0017 vcpu = "config:16-31"
0018
0019 For example::
0020
0021 PM_PB_CYC = "domain=1,offset=0x80,chip=?,lpar=0x0"
0022
0023 In this event, '?' after chip specifies that
0024 this value will be provided by user while running this event.
0025
0026 What: /sys/bus/event_source/devices/hv_24x7/interface/catalog
0027 Date: February 2014
0028 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0029 Description:
0030 Provides access to the binary "24x7 catalog" provided by the
0031 hypervisor on POWER7 and 8 systems. This catalog lists events
0032 available from the powerpc "hv_24x7" pmu. Its format is
0033 documented here:
0034 https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h
0035
0036 What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_length
0037 Date: February 2014
0038 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0039 Description:
0040 A number equal to the length in bytes of the catalog. This is
0041 also extractable from the provided binary "catalog" sysfs entry.
0042
0043 What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_version
0044 Date: February 2014
0045 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0046 Description:
0047 Exposes the "version" field of the 24x7 catalog. This is also
0048 extractable from the provided binary "catalog" sysfs entry.
0049
0050 What: /sys/devices/hv_24x7/interface/sockets
0051 Date: May 2020
0052 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0053 Description: read only
0054 This sysfs interface exposes the number of sockets present in the
0055 system.
0056
0057 What: /sys/devices/hv_24x7/interface/chipspersocket
0058 Date: May 2020
0059 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0060 Description: read only
0061 This sysfs interface exposes the number of chips per socket
0062 present in the system.
0063
0064 What: /sys/devices/hv_24x7/interface/coresperchip
0065 Date: May 2020
0066 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0067 Description: read only
0068 This sysfs interface exposes the number of cores per chip
0069 present in the system.
0070
0071 What: /sys/devices/hv_24x7/cpumask
0072 Date: July 2020
0073 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0074 Description: read only
0075 This sysfs file exposes the cpumask which is designated to make
0076 HCALLs to retrieve hv-24x7 pmu event counter data.
0077
0078 What: /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name>
0079 Date: February 2014
0080 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0081 Description:
0082 Provides the description of a particular event as provided by
0083 the firmware. If firmware does not provide a description, no
0084 file will be created.
0085
0086 Note that the event-name lacks the domain suffix appended for
0087 events in the events/ dir.
0088
0089 What: /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name>
0090 Date: February 2014
0091 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0092 Description:
0093 Provides the "long" description of a particular event as
0094 provided by the firmware. If firmware does not provide a
0095 description, no file will be created.
0096
0097 Note that the event-name lacks the domain suffix appended for
0098 events in the events/ dir.
