0001 What: /sys/bus/event_source/devices/hv_gpci/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 counter_info_version = "config:16-23"
0013 length = "config:24-31"
0014 partition_id = "config:32-63"
0015 request = "config:0-31"
0016 sibling_part_id = "config:32-63"
0017 hw_chip_id = "config:32-63"
0018 offset = "config:32-63"
0019 phys_processor_idx = "config:32-63"
0020 secondary_index = "config:0-15"
0021 starting_index = "config:32-63"
0022
0023 For example::
0024
0025 processor_core_utilization_instructions_completed = "request=0x94,
0026 phys_processor_idx=?,counter_info_version=0x8,
0027 length=8,offset=0x18"
0028
0029 In this event, '?' after phys_processor_idx specifies this value
0030 this value will be provided by user while running this event.
0031
0032 What: /sys/bus/event_source/devices/hv_gpci/interface/collect_privileged
0033 Date: February 2014
0034 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0035 Description:
0036 '0' if the hypervisor is configured to forbid access to event
0037 counters being accumulated by other guests and to physical
0038 domain event counters.
0039
0040 '1' if that access is allowed.
0041
0042 What: /sys/bus/event_source/devices/hv_gpci/interface/ga
0043 Date: February 2014
0044 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0045 Description:
0046 0 or 1. Indicates whether we have access to "GA" events (listed
0047 in arch/powerpc/perf/hv-gpci.h).
0048
0049 What: /sys/bus/event_source/devices/hv_gpci/interface/expanded
0050 Date: February 2014
0051 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0052 Description:
0053 0 or 1. Indicates whether we have access to "EXPANDED" events (listed
0054 in arch/powerpc/perf/hv-gpci.h).
0055
0056 What: /sys/bus/event_source/devices/hv_gpci/interface/lab
0057 Date: February 2014
0058 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0059 Description:
0060 0 or 1. Indicates whether we have access to "LAB" events (listed
0061 in arch/powerpc/perf/hv-gpci.h).
0062
0063 What: /sys/bus/event_source/devices/hv_gpci/interface/version
0064 Date: February 2014
0065 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0066 Description:
0067 A number indicating the version of the gpci interface that the
0068 hypervisor reports supporting.
0069
0070 What: /sys/bus/event_source/devices/hv_gpci/interface/kernel_version
0071 Date: February 2014
0072 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0073 Description:
0074 A number indicating the latest version of the gpci interface
0075 that the kernel is aware of.
0076
0077 What: /sys/devices/hv_gpci/cpumask
0078 Date: October 2020
0079 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
0080 Description: read only
0081 This sysfs file exposes the cpumask which is designated to make
0082 HCALLs to retrieve hv-gpci pmu event counter data.
