Added proxy-error action

Added example of receiver adjusting block-size when accepting a transport-replace for IBB


git-svn-id: file:///home/ksmith/gitmigration/svn/xmpp/trunk@3933 4b5297f7-1745-476d-ba37-a9c6900126ab
This commit is contained in:
Marcus Lundblad 2010-02-17 22:07:29 +00:00
parent 70e0beb38c
commit 0402c375fb
1 changed files with 28 additions and 2 deletions

View File

@ -31,6 +31,12 @@
<email>klaus.hartke@googlemail.com</email>
<jid>nx@jabber.org</jid>
</author>
<revision>
<version>0.4</version>
<date>2010-02-17</date>
<initial>ml</initial>
<remark><p>Added proxy-error action. Added a block-size attribute in the transport-accept action when negotiating a fallback to IBB, analogueous with changes in XEP-0261.</p></remark>
</revision>
<revision>
<version>0.3</version>
<date>2009-07-14</date>
@ -308,6 +314,26 @@ priority = (2^16)*(type preference) + (local preference)
</jingle>
</iq>
]]></example>
<p>If the nominated candidate is of the proxy type and the party that offered that candidate can not connect to the proxy to activate it (for example because of a restrictive firewall), the party shall send a transport-info message containing an &lt;proxy-error/&gt; element as follows.</p>
<example caption="Responder informs initiator that bytestream has been activated"><![CDATA[
<iq from='juliet@capulet.lit/balcony'
id='bv73bs91'
to='romeo@montague.lit/orchard'
type='set'>
<jingle xmlns='urn:xmpp:jingle:1'>
action='transport-info'
initiator='romeo@montague.lit/orchard'
sid='a73sjjvkla37jfea'>
<content creator='initiator' name='stub'>
<transport xmlns='urn:xmpp:jingle:transports:s5b:1'
sid='vj3hs98y'>
<proxy-error/>
</transport>
</content>
</jingle>
</iq>
]]></example>
<p>The parties shall then consider the bytestream unsuccessful and fallback to IBB as described in <link url='#fallback'>Fallback to IBB</link>.</p>
</section2>
<section2 topic='Closing the Bytestream' anchor='close'>
<p>Once the parties have finished using the bytestream (e.g., because a complete file has been sent), either party can send a Jingle session-terminate action.</p>
@ -386,7 +412,7 @@ Romeo Juliet
to='romeo@montague.lit/orchard'
type='result'/>
]]></example>
<p>If the transport replacement is acceptable, the responder then sends a transport-accept action to the initiator (if not, the responder sends a transport-reject action).</p>
<p>If the transport replacement is acceptable, the responder then sends a transport-accept action to the initiator (if not, the responder sends a transport-reject action). If the responder wishes to use a smaller block size than the one specified in the transport-replace offer, this can be done by specifying a block-size attribute in the transport-accept action.</p>
<example caption="Responder sends transport-accept"><![CDATA[
<iq from='juliet@capulet.lit/balcony'
id='is71ns63'
@ -398,7 +424,7 @@ Romeo Juliet
sid='a73sjjvkla37jfea'>
<content creator='initiator' name='stub'>
<transport xmlns='urn:xmpp:jingle:transports:ibb:0'
block-size='4096'
block-size='2048'
sid='ch3d9s71'/>
</content>
</jingle>