diff options
author | Ralf Habacker <ralf.habacker@freenet.de> | 2010-10-08 21:09:01 +0200 |
---|---|---|
committer | Ralf Habacker <ralf.habacker@freenet.de> | 2010-10-08 21:09:01 +0200 |
commit | 083027330685067f096b2f278abc2aec1f15aa7f (patch) | |
tree | c6a1f35836b2b9f061d560240911234c8d582c36 | |
parent | d6824bc618a7fd5ffc2c981a4aab85b54c110099 (diff) | |
parent | a96fcb19d1e359207cbda355774851ab1bbbb81d (diff) | |
download | dbus-083027330685067f096b2f278abc2aec1f15aa7f.tar.gz |
Merge branch 'master' of ssh://git.freedesktop.org/git/dbus/dbus
-rw-r--r-- | doc/dbus-specification.xml | 124 |
1 files changed, 5 insertions, 119 deletions
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml index d675cef1..69be6fef 100644 --- a/doc/dbus-specification.xml +++ b/doc/dbus-specification.xml @@ -7,8 +7,8 @@ <article id="index"> <articleinfo> <title>D-Bus Specification</title> - <releaseinfo>Version 0.15</releaseinfo> - <date>September 25, 2010</date> + <releaseinfo>Version 0.14</releaseinfo> + <date>May 12, 2010</date> <authorgroup> <author> <firstname>Havoc</firstname> @@ -2598,124 +2598,10 @@ </informaltable> </sect3> </sect2> - <sect2 id="transports-autolaunch"> - <title>Autolaunch</title> - <para>The autolaunch transport provides a way for dbus clients to autodetect - a running dbus session bus and to autolaunch a session bus if not present. - </para> - <sect3 id="transports-autolaunch-addresses"> - <title>Server Address Format</title> - <para> - Autolaunch addresses uses the "autolaunch:" prefix and support the - following key/value pairs: - </para> - <informaltable> - <tgroup cols="3"> - <thead> - <row> - <entry>Name</entry> - <entry>Values</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>scope</entry> - <entry>(string)</entry> - <entry>scope of autolaunch (Windows only) - <itemizedlist> - <listitem> - <para> - "install-path" - limit session bus to dbus installation path. - The dbus installation path is determined from the location of - the shared dbus library. If the library is located in a 'bin' - subdirectory the installation root is the directory above, - otherwise the directory where the library lives is taken as - installation root. - <programlisting> - <install-root>/bin/[lib]dbus-1.dll - <install-root>/[lib]dbus-1.dll - </programlisting> - </para> - </listitem> - <listitem> - <para> - other values - specify dedicated session bus like 'release', - 'debug' or other - </para> - </listitem> - </itemizedlist> - </entry> - </row> - </tbody> - </tgroup> - </informaltable> - </sect3> - <sect3 id="transports-autolaunch-unix-implementation-notes"> - <title>Unix implementation notes</title> - <para> - [FIXME add unix notes ] - </para> - </sect3> - <sect3 id="transports-autolaunch-windows-implementation-notes"> - <title>Windows implementation notes</title> - <para> - On start, the server opens a transport, creates a mutex and a shared - memory section containing the related session bus address. This mutex will be - inspected by the dbus client library to detect a running dbus session bus. - The access to the mutex and the shared memory section are protected by a - global lock named "UniqueDBusInitMutex". - </para> - <para> - The mutex and shared memory section name depends on the value of the scope - attribute and are listed in the following table: - </para> - <informaltable> - <tgroup cols="3"> - <thead> - <row> - <entry>Scope Attribute Values</entry> - <entry>Mutex Name</entry> - <entry>Shared Memory Section Name</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>not defined or empty</entry> - <entry>cDBusDaemonMutex</entry> - <entry>DBusDaemonAddressInfo</entry> - <entry> </entry> - </row> - <row> - <entry>"install-path"</entry> - <entry>cDBusDaemonMutex-<sha1-hash></entry> - <entry>DBusDaemonAddressInfo-<sha1-hash></entry> - <entry>The term <sha1-hash> is a sha1 hash string build from the - dbus installation root, which is specified in <xref linkend="transports-autolaunch-addresses"/>. - Before creating the sha1 hash the installation root string is converted - to lowercase.</entry> - </row> - <row> - <entry>any other value</entry> - <entry>cDBusDaemonMutex-<scope></entry> - <entry>DBusDaemonAddressInfo-<scope></entry> - <entry>The term <scope> is directly taken from the value of the - scope attribute.</entry> - </row> - </tbody> - </tgroup> - </informaltable> - <para> - In the recent implementation the autolaunch transport uses a tcp transport - on localhost with a port choosen from the operating system. This detail may - change in the future. - </para> - </sect3> - </sect2> - </sect1> - <sect1 id="naming-conventions"> + </sect1> + + <sect1 id="naming-conventions"> <title>Naming Conventions</title> <para> |