Mercurial > prosody-modules
annotate mod_s2s_smacks_timeout/README.md @ 5787:e79f9dec35c0
mod_c2s_conn_throttle: Reduce log level from error->info
Our general policy is that "error" should never be triggerable by remote
entities, and that it is always about something that requires admin
intervention. This satisfies neither condition.
The "warn" level can be used for unexpected events/behaviour triggered by
remote entities, and this could qualify. However I don't think failed auth
attempts are unexpected enough.
I selected "info" because it is what is also used for other notable session
lifecycle events.
author | Matthew Wild <mwild1@gmail.com> |
---|---|
date | Thu, 07 Dec 2023 15:46:50 +0000 |
parents | 78368d2865dd |
children |
rev | line source |
---|---|
5765
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
1 --- |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
2 labels: |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
3 - Stage-Obsolete |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
4 --- |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
5 |
4981
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
6 # Introduction |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
7 |
5765
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
8 ::: {.alert .alert-warning} |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
9 This behavior has now been merged into |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
10 [mod_s2s][doc:modules:mod_s2s] in trunk and is therefore obsolete |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
11 when used with trunk. |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
12 |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
13 It can still be used with Prosody 0.12 to get this behavior. |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
14 ::: |
78368d2865dd
mod_s2s_smacks_timeout: Add note about being merged in trunk mod_s2s
Kim Alvefur <zash@zash.se>
parents:
4981
diff
changeset
|
15 |
4981
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
16 This module closes s2s connections when |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
17 [mod_smacks][doc:modules:mod_smacks] reports that a connection has not |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
18 received a timely acknowledgement as requested, indicating that the |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
19 connection is broken or the remote server is not responding. |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
20 |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
21 With the connection closed, the next stanza to be directed to that |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
22 server will trigger Prosody to establish a new connection, instead of |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
23 queueing it on the potentially broken connection. |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
24 |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
25 This should prevent messages from being stuck in a queue for a |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
26 potentially long time before being bounced back to the sender as |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
27 delivery failure reports. |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
28 |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
29 Normally the amount of time it takes for a broken connection to time out |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
30 is determined by TCP. |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
31 |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
32 If this is deemed sensible behavior then it will likely be merged into |
f0fe95f9e21c
mod_s2s_smacks_timeout: Use mod_smacks to close stale s2s connections
Kim Alvefur <zash@zash.se>
parents:
diff
changeset
|
33 Prosody itself somewhere. |