MIRRORS/linux-imx
1
0
Fork 0
mirror of https://github.com/nxp-imx/linux-imx.git synced 2025-07-19 07:39:54 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity
ef901b38d3
linux-imx/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_24x7
Mauro Carvalho Chehab 54a19b4d3f docs: ABI: cleanup several ABI documents 
There are some ABI documents that, while they don't generate
any warnings, they have issues when parsed by get_abi.pl script
on its output result.

Address them, in order to provide a clean output.

Reviewed-by: Tom Rix <trix@redhat.com> # for fpga-manager
Reviewed-By: Kajol Jain<kjain@linux.ibm.com> # for sysfs-bus-event_source-devices-hv_gpci and sysfs-bus-event_source-devices-hv_24x7
Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com> #for IIO
Acked-by: Oded Gabbay <oded.gabbay@gmail.com> # for Habanalabs
Acked-by: Vaibhav Jain <vaibhav@linux.ibm.com> # for sysfs-bus-papr-pmem
Acked-by: Cezary Rojewski <cezary.rojewski@intel.com> # for catpt
Acked-by: Suzuki K Poulose <suzuki.poulose@arm.com>
Acked-by: Ilya Dryomov <idryomov@gmail.com> # for rbd
Acked-by: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Link: https://lore.kernel.org/r/5bc78e5b68ed1e9e39135173857cb2e753be868f.1604042072.git.mchehab+huawei@kernel.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2020-10-30 13:14:29 +01:00

3.8 KiB
Raw Blame History

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/ 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/ 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.