dasharo/systemd
0
0
Fork 0
mirror of https://github.com/Dasharo/systemd.git synced 2026-03-06 15:02:31 -08:00
Code Issues Packages Projects Releases Wiki Activity

man: document new --exec switch for systemd-notify

Browse Source
This commit is contained in:
Lennart Poettering
2023-02-16 16:30:09 +01:00
parent 9175338e09
commit c4ef4df417
1 changed files with 17 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
man/systemd-notify.xml
View File

@@ -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>