#### 以后有时间在翻译成中文 beanstalkd(1) -- 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.