summaryrefslogtreecommitdiff
path: root/man/sd_notify.xml
diff options
context:
space:
mode:
authorDaniel Black <danielgb@au.ibm.com>2017-12-14 22:17:43 +1100
committerLennart Poettering <lennart@poettering.net>2017-12-14 12:17:43 +0100
commita327431bd168b2f327f3cd422379e213c643f2a5 (patch)
tree579e571140c7015f4d4d48d6e2a8558c097688ae /man/sd_notify.xml
parent966c04cf012f48686cf5359067a7b26c080f44ea (diff)
downloadsystemd-a327431bd168b2f327f3cd422379e213c643f2a5.tar.gz
core: add EXTEND_TIMEOUT_USEC={usec} - prevent timeouts in startup/runtime/shutdown (#7214)
With Type=notify services, EXTEND_TIMEOUT_USEC= messages will delay any startup/ runtime/shutdown timeouts. A service that hasn't timed out, i.e, start time < TimeStartSec, runtime < RuntimeMaxSec and stop time < TimeoutStopSec, may by sending EXTEND_TIMEOUT_USEC=, allow the service to continue beyond the limit for the execution phase (i.e TimeStartSec, RunTimeMaxSec and TimeoutStopSec). EXTEND_TIMEOUT_USEC= must continue to be sent (in the same way as WATCHDOG=1) within the time interval specified to continue to reprevent the timeout from occuring. Watchdog timeouts are also extended if a EXTEND_TIMEOUT_USEC is greater than the remaining time on the watchdog counter. Fixes #5868.
Diffstat (limited to 'man/sd_notify.xml')
-rw-r--r--man/sd_notify.xml12
1 files changed, 12 insertions, 0 deletions
diff --git a/man/sd_notify.xml b/man/sd_notify.xml
index a53b1ab33e..c28f303c7e 100644
--- a/man/sd_notify.xml
+++ b/man/sd_notify.xml
@@ -212,6 +212,18 @@
</varlistentry>
<varlistentry>
+ <term>EXTEND_TIMEOUT_USEC=…</term>
+
+ <listitem><para>Tells the service manager to extend the startup, runtime or shutdown service timeout
+ corresponding the current state. The value specified is a time in microseconds during which the service must
+ send a new message. A service timeout will occur if the message isn't received, but only if the runtime of the
+ current state is beyond the original maximium times of <varname>TimeoutStartSec=</varname>, <varname>RuntimeMaxSec=</varname>,
+ and <varname>TimeoutStopSec=</varname>.
+ See <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+ for effects on the service timeouts.</para></listitem>
+ </varlistentry>
+
+ <varlistentry>
<term>FDSTORE=1</term>
<listitem><para>Stores additional file descriptors in the service manager. File descriptors sent this way will