summaryrefslogtreecommitdiffstats
path: root/doc/dbus-specification.xml
diff options
context:
space:
mode:
authorOlivier Andrieu <oliv__a@users.sourceforge.net>2004-04-15 22:08:05 +0000
committerOlivier Andrieu <oliv__a@users.sourceforge.net>2004-04-15 22:08:05 +0000
commita470eaa0789662d3d3e1f0a23e75c7be2ab574cc (patch)
treee8db28dbafeb1af3d93459bc2fe76f88e940808b /doc/dbus-specification.xml
parent61b294f1a9e41c68486bc9340cd42d94224a4080 (diff)
2004-04-15 Olivier Andrieu <oliv__a@users.sourceforge.net>
* bus/driver.c (bus_driver_handle_get_service_owner): implement a GetServiceOwner method. * doc/dbus-specification.xml: document it. * dbus/dbus-errors.h: add a 'ServiceHasNoOwner' error. * glib/dbus-gproxy.c (dbus_gproxy_new_for_service_owner): implement, using the bus GetServiceOwner method. * test/glib/test-dbus-glib.c: use dbus_gproxy_new_for_service_owner so that we can receive the signal.
Diffstat (limited to 'doc/dbus-specification.xml')
-rw-r--r--doc/dbus-specification.xml52
1 files changed, 52 insertions, 0 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 94dc740c..2f22b772 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -2206,6 +2206,58 @@
</sect3>
+ <sect3 id="bus-messages-get-service-owner">
+ <title><literal>org.freedesktop.DBus.GetServiceOwner</literal></title>
+ <para>
+ As a method:
+ <programlisting>
+ STRING GetServiceOwner (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 to query</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ Reply 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>Return value, a base service name</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ Returns the base service name of the primary owner of the
+ service in argument. If the requested service isn't active,
+ returns a
+ <literal>org.freedesktop.DBus.Error.ServiceHasNoOwner</literal> error.
+ </para>
+ </sect3>
+
<sect3 id="bus-messages-out-of-memory">
<title><literal>org.freedesktop.DBus.Error.NoMemory</literal></title>
<para>