__perf_evlis...h_entry_safe(9)

💅 __perf_evlis...h_entry_safe(9) 💅

okay so bestie, welcome to the Kernel API Manual ✨ this one's a macro name so long it got its own abbreviated little nickname up top (__perf_evlis...h_entry_safe(9) — yes the header really did give up halfway thru, iconic honestly 🎀). let's get into it.

---

🌸 NAME 🌸

__perf_evlist__for_each_entry_safe — safely iterate thru all the evsels 🦋

like, it walks the whole list, and it does it safely, which is the whole point (more on that vibe below, no cap).

---

✨ SYNOPSIS ✨

__perf_evlist__for_each_entry_safe (list , tmp , evsel );

three things go in, that's the whole gig 💖

---

🫶 ARGUMENTS 🫶

• list — a list_head instance to iterate. this is the thing you're walking thru, the main character of the operation 👑
• tmp — a struct evsel temp iterator. it's your little sidekick holding onto the next one so nothing gets dropped mid-loop 🧚
• evsel — a struct evsel iterator. this is the one you actually do stuff with on each pass, the one you're looking at rn 💅

ngl the whole "safe" thing is the entire personality here — tmp exists so you can keep going even while you're messing with the list as you go. that's the vibe check this macro is passing 🔥

---

💜 SEE ALSO 💜

• Kernel file ./tools/lib/perf/include/internal/evlist.h
• __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)

like the whole friend group fr fr — go read the non-underscore ones too, they're all sitting in the same header being cute together 🍓

---

🌈 friendly reminder: this page is from ./tools/lib/perf/include/internal and it's dated October 2026 — so yeah, sourced from there, dated that, and filed under __perf_evlis...h_entry_safe(9) one more time for the people in the back 📣

stay safe out there (literally, it's in the name) — mwah 💋💖