metricgroup_..._metric_list(9)

📦 version 7.3.1, in nixpkgs unstable

✨ metricgroup__add_metric_list 💅

okay so bestie, welcome to the Kernel API Manual 🎀 — this one's <pink>metricgroup__add_metric_list(9)</pink>, and no cap it's giving "find the metrics you asked for and actually add them" energy. Let's get into it 🫶

🌸 NAME 🌸

metricgroup__add_metric_list — Find and add metrics, or metric groups, specified in a list. Literally its whole job 💖

🦋 SYNOPSIS 🦋

int metricgroup__add_metric_list (const char *pmu , const char *list ,
       bool metric_no_group , bool metric_no_threshold , const char
       *user_requested_cpu_list , bool system_wide , struct list_head
       *metric_list , const struct pmu_metrics_table *table );

it returns an int, bestie — write it down 📝

⭐ ARGUMENTS ⭐

  • pmu — a pmu to restrict the metrics to, or "all" for all PMUS. like, "all" is the main character option here 👑
  • list — the list of metrics or metric groups. For example, "IPC,CPI,TopDownL1" would match the IPC and CPI metrics, and TopDownL1 would match all the metrics in the TopDownL1 group. so TopDownL1 is out here collecting the whole group, iconic 🌈
  • metric_no_group — should events written to events be grouped "{}" or global. Grouping is the default but due to multiplexing the user may override. yeah — default is grouping, but multiplexing exists so the user gets to override, iykyk 💅
  • metric_no_threshold — -- undescribed --. that's it. that's the description. the docs literally said nothing on this one 😭💀 we're not gonna invent lore for it, moving on
  • user_requested_cpu_list — Command line specified CPUs to record on. so, the cpus you asked for from the command line 🧚
  • system_wide — Are events for all processes recorded. yes this is phrased as a question. yes it's still the argument 🍓
  • metric_list — The list that metrics are added to. this is where the good stuff goes 💜
  • table — The table that is searched for metrics, most commonly the table for the architecture perf is running upon. so like, the arch table for whatever perf is running on 🦋

💅 SEE ALSO 💅

and also the kernel file ./tools/perf/util/metricgroup.c — literally the source, go read it, it's serving context 💖

🫶 quick reminder bestie: the metric_no_threshold description is <red>genuinely listed as -- undescribed -- in the original. that's not me being lazy, that's Just What It Says. keep that energy.

and that's the whole page!! mwah 💋 this one ships from ./tools/perf/util, dated October 2026, filed under metricgroup_..._metric_list(9) — slay, go add some metrics ✨🎀🔥

📦 where this page comes from