summaryrefslogtreecommitdiff
path: root/man/org.freedesktop.systemd1.xml
diff options
context:
space:
mode:
authorLuca Boccassi <bluca@debian.org>2022-03-08 22:13:37 +0000
committerLuca Boccassi <bluca@debian.org>2022-03-10 13:16:21 +0000
commitee3ae55e7537c716530b293c91f3fb9ae22a8049 (patch)
treef94534ceb5f937f2e3b140ff110a891fba1e4349 /man/org.freedesktop.systemd1.xml
parentbd844eae233b74ebf151ceefa0a5f026978bebab (diff)
downloadsystemd-ee3ae55e7537c716530b293c91f3fb9ae22a8049.tar.gz
core: do not return 'skipped' when Condition*= fail with StartUnitWithFlags()
Backward incompatible change to avoid returning 'skipped' if a condition causes a job activation to be skipped when using StartUnitWithFlags(). Job results are broadcasted, so it is theoretically possible that existing software could get confused if they see this result. Replaces https://github.com/systemd/systemd/pull/22369
Diffstat (limited to 'man/org.freedesktop.systemd1.xml')
-rw-r--r--man/org.freedesktop.systemd1.xml5
1 files changed, 1 insertions, 4 deletions
diff --git a/man/org.freedesktop.systemd1.xml b/man/org.freedesktop.systemd1.xml
index 5f1f586222..d47d916b76 100644
--- a/man/org.freedesktop.systemd1.xml
+++ b/man/org.freedesktop.systemd1.xml
@@ -1206,10 +1206,7 @@ node /org/freedesktop/systemd1 {
<para><function>StartUnitWithFlags()</function> is similar to <function>StartUnit()</function> but
allows the caller to pass an extra <varname>flags</varname> parameter, which does not support any
- flags for now, and is reserved for future extensions. The new method also changes the behaviour
- of the <varname>JobRemoved</varname> signal and make it return <literal>skipped</literal> in case
- the unit activation job is skipped because a <varname>Condition*=</varname> is not satisfied.
- With the <varname>StartUnit</varname> method, <literal>done</literal> would be returned instead.</para>
+ flags for now, and is reserved for future extensions.</para>
<para><function>StopUnit()</function> is similar to <function>StartUnit()</function> but stops the
specified unit rather than starting it. Note that the <literal>isolate</literal> mode is invalid for this