From: "William Hubbs" <williamh@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Subject: [gentoo-commits] proj/openrc:master commit in: /
Date: Mon, 22 Oct 2018 23:09:58 +0000 (UTC) [thread overview]
Message-ID: <1540248565.aacf841de4983ab33755081a6f69cdf5e3a47007.williamh@OpenRC> (raw)
commit: aacf841de4983ab33755081a6f69cdf5e3a47007
Author: William Hubbs <w.d.hubbs <AT> gmail <DOT> com>
AuthorDate: Mon Oct 22 22:49:25 2018 +0000
Commit: William Hubbs <williamh <AT> gentoo <DOT> org>
CommitDate: Mon Oct 22 22:49:25 2018 +0000
URL: https://gitweb.gentoo.org/proj/openrc.git/commit/?id=aacf841d
supervise-daemon-guide.md: re-format and add more variables
supervise-daemon-guide.md | 65 ++++++++++++++++++++++++++++++++++-------------
1 file changed, 47 insertions(+), 18 deletions(-)
diff --git a/supervise-daemon-guide.md b/supervise-daemon-guide.md
index ec885e71..0b15a858 100644
--- a/supervise-daemon-guide.md
+++ b/supervise-daemon-guide.md
@@ -7,44 +7,73 @@ terminates unexpectedly.
The following is a brief guide on using this capability.
-## Use Default start, stop and status functions
+* Use Default start, stop and status functions
+ If you write your own start, stop and status functions in your service
+ script, none of this will work. You must allow OpenRC to use the default
+ functions.
-If you write your own start, stop and status functions in your service
-script, none of this will work. You must allow OpenRC to use the default
-functions.
+* Daemons must not fork
+ Any deamon that you would like to have monitored by supervise-daemon
+ must not fork. Instead, it must stay in the foreground. If the daemon
+ forks, the supervisor will be unable to monitor it.
-## Daemons must not fork
+ If the daemon can be configured to not fork, this should be done in the
+ daemon's configuration file, or by adding a command line option that
+ instructs it not to fork to the command_args_foreground variable shown
+ below.
-Any deamon that you would like to have monitored by supervise-daemon
-must not fork. Instead, it must stay in the foreground. If the daemon
-itself forks, the supervisor will be unable to monitor it.
-
-If the daemon can be configured to not fork, this should be done in the
-daemon's configuration file, or by adding a command line option that
-instructs it not to fork to the command_args_foreground variable shown
-below.
-
-## Variable Settings
+# Variable Settings
The most important setting is the supervisor variable. At the top of
your service script, you should set this variable as follows:
+``` sh
supervisor=supervise-daemon
+```
Several other variables affect the way services behave under
supervise-daemon. They are documented on the openrc-run man page, but I
will list them here for convenience:
+``` sh
pidfile=/pid/of/supervisor.pid
+```
If you are using start-stop-daemon to monitor your scripts, the pidfile
is the path to the pidfile the daemon creates. If, on the other hand,
you are using supervise-daemon, this is the path to the pidfile the
supervisor creates.
-command_args_foreground should be used if the daemon you want to monitor
+``` sh
+command_args_foreground="arguments"
+```
+
+This should be used if the daemon you want to monitor
forks and goes to the background by default. This should be set to the
command line option that instructs the daemon to stay in the foreground.
-This is very early support, so feel free to file bugs if you have
-issues.
+``` sh
+respawn_delay
+```
+
+This is the number of seconds to delay before attempting to respawn a
+supervised process after it dies unexpectedly.
+The default is to respawn immediately.
+
+``` sh
+respawn_max=x
+```
+
+This is the maximum number of times to respawn a supervised process
+during the given respawn period. The default is unlimited.
+
+``` sh
+respawn_period=seconds
+```
+
+This works in conjunction with respawn_max and respawn_delay above to
+decide if a process should not be respawned for some reason.
+
+For example, if respawn_period is 60, respawn_max is 2 and respawn_delay
+is 3 and a process dies more than 4 times, the process will not be
+respawned and the supervisor will terminate.
next reply other threads:[~2018-10-22 23:10 UTC|newest]
Thread overview: 150+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-10-22 23:09 William Hubbs [this message]
-- strict thread matches above, loose matches on Subject: below --
2018-11-02 23:24 [gentoo-commits] proj/openrc:master commit in: / William Hubbs
2018-10-23 22:14 William Hubbs
2018-10-23 22:00 William Hubbs
2018-10-23 22:00 William Hubbs
2018-06-28 18:33 William Hubbs
2018-06-28 18:03 William Hubbs
2018-06-17 17:46 William Hubbs
2018-06-15 23:07 William Hubbs
2018-06-15 18:01 William Hubbs
2018-06-05 22:38 William Hubbs
2018-06-05 22:38 William Hubbs
2018-06-05 21:28 William Hubbs
2018-05-31 21:54 William Hubbs
2018-03-12 2:43 William Hubbs
2018-02-28 22:32 William Hubbs
2018-01-24 23:44 William Hubbs
2018-01-11 16:59 William Hubbs
2018-01-10 19:29 William Hubbs
2018-01-08 21:34 William Hubbs
2018-01-08 20:07 William Hubbs
2017-12-07 18:53 William Hubbs
2017-10-25 20:10 William Hubbs
2017-10-24 15:43 William Hubbs
2017-10-13 21:11 William Hubbs
2017-10-13 16:38 William Hubbs
2017-10-12 23:55 William Hubbs
2017-10-02 21:59 William Hubbs
2017-10-02 16:22 William Hubbs
2017-09-16 18:27 William Hubbs
2017-09-16 18:27 William Hubbs
2017-09-15 20:32 William Hubbs
2017-09-14 15:57 William Hubbs
2017-09-07 17:25 William Hubbs
2017-09-06 22:33 William Hubbs
2017-08-24 16:45 William Hubbs
2017-08-16 17:16 William Hubbs
2017-07-24 22:29 William Hubbs
2017-07-13 22:51 William Hubbs
2017-07-13 22:51 William Hubbs
2017-07-11 20:13 William Hubbs
2017-07-11 19:57 William Hubbs
2017-06-12 15:41 William Hubbs
2017-06-07 17:15 William Hubbs
2017-05-16 0:00 William Hubbs
2017-05-12 3:01 William Hubbs
2017-04-19 22:38 William Hubbs
2017-04-17 17:49 William Hubbs
2017-03-31 15:37 William Hubbs
2017-03-15 22:31 William Hubbs
2017-03-12 18:56 William Hubbs
2017-03-10 19:33 William Hubbs
2017-01-26 23:07 William Hubbs
2016-12-21 17:51 William Hubbs
2016-12-20 18:34 William Hubbs
2016-09-28 0:40 William Hubbs
2016-09-27 17:26 William Hubbs
2016-09-09 0:28 William Hubbs
2016-08-30 14:16 William Hubbs
2016-08-30 14:16 William Hubbs
2016-08-25 22:35 William Hubbs
2016-07-25 18:54 William Hubbs
2016-06-10 21:12 William Hubbs
2016-05-24 19:10 William Hubbs
2016-05-24 18:14 William Hubbs
2016-05-24 18:05 William Hubbs
2016-05-19 18:37 William Hubbs
2016-02-09 21:42 William Hubbs
2016-01-19 22:33 William Hubbs
2016-01-14 17:37 William Hubbs
2016-01-13 17:04 William Hubbs
2015-12-11 22:49 William Hubbs
2015-12-09 23:58 William Hubbs
2015-12-08 19:12 William Hubbs
2015-12-08 19:12 William Hubbs
2015-12-06 0:14 William Hubbs
2015-12-04 19:52 William Hubbs
2015-10-08 21:15 William Hubbs
2015-10-08 18:34 William Hubbs
2015-07-10 18:26 William Hubbs
2015-06-19 14:56 William Hubbs
2015-05-29 6:11 Mike Frysinger
2015-05-13 21:07 William Hubbs
2015-05-11 23:46 William Hubbs
2015-05-02 0:03 William Hubbs
2015-05-01 21:19 William Hubbs
2015-04-26 15:31 William Hubbs
2015-04-25 23:36 William Hubbs
2015-04-25 1:01 William Hubbs
2015-04-25 0:41 William Hubbs
2015-04-22 22:43 William Hubbs
2015-04-22 22:14 William Hubbs
2015-04-22 22:05 William Hubbs
2015-04-22 21:17 William Hubbs
2015-04-22 20:55 William Hubbs
2015-04-22 20:40 William Hubbs
2015-04-22 20:09 William Hubbs
2015-04-22 20:09 William Hubbs
2015-01-23 18:57 William Hubbs
2014-10-20 20:59 William Hubbs
2014-10-20 20:59 William Hubbs
2014-08-22 19:10 William Hubbs
2014-08-17 5:14 ` William Hubbs
2014-08-17 21:07 William Hubbs
2014-08-22 19:10 ` William Hubbs
2014-08-16 22:18 William Hubbs
2014-08-22 19:10 ` William Hubbs
2014-08-11 18:18 William Hubbs
2014-08-22 19:10 ` William Hubbs
2014-07-10 14:05 William Hubbs
2014-07-01 12:33 William Hubbs
2014-06-24 1:54 William Hubbs
2014-04-10 0:58 William Hubbs
2014-01-23 18:04 William Hubbs
2013-08-24 23:00 William Hubbs
2013-08-14 6:08 William Hubbs
2013-08-14 5:17 William Hubbs
2013-07-16 18:56 William Hubbs
2013-07-16 18:56 William Hubbs
2013-06-24 21:31 Robin H. Johnson
2013-05-07 22:08 William Hubbs
2013-05-07 19:40 William Hubbs
2012-11-02 21:41 William Hubbs
2012-10-18 15:14 William Hubbs
2012-09-23 16:12 William Hubbs
2012-07-09 2:05 William Hubbs
2012-05-22 15:14 William Hubbs
2012-03-02 19:55 Robin H. Johnson
2012-02-12 19:38 Christian Ruppert
2012-01-25 19:04 Robin H. Johnson
2012-01-14 20:11 William Hubbs
2012-01-07 0:02 William Hubbs
2011-12-09 23:49 William Hubbs
2011-11-25 21:40 William Hubbs
2011-11-23 14:38 William Hubbs
2011-10-16 15:36 Christian Ruppert
2011-09-08 20:13 William Hubbs
2011-09-08 18:31 William Hubbs
2011-09-02 20:26 William Hubbs
2011-09-01 22:21 William Hubbs
2011-09-01 15:35 William Hubbs
2011-07-13 22:54 William Hubbs
2011-06-24 17:47 William Hubbs
2011-06-20 2:39 William Hubbs
2011-05-16 22:05 Mike Frysinger
2011-04-19 17:19 Robin H. Johnson
2011-04-16 1:02 William Hubbs
2011-04-12 13:49 William Hubbs
2011-03-22 5:49 William Hubbs
2011-02-22 2:59 Robin H. Johnson
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1540248565.aacf841de4983ab33755081a6f69cdf5e3a47007.williamh@OpenRC \
--to=williamh@gentoo.org \
--cc=gentoo-commits@lists.gentoo.org \
--cc=gentoo-dev@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox