summaryrefslogtreecommitdiff
path: root/extensions/Channel_Interface_Tube.xml
diff options
context:
space:
mode:
Diffstat (limited to 'extensions/Channel_Interface_Tube.xml')
-rw-r--r--extensions/Channel_Interface_Tube.xml22
1 files changed, 8 insertions, 14 deletions
diff --git a/extensions/Channel_Interface_Tube.xml b/extensions/Channel_Interface_Tube.xml
index bea58d44..8e1ffab3 100644
--- a/extensions/Channel_Interface_Tube.xml
+++ b/extensions/Channel_Interface_Tube.xml
@@ -40,21 +40,12 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
simultaneously).</p>
</tp:docstring>
- <property name="Initiator" type="u" tp:type="Contact_Handle" access="read"
- tp:name-for-bindings="Initiator">
- <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
- <p>Initiator handle.</p>
- <p>When requesting a channel with
- <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.Interface.Requests.CreateChannel</tp:dbus-ref>,
- this property MUST NOT be included in the request.</p>
- </tp:docstring>
- </property>
-
<property name="Parameters" type="a{sv}" tp:type="String_Variant_Map"
access="readwrite" tp:name-for-bindings="Parameters">
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>Each tube has a dictionary of arbitrary parameters. Parameters are
- commonly used for bootstrap information. The allowable keys,
+ commonly used to bootstrap legacy protocols where you can't
+ negotiate parameters in-band. The allowable keys,
types and values are defined by the service. Connection managers
must support the value being a string (D-Bus type 's'), array of bytes
(D-Bus type 'ay'), unsigned integer (D-Bus type 'u'), integer (D-Bus
@@ -62,15 +53,18 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
<p>When the tube is offered, the parameters are transmitted with the
offer and appear as a property of the incoming tube for other
participants.</p>
- <p>Example of valid parameters:
- <code>{'game name': 'go', 'board size': 19}</code></p>
+ <p>Example of valid parameters for 'smb' Server Message Block over
+ TCP/IP (from <a href="http://www.dns-sd.org/ServiceTypes.html">DNS
+ SRV (RFC 2782) Service Types
+ http://www.dns-sd.org/ServiceTypes.html</a>):
+ <code>{'u': 'username', 'p': 'password', 'path': 'path'}</code></p>
<p>When requesting a channel with
<tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.Interface.Requests.CreateChannel</tp:dbus-ref>,
this property MAY be included in the request. If it is not included in
the request, the connection manager MUST consider the property to be
empty. This property MAY be changed after the channel creation when
the tube is in the state Not_Offered. If the tube is in another
- state, changing this property MUST fail without side effect.</p>
+ state, changing this property MUST fail without side effects.</p>
</tp:docstring>
</property>