lib/daemon.man

   1 .TP
   2 \fB-P\fR[\fIpidfile\fR], \fB--pidfile\fR[\fB=\fIpidfile\fR]
   3 Causes a file (by default, \fB\*(PN.pid\fR) to be created indicating
   4 the PID of the running process.  If \fIpidfile\fR is not specified, or
   5 if it does not begin with \fB/\fR, then it is created in
   6 \fB@RUNDIR@\fR.
   7
   8 .TP
   9 \fB-f\fR, \fB--force\fR
  10 By default, when \fB-P\fR or \fB--pidfile\fR is specified and the
  11 specified pidfile already exists and is locked by a running process,
  12 \fB\*(PN\fR refuses to start.  Specify \fB-f\fR or \fB--force\fR
  13 to cause it to instead overwrite the pidfile.
  14
  15 When \fB-P\fR or \fB--pidfile\fR is not specified, this option has no
  16 effect.
  17
  18 .TP
  19 \fB-D\fR, \fB--detach\fR
  20 Causes \fB\*(PN\fR to detach itself from the foreground session and
  21 run as a background process.
  22
  23 .TP
  24 \fB--no-chdir\fR
  25 By default, when \fB-D\fR or \fB--detach\fR is specified, \fB\*(PN\fR
  26 changes its current working directory to the root directory after it
  27 detaches.  Otherwise, invoking \fB\*(PN\fR from a carelessly chosen
  28 directory would prevent the administrator from unmounting the file
  29 system that holds that directory.
  30 .IP
  31 Specifying \fB--no-chdir\fR suppresses this behavior, preventing
  32 \fB\*(PN\fR from changing its current working directory.  This may be
  33 useful for collecting core files, since it is common behavior to write
  34 core dumps into the current working directory and the root directory
  35 is not a good directory to use.
  36 .IP
  37 This option has no effect when neither \fB-D\fR nor \fB--detach\fR is
  38 specified.