setup_metric_events(9)

✨ setup_metric_events(9) ✨

okay bestie, this page comes from the Kernel API Manual and it's about one function with serious “matchmaker for metric events” energy. No cap, it finds a group of events in metric_evlist that correspond to the IDs from a parsed metric expression. 💅

💖 NAME 💖

setup_metric_events — finds a group of events in metric_evlist that correspond to the IDs from a parsed metric expression. That's the whole vibe. 🎯

🛠️ SYNOPSIS 🛠️

int setup_metric_events (const char *pmu , struct hashmap *ids , struct
evlist *metric_evlist , struct evsel ***out_metric_events );

🎀 ARGUMENTS 🎀

• pmu — the PMU for the IDs. That's it, that's the assignment. ✨
• ids — the metric IDs to match. These are the ones we're looking for, bestie. 🔍
• metric_evlist — the list of perf events. This is the pile we're checking through. 📚
• out_metric_events — holds the created metric events array. It's the output spot, so the new array has somewhere cute to live. 🫶

👀 SEE ALSO 👀

Kernel file ./tools/perf/util/metricgroup.c and its little friend group:

• resolve_metric(9)
• __add_metric(9)
• metric_list_cmp(9)
• default_metricgroup_cmp(9)
• metricgroup__add_metric(9)
• metricgroup__add_metric_list(9)
• find_tool_events(9)
• build_combined_expr_ctx(9)
• parse_ids(9)

okay that's the page, bestie 💖 it comes from the source/version path ./tools/perf/util, dated October 2026, and the function at the center of it all is setup_metric_events(9) 🫶✨