NAME

       libpfm_intel_bdx_unc_cbo - support for Intel Broadwell Server C-Box uncore PMU

SYNOPSIS

       #include <perfmon/pfmlib.h>

       PMU name: bdx_unc_cbo[0-21]
       PMU desc: Intel Broadwell Server C-Box uncore PMU

DESCRIPTION

       The library supports the Intel Broadwell Server C-Box (coherency engine) uncore PMU.  This
       PMU model exists on various Broadwell server models (79, 86) . There is one C-box PMU  per
       physical core. Therefore there are up to twenty-one identical C-Box PMU instances numbered
       from 0 to 21. On dual-socket systems, the number refers to the C-Box  PMU  on  the  socket
       where the program runs. For instance, if running on CPU18, then bdx_unc_cbo0 refers to the
       C-Box for physical core 0 on socket 1. Conversely, if  running  on  CPU0,  then  the  same
       bdx_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 Broadwell 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 5-bit filter which is used to filter based on physical  core
              origin  of  the  C-Box  request.  Possible  values  are  0-63. If the filter is not
              specified, then no filtering takes place. Bit  0-3 indicate  the physical  core  id
              and bit 4 filters on non thread-related data.

       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>

                                            June, 2017                                  LIBPFM(3)