LIBPFM(3)

✨ LIBPFM(3) — the Linux Programmer's Manual glow-up ✨

okay so bestie, you're reading the libpfm man page (that's section 3 of the Linux Programmer's Manual, for the library girlies 🫶), and today's episode is all about one very specific little corner of it. buckle up. 🎀

🌸 NAME 🌸

libpfm_intel_hswep_unc_sbo — support for Intel Haswell-EP S-Box uncore PMU 💅

🦋 SYNOPSIS 🦋

#include <perfmon/pfmlib.h>

• PMU name: hswep_unc_sbo
• PMU desc: Intel Haswell-EP S-Box uncore PMU

💖 DESCRIPTION 💖

so the library ships support for the Intel Haswell Rrint Transfer unit (S-Box) uncore PMU. no cap. 👑

and here's the tea: this PMU model only exists on Haswell model 63. that's it. that's the whole vibe check. if you're not on model 63, this isn't your girl. 😭

✨ MODIFIERS ✨

these are the modifiers supported on the Intel Haswell S-Box uncore PMU, and honestly, they're giving very much "control freak but make it cute" 🎀

• e — turns on edge detection, meaning it counts only when there's a state transition from no occurrence of the event to at least one occurrence. ⚡ important though: this modifier must be combined with a threshold modifier (t) whose value is greater than or equal to one. it's a boolean modifier, so it's on or off, periodt.
• t — sets the threshold value. when you set it to a non-zero value, the counter counts the number of HA 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:15]. 🔢
• i — inverts the meaning of the threshold or edge filter. if set, the event counts when strictly less than N occurrences occur per cycle, given that threshold is set to N. when invert is set, then threshold must be set to a non-zero value. and if edge detection is set, then setting invert means the event counts when the event transitions from occurring to not occurring (a falling edge 🌊). this is a boolean modifier.
• i — inverts the meaning of the threshold or edge filter. if set, the event counts when strictly less than N occurrences occur per cycle, given that threshold is set to N. when invert is set, then threshold must be set to a non-zero value. and if edge detection is set, then setting invert means the event counts when the event transitions from occurring to not occurring (a falling edge 🌊). this is a boolean modifier.

not me listing i twice 💀 bestie that is literally how it appears in the original — same modifier, same words, twice in a row. i'm not merging them, i'm not "fixing" it, i'm just handing you the truth as it was written. the way that documentation just… did that. 🙈

👑 AUTHORS 👑

Stephane Eranian <eranian@gmail.com>

and that's the whole page, bestie!! 🥳 this edition of the Linux Programmer's Manual is dated May, 2015, and it's filed under LIBPFM(3) — go forth, count your S-Box events, and slay 💖✨🎀🦋🌸💅🫶