libpfm_intel_spr_unc_cha(3) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| MODIFIERS \| AUTHORS \| COLOPHON

LIBPFM(3)               Linux Programmer's Manual              LIBPFM(3)

NAME top

       libpfm_intel_spr_unc_cha - support for Intel IcelakeX Server CHA
       uncore PMU

SYNOPSIS top

       #include <perfmon/pfmlib.h>

       PMU name: spr_unc_cha[0-59]
       PMU desc: Intel SapphireRapids CHA uncore PMU

DESCRIPTION top

       The library supports the Intel SapphireRapids CHA (coherency and
       home agent) uncore PMU.  There is one CHA-box PMU per physical
       core. Therefore there are up forty identical CHA PMU instances
       numbered from 0 up to possibly 59. On dual-socket systems, the
       number refers to the CHA PMUs on the socket where the program
       runs.

       Each CHA PMU implements 4 generic counters.

MODIFIERS top

       The following modifiers are supported on Intel SapphireRapids CHA
       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 CHA clockticks 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].

       i      Invert the threshold (t) test from strictly greater than
              to less or equal to. This is a boolean modifier.

AUTHORS top

       Stephane Eranian <eranian@gmail.com>

COLOPHON top

       This page is part of the perfmon2 (a performance monitoring
       library) project.  Information about the project can be found at
       ⟨http://perfmon2.sourceforge.net/⟩.  If you have a bug report for
       this manual page, send it to
       perfmon2-devel@lists.sourceforge.net.  This page was obtained
       from the project's upstream Git repository
       ⟨git://git.code.sf.net/p/perfmon2/libpfm4 perfmon2-libpfm4⟩ on
       2024-06-14.  (At that time, the date of the most recent commit
       that was found in the repository was 2024-04-24.)  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to man-pages@man7.org

                              January, 2024                    LIBPFM(3)