243 lines · plain
1What: /sys/bus/event_source/devices/hv_gpci/format2Date: September 20203Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>4Description: Read-only. Attribute group to describe the magic bits5 that go into perf_event_attr.config for a particular pmu.6 (See ABI/testing/sysfs-bus-event_source-devices-format).7 8 Each attribute under this group defines a bit range of the9 perf_event_attr.config. All supported attributes are listed10 below::11 12 counter_info_version = "config:16-23"13 length = "config:24-31"14 partition_id = "config:32-63"15 request = "config:0-31"16 sibling_part_id = "config:32-63"17 hw_chip_id = "config:32-63"18 offset = "config:32-63"19 phys_processor_idx = "config:32-63"20 secondary_index = "config:0-15"21 starting_index = "config:32-63"22 23 For example::24 25 processor_core_utilization_instructions_completed = "request=0x94,26 phys_processor_idx=?,counter_info_version=0x8,27 length=8,offset=0x18"28 29 In this event, '?' after phys_processor_idx specifies this value30 this value will be provided by user while running this event.31 32What: /sys/bus/event_source/devices/hv_gpci/interface/collect_privileged33Date: February 201434Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>35Description:36 '0' if the hypervisor is configured to forbid access to event37 counters being accumulated by other guests and to physical38 domain event counters.39 40 '1' if that access is allowed.41 42What: /sys/bus/event_source/devices/hv_gpci/interface/ga43Date: February 201444Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>45Description:46 0 or 1. Indicates whether we have access to "GA" events (listed47 in arch/powerpc/perf/hv-gpci.h).48 49What: /sys/bus/event_source/devices/hv_gpci/interface/expanded50Date: February 201451Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>52Description:53 0 or 1. Indicates whether we have access to "EXPANDED" events (listed54 in arch/powerpc/perf/hv-gpci.h).55 56What: /sys/bus/event_source/devices/hv_gpci/interface/lab57Date: February 201458Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>59Description:60 0 or 1. Indicates whether we have access to "LAB" events (listed61 in arch/powerpc/perf/hv-gpci.h).62 63What: /sys/bus/event_source/devices/hv_gpci/interface/version64Date: February 201465Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>66Description:67 A number indicating the version of the gpci interface that the68 hypervisor reports supporting.69 70What: /sys/bus/event_source/devices/hv_gpci/interface/kernel_version71Date: February 201472Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>73Description:74 A number indicating the latest version of the gpci interface75 that the kernel is aware of.76 77What: /sys/devices/hv_gpci/cpumask78Date: October 202079Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>80Description: read only81 This sysfs file exposes the cpumask which is designated to make82 HCALLs to retrieve hv-gpci pmu event counter data.83 84What: /sys/devices/hv_gpci/interface/processor_bus_topology85Date: July 202386Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>87Description: admin read only88 This sysfs file exposes the system topology information by making HCALL89 H_GET_PERF_COUNTER_INFO. The HCALL is made with counter request value90 PROCESSOR_BUS_TOPOLOGY(0xD0).91 92 * This sysfs file will be created only for power10 and above platforms.93 94 * User needs root privileges to read data from this sysfs file.95 96 * This sysfs file will be created, only when the HCALL returns "H_SUCCESS",97 "H_AUTHORITY" or "H_PARAMETER" as the return type.98 99 HCALL with return error type "H_AUTHORITY" can be resolved during100 runtime by setting "Enable Performance Information Collection" option.101 102 * The end user reading this sysfs file must decode the content as per103 underlying platform/firmware.104 105 Possible error codes while reading this sysfs file:106 107 * "-EPERM" : Partition is not permitted to retrieve performance information,108 required to set "Enable Performance Information Collection" option.109 110 * "-EIO" : Can't retrieve system information because of invalid buffer length/invalid address111 or because of some hardware error. Refer to getPerfCountInfo documentation for112 more information.113 114 * "-EFBIG" : System information exceeds PAGE_SIZE.115 116What: /sys/devices/hv_gpci/interface/processor_config117Date: July 2023118Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>119Description: admin read only120 This sysfs file exposes the system topology information by making HCALL121 H_GET_PERF_COUNTER_INFO. The HCALL is made with counter request value122 PROCESSOR_CONFIG(0x90).123 124 * This sysfs file will be created only for power10 and above platforms.125 126 * User needs root privileges to read data from this sysfs file.127 128 * This sysfs file will be created, only when the HCALL returns "H_SUCCESS",129 "H_AUTHORITY" or "H_PARAMETER" as the return type.130 131 HCALL with return error type "H_AUTHORITY" can be resolved during132 runtime by setting "Enable Performance Information Collection" option.133 134 * The end user reading this sysfs file must decode the content as per135 underlying platform/firmware.136 137 Possible error codes while reading this sysfs file:138 139 * "-EPERM" : Partition is not permitted to retrieve performance information,140 required to set "Enable Performance Information Collection" option.141 142 * "-EIO" : Can't retrieve system information because of invalid buffer length/invalid address143 or because of some hardware error. Refer to getPerfCountInfo documentation for144 more information.145 146 * "-EFBIG" : System information exceeds PAGE_SIZE.147 148What: /sys/devices/hv_gpci/interface/affinity_domain_via_virtual_processor149Date: July 2023150Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>151Description: admin read only152 This sysfs file exposes the system topology information by making HCALL153 H_GET_PERF_COUNTER_INFO. The HCALL is made with counter request value154 AFFINITY_DOMAIN_INFORMATION_BY_VIRTUAL_PROCESSOR(0xA0).155 156 * This sysfs file will be created only for power10 and above platforms.157 158 * User needs root privileges to read data from this sysfs file.159 160 * This sysfs file will be created, only when the HCALL returns "H_SUCCESS",161 "H_AUTHORITY" or "H_PARAMETER" as the return type.162 163 HCALL with return error type "H_AUTHORITY" can be resolved during164 runtime by setting "Enable Performance Information Collection" option.165 166 * The end user reading this sysfs file must decode the content as per167 underlying platform/firmware.168 169 Possible error codes while reading this sysfs file:170 171 * "-EPERM" : Partition is not permitted to retrieve performance information,172 required to set "Enable Performance Information Collection" option.173 174 * "-EIO" : Can't retrieve system information because of invalid buffer length/invalid address175 or because of some hardware error. Refer to getPerfCountInfo documentation for176 more information.177 178 * "-EFBIG" : System information exceeds PAGE_SIZE.179 180What: /sys/devices/hv_gpci/interface/affinity_domain_via_domain181Date: July 2023182Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>183Description: admin read only184 This sysfs file exposes the system topology information by making HCALL185 H_GET_PERF_COUNTER_INFO. The HCALL is made with counter request value186 AFFINITY_DOMAIN_INFORMATION_BY_DOMAIN(0xB0).187 188 * This sysfs file will be created only for power10 and above platforms.189 190 * User needs root privileges to read data from this sysfs file.191 192 * This sysfs file will be created, only when the HCALL returns "H_SUCCESS",193 "H_AUTHORITY" or "H_PARAMETER" as the return type.194 195 HCALL with return error type "H_AUTHORITY" can be resolved during196 runtime by setting "Enable Performance Information Collection" option.197 198 * The end user reading this sysfs file must decode the content as per199 underlying platform/firmware.200 201 Possible error codes while reading this sysfs file:202 203 * "-EPERM" : Partition is not permitted to retrieve performance information,204 required to set "Enable Performance Information Collection" option.205 206 * "-EIO" : Can't retrieve system information because of invalid buffer length/invalid address207 or because of some hardware error. Refer to getPerfCountInfo documentation for208 more information.209 210 * "-EFBIG" : System information exceeds PAGE_SIZE.211 212What: /sys/devices/hv_gpci/interface/affinity_domain_via_partition213Date: July 2023214Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>215Description: admin read only216 This sysfs file exposes the system topology information by making HCALL217 H_GET_PERF_COUNTER_INFO. The HCALL is made with counter request value218 AFFINITY_DOMAIN_INFORMATION_BY_PARTITION(0xB1).219 220 * This sysfs file will be created only for power10 and above platforms.221 222 * User needs root privileges to read data from this sysfs file.223 224 * This sysfs file will be created, only when the HCALL returns "H_SUCCESS",225 "H_AUTHORITY" or "H_PARAMETER" as the return type.226 227 HCALL with return error type "H_AUTHORITY" can be resolved during228 runtime by setting "Enable Performance Information Collection" option.229 230 * The end user reading this sysfs file must decode the content as per231 underlying platform/firmware.232 233 Possible error codes while reading this sysfs file:234 235 * "-EPERM" : Partition is not permitted to retrieve performance information,236 required to set "Enable Performance Information Collection" option.237 238 * "-EIO" : Can't retrieve system information because of invalid buffer length/invalid address239 or because of some hardware error. Refer to getPerfCountInfo documentation for240 more information.241 242 * "-EFBIG" : System information exceeds PAGE_SIZE.243