moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-24 18:22:24 -05:00
Code Issues Releases Wiki Activity

added optional h attribute to failed element on sm resumption

Browse Source 
as previously discussed on the mailing list: http://mail.jabber.org/pipermail/standards/2015-May/029851.html
This commit is contained in:
Daniel Gultsch 2015-09-14 10:52:23 +02:00 committed by Ash Ward
parent c7d702b0b3
commit 97d743a341
1 changed files with 21 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
xep-0198.xml
View File

@ -28,7 +28,16 @@
&fabio;
&dcridland;
&mwild;
<interim/>
<revision>
<version>1.5</version>
<date>2015-09-13</date>
<initials>dg</initials>
<remark>
<ul>
<li>Noted that the server MAY include a 'h' attribute when failing to resume a session because it has been timed out</li>
</ul>
</remark>
</revision>
<revision>
<version>1.4rc1</version>
<date>2015-07-27</date>
@ -348,7 +357,14 @@ S: <resumed xmlns='urn:xmpp:sm:3'
h='another-sequence-number'
previd='some-long-sm-id'/>
]]></example>
<p>If the server does not support session resumption, it MUST return a &lt;failed/&gt; element, which SHOULD include an error condition of &feature;. If the server does not recognize the 'previd' as an earlier session (e.g., because the former session has timed out), it MUST return a &lt;failed/&gt; element, which SHOULD include an error condition of &notfound;. In both of these failure cases, the server SHOULD allow the client to bind a resource at this point rather than forcing the client to restart the stream negotiation process and re-authenticate.</p>
<p>If the server does not support session resumption, it MUST return a &lt;failed/&gt; element, which SHOULD include an error condition of &feature;. If the server does not recognize the 'previd' as an earlier session (e.g., because the former session has timed out), it MUST return a &lt;failed/&gt; element, which SHOULD include an error condition of &notfound;. If the server recogizes the 'previd' as an earlier session that has timed out the server MAY also include a 'h' attribute indicating the number of stanzas received before the timeout. (Note: For this to work the server has to store the SM-ID/sequence number tuple past the time out of the actual session.)</p>
<example caption='Stream timed out'><![CDATA[
S: <failed xml='urn:xmpp:sm:3'
h='another-sequence-number'>
<item-not-found xmlns='urn:ietf:params:xml:ns:xmpp-stanzas'/>
</failed>
]]></example>
<p>In both of these failure cases, the server SHOULD allow the client to bind a resource at this point rather than forcing the client to restart the stream negotiation process and re-authenticate.</p>
<p>If the former stream is resumed and the server still has the stream for the previously-identified session open at this time, the old stream SHOULD be terminated.</p>
<p>When a session is resumed, the parties proceed as follows:</p>
<ul>
@ -574,6 +590,9 @@ S: <a h='10'/>
maxOccurs='1'>
<xs:group ref='err:stanzaErrorGroup'/>
</xs:sequence>
<xs:attribute name='h'
type='xs:unsignedInt'
use='optional'/>
</xs:complexType>
</xs:element>