792f73f747
Patch here adds a cpumask attr to hv_24x7 pmu along with ABI documentation. Primary use to expose the cpumask is for the perf tool which has the capability to parse the driver sysfs folder and understand the cpumask file. Having cpumask file will reduce the number of perf command line parameters (will avoid "-C" option in the perf tool command line). It can also notify the user which is the current cpu used to retrieve the counter data. command:# cat /sys/devices/hv_24x7/interface/cpumask 0 Signed-off-by: Kajol Jain <kjain@linux.ibm.com> Reviewed-by: Madhavan Srinivasan <maddy@linux.ibm.com> Signed-off-by: Michael Ellerman <mpe@ellerman.id.au> Link: https://lore.kernel.org/r/20200709051836.723765-3-kjain@linux.ibm.com
74 lines
2.9 KiB
Plaintext
74 lines
2.9 KiB
Plaintext
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/interface/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.
|