KinoSe...hClient(3pm)

💖 KinoSearch1::Search::SearchClient — connect to a remote SearchServer 💖

okay so bestie, quick heads up before we even get into it: this is KinoSearch1::Search::SearchClient, from the User Contributed Perl Documentation, and it's giving "let me call a whole other computer and ask it to search stuff for me" energy. 🦋

Also, ground rules: you're making a remote procedure call. And for every single call that does not close or terminate the socket connection, please expect a response back that's been serialized using Storable. That's just how it is, no cap. ✨

---

🌸 SYNOPSIS 🌸

my $client = KinoSearch1::Search::SearchClient->new(
    peer_address => 'searchserver1:7890',
    password     => $pass,
    analyzer     => $analyzer,
);
my $hits = $client->search( query => $query );

look at that. three little params and suddenly you're searching an index on a whole different machine. main character behavior fr fr. 👑

---

✨ DESCRIPTION ✨

SearchClient is a subclass of KinoSearch1::Searcher, and what it does — its whole thing, its moment — is let you search an index that lives on a remote machine, one that's been made accessible via SearchServer. 💅

So like. Local searcher? adorable. Remote searcher? iconic. 🎀

---

🫶 METHODS 🫶

new

Constructor time!! 🎉 It takes hash-style params, so you pass it a list of key/value pairs like the good little Perl dev you are.

• peer_address — the name or IP plus the port number that the client should attempt to connect to. that's your "where's my search server at" address. 📍
• password — the password to be supplied to the SearchServer when initializing the socket connection. yes you gotta knock first. 🙈
• analyzer — an object belonging to a subclass of KinoSearch1::Analysis::Analyzer. bring your own analyzer, babe. 🧚

---

😭 LIMITATIONS 😭

okay so this is the sad part, sit down. 🍓

Limiting search results with a QueryFilter is not yet supported. that's it. that's the whole limitation. we wait. 💀

---

👑 COPYRIGHT 👑

Copyright 2006-2010 Marvin Humphrey

---

📜 LICENSE, DISCLAIMER, BUGS, etc. 📜

See KinoSearch1 version 1.01.

ngl, "see version 1.01" is the manpage equivalent of "it's in the group chat, scroll up." 🙈

---

mwah 💋 that was written up against perl v5.42.3, dated 2026-08-20, and it's the page for KinoSe...hClient(3pm) (yes the title got truncated by the formatter, that's just how the manpage colonizers do it, we still love her). byeee, go search something remotely, you got this 🫶✨