Mercurial > prosody-wiki
annotate mod_smacks.wiki @ 257:53e6f43b23fc
Created wiki page through web user interface.
| author | MWild1@gmail.com |
|---|---|
| date | Sun, 15 Jan 2012 01:35:10 +0000 |
| parents | 5bbdbce10b0a |
| children | 36f475bd6425 |
| rev | line source |
|---|---|
| 171 | 1 #summary XEP-0198: Reliability and fast reconnects for XMPP |
| 2 #labels Stage-Beta | |
| 3 | |
| 4 = Introduction = | |
| 5 | |
| 6 By default XMPP is as reliable as your network is. Unfortunately in some cases that is not very reliable - in some network conditions disconnects can be frequent and message loss can occur. | |
| 7 | |
| 8 To overcome this, XMPP has an optional extension (XEP-0198: Stream Management) which, when supported by both the client and server, can allow a client to resume a disconnected session, and prevent message loss. | |
| 9 | |
| 10 = Details = | |
| 11 | |
| 12 When using XEP-0198 both the client and the server keep a queue of the most recently sent stanzas - this is cleared when the other end acknowledges they have received the stanzas. If the client disconnects, instead of marking the user offline the server pretends the client is still online for a short (configurable) period of time. If the client reconnects within this period, any stanzas in the queue that the client did not receive are re-sent. | |
| 13 | |
| 14 If the client fails to reconnect before the timeout then it is marked offline as normal, and any stanzas in the queue are returned to the sender as a "recipient-unavailable" error. | |
| 15 | |
| 16 = Configuration = | |
| 17 | |
| 18 || *Option* || *Default* || *Description* || | |
| 19 || smacks_hibernation_time || 300 (5 minutes) || The number of seconds a disconnected session should stay alive for (to allow reconnect) || | |
| 20 | |
| 21 = Compatibility = | |
| 22 ||0.8||Works|| | |
| 23 | |
|
172
5bbdbce10b0a
Edited wiki page mod_smacks through web user interface.
MWild1
parents:
171
diff
changeset
|
24 = Clients = |
|
5bbdbce10b0a
Edited wiki page mod_smacks through web user interface.
MWild1
parents:
171
diff
changeset
|
25 Clients that support XEP-0198: |
|
5bbdbce10b0a
Edited wiki page mod_smacks through web user interface.
MWild1
parents:
171
diff
changeset
|
26 * Swift (but not resumption, as of beta9) |
|
5bbdbce10b0a
Edited wiki page mod_smacks through web user interface.
MWild1
parents:
171
diff
changeset
|
27 * Psi (in an unreleased branch) |
|
5bbdbce10b0a
Edited wiki page mod_smacks through web user interface.
MWild1
parents:
171
diff
changeset
|
28 |
| 171 | 29 = TODO = |
| 30 * Doesn't work very well with multiple virtual hosts yet (just a plugin implementation detail). | |
| 31 * Related to the above issue - reload/unload of this module may not work very well. |