X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.service.xml;h=74d974e6e9f67857c85d31d2e7e2301cae15e242;hb=623538c3125fd0174513e4ef5b0e6163f4ea41ef;hp=af32ccb87816b73810b1ce3c23aef32ecd53d76d;hpb=93ae25e6fd62b2f87c3dd9ad3e81934eecc48057;p=elogind.git

diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index af32ccb87..74d974e6e 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -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 not only triggers a
+                                configuration reload of the daemon,
+                                but also synchronously waits for it to
+                                complete.</para>
                                 </listitem>
                         </varlistentry>