diff options
author | Mattias Andrée <maandree@operamail.com> | 2014-08-29 20:38:42 +0200 |
---|---|---|
committer | Mattias Andrée <maandree@operamail.com> | 2014-08-29 20:38:58 +0200 |
commit | 5d0bf5d53bfb0ab8005e65a26a656a2b24615b0c (patch) | |
tree | 6f29cf12ad4e63172eceee952e8769c62e0303a1 | |
parent | the children should not have an alarm set (diff) | |
download | mds-5d0bf5d53bfb0ab8005e65a26a656a2b24615b0c.tar.gz mds-5d0bf5d53bfb0ab8005e65a26a656a2b24615b0c.tar.bz2 mds-5d0bf5d53bfb0ab8005e65a26a656a2b24615b0c.tar.xz |
info: mds-respawn
Signed-off-by: Mattias Andrée <maandree@operamail.com>
-rw-r--r-- | doc/info/mds.texinfo | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/doc/info/mds.texinfo b/doc/info/mds.texinfo index 0f73c7e..f30ffea 100644 --- a/doc/info/mds.texinfo +++ b/doc/info/mds.texinfo @@ -54,6 +54,7 @@ Texts. A copy of the license is included in the section entitled * Overview:: Brief overview of @command{mds}. * Architecture:: Architectural overview of @command{mds}. * Protocol:: The @command{mds} procotol. +* Utilities:: About @command{mds} utilities. * libmdsserver:: Overview of @command{libmdsserver}. * mds-base:: Overview of @command{mds-base}. * GNU Free Documentation License:: Copying and sharing this manual. @@ -764,6 +765,57 @@ Command: keyboard-enumeration\n +@node Utilities +@chapter Utilities + +@menu +* mds-respawn:: The server immortality protocol. +@end menu + + + +@node mds-respawn +@section @command{mds-respawn} + +@command{mds-respawn} is a utility intended to be used +in @file{$@{XDG_CONFIG_HOME@}/mdsinitrc}. It will spawn +a selected set of servers. If a server it spawns exits +with a bad status, @command{mds-respawn} will respawn it. +@command{mds-respawn} supports two options in the command +line: + +@table @option +@item --alarm=SECONDS +Schedule @command{mds-respawn} to die in @var{SECONDS} +seconds. At most 1 minute. + +@item --interval=SECONDS +Spawned servers that die twice with @var{SECONDS} +seconds should stop respawning until the signal +@code{SIGUSR2} is send to @command{mds-respawn}. +At most 1 minute. +@end table + +Commands for servers to spawn are specified within +curly braces. Each of the braces must be alone its +its own argument. For example: + +@example +mds-respawn --interval=5 \ + @{ mds-foo --initial-spawn @} \ + @{ mds-bar --initial-spawn @} +@end example + +will spawn and supervise the servers @command{mds-foo} +and @command{mds-bar}. Both spawned with the +argument @option{--initial-spawn}. When a server is +respawed by @command{mds-respawn}, @option{--initial-spawn} +in its argument list will be replaced by +@option{--respawn} to let the server know it is being +respawned. + + + @node libmdsserver @chapter libmdsserver |