sr-dev January 2025

sr-dev@lists.kamailio.org

5 participants
16 discussions

git:master:fc182198: presence_dfks: added README file

by Daniel-Constantin Mierla

Module: kamailio Branch: master Commit: fc182198c7182759cc2c10b4afa3569336a438c9 URL: https://github.com/kamailio/kamailio/commit/fc182198c7182759cc2c10b4afa3569… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: 2025-01-03T12:02:21+01:00 presence_dfks: added README file - initial import, it is going to be autmatically generated from now on --- Added: src/modules/presence_dfks/README --- Diff: https://github.com/kamailio/kamailio/commit/fc182198c7182759cc2c10b4afa3569… Patch: https://github.com/kamailio/kamailio/commit/fc182198c7182759cc2c10b4afa3569… --- diff --git a/src/modules/presence_dfks/README b/src/modules/presence_dfks/README new file mode 100644 index 00000000000..d965a6e4c6a --- /dev/null +++ b/src/modules/presence_dfks/README @@ -0,0 +1,78 @@ +presence_dfks Module + +Maja Stanislawska + + <maja.stanislawska(a)yahoo.com> + +Victor Seva + + Sipwise GmbH + <vseva(a)sipwise.com> + +Edited by + +Victor Seva + + Sipwise GmbH + <vseva(a)sipwise.com> + + Copyright �� 2014 Maja Stanislawska + + Copyright �� 2024 Victor Seva + __________________________________________________________________ + + Table of Contents + + 1. Admin Guide + + 1. Overview + 2. Dependencies + + 2.1. Kamailio Modules + 2.2. External Libraries or Applications + + 3. Parameters + +Chapter 1. Admin Guide + + Table of Contents + + 1. Overview + 2. Dependencies + + 2.1. Kamailio Modules + 2.2. External Libraries or Applications + + 3. Parameters + +1. Overview + + This module for handling as-feature-event presence messages Provides + support for 'Device FeatureKey Synchronization', as described in + http://community.polycom.com/polycom/attachments/polycom/VoIP/2233/1/De + viceFeatureKeySynchronizationFD.pdf This 'protocol' was developed at + Broadsoft, and is used in Linksys/Cisco and Polycom phones and probably + some other too. It allows to set up features like dnd (No Not Disturb) + and call forwarding using phone interface and have that status updated + on aplication server/ proxy or otherway, set those features on + aplication server using some gui, and have this data provisioned on + phone. For Shared Line Appreance application this let You share status + on all phones. + +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: + * sl. presence. pua. + +2.2. External Libraries or Applications + + The following libraries or applications must be installed before + running Kamailio with this module loaded: + * libxml2 - xml handling library. + +3. Parameters

2 days, 20 hours

git:master:0a09129a: topos_htable: added README file

by Daniel-Constantin Mierla

Module: kamailio Branch: master Commit: 0a09129a952b10bee6aa037781cf498ab703eabd URL: https://github.com/kamailio/kamailio/commit/0a09129a952b10bee6aa037781cf498… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: 2025-01-03T12:00:13+01:00 topos_htable: added README file - it has to be added first time, when the module is imported in the repo, afterwards is autmatically generated when the xml doc files are updated --- Added: src/modules/topos_htable/README --- Diff: https://github.com/kamailio/kamailio/commit/0a09129a952b10bee6aa037781cf498… Patch: https://github.com/kamailio/kamailio/commit/0a09129a952b10bee6aa037781cf498… --- diff --git a/src/modules/topos_htable/README b/src/modules/topos_htable/README new file mode 100644 index 00000000000..85ca43e6916 --- /dev/null +++ b/src/modules/topos_htable/README @@ -0,0 +1,113 @@ +TOPOS_HTABLE Module + +Edited by + +Stefan Mititelu + + <stefan.mititelu(a)net2phone.com> + + Copyright �� 2024 kamailio.org + + Copyright �� 2024 net2phone.com + __________________________________________________________________ + + Table of Contents + + 1. Admin Guide + + 1. Overview + 2. Dependencies + + 2.1. Kamailio Modules + 2.2. External Libraries or Applications + + 3. Parameters + + 3.1. topos_htable_dialog (string) + 3.2. topos_htable_transaction (string) + 3.3. topos_htable_base64 (int) + + List of Examples + + 1.1. Set topos_htable_dialog parameter + 1.2. Set topos_htable_transaction parameter + 1.3. Set topos_htable_base64 parameter + +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. topos_htable_dialog (string) + 3.2. topos_htable_transaction (string) + 3.3. topos_htable_base64 (int) + +1. Overview + + This module offers storage support for topos module using htable + module. + +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: + * topos module - to bind to as a storage engine. + * htable module - to bind to as a shm storage engine. + +2.2. External Libraries or Applications + + No libraries or applications must be installed before running Kamailio + with this module loaded. + +3. Parameters + + 3.1. topos_htable_dialog (string) + 3.2. topos_htable_transaction (string) + 3.3. topos_htable_base64 (int) + +3.1. topos_htable_dialog (string) + + Definition of dialog htable, with all parameters. + + Default value is ��topos_dialog=>size=4;autoexpire=7200;dmqreplicate=1��. + + Example 1.1. Set topos_htable_dialog parameter +... +modparam("topos_htable", "topos_htable_dialog", "my_dialogs=>size=4;autoexpire=7 +200;dmqreplicate=1") +... + +3.2. topos_htable_transaction (string) + + Definition of transaction htable, with all parameters. + + Default value is ��topos_transaction=>size=4;autoexpire=7200��. + + Example 1.2. Set topos_htable_transaction parameter +... +modparam("topos_htable", "topos_htable_transaction", "my_transactions=>size=4;au +toexpire=7200") +... + +3.3. topos_htable_base64 (int) + + Enable or disable base64 encoding of htable values. Useful when + individual values stored in htable contain delimiter value "|". + + Default value is ��0��. + + Example 1.3. Set topos_htable_base64 parameter +... +modparam("topos_htable", "topos_htable_base64", 1) +...

