Mercurial > prosody-modules
comparison mod_smacks/README.markdown @ 1803:4d73a1a6ba68
Convert all wiki pages to Markdown
| author | Kim Alvefur <zash@zash.se> |
|---|---|
| date | Fri, 28 Aug 2015 18:03:58 +0200 |
| parents | mod_smacks/README.wiki@29f3d6b7ad16 |
| children | 9c9397d692aa |
comparison
equal
deleted
inserted
replaced
| 1802:0ab737feada6 | 1803:4d73a1a6ba68 |
|---|---|
| 1 --- | |
| 2 labels: | |
| 3 - 'Stage-Beta' | |
| 4 summary: 'XEP-0198: Reliability and fast reconnects for XMPP' | |
| 5 ... | |
| 6 | |
| 7 Introduction | |
| 8 ============ | |
| 9 | |
| 10 By default XMPP is as reliable as your network is. Unfortunately in some | |
| 11 cases that is not very reliable - in some network conditions disconnects | |
| 12 can be frequent and message loss can occur. | |
| 13 | |
| 14 To overcome this, XMPP has an optional extension (XEP-0198: Stream | |
| 15 Management) which, when supported by both the client and server, can | |
| 16 allow a client to resume a disconnected session, and prevent message | |
| 17 loss. | |
| 18 | |
| 19 Details | |
| 20 ======= | |
| 21 | |
| 22 When using XEP-0198 both the client and the server keep a queue of the | |
| 23 most recently sent stanzas - this is cleared when the other end | |
| 24 acknowledges they have received the stanzas. If the client disconnects, | |
| 25 instead of marking the user offline the server pretends the client is | |
| 26 still online for a short (configurable) period of time. If the client | |
| 27 reconnects within this period, any stanzas in the queue that the client | |
| 28 did not receive are re-sent. | |
| 29 | |
| 30 If the client fails to reconnect before the timeout then it is marked | |
| 31 offline as normal, and any stanzas in the queue are returned to the | |
| 32 sender as a "recipient-unavailable" error. | |
| 33 | |
| 34 Configuration | |
| 35 ============= | |
| 36 | |
| 37 Option Default Description | |
| 38 --------------------------- ----------------- ----------------------------------------------------------------------------------------- | |
| 39 smacks\_hibernation\_time 300 (5 minutes) The number of seconds a disconnected session should stay alive for (to allow reconnect) | |
| 40 | |
| 41 Compatibility | |
| 42 ============= | |
| 43 | |
| 44 ----- -------------------------------------------------------------------------------------------------------------------------------------------------------- | |
| 45 0.9 Works | |
| 46 0.8 Works, use version [7693724881b3](http://prosody-modules.googlecode.com/hg-history/7693724881b3f3cdafa35763f00dd040d02313bf/mod_smacks/mod_smacks.lua) | |
| 47 ----- -------------------------------------------------------------------------------------------------------------------------------------------------------- | |
| 48 | |
| 49 Clients | |
| 50 ======= | |
| 51 | |
| 52 Clients that support XEP-0198: | |
| 53 | |
| 54 - Gajim | |
| 55 - Swift (but not resumption, as of version 2.0 and alphas of 3.0) | |
| 56 - Psi (in an unreleased branch) | |
| 57 - Yaxim |