NAME

       libpfm_intel_ivbep_unc_cbo - support for Intel Ivy Bridge-EP C-Box uncore PMU

SYNOPSIS

       #include <perfmon/pfmlib.h>

       PMU name: ivbep_unc_cbo[0-7]
       PMU desc: Intel Ivy Bridge-EP C-Box uncore PMU

DESCRIPTION

       The  library  supports  the  Intel  Ivy  Bridge C-Box (coherency engine) uncore PMU.  This PMU model only
       exists on Ivy Bridge model 62. There is one C-box PMU per  physical  core.  Therefore  there  are  up  to
       fifteen identical C-Box PMU instances numbered from 0 to 14. On dual-socket systems, the number refers to
       the C-Box PMU  on  the  socket  where  the  program  runs.  For  instance,  if  running  on  CPU15,  then
       ivbep_unc_cbo0  refers to the C-Box for physical core 0 on socket 1. Conversely, if running on CPU0, then
       the same ivbep_unc_cbo0 refers to the C-Box for physical core 0 but on socket 0.

       Each C-Box PMU implements 4 generic counters and two filter registers used only with certain  events  and
       umasks.

MODIFIERS

       The following modifiers are supported on Intel Ivy Bridge C-Box uncore PMU:

       e      Enable edge detection, i.e., count only when there is a state transition from no occurrence of the
              event to at least one occurrence. This modifier must be combined with  a  threshold  modifier  (t)
              with a value greater or equal to one.  This is a boolean modifier.

       t      Set  the  threshold  value.  When  set to a non-zero value, the counter counts the number of C-Box
              cycles in which the number of occurrences of the event is greater or equal to the threshold.  This
              is an integer modifier with values in the range [0:255].

       nf     Node  filter.  Certain  events,  such as UNC_C_LLC_LOOKUP, UNC_C_LLC_VICTIMS, provide a NID umask.
              Sometimes the NID is combined with other filtering capabilities, such as opcodes.  The node filter
              is  an  8-bit  max  bitmask.  A node corresponds to a processor socket. The legal values therefore
              depend on the underlying hardware configuration. For dual-socket  systems,  the  bitmask  has  two
              valid bits [0:1].

       cf     Core  Filter.  This is a 3-bit filter which is used to filter based on physical core origin of the
              C-Box request. Possible values are 0-7. If the filter is not specified, then  no  filtering  takes
              place.

       tf     Thread  Filter.  This  is  a  1-bit filter which is used to filter C-Box requests based on logical
              processor (hyper-thread) identification. Possibles values are 0-1. If the filter is not specified,
              then no filtering takes place.

       nc     Non-Coherent.  This  is  a  1-bit  filter  which  is  used  to  filter C-Box requests only for the
              TOR_INSERTS and TOR_OCCUPANCY umasks using the OPCODE matcher. If the  filter  is  not  specified,
              then no filtering takes place.

       isoc   Isochronous.  This  is  a  1-bit  filter  which  is  used  to  filter  C-Box requests only for the
              TOR_INSERTS and TOR_OCCUPANCY umasks using the OPCODE matcher. If the  filter  is  not  specified,
              then no filtering takes place.

Opcode filtering

       Certain  events, such as UNC_C_TOR_INSERTS supports opcode matching on the C-BOX transaction type. To use
       this feature, first an opcode matching umask must be selected, e.g., MISS_OPCODE.  Second, the opcode  to
       match   on   must   be   selected   via   a   second   umask  among  the  OPC_*  umasks.   For  instance,
       UNC_C_TOR_INSERTS:OPCODE:OPC_RFO, counts the number of TOR insertions for RFO transactions.

       Opcode matching may be combined with node filtering  with  certain  umasks.  In  general,  the  filtering
       support  is  encoded  into  the umask name, e.g., NID_OPCODE supports both node and opcode filtering. For
       instance, UNC_C_TOR_INSERTS:NID_OPCODE:OPC_RFO:nf=1.

AUTHORS

       Stephane Eranian <eranian@gmail.com>

                                                 February, 2014                                        LIBPFM(3)