GEARMAND(1p)

💖 GEARMAND 💖

okay so bestie, welcome to the manual page for gearmand — and yes, it's page 1p of the User Contributed Perl Documentation, so you already know this is gonna be a Perl-flavored situation. 🍓

---

✨ NAME ✨

gearmand — Gearman client/worker connector.

like, that's the whole vibe. it's the connector. it connects. 💅

---

🌈 SYNOPSIS 🌈

gearmand --daemon

that's it. that's the whole synopsis. go off, king. 👑

---

🦋 DESCRIPTION 🦋

So this is the main executable for Gearman::Server, bestie. It's the one that actually runs the show. What it gives you is command-line configuration of port numbers, pidfiles, and daemonization. That's the whole menu. No cap. ✨

---

💜 OPTIONS 💜

okay here's where it gets juicy. every single one, no skips, we're doing this properly. 🫶

• --daemonize / -d — Makes the daemon run in the background. Good for init.d scripts, bad for running under daemontools/supervise. So like… know your context, queen. 💀
• --port=4730 / -p 4730 — Sets the port number. Defaults to 4730. it's giving classic, it's giving default.
• --listen hostname / -L hostname — The address the server should listen on.

Default is — and I need you to know I'm not gatekeeping, this is literally what the page says — nothing. It just says "Default is" and then stops. The default is blank. empty. a little mysterious. 🙈

• --pidfile=/some/dir/gearmand.pid — Writes a pidfile when starting up. 🎀
• --debug=1 — Enables debugging. And ngl, currently the only debug output is when a client or worker connects. That's it. That's the tea. 🍵
• --accept=10 — The number of new connections to accept each time we see a listening socket ready. Like, normally? Nobody needs to touch this. It does not usually need to be tuned by anyone. BUT — in dire circumstances you may need to do it quickly. dire circumstances. dramatic much? yes. accurate? also yes. 😭
• --wakeup=3 — Number of workers to wake up per job inserted into the queue.

0 (Zero) is a perfectly acceptable answer, and you can use it if you don't care much about job latency. This would bank on the base idea of a worker checking in with the server every so often. so like, the worker just shows up on its own schedule. lowkey iconic of it. ✨

-1 (Negative One) indicates that all sleeping workers should be woken up.

All other negative numbers will cause the server to throw exception and not start. so like… don't. 💀

• --wakeup-delay= — Time interval before waking up more workers (the value specified by --wakeup) when jobs are still in the queue.

0 (Zero) means go as fast as possible, but not all at the same time. Similar to -1 on --wakeup, but is more cooperative in gearmand's multitasking model. teamwork makes the dream work, fr fr. 🫶

-1 (Negative One) means that this event won't happen, so only the initial workers will be woken up to handle jobs in the queue.

• --version — Display the version and exit. short. sweet. slay. ⭐

---

👑 COPYRIGHT 👑

Copyright 2005-2007, Danga Interactive

You are granted a license to use it under the same terms as Perl itself.

---

💀 WARRANTY 💀

This is free software. IT COMES WITHOUT WARRANTY OF ANY KIND. all caps because they MEAN it, bestie. read it again. no warranty. none. zero. 🚨

---

🌸 AUTHORS 🌸

• Brad Fitzpatrick <brad@danga.com>
• Brad Whitaker <whitaker@danga.com>

two Brads. iconic behavior. the Brads really said "we'll build it." 💅

---

🧚 SEE ALSO 🧚

• Gearman::Server
• Gearman::Client
• Gearman::Worker
• Gearman::Client::Async

go read those next, iykyk. 📚✨

---

and that's the whole page, babe 🎀 this was perl v5.34.0, dated 2022-06-05, and that's your GEARMAND(1p) — now go forth and daemonize responsibly. mwah. 💖🦋