1 What: /sys/bus/event_source/devices/ 1 What: /sys/bus/event_source/devices/hv_gpci/format
2 Date: September 2020 2 Date: September 2020
3 Contact: Linux on PowerPC Developer Lis< 3 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
4 Description: Read-only. Attribute group to 4 Description: Read-only. Attribute group to describe the magic bits
5 that go into perf_event_attr.c 5 that go into perf_event_attr.config for a particular pmu.
6 (See ABI/testing/sysfs-bus-eve 6 (See ABI/testing/sysfs-bus-event_source-devices-format).
7 7
8 Each attribute under this grou 8 Each attribute under this group defines a bit range of the
9 perf_event_attr.config. All su 9 perf_event_attr.config. All supported attributes are listed
10 below:: 10 below::
11 11
12 counter_info_v 12 counter_info_version = "config:16-23"
13 length = "con 13 length = "config:24-31"
14 partition_id 14 partition_id = "config:32-63"
15 request = "con 15 request = "config:0-31"
16 sibling_part_i 16 sibling_part_id = "config:32-63"
17 hw_chip_id = " 17 hw_chip_id = "config:32-63"
18 offset = "conf 18 offset = "config:32-63"
19 phys_processor 19 phys_processor_idx = "config:32-63"
20 secondary_inde 20 secondary_index = "config:0-15"
21 starting_index 21 starting_index = "config:32-63"
22 22
23 For example:: 23 For example::
24 24
25 processor_core_utilization_i 25 processor_core_utilization_instructions_completed = "request=0x94,
26 phys_p 26 phys_processor_idx=?,counter_info_version=0x8,
27 length 27 length=8,offset=0x18"
28 28
29 In this event, '?' after phys_ 29 In this event, '?' after phys_processor_idx specifies this value
30 this value will be provided by 30 this value will be provided by user while running this event.
31 31
32 What: /sys/bus/event_source/devices/ 32 What: /sys/bus/event_source/devices/hv_gpci/interface/collect_privileged
33 Date: February 2014 33 Date: February 2014
34 Contact: Linux on PowerPC Developer Lis< 34 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
35 Description: 35 Description:
36 '0' if the hypervisor is confi 36 '0' if the hypervisor is configured to forbid access to event
37 counters being accumulated by 37 counters being accumulated by other guests and to physical
38 domain event counters. 38 domain event counters.
39 39
40 '1' if that access is allowed. 40 '1' if that access is allowed.
41 41
42 What: /sys/bus/event_source/devices/ 42 What: /sys/bus/event_source/devices/hv_gpci/interface/ga
43 Date: February 2014 43 Date: February 2014
44 Contact: Linux on PowerPC Developer Lis< 44 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
45 Description: 45 Description:
46 0 or 1. Indicates whether we h 46 0 or 1. Indicates whether we have access to "GA" events (listed
47 in arch/powerpc/perf/hv-gpci.h 47 in arch/powerpc/perf/hv-gpci.h).
48 48
49 What: /sys/bus/event_source/devices/ 49 What: /sys/bus/event_source/devices/hv_gpci/interface/expanded
50 Date: February 2014 50 Date: February 2014
51 Contact: Linux on PowerPC Developer Lis< 51 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
52 Description: 52 Description:
53 0 or 1. Indicates whether we h 53 0 or 1. Indicates whether we have access to "EXPANDED" events (listed
54 in arch/powerpc/perf/hv-gpci.h 54 in arch/powerpc/perf/hv-gpci.h).
55 55
56 What: /sys/bus/event_source/devices/ 56 What: /sys/bus/event_source/devices/hv_gpci/interface/lab
57 Date: February 2014 57 Date: February 2014
58 Contact: Linux on PowerPC Developer Lis< 58 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
59 Description: 59 Description:
60 0 or 1. Indicates whether we h 60 0 or 1. Indicates whether we have access to "LAB" events (listed
61 in arch/powerpc/perf/hv-gpci.h 61 in arch/powerpc/perf/hv-gpci.h).
62 62
63 What: /sys/bus/event_source/devices/ 63 What: /sys/bus/event_source/devices/hv_gpci/interface/version
64 Date: February 2014 64 Date: February 2014
65 Contact: Linux on PowerPC Developer Lis< 65 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
66 Description: 66 Description:
67 A number indicating the versio 67 A number indicating the version of the gpci interface that the
68 hypervisor reports supporting. 68 hypervisor reports supporting.
69 69
70 What: /sys/bus/event_source/devices/ 70 What: /sys/bus/event_source/devices/hv_gpci/interface/kernel_version
71 Date: February 2014 71 Date: February 2014
72 Contact: Linux on PowerPC Developer Lis< 72 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
73 Description: 73 Description:
74 A number indicating the latest 74 A number indicating the latest version of the gpci interface
75 that the kernel is aware of. 75 that the kernel is aware of.
76 76
77 What: /sys/devices/hv_gpci/cpumask 77 What: /sys/devices/hv_gpci/cpumask
78 Date: October 2020 78 Date: October 2020
79 Contact: Linux on PowerPC Developer Lis< 79 Contact: Linux on PowerPC Developer List <linuxppc-dev@lists.ozlabs.org>
80 Description: read only 80 Description: read only
81 This sysfs file exposes the cp 81 This sysfs file exposes the cpumask which is designated to make
82 HCALLs to retrieve hv-gpci pmu 82 HCALLs to retrieve hv-gpci pmu event counter data.
83 <<
84 What: /sys/devices/hv_gpci/interface <<
85 Date: July 2023 <<
86 Contact: Linux on PowerPC Developer Lis< <<
87 Description: admin read only <<
88 This sysfs file exposes the sy <<
89 H_GET_PERF_COUNTER_INFO. The H <<
90 PROCESSOR_BUS_TOPOLOGY(0xD0). <<
91 <<
92 * This sysfs file will be crea <<
93 <<
94 * User needs root privileges t <<
95 <<
96 * This sysfs file will be crea <<
97 "H_AUTHORITY" or "H_PARAMETE <<
98 <<
99 HCALL with return error type <<
100 runtime by setting "Enable P <<
101 <<
102 * The end user reading this sy <<
103 underlying platform/firmware <<
104 <<
105 Possible error codes while rea <<
106 <<
107 * "-EPERM" : Partition is not <<
108 required to set "E <<
109 <<
110 * "-EIO" : Can't retrieve syst <<
111 or because of some <<
112 more information. <<
113 <<
114 * "-EFBIG" : System informatio <<
115 <<
116 What: /sys/devices/hv_gpci/interface <<
117 Date: July 2023 <<
118 Contact: Linux on PowerPC Developer Lis< <<
119 Description: admin read only <<
120 This sysfs file exposes the sy <<
121 H_GET_PERF_COUNTER_INFO. The H <<
122 PROCESSOR_CONFIG(0x90). <<
123 <<
124 * This sysfs file will be crea <<
125 <<
126 * User needs root privileges t <<
127 <<
128 * This sysfs file will be crea <<
129 "H_AUTHORITY" or "H_PARAMETE <<
130 <<
131 HCALL with return error type <<
132 runtime by setting "Enable P <<
133 <<
134 * The end user reading this sy <<
135 underlying platform/firmware <<
136 <<
137 Possible error codes while rea <<
138 <<
139 * "-EPERM" : Partition is not <<
140 required to set "E <<
141 <<
142 * "-EIO" : Can't retrieve syst <<
143 or because of some <<
144 more information. <<
145 <<
146 * "-EFBIG" : System informatio <<
147 <<
148 What: /sys/devices/hv_gpci/interface <<
149 Date: July 2023 <<
150 Contact: Linux on PowerPC Developer Lis< <<
151 Description: admin read only <<
152 This sysfs file exposes the sy <<
153 H_GET_PERF_COUNTER_INFO. The H <<
154 AFFINITY_DOMAIN_INFORMATION_BY <<
155 <<
156 * This sysfs file will be crea <<
157 <<
158 * User needs root privileges t <<
159 <<
160 * This sysfs file will be crea <<
161 "H_AUTHORITY" or "H_PARAMETE <<
162 <<
163 HCALL with return error type <<
164 runtime by setting "Enable P <<
165 <<
166 * The end user reading this sy <<
167 underlying platform/firmware <<
168 <<
169 Possible error codes while rea <<
170 <<
171 * "-EPERM" : Partition is not <<
172 required to set "E <<
173 <<
174 * "-EIO" : Can't retrieve syst <<
175 or because of some <<
176 more information. <<
177 <<
178 * "-EFBIG" : System informatio <<
179 <<
180 What: /sys/devices/hv_gpci/interface <<
181 Date: July 2023 <<
182 Contact: Linux on PowerPC Developer Lis< <<
183 Description: admin read only <<
184 This sysfs file exposes the sy <<
185 H_GET_PERF_COUNTER_INFO. The H <<
186 AFFINITY_DOMAIN_INFORMATION_BY <<
187 <<
188 * This sysfs file will be crea <<
189 <<
190 * User needs root privileges t <<
191 <<
192 * This sysfs file will be crea <<
193 "H_AUTHORITY" or "H_PARAMETE <<
194 <<
195 HCALL with return error type <<
196 runtime by setting "Enable P <<
197 <<
198 * The end user reading this sy <<
199 underlying platform/firmware <<
200 <<
201 Possible error codes while rea <<
202 <<
203 * "-EPERM" : Partition is not <<
204 required to set "E <<
205 <<
206 * "-EIO" : Can't retrieve syst <<
207 or because of some <<
208 more information. <<
209 <<
210 * "-EFBIG" : System informatio <<
211 <<
212 What: /sys/devices/hv_gpci/interface <<
213 Date: July 2023 <<
214 Contact: Linux on PowerPC Developer Lis< <<
215 Description: admin read only <<
216 This sysfs file exposes the sy <<
217 H_GET_PERF_COUNTER_INFO. The H <<
218 AFFINITY_DOMAIN_INFORMATION_BY <<
219 <<
220 * This sysfs file will be crea <<
221 <<
222 * User needs root privileges t <<
223 <<
224 * This sysfs file will be crea <<
225 "H_AUTHORITY" or "H_PARAMETE <<
226 <<
227 HCALL with return error type <<
228 runtime by setting "Enable P <<
229 <<
230 * The end user reading this sy <<
231 underlying platform/firmware <<
232 <<
233 Possible error codes while rea <<
234 <<
235 * "-EPERM" : Partition is not <<
236 required to set "E <<
237 <<
238 * "-EIO" : Can't retrieve syst <<
239 or because of some <<
240 more information. <<
241 <<
242 * "-EFBIG" : System informatio <<
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.