summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorOlivier Andrieu <oliv__a@users.sourceforge.net>2004-09-24 10:43:36 +0000
committerOlivier Andrieu <oliv__a@users.sourceforge.net>2004-09-24 10:43:36 +0000
commit85f8f62da6bb26d7033310af9d3260b073efe4bf (patch)
tree9b4bc616ed867cba0e8b48873c9b9e91cd326bbb /doc
parent64b63e84b7f08695bf194a05aadd074600c8e622 (diff)
* doc/dbus-specification.xml: document ServiceOwnerChanged signal.
* bus/driver.c, bus/driver.h, bus/services.c: Use ServiceOwnerChanged signal instead of ServiceCreated and ServiceDeleted. * bus/dispatch.c: update testcase for the new signal.
Diffstat (limited to 'doc')
-rw-r--r--doc/dbus-specification.xml59
1 files changed, 12 insertions, 47 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index f0d1727e..4793278f 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -2277,19 +2277,14 @@
<para>
This message is sent to a specific application when it loses primary
ownership of a service.
-
- [FIXME instead of ServiceLost/ServiceCreated going only to
- a specific app, why not just OwnerChanged that covers both
- lost and created and changed owner and deleted]
</para>
</sect3>
- <sect3 id="bus-messages-service-created">
- <title><literal>org.freedesktop.DBus.ServiceCreated</literal></title>
+ <sect3 id="bus-messages-service-owner-changed">
+ <title><literal>org.freedesktop.DBus.ServiceOwnerChanged</literal></title>
<para>
- As a method:
<programlisting>
- ServiceCreated (in STRING service_name)
+ ServiceOwnerChanged (STRING service_name, STRING old_owner, STRING new_owner)
</programlisting>
Message arguments:
<informaltable>
@@ -2309,46 +2304,15 @@
</row>
<row>
<entry>1</entry>
- <entry>UINT32</entry>
- <entry>Flags</entry>
+ <entry>STRING</entry>
+ <entry>Base service of previous owner, empty string if the
+ service is newly created</entry>
</row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- <para>
- This message is broadcast to all applications when a service has been
- successfully registered on the message bus.
- </para>
- </sect3>
-
- <sect3 id="bus-messages-service-deleted">
- <title><literal>org.freedesktop.DBus.ServiceDeleted</literal></title>
- <para>
- As a method:
- <programlisting>
- ServiceDeleted (in STRING service_name)
- </programlisting>
- Message arguments:
- <informaltable>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Argument</entry>
- <entry>Type</entry>
- <entry>Description</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>0</entry>
- <entry>STRING</entry>
- <entry>Name of the service</entry>
- </row>
<row>
- <entry>1</entry>
- <entry>UINT32</entry>
- <entry>Flags</entry>
+ <entry>2</entry>
+ <entry>STRING</entry>
+ <entry>Base service of new owner, empty string if the
+ service is no longer available</entry>
</row>
</tbody>
</tgroup>
@@ -2356,7 +2320,8 @@
</para>
<para>
This message is broadcast to all applications when a service has been
- deleted from the message bus.
+ successfully registered on the message bus, has been deleted
+ or its primary owner has changed.
</para>
</sect3>