Software /
code /
prosody-modules
Annotate
mod_block_outgoing/README.markdown @ 4976:75b6e5df65f9
various: Improve error reporting if missing file server module on 0.12
If there is some error loading net.http.files then it would be swallowed
by the pcall and then it would proceed to trying mod_http_files, which
might cause unexpected behavior on 0.12
Ref #1765
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Mon, 18 Jul 2022 22:47:54 +0200 |
parent | 2400:bd3a1df128a4 |
child | 5007:34fb3d239ac1 |
rev | line source |
---|---|
2400
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
1 --- |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
2 summary: 'Block outgoing stanzas from users' |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
3 ... |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
4 |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
5 Introduction |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
6 ============ |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
7 |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
8 This module blocks all outgoing stanzas from a list of users. |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
9 |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
10 Using |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
11 ===== |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
12 |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
13 Add mod_block_outgoing to the enabled modules in your config file: |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
14 ``` {.lua} |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
15 modules_enabled = { |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
16 -- ... |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
17 "block_outgoing", |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
18 -- ... |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
19 } |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
20 ``` |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
21 |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
22 Either in a section for a certain host or the global section define which users and what stanzas to block: |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
23 ``` {.lua} |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
24 block_outgoing_users = { "romeo@example.com", "juliet@example.com" } |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
25 block_outgoing_stanzas = { "message", "iq", "presence" } |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
26 ``` |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
27 |
bd3a1df128a4
Add documentation for mod_block_outgoing
Michael Vetter <jubalh@openmailbox.org>
parents:
diff
changeset
|
28 block_outgoing_stanzas defaults to "message" if not specified. |