LIBPFM(3)

💖 LIBPFM(3) 💖

okay so bestie, welcome to the Linux Programmer's Manual, section 3, page LIBPFM. This one's all about the Intel Icelake X Server Mesh to Memory (M2M) uncore PMU support in libpfm. It's giving niche, it's giving powerful, it's giving slay. Let's get into it 🫶

✨ NAME ✨

libpfm_intel_icx_unc_m2m — support for the Intel Icelake X Server Mesh to Memory (M2M) uncore PMU. That's the whole vibe, no notes 💅

🌸 SYNOPSIS 🌸

#include <perfmon/pfmlib.h>

PMU name: icx_unc_m2m[0-1]
PMU desc: Intel Icelake X Server M2M uncore PMU

see how there's a [0-1] on the PMU name? Yeah bestie, there's more than one of them, and the library knows 👑

🦋 DESCRIPTION 🦋

The library supports the Intel Icelake X Server Mesh to Memory (M2M) uncore PMU. That's it, that's the job, and it does it flawlessly ✨

💅 MODIFIERS 💅

Okay so these are the modifiers you can slap onto events on the Intel Icelake X server M2M uncore PMU. Read them, love them, use them correctly 🙈

• e — Enables edge detection, meaning you only count when there's a state transition from no occurrence of the event to at least one occurrence. Heads up: you must pair this with a threshold modifier (t) whose value is greater than or equal to one. This is a boolean modifier.
• t — Sets the threshold value. When you set it to something non-zero, the counter counts the number of M2M cycles in which the number of occurrences of the event is greater than or equal to the threshold. This is an integer modifier, and its values live in the range [0:255].
• i — Inverts the threshold (t) test from strictly greater than to less or equal to. This is a boolean modifier.

fr fr, remember: e without a t of at least 1 is not a thing. Do not try it. The modifier is literally built to be combined 💀

🎀 AUTHORS 🎀

Stephane Eranian <eranian@gmail.com> — thank you king, we are obsessed 🫶👑

and that's the whole page bestie!! this one's from November, 2023, and it lives at the bottom of LIBPFM(3) like a little signature. go forth and count some M2M cycles, no cap 🌈⭐💜