| What: /sys/bus/event_source/devices/hv_24x7/format |
| Date: September 2020 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: Read-only. Attribute group to describe the magic bits |
| that go into perf_event_attr.config for a particular pmu. |
| (See ABI/testing/sysfs-bus-event_source-devices-format). |
| |
| Each attribute under this group defines a bit range of the |
| perf_event_attr.config. All supported attributes are listed |
| below. |
| |
| chip = "config:16-31" |
| core = "config:16-31" |
| domain = "config:0-3" |
| lpar = "config:0-15" |
| offset = "config:32-63" |
| vcpu = "config:16-31" |
| |
| For example, |
| |
| PM_PB_CYC = "domain=1,offset=0x80,chip=?,lpar=0x0" |
| |
| In this event, '?' after chip specifies that |
| this value will be provided by user while running this event. |
| |
| What: /sys/bus/event_source/devices/hv_24x7/interface/catalog |
| Date: February 2014 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: |
| Provides access to the binary "24x7 catalog" provided by the |
| hypervisor on POWER7 and 8 systems. This catalog lists events |
| available from the powerpc "hv_24x7" pmu. Its format is |
| documented here: |
| https://raw.githubusercontent.com/jmesmon/catalog-24x7/master/hv-24x7-catalog.h |
| |
| What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_length |
| Date: February 2014 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: |
| A number equal to the length in bytes of the catalog. This is |
| also extractable from the provided binary "catalog" sysfs entry. |
| |
| What: /sys/bus/event_source/devices/hv_24x7/interface/catalog_version |
| Date: February 2014 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: |
| Exposes the "version" field of the 24x7 catalog. This is also |
| extractable from the provided binary "catalog" sysfs entry. |
| |
| What: /sys/devices/hv_24x7/interface/sockets |
| Date: May 2020 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: read only |
| This sysfs interface exposes the number of sockets present in the |
| system. |
| |
| What: /sys/devices/hv_24x7/interface/chipspersocket |
| Date: May 2020 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: read only |
| This sysfs interface exposes the number of chips per socket |
| present in the system. |
| |
| What: /sys/devices/hv_24x7/interface/coresperchip |
| Date: May 2020 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: read only |
| This sysfs interface exposes the number of cores per chip |
| present in the system. |
| |
| What: /sys/devices/hv_24x7/cpumask |
| Date: July 2020 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: read only |
| This sysfs file exposes the cpumask which is designated to make |
| HCALLs to retrieve hv-24x7 pmu event counter data. |
| |
| What: /sys/bus/event_source/devices/hv_24x7/event_descs/<event-name> |
| Date: February 2014 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: |
| Provides the description of a particular event as provided by |
| the firmware. If firmware does not provide a description, no |
| file will be created. |
| |
| Note that the event-name lacks the domain suffix appended for |
| events in the events/ dir. |
| |
| What: /sys/bus/event_source/devices/hv_24x7/event_long_descs/<event-name> |
| Date: February 2014 |
| Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org> |
| Description: |
| Provides the "long" description of a particular event as |
| provided by the firmware. If firmware does not provide a |
| description, no file will be created. |
| |
| Note that the event-name lacks the domain suffix appended for |
| events in the events/ dir. |