2 days, 20 hours

git:master:1197efc3: cmake: Add modules docs and man target

by Xenofon Karamanos

Module: kamailio Branch: master Commit: 1197efc3150a361e3f884c47085ed9598c16589e URL: https://github.com/kamailio/kamailio/commit/1197efc3150a361e3f884c47085ed95… Author: Xenofon Karamanos <xk(a)gilawa.com> Committer: Xenofon Karamanos <xk(a)gilawa.com> Date: 2025-01-03T10:32:46Z cmake: Add modules docs and man target - Add kamailio_docs_readme to produce all modules READMEs in source tree at once. - Add kamailio_docs_man to prduce all modules man page. (if xml exist) - Switch to add_dependencies when we depend on a target and not file. --- Modified: cmake/modules-docs.cmake Modified: src/modules/CMakeLists.txt --- Diff: https://github.com/kamailio/kamailio/commit/1197efc3150a361e3f884c47085ed95… Patch: https://github.com/kamailio/kamailio/commit/1197efc3150a361e3f884c47085ed95…

2 days, 21 hours

[kamailio/kamailio] Module snmpstats reporting inconsistent call success metrics on intense peaks of failed calls (Issue #4006)

by igorpotjevlesh

### Description We are plotting the call success rate on each of our proxies. Using the Kamailio snmpstats module, we try to obtain three counters in order to plot them on a graph: - Total Calls - Active Calls - Error Calls Most of the time, everything works well and we obtain sensible values: `snmpwalk -c mycommunity -v 2c W.X.Y.Z 1.3.6.1.4.1.34352.3.1.3.1.3.2 -O n` > .1.3.6.1.4.1.34352.3.1.3.1.3.2.1.0 = Gauge32: 309 -> Total Calls .1.3.6.1.4.1.34352.3.1.3.1.3.2.2.0 = Gauge32: 95 -> Active Calls .1.3.6.1.4.1.34352.3.1.3.1.3.2.3.0 = Gauge32: 214 -> Error calls However, **when our proxies are facing intense peaks of failed calls in a short timespan**, sometimes, the **"Error Calls"** counter returns a value **higher than "Total Calls"**. As a result, **"Active Calls"** suddenly reaches a value close to the **maximum of a _Gauge32_** (because ${TotalCalls} - {ErrorCalls} < 0$). `snmpwalk -c mycommunity -v 2c W.X.Y.Z 1.3.6.1.4.1.34352.3.1.3.1.3.2 -O n` > .1.3.6.1.4.1.34352.3.1.3.1.3.2.1.0 = Gauge32: 153 -> Total Calls .1.3.6.1.4.1.34352.3.1.3.1.3.2.2.0 = Gauge32: 4294967226 -> Active Calls .1.3.6.1.4.1.34352.3.1.3.1.3.2.3.0 = Gauge32: 223 -> Error calls As a result, our graphs make no more sense. ### Troubleshooting There seems to be a bug causing Total calls to be lower than Error calls when a high number of failed calls are received in a short time window. Moreover, there is an integer overflow resulting to the negative result of the substraction being converted to a _Gauge32_. Maybe setting it to 0 in case of a negative result would be safer ? #### Reproduction Using the following configuration for the snmpstats module of your Kamailio proxy: ``` # -------- snmpstats params ------- modparam("snmpstats", "snmpgetPath", "/usr/bin/") modparam("snmpstats", "snmpCommunity", "mycommunity") modparam("snmpstats", "sipEntityType", "proxyServer") ``` On intense peaks of failed calls, get the call success metrics using `snmpwalk` : `snmpwalk -c mycommunity -v 2c W.X.Y.Z 1.3.6.1.4.1.34352.3.1.3.1.3.2 -O n` > .1.3.6.1.4.1.34352.3.1.3.1.3.2.1.0 = Gauge32: 153 -> Total Calls .1.3.6.1.4.1.34352.3.1.3.1.3.2.2.0 = Gauge32: 4294967226 -> Active Calls .1.3.6.1.4.1.34352.3.1.3.1.3.2.3.0 = Gauge32: 223-> Error calls ### Additional Information **Kamailio Version**: `kamailio -v` > version: kamailio 5.6.4 (x86_64/linux) a004cf flags: USE_TCP, USE_TLS, USE_SCTP, TLS_HOOKS, USE_RAW_SOCKS, DISABLE_NAGLE, USE_ MCAST, DNS_IP_HACK, SHM_MMAP, PKG_MALLOC, Q_MALLOC, F_MALLOC, TLSF_MALLOC, DBG_S R_MEMORY, USE_FUTEX, FAST_LOCK-ADAPTIVE_WAIT, USE_DNS_CACHE, USE_DNS_FAILOVER, U SE_NAPTR, USE_DST_BLOCKLIST, HAVE_RESOLV_RES ADAPTIVE_WAIT_LOOPS 1024, MAX_RECV_BUFFER_SIZE 262144, MAX_URI_SIZE 1024, BUF_SI ZE 65535, DEFAULT PKG_SIZE 64MB poll method support: poll, epoll_lt, epoll_et, sigio_rt, select. id: a004cf compiled on 16:10:41 May 22 2023 with gcc 4.4.7 * **Operating System**: `uname -r` > 2.6.32-279.el6.x86_64 `lsb_release -a` > LSB Version: :core-4.0-amd64:core-4.0-noarch:graphics-4.0-amd64:graphics-4.0-noarch:printing-4.0-amd64:printing-4.0-noarch Distributor ID: RedHatEnterpriseServer Description: Red Hat Enterprise Linux Server release 6.3 (Santiago) Release: 6.3 Codename: Santiago -- Reply to this email directly or view it on GitHub: https://github.com/kamailio/kamailio/issues/4006 You are receiving this because you are subscribed to this thread. Message ID: <kamailio/kamailio/issues/4006(a)github.com>

3 days, 16 hours

[kamailio/kamailio] core: parser - set URI type to TELS_URI_T for user=phone SIPS R-URI (PR #4093)

by Alexander Bakker

#### Pre-Submission Checklist - [x] Commit message has the format required by CONTRIBUTING guide - [x] Commits are split per component (core, individual modules, libs, utils, ...) - [x] Each component has a single commit (if not, squash them into one commit) - [x] No commits to README files for modules (changes must be done to docbook files in `doc/` subfolder, the README file is autogenerated) #### Type Of Change - [x] Small bug fix (non-breaking change which fixes an issue) - [ ] New feature (non-breaking change which adds new functionality) - [ ] Breaking change (fix or feature that would change existing functionality) #### Checklist: - [x] PR should be backported to stable branches - [x] Tested changes locally - [ ] Related to issue #XXXX (replace XXXX with an open issue number) #### Description Fixes an issue where setting the ``$rU`` for a SIPS R-URI containing ``user=phone`` would overwrite the scheme to ``sip``. You can view, comment on, or merge this pull request online at: https://github.com/kamailio/kamailio/pull/4093 -- Commit Summary -- * core: parser - set URI type to TELS_URI_T for user=phone SIPS R-URI -- File Changes -- M src/core/parser/parse_uri.c (2) -- Patch Links -- https://github.com/kamailio/kamailio/pull/4093.patch https://github.com/kamailio/kamailio/pull/4093.diff -- Reply to this email directly or view it on GitHub: https://github.com/kamailio/kamailio/pull/4093 You are receiving this because you are subscribed to this thread. Message ID: <kamailio/kamailio/pull/4093(a)github.com>

3 days, 17 hours

[kamailio/kamailio] app_python3: evaluate LIBS variable imediately in Makefile (PR #4085)

by sergey-safarov

#### Pre-Submission Checklist - [x] Commit message has the format required by CONTRIBUTING guide - [x] Commits are split per component (core, individual modules, libs, utils, ...) - [x] Each component has a single commit (if not, squash them into one commit) - [x] No commits to README files for modules (changes must be done to docbook files in `doc/` subfolder, the README file is autogenerated) #### Type Of Change - [x] Small bug fix (non-breaking change which fixes an issue) - [ ] New feature (non-breaking change which adds new functionality) - [ ] Breaking change (fix or feature that would change existing functionality) #### Checklist: - [x] PR should be backported to stable branches - [x] Tested changes locally - [ ] Related to issue #XXXX (replace XXXX with an open issue number) #### Description latest `make` version does not evaluate variables immediately. PR explicitly evaluates the LIBS makefile variable. You can view, comment on, or merge this pull request online at: https://github.com/kamailio/kamailio/pull/4085 -- Commit Summary -- * app_python3: evaluate LIBS variable imediately in Makefile -- File Changes -- M src/modules/app_python3/Makefile (4) -- Patch Links -- https://github.com/kamailio/kamailio/pull/4085.patch https://github.com/kamailio/kamailio/pull/4085.diff -- Reply to this email directly or view it on GitHub: https://github.com/kamailio/kamailio/pull/4085 You are receiving this because you are subscribed to this thread. Message ID: <kamailio/kamailio/pull/4085(a)github.com>

3 days, 19 hours

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

sr-dev January 2025