doc/lxmppd_core_stanz_dispatch.txt
author Matthew Wild <mwild1@gmail.com>
Wed, 01 May 2013 13:54:44 +0100
branchtls
changeset 5556 7407b1160b46
parent 23 236375777f8c
child 75 338e75cba18d
permissions -rw-r--r--
Close 'tls' branch
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
23
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
     1
lxmppd -> core -> stanza_dispatch
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
     2
	requires	"util.stanza"
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
     3
	requires	"core.usermanager"
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
     4
	
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
     5
function init_stanza_dispatcher(session)
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
     6
	Initialises the stanza dispatcher which handles different stanza according
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
     7
	to their type and XML namespace, dispatching to required handlers.
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
     8
	
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
     9
	iq_handlers["jabber:iq:auth"]
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    10
		A list of handlers for "jabber:iq:auth" stanzas -- authentication
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    11
		(request) stanzas.
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    12
		
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    13
		function (stanza)
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    14
			If one of username, password and resource are missing then it ????.
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    15
			If not, then it validates the credentials and replies with the
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    16
			appropriate stanza.
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    17
			
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    18
	iq_handlers["jabber:iq:roster"]
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    19
		A list of handlers for "jabber:iq:roster" stanzas -- roster management
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    20
		
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    21
		function (stanza)
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    22
			Parses the type of stanza for roster management and does what is
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    23
			requested (roster retrieval, etc.)
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    24
	
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    25
	function (stanza)
236375777f8c Some docs written by Thorns. Need reviewing.
bt@silverblade
parents:
diff changeset
    26
		Validates the stanza and calls the required handler