LIBPFM(3)

💖 LIBPFM(3) 💖

okay bestie, welcome to the Linux Programmer's Manual ✨ — this one's about libpfm_intel_icx_unc_upi, which is the support for the Intel IcelakeX Server UPI uncore PMU. it's giving hardware-counter realness, no cap 🎀

✨ NAME ✨

libpfm_intel_icx_unc_upi — support for Intel IcelakeX Server UPI uncore PMU 🦋

🌸 SYNOPSIS 🌸

#include <perfmon/pfmlib.h>

• PMU name: icx_unc_upi[0-3] 👑
• PMU desc: Intel IcelakeX UPI uncore PMU

💜 DESCRIPTION 💜

so like, the library supports the Intel IcelakeX UPI (Ultra Path Interconnect) uncore PMU. and each UPI PMU implements 4 generic counters. that's it, that's the vibe ✨ four counters, four little besties, all counting at once 💅

🎀 MODIFIERS 🎀

here's the modifiers that are supported on the Intel IcelakeX UPI uncore PMU — memorize them, they're iconic:

• 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 IRP 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.

lowkey important: the e modifier does not work solo, fr fr. it needs t with a value >= 1 or it's just not happening 🫶

👑 AUTHORS 👑

Stephane Eranian <eranian@gmail.com>

and that's the whole page, bestie 💖 November, 2023 energy, LIBPFM(3) through and through, straight out of the Linux Programmer's Manual. slay, go count something 🦋✨💅