diff options
| author | Alban Crequy <alban.crequy@collabora.co.uk> | 2008-07-21 17:09:14 +0000 |
|---|---|---|
| committer | Jonny Lamb <jonnylamb@jonnylamb.com> | 2008-08-11 20:01:13 +0100 |
| commit | e78334e87d516664e312d3c870247f2d23cb3b12 (patch) | |
| tree | c72cb7c04e8ebe3d4a36c5c7852c68bb5deb4770 /docs | |
| parent | 273f9b0595976a57000ca32d418983658cec6508 (diff) | |
doc: 1-1 stream tube session
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/tubes.txt | 129 |
1 files changed, 127 insertions, 2 deletions
diff --git a/docs/tubes.txt b/docs/tubes.txt index 10138683..6b56b652 100644 --- a/docs/tubes.txt +++ b/docs/tubes.txt @@ -6,12 +6,137 @@ Implementation of tubes in telepathy-salut Implemented. The XMPP spec is available on: http://telepathy.freedesktop.org/xmpp/tubes.html +- 1-1 D-Bus tubes + +Not tested, work in progress. + - 1-1 stream tubes Implemented. The XMPP spec is not finalized. The current code uses stream-initiation (XEP-0095). -- 1-1 D-Bus tubes +Initiator to receptor: offer the tube: + <iq type="set" + from="alban_test01@alban-hp" + to="alban_test02@alban-hp" + id="264209854163"> + <tube type="stream" + service="TicTacTube" + id="958316872" + xmlns="http://telepathy.freedesktop.org/xmpp/tubes"/> + <parameters/> + </iq> -Not tested, work in progress. +Receptor to initiator: acknowledgment of the offer + <iq type="result" + from="alban_test02@alban-hp" + to="alban_test01@alban-hp" + id="264209854163"/> + +This acknowledgment should be used to accept the tube. However the current code +ignores the acknowledgment. The tube will be accepted on the initiator side +when the first stream will be requested by the receptor. Gabble has a similar +problem, see https://bugs.freedesktop.org/show_bug.cgi?id=16595 + +Receptor to initiator: Request first stream in the stream tube with SI: + <iq type="set" + from="alban_test02@alban-hp" + to="alban_test01@alban-hp" + id="305185523299"> + <si id="1216653628-2482728629" + profile="http://telepathy.freedesktop.org/xmpp/tubes" + mime-type="application/octet-stream" + xmlns="http://jabber.org/protocol/si"> + <feature xmlns="http://jabber.org/protocol/feature-neg"> + <x type="form" xmlns="jabber:x:data"> + <field var="stream-method" + type="list-single"> + <option> + <value>jabber:iq:oob</value> + </option> + <option> + <value>http://jabber.org/protocol/ibb</value> + </option> + </field> + </x> + </feature> + <stream tube="958316872" + xmlns="http://telepathy.freedesktop.org/xmpp/tubes"/> + </si> + </iq> + +Initiator to receptor: accept the stream (SI): + <iq type="result" + from="alban_test01@alban-hp" + to="alban_test02@alban-hp" + id="305185523299"> + <si xmlns="http://jabber.org/protocol/si"> + <feature xmlns="http://jabber.org/protocol/feature-neg"> + <x type="submit" + xmlns="jabber:x:data"> + <field var="stream-method"> + <value>jabber:iq:oob</value> + </field> + </x> + </feature> + <tube xmlns="http://telepathy.freedesktop.org/xmpp/tubes"/> + </si> + </iq> + +Receptor to initiator: gives the x-tcp address + <iq type="set" + from="alban_test02@alban-hp" + to="alban_test01@alban-hp" + id="273187360243"> + <query sid="1216654309-3452169159" + xmlns="jabber:iq:oob"> + <url>x-tcp://alban-hp.local:41651</url> + </query> + </iq> + +-- Tube is used -- + +Receptor to initiator: close the tube + + <iq type="set" + from="alban_test02@alban-hp" + to="alban_test01@alban-hp" + id="36867237061"> + <close id="958316872" + xmlns="http://telepathy.freedesktop.org/xmpp/tubes"/> + </iq> + +Initiator to receptor: acknowledges the x-tcp address (why so late?) + + <iq type="result" + from="alban_test01@alban-hp" + to="alban_test02@alban-hp" + id="34466104096"/> + +Initiator to receptor: closes the tube, again + + <iq type="set" + from="alban_test01@alban-hp" + to="alban_test02@alban-hp" + id="40963238067"> + <close id="958316872" + xmlns="http://telepathy.freedesktop.org/xmpp/tubes"/> + </iq> + +Receptor to initiator: acknowledges the close request + + <iq type="result" + from="alban_test01@alban-hp" + to="alban_test02@alban-hp" + id="36867237061"/> + +Receptor to initiator: acknowledgmes the close request, again + +<iq type="result" + from="alban_test02@alban-hp" + to="alban_test01@alban-hp" + id="40963238067"/> + +Note that the close message is sent twice. Gabble does the same. See bug +https://bugs.freedesktop.org/show_bug.cgi?id=16797 |