NAME

       beanstalkd - simple, fast work queue

SYNOPSIS

       beanstalkd [options]

DESCRIPTION

       Beanstalkd  is  a  simple work-queue service. Its interface is generic, though it was originally designed
       for reducing the latency of page views in high-volume web applications by  running  time-consuming  tasks
       asynchronously.

       When  started,  beanstalkd  opens a socket (or uses a file descriptor provided by the init(1) system, see
       ENVIRONMENT) and listens for incoming connections. For each connection, it reads a sequence  of  commands
       to  create,  reserve,  delete,  and  otherwise  manipulate  "jobs",  units  of  work to be done. See file
       doc/protocol.txt in the beanstalkd distribution for a thorough description of the meaning and  format  of
       the beanstalkd protocol.

OPTIONS

       -b path
              Use  a  binlog to keep jobs on persistent storage in directory path. Upon startup, beanstalkd will
              recover any binlog that is present in path, then, during normal operation,  append  new  jobs  and
              changes in state to the binlog.

       -c     Perform online, incremental compaction of binlog files. Negates -n. This is the default behavior.

              (Do  not  use  this option, except to negate -n. Both -c and -n will likely be removed in a future
              beanstalkd release.)

       -f ms  Call fsync(2) at most once every ms milliseconds. Larger values for ms reduce  disk  activity  and
              improve  speed  at  the  cost  of  safety.  A  power  failure could result in the loss of up to ms
              milliseconds of history.

              A ms value of 0 will cause beanstalkd to call fsync every time it writes to the binlog.

              (This option has no effect without -b.)

       -F     Never call fsync(2). Equivalent to -f with an infinite ms value.

              This is the default behavior.

              (This option has no effect without -b.)

       -h     Show a brief help message and exit.

       -l addr
              Listen on address addr (default is 0.0.0.0).

              (Option -l has no effect if sd-daemon(5) socket activation is being used. See also ENVIRONMENT.)

       -n     Turn off binlog compaction, negating -c.

              (Do not use this option. Both -c and -n will likely be removed in a future beanstalkd release.)

       -p port
              Listen on TCP port port (default is 11300).

              (Option -p has no effect if sd-daemon(5) socket activation is being used. See also ENVIRONMENT.)

       -s bytes
              The size in bytes of each binlog file.

              (This option has no effect without -b.)

       -u user
              Become the user user and its primary group.

       -V     Increase verbosity. May be used more than once to produce more verbose output. The  output  format
              is subject to change.

       -v     Print the version string and exit.

       -z bytes
              The maximum size in bytes of a job.

ENVIRONMENT

       LISTEN_PID, LISTEN_FDS
              These variables can be set by init(1). See sd_listen_fds(3) for details.

SEE ALSO

       sd-daemon(5), sd_listen_fds(5)

       Files README and doc/protocol.txt in the beanstalkd distribution.

       http://kr.github.com/beanstalkd/

AUTHOR

       Beanstalkd is written and maintained by Keith Rarick with the help of many others.

                                                   April 2012                                      BEANSTALKD(1)