Software / code / prosody
Annotate
doc/stanza_routing.txt @ 12995:e385f3a06673
moduleapi: Add 'peek' to :may() and new :could() helper to suppress logging
The current method logs scary "access denied" messages on failure - this is
generally very useful when debugging access control stuff, but in some cases
the call is simply a check to see if someone *could* perform an action, even
if they haven't requested it yet. One example is determining whether to show
the user as an admin in disco.
The 'peek' parameter, if true, will suppress such logging.
The :could() method is just a simple helper that can make the calling code a
bit more readable (suggested by Zash).
| author | Matthew Wild <mwild1@gmail.com> |
|---|---|
| date | Sun, 26 Mar 2023 14:06:04 +0100 |
| parent | 22:2856dfc1f5cc |
| rev | line source |
|---|---|
| 12 | 1 No 'to' attribute: |
| 2 IQ: Pass to appropriate handler | |
| 3 Presence: Broadcast to contacts | |
| 4 - if initial presence, also send out presence probes | |
| 5 - if probe would be to local user, generate presence stanza for them | |
| 6 Message: Route as if it is addressed to the bare JID of the sender | |
| 7 | |
| 8 To a local host: | |
| 9 IQ: Pass to appropriate handler | |
| 10 Presence: - | |
| 11 Message: Deliver to admin? | |
| 12 | |
| 13 To local contact: | |
| 14 Bare JID: | |
| 15 IQ: Pass to appropriate handler | |
| 16 Presence: Broadcast to all resources | |
| 17 Message: Route to 'best' resource | |
| 18 Full JID: | |
| 19 IQ: Send to resource | |
| 20 Presence: Send to resource | |
| 21 Message: Send to resource | |
| 21 | 22 Full JID but resource not connected: |
| 23 IQ: Return service-unavailable | |
| 24 Message: Handle same as if to bare JID | |
| 25 Presence: Drop (unless type=subscribe[ed]) | |
| 12 | 26 |
| 27 To remote contact: | |
| 28 Initiate s2s connection if necessary | |
| 29 Send stanza across | |
|
22
2856dfc1f5cc
Various documentation updates, and added names.txt :)
Matthew Wild <mwild1@gmail.com>
parents:
21
diff
changeset
|
30 |
