shaba/systemd
1
0
Fork 0
mirror of https://github.com/systemd/systemd.git synced 2025-03-14 04:58:28 +03:00
Code

man/org.freedesktop.systemd1.xml: Clarify the behavior of Subscribe()

Browse Source 
It was unclear that it was applied to standard signals too, and this
lead to unexpected behavior.

See: https://github.com/systemd/systemd/pull/36366
This commit is contained in:
Marco Trevisan (Treviño) 2025-02-17 18:12:01 +01:00 committed by Luca Boccassi
parent 89b3d1fafb
commit bd887a75d4
1 changed files with 6 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
man/org.freedesktop.systemd1.xml
View File

@ -1434,7 +1434,12 @@ node /org/freedesktop/systemd1 {
<para><function>Subscribe()</function> enables most bus signals to be sent out. Clients which are
interested in signals need to call this method. Signals are only sent out if at least one client
invoked this method. <function>Unsubscribe()</function> reverts the signal subscription that
invoked this method. Note that this behavior is applied to all the signals that the object
in <constant>/org/freedesktop/systemd1</constant> may emit, including the
D-Bus standard <constant>org.freedesktop.DBus.Properties.PropertiesChanged</constant>
signal and others that do not belong to the <constant>org.freedesktop.systemd1</constant> interface.</para>
<para><function>Unsubscribe()</function> reverts the signal subscription that
<function>Subscribe()</function> implements. It is not necessary to invoke
<function>Unsubscribe()</function> as clients are tracked. Signals are no longer sent out as soon as
all clients which previously asked for <function>Subscribe()</function> either closed their connection