GEARMAND(1)

📦
version 1.130.1 · 2 versions
, in fedora 43

💖 GEARMAND 💖

okay bestie, welcome to GEARMAND(1) — it's a page from the User Contributed Perl Documentation section, and it's literally the whole vibe of Gearman's server executable. buckle up 🎀

✨ NAME ✨

gearmand — the Gearman client/worker connector. yes queen, that's the whole job description 💅

🌸 SYNOPSIS 🌸

gearmand --daemon

that's it. that's the vibe. go off 👑

🦋 DESCRIPTION 🦋

so this is the main executable for Gearman::Server ✨ it's the one that actually gets the party started.

what it gives you is command-line configuration of port numbers, pidfiles, and daemonization. that's it, that's the whole menu. no cap 🫶

💅 OPTIONS 💅

  • --daemonize, -d — makes the daemon run in the background. lowkey perfect for init.d scripts, highkey terrible if you're running under daemontools/supervise. pick your fighter 😭
  • --port=4730, -p 4730 — sets the port number. it defaults to 4730. iconic default, honestly ⭐
  • --listen hostname, -L hostname — the address the server should listen on.

Default is... nothing listed. like, the manpage literally just says "Default is" and then stops. so yeah, that's a mystery wrapped in an enigma, bestie 🙈

  • --pidfile=/some/dir/gearmand.pid — writes a pidfile when it starts up. classic 📝
  • --debug=1 — turns debugging on. and ngl, the current debug output is only when a client or worker connects, so don't expect a whole fireworks show 💀
  • --accept=10 — how many new connections we accept each time we see a listening socket ready. usually nobody needs to tune this, but in dire circumstances you may need to do it quickly. dire!! circumstances!! 😳
  • --wakeup=3 — how many workers to wake up per job inserted into the queue. let's break it down:
    • Zero (0) is a perfectly acceptable answer 🫶 use it if you don't care much about job latency. this banks on the base idea of a worker checking in with the server every so often.
    • Negative One (-1) means all sleeping workers should be woken up. everybody up, it's time to work 🌈
    • All other negative numbers will cause the server to throw an exception and not start. so like, -2? not today, bestie. no ❌
  • --wakeup-delay= — the time interval before waking up more workers (the amount specified by --wakeup) when jobs are still hanging out in the queue.
    • Zero (0) means go as fast as possible, but not all at the same time. similar to -1 on --wakeup, but more cooperative in gearmand's multitasking model. teamwork makes the dream work 🧚
    • Negative One (-1) means this event won't happen, so only the initial workers get woken up to handle the jobs in the queue.
  • --version — displays the version and dips. bye 👋

Copyright 2005-2007, Danga Interactive

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

🔥 WARRANTY 🔥

This is free software. IT COMES WITHOUT WARRANTY OF ANY KIND.

read that again. NO WARRANTY OF ANY KIND. not even a little one. she said what she said 💀

🌟 AUTHORS 🌟

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

two Brads, one legend. main character energy fr fr 👑

🌈 SEE ALSO 🌈

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

and that's a wrap 🎀 this lil page is from perl v5.42.0, dated 2025-07-25, and yeah — GEARMAND(1) stays iconic forever. mwah 💖✨

📦 where this page comes from