summaryrefslogtreecommitdiffstats
path: root/man/sd_notify.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2023-05-03 14:13:58 +0200
committerLennart Poettering <lennart@poettering.net>2023-05-03 18:21:42 +0200
commit0de343187127f6a5a93602608812e60fc4092c9a (patch)
treeaf1d8c130a51efa6b0009d0ee47d3813eb97369d /man/sd_notify.xml
parentMerge pull request #27510 from poettering/notify-barrier-pid-1-tweaks (diff)
downloadsystemd-0de343187127f6a5a93602608812e60fc4092c9a.tar.xz
systemd-0de343187127f6a5a93602608812e60fc4092c9a.zip
sd-daemon: add sd_pid_notify_barrier() call and use it in systemd-notify
Previously we'd honour --pid= from the main notification we send, but not from the barrier. This is confusing at best. Let's fix that.
Diffstat (limited to 'man/sd_notify.xml')
-rw-r--r--man/sd_notify.xml14
1 files changed, 12 insertions, 2 deletions
diff --git a/man/sd_notify.xml b/man/sd_notify.xml
index b82d145860..89f1729b13 100644
--- a/man/sd_notify.xml
+++ b/man/sd_notify.xml
@@ -24,6 +24,7 @@
<refname>sd_pid_notify_with_fds</refname>
<refname>sd_pid_notifyf_with_fds</refname>
<refname>sd_notify_barrier</refname>
+ <refname>sd_pid_notify_barrier</refname>
<refpurpose>Notify service manager about start-up completion and other service status changes</refpurpose>
</refnamediv>
@@ -83,6 +84,13 @@
<paramdef>int <parameter>unset_environment</parameter></paramdef>
<paramdef>uint64_t <parameter>timeout</parameter></paramdef>
</funcprototype>
+
+ <funcprototype>
+ <funcdef>int <function>sd_pid_notify_barrier</function></funcdef>
+ <paramdef>pid_t <parameter>pid</parameter></paramdef>
+ <paramdef>int <parameter>unset_environment</parameter></paramdef>
+ <paramdef>uint64_t <parameter>timeout</parameter></paramdef>
+ </funcprototype>
</funcsynopsis>
</refsynopsisdiv>
@@ -372,8 +380,10 @@
previously sent notification messages and uses the <varname>BARRIER=1</varname> command. It takes a
relative <varname>timeout</varname> value in microseconds which is passed to
<citerefentry><refentrytitle>ppoll</refentrytitle><manvolnum>2</manvolnum>
- </citerefentry>. A value of UINT64_MAX is interpreted as infinite timeout.
- </para>
+ </citerefentry>. A value of UINT64_MAX is interpreted as infinite timeout.</para>
+
+ <para><function>sd_pid_notify_barrier()</function> is just like <function>sd_notify_barrier()</function>,
+ but allows specifying the originating PID for the notification message.</para>
</refsect1>
<refsect1>