annotate mod_smacks.wiki @ 378:3f73ea0fef1c

mod_s2s_auth_dnssec_srv: Google code wiki blah can't have links spanning multiple lines? Pfft!
author Kim Alvefur <zash@zash.se>
date Sat, 29 Jun 2013 22:36:20 +0200
parents 36f475bd6425
children 2ad6225d937f
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
171
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
1 #summary XEP-0198: Reliability and fast reconnects for XMPP
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
2 #labels Stage-Beta
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
3
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
4 = Introduction =
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
5
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
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.
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
7
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
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.
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
9
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
10 = Details =
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
11
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
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.
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
13
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
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.
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
15
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
16 = Configuration =
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
17
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
18 || *Option* || *Default* || *Description* ||
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
19 || smacks_hibernation_time || 300 (5 minutes) || The number of seconds a disconnected session should stay alive for (to allow reconnect) ||
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
20
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
21 = Compatibility =
267
36f475bd6425 Edited wiki page mod_smacks through web user interface.
MWild1@gmail.com
parents: 172
diff changeset
22 ||0.9||Works||
36f475bd6425 Edited wiki page mod_smacks through web user interface.
MWild1@gmail.com
parents: 172
diff changeset
23 ||0.8||Works, use version [http://prosody-modules.googlecode.com/hg-history/7693724881b3f3cdafa35763f00dd040d02313bf/mod_smacks/mod_smacks.lua 7693724881b3]||
171
c9bd647b287d Created wiki page through web user interface.
MWild1
parents:
diff changeset
24
172
5bbdbce10b0a Edited wiki page mod_smacks through web user interface.
MWild1
parents: 171
diff changeset
25 = Clients =
5bbdbce10b0a Edited wiki page mod_smacks through web user interface.
MWild1
parents: 171
diff changeset
26 Clients that support XEP-0198:
267
36f475bd6425 Edited wiki page mod_smacks through web user interface.
MWild1@gmail.com
parents: 172
diff changeset
27 * Gajim
172
5bbdbce10b0a Edited wiki page mod_smacks through web user interface.
MWild1
parents: 171
diff changeset
28 * Swift (but not resumption, as of beta9)
267
36f475bd6425 Edited wiki page mod_smacks through web user interface.
MWild1@gmail.com
parents: 172
diff changeset
29 * Psi (in an unreleased branch)