sr-dev March 2011

sr-dev@lists.kamailio.org

25 participants
194 discussions

git:master: sdpops: documented sdp_print(...) and sdp_with_media(...)
by Daniel-Constantin Mierla 13 Mar '11

13 Mar '11

Module: sip-router Branch: master Commit: 501df6bd29bb1c22c53de8bd772eb4c641ad0d6f URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=501df6b… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Sun Mar 13 23:18:02 2011 +0100 sdpops: documented sdp_print(...) and sdp_with_media(...) --- modules/sdpops/README | 40 +++++++++++++++++++++++++++ modules/sdpops/doc/sdpops_admin.xml | 52 ++++++++++++++++++++++++++++++++++- 2 files changed, 91 insertions(+), 1 deletions(-) diff --git a/modules/sdpops/README b/modules/sdpops/README index 50630f7..10d72ce 100644 --- a/modules/sdpops/README +++ b/modules/sdpops/README @@ -27,10 +27,14 @@ Daniel-Constantin Mierla 4. Exported Functions 4.1. sdp_remove_codecs_by_id(list) + 4.2. sdp_with_media(type) + 4.3. sdp_print(level) List of Examples 1.1. sdp_remove_codecs_by_id usage + 1.2. sdp_with_media usage + 1.3. sdp_print usage Chapter 1. Admin Guide @@ -46,6 +50,8 @@ Chapter 1. Admin Guide 4. Exported Functions 4.1. sdp_remove_codecs_by_id(list) + 4.2. sdp_with_media(type) + 4.3. sdp_print(level) 1. Overview @@ -80,6 +86,8 @@ Chapter 1. Admin Guide 4. Exported Functions 4.1. sdp_remove_codecs_by_id(list) + 4.2. sdp_with_media(type) + 4.3. sdp_print(level) 4.1. sdp_remove_codecs_by_id(list) @@ -88,6 +96,8 @@ Chapter 1. Admin Guide comma separated list of numeric codec IDs. The parameter can be a static string or a variable holding the list of numeric codec IDs. + This function can be used from ANY_ROUTE. + Example 1.1. sdp_remove_codecs_by_id usage ... # remove PCMU @@ -95,3 +105,33 @@ sdp_remove_codecs_by_id("0"); # remove PCMU, PCMA and GSM sdp_remove_codecs_by_id("0,8,3"); ... + +4.2. sdp_with_media(type) + + Return true of the SDP has 'media=type ...' line. Useful to check the + content of the RTP sessions, such as 'audio' or 'video'. The parameter + can be static string or variable holding the media type. + + This function can be used from ANY_ROUTE. + + Example 1.2. sdp_with_media usage +... +# check for video stream +if(sdp_with_media("video")) +{ + # the session has a video stream +} +... + +4.3. sdp_print(level) + + Print the SDP internal structure to log 'level'. The parameter can be + static integer or variable holding the integer value of the log level. + + This function can be used from ANY_ROUTE. + + Example 1.3. sdp_print usage +... +# print the SDP +sdp_print("1"); +... diff --git a/modules/sdpops/doc/sdpops_admin.xml b/modules/sdpops/doc/sdpops_admin.xml index 4981c07..bbb4738 100644 --- a/modules/sdpops/doc/sdpops_admin.xml +++ b/modules/sdpops/doc/sdpops_admin.xml @@ -67,7 +67,7 @@ <section> <title>Exported Functions</title> - <section> + <section> <title> <function moreinfo="none">sdp_remove_codecs_by_id(list)</function> </title> @@ -78,6 +78,9 @@ parameter can be a static string or a variable holding the list of numeric codec IDs. </para> + <para> + This function can be used from ANY_ROUTE. + </para> <example> <title><function>sdp_remove_codecs_by_id</function> usage</title> <programlisting format="linespecific"> @@ -90,6 +93,53 @@ sdp_remove_codecs_by_id("0,8,3"); </programlisting> </example> </section> + <section> + <title> + <function moreinfo="none">sdp_with_media(type)</function> + </title> + <para> + Return true of the SDP has 'media=type ...' line. Useful to check + the content of the RTP sessions, such as 'audio' or 'video'. The + parameter can be static string or variable holding the media type. + </para> + <para> + This function can be used from ANY_ROUTE. + </para> + <example> + <title><function>sdp_with_media</function> usage</title> + <programlisting format="linespecific"> +... +# check for video stream +if(sdp_with_media("video")) +{ + # the session has a video stream +} +... +</programlisting> + </example> + </section> + <section> + <title> + <function moreinfo="none">sdp_print(level)</function> + </title> + <para> + Print the SDP internal structure to log 'level'. The + parameter can be static integer or variable holding the integer + value of the log level. + </para> + <para> + This function can be used from ANY_ROUTE. + </para> + <example> + <title><function>sdp_print</function> usage</title> + <programlisting format="linespecific"> +... +# print the SDP +sdp_print("1"); +... +</programlisting> + </example> + </section> </section> </chapter>

