GEARMAND-PERL(1p)

📦 version 1.130.1, in ubuntu stonking

💖 NAME 💖

gearmand-perl — the Gearman client/worker connector, bestie edition ✨

🌸 SYNOPSIS 🌸

gearmand-perl --daemon

🦋 DESCRIPTION 🦋

okay so listen. this right here? this is the main executable for Gearman::Server. it's the one that actually gets your whole gearman party started 🎉

basically it hands you command-line control over the good stuff: port numbers, pidfiles, and daemonization. no config file drama, no digging around — you just tell it what you want at the prompt and it's giving main character energy the entire time 💅

✨ OPTIONS ✨

  • --daemonize, -d — makes the daemon run in the background. great for init.d scripts, kinda bad for running under daemontools/supervise 😭 so like, choose your vibe wisely.
  • --port=4730, -p 4730 — sets the port number. default is literally 4730, like the legend it is 👑
  • --listen hostname, -L hostname — the address the server should listen on.

default is

(yes bestie, that's it. that's the whole default. blank. iconic behaviour honestly 🎀)

  • --pidfile=/some/dir/gearmand-perl.pid — writes a pidfile when starting up. the little receipt of "yes i'm alive" 🫶
  • --debug=1 — turns debugging on. and rn, the only debug output you get is a lil message when a client or worker connects. that's it. that's the whole show 🙈
  • --accept=10 — number of new connections to accept each time we see a listening socket ready. girl, this does not usually need tuning by anyone 📢 ...but in dire circumstances you may need to do it, and do it quickly. so keep it in your back pocket 💀
  • --wakeup=3 — number of workers to wake up per job inserted into the queue. let's break this down:
    • Zero (0) is a perfectly acceptable answer, and it's for when you don't really care about job latency. this banks on the base idea of a worker checking in with the server every so often. lowkey chill of you 🍓
    • Negative One (-1) means all sleeping workers should be woken up. everyone up, we're going ✨
    • All other negative numbers will cause the server to throw an exception and not start. so like. don't. 😭
  • --wakeup-delay= — the time interval before waking up more workers (the amount specified by --wakeup) while jobs are still sitting in the queue. two moods:
    • Zero (0) means go as fast as possible — but not all at the same time. it's similar to -1 on --wakeup, except it's way more cooperative in gearmand's multitasking model 🤝
    • Negative One (-1) means this event simply won't happen, so only the initial workers get woken up to handle the jobs in the queue. minimal effort, still slaying 💜
  • --version — displays the version and exits. short, sweet, to the point, obsessed ⭐

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. no cap, no safety net, no refunds, no nothing 🫠

🌈 AUTHORS 🌈

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

🧚 SEE ALSO 🧚

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

and that's the whole page bestie, we ate and left no crumbs 🍽️✨ this was brought to you by perl v5.42.3, dated 2026-09-16, under the name GEARMAND-PERL(1p) — mwah, periodt 💅💖

📦 where this page comes from