]>
Commit | Line | Data |
---|---|---|
fda546bd | 1 | The following options are valid on POSIX based platforms. |
064af421 | 2 | .TP |
86f2fa59 | 3 | \fB\-\-pidfile\fR[\fB=\fIpidfile\fR] |
064af421 | 4 | Causes a file (by default, \fB\*(PN.pid\fR) to be created indicating |
86f2fa59 BP |
5 | the PID of the running process. If the \fIpidfile\fR argument is not |
6 | specified, or | |
064af421 BP |
7 | if it does not begin with \fB/\fR, then it is created in |
8 | \fB@RUNDIR@\fR. | |
86f2fa59 | 9 | .IP |
4e312e69 | 10 | If \fB\-\-pidfile\fR is not specified, no pidfile is created. |
a9b4a41a | 11 | . |
064af421 | 12 | .TP |
4e312e69 BP |
13 | \fB\-\-overwrite\-pidfile\fR |
14 | By default, when \fB\-\-pidfile\fR is specified and the specified pidfile | |
e7bd7d78 | 15 | already exists and is locked by a running process, \fB\*(PN\fR refuses |
4e312e69 | 16 | to start. Specify \fB\-\-overwrite\-pidfile\fR to cause it to instead |
e7bd7d78 | 17 | overwrite the pidfile. |
a9b4a41a | 18 | .IP |
4e312e69 | 19 | When \fB\-\-pidfile\fR is not specified, this option has no effect. |
a9b4a41a | 20 | . |
064af421 | 21 | .TP |
4e312e69 | 22 | \fB\-\-detach\fR |
064af421 | 23 | Causes \fB\*(PN\fR to detach itself from the foreground session and |
a7ff9bd7 | 24 | run as a background process. \*(DD |
a9b4a41a | 25 | . |
ff8decf1 | 26 | .TP |
4e312e69 | 27 | \fB\-\-monitor\fR |
ff8decf1 BP |
28 | Creates an additional process to monitor the \fB\*(PN\fR daemon. If |
29 | the daemon dies due to a signal that indicates a programming error | |
f67c3295 BP |
30 | (\fBSIGABRT\fR, \fBSIGALRM\fR, \fBSIGBUS\fR, \fBSIGFPE\fR, |
31 | \fBSIGILL\fR, \fBSIGPIPE\fR, \fBSIGSEGV\fR, \fBSIGXCPU\fR, or | |
32 | \fBSIGXFSZ\fR) then the monitor process starts a new copy of it. If | |
33 | the daemon dies or exits for another reason, the monitor process exits. | |
ff8decf1 | 34 | .IP |
4e312e69 | 35 | This option is normally used with \fB\-\-detach\fR, but it also |
ff8decf1 | 36 | functions without it. |
a9b4a41a | 37 | . |
91a1e24d | 38 | .TP |
4e312e69 BP |
39 | \fB\-\-no\-chdir\fR |
40 | By default, when \fB\-\-detach\fR is specified, \fB\*(PN\fR | |
91a1e24d JP |
41 | changes its current working directory to the root directory after it |
42 | detaches. Otherwise, invoking \fB\*(PN\fR from a carelessly chosen | |
43 | directory would prevent the administrator from unmounting the file | |
44 | system that holds that directory. | |
45 | .IP | |
4e312e69 | 46 | Specifying \fB\-\-no\-chdir\fR suppresses this behavior, preventing |
91a1e24d JP |
47 | \fB\*(PN\fR from changing its current working directory. This may be |
48 | useful for collecting core files, since it is common behavior to write | |
49 | core dumps into the current working directory and the root directory | |
50 | is not a good directory to use. | |
51 | .IP | |
4e312e69 | 52 | This option has no effect when \fB\-\-detach\fR is not specified. |