moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2025-02-16 07:10:15 -05:00
Code Issues Releases Wiki Activity

XEP-0363: Announce maximum file size by means of XEP-0128

Browse Source
This commit is contained in:
Daniel Gultsch 2016-03-07 14:35:20 +01:00 committed by Matthew A. Miller
parent 40123bfcf8
commit ea22a77bc6
1 changed files with 18 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
xep-0363.xml
View File

@ -28,6 +28,12 @@
<email>daniel@gultsch.de</email> <email>daniel@gultsch.de</email>
<jid>daniel@gultsch.de</jid> <jid>daniel@gultsch.de</jid>
</author> </author>
<revision>
<version>0.2</version>
<date>2016-03-07</date>
<initials>dg</initials>
<remark><p>Announce maximum file size by means of &xep0128;</p></remark>
</revision>
<revision> <revision>
<version>0.1.2</version> <version>0.1.2</version>
<date>2016-02-16</date> <date>2016-02-16</date>
@ -66,7 +72,8 @@
</ul> </ul>
</section1> </section1>
<section1 topic='Discovering Support' anchor='disco'> <section1 topic='Discovering Support' anchor='disco'>
<p>An entity advertises support for this protocol by including the "urn:xmpp:http:upload" in its service discovery information features as specified in &xep0030; or section 6.3 of &xep0115;. A users server SHOULD include any known entities that provide such services into its service discovery items.</p> <p>An entity advertises support for this protocol by including the "urn:xmpp:http:upload" in its service discovery information features as specified in &xep0030; or section 6.3 of &xep0115;. To avoid unnecessary round trips an entity SHOULD also include the maximum file size as specified in &xep0128; if such a limitation exisits. The field name MUST be "max-file-size" and the value MUST be in bytes.</p>
<p>A users server SHOULD include any known entities that provide such services into its service discovery items.</p>
<example caption='Client sends service discovery request to server'><![CDATA[ <example caption='Client sends service discovery request to server'><![CDATA[
<iq from='romeo@montague.tld/garden' <iq from='romeo@montague.tld/garden'
id='step_01' id='step_01'
@ -91,7 +98,7 @@
type='get'> type='get'>
<query xmlns='http://jabber.org/protocol/disco#info'/> <query xmlns='http://jabber.org/protocol/disco#info'/>
</iq>]]></example> </iq>]]></example>
<example caption='Upload service replies to service discovery request'><![CDATA[ <example caption='Upload service replies to service discovery request and reports a maximum file size of 5MiB'><![CDATA[
<iq from='upload.montague.tld' <iq from='upload.montague.tld'
id='step_02' id='step_02'
to='romeo@montague.tld/garden' to='romeo@montague.tld/garden'
@ -101,6 +108,14 @@
type='file' type='file'
name='HTTP File Upload' /> name='HTTP File Upload' />
<feature var='urn:xmpp:http:upload' /> <feature var='urn:xmpp:http:upload' />
<x type='result' xmlns='jabber:x:data'>
<field var='FORM_TYPE' type='hidden'>
<value>urn:xmpp:http:upload</value>
</field>
<field var='max-file-size'>
<value>5242880</value>
</field>
</x>
</query> </query>
</iq>]]></example> </iq>]]></example>
</section1> </section1>
@ -145,7 +160,7 @@
<not-acceptable xmlns='urn:ietf:params:xml:ns:xmpp-stanzas' /> <not-acceptable xmlns='urn:ietf:params:xml:ns:xmpp-stanzas' />
<text xmlns='urn:ietf:params:xml:ns:xmpp-stanzas>file too large. the maximum file size is 20000 bytes</text> <text xmlns='urn:ietf:params:xml:ns:xmpp-stanzas>file too large. the maximum file size is 20000 bytes</text>
<file-too-large xmlns='urn:xmpp:http:upload'> <file-too-large xmlns='urn:xmpp:http:upload'>
<max-size>20000</max-size> <max-file-size>20000</max-file-size>
</file-too-large> </file-too-large>
</error> </error>
</iq>]]></example> </iq>]]></example>