From: Kevin Kuehler <keur@xcf.berkeley.edu>
Date: Fri, 1 Nov 2019 08:47:37 +0000 (-0700)
Subject: man: Document --job-mode=triggering switch
X-Git-Tag: v244-rc1~86^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F13904%2Fhead;p=thirdparty%2Fsystemd.git

man: Document --job-mode=triggering switch
---

diff --git a/man/systemctl.xml b/man/systemctl.xml
index a519a2aec11..0e3b90b266a 100644
--- a/man/systemctl.xml
+++ b/man/systemctl.xml
@@ -1601,8 +1601,9 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
         <literal>replace-irreversibly</literal>,
         <literal>isolate</literal>,
         <literal>ignore-dependencies</literal>,
-        <literal>ignore-requirements</literal> or
-        <literal>flush</literal>. Defaults to
+        <literal>ignore-requirements</literal>,
+        <literal>flush</literal>, or
+        <literal>triggering</literal>. Defaults to
         <literal>replace</literal>, except when the
         <command>isolate</command> command is used which implies the
         <literal>isolate</literal> job mode.</para>
@@ -1647,6 +1648,13 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
         dependencies will still be honored.</para>
         </listitem>
 
+        <para><literal>triggering</literal> may only be used with
+        <command>systemctl stop</command>. In this mode, the specified
+        unit and any active units that trigger it are stopped. See the
+        discussion of
+        <varname>Triggers=</varname> in <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+        for more information about triggering units.</para>
+
       </varlistentry>
 
       <varlistentry>
diff --git a/src/core/transaction.c b/src/core/transaction.c
index 34647281a45..a0ea0f04897 100644
--- a/src/core/transaction.c
+++ b/src/core/transaction.c
@@ -1148,6 +1148,7 @@ int transaction_add_triggering_jobs(Transaction *tr, Unit *u) {
         int r;
 
         assert(tr);
+        assert(u);
 
         HASHMAP_FOREACH_KEY(v, trigger, u->dependencies[UNIT_TRIGGERED_BY], i) {
                 /* No need to stop inactive jobs */