diff options
author | Lennart Poettering <lennart@poettering.net> | 2023-05-03 14:13:58 +0200 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2023-05-03 18:21:42 +0200 |
commit | 0de343187127f6a5a93602608812e60fc4092c9a (patch) | |
tree | af1d8c130a51efa6b0009d0ee47d3813eb97369d /man/sd_notify.xml | |
parent | Merge pull request #27510 from poettering/notify-barrier-pid-1-tweaks (diff) | |
download | systemd-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.xml | 14 |
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> |