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)