doc/stanza_routing.txt
author Kim Alvefur <zash@zash.se>
Sat, 23 Mar 2024 20:48:19 +0100
changeset 13465 c673ff1075bd
parent 22 2856dfc1f5cc
permissions -rw-r--r--
mod_posix: Move everything to util.startup This allows greater control over the order of events. Notably, the internal ordering between daemonization, initialization of libunbound and setup of signal handling is sensitive. libunbound starts a separate thread for processing DNS requests. If this thread is started before signal handling has been set up, it will not inherit the signal handlers and instead behave as it would have before signal handlers were set up, i.e. cause the whole process to immediately exit. libunbound is usually initialized on the first DNS request, usually triggered by an outgoing s2s connection attempt. If daemonization happens before signals have been set up, signals may not be processed at all.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
12
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     1
No 'to' attribute:
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     2
	IQ:			Pass to appropriate handler
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     3
	Presence:		Broadcast to contacts
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     4
				- if initial presence, also send out presence probes
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     5
					- if probe would be to local user, generate presence stanza for them
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     6
	Message:		Route as if it is addressed to the bare JID of the sender
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     7
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     8
To a local host:
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
     9
	IQ:			Pass to appropriate handler
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    10
	Presence:		-
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    11
	Message:		Deliver to admin?
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    12
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    13
To local contact:
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    14
	Bare JID:
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    15
		IQ:		Pass to appropriate handler
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    16
		Presence:	Broadcast to all resources
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    17
		Message:	Route to 'best' resource
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    18
	Full JID:
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    19
		IQ:		Send to resource
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    20
		Presence:	Send to resource
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    21
		Message:	Send to resource
21
ade26639f237 Updated stanza routing doc
Matthew Wild <mwild1@gmail.com>
parents: 12
diff changeset
    22
	Full JID but resource not connected:
ade26639f237 Updated stanza routing doc
Matthew Wild <mwild1@gmail.com>
parents: 12
diff changeset
    23
		IQ:		Return service-unavailable
ade26639f237 Updated stanza routing doc
Matthew Wild <mwild1@gmail.com>
parents: 12
diff changeset
    24
		Message:	Handle same as if to bare JID
ade26639f237 Updated stanza routing doc
Matthew Wild <mwild1@gmail.com>
parents: 12
diff changeset
    25
		Presence:	Drop (unless type=subscribe[ed])
12
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    26
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    27
To remote contact:
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    28
	Initiate s2s connection if necessary
90f22275f7ae Moved server module to net/
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
    29
	Send stanza across
22
2856dfc1f5cc Various documentation updates, and added names.txt :)
Matthew Wild <mwild1@gmail.com>
parents: 21
diff changeset
    30