| 33 | | \fBCherokee\fP is an extremely fast, flexible and embeddable web |
|---|
| 34 | | server. \fBcherokee\fP is the recommended way to invoke |
|---|
| 35 | | cherokee-worker - It will launch Cherokee with any options specified to it |
|---|
| 36 | | via the command line, and monitor it. In case Cherokee ends |
|---|
| 37 | | abnormally, it will be immediately re-launched. |
|---|
| 38 | | .PP |
|---|
| 39 | | This program was previously called cherokee\-guardian, but became the |
|---|
| 40 | | main binary to invoke Cherokee since release 0.9. |
|---|
| | 33 | \fBcherokee\fP is an extremely fast, flexible and embeddable web server. |
|---|
| | 34 | .\" .PP |
|---|
| | 35 | .\" It also... |
|---|
| | 36 | .SH OPTIONS |
|---|
| | 37 | This command will launch the Cherokee webserver. It accepts the |
|---|
| | 38 | following options: |
|---|
| | 39 | .TP 8 |
|---|
| | 40 | .B \-h, --help |
|---|
| | 41 | Prints a brief help message and terminates execution |
|---|
| | 42 | .TP 8 |
|---|
| | 43 | .B \-V, --version |
|---|
| | 44 | Prints Cherokee's version and terminates execution |
|---|
| | 45 | .TP 8 |
|---|
| | 46 | .B \-t, --test |
|---|
| | 47 | Perform a sanity check on the configuration file. The server will not run. |
|---|
| | 48 | .TP 8 |
|---|
| | 49 | .B \-d, --detach |
|---|
| | 50 | Launches the server as a background process (default behaviour is to |
|---|
| | 51 | stay attached to the controlling terminal). |
|---|
| | 52 | .TP 8 |
|---|
| | 53 | .B \-C, --config=PATH |
|---|
| | 54 | Specifies an alternative path for the configuration file to use instead |
|---|
| | 55 | of the default cherokee.conf |
|---|
| | 56 | .TP 8 |
|---|
| | 57 | .B \-p, --port=PORT |
|---|
| | 58 | TCP port number to which the server will listen. |
|---|
| | 59 | .TP 8 |
|---|
| | 60 | .B \-r, --documentroot=PATH |
|---|
| | 61 | Launches a server exposing statically the specified directory. When |
|---|
| | 62 | launched with \-r, the configuration file is ignored, and the Cherokee |
|---|
| | 63 | instance runs with its default values. |
|---|
| | 64 | .TP 8 |
|---|
| | 65 | .B \-i, --print |
|---|
| | 66 | Print server technical information. |
|---|
| | 67 | .SH SIGNALS |
|---|
| | 68 | The following signals are supported by Cherokee: |
|---|
| | 69 | .TP 8 |
|---|
| | 70 | \fBSIGHUP\fR, Restarts the server gracefully |
|---|
| | 71 | .TP 8 |
|---|
| | 72 | \fBSIGUSR1\fR, Restarts the server closing all the opened connections |
|---|
| | 73 | .TP 8 |
|---|
| | 74 | \fBSIGUSR2\fR, Reopens the log files |
|---|
| | 75 | .TP 8 |
|---|
| | 76 | \fBSIGTERM\fR, Exits |
|---|