textsearch_prepare(9)

✨ textsearch_prepare(9) ✨

okay so bestie, we're in the Kernel API Manual today and this one is textsearch_prepare(9) — literally the glow-up that gets your search ready to go. 💅

---

🌸 NAME 🌸

textsearch_prepare — Prepare a search 🎀

---

🦋 SYNOPSIS 🦋

struct ts_config * textsearch_prepare (const char *algo , const void
       *pattern , unsigned int len , gfp_t gfp_mask , int flags );

like, it hands you back a struct ts_config *, and it takes five whole arguments. she's thorough. 💖

---

🔥 ARGUMENTS 🔥

• algo — name of search algorithm 👑 (yes, as a string, pick your fighter)
• pattern — pattern data 🍓 the actual bytes you're hunting for
• len — length of pattern, fr fr, she needs to know how much
• gfp_mask — allocation mask 🌈 standard kernel allocation vibes
• flags — search flags ⭐ the little toggles

---

💜 DESCRIPTION 💜

So what does it do? It looks up the search algorithm module (shoutout to modules, iconic) and creates a new textsearch configuration for the specified pattern. that's it, that's the whole vibe check. main character energy: prepare the search, then go find stuff. ✨🫶

---

🌟 NOTE 🌟

big heads-up bestie: the format of the pattern may not be compatible between the various search algorithms 😭 like the pattern you write for one algo is not guaranteed to make sense to another one. no cap.

It returns a new textsearch configuration according to the specified parameters, or a ERR_PTR 💀 (yes, an error pointer, she does that sometimes).

And if a zero length pattern is passed, this function returns EINVAL. zero bytes? not today. 🙈

---

🌈 SEE ALSO 🌈

Kernel file ./lib/textsearch.c, plus the whole friend group: ts_intro(9), textsearch_register(9), textsearch_unregister(9), textsearch_find_continuous(9), textsearch_destroy(9) 🧚‍♀️💫

---

mwah, that's the page 💋 — straight out of ./lib, dated October 2026, and this was textsearch_prepare(9). go slay your searches, bestie 🎀💖