diff options
| -rw-r--r-- | man/systemd-notify.xml | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/man/systemd-notify.xml b/man/systemd-notify.xml index 46f3f1afaf..5286418cc0 100644 --- a/man/systemd-notify.xml +++ b/man/systemd-notify.xml @@ -73,6 +73,11 @@ environment variables to send as part of the status update.</para> + <para>Note that systemd will refuse reception of + status updates from this command unless + <varname>NotifyAccess=all</varname> is set for the + service unit this command is called from.</para> + </refsect1> <refsect1> @@ -154,6 +159,34 @@ </refsect1> <refsect1> + <title>Example</title> + + <example> + <title>Start-up Notification and Status Updates</title> + + <para>A simple shell daemon that sends + start-up notifications after having set up its + communication channel. During runtime it sends + further status updates to the init + system:</para> + + <programlisting>#!/bin/bash + +mkfifo /tmp/waldo +systemd-notify --ready --status="Waiting for data..." + +while : ; do + read a < /tmp/waldo + systemd-notify --status="Processing $a" + + # Do something with $a ... + + systemd-notify --status="Waiting for data..." +done</programlisting> + </example> + </refsect1> + + <refsect1> <title>See Also</title> <para> <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>, |