Merge branch 'feature/xep-0234'

This commit is contained in:
Jonas Schäfer 2019-06-19 15:14:21 +02:00
commit 7bdd5fc382
1 changed files with 9 additions and 2 deletions

View File

@ -25,6 +25,12 @@
<shortname>jingle-ft</shortname> <shortname>jingle-ft</shortname>
&stpeter; &stpeter;
&lance; &lance;
<revision>
<version>0.19.1</version>
<date>2019-06-19</date>
<initials>ri0n</initials>
<remark>Fix use of hash elements from XEP—0300.</remark>
</revision>
<revision> <revision>
<version>0.19.0</version> <version>0.19.0</version>
<date>2018-11-08</date> <date>2018-11-08</date>
@ -854,7 +860,7 @@ a=file-range:1024-*]]></code>
</checksum> </checksum>
</jingle> </jingle>
</iq>]]></example> </iq>]]></example>
<p>If the initiator wishes to communicate only the hashing algorithm at the beginning of the session (e.g., because it has not yet calculated the checksum), it can send an empty &lt;hash/&gt; element (without a checksum in the XML character data as shown in the previous examples) in the session-initiate message; this enables the recipient to check the file during the transfer session (which can be helpful in the case of transfers that are truncated or fail mid-stream).</p> <p>If the initiator wishes to communicate only the hashing algorithm at the beginning of the session (e.g., because it has not yet calculated the checksum), it can send &lt;hash-used/&gt; element in the session-initiate message; this enables the recipient to check the file during the transfer session (which can be helpful in the case of transfers that are truncated or fail mid-stream).</p>
<example caption="Initiator communicates hashing algorithm in session-initiate"><![CDATA[ <example caption="Initiator communicates hashing algorithm in session-initiate"><![CDATA[
<iq from='romeo@montague.example/dr4hcr0st3lup4c' <iq from='romeo@montague.example/dr4hcr0st3lup4c'
id='nzu25s8' id='nzu25s8'
@ -873,7 +879,7 @@ a=file-range:1024-*]]></code>
<name>test.txt</name> <name>test.txt</name>
<range/> <range/>
<size>6144</size> <size>6144</size>
<hash xmlns='urn:xmpp:hashes:2' algo='sha-1'/> <hash-used xmlns='urn:xmpp:hashes:2' algo='sha-1'/>
</file> </file>
</description> </description>
<transport xmlns='urn:xmpp:jingle:transports:s5b:1' <transport xmlns='urn:xmpp:jingle:transports:s5b:1'
@ -1078,6 +1084,7 @@ a=file-range:1024-*]]></code>
<xs:element name='size' type='xs:positiveInteger'/> <xs:element name='size' type='xs:positiveInteger'/>
<xs:element name='range' type='fileTransferRangeType'/> <xs:element name='range' type='fileTransferRangeType'/>
<xs:element ref='h:hash' minOccurs='0' maxOccurs='unbounded'/> <xs:element ref='h:hash' minOccurs='0' maxOccurs='unbounded'/>
<xs:element ref='h:hash-used' minOccurs='0' maxOccurs='unbounded'/>
</xs:sequence> </xs:sequence>
</xs:complexType> </xs:complexType>