gearmand man page

gearmand — Gearman client/worker connector.


 gearmand --daemon


This is the main executable for Gearman::Server.  It provides command-line configuration of port numbers, pidfiles, and daemonization.


--daemonize / -d

Make the daemon run in the background (good for init.d scripts, bad for running under daemontools/supervise).

--port=4730 / -p 4730

Set the port number, defaults to 4730.

--listen hostname / -L hostname

Address the server should listen on.

Default is


Write a pidfile when starting up


Enable debugging (currently the only debug output is when a client or worker connects).


Number of new connections to accept each time we see a listening socket ready. This doesn't usually need to be tuned by anyone, however in dire circumstances you may need to do it quickly.


Number of workers to wake up per job inserted into the queue.

Zero (0) is a perfectly acceptable answer, and can be used 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.

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

All other negative numbers will cause the server to throw exception and not start.


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

Zero (0) 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.

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


Display the version and exit.


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


Brad Fitzpatrick <>

Brad Whitaker <>

See Also






2017-02-11 perl v5.24.1 User Contributed Perl Documentation