diff options
author | Lennart Poettering <lennart@poettering.net> | 2014-10-28 01:49:07 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2014-10-28 02:19:55 +0100 |
commit | f189ab18de69d3dee81117d7925fb370cd038f0f (patch) | |
tree | 49e5346670270801723ae7fecdf6413115826f93 /man/systemd.unit.xml | |
parent | fa1b91632c5220e6589007af4cd573ca909f915a (diff) |
job: optionally, when a job timeout is hit, also execute a failure action
Diffstat (limited to 'man/systemd.unit.xml')
-rw-r--r-- | man/systemd.unit.xml | 41 |
1 files changed, 29 insertions, 12 deletions
diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml index 88c9d7f8e8..803eff24aa 100644 --- a/man/systemd.unit.xml +++ b/man/systemd.unit.xml @@ -888,20 +888,22 @@ <varlistentry> <term><varname>JobTimeoutSec=</varname></term> - - <listitem><para>When clients are - waiting for a job of this unit to - complete, time out after the specified - time. If this time limit is reached, - the job will be cancelled, the unit - however will not change state or even - enter the <literal>failed</literal> - mode. This value defaults to 0 (job - timeouts disabled), except for device + <term><varname>JobTimeoutAction=</varname></term> + <term><varname>JobTimeoutRebootArgument=</varname></term> + + <listitem><para>When a job for this + unit is queued a time-out may be + configured. If this time limit is + reached, the job will be cancelled, + the unit however will not change state + or even enter the + <literal>failed</literal> mode. This + value defaults to 0 (job timeouts + disabled), except for device units. NB: this timeout is independent from any unit-specific timeout (for example, the timeout set with - <varname>Timeout=</varname> in service + <varname>StartTimeoutSec=</varname> in service units) as the job timeout has no effect on the unit itself, only on the job that might be pending for it. Or @@ -911,7 +913,22 @@ timeout set with this option however is useful to abort only the job waiting for the unit state to - change.</para></listitem> + change.</para> + + <para><varname>JobTimeoutAction=</varname> + optionally configures an additional + action to take when the time-out is + hit. It takes the same values as the + per-service + <varname>StartLimitAction=</varname> + setting, see + <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry> + for details. Defaults to + <option>none</option>. <varname>JobTimeoutRebootArgument=</varname> + configures an optional reboot string + to pass to the + <citerefentry><refentrytitle>reboot</refentrytitle><manvolnum>2</manvolnum></citerefentry> + system call.</para></listitem> </varlistentry> <varlistentry> |