cpufreq-aperf(1)

📦 version 008, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

✨ cpufreq-aperf(1) ✨

okay bestie, welcome to cpufreq-aperf — it's a lil tool from the cpufrequtils crew and it does exactly one iconic thing: it figures out your CPU's average frequency over a time period. that's it. that's the whole vibe. 💅

🌸 NAME 🌸

cpufreq-aperf — calculates the average frequency over a time period ✨

🦋 SYNTAX 🦋

cpufreq-aperf [options]

💖 DESCRIPTION 💖

so on the latest processors there are these two MSR registers, and they are the moment, fr fr:

  • MPERF — this one increases with the maximum (P0) frequency while in C0
  • APERF — this one increases with the current/actual frequency while in C0

and from that info? the average frequency over a time period gets calculated. that's literally what this tool does. no cap. 🎀

a nice lil falloff feature beside the average frequency is the time a processor core remained in C0 (working state) or any CX (sleep state) processor sleep state during the measured time period. and the way we know that is iconic: MPERF only increases in C0 state. so if MPERF isn't moving, bestie, that core is napping. 😴✨

🎀 OPTIONS 🎀

  • -c --cpu <CPU> — the <CPU> core to measure. default: all cores 👑
  • -i --interval <seconds> — the refresh rate. default: 1 second ⏱️
  • -o --once — dips after one interval. one and done, periodt. 💅
  • -h --help — prints all the available options so you can read them yourself 🫶

⭐ REMARKS ⭐

bestie, heads up: the msr driver must be loaded for this command to work. no driver, no vibes. 😭

💜 AUTHORS 💜

Thomas Renninger <trenn@suse.de>

🌈 SEE ALSO 🌈

cpufreq-set(1), cpufreq-info(1)

mwah 💋 this page was brought to you by Mattia Dongili, version 0.1 of cpufreq-aperf(1) — go check your cores, they're doing so good, slay 🦋✨👑

📦 where this page comes from