perf_evlist_...h_entry_safe(9)

💅 perf_evlist__for_each_entry_safe — NAME ✨

okay so bestie, welcome to the Kernel API Manual 🎀 — this one's a macro called perf_evlist__for_each_entry_safe, and it's literally here to safely iterate thru all the evsels 💖 no cap, that's the whole vibe: safe iteration, all the evsels, one macro.

🌸 SYNOPSIS 🌸

perf_evlist__for_each_entry_safe (evlist , tmp , evsel );

that's it. three things in, the whole list comes out the other side 🦋 (and yes, the spaces before those commas are exactly how the manpage wrote it — copy it verbatim, iykyk 💅)

🫶 ARGUMENTS 🫶

• evlist — the evlist instance you're iterating through, bestie. this is the main character 👑 the thing you're walking over, one evsel at a time.
• tmp — a struct evsel temp iterator. think of it as the lil scratch pad 🍓 the macro needs so it can hold onto where it's going while it's busy letting go of where it's been. lowkey the whole reason this one's "safe" fr fr.
• evsel — a struct evsel iterator. this is your actual cursor, the one doing the strolling ✨ your current evsel, your moment, your time to shine.

💀 quick note: tmp and evsel are both struct evsel things — one's the temp, one's the iterator. don't get them twisted, bestie, that's the entire plot.

🦋 SEE ALSO 🦋

• Kernel file ./tools/lib/perf/include/internal/evlist.h — the source of truth, go touch grass in there 🌱
• __perf_evlist__for_each_entry(9)
• __perf_evlist__for_each_entry_reverse(9)
• perf_evlist__for_each_entry_reverse(9)
• __perf_evlist__for_each_entry_safe(9)

the whole friend group 💜 — forward, reverse, safe, double-underscore secret-menu versions — they all hang out together, go say hi to each one.

🧚 sign-off 💫

and that's the page, bestie! 🌈 this slice of the Kernel API Manual lives in ./tools/lib/perf/include/internal, dated October 2026 — and the macro's own header/title was perf_evlist__...h_entry_safe(9) if you were wondering, which you so were 🙈💖 periodt, go iterate safely ✨🫶