2009-07-08 13:19:16 -07:00
|
|
|
.TP
|
|
|
|
|
\fB-P\fR[\fIpidfile\fR], \fB--pidfile\fR[\fB=\fIpidfile\fR]
|
|
|
|
|
Causes a file (by default, \fB\*(PN.pid\fR) to be created indicating
|
|
|
|
|
the PID of the running process. If \fIpidfile\fR is not specified, or
|
|
|
|
|
if it does not begin with \fB/\fR, then it is created in
|
|
|
|
|
\fB@RUNDIR@\fR.
|
|
|
|
|
|
|
|
|
|
.TP
|
|
|
|
|
\fB-f\fR, \fB--force\fR
|
|
|
|
|
By default, when \fB-P\fR or \fB--pidfile\fR is specified and the
|
|
|
|
|
specified pidfile already exists and is locked by a running process,
|
|
|
|
|
\fB\*(PN\fR refuses to start. Specify \fB-f\fR or \fB--force\fR
|
|
|
|
|
to cause it to instead overwrite the pidfile.
|
|
|
|
|
|
|
|
|
|
When \fB-P\fR or \fB--pidfile\fR is not specified, this option has no
|
|
|
|
|
effect.
|
|
|
|
|
|
|
|
|
|
.TP
|
|
|
|
|
\fB-D\fR, \fB--detach\fR
|
|
|
|
|
Causes \fB\*(PN\fR to detach itself from the foreground session and
|
|
|
|
|
run as a background process.
|
2009-08-04 22:41:46 -07:00
|
|
|
|
|
|
|
|
.TP
|
|
|
|
|
\fB--no-chdir\fR
|
|
|
|
|
By default, when \fB-D\fR or \fB--detach\fR is specified, \fB\*(PN\fR
|
|
|
|
|
changes its current working directory to the root directory after it
|
|
|
|
|
detaches. Otherwise, invoking \fB\*(PN\fR from a carelessly chosen
|
|
|
|
|
directory would prevent the administrator from unmounting the file
|
|
|
|
|
system that holds that directory.
|
|
|
|
|
.IP
|
|
|
|
|
Specifying \fB--no-chdir\fR suppresses this behavior, preventing
|
|
|
|
|
\fB\*(PN\fR from changing its current working directory. This may be
|
|
|
|
|
useful for collecting core files, since it is common behavior to write
|
|
|
|
|
core dumps into the current working directory and the root directory
|
|
|
|
|
is not a good directory to use.
|
|
|
|
|
.IP
|
|
|
|
|
This option has no effect when neither \fB-D\fR nor \fB--detach\fR is
|
|
|
|
|
specified.
|
