strfilter__new(9)

💅 strfilter__new(9) — kernel API manual, but make it cute

okay bestie, so this one's from the Kernel API Manual and it's genuinely such a little icon. it makes string filters. that's it. that's the vibe. ✨

---

🎀 NAME 🎀

strfilter__new — literally creates a brand new string filter for you 🫶

---

✨ SYNOPSIS ✨

struct strfilter * strfilter__new (const char *rules , const char **err
);

---

🌸 ARGUMENTS 🌸

• rules — the filter rule itself, and no cap it's a combination of glob expressions, like it's not just one lil glob, it's the whole squad 🦋
• err — a pointer that points at an error detected on rules. yes it's a pointer to a pointer, she's fancy like that 💅

---

💖 DESCRIPTION 💖

so the way that this works is: it parses rules and returns a shiny new strfilter. main character energy fr fr 🌈

but listen 👑 — it returns NULL if an error is detected. and in that case, *err will indicate where it is detected. so *err is your lil receipts of where things went off 💀

one more thing bestie, and this is the important caveat: *err is NULL if a memory allocation is failed. like, that's a different failure mode entirely, so don't @ me if you assumed it was a rule problem 🙈

---

🔥 SEE ALSO 🔥

• Kernel file ./tools/perf/util/strfilter.h
• strfilter__or(9)
• strfilter__compare(9)
• strfilter__delete(9)
• strfilter__string(9)

go read those next, iykyk 💜

---

ngl this whole thing lives at ./tools/perf/util — that's the source/version home, and the date on the cover is October 2026. it's giving strfilter__new(9) era and we're obsessed. periodt. 🍓🧚⭐