]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - lib/libpmc/pmc.westmereuc.3
pmc(3): mandoc clean ups
[FreeBSD/FreeBSD.git] / lib / libpmc / pmc.westmereuc.3
1 .\" Copyright (c) 2010 Fabien Thomas.  All rights reserved.
2 .\"
3 .\" Redistribution and use in source and binary forms, with or without
4 .\" modification, are permitted provided that the following conditions
5 .\" are met:
6 .\" 1. Redistributions of source code must retain the above copyright
7 .\"    notice, this list of conditions and the following disclaimer.
8 .\" 2. Redistributions in binary form must reproduce the above copyright
9 .\"    notice, this list of conditions and the following disclaimer in the
10 .\"    documentation and/or other materials provided with the distribution.
11 .\"
12 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
13 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
14 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
15 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
16 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
17 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
18 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
19 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
20 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
21 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
22 .\" SUCH DAMAGE.
23 .\"
24 .\" $FreeBSD$
25 .\"
26 .Dd March 24, 2010
27 .Dt PMC.WESTMEREUC 3
28 .Os
29 .Sh NAME
30 .Nm pmc.westmere
31 .Nd uncore measurement events for
32 .Tn Intel
33 .Tn Westmere
34 family CPUs
35 .Sh LIBRARY
36 .Lb libpmc
37 .Sh SYNOPSIS
38 .In pmc.h
39 .Sh DESCRIPTION
40 .Tn Intel
41 .Tn "Westmere"
42 CPUs contain PMCs conforming to version 2 of the
43 .Tn Intel
44 performance measurement architecture.
45 These CPUs contain two classes of PMCs:
46 .Bl -tag -width "Li PMC_CLASS_UCP"
47 .It Li PMC_CLASS_UCF
48 Fixed-function counters that count only one hardware event per counter.
49 .It Li PMC_CLASS_UCP
50 Programmable counters that may be configured to count one of a defined
51 set of hardware events.
52 .El
53 .Pp
54 The number of PMCs available in each class and their widths need to be
55 determined at run time by calling
56 .Xr pmc_cpuinfo 3 .
57 .Pp
58 Intel Westmere PMCs are documented in
59 .Rs
60 .%B "Intel(R) 64 and IA-32 Architectures Software Developes Manual"
61 .%T "Volume 3B: System Programming Guide, Part 2"
62 .%N "Order Number: 253669-033US"
63 .%D December 2009
64 .%Q "Intel Corporation"
65 .Re
66 .Ss WESTMERE UNCORE FIXED FUNCTION PMCS
67 These PMCs and their supported events are documented in
68 .Xr pmc.ucf 3 .
69 Not all CPUs in this family implement fixed-function counters.
70 .Ss WESTMERE UNCORE PROGRAMMABLE PMCS
71 The programmable PMCs support the following capabilities:
72 .Bl -column "PMC_CAP_INTERRUPT" "Support"
73 .It Em Capability Ta Em Support
74 .It PMC_CAP_CASCADE Ta \&No
75 .It PMC_CAP_EDGE Ta Yes
76 .It PMC_CAP_INTERRUPT Ta \&No
77 .It PMC_CAP_INVERT Ta Yes
78 .It PMC_CAP_READ Ta Yes
79 .It PMC_CAP_PRECISE Ta \&No
80 .It PMC_CAP_SYSTEM Ta \&No
81 .It PMC_CAP_TAGGING Ta \&No
82 .It PMC_CAP_THRESHOLD Ta Yes
83 .It PMC_CAP_USER Ta \&No
84 .It PMC_CAP_WRITE Ta Yes
85 .El
86 .Ss Event Qualifiers
87 Event specifiers for these PMCs support the following common
88 qualifiers:
89 .Bl -tag -width indent
90 .It Li cmask= Ns Ar value
91 Configure the PMC to increment only if the number of configured
92 events measured in a cycle is greater than or equal to
93 .Ar value .
94 .It Li edge
95 Configure the PMC to count the number of de-asserted to asserted
96 transitions of the conditions expressed by the other qualifiers.
97 If specified, the counter will increment only once whenever a
98 condition becomes true, irrespective of the number of clocks during
99 which the condition remains true.
100 .It Li inv
101 Invert the sense of comparison when the
102 .Dq Li cmask
103 qualifier is present, making the counter increment when the number of
104 events per cycle is less than the value specified by the
105 .Dq Li cmask
106 qualifier.
107 .El
108 .Ss Event Specifiers (Programmable PMCs)
109 Westmere uncore programmable PMCs support the following events:
110 .Bl -tag -width indent
111 .It Li GQ_CYCLES_FULL.READ_TRACKER
112 .Pq Event 00H , Umask 01H
113 Uncore cycles Global Queue read tracker is full.
114 .It Li GQ_CYCLES_FULL.WRITE_TRACKER
115 .Pq Event 00H , Umask 02H
116 Uncore cycles Global Queue write tracker is full.
117 .It Li GQ_CYCLES_FULL.PEER_PROBE_TRACKER
118 .Pq Event 00H , Umask 04H
119 Uncore cycles Global Queue peer probe tracker is full.
120 The peer probe tracker queue tracks snoops from the IOH and remote sockets.
121 .It Li GQ_CYCLES_NOT_EMPTY.READ_TRACKER
122 .Pq Event 01H , Umask 01H
123 Uncore cycles were Global Queue read tracker has at least one valid entry.
124 .It Li GQ_CYCLES_NOT_EMPTY.WRITE_TRACKER
125 .Pq Event 01H , Umask 02H
126 Uncore cycles were Global Queue write tracker has at least one valid entry.
127 .It Li GQ_CYCLES_NOT_EMPTY.PEER_PROBE_TRACKER
128 .Pq Event 01H , Umask 04H
129 Uncore cycles were Global Queue peer probe tracker has at least one valid entry.
130 The peer probe tracker queue tracks IOH and remote socket snoops.
131 .It Li GQ_OCCUPANCY.READ_TRACKER
132 .Pq Event 02H , Umask 01H
133 Increments the number of queue entries (code read, data read, and RFOs) in
134 the tread tracker.
135 The GQ read tracker allocate to deallocate occupancy count is divided by the
136 count to obtain the average read tracker latency.
137 .It Li GQ_ALLOC.READ_TRACKER
138 .Pq Event 03H , Umask 01H
139 Counts the number of tread tracker allocate to deallocate entries.
140 The GQ read tracker allocate to deallocate occupancy count is divided by
141 the count to obtain the average read tracker latency.
142 .It Li GQ_ALLOC.RT_L3_MISS
143 .Pq Event 03H , Umask 02H
144 Counts the number GQ read tracker entries for which a full cache line read
145 has missed the L3.
146 The GQ read tracker L3 miss to fill occupancy count is divided by this count
147 to obtain the average cache line read L3 miss latency.
148 The latency represents the time after which the L3 has determined that the
149 cache line has missed.
150 The time between a GQ read tracker allocation and the L3 determining that
151 the cache line has missed is the average L3 hit latency.
152 The total L3 cache line read miss latency is the hit latency + L3 miss
153 latency.
154 .It Li GQ_ALLOC.RT_TO_L3_RESP
155 .Pq Event 03H , Umask 04H
156 Counts the number of GQ read tracker entries that are allocated in the read
157 tracker queue that hit or miss the L3.
158 The GQ read tracker L3 hit occupancy count is divided by this count to obtain the average L3 hit latency.
159 .It Li GQ_ALLOC.RT_TO_RTID_ACQUIRED
160 .Pq Event 03H , Umask 08H
161 Counts the number of GQ read tracker entries that are allocated in the read
162 tracker, have missed in the L3 and have not acquired a Request Transaction ID.
163 The GQ read tracker L3 miss to RTID acquired occupancy count is
164 divided by this count to obtain the average latency for a read L3 miss to
165 acquire an RTID.
166 .It Li GQ_ALLOC.WT_TO_RTID_ACQUIRED
167 .Pq Event 03H , Umask 10H
168 Counts the number of GQ write tracker entries that are allocated in the
169 write tracker, have missed in the L3 and have not acquired a Request
170 Transaction ID.
171 The GQ write tracker L3 miss to RTID occupancy count is divided by this count
172 to obtain the average latency for a write L3 miss to acquire an RTID.
173 .It Li GQ_ALLOC.WRITE_TRACKER
174 .Pq Event 03H , Umask 20H
175 Counts the number of GQ write tracker entries that are allocated in the write
176 tracker queue that miss the L3.
177 The GQ write tracker occupancy count
178 is divided by the this count to obtain the average L3 write miss latency.
179 .It Li GQ_ALLOC.PEER_PROBE_TRACKER
180 .Pq Event 03H , Umask 40H
181 Counts the number of GQ peer probe tracker (snoop) entries that are
182 allocated in the peer probe tracker queue that miss the L3.
183 The GQ peer probe occupancy count is divided by this count to obtain the average
184 L3 peer probe miss latency.
185 .It Li GQ_DATA.FROM_QPI
186 .Pq Event 04H , Umask 01H
187 Cycles Global Queue Quickpath Interface input data port is busy importing
188 data from the Quickpath Interface.
189 Each cycle the input port can transfer 8 or 16 bytes of data.
190 .It Li GQ_DATA.FROM_QMC
191 .Pq Event 04H , Umask 02H
192 Cycles Global Queue Quickpath Memory Interface input data port is busy
193 importing data from the Quickpath Memory Interface.
194 Each cycle the input port can transfer 8 or 16 bytes of data.
195 .It Li GQ_DATA.FROM_L3
196 .Pq Event 04H , Umask 04H
197 Cycles GQ L3 input data port is busy importing data from the Last Level Cache.
198 Each cycle the input port can transfer 32 bytes of data.
199 .It Li GQ_DATA.FROM_CORES_02
200 .Pq Event 04H , Umask 08H
201 Cycles GQ Core 0 and 2 input data port is busy importing data from processor
202 cores 0 and 2.
203 Each cycle the input port can transfer 32 bytes of data.
204 .It Li GQ_DATA.FROM_CORES_13
205 .Pq Event 04H , Umask 10H
206 Cycles GQ Core 1 and 3 input data port is busy importing data from processor
207 cores 1 and 3.
208 Each cycle the input port can transfer 32 bytes of data.
209 .It Li GQ_DATA.TO_QPI_QMC
210 .Pq Event 05H , Umask 01H
211 Cycles GQ QPI and QMC output data port is busy sending data to the Quickpath
212 Interface or Quickpath Memory Interface.
213 Each cycle the output port can transfer 32 bytes of data.
214 .It Li GQ_DATA.TO_L3
215 .Pq Event 05H , Umask 02H
216 Cycles GQ L3 output data port is busy sending data to the Last Level Cache.
217 Each cycle the output port can transfer 32 bytes of data.
218 .It Li GQ_DATA.TO_CORES
219 .Pq Event 05H , Umask 04H
220 Cycles GQ Core output data port is busy sending data to the Cores.
221 Each cycle the output port can transfer 32 bytes of data.
222 .It Li SNP_RESP_TO_LOCAL_HOME.I_STATE
223 .Pq Event 06H , Umask 01H
224 Number of snoop responses to the local home that L3 does not have the
225 referenced cache line.
226 .It Li SNP_RESP_TO_LOCAL_HOME.S_STATE
227 .Pq Event 06H , Umask 02H
228 Number of snoop responses to the local home that L3 has the referenced line
229 cached in the S state.
230 .It Li SNP_RESP_TO_LOCAL_HOME.FWD_S_STATE
231 .Pq Event 06H , Umask 04H
232 Number of responses to code or data read snoops to the local home that the
233 L3 has the referenced cache line in the E state.
234 The L3 cache line state is changed to the S state and the line is forwarded
235 to the local home in the S state.
236 .It Li SNP_RESP_TO_LOCAL_HOME.FWD_I_STATE
237 .Pq Event 06H , Umask 08H
238 Number of responses to read invalidate snoops to the local home that the L3
239 has the referenced cache line in the M state.
240 The L3 cache line state is invalidated and the line is forwarded to the
241 local home in the M state.
242 .It Li SNP_RESP_TO_LOCAL_HOME.CONFLICT
243 .Pq Event 06H , Umask 10H
244 Number of conflict snoop responses sent to the local home.
245 .It Li SNP_RESP_TO_LOCAL_HOME.WB
246 .Pq Event 06H , Umask 20H
247 Number of responses to code or data read snoops to the local home that the
248 L3 has the referenced line cached in the M state.
249 .It Li SNP_RESP_TO_REMOTE_HOME.I_STATE
250 .Pq Event 07H , Umask 01H
251 Number of snoop responses to a remote home that L3 does not have the
252 referenced cache line.
253 .It Li SNP_RESP_TO_REMOTE_HOME.S_STATE
254 .Pq Event 07H , Umask 02H
255 Number of snoop responses to a remote home that L3 has the referenced line
256 cached in the S state.
257 .It Li SNP_RESP_TO_REMOTE_HOME.FWD_S_STATE
258 .Pq Event 07H , Umask 04H
259 Number of responses to code or data read snoops to a remote home that the L3
260 has the referenced cache line in the E state.
261 The L3 cache line state is changed to the S state and the line is forwarded
262 to the remote home in the S state.
263 .It Li SNP_RESP_TO_REMOTE_HOME.FWD_I_STATE
264 .Pq Event 07H , Umask 08H
265 Number of responses to read invalidate snoops to a remote home that the L3
266 has the referenced cache line in the M state.
267 The L3 cache line state is invalidated and the line is forwarded to the
268 remote home in the M state.
269 .It Li SNP_RESP_TO_REMOTE_HOME.CONFLICT
270 .Pq Event 07H , Umask 10H
271 Number of conflict snoop responses sent to the local home.
272 .It Li SNP_RESP_TO_REMOTE_HOME.WB
273 .Pq Event 07H , Umask 20H
274 Number of responses to code or data read snoops to a remote home that the L3
275 has the referenced line cached in the M state.
276 .It Li SNP_RESP_TO_REMOTE_HOME.HITM
277 .Pq Event 07H , Umask 24H
278 Number of HITM snoop responses to a remote home.
279 .It Li L3_HITS.READ
280 .Pq Event 08H , Umask 01H
281 Number of code read, data read and RFO requests that hit in the L3.
282 .It Li L3_HITS.WRITE
283 .Pq Event 08H , Umask 02H
284 Number of writeback requests that hit in the L3.
285 Writebacks from the cores will always result in L3 hits due to the
286 inclusive property of the L3.
287 .It Li L3_HITS.PROBE
288 .Pq Event 08H , Umask 04H
289 Number of snoops from IOH or remote sockets that hit in the L3.
290 .It Li L3_HITS.ANY
291 .Pq Event 08H , Umask 03H
292 Number of reads and writes that hit the L3.
293 .It Li L3_MISS.READ
294 .Pq Event 09H , Umask 01H
295 Number of code read, data read and RFO requests that miss the L3.
296 .It Li L3_MISS.WRITE
297 .Pq Event 09H , Umask 02H
298 Number of writeback requests that miss the L3.
299 Should always be zero as writebacks from the cores will always result in L3 hits due to the inclusive
300 property of the L3.
301 .It Li L3_MISS.PROBE
302 .Pq Event 09H , Umask 04H
303 Number of snoops from IOH or remote sockets that miss the L3.
304 .It Li L3_MISS.ANY
305 .Pq Event 09H , Umask 03H
306 Number of reads and writes that miss the L3.
307 .It Li L3_LINES_IN.M_STATE
308 .Pq Event 0AH , Umask 01H
309 Counts the number of L3 lines allocated in M state.
310 The only time a cache line is allocated in the M state is when the
311 line was forwarded in M state is forwarded due to a Snoop Read Invalidate Own request.
312 .It Li L3_LINES_IN.E_STATE
313 .Pq Event 0AH , Umask 02H
314 Counts the number of L3 lines allocated in E state.
315 .It Li L3_LINES_IN.S_STATE
316 .Pq Event 0AH , Umask 04H
317 Counts the number of L3 lines allocated in S state.
318 .It Li L3_LINES_IN.F_STATE
319 .Pq Event 0AH , Umask 08H
320 Counts the number of L3 lines allocated in F state.
321 .It Li L3_LINES_IN.ANY
322 .Pq Event 0AH , Umask 0FH
323 Counts the number of L3 lines allocated in any state.
324 .It Li L3_LINES_OUT.M_STATE
325 .Pq Event 0BH , Umask 01H
326 Counts the number of L3 lines victimized that were in the M state.
327 When the victim cache line is in M state, the line is written to its home cache agent
328 which can be either local or remote.
329 .It Li L3_LINES_OUT.E_STATE
330 .Pq Event 0BH , Umask 02H
331 Counts the number of L3 lines victimized that were in the E state.
332 .It Li L3_LINES_OUT.S_STATE
333 .Pq Event 0BH , Umask 04H
334 Counts the number of L3 lines victimized that were in the S state.
335 .It Li L3_LINES_OUT.I_STATE
336 .Pq Event 0BH , Umask 08H
337 Counts the number of L3 lines victimized that were in the I state.
338 .It Li L3_LINES_OUT.F_STATE
339 .Pq Event 0BH , Umask 10H
340 Counts the number of L3 lines victimized that were in the F state.
341 .It Li L3_LINES_OUT.ANY
342 .Pq Event 0BH , Umask 1FH
343 Counts the number of L3 lines victimized in any state.
344 .It Li GQ_SNOOP.GOTO_S
345 .Pq Event 0CH , Umask 01H
346 Counts the number of remote snoops that have requested a cache line be set
347 to the S state.
348 .It Li GQ_SNOOP.GOTO_I
349 .Pq Event 0CH , Umask 02H
350 Counts the number of remote snoops that have requested a cache line be set
351 to the I state.
352 .It Li GQ_SNOOP.GOTO_S_HIT_E
353 .Pq Event 0CH , Umask 04H
354 Counts the number of remote snoops that have requested a cache line be set
355 to the S state from E state.
356 Requires writing MSR 301H with mask = 2H
357 .It Li GQ_SNOOP.GOTO_S_HIT_F
358 .Pq Event 0CH , Umask 04H
359 Counts the number of remote snoops that have requested a cache line be set
360 to the S state from F (forward) state.
361 Requires writing MSR 301H with mask = 8H
362 .It Li GQ_SNOOP.GOTO_S_HIT_M
363 .Pq Event 0CH , Umask 04H
364 Counts the number of remote snoops that have requested a cache line be set
365 to the S state from M state.
366 Requires writing MSR 301H with mask = 1H
367 .It Li GQ_SNOOP.GOTO_S_HIT_S
368 .Pq Event 0CH , Umask 04H
369 Counts the number of remote snoops that have requested a cache line be set
370 to the S state from S state.
371 Requires writing MSR 301H with mask = 4H
372 .It Li GQ_SNOOP.GOTO_I_HIT_E
373 .Pq Event 0CH , Umask 08H
374 Counts the number of remote snoops that have requested a cache line be set
375 to the I state from E state.
376 Requires writing MSR 301H with mask = 2H
377 .It Li GQ_SNOOP.GOTO_I_HIT_F
378 .Pq Event 0CH , Umask 08H
379 Counts the number of remote snoops that have requested a cache line be set
380 to the I state from F (forward) state.
381 Requires writing MSR 301H with mask = 8H
382 .It Li GQ_SNOOP.GOTO_I_HIT_M
383 .Pq Event 0CH , Umask 08H
384 Counts the number of remote snoops that have requested a cache line be set
385 to the I state from M state.
386 Requires writing MSR 301H with mask = 1H
387 .It Li GQ_SNOOP.GOTO_I_HIT_S
388 .Pq Event 0CH , Umask 08H
389 Counts the number of remote snoops that have requested a cache line be set
390 to the I state from S state.
391 Requires writing MSR 301H with mask = 4H
392 .It Li QHL_REQUESTS.IOH_READS
393 .Pq Event 20H , Umask 01H
394 Counts number of Quickpath Home Logic read requests from the IOH.
395 .It Li QHL_REQUESTS.IOH_WRITES
396 .Pq Event 20H , Umask 02H
397 Counts number of Quickpath Home Logic write requests from the IOH.
398 .It Li QHL_REQUESTS.REMOTE_READS
399 .Pq Event 20H , Umask 04H
400 Counts number of Quickpath Home Logic read requests from a remote socket.
401 .It Li QHL_REQUESTS.REMOTE_WRITES
402 .Pq Event 20H , Umask 08H
403 Counts number of Quickpath Home Logic write requests from a remote socket.
404 .It Li QHL_REQUESTS.LOCAL_READS
405 .Pq Event 20H , Umask 10H
406 Counts number of Quickpath Home Logic read requests from the local socket.
407 .It Li QHL_REQUESTS.LOCAL_WRITES
408 .Pq Event 20H , Umask 20H
409 Counts number of Quickpath Home Logic write requests from the local socket.
410 .It Li QHL_CYCLES_FULL.IOH
411 .Pq Event 21H , Umask 01H
412 Counts uclk cycles all entries in the Quickpath Home Logic IOH are full.
413 .It Li QHL_CYCLES_FULL.REMOTE
414 .Pq Event 21H , Umask 02H
415 Counts uclk cycles all entries in the Quickpath Home Logic remote tracker
416 are full.
417 .It Li QHL_CYCLES_FULL.LOCAL
418 .Pq Event 21H , Umask 04H
419 Counts uclk cycles all entries in the Quickpath Home Logic local tracker are
420 full.
421 .It Li QHL_CYCLES_NOT_EMPTY.IOH
422 .Pq Event 22H , Umask 01H
423 Counts uclk cycles all entries in the Quickpath Home Logic IOH is busy.
424 .It Li QHL_CYCLES_NOT_EMPTY.REMOTE
425 .Pq Event 22H , Umask 02H
426 Counts uclk cycles all entries in the Quickpath Home Logic remote tracker is
427 busy.
428 .It Li QHL_CYCLES_NOT_EMPTY.LOCAL
429 .Pq Event 22H , Umask 04H
430 Counts uclk cycles all entries in the Quickpath Home Logic local tracker is
431 busy.
432 .It Li QHL_OCCUPANCY.IOH
433 .Pq Event 23H , Umask 01H
434 QHL IOH tracker allocate to deallocate read occupancy.
435 .It Li QHL_OCCUPANCY.REMOTE
436 .Pq Event 23H , Umask 02H
437 QHL remote tracker allocate to deallocate read occupancy.
438 .It Li QHL_OCCUPANCY.LOCAL
439 .Pq Event 23H , Umask 04H
440 QHL local tracker allocate to deallocate read occupancy.
441 .It Li QHL_ADDRESS_CONFLICTS.2WAY
442 .Pq Event 24H , Umask 02H
443 Counts number of QHL Active Address Table (AAT) entries that saw a max of 2 conflicts.
444 The AAT is a structure that tracks requests that are in conflict.
445 The requests themselves are in the home tracker entries.
446 The count is reported when an AAT entry deallocates.
447 .It Li QHL_ADDRESS_CONFLICTS.3WAY
448 .Pq Event 24H , Umask 04H
449 Counts number of QHL Active Address Table (AAT) entries that saw a max of 3 conflicts.
450 The AAT is a structure that tracks requests that are in conflict.
451 The requests themselves are in the home tracker entries.
452 The count is reported when an AAT entry deallocates.
453 .It Li QHL_CONFLICT_CYCLES.IOH
454 .Pq Event 25H , Umask 01H
455 Counts cycles the Quickpath Home Logic IOH Tracker contains two or more
456 requests with an address conflict.
457 A max of 3 requests can be in conflict.
458 .It Li QHL_CONFLICT_CYCLES.REMOTE
459 .Pq Event 25H , Umask 02H
460 Counts cycles the Quickpath Home Logic Remote Tracker contains two or more
461 requests with an address conflict.
462 A max of 3 requests can be in conflict.
463 .It Li QHL_CONFLICT_CYCLES.LOCAL
464 .Pq Event 25H , Umask 04H
465 Counts cycles the Quickpath Home Logic Local Tracker contains two or more
466 requests with an address conflict.
467 A max of 3 requests can be in conflict.
468 .It Li QHL_TO_QMC_BYPASS
469 .Pq Event 26H , Umask 01H
470 Counts number or requests to the Quickpath Memory Controller that bypass the
471 Quickpath Home Logic.
472 All local accesses can be bypassed.
473 For remote requests, only read requests can be bypassed.
474 .It Li QMC_ISOC_FULL.READ.CH0
475 .Pq Event 28H , Umask 01H
476 Counts cycles all the entries in the DRAM channel 0 high priority queue are
477 occupied with isochronous read requests.
478 .It Li QMC_ISOC_FULL.READ.CH1
479 .Pq Event 28H , Umask 02H
480 Counts cycles all the entries in the DRAM channel 1 high priority queue are
481 occupied with isochronous read requests.
482 .It Li QMC_ISOC_FULL.READ.CH2
483 .Pq Event 28H , Umask 04H
484 Counts cycles all the entries in the DRAM channel 2 high priority queue are
485 occupied with isochronous read requests.
486 .It Li QMC_ISOC_FULL.WRITE.CH0
487 .Pq Event 28H , Umask 08H
488 Counts cycles all the entries in the DRAM channel 0 high priority queue are
489 occupied with isochronous write requests.
490 .It Li QMC_ISOC_FULL.WRITE.CH1
491 .Pq Event 28H , Umask 10H
492 Counts cycles all the entries in the DRAM channel 1 high priority queue are
493 occupied with isochronous write requests.
494 .It Li QMC_ISOC_FULL.WRITE.CH2
495 .Pq Event 28H , Umask 20H
496 Counts cycles all the entries in the DRAM channel 2 high priority queue are
497 occupied with isochronous write requests.
498 .It Li QMC_BUSY.READ.CH0
499 .Pq Event 29H , Umask 01H
500 Counts cycles where Quickpath Memory Controller has at least 1 outstanding
501 read request to DRAM channel 0.
502 .It Li QMC_BUSY.READ.CH1
503 .Pq Event 29H , Umask 02H
504 Counts cycles where Quickpath Memory Controller has at least 1 outstanding
505 read request to DRAM channel 1.
506 .It Li QMC_BUSY.READ.CH2
507 .Pq Event 29H , Umask 04H
508 Counts cycles where Quickpath Memory Controller has at least 1 outstanding
509 read request to DRAM channel 2.
510 .It Li QMC_BUSY.WRITE.CH0
511 .Pq Event 29H , Umask 08H
512 Counts cycles where Quickpath Memory Controller has at least 1 outstanding
513 write request to DRAM channel 0.
514 .It Li QMC_BUSY.WRITE.CH1
515 .Pq Event 29H , Umask 10H
516 Counts cycles where Quickpath Memory Controller has at least 1 outstanding
517 write request to DRAM channel 1.
518 .It Li QMC_BUSY.WRITE.CH2
519 .Pq Event 29H , Umask 20H
520 Counts cycles where Quickpath Memory Controller has at least 1 outstanding
521 write request to DRAM channel 2.
522 .It Li QMC_OCCUPANCY.CH0
523 .Pq Event 2AH , Umask 01H
524 IMC channel 0 normal read request occupancy.
525 .It Li QMC_OCCUPANCY.CH1
526 .Pq Event 2AH , Umask 02H
527 IMC channel 1 normal read request occupancy.
528 .It Li QMC_OCCUPANCY.CH2
529 .Pq Event 2AH , Umask 04H
530 IMC channel 2 normal read request occupancy.
531 .It Li QMC_OCCUPANCY.ANY
532 .Pq Event 2AH , Umask 07H
533 Normal read request occupancy for any channel.
534 .It Li QMC_ISSOC_OCCUPANCY.CH0
535 .Pq Event 2BH , Umask 01H
536 IMC channel 0 issoc read request occupancy.
537 .It Li QMC_ISSOC_OCCUPANCY.CH1
538 .Pq Event 2BH , Umask 02H
539 IMC channel 1 issoc read request occupancy.
540 .It Li QMC_ISSOC_OCCUPANCY.CH2
541 .Pq Event 2BH , Umask 04H
542 IMC channel 2 issoc read request occupancy.
543 .It Li QMC_ISSOC_READS.ANY
544 .Pq Event 2BH , Umask 07H
545 IMC issoc read request occupancy.
546 .It Li QMC_NORMAL_READS.CH0
547 .Pq Event 2CH , Umask 01H
548 Counts the number of Quickpath Memory Controller channel 0 medium and low
549 priority read requests.
550 The QMC channel 0 normal read occupancy divided by this count provides the
551 average QMC channel 0 read latency.
552 .It Li QMC_NORMAL_READS.CH1
553 .Pq Event 2CH , Umask 02H
554 Counts the number of Quickpath Memory Controller channel 1 medium and low
555 priority read requests.
556 The QMC channel 1 normal read occupancy divided by this count provides the
557 average QMC channel 1 read latency.
558 .It Li QMC_NORMAL_READS.CH2
559 .Pq Event 2CH , Umask 04H
560 Counts the number of Quickpath Memory Controller channel 2 medium and low
561 priority read requests.
562 The QMC channel 2 normal read occupancy divided by this count provides the
563 average QMC channel 2 read latency.
564 .It Li QMC_NORMAL_READS.ANY
565 .Pq Event 2CH , Umask 07H
566 Counts the number of Quickpath Memory Controller medium and low priority read requests.
567 The QMC normal read occupancy divided by this count provides the average
568 QMC read latency.
569 .It Li QMC_HIGH_PRIORITY_READS.CH0
570 .Pq Event 2DH , Umask 01H
571 Counts the number of Quickpath Memory Controller channel 0 high priority
572 isochronous read requests.
573 .It Li QMC_HIGH_PRIORITY_READS.CH1
574 .Pq Event 2DH , Umask 02H
575 Counts the number of Quickpath Memory Controller channel 1 high priority
576 isochronous read requests.
577 .It Li QMC_HIGH_PRIORITY_READS.CH2
578 .Pq Event 2DH , Umask 04H
579 Counts the number of Quickpath Memory Controller channel 2 high priority
580 isochronous read requests.
581 .It Li QMC_HIGH_PRIORITY_READS.ANY
582 .Pq Event 2DH , Umask 07H
583 Counts the number of Quickpath Memory Controller high priority isochronous
584 read requests.
585 .It Li QMC_CRITICAL_PRIORITY_READS.CH0
586 .Pq Event 2EH , Umask 01H
587 Counts the number of Quickpath Memory Controller channel 0 critical priority
588 isochronous read requests.
589 .It Li QMC_CRITICAL_PRIORITY_READS.CH1
590 .Pq Event 2EH , Umask 02H
591 Counts the number of Quickpath Memory Controller channel 1 critical priority
592 isochronous read requests.
593 .It Li QMC_CRITICAL_PRIORITY_READS.CH2
594 .Pq Event 2EH , Umask 04H
595 Counts the number of Quickpath Memory Controller channel 2 critical priority
596 isochronous read requests.
597 .It Li QMC_CRITICAL_PRIORITY_READS.ANY
598 .Pq Event 2EH , Umask 07H
599 Counts the number of Quickpath Memory Controller critical priority
600 isochronous read requests.
601 .It Li QMC_WRITES.FULL.CH0
602 .Pq Event 2FH , Umask 01H
603 Counts number of full cache line writes to DRAM channel 0.
604 .It Li QMC_WRITES.FULL.CH1
605 .Pq Event 2FH , Umask 02H
606 Counts number of full cache line writes to DRAM channel 1.
607 .It Li QMC_WRITES.FULL.CH2
608 .Pq Event 2FH , Umask 04H
609 Counts number of full cache line writes to DRAM channel 2.
610 .It Li QMC_WRITES.FULL.ANY
611 .Pq Event 2FH , Umask 07H
612 Counts number of full cache line writes to DRAM.
613 .It Li QMC_WRITES.PARTIAL.CH0
614 .Pq Event 2FH , Umask 08H
615 Counts number of partial cache line writes to DRAM channel 0.
616 .It Li QMC_WRITES.PARTIAL.CH1
617 .Pq Event 2FH , Umask 10H
618 Counts number of partial cache line writes to DRAM channel 1.
619 .It Li QMC_WRITES.PARTIAL.CH2
620 .Pq Event 2FH , Umask 20H
621 Counts number of partial cache line writes to DRAM channel 2.
622 .It Li QMC_WRITES.PARTIAL.ANY
623 .Pq Event 2FH , Umask 38H
624 Counts number of partial cache line writes to DRAM.
625 .It Li QMC_CANCEL.CH0
626 .Pq Event 30H , Umask 01H
627 Counts number of DRAM channel 0 cancel requests.
628 .It Li QMC_CANCEL.CH1
629 .Pq Event 30H , Umask 02H
630 Counts number of DRAM channel 1 cancel requests.
631 .It Li QMC_CANCEL.CH2
632 .Pq Event 30H , Umask 04H
633 Counts number of DRAM channel 2 cancel requests.
634 .It Li QMC_CANCEL.ANY
635 .Pq Event 30H , Umask 07H
636 Counts number of DRAM cancel requests.
637 .It Li QMC_PRIORITY_UPDATES.CH0
638 .Pq Event 31H , Umask 01H
639 Counts number of DRAM channel 0 priority updates.
640 A priority update occurs when an ISOC high or critical request is
641 received by the QHL and there is a matching request with normal priority
642 that has already been issued to the QMC.
643 In this instance, the QHL will send a priority update to QMC to
644 expedite the request.
645 .It Li QMC_PRIORITY_UPDATES.CH1
646 .Pq Event 31H , Umask 02H
647 Counts number of DRAM channel 1 priority updates.
648 A priority update occurs when an ISOC high or critical request is received
649 by the QHL and there is a matching request with normal priority that has
650 already been issued to the QMC.
651 In this instance, the QHL will send a priority update to QMC to expedite the request.
652 .It Li QMC_PRIORITY_UPDATES.CH2
653 .Pq Event 31H , Umask 04H
654 Counts number of DRAM channel 2 priority updates.
655 A priority update occurs when an ISOC high or critical request is received
656 by the QHL and there is a matching request with normal priority that has
657 already been issued to the QMC.
658 In this instance, the QHL will send a priority update to QMC to expedite the request.
659 .It Li QMC_PRIORITY_UPDATES.ANY
660 .Pq Event 31H , Umask 07H
661 Counts number of DRAM priority updates.
662 A priority update occurs when an ISOC high or critical request is received
663 by the QHL and there is a matching request with normal priority that has already
664 been issued to the QMC.
665 In this instance, the QHL will send a priority update to QMC to expedite the request.
666 .It Li IMC_RETRY.CH0
667 .Pq Event 32H , Umask 01H
668 Counts number of IMC DRAM channel 0 retries.
669 DRAM retry only occurs when configured in RAS mode.
670 .It Li IMC_RETRY.CH1
671 .Pq Event 32H , Umask 02H
672 Counts number of IMC DRAM channel 1 retries.
673 DRAM retry only occurs when configured in RAS mode.
674 .It Li IMC_RETRY.CH2
675 .Pq Event 32H , Umask 04H
676 Counts number of IMC DRAM channel 2 retries.
677 DRAM retry only occurs when configured in RAS mode.
678 .It Li IMC_RETRY.ANY
679 .Pq Event 32H , Umask 07H
680 Counts number of IMC DRAM retries from any channel.
681 DRAM retry only occurs when configured in RAS mode.
682 .It Li QHL_FRC_ACK_CNFLTS.IOH
683 .Pq Event 33H , Umask 01H
684 Counts number of Force Acknowledge Conflict messages sent by the Quickpath
685 Home Logic to the IOH.
686 .It Li QHL_FRC_ACK_CNFLTS.REMOTE
687 .Pq Event 33H , Umask 02H
688 Counts number of Force Acknowledge Conflict messages sent by the Quickpath
689 Home Logic to the remote home.
690 .It Li QHL_FRC_ACK_CNFLTS.LOCAL
691 .Pq Event 33H , Umask 04H
692 Counts number of Force Acknowledge Conflict messages sent by the Quickpath
693 Home Logic to the local home.
694 .It Li QHL_FRC_ACK_CNFLTS.ANY
695 .Pq Event 33H , Umask 07H
696 Counts number of Force Acknowledge Conflict messages sent by the Quickpath
697 Home Logic.
698 .It Li QHL_SLEEPS.IOH_ORDER
699 .Pq Event 34H , Umask 01H
700 Counts number of occurrences a request was put to sleep due to IOH ordering
701 (write after read) conflicts.
702 While in the sleep state, the request is not eligible to be scheduled to the QMC.
703 .It Li QHL_SLEEPS.REMOTE_ORDER
704 .Pq Event 34H , Umask 02H
705 Counts number of occurrences a request was put to sleep due to remote socket
706 ordering (write after read) conflicts.
707 While in the sleep state, the request is not eligible to be scheduled to the QMC.
708 .It Li QHL_SLEEPS.LOCAL_ORDER
709 .Pq Event 34H , Umask 04H
710 Counts number of occurrences a request was put to sleep due to local socket
711 ordering (write after read) conflicts.
712 While in the sleep state, the request is not eligible to be scheduled to the QMC.
713 .It Li QHL_SLEEPS.IOH_CONFLICT
714 .Pq Event 34H , Umask 08H
715 Counts number of occurrences a request was put to sleep due to IOH address conflicts.
716 While in the sleep state, the request is not eligible to be scheduled to the QMC.
717 .It Li QHL_SLEEPS.REMOTE_CONFLICT
718 .Pq Event 34H , Umask 10H
719 Counts number of occurrences a request was put to sleep due to remote socket
720 address conflicts.
721 While in the sleep state, the request is not eligible to be scheduled to the QMC.
722 .It Li QHL_SLEEPS.LOCAL_CONFLICT
723 .Pq Event 34H , Umask 20H
724 Counts number of occurrences a request was put to sleep due to local socket address conflicts.
725 While in the sleep state, the request is not eligible to be scheduled to the QMC.
726 .It Li ADDR_OPCODE_MATCH.IOH
727 .Pq Event 35H , Umask 01H
728 Counts number of requests from the IOH, address/opcode of request is
729 qualified by mask value written to MSR 396H.
730 The following mask values are supported:
731 0: NONE 40000000_00000000H:RSPFWDI 40001A00_00000000H:RSPFWDS
732 40001D00_00000000H:RSPIWB
733 Match opcode/address by writing MSR 396H with mask supported mask value.
734 .It Li ADDR_OPCODE_MATCH.REMOTE
735 .Pq Event 35H , Umask 02H
736 Counts number of requests from the remote socket, address/opcode of request
737 is qualified by mask value written to MSR 396H.
738 The following mask values are supported:
739 0: NONE 40000000_00000000H:RSPFWDI 40001A00_00000000H:RSPFWDS
740 40001D00_00000000H:RSPIWB
741 Match opcode/address by writing MSR 396H with mask supported mask value.
742 .It Li ADDR_OPCODE_MATCH.LOCAL
743 .Pq Event 35H , Umask 04H
744 Counts number of requests from the local socket, address/opcode of request
745 is qualified by mask value written to MSR 396H.
746 The following mask values are supported:
747 0: NONE 40000000_00000000H:RSPFWDI 40001A00_00000000H:RSPFWDS
748 40001D00_00000000H:RSPIWB
749 Match opcode/address by writing MSR 396H with mask supported mask value.
750 .It Li QPI_TX_STALLED_SINGLE_FLIT.HOME.LINK_0
751 .Pq Event 40H , Umask 01H
752 Counts cycles the Quickpath outbound link 0 HOME virtual channel is stalled
753 due to lack of a VNA and VN0 credit.
754 Note that this event does not filter out when a flit would not have been selected
755 for arbitration because another virtual channel is getting arbitrated.
756 .It Li QPI_TX_STALLED_SINGLE_FLIT.SNOOP.LINK_0
757 .Pq Event 40H , Umask 02H
758 Counts cycles the Quickpath outbound link 0 SNOOP virtual channel is stalled
759 due to lack of a VNA and VN0 credit.
760 Note that this event does not filter out when a flit would not have been selected
761 for arbitration because another virtual channel is getting arbitrated.
762 .It Li QPI_TX_STALLED_SINGLE_FLIT.NDR.LINK_0
763 .Pq Event 40H , Umask 04H
764 Counts cycles the Quickpath outbound link 0 non-data response virtual
765 channel is stalled due to lack of a VNA and VN0 credit.
766 Note that this event does not filter out when a flit would not have been selected
767 for arbitration because another virtual channel is getting arbitrated.
768 .It Li QPI_TX_STALLED_SINGLE_FLIT.HOME.LINK_1
769 .Pq Event 40H , Umask 08H
770 Counts cycles the Quickpath outbound link 1 HOME virtual channel is stalled
771 due to lack of a VNA and VN0 credit.
772 Note that this event does not filter out when a flit would not have been selected
773 for arbitration because another virtual channel is getting arbitrated.
774 .It Li QPI_TX_STALLED_SINGLE_FLIT.SNOOP.LINK_1
775 .Pq Event 40H , Umask 10H
776 Counts cycles the Quickpath outbound link 1 SNOOP virtual channel is stalled
777 due to lack of a VNA and VN0 credit.
778 Note that this event does not filter out when a flit would not have been selected
779 for arbitration because another virtual channel is getting arbitrated.
780 .It Li QPI_TX_STALLED_SINGLE_FLIT.NDR.LINK_1
781 .Pq Event 40H , Umask 20H
782 Counts cycles the Quickpath outbound link 1 non-data response virtual
783 channel is stalled due to lack of a VNA and VN0 credit.
784 Note that this event does not filter out when a flit would not have been selected
785 for arbitration because another virtual channel is getting arbitrated.
786 .It Li QPI_TX_STALLED_SINGLE_FLIT.LINK_0
787 .Pq Event 40H , Umask 07H
788 Counts cycles the Quickpath outbound link 0 virtual channels are stalled due
789 to lack of a VNA and VN0 credit.
790 Note that this event does not filter out when a flit would not have been selected
791 for arbitration because another virtual channel is getting arbitrated.
792 .It Li QPI_TX_STALLED_SINGLE_FLIT.LINK_1
793 .Pq Event 40H , Umask 38H
794 Counts cycles the Quickpath outbound link 1 virtual channels are stalled due
795 to lack of a VNA and VN0 credit.
796 Note that this event does not filter out when a flit would not have been selected
797 for arbitration because another virtual channel is getting arbitrated.
798 .It Li QPI_TX_STALLED_MULTI_FLIT.DRS.LINK_0
799 .Pq Event 41H , Umask 01H
800 Counts cycles the Quickpath outbound link 0 Data ResponSe virtual channel is
801 stalled due to lack of VNA and VN0 credits.
802 Note that this event does not filter out when a flit would not have been selected
803 for arbitration because another virtual channel is getting arbitrated.
804 .It Li QPI_TX_STALLED_MULTI_FLIT.NCB.LINK_0
805 .Pq Event 41H , Umask 02H
806 Counts cycles the Quickpath outbound link 0 Non-Coherent Bypass virtual
807 channel is stalled due to lack of VNA and VN0 credits.
808 Note that this event does not filter out when a flit would not have been selected
809 for arbitration because another virtual channel is getting arbitrated.
810 .It Li QPI_TX_STALLED_MULTI_FLIT.NCS.LINK_0
811 .Pq Event 41H , Umask 04H
812 Counts cycles the Quickpath outbound link 0 Non-Coherent Standard virtual
813 channel is stalled due to lack of VNA and VN0 credits.
814 Note that this event does not filter out when a flit would not have been selected
815 for arbitration because another virtual channel is getting arbitrated.
816 .It Li QPI_TX_STALLED_MULTI_FLIT.DRS.LINK_1
817 .Pq Event 41H , Umask 08H
818 Counts cycles the Quickpath outbound link 1 Data ResponSe virtual channel is
819 stalled due to lack of VNA and VN0 credits.
820 Note that this event does not filter out when a flit would not have been selected
821 for arbitration because another virtual channel is getting arbitrated.
822 .It Li QPI_TX_STALLED_MULTI_FLIT.NCB.LINK_1
823 .Pq Event 41H , Umask 10H
824 Counts cycles the Quickpath outbound link 1 Non-Coherent Bypass virtual
825 channel is stalled due to lack of VNA and VN0 credits.
826 Note that this event does not filter out when a flit would not have been selected
827 for arbitration because another virtual channel is getting arbitrated.
828 .It Li QPI_TX_STALLED_MULTI_FLIT.NCS.LINK_1
829 .Pq Event 41H , Umask 20H
830 Counts cycles the Quickpath outbound link 1 Non-Coherent Standard virtual
831 channel is stalled due to lack of VNA and VN0 credits.
832 Note that this event does not filter out when a flit would not have been selected
833 for arbitration because another virtual channel is getting arbitrated.
834 .It Li QPI_TX_STALLED_MULTI_FLIT.LINK_0
835 .Pq Event 41H , Umask 07H
836 Counts cycles the Quickpath outbound link 0 virtual channels are stalled due
837 to lack of VNA and VN0 credits.
838 Note that this event does not filter out when a flit would not have been selected
839 for arbitration because another virtual channel is getting arbitrated.
840 .It Li QPI_TX_STALLED_MULTI_FLIT.LINK_1
841 .Pq Event 41H , Umask 38H
842 Counts cycles the Quickpath outbound link 1 virtual channels are stalled due
843 to lack of VNA and VN0 credits.
844 Note that this event does not filter out when a flit would not have been selected
845 for arbitration because another virtual channel is getting arbitrated.
846 .It Li QPI_TX_HEADER.FULL.LINK_0
847 .Pq Event 42H , Umask 01H
848 Number of cycles that the header buffer in the Quickpath Interface outbound
849 link 0 is full.
850 .It Li QPI_TX_HEADER.BUSY.LINK_0
851 .Pq Event 42H , Umask 02H
852 Number of cycles that the header buffer in the Quickpath Interface outbound
853 link 0 is busy.
854 .It Li QPI_TX_HEADER.FULL.LINK_1
855 .Pq Event 42H , Umask 04H
856 Number of cycles that the header buffer in the Quickpath Interface outbound
857 link 1 is full.
858 .It Li QPI_TX_HEADER.BUSY.LINK_1
859 .Pq Event 42H , Umask 08H
860 Number of cycles that the header buffer in the Quickpath Interface outbound
861 link 1 is busy.
862 .It Li QPI_RX_NO_PPT_CREDIT.STALLS.LINK_0
863 .Pq Event 43H , Umask 01H
864 Number of cycles that snoop packets incoming to the Quickpath Interface link
865 0 are stalled and not sent to the GQ because the GQ Peer Probe Tracker (PPT)
866 does not have any available entries.
867 .It Li QPI_RX_NO_PPT_CREDIT.STALLS.LINK_1
868 .Pq Event 43H , Umask 02H
869 Number of cycles that snoop packets incoming to the Quickpath Interface link
870 1 are stalled and not sent to the GQ because the GQ Peer Probe Tracker (PPT)
871 does not have any available entries.
872 .It Li DRAM_OPEN.CH0
873 .Pq Event 60H , Umask 01H
874 Counts number of DRAM Channel 0 open commands issued either for read or write.
875 To read or write data, the referenced DRAM page must first be opened.
876 .It Li DRAM_OPEN.CH1
877 .Pq Event 60H , Umask 02H
878 Counts number of DRAM Channel 1 open commands issued either for read or write.
879 To read or write data, the referenced DRAM page must first be opened.
880 .It Li DRAM_OPEN.CH2
881 .Pq Event 60H , Umask 04H
882 Counts number of DRAM Channel 2 open commands issued either for read or write.
883 To read or write data, the referenced DRAM page must first be opened.
884 .It Li DRAM_PAGE_CLOSE.CH0
885 .Pq Event 61H , Umask 01H
886 DRAM channel 0 command issued to CLOSE a page due to page idle timer expiration.
887 Closing a page is done by issuing a precharge.
888 .It Li DRAM_PAGE_CLOSE.CH1
889 .Pq Event 61H , Umask 02H
890 DRAM channel 1 command issued to CLOSE a page due to page idle timer expiration.
891 Closing a page is done by issuing a precharge.
892 .It Li DRAM_PAGE_CLOSE.CH2
893 .Pq Event 61H , Umask 04H
894 DRAM channel 2 command issued to CLOSE a page due to page idle timer expiration.
895 Closing a page is done by issuing a precharge.
896 .It Li DRAM_PAGE_MISS.CH0
897 .Pq Event 62H , Umask 01H
898 Counts the number of precharges (PRE) that were issued to DRAM channel 0
899 because there was a page miss.
900 A page miss refers to a situation in which a page is currently open and another
901 page from the same bank needs to be opened.
902 The new page experiences a page miss.
903 Closing of the old page is done by issuing a precharge.
904 .It Li DRAM_PAGE_MISS.CH1
905 .Pq Event 62H , Umask 02H
906 Counts the number of precharges (PRE) that were issued to DRAM channel 1
907 because there was a page miss.
908 A page miss refers to a situation in which a page is currently open and another
909 page from the same bank needs to be opened.
910 The new page experiences a page miss.
911 Closing of the old page is done by issuing a precharge.
912 .It Li DRAM_PAGE_MISS.CH2
913 .Pq Event 62H , Umask 04H
914 Counts the number of precharges (PRE) that were issued to DRAM channel 2
915 because there was a page miss.
916 A page miss refers to a situation in which a page is currently open and another
917 page from the same bank needs to be opened.
918 The new page experiences a page miss.
919 Closing of the old page is done by issuing a precharge.
920 .It Li DRAM_READ_CAS.CH0
921 .Pq Event 63H , Umask 01H
922 Counts the number of times a read CAS command was issued on DRAM channel 0.
923 .It Li DRAM_READ_CAS.AUTOPRE_CH0
924 .Pq Event 63H , Umask 02H
925 Counts the number of times a read CAS command was issued on DRAM channel 0
926 where the command issued used the auto-precharge (auto page close) mode.
927 .It Li DRAM_READ_CAS.CH1
928 .Pq Event 63H , Umask 04H
929 Counts the number of times a read CAS command was issued on DRAM channel 1.
930 .It Li DRAM_READ_CAS.AUTOPRE_CH1
931 .Pq Event 63H , Umask 08H
932 Counts the number of times a read CAS command was issued on DRAM channel 1
933 where the command issued used the auto-precharge (auto page close) mode.
934 .It Li DRAM_READ_CAS.CH2
935 .Pq Event 63H , Umask 10H
936 Counts the number of times a read CAS command was issued on DRAM channel 2.
937 .It Li DRAM_READ_CAS.AUTOPRE_CH2
938 .Pq Event 63H , Umask 20H
939 Counts the number of times a read CAS command was issued on DRAM channel 2
940 where the command issued used the auto-precharge (auto page close) mode.
941 .It Li DRAM_WRITE_CAS.CH0
942 .Pq Event 64H , Umask 01H
943 Counts the number of times a write CAS command was issued on DRAM channel 0.
944 .It Li DRAM_WRITE_CAS.AUTOPRE_CH0
945 .Pq Event 64H , Umask 02H
946 Counts the number of times a write CAS command was issued on DRAM channel 0
947 where the command issued used the auto-precharge (auto page close) mode.
948 .It Li DRAM_WRITE_CAS.CH1
949 .Pq Event 64H , Umask 04H
950 Counts the number of times a write CAS command was issued on DRAM channel 1.
951 .It Li DRAM_WRITE_CAS.AUTOPRE_CH1
952 .Pq Event 64H , Umask 08H
953 Counts the number of times a write CAS command was issued on DRAM channel 1
954 where the command issued used the auto-precharge (auto page close) mode.
955 .It Li DRAM_WRITE_CAS.CH2
956 .Pq Event 64H , Umask 10H
957 Counts the number of times a write CAS command was issued on DRAM channel 2.
958 .It Li DRAM_WRITE_CAS.AUTOPRE_CH2
959 .Pq Event 64H , Umask 20H
960 Counts the number of times a write CAS command was issued on DRAM channel 2
961 where the command issued used the auto-precharge (auto page close) mode.
962 .It Li DRAM_REFRESH.CH0
963 .Pq Event 65H , Umask 01H
964 Counts number of DRAM channel 0 refresh commands.
965 DRAM loses data content over time.
966 In order to keep correct data content, the data values have to be
967 refreshed periodically.
968 .It Li DRAM_REFRESH.CH1
969 .Pq Event 65H , Umask 02H
970 Counts number of DRAM channel 1 refresh commands.
971 DRAM loses data content over time.
972 In order to keep correct data content, the data values have to be refreshed periodically.
973 .It Li DRAM_REFRESH.CH2
974 .Pq Event 65H , Umask 04H
975 Counts number of DRAM channel 2 refresh commands.
976 DRAM loses data content over time.
977 In order to keep correct data content, the data values have to be refreshed periodically.
978 .It Li DRAM_PRE_ALL.CH0
979 .Pq Event 66H , Umask 01H
980 Counts number of DRAM Channel 0 precharge-all (PREALL) commands that close
981 all open pages in a rank.
982 PREALL is issued when the DRAM needs to be refreshed or needs to go into a power down mode.
983 .It Li DRAM_PRE_ALL.CH1
984 .Pq Event 66H , Umask 02H
985 Counts number of DRAM Channel 1 precharge-all (PREALL) commands that close
986 all open pages in a rank.
987 PREALL is issued when the DRAM needs to be refreshed or needs to go into a power down mode.
988 .It Li DRAM_PRE_ALL.CH2
989 .Pq Event 66H , Umask 04H
990 Counts number of DRAM Channel 2 precharge-all (PREALL) commands that close
991 all open pages in a rank.
992 PREALL is issued when the DRAM needs to be refreshed or needs to go into a power down mode.
993 .It Li DRAM_THERMAL_THROTTLED
994 .Pq Event 67H , Umask 01H
995 Uncore cycles DRAM was throttled due to its temperature being above the
996 thermal throttling threshold.
997 .It Li THERMAL_THROTTLING_TEMP.CORE_0
998 .Pq Event 80H , Umask 01H
999 Cycles that the PCU records that core 0 is above the thermal throttling
1000 threshold temperature.
1001 .It Li THERMAL_THROTTLING_TEMP.CORE_1
1002 .Pq Event 80H , Umask 02H
1003 Cycles that the PCU records that core 1 is above the thermal throttling
1004 threshold temperature.
1005 .It Li THERMAL_THROTTLING_TEMP.CORE_2
1006 .Pq Event 80H , Umask 04H
1007 Cycles that the PCU records that core 2 is above the thermal throttling
1008 threshold temperature.
1009 .It Li THERMAL_THROTTLING_TEMP.CORE_3
1010 .Pq Event 80H , Umask 08H
1011 Cycles that the PCU records that core 3 is above the thermal throttling
1012 threshold temperature.
1013 .It Li THERMAL_THROTTLED_TEMP.CORE_0
1014 .Pq Event 81H , Umask 01H
1015 Cycles that the PCU records that core 0 is in the power throttled state due
1016 to cores temperature being above the thermal throttling threshold.
1017 .It Li THERMAL_THROTTLED_TEMP.CORE_1
1018 .Pq Event 81H , Umask 02H
1019 Cycles that the PCU records that core 1 is in the power throttled state due
1020 to cores temperature being above the thermal throttling threshold.
1021 .It Li THERMAL_THROTTLED_TEMP.CORE_2
1022 .Pq Event 81H , Umask 04H
1023 Cycles that the PCU records that core 2 is in the power throttled state due
1024 to cores temperature being above the thermal throttling threshold.
1025 .It Li THERMAL_THROTTLED_TEMP.CORE_3
1026 .Pq Event 81H , Umask 08H
1027 Cycles that the PCU records that core 3 is in the power throttled state due
1028 to cores temperature being above the thermal throttling threshold.
1029 .It Li PROCHOT_ASSERTION
1030 .Pq Event 82H , Umask 01H
1031 Number of system assertions of PROCHOT indicating the entire processor has
1032 exceeded the thermal limit.
1033 .It Li THERMAL_THROTTLING_PROCHOT.CORE_0
1034 .Pq Event 83H , Umask 01H
1035 Cycles that the PCU records that core 0 is a low power state due to the
1036 system asserting PROCHOT the entire processor has exceeded the thermal
1037 limit.
1038 .It Li THERMAL_THROTTLING_PROCHOT.CORE_1
1039 .Pq Event 83H , Umask 02H
1040 Cycles that the PCU records that core 1 is a low power state due to the
1041 system asserting PROCHOT the entire processor has exceeded the thermal
1042 limit.
1043 .It Li THERMAL_THROTTLING_PROCHOT.CORE_2
1044 .Pq Event 83H , Umask 04H
1045 Cycles that the PCU records that core 2 is a low power state due to the
1046 system asserting PROCHOT the entire processor has exceeded the thermal
1047 limit.
1048 .It Li THERMAL_THROTTLING_PROCHOT.CORE_3
1049 .Pq Event 83H , Umask 08H
1050 Cycles that the PCU records that core 3 is a low power state due to the
1051 system asserting PROCHOT the entire processor has exceeded the thermal
1052 limit.
1053 .It Li TURBO_MODE.CORE_0
1054 .Pq Event 84H , Umask 01H
1055 Uncore cycles that core 0 is operating in turbo mode.
1056 .It Li TURBO_MODE.CORE_1
1057 .Pq Event 84H , Umask 02H
1058 Uncore cycles that core 1 is operating in turbo mode.
1059 .It Li TURBO_MODE.CORE_2
1060 .Pq Event 84H , Umask 04H
1061 Uncore cycles that core 2 is operating in turbo mode.
1062 .It Li TURBO_MODE.CORE_3
1063 .Pq Event 84H , Umask 08H
1064 Uncore cycles that core 3 is operating in turbo mode.
1065 .It Li CYCLES_UNHALTED_L3_FLL_ENABLE
1066 .Pq Event 85H , Umask 02H
1067 Uncore cycles that at least one core is unhalted and all L3 ways are
1068 enabled.
1069 .It Li CYCLES_UNHALTED_L3_FLL_DISABLE
1070 .Pq Event 86H , Umask 01H
1071 Uncore cycles that at least one core is unhalted and all L3 ways are
1072 disabled.
1073 .El
1074 .Sh SEE ALSO
1075 .Xr pmc 3 ,
1076 .Xr pmc.atom 3 ,
1077 .Xr pmc.core 3 ,
1078 .Xr pmc.corei7 3 ,
1079 .Xr pmc.corei7uc 3 ,
1080 .Xr pmc.iaf 3 ,
1081 .Xr pmc.k7 3 ,
1082 .Xr pmc.k8 3 ,
1083 .Xr pmc.p4 3 ,
1084 .Xr pmc.p5 3 ,
1085 .Xr pmc.p6 3 ,
1086 .Xr pmc.soft 3 ,
1087 .Xr pmc.tsc 3 ,
1088 .Xr pmc.ucf 3 ,
1089 .Xr pmc.westmere 3 ,
1090 .Xr pmc_cpuinfo 3 ,
1091 .Xr pmclog 3 ,
1092 .Xr hwpmc 4
1093 .Sh HISTORY
1094 The
1095 .Nm pmc
1096 library first appeared in
1097 .Fx 6.0 .
1098 .Sh AUTHORS
1099 The
1100 .Lb libpmc
1101 library was written by
1102 .An Joseph Koshy Aq Mt jkoshy@FreeBSD.org .