1LIBPFM(3)                  Linux Programmer's Manual                 LIBPFM(3)
2
3
4

NAME

6       libpfm_intel_ivbep_unc_pcu - support for Intel Ivy Bridge-EP Power Con‐
7       troller Unit (PCU) uncore PMU
8

SYNOPSIS

10       #include <perfmon/pfmlib.h>
11
12       PMU name: ivbep_unc_pcu
13       PMU desc: Intel Ivy Bridge-EP PCU uncore PMU
14
15

DESCRIPTION

17       The library supports the Intel Ivy Bridge Power Controller Unit  uncore
18       PMU.  This PMU model only exists on Ivy Bridge model 62.
19
20

MODIFIERS

22       The  following  modifiers  are supported on Intel Ivy Bridge PCU uncore
23       PMU:
24
25       e      Enable edge detection, i.e., count only when there  is  a  state
26              transition  from  no  occurrence  of  the  event to at least one
27              occurrence. This modifier must be combined with a threshold mod‐
28              ifier (t) with a value greater or equal to one.  This is a bool‐
29              ean modifier.
30
31       t      Set the threshold value. When  set  to  a  non-zero  value,  the
32              counter  counts  the  number of HA cycles in which the number of
33              occurrences of the event is greater or equal to  the  threshold.
34              This is an integer modifier with values in the range [0:15].
35
36       ff     Enable  frequency  band filtering. This modifier applies only to
37              the UNC_P_FREQ_BANDx_CYCLES events, where x is [0-3].  The modi‐
38              fiers  expects  an  integer  in  the range [0-255]. The value is
39              interpreted as a frequency value to  be  multiplied  by  100Mhz.
40              Thus  if the value is 32, then all cycles where the processor is
41              running at 3.2GHz and more are counted.
42
43

Frequency band filtering

45       There are 3 events which  support  frequency  band  filtering,  namely,
46       UNC_P_FREQ_BAND0_CYCLES,                       UNC_P_FREQ_BAND1_CYCLES,
47       UNC_P_FREQ_BAND2_CYCLES, UNC_P_FREQ_BAND3_CYCLES. The frequency  filter
48       (available  via  the  ff modifier) is stored into a PMU shared register
49       which hold all 4 possible frequency bands, one per event. However,  the
50       library  generate  the  encoding for each event individually because it
51       processes events one at a time. The caller  or  the  underlying  kernel
52       interface  may  have  to  merge the band filter settings to program the
53       filter register properly.
54
55

AUTHORS

57       Stephane Eranian <eranian@gmail.com>
58
59
60
61                                February, 2014                       LIBPFM(3)
Impressum