diff options
author | Havoc Pennington <hp@redhat.com> | 2007-06-18 19:32:51 +0000 |
---|---|---|
committer | Havoc Pennington <hp@redhat.com> | 2007-06-18 19:32:51 +0000 |
commit | 54b943432c7c947db88066751dd36a372cc9a618 (patch) | |
tree | 9b3eb7bc94cc0058c3fbcf2dc361fac40561a210 /doc | |
parent | ded479fda43da9dbe5780d0a2b287b5b1dcac64e (diff) |
2007-06-18 Havoc Pennington <hp@redhat.com>
* doc/dbus-specification.xml: document org.freedesktop.DBus.GetId()
* bus/driver.c (bus_driver_handle_get_id): implement org.freedesktop.DBus.GetId()
* bus/bus.c (bus_context_new): generate a unique ID for each bus context
* dbus/dbus-connection.c (dbus_connection_get_server_id): new function
* dbus/dbus-bus.c (dbus_bus_get_id): new function
* dbus/dbus-server.c (dbus_server_get_id): new function
Diffstat (limited to 'doc')
-rw-r--r-- | doc/dbus-specification.xml | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index 878c2fa4..39bb7723 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -3824,6 +3824,42 @@ </para> </sect3> + <sect3 id="bus-messages-get-id"> + <title><literal>org.freedesktop.DBus.GetId</literal></title> + <para> + As a method: + <programlisting> + GetId (out STRING id) + </programlisting> + 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>Unique ID identifying the bus daemon</entry> + </row> + </tbody> + </tgroup> + </informaltable> + Gets the unique ID of the bus. The unique ID here is shared among all addresses the + bus daemon is listening on (TCP, UNIX domain socket, etc.) and its format is described in + <xref linkend="uuids"/>. Each address the bus is listening on also has its own unique + ID, as described in <xref linkend="addresses"/>. The per-bus and per-address IDs are not related. + There is also a per-machine ID, described in <xref linkend="standard-interfaces-peer"/> and returned + by org.freedesktop.DBus.Peer.GetMachineId(). + For a desktop session bus, the bus ID can be used as a way to uniquely identify a user's session. + </para> + </sect3> + </sect2> </sect1> |