moparisthebest/xeps
1
0
Fork 0
mirror of https://github.com/moparisthebest/xeps synced 2024-11-28 04:02:20 -05:00
Code Issues Releases Wiki Activity

XEP-0045: Specify 333 status code

Browse Source
This commit is contained in:
Jonas Wielicki 2017-12-18 17:44:44 +01:00
parent a66bf3ce0d
commit 22dbb78a40
1 changed files with 50 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

50
xep-0045.xml
View File

@ -45,6 +45,14 @@
</schemaloc> </schemaloc>
<registry/> <registry/>
&stpeter; &stpeter;
<revision>
<version>1.30</version>
<date>2017-12-18</date>
<initials>jwi</initials>
<remark>
<p>Add 333 status code with OPTIONAL feature.</p>
</remark>
</revision>
<revision> <revision>
<version>1.29</version> <version>1.29</version>
<date>2017-09-01</date> <date>2017-09-01</date>
@ -4870,6 +4878,39 @@
</section1> </section1>
<section1 topic='Service Use Cases' anchor='service'>
<section2 topic='Service removes user because of error response' anchor='service-error-kick'>
<p>A MUC service MAY support adding the 333 status code to presences when a user gets removed by the service due to a technical problem (e.g. s2s link failure).</p>
<p>If a MUC service supports this OPTIONAL feature, it MUST include the 333 status code in the resulting presence:</p>
<example caption='MUC service removes user because of error'><![CDATA[
<presence
from='harfleur@chat.shakespeare.lit/pistol'
to='pistol@shakespeare.lit/harfleur'
type='unavailable'>
<x xmlns='http://jabber.org/protocol/muc#user'>
<item affiliation='none' role='none' />
<status code='110'/>
<status code='307'/>
<status code='333'/>
</x>
</presence>
]]></example>
<p>The status code MUST also be included in presences sent to other occupants:</p>
<example caption='MUC service informs other occupants of removal because of an error'><![CDATA[
<presence
from='harfleur@chat.shakespeare.lit/pistol'
to='gower@shakespeare.lit/cell'
type='unavailable'>
<x xmlns='http://jabber.org/protocol/muc#user'>
<item affiliation='none' role='none'/>
<status code='307'/>
<status code='333'/>
</x>
</presence>
]]></example>
</section2>
</section1>
<section1 topic='Status Codes' anchor='statuscodes'> <section1 topic='Status Codes' anchor='statuscodes'>
<p>Multi-User Chat uses a &lt;status/&gt; element (specifically, the 'code' attribute of the &lt;status/&gt; element) to communicate information about a user's status in a room. Over time, the number of status codes has grown quite large, and new status codes continue to be requested of the author. Therefore, these codes are now documented in a registry maintained by the XMPP Registrar. For details, refer to the <link url='#registrar-statuscodes'>Status Codes Registry</link> section of this document.</p> <p>Multi-User Chat uses a &lt;status/&gt; element (specifically, the 'code' attribute of the &lt;status/&gt; element) to communicate information about a user's status in a room. Over time, the number of status codes has grown quite large, and new status codes continue to be requested of the author. Therefore, these codes are now documented in a registry maintained by the XMPP Registrar. For details, refer to the <link url='#registrar-statuscodes'>Status Codes Registry</link> section of this document.</p>
<p>Note: In general, MUC status codes tend to follow the "philosophy" of status codes that is implicit in &rfc2616; and &rfc1893; (1xx codes are informational, 2xx codes specify that it is fine to continue, 3xx codes specify redirects such as being kicked or banned, x3x codes refer to system status, x7x codes refer to security or policy matters, etc.).</p> <p>Note: In general, MUC status codes tend to follow the "philosophy" of status codes that is implicit in &rfc2616; and &rfc1893; (1xx codes are informational, 2xx codes specify that it is fine to continue, 3xx codes specify redirects such as being kicked or banned, x3x codes refer to system status, x7x codes refer to security or policy matters, etc.).</p>
@ -5439,6 +5480,15 @@
because the MUC service is being shut down because the MUC service is being shut down
</purpose> </purpose>
</statuscode> </statuscode>
<statuscode>
<number>333</number>
<stanza>presence</stanza>
<context>Removal from room</context>
<purpose>
Inform users that a user was removed because of an error reply (for example
when an s2s link fails between the MUC and the removed users server).
</purpose>
</statuscode>
]]></code> ]]></code>
</section3> </section3>