From: Simon McVittie <simon.mcvittie@collabora.co.uk>
Date: Fri, 4 May 2007 10:28:12 +0000 (+0000)
Subject: doc/dbus-specification.xml: mention the reserved o.fd.DBus.Local interface
X-Git-Tag: dbus-1.1.0~35
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=e600d78e41511e8fbaf20cc1c2d3ddac97cbf3e0;p=thirdparty%2Fdbus.git

doc/dbus-specification.xml: mention the reserved o.fd.DBus.Local interface
and the corresponding /o/fd/DBus/Local object path; describe them as reserved
and forbid using them in a sent message, mentioning that in the reference
implementation this will cause the connection to be dropped.
Patch approved by Havoc.
---

diff --git a/ChangeLog b/ChangeLog
index 5e112ff05..454b092ee 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2007-05-04  Simon McVittie <simon.mcvittie@collabora.co.uk>
+
+	* doc/dbus-specification.xml: mention the reserved o.fd.DBus.Local
+	interface and the corresponding /o/fd/DBus/Local object path;
+	describe them as reserved and forbid using them in a sent message,
+	mentioning that in the reference implementation this will cause the
+	connection to be dropped. Patch approved by Havoc.
+
 2007-04-28  Ralf Habacker <ralf.habacker@freenet.de>
 
 	* cmake/: don't install test applications and service files,
diff --git a/doc/dbus-specification.xml b/doc/dbus-specification.xml
index 77b7e699c..71c267ea4 100644
--- a/doc/dbus-specification.xml
+++ b/doc/dbus-specification.xml
@@ -921,8 +921,13 @@
                   <entry>1</entry>
                   <entry><literal>OBJECT_PATH</literal></entry>
                   <entry><literal>METHOD_CALL</literal>, <literal>SIGNAL</literal></entry>
-                  <entry>The object to send a call to, 
+                  <entry>The object to send a call to,
                     or the object a signal is emitted from.
+                    The special path
+                    <literal>/org/freedesktop/DBus/Local</literal> is reserved;
+                    implementations should not send messages with this path,
+                    and the reference implementation of the bus daemon will
+                    disconnect any application that attempts to do so.
                   </entry>
                 </row>
                 <row>
@@ -934,6 +939,12 @@
                     The interface to invoke a method call on, or 
                     that a signal is emitted from. Optional for 
                     method calls, required for signals.
+                    The special interface
+                    <literal>org.freedesktop.DBus.Local</literal> is reserved;
+                    implementations should not send messages with this
+                    interface, and the reference implementation of the bus
+                    daemon will disconnect any application that attempts to
+                    do so.
                   </entry>
                 </row>
                 <row>