aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRoy Marples <roy@marples.name>2009-04-22 10:49:07 +0000
committerRoy Marples <roy@marples.name>2009-04-22 10:49:07 +0000
commit953b0b74357d28a1ec28ca13fbdeaa126fa2bbaa (patch)
treeb1dc40959b1de3ad6b740f17845a31d2668810df
parentf326f688f6a9d49936f4e5e6e6b9db67957c6797 (diff)
Document -i, --interpreted flag.
-rw-r--r--man/start-stop-daemon.827
1 files changed, 14 insertions, 13 deletions
diff --git a/man/start-stop-daemon.8 b/man/start-stop-daemon.8
index 1b1f664c..8b63741a 100644
--- a/man/start-stop-daemon.8
+++ b/man/start-stop-daemon.8
@@ -22,7 +22,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd April 19, 2009
+.Dd April 22, 2009
.Dt START-STOP-DAEMON 8 SMM
.Os OpenRC
.Sh NAME
@@ -52,14 +52,6 @@ are provided, then we assume we are starting the daemon.
If a daemon cannot background by itself, nor create a pidfile,
.Nm
can do it for the daemon in a secure fashion.
-.Nm
-also ensures that a daemon really has started by checking to see if it still
-exists for a short time after it has started. This is because some badly
-written daemons like to daemonize before checking their configuration, doing
-sanity checks, etc. Likewise,
-.Nm
-ensures that a daemon really stops as well, again by using the information
-above to ensure that it's not running.
.Pp
If
.Nm
@@ -84,6 +76,16 @@ listed in the
Match the process
.Ar name
instead of a pidfile or executable.
+.It Fl i , -interpreted
+When matching process name, we should ensure that the correct interpreter
+is also matched.
+So if the daemon foo starts off like so
+.D1 #!/usr/bin/perl -w
+then
+.Nm
+matches the process
+.D1 /usr/bin/perl -w foo
+If an interpreted daemon changes it's process name then this won't work.
.It Fl u , -user Ar user Ns Op : Ns Ar group
Start the daemon as the
.Ar user
@@ -155,10 +157,9 @@ but with the standard error output.
These options are only used for stopping daemons:
.Bl -tag -width indent
.It Fl R , -retry Ar timeout | Ar signal Ns / Ns Ar timeout
-You can either specify a timeout or a multiple signal/timeout pairs as a
-stopping schedule.
-If not specified then a default value of SIGTERM/0 is
-assumed.
+You can either specify a timeout in seconds or a multiple signal/timeout
+pairs as a stopping schedule.
+If not specified then a default value of SIGTERM/5 is assumed.
.El
.Sh ENVIRONMENT
.Va SSD_NICELEVEL