1 The following options are valid on POSIX based platforms.
3 \fB\-\-pidfile\fR[\fB=\fIpidfile\fR]
4 Causes a file (by default, \fB\*(PN.pid\fR) to be created indicating
5 the PID of the running process. If the \fIpidfile\fR argument is not
7 if it does not begin with \fB/\fR, then it is created in
10 If \fB\-\-pidfile\fR is not specified, no pidfile is created.
13 \fB\-\-overwrite\-pidfile\fR
14 By default, when \fB\-\-pidfile\fR is specified and the specified pidfile
15 already exists and is locked by a running process, \fB\*(PN\fR refuses
16 to start. Specify \fB\-\-overwrite\-pidfile\fR to cause it to instead
17 overwrite the pidfile.
19 When \fB\-\-pidfile\fR is not specified, this option has no effect.
23 Causes \fB\*(PN\fR to detach itself from the foreground session and
24 run as a background process. \*(DD
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
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.
35 This option is normally used with \fB\-\-detach\fR, but it also
40 By default, when \fB\-\-detach\fR is specified, \fB\*(PN\fR
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.
46 Specifying \fB\-\-no\-chdir\fR suppresses this behavior, preventing
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.
52 This option has no effect when \fB\-\-detach\fR is not specified.