From 132e0b532c9b7e7d3166f9d6100d94d395a91aed Mon Sep 17 00:00:00 2001
From: Kevin Kuehler <keur@xcf.berkeley.edu>
Date: Fri, 1 Nov 2019 01:47:37 -0700
Subject: [PATCH] man: Document --job-mode=triggering switch

---
 man/systemctl.xml      | 12 ++++++++++--
 src/core/transaction.c |  1 +
 2 files changed, 11 insertions(+), 2 deletions(-)

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 */
-- 
2.47.3