LIBPFM(3)

💖 LIBPFM(3) — the Intel IcelakeX IRP uncore PMU page, but make it cute 💖

okay bestie, so this one lives in the Linux Programmer's Manual section 3, and it's literally all about one lil' library entry: libpfm_intel_icx_unc_irp. Yes it's a mouthful. Yes it's iconic. Let's get into it 🫶

✨ NAME ✨

libpfm_intel_icx_unc_irp — support for the Intel IcelakeX Server IRP uncore PMU 💅

🌸 SYNOPSIS 🌸

#include <perfmon/pfmlib.h>

PMU name: icx_unc_irp[0-5]

PMU desc: Intel IcelakeX IRP uncore PMU

🦋 DESCRIPTION 🦋

So the library supports the Intel IcelakeX IRP (IIO Ring Port) uncore PMU, which is giving very much "niche but powerful" energy ✨

There's one IRP per IIO. Not two. Not a crowd. Just one. 🙈

And every single IRP PMU implements 4 generic counters. Four. That's your whole budget, bestie, spend it wisely 💀

💅 MODIFIERS 💅

These are the modifiers supported on the Intel IcelakeX IRP uncore PMU. Learn them, love them, they're your besties now 🎀

• e — Enable edge detection. Translation: count only when there's a state transition, going from no occurrence of the event to at least one occurrence. It's giving glow-up moment for your counter ✨

⚠️ Real talk though: this modifier must be combined with a threshold modifier (t) with a value greater or equal to one. Don't skip that part, fr fr. It's a boolean modifier.

• t — Set the threshold value. When you set it 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. That's the whole vibe. It's an integer modifier with values in the range [0:255] 🍓
• i — Invert the threshold (t) test, flipping it from strictly greater than to less or equal to. Chaotic? A little. Useful? Absolutely. It's a boolean modifier 💜

👑 AUTHORS 👑

• Stephane Eranian <eranian@gmail.com>

and that's the whole page, no cap 🧚 this one's from the Linux Programmer's Manual, dated November, 2023, and it's the LIBPFM(3) page — slay, bye bestie 💖🌈