diff options
| author | Lennart Poettering <lennart@poettering.net> | 2023-02-16 16:30:09 +0100 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2023-02-17 09:55:35 +0100 |
| commit | c4ef4df41728435dc3bf3c192281aa17fde2be3f (patch) | |
| tree | ed8ec8446e9295688f1c2ee2156a140492e5f11c /man/systemd-notify.xml | |
| parent | notify: add new --exec switch for chaining other commands to systemd-notify (diff) | |
| download | systemd-c4ef4df41728435dc3bf3c192281aa17fde2be3f.tar.xz systemd-c4ef4df41728435dc3bf3c192281aa17fde2be3f.zip | |
man: document new --exec switch for systemd-notify
Diffstat (limited to 'man/systemd-notify.xml')
| -rw-r--r-- | man/systemd-notify.xml | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/man/systemd-notify.xml b/man/systemd-notify.xml index dd76cc0fb6..5a154686f5 100644 --- a/man/systemd-notify.xml +++ b/man/systemd-notify.xml @@ -25,6 +25,9 @@ <cmdsynopsis> <command>systemd-notify <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="opt" rep="repeat">VARIABLE=VALUE</arg></command> </cmdsynopsis> + <cmdsynopsis> + <command>systemd-notify --exec <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="opt" rep="repeat">VARIABLE=VALUE</arg> ; <arg rep="repeat">CMDLINE</arg></command> + </cmdsynopsis> </refsynopsisdiv> <refsect1> @@ -174,6 +177,20 @@ this option set is prone to race conditions in all other cases.</para></listitem> </varlistentry> + <varlistentry> + <term><option>--exec</option></term> + + <listitem><para>If specified <command>systemd-notify</command> will execute another command line + after it completed its operation, replacing its own process. If used, the list of assignments to + include in the message sent must be followed by a <literal>;</literal> character (as separate + argument), followed by the command line to execute. This permits "chaining" of commands, i.e. issuing + one operation, followed immediately by another, without changing PIDs.</para> + + <para>Note that many shells interpret <literal>;</literal> as their own separator for command lines, + hence when <command>systemd-notify</command> is invoked from a shell the semicolon must usually be + escaped as <literal>\;</literal>.</para></listitem> + </varlistentry> + <xi:include href="standard-options.xml" xpointer="help" /> <xi:include href="standard-options.xml" xpointer="version" /> </variablelist> |