name mode size
..
doc 040000
Makefile 100644 567B
README 100644 3.78kB
pidf.c 100644 2.59kB
pidf.h 100644 1.4kB
pua_xmpp.c 100644 7.71kB
pua_xmpp.h 100644 1.7kB
request_winfo.c 100644 2.41kB
request_winfo.h 100644 1.04kB
simple2xmpp.c 100644 21.32kB
simple2xmpp.h 100644 1.08kB
xmpp2simple.c 100644 10.96kB
xmpp2simple.h 100644 1.04kB
README
Presence User Agent for XMPP (Presence gateway between SIP and XMPP) Anca-Maria Vamanu Voice Sistem SRL Edited by Anca-Maria Vamanu Copyright © 2007 Voice Sistem SRL __________________________________________________________________ Table of Contents 1. Admin Guide 1. Overview 2. Dependencies 2.1. Kamailio Modules 2.2. External Libraries or Applications 3. Parameters 3.1. server_address(str) 4. Functions 4.1. pua_xmpp_notify() 4.2. pua_xmpp_req_winfo(request_uri, expires) 5. Filtering 2. Developer Guide List of Examples 1.1. Set server_address parameter 1.2. pua_xmpp_notify usage 1.3. xmpp_send_winfo usage Chapter 1. Admin Guide Table of Contents 1. Overview 2. Dependencies 2.1. Kamailio Modules 2.2. External Libraries or Applications 3. Parameters 3.1. server_address(str) 4. Functions 4.1. pua_xmpp_notify() 4.2. pua_xmpp_req_winfo(request_uri, expires) 5. Filtering 1. Overview This module is a gateway for presence between SIP and XMPP. It translates one format into another and uses xmpp, pua and presence modules to manage the transmission of presence state information. 2. Dependencies 2.1. Kamailio Modules 2.2. External Libraries or Applications 2.1. Kamailio Modules The following modules must be loaded before this module: * presence. * pua. * xmpp. 2.2. External Libraries or Applications The following libraries or applications must be installed before running Kamailio with this module loaded: * libxml. 3. Parameters 3.1. server_address(str) 3.1. server_address(str) The SIP URI specifying the address of the SIP server. Example 1.1. Set server_address parameter ... modparam("pua_xmpp", "server_address", "sip:160.23.23.10") ... 4. Functions 4.1. pua_xmpp_notify() 4.2. pua_xmpp_req_winfo(request_uri, expires) Functions exported to be used in configuration file. 4.1. pua_xmpp_notify() Function that handles Notify messages addressed to a user from an xmpp domain. It requires filtering after method and domain in configuration file. If the function is successful, a 2xx reply must be sent. This function can be used from REQUEST_ROUTE. Example 1.2. pua_xmpp_notify usage ... if( is_method("NOTIFY") && uri=~"sip:.+@sip-xmpp.kamailio.org") { if(pua_xmpp_notify()) t_reply("200", "OK"); exit; } ... 4.2. pua_xmpp_req_winfo(request_uri, expires) Function called when a Subscribe addressed to a user from a xmpp domain is received. It calls sending a Subscribe for winfo for the user, and the following Notify with dialog-info is translated into a subscription in xmpp. It also requires filtering in configuration file, after method, domain and event(only for presence). It takes 2 parameters: request_uri and the value of Expires header field in received Subscribe. This function can be used from REQUEST_ROUTE. Example 1.3. xmpp_send_winfo usage ... if( is_method("SUBSCRIBE")) { handle_subscribe(); if(uri=~"sip:.+@sip-xmpp.siphub.ro" && $hdr(Event)== "presence") { pua_xmpp_req_winfo("$ruri", "$hdr(Expires)"); } t_release(); } ... 5. Filtering Instead of "sip-xmpp.siphub.ro" in the example you should use the value set for the xmpp module parameter named 'gateway_domain'. Chapter 2. Developer Guide The module provides no function to be used in other Kamailio modules.