hc
2023-12-11 d2ccde1c8e90d38cee87a1b0309ad2827f3fd30d
kernel/Documentation/ABI/testing/sysfs-bus-event_source-devices-hv_gpci
....@@ -1,3 +1,34 @@
1
+What: /sys/bus/event_source/devices/hv_gpci/format
2
+Date: September 2020
3
+Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
4
+Description: Read-only. Attribute group to describe the magic bits
5
+ 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 the
9
+ perf_event_attr.config. All supported attributes are listed
10
+ 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 value
30
+ this value will be provided by user while running this event.
31
+
132 What: /sys/bus/event_source/devices/hv_gpci/interface/collect_privileged
233 Date: February 2014
334 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
....@@ -5,6 +36,7 @@
536 '0' if the hypervisor is configured to forbid access to event
637 counters being accumulated by other guests and to physical
738 domain event counters.
39
+
840 '1' if that access is allowed.
941
1042 What: /sys/bus/event_source/devices/hv_gpci/interface/ga
....@@ -41,3 +73,10 @@
4173 Description:
4274 A number indicating the latest version of the gpci interface
4375 that the kernel is aware of.
76
+
77
+What: /sys/devices/hv_gpci/cpumask
78
+Date: October 2020
79
+Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
80
+Description: read only
81
+ This sysfs file exposes the cpumask which is designated to make
82
+ HCALLs to retrieve hv-gpci pmu event counter data.