Make -P or --pidfile keep programs from running if already running.

[openvswitch] / controller / controller.8.in

diff --git a/controller/controller.8.in b/controller/controller.8.in
index a829951956ff65dca8c410c2909cbdc97bae344b..2781fdebf76da0069998063fbb517e3115004a89 100644 (file)
--- a/controller/controller.8.in
+++ b/controller/controller.8.in
@@ -117,6 +117,16 @@ 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,
+\fBcontroller\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 \fBcontroller\fR to detach itself from the foreground session and