/usr/share/doc/telepathy-gabble/si-multiple.html is in telepathy-gabble 0.16.0-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 | <?xml version="1.0"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-loose.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>XEP-si-multiple: Stream initiation multi-bytestreams extension</title><link rel="stylesheet" type="text/css" href="../xmpp.css" /><link href="../prettify.css" type="text/css" rel="stylesheet" /><link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" /><script type="text/javascript" src="../prettify.js"></script><meta name="DC.Title" content="Stream initiation multi-bytestreams extension" /><meta name="DC.Creator" content="Guillaume Desmottes" /><meta name="DC.Description" content="Extension of XEP-0095 allowing to negotiate more than one bytestream to be used as a fallback." /><meta name="DC.Publisher" content="XMPP Standards Foundation" /><meta name="DC.Contributor" content="XMPP Extensions Editor" /><meta name="DC.Date" content="2008-12-11" /><meta name="DC.Type" content="XMPP Extension Protocol" /><meta name="DC.Format" content="XHTML" /><meta name="DC.Identifier" content="XEP-si-multiple" /><meta name="DC.Language" content="en" /><meta name="DC.Rights" content="" /></head><body onload="prettyPrint()"><h1>XEP-si-multiple: Stream initiation multi-bytestreams extension</h1><table><tr valign="top"><td><strong>Abstract:</strong></td><td>Extension of XEP-0095 allowing to negotiate more
than one bytestream to be used as a fallback.</td></tr><tr valign="top"><td><strong>Author:</strong></td><td>Guillaume Desmottes</td></tr><tr valign="top"><td><strong>Copyright:</strong></td><td>© 1999 - 2009 XMPP Standards Foundation. <a href="#appendix-legal">SEE LEGAL NOTICES</a>.</td></tr><tr valign="top"><td><strong>Status:</strong></td><td>ProtoXEP</td></tr><tr valign="top"><td><strong>Type:</strong></td><td>Extension</td></tr><tr valign="top"><td><strong>Version:</strong></td><td>0.0.1</td></tr><tr valign="top"><td><strong>Last Updated:</strong></td><td>2008-12-11</td></tr></table><hr /><p style="color:red">WARNING: This document has not yet been accepted for consideration or approved in any official manner by the XMPP Standards Foundation, and this document is not yet an XMPP Extension Protocol (XEP). If this document is accepted as a XEP by the XMPP Council, it will be published at <<a href="http://xmpp.org/extensions/">http://xmpp.org/extensions/</a>> and announced on the <standards@xmpp.org> mailing list.</p><hr /><h2>Table of Contents</h2><div class="indent"><p><br />1. <a href="#intro">Introduction</a><br />2. <a href="#usecases">Use Cases</a><br />3. <a href="#security">Security Considerations</a><br />4. <a href="#iana">IANA Considerations</a><br />5. <a href="#registrar">XMPP Registrar Considerations</a><br />6. <a href="#schema">XML Schema</a></p><p><a href="#appendices">Appendices</a><br /> <a href="#appendix-docinfo">A: Document Information</a><br /> <a href="#appendix-authorinfo">B: Author Information</a><br /> <a href="#appendix-legal">C: Legal Notices</a><br /> <a href="#appendix-xmpp">D: Relation to XMPP</a><br /> <a href="#appendix-discuss">E: Discussion Venue</a><br /> <a href="#appendix-conformance">F: Requirements Conformance</a><br /> <a href="#appendix-notes">G: Notes</a><br /> <a href="#appendix-revs">H: Revision History</a></p></div><hr /><h2>1.
<a name="intro" id="intro">Introduction</a></h2>
<p>This document describes an extension of the Stream Initiation (SI)
protocol. With current SI protocol, the receiver has to choose which
bytestream method he wants to use for the data streaming.
If he chooses an efficient method as SOCKS5 (XEP-0065)
and this method fails because of network topology, the SI fails and
data can't be transferred. The protocol described in this document
aims to solve this problem by allowing users to fallback to another
bytestream method if the first one failed.</p>
<h2>2.
<a name="usecases" id="usecases">Use Cases</a></h2>
<p>When sending a SI request, the sender informs the receiver that he
supports multi-bytestreams by adding the si-multiple node.</p>
<p class="caption"><a name="example-1" id="example-1"></a>Example 1. Romeo sends a SI offer to Juliet</p><div class="indent"><pre class="prettyprint">
<iq to='juliet@capulet.lit/Balcony' type='reply' id='H_1' from='romeo@montague.lit/Home'>
<si xmlns='http://jabber.org/protocol/si' profile='http://telepathy.freedesktop.org/xmpp/tubes' id='alpha'>
<feature xmlns='http://jabber.org/protocol/feature-neg'>
<x xmlns='jabber:x:data' type='form'>
<field var='stream-method' type='list-single'>
<option><value>http://jabber.org/protocol/bytestreams</value></option>
<option><value>http://jabber.org/protocol/ibb</value></option>
</field>
</x>
</feature>
<stream xmlns='http://telepathy.freedesktop.org/xmpp/tubes' tube='370459677'/>
<si-multiple xmlns='http://telepathy.freedesktop.org/xmpp/si-multiple'/>
</si>
</iq>
</pre></div>
<p>If the receiver support multi-bytestreams as well, he sends a list of the methods supported
instead of the normal SI reply. Bytestreams will be try by the sender in that order.</p>
<p class="caption"><a name="example-2" id="example-2"></a>Example 2. Juliet replies to SI offer</p><div class="indent"><pre class="prettyprint">
<iq to='juliet@capulet.lit/Balcony' type='set' id='H_1' from='romeo@montague.lit/Home'>
<si xmlns='http://jabber.org/protocol/si'>
<si-multiple xmlns='http://telepathy.freedesktop.org/xmpp/si-multiple>
<value>http://jabber.org/protocol/bytestreams</value>
<value>http://jabber.org/protocol/ibb</value>
</si-multiple>
</si>
</iq>
</pre></div>
<p>At this point Romeo starts to initiate the bytestream using the first method (XEP-0065).
If that fails, he'll try the second one (XEP-0047). Each bytestream is negotiated
according the protocol described in its XEP. Once a bytestream has been sucessfully established,
all the data are send using it and the other methods are not used.</p>
<h2>3.
<a name="security" id="security">Security Considerations</a></h2>
<p>None.</p>
<h2>4.
<a name="iana" id="iana">IANA Considerations</a></h2>
<p>None.</p>
<h2>5.
<a name="registrar" id="registrar">XMPP Registrar Considerations</a></h2>
<p>None.</p>
<h2>6.
<a name="schema" id="schema">XML Schema</a></h2>
TODO
<hr /><a name="appendices" id="appendices"></a><h2>Appendices</h2><hr /><a name="appendix-docinfo" id="appendix-docinfo"></a><h3>Appendix A: Document Information</h3><p class="indent">
Series: <a href="http://xmpp.org/extensions/">XEP</a><br />
Number: si-multiple<br />
Publisher: <a href="/xsf/">XMPP Standards Foundation</a><br />
Status:
<a href="http://xmpp.org/extensions/xep-0001.html#states-ProtoXEP">ProtoXEP</a><br />
Type:
<a href="http://xmpp.org/extensions/xep-0001.html#types-Extension">Extension</a><br />
Version: 0.0.1<br />
Last Updated: 2008-12-11<br />
Approving Body: <a href="http://xmpp.org/council/">XMPP Council</a><br />Dependencies: XMPP Core, XEP-0095<br />
Supersedes: None<br />
Superseded By: None<br />
Short Name: NOT YET ASSIGNED<br /></p><hr /><a name="appendix-authorinfo" id="appendix-authorinfo"></a><h3>Appendix B: Author Information</h3><div class="indent"><h3>Guillaume Desmottes</h3><p class="indent">
Email:
<a href="mailto:guillaume.desmottes@collabora.co.uk">guillaume.desmottes@collabora.co.uk</a><br />
JabberID:
<a href="xmpp:guillaume.desmottes@collabora.co.uk">guillaume.desmottes@collabora.co.uk</a><br /></p></div><hr /><a name="appendix-legal" id="appendix-legal"></a><h3>Appendix C: Legal Notices</h3><div class="indent"><h4>Copyright</h4><h4>Permissions</h4><h4>Disclaimer of Warranty</h4><span style="font-weight: bold"></span><h4>Limitation of Liability</h4><h4>IPR Conformance</h4></div><hr /><a name="appendix-xmpp" id="appendix-xmpp"></a><h3>Appendix D: Relation to XMPP</h3><p class="indent">The Extensible Messaging and Presence Protocol (XMPP) is defined in the XMPP Core (RFC 3920) and XMPP IM (RFC 3921) specifications contributed by the XMPP Standards Foundation to the Internet Standards Process, which is managed by the Internet Engineering Task Force in accordance with RFC 2026. Any protocol defined in this document has been developed outside the Internet Standards Process and is to be understood as an extension to XMPP rather than as an evolution, development, or modification of XMPP itself.</p><hr /><a name="appendix-discuss" id="appendix-discuss"></a><h3>Appendix E: Discussion Venue</h3><p class="indent">The primary venue for discussion of XMPP Extension Protocols is the <<a href="http://mail.jabber.org/mailman/listinfo/standards">standards@xmpp.org</a>> discussion list.</p><p class="indent">Discussion on other xmpp.org discussion lists might also be appropriate; see <<a href="http://xmpp.org/about/discuss.shtml">http://xmpp.org/about/discuss.shtml</a>> for a complete list.</p><p class="indent">Errata can be sent to <<a href="mailto:editor@xmpp.org">editor@xmpp.org</a>>.</p><hr /><a name="appendix-conformance" id="appendix-conformance"></a><h3>Appendix F: Requirements Conformance</h3><p class="indent">The following requirements keywords as used in this document are to be interpreted as described in <a href="http://www.ietf.org/rfc/rfc2119.txt">RFC 2119</a>: "MUST", "SHALL", "REQUIRED"; "MUST NOT", "SHALL NOT"; "SHOULD", "RECOMMENDED"; "SHOULD NOT", "NOT RECOMMENDED"; "MAY", "OPTIONAL".</p><hr /><a name="appendix-notes" id="appendix-notes"></a><h3>Appendix G: Notes</h3><div class="indent"></div><hr /><a name="appendix-revs" id="appendix-revs"></a><h3>Appendix H: Revision History</h3><p>Note: Older versions of this specification might be available at <a href="http://xmpp.org/extensions/attic/">http://xmpp.org/extensions/attic/</a></p><div class="indent"><h4>Version 0.0.1 (2008-12-11)</h4><div class="indent"><p>First draft.</p> (cassidy)
</div></div><hr /><p>END</p></body></html>
|