1 0

git:master: core: accept signed int for fixup FPARAM_INT
by Daniel-Constantin Mierla 13 Mar '11

13 Mar '11

Module: sip-router Branch: master Commit: 67436c8fd301c1b59d0f58ff0f09c4f227865a5a URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=67436c8… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Sun Mar 13 23:03:37 2011 +0100 core: accept signed int for fixup FPARAM_INT --- sr_module.c | 4 ++-- 1 files changed, 2 insertions(+), 2 deletions(-) diff --git a/sr_module.c b/sr_module.c index f975062..1970395 100644 --- a/sr_module.c +++ b/sr_module.c @@ -1038,7 +1038,7 @@ int fix_param(int type, void** param) { fparam_t* p; str name, s; - unsigned int num; + int num; int err; p = (fparam_t*)pkg_malloc(sizeof(fparam_t)); @@ -1064,7 +1064,7 @@ int fix_param(int type, void** param) case FPARAM_INT: s.s = (char*)*param; s.len = strlen(s.s); - err = str2int(&s, &num); + err = str2sint(&s, &num); if (err == 0) { p->v.i = (int)num; } else {

1 0

git:master: sqlops: adding missing ending tags to docbook
by Daniel-Constantin Mierla 13 Mar '11

13 Mar '11

Module: sip-router Branch: master Commit: a4daa0d11e758dc7e72673a2e670338d19591ee8 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=a4daa0d… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Sun Mar 13 22:19:12 2011 +0100 sqlops: adding missing ending tags to docbook - replaced list of routing blocks with ANY_ROUTE --- modules_k/sqlops/README | 71 +++++++++++++++++++++++++++------ modules_k/sqlops/doc/sqlops_admin.xml | 17 ++++---- 2 files changed, 67 insertions(+), 21 deletions(-) diff --git a/modules_k/sqlops/README b/modules_k/sqlops/README index 902f709..5656715 100644 --- a/modules_k/sqlops/README +++ b/modules_k/sqlops/README @@ -32,7 +32,8 @@ Daniel-Constantin Mierla 4. Exported Functions 4.1. sql_query(connection, query, result) - 4.2. sql_result_free(result) + 4.2. sql_xquery(connection, query, result) + 4.3. sql_result_free(result) 5. Exported pseudo-variables @@ -43,8 +44,9 @@ Daniel-Constantin Mierla 1.1. Set sqlcon parameter 1.2. Set sqlres parameter 1.3. sql_query() usage - 1.4. sql_result_free() usage - 1.5. $dbr(result=>key) usage + 1.4. sql_xquery() usage + 1.5. sql_result_free() usage + 1.6. $dbr(result=>key) usage Chapter 1. Admin Guide @@ -64,7 +66,8 @@ Chapter 1. Admin Guide 4. Exported Functions 4.1. sql_query(connection, query, result) - 4.2. sql_result_free(result) + 4.2. sql_xquery(connection, query, result) + 4.3. sql_result_free(result) 5. Exported pseudo-variables @@ -91,6 +94,10 @@ Chapter 1. Admin Guide [row,column]. * persistence in process space - a result can be used many times in the same worker process. Query once, use many times. + * alternatively, results can be stored in xavps - columns are + accessed by their names, rows by xavp index. Xavp's are available + during the transactions lifetime and don't need to be destroyed + manually. 2. Dependencies @@ -153,7 +160,8 @@ modparam("sqlops", "sqlres", "ra") 4. Exported Functions 4.1. sql_query(connection, query, result) - 4.2. sql_result_free(result) + 4.2. sql_xquery(connection, query, result) + 4.3. sql_result_free(result) 4.1. sql_query(connection, query, result) @@ -164,8 +172,7 @@ modparam("sqlops", "sqlres", "ra") * result - string name to identify the result. Will be used by $dbr(...) pseudo-variable to access result attributes. - This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, - ONREPLY_ROUTE, BRANCH_ROUTE. + This function can be used from ANY_ROUTE. Example 1.3. sql_query() usage ... @@ -176,14 +183,32 @@ xlog("number of rows in table domain: $dbr(ra=>rows)\n"); sql_result_free("ra"); ... -4.2. sql_result_free(result) +4.2. sql_xquery(connection, query, result) + + Make a SQL query using 'connection' and store data in 'result' xavp. + * connection - the name of the connection to be used for query + (defined via the “sqlcon” parameter). + * query - SQL query string or pseudo-variables containing SQL query. + * result - string name to identify the result xavp. Each row will be + added to this xavp, each column can be accessed by its name. + + This function can be used from ANY_ROUTE. + + Example 1.4. sql_xquery() usage +... +modparam("sqlops","sqlcon","ca=>dbdriver://username:password@dbhost/dbname") +... +sql_xquery("ca", "select * from domain", "ra"); + xlog("first domain: $xavp(ra=>domain) with id: $xavp(ra=>domain_id)\n"); +... + +4.3. sql_result_free(result) Free data in SQL 'result'. - This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, - ONREPLY_ROUTE, BRANCH_ROUTE. + This function can be used from ANY_ROUTE. - Example 1.4. sql_result_free() usage + Example 1.5. sql_result_free() usage ... modparam("sqlops","sqlcon","ca=>dbdriver://username:password@dbhost/dbname") ... @@ -212,7 +237,7 @@ sql_result_free("ra"); integer. * colname[N] - return the name of the N-th column in the result set. - Example 1.5. $dbr(result=>key) usage + Example 1.6. $dbr(result=>key) usage ... modparam("sqlops","sqlcon","ca=>dbdriver://username:password@dbhost/dbname") ... @@ -240,3 +265,25 @@ if($dbr(ra=>rows)>0) } sql_result_free("ra"); ... + + +... +if (sql_xquery("ca", "select * from domain", "ra") == 1) +{ +# non-destructive iteration + $var(i) = 0; + while($xavp(ra[$var(i)]) != $null) + { + xlog("[id, domain] = [$xavp(ra[$var(i)]=>id), $xavp(ra[$var(i)]=>domain) +]\n"); + $var(i) = $var(i) + 1; + } + +# destructive iteration + while($xavp(ra) != $null) + { + xlog("[id, domain] = [$xavp(ra=>id), $xavp(ra=>domain)]\n"); + pv_unset("$xavp(ra)"); + } +} +... diff --git a/modules_k/sqlops/doc/sqlops_admin.xml b/modules_k/sqlops/doc/sqlops_admin.xml index 57ac3ab..d042c61 100644 --- a/modules_k/sqlops/doc/sqlops_admin.xml +++ b/modules_k/sqlops/doc/sqlops_admin.xml @@ -62,9 +62,10 @@ </listitem> <listitem> <para> - <emphasis>alternatively, results can be stored in xavps. Columns are - accessed by their names, rows by xavp index. Xavp's are available - during the transactions lifetime and don't need to be destroyed manually. + <emphasis>alternatively, results can be stored in xavps</emphasis> + - columns are accessed by their names, rows by xavp index. Xavp's + are available during the transactions lifetime and don't need to + be destroyed manually. </para> </listitem> @@ -204,8 +205,7 @@ modparam("sqlops", "sqlres", "ra") </listitem> </itemizedlist> <para> - This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, - ONREPLY_ROUTE, BRANCH_ROUTE. + This function can be used from ANY_ROUTE. </para> <example> <title><function>sql_query()</function> usage</title> @@ -220,6 +220,7 @@ sql_result_free("ra"); </programlisting> </example> </section> + <section> <title> <function moreinfo="none">sql_xquery(connection, query, result)</function> </title> @@ -247,8 +248,7 @@ sql_result_free("ra"); </listitem> </itemizedlist> <para> - This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, - ONREPLY_ROUTE, BRANCH_ROUTE. + This function can be used from ANY_ROUTE. </para> <example> <title><function>sql_xquery()</function> usage</title> @@ -270,8 +270,7 @@ sql_xquery("ca", "select * from domain", "ra"); Free data in SQL 'result'. </para> <para> - This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, - ONREPLY_ROUTE, BRANCH_ROUTE. + This function can be used from ANY_ROUTE. </para> <example> <title><function>sql_result_free()</function> usage</title>

1 0

Kamailio distributed message queue
by Bucur Marius 13 Mar '11

13 Mar '11

Hello, At Daniel's suggestion, I am planning to work on a distributed message queue system for Kamailio for my BCS thesis. The idea is having a way of communicating between different Kamailio instances for user presence states, user location information, etc. The plan is to use SIP for transport, and to have efficient ways of adding/deleting a node from the message queue bus. Any suggestions/opinions are very welcomed. Cheers, Marius

3 2

git:master: sdpops: new module for SDP operations
by Daniel-Constantin Mierla 13 Mar '11

13 Mar '11

Module: sip-router Branch: master Commit: f772c256238596f3df1755cf31b31606c33ee064 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=f772c25… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Sun Mar 13 10:20:20 2011 +0100 sdpops: new module for SDP operations - the module is intended to export functions that will allow easier management of SDP from configuration file - first function: spd_remove_codecs_by_id(list) - remove the codecs by their numeric IDs given in a comma separated list as paramter - codecs attributes are not removed yet --- modules/sdpops/Makefile | 14 +++ modules/sdpops/sdpops_mod.c | 257 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 271 insertions(+), 0 deletions(-) diff --git a/modules/sdpops/Makefile b/modules/sdpops/Makefile new file mode 100644 index 0000000..2ade2d9 --- /dev/null +++ b/modules/sdpops/Makefile @@ -0,0 +1,14 @@ +# $Id$ +# +# +# WARNING: do not run this directly, it should be run by the master Makefile + +include ../../Makefile.defs +auto_gen= +NAME=sdpops.so +DEFS += +LIBS += + +DEFS+=-DOPENSER_MOD_INTERFACE + +include ../../Makefile.modules diff --git a/modules/sdpops/sdpops_mod.c b/modules/sdpops/sdpops_mod.c new file mode 100644 index 0000000..bc118ca --- /dev/null +++ b/modules/sdpops/sdpops_mod.c @@ -0,0 +1,257 @@ +/* + * $Id$ + * + * Copyright (C) 2011 Daniel-Constantin Mierla (asipto.com) + * + * This file is part of Kamailio, a free SIP server. + * + * Kamailio is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version + * + * Kamailio is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * + */ + + +#include <string.h> +#include <stdlib.h> +#include <stdio.h> + +#include "../../sr_module.h" +#include "../../dprint.h" +#include "../../mod_fix.h" +#include "../../pvar.h" +#include "../../trim.h" +#include "../../parser/sdp/sdp.h" +#include "../../data_lump.h" + + +MODULE_VERSION + +static int w_sdp_remove_codecs_by_id(sip_msg_t* msg, char* codecs, char *bar); +static int fixup_sdp_remove_codecs_by_id(void** param, int param_no); + +static int mod_init(void); + +static cmd_export_t cmds[] = { + {"sdp_remove_codecs_by_id", (cmd_function)w_sdp_remove_codecs_by_id, + 1, fixup_sdp_remove_codecs_by_id, 0, ANY_ROUTE}, + {0, 0, 0, 0, 0} +}; + +static pv_export_t mod_pvs[] = { +#if 0 + {{"sdp", (sizeof("sdp")-1)}, /* */ + PVT_OTHER, pv_get_sdp, 0, + 0, 0, 0, 0}, +#endif + + { {0, 0}, 0, 0, 0, 0, 0, 0, 0 } +}; + +static param_export_t params[] = { + {0, 0, 0} +}; + +/** module exports */ +struct module_exports exports= { + "sdpops", + DEFAULT_DLFLAGS, /* dlopen flags */ + cmds, + params, + 0, /* exported statistics */ + 0 , /* exported MI functions */ + mod_pvs, /* exported pseudo-variables */ + 0, /* extra processes */ + mod_init, /* module initialization function */ + 0, + 0, + 0 /* per-child init function */ +}; + +/** + * + */ +static int mod_init(void) +{ + LM_DBG("sdpops module loaded\n"); + return 0; +} + + +/** + * + */ +int str_find_token(str *text, str *result, char delim) +{ + int i; + if(text==NULL || result==NULL) + return -1; + if(text->s[0] == delim) + { + text->s += 1; + text->len -= 1; + } + trim_leading(text); + result->s = text->s; + result->len = 0; + for (i=0; i<text->len; i++) + { + if(result->s[i]==delim || result->s[i]=='\0' + || result->s[i]=='\r' || result->s[i]=='\n') + return 0; + result->len++; + } + return 0; +} + + +int sdp_remove_str_codec_id(sip_msg_t* msg, str *allcodecs, str* rmcodec) +{ + int i; + int cmp; + struct lump *anchor; + + if(msg==NULL || allcodecs==NULL || rmcodec==NULL + || allcodecs->len<=0 || rmcodec->len<=0) + return -1; + + cmp = 1; + for(i=0; i<allcodecs->len; i++) { + if(cmp==1) { + if(rmcodec->len <= allcodecs->len-i) { + if(strncmp(&allcodecs->s[i], rmcodec->s, rmcodec->len)==0) { + if(&allcodecs->s[i+rmcodec->len] + == &allcodecs->s[allcodecs->len] + || allcodecs->s[i+rmcodec->len] == ' ') { + /* match - remove also the space before codec id */ + LM_DBG("found codec [%.*s] inside [%.*s]\n", + rmcodec->len, rmcodec->s, + allcodecs->len, allcodecs->s); + anchor = del_lump(msg, &allcodecs->s[i-1] - msg->buf, + rmcodec->len+1, 0); + if (anchor == NULL) { + LM_ERR("failed to remove [%.*s] inside [%.*s]\n", + rmcodec->len, rmcodec->s, + allcodecs->len, allcodecs->s); + return -1; + } + return 0; + } + } + } + } + if(allcodecs->s[i]==' ') + cmp = 1; + else + cmp = 0; + } + + return 0; +} + +/** + * + */ +int sdp_remove_codecs_by_id(sip_msg_t* msg, str* codecs) +{ + sdp_info_t *sdp = NULL; + int sdp_session_num; + int sdp_stream_num; + sdp_session_cell_t* sdp_session; + sdp_stream_cell_t* sdp_stream; + str sdp_codecs; + str tmp_codecs; + str rm_codec; + + if(parse_sdp(msg) < 0) { + LM_ERR("Unable to parse sdp\n"); + return -1; + } + + LM_ERR("attempting to remove codecs from sdp: [%.*s]\n", + codecs->len, codecs->s); + + sdp = (sdp_info_t*)msg->body; + + print_sdp(sdp, L_DBG); + + sdp_session_num = 0; + for(;;) + { + sdp_session = get_sdp_session(msg, sdp_session_num); + if(!sdp_session) break; + sdp_stream_num = 0; + for(;;) + { + sdp_stream = get_sdp_stream(msg, sdp_session_num, sdp_stream_num); + if(!sdp_stream) break; + + LM_DBG("stream %d of %d - payloads [%.*s]\n", + sdp_stream_num, sdp_session_num, + sdp_stream->payloads.len, sdp_stream->payloads.s); + sdp_codecs = sdp_stream->payloads; + tmp_codecs = *codecs; + while(str_find_token(&tmp_codecs, &rm_codec, ',')==0 + && rm_codec.len>0) + { + tmp_codecs.len -=(int)(&rm_codec.s[rm_codec.len]-tmp_codecs.s); + tmp_codecs.s = rm_codec.s + rm_codec.len; + + LM_DBG("codecs [%.*s] - remove [%.*s]\n", + sdp_codecs.len, sdp_codecs.s, + rm_codec.len, rm_codec.s); + sdp_remove_str_codec_id(msg, &sdp_codecs, &rm_codec); + } + sdp_stream_num++; + } + sdp_session_num++; + } + + return 0; +} + +/** + * + */ +static int w_sdp_remove_codecs_by_id(sip_msg_t* msg, char* codecs, char* bar) +{ + str lcodecs = {0, 0}; + + if(codecs==0) + { + LM_ERR("invalid parameters\n"); + return -1; + } + + if(fixup_get_svalue(msg, (gparam_p)codecs, &lcodecs)!=0) + { + LM_ERR("unable to get the list of codecs\n"); + return -1; + } + + if(sdp_remove_codecs_by_id(msg, &lcodecs)<0) + return -1; + return 1; +} + + +/** + * + */ +static int fixup_sdp_remove_codecs_by_id(void** param, int param_no) +{ + if (param_no == 1) { + return fixup_spve_null(param, 1); + } + return 0; +}

1 0

git:master: sdpops: added module documentation
by Daniel-Constantin Mierla 13 Mar '11

13 Mar '11

Module: sip-router Branch: master Commit: d0e8c06af3a119b4ea5ba6c1881b23b3f9113c0d URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=d0e8c06… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Sun Mar 13 10:51:01 2011 +0100 sdpops: added module documentation --- modules/sdpops/README | 97 +++++++++++++++++++++++++++++++++++ modules/sdpops/doc/Makefile | 4 ++ modules/sdpops/doc/sdpops.xml | 37 +++++++++++++ modules/sdpops/doc/sdpops_admin.xml | 95 ++++++++++++++++++++++++++++++++++ 4 files changed, 233 insertions(+), 0 deletions(-) diff --git a/modules/sdpops/README b/modules/sdpops/README new file mode 100644 index 0000000..50630f7 --- /dev/null +++ b/modules/sdpops/README @@ -0,0 +1,97 @@ +SDPOPS Module + +Daniel-Constantin Mierla + + <miconda(a)gmail.com> + +Edited by + +Daniel-Constantin Mierla + + <miconda(a)gmail.com> + + Copyright © 2011 asipto.com + __________________________________________________________________ + + Table of Contents + + 1. Admin Guide + + 1. Overview + 2. Dependencies + + 2.1. Kamailio Modules + 2.2. External Libraries or Applications + + 3. Exported Parameters + 4. Exported Functions + + 4.1. sdp_remove_codecs_by_id(list) + + List of Examples + + 1.1. sdp_remove_codecs_by_id usage + +Chapter 1. Admin Guide + + Table of Contents + + 1. Overview + 2. Dependencies + + 2.1. Kamailio Modules + 2.2. External Libraries or Applications + + 3. Exported Parameters + 4. Exported Functions + + 4.1. sdp_remove_codecs_by_id(list) + +1. Overview + + This module provides function for checking and managing the SDP + payloads of SIP messages. + + Examples of what this module offers: remove codecs from SDP, check the + media stream types, return attributes of SDP document. For the full + least of the features provided by this module and the implementation + state, read further to the list of exported functions. + +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: + * none. + +2.2. External Libraries or Applications + + The following libraries or applications must be installed before + running Kamailio with this module loaded: + * None + +3. Exported Parameters + + The module does not export any config parameter yet. + +4. Exported Functions + + 4.1. sdp_remove_codecs_by_id(list) + +4.1. sdp_remove_codecs_by_id(list) + + Remove the codecs provided in the parameter 'list' from all media + streams found in SDP payload. The parameter 'list' must be one or a + comma separated list of numeric codec IDs. The parameter can be a + static string or a variable holding the list of numeric codec IDs. + + Example 1.1. sdp_remove_codecs_by_id usage +... +# remove PCMU +sdp_remove_codecs_by_id("0"); +# remove PCMU, PCMA and GSM +sdp_remove_codecs_by_id("0,8,3"); +... diff --git a/modules/sdpops/doc/Makefile b/modules/sdpops/doc/Makefile new file mode 100644 index 0000000..6fae5ba --- /dev/null +++ b/modules/sdpops/doc/Makefile @@ -0,0 +1,4 @@ +docs = sdpops.xml + +docbook_dir = ../../../docbook +include $(docbook_dir)/Makefile.module diff --git a/modules/sdpops/doc/sdpops.xml b/modules/sdpops/doc/sdpops.xml new file mode 100644 index 0000000..33771e5 --- /dev/null +++ b/modules/sdpops/doc/sdpops.xml @@ -0,0 +1,37 @@ +<?xml version="1.0" encoding='ISO-8859-1'?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" +"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ + + +<!ENTITY % docentities SYSTEM "../../../docbook/entities.xml"> +%docentities; + +]> + +<book xmlns:xi="http://www.w3.org/2001/XInclude"> + <bookinfo> + <title>SDPOPS Module</title> + <productname class="trade">sip-router.org</productname> + <authorgroup> + <author> + <firstname>Daniel-Constantin</firstname> + <surname>Mierla</surname> + <email>miconda(a)gmail.com</email> + </author> + <editor> + <firstname>Daniel-Constantin</firstname> + <surname>Mierla</surname> + <email>miconda(a)gmail.com</email> + </editor> + </authorgroup> + <copyright> + <year>2011</year> + <holder>asipto.com</holder> + </copyright> + </bookinfo> + <toc></toc> + + <xi:include href="sdpops_admin.xml"/> + + +</book> diff --git a/modules/sdpops/doc/sdpops_admin.xml b/modules/sdpops/doc/sdpops_admin.xml new file mode 100644 index 0000000..4981c07 --- /dev/null +++ b/modules/sdpops/doc/sdpops_admin.xml @@ -0,0 +1,95 @@ +<?xml version="1.0" encoding='ISO-8859-1'?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" +"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ + + +<!ENTITY % docentities SYSTEM "../../../docbook/entities.xml"> +%docentities; + +]> + + +<chapter> + + <title>&adminguide;</title> + + <section> + <title>Overview</title> + <para> + This module provides function for checking and managing the SDP + payloads of SIP messages. + </para> + <para> + Examples of what this module offers: remove codecs from SDP, + check the media stream types, return attributes of SDP document. + For the full least of the features provided by this module and + the implementation state, read further to the list of exported + functions. + </para> + </section> + + <section> + <title>Dependencies</title> + <section> + <title>&kamailio; Modules</title> + <para> + The following modules must be loaded before this module: + <itemizedlist> + <listitem> + <para> + <emphasis>none</emphasis>. + </para> + </listitem> + </itemizedlist> + </para> + </section> + <section> + <title>External Libraries or Applications</title> + <para> + The following libraries or applications must be installed before running + &kamailio; with this module loaded: + <itemizedlist> + <listitem> + <para> + <emphasis>None</emphasis> + </para> + </listitem> + </itemizedlist> + </para> + </section> + </section> + <section> + <title>Exported Parameters</title> + <para> + The module does not export any config parameter yet. + </para> + </section> + + <section> + <title>Exported Functions</title> + <section> + <title> + <function moreinfo="none">sdp_remove_codecs_by_id(list)</function> + </title> + <para> + Remove the codecs provided in the parameter 'list' from all + media streams found in SDP payload. The parameter 'list' must + be one or a comma separated list of numeric codec IDs. The + parameter can be a static string or a variable holding the + list of numeric codec IDs. + </para> + <example> + <title><function>sdp_remove_codecs_by_id</function> usage</title> + <programlisting format="linespecific"> +... +# remove PCMU +sdp_remove_codecs_by_id("0"); +# remove PCMU, PCMA and GSM +sdp_remove_codecs_by_id("0,8,3"); +... +</programlisting> + </example> + </section> + </section> +</chapter> +

1 0

git:master: tmx: restored t_flush_flags()
by Daniel-Constantin Mierla 12 Mar '11

12 Mar '11

Module: sip-router Branch: master Commit: 83620cb7cd14ee3b509eef72d99337567f53967f URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=83620cb… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Sat Mar 12 12:22:51 2011 +0100 tmx: restored t_flush_flags() - function to sycn the msg flags back to transaction when the transaction was created before modifying the flags - reported by Juha Heinanen --- modules_k/tmx/tmx_mod.c | 21 +++++++++++++++++++++ 1 files changed, 21 insertions(+), 0 deletions(-) diff --git a/modules_k/tmx/tmx_mod.c b/modules_k/tmx/tmx_mod.c index 6e6f758..1da7fd3 100644 --- a/modules_k/tmx/tmx_mod.c +++ b/modules_k/tmx/tmx_mod.c @@ -53,6 +53,8 @@ static int t_reply_callid(struct sip_msg* msg, char *cid, char *cseq, char *rc, char *rs); static int fixup_reply_callid(void** param, int param_no); +static int t_flush_flags(struct sip_msg* msg, char*, char* ); + /* statistic variables */ stat_var *tm_rcv_rpls; stat_var *tm_rld_rpls; @@ -135,6 +137,8 @@ static cmd_export_t cmds[]={ fixup_cancel_callid, 0, ANY_ROUTE }, {"t_reply_callid", (cmd_function)t_reply_callid, 4, fixup_reply_callid, 0, ANY_ROUTE }, + {"t_flush_flags", (cmd_function)t_flush_flags, 0, 0, + 0, ANY_ROUTE }, {0,0,0,0,0,0} }; @@ -398,6 +402,23 @@ static int t_reply_callid(struct sip_msg* msg, char *cid, char *cseq, return -1; } +/** + * + */ +static int t_flush_flags(struct sip_msg* msg, char *foo, char *bar) +{ + struct cell *t; + + t=_tmx_tmb.t_gett(); + if ( t==0 || t==T_UNDEFINED) { + LM_ERR("failed to flush flags - no transaction found\n"); + return -1; + } + + t->uas.request->flags = msg->flags; + return 1; +} + #ifdef STATISTICS /*** tm stats ***/

1 0

git:master: tmx: added the docs for t_flush_flags()
by Daniel-Constantin Mierla 12 Mar '11

12 Mar '11

Module: sip-router Branch: master Commit: ce7aa8e46e839a56d5759a688d03515f94497267 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=ce7aa8e… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Sat Mar 12 12:27:52 2011 +0100 tmx: added the docs for t_flush_flags() --- modules_k/tmx/README | 17 +++++++++++++++++ modules_k/tmx/doc/tmx_admin.xml | 21 +++++++++++++++++++++ 2 files changed, 38 insertions(+), 0 deletions(-) diff --git a/modules_k/tmx/README b/modules_k/tmx/README index 6b3f050..7f62959 100644 --- a/modules_k/tmx/README +++ b/modules_k/tmx/README @@ -29,6 +29,7 @@ Daniel-Constantin Mierla 3.1. t_cancel_branches(which) 3.2. t_cancel_callid(callid, cseq, flag) 3.3. t_reply_callid(callid, cseq, code, reason) + 3.4. t_flush_flags() 4. Exported pseudo-variables 5. Exported MI Functions @@ -57,6 +58,7 @@ Daniel-Constantin Mierla 1.1. t_cancel_branches usage 1.2. t_cancel_callid usage 1.3. t_reply_callid usage + 1.4. t_flush_flags usage Chapter 1. Admin Guide @@ -73,6 +75,7 @@ Chapter 1. Admin Guide 3.1. t_cancel_branches(which) 3.2. t_cancel_callid(callid, cseq, flag) 3.3. t_reply_callid(callid, cseq, code, reason) + 3.4. t_flush_flags() 4. Exported pseudo-variables 5. Exported MI Functions @@ -124,6 +127,7 @@ Chapter 1. Admin Guide 3.1. t_cancel_branches(which) 3.2. t_cancel_callid(callid, cseq, flag) 3.3. t_reply_callid(callid, cseq, code, reason) + 3.4. t_flush_flags() 3.1. t_cancel_branches(which) @@ -182,6 +186,19 @@ if (t_reply_callid("123qaz", "5", "458", "Replied remotely")) { } ... +3.4. t_flush_flags() + + Flush the flags from current SIP message into the already created + transaction. It make sense only in routing block if the transaction was + created via t_newtran() and the flags have been altered since. + + This function can be used from ANY_ROUTE . + + Example 1.4. t_flush_flags usage +... +t_flush_flags(); +... + 4. Exported pseudo-variables * $T_branch_idx diff --git a/modules_k/tmx/doc/tmx_admin.xml b/modules_k/tmx/doc/tmx_admin.xml index 1012972..ccdb791 100644 --- a/modules_k/tmx/doc/tmx_admin.xml +++ b/modules_k/tmx/doc/tmx_admin.xml @@ -171,6 +171,27 @@ if (t_reply_callid("123qaz", "5", "458", "Replied remotely")) { </programlisting> </example> </section> + <section> + <title> + <function moreinfo="none">t_flush_flags()</function> + </title> + <para> + Flush the flags from current SIP message into the already created + transaction. It make sense only in routing block if the transaction was + created via t_newtran() and the flags have been altered since. + </para> + <para> + This function can be used from ANY_ROUTE . + </para> + <example> + <title><function>t_flush_flags</function> usage</title> + <programlisting format="linespecific"> +... +t_flush_flags(); +... +</programlisting> + </example> + </section> </section> <section>

1 0

git:3.1: doc: add small note about SCTP compile time deps to INSTALL file, reported from Juha
by Daniel-Constantin Mierla 12 Mar '11

12 Mar '11

Module: sip-router Branch: 3.1 Commit: fb04c55464adb63325ca1772f868e6b80c5c95ca URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=fb04c55… Author: Henning Westerholt <henning.westerholt(a)1und1.de> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Mon Jan 3 12:41:20 2011 +0100 doc: add small note about SCTP compile time deps to INSTALL file, reported from Juha (cherry picked from commit d4d6d3c0270a5892fae87650adc7600a40e25c0e) --- INSTALL | 1 + 1 files changed, 1 insertions(+), 0 deletions(-) diff --git a/INSTALL b/INSTALL index 85b568f..e631567 100644 --- a/INSTALL +++ b/INSTALL @@ -126,6 +126,7 @@ Requirements: module - libpcre libs and devel headers - if you want to compile the lcr and dialplan modules +- libsctp devel headers - if you want to compile the SCTP transport in the core OS Notes:

1 0

git:3.1: INSTALL: updates to reflect flavour switching
by Daniel-Constantin Mierla 12 Mar '11

12 Mar '11

Module: sip-router Branch: 3.1 Commit: 2b23fe5e555e6a0e9a14141b683307626a6bc24b URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=2b23fe5… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Tue Oct 12 22:50:28 2010 +0200 INSTALL: updates to reflect flavour switching (cherry picked from commit 77d7e32549b46bb3a3c7d796e46cf08c0359b730) --- INSTALL | 344 ++++++++++++++++++++++++++++++++++++++++---------------------- 1 files changed, 222 insertions(+), 122 deletions(-) Diff: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commitdiff;h=2b2…

1 0

← Newer
1
...
8
9
10
11
12
13
14
...
20
Older →

Jump to page:

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

sr-dev March 2011