man: clarify that the ExecReload= command should be synchronous

http://lists.freedesktop.org/archives/systemd-devel/2014-May/019054.html (cherry picked from commit 33169701b0) (cherry picked from commit e3f7124073)
2026-10-03 23:38:39 +00:00 · 2014-06-18 12:34:14 -04:00
parent 54fe753272
commit 94dde9f705
1 changed files with 14 additions and 0 deletions
@@ -519,6 +519,20 @@ ExecStart=/bin/echo $ONE $TWO ${TWO}</programlisting>
                                following:</para>

                                <programlisting>/bin/kill -HUP $MAINPID</programlisting>
+
+                                <para>Note however that reloading a
+                                daemon by sending a signal (as with
+                                the example line above) is usually not
+                                a good choice, because this is an
+                                asynchronous operation and hence not
+                                suitable to order reloads of multiple
+                                services against each other. It is
+                                strongly recommended to set
+                                <varname>ExecReload=</varname> to a
+                                command that no only triggers a
+                                configuration reload of the daemon,
+                                but also synchronously waits for it
+                                complete.</para>
                                </listitem>
                        </varlistentry>