luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-12-26 15:36:14 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch '1036-dbus-proxy-docs' into 'master'

Browse Source 
gdbusproxy: Recommend it is not used for stateless services

Closes #1036

See merge request GNOME/glib!386
This commit is contained in:
Philip Withnall 2021-05-13 22:25:21 +00:00
commit 87e994ef48
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
gio/gdbusproxy.c
View File

@ -71,6 +71,13 @@
* the message bus launching an owner (unless * the message bus launching an owner (unless
* %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is set). * %G_DBUS_PROXY_FLAGS_DO_NOT_AUTO_START is set).
* *
* If the proxy is for a stateless D-Bus service, where the name owner may
* be started and stopped between calls, the #GDBusProxy:g-name-owner tracking
* of #GDBusProxy will cause the proxy to drop signal and property changes from
* the service after it has restarted for the first time. When interacting
* with a stateless D-Bus service, do not use #GDBusProxy — use direct D-Bus
* method calls and signal connections.
*
* The generic #GDBusProxy::g-properties-changed and * The generic #GDBusProxy::g-properties-changed and
* #GDBusProxy::g-signal signals are not very convenient to work with. * #GDBusProxy::g-signal signals are not very convenient to work with.
* Therefore, the recommended way of working with proxies is to subclass * Therefore, the recommended way of working with proxies is to subclass