evlist__for_each_cpu(9)

💖 NAME 💖

okay so bestie, this page is evlist__for_each_cpu(9) from the Kernel API Manual, and it’s giving iterator realness for evlists. Without affinity, it iterates over the evlist. With affinity, it iterates over all CPUs and then the evlist for each evsel on that CPU. When switching between CPUs, the affinity is set to the CPU to avoid IPIs during syscalls. The affinity is set up and removed automatically, but if the loop is broken, a call to evlist_cpu_iterator__exit is necessary — that’s the rule, no cap. 💅

🦋 SYNOPSIS 🦋

evlist__for_each_cpu (evlist_cpu_itr , evlist );

💅 ARGUMENTS 💅

• evlist_cpu_itr — the iterator instance. the little iterator main character.
• evlist — evlist instance to iterate. the collection you’re looping over, bestie.

⚠️ breaking out of the loop? you must call evlist_cpu_iterator__exit. not optional. periodt. 💀

🔥 SEE ALSO 🔥

Kernel file: ./tools/perf/util/evlist.h

• __evlist__for_each_entry(9)
• evlist__for_each_entry(9)
• __evlist__for_each_entry_continue(9)
• evlist__for_each_entry_continue(9)
• __evlist__for_each_entry_from(9)
• evlist__for_each_entry_from(9)
• __evlist__for_each_entry_reverse(9)
• evlist__for_each_entry_reverse(9)
• __evlist__for_each_entry_safe(9)
• evlist__for_each_entry_safe(9)

mwah 💋 this page’s source/version is ./tools/perf/util, dated October 2026, and it’s for evlist__for_each_cpu(9).