Module: kamailio
Branch: master
Commit: a78b2dcdb484dd3c58b5c3c59e6e627bf2947516
URL: https://github.com/kamailio/kamailio/commit/a78b2dcdb484dd3c58b5c3c59e6e627…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2022-02-15T08:16:18+01:00
modules: readme files regenerated - async ... [skip ci]
---
Modified: src/modules/async/README
---
Diff: https://github.com/kamailio/kamailio/commit/a78b2dcdb484dd3c58b5c3c59e6e627…
Patch: https://github.com/kamailio/kamailio/commit/a78b2dcdb484dd3c58b5c3c59e6e627…
---
diff --git a/src/modules/async/README b/src/modules/async/README
index e26f2ea584..744e98bf3e 100644
--- a/src/modules/async/README
+++ b/src/modules/async/README
@@ -35,6 +35,7 @@ Daniel-Constantin Mierla
4.3. async_sleep(seconds)
4.4. async_ms_sleep(milliseconds)
4.5. async_task_route(routename)
+ 4.6. async_task_group_route(routename, groupname)
List of Examples
@@ -46,6 +47,7 @@ Daniel-Constantin Mierla
1.6. async_ms_sleep usage
1.7. async_workers usage
1.8. async_task_route usage
+ 1.9. async_task_group_route usage
Chapter 1. Admin Guide
@@ -69,6 +71,7 @@ Chapter 1. Admin Guide
4.3. async_sleep(seconds)
4.4. async_ms_sleep(milliseconds)
4.5. async_task_route(routename)
+ 4.6. async_task_group_route(routename, groupname)
1. Overview
@@ -139,6 +142,7 @@ modparam("async", "ms_timer", 10)
4.3. async_sleep(seconds)
4.4. async_ms_sleep(milliseconds)
4.5. async_task_route(routename)
+ 4.6. async_task_group_route(routename, groupname)
4.1. async_route(routename, seconds)
@@ -266,10 +270,11 @@ route[REQUESTSHAPER] {
4.5. async_task_route(routename)
Continue the processing of the SIP request with the route[routename] in
- one of the processes from core asynchronous framework. The core
- parameter async_workers has to be set to enable asynchronous framework.
- The task is executed as soon as a process from asynchronous framework
- is idle, there is no wait time for the task like for async_route(...).
+ one of the processes from first group of core asynchronous framework.
+ The core parameter async_workers has to be set to enable asynchronous
+ framework. The task is executed as soon as a process from asynchronous
+ framework is idle, there is no wait time for the task like for
+ async_route(...).
To enable the core asynchronous framework, you need to set the
async_workers core parameter in the configuration file. See the core
@@ -307,3 +312,26 @@ route[RESUME] {
exit;
}
...
+
+4.6. async_task_group_route(routename, groupname)
+
+ Similar to async_task_route(), but allows to specify the name of the
+ group for asynchronous workers. See also 'async_workers_group' core
+ global parameter.
+
+ This function can be used from REQUEST_ROUTE.
+
+ Example 1.9. async_task_group_route usage
+...
+async_workers_group="name=abc;workers=4;nonblock=0;usleep=0"
+...
+request_route {
+ ...
+ async_task_route("RESUME", "abc");
+ ...
+}
+route[RESUME] {
+ t_relay();
+ exit;
+}
+...
Module: kamailio
Branch: master
Commit: 5f590180c3acc5f786c1d0667997c1b3b8924ed9
URL: https://github.com/kamailio/kamailio/commit/5f590180c3acc5f786c1d0667997c1b…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2022-02-15T08:10:54+01:00
async: docs for async_task_group_route(routename, groupname)
---
Modified: src/modules/async/doc/async_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/5f590180c3acc5f786c1d0667997c1b…
Patch: https://github.com/kamailio/kamailio/commit/5f590180c3acc5f786c1d0667997c1b…
---
diff --git a/src/modules/async/doc/async_admin.xml b/src/modules/async/doc/async_admin.xml
index a56c60d7d2..1db4d60e9e 100644
--- a/src/modules/async/doc/async_admin.xml
+++ b/src/modules/async/doc/async_admin.xml
@@ -287,8 +287,8 @@ route[REQUESTSHAPER] {
</title>
<para>
Continue the processing of the SIP request with the route[routename]
- in one of the processes from core asynchronous framework. The core
- parameter async_workers has to be set to enable asynchronous
+ in one of the processes from first group of core asynchronous framework.
+ The core parameter async_workers has to be set to enable asynchronous
framework. The task is executed as soon as a process from asynchronous
framework is idle, there is no wait time for the task like for
async_route(...).
@@ -339,6 +339,37 @@ route[RESUME] {
exit;
}
...
+</programlisting>
+ </example>
+ </section>
+ <section id="async.f.async_task_group_route">
+ <title>
+ <function moreinfo="none">async_task_group_route(routename, groupname)</function>
+ </title>
+ <para>
+ Similar to async_task_route(), but allows to specify the name of the group
+ for asynchronous workers. See also 'async_workers_group' core global
+ parameter.
+ </para>
+ <para>
+ This function can be used from REQUEST_ROUTE.
+ </para>
+ <example>
+ <title><function>async_task_group_route</function> usage</title>
+ <programlisting format="linespecific">
+...
+async_workers_group="name=abc;workers=4;nonblock=0;usleep=0"
+...
+request_route {
+ ...
+ async_task_route("RESUME", "abc");
+ ...
+}
+route[RESUME] {
+ t_relay();
+ exit;
+}
+...
</programlisting>
</example>
</section>
Module: kamailio
Branch: 5.5
Commit: 3c3ffd803192b92f126f7f08119459593eafe30c
URL: https://github.com/kamailio/kamailio/commit/3c3ffd803192b92f126f7f081194595…
Author: Kamailio Dev <kamailio.dev(a)kamailio.org>
Committer: Kamailio Dev <kamailio.dev(a)kamailio.org>
Date: 2022-02-14T15:17:04+01:00
modules: readme files regenerated - modules ... [skip ci]
---
Modified: src/modules/xmlops/README
---
Diff: https://github.com/kamailio/kamailio/commit/3c3ffd803192b92f126f7f081194595…
Patch: https://github.com/kamailio/kamailio/commit/3c3ffd803192b92f126f7f081194595…
---
diff --git a/src/modules/xmlops/README b/src/modules/xmlops/README
index 0ecfcb5ca0..df62770802 100644
--- a/src/modules/xmlops/README
+++ b/src/modules/xmlops/README
@@ -93,11 +93,28 @@ modparam("xmlops", "buf_size", 8192)
3.2. xml_ns (str)
Register xml namespace prefix. Parameter value must have the format:
- 'prefix=uri'.
+ 'prefix=uri'. It can be set many times to cope with multiple namespaces
+ without prefix.
+
+ This is useful when it is needed to access XML documents that specify
+ xmlns without prefix, which is not XML-standard compliant, but it comes
+ with SIP SIMPLE presence bodies.
Example 1.2. Set xml_ns parameter
...
modparam("xmlops", "xml_ns", "rpid=urn:ietf:params:xml:ns:pidf:rpid")
+modparam("xmlops", "xml_ns", "pidf=urn:ietf:params:xml:ns:pidf")
+...
+$xml(x=>doc) = '<?xml version="1.0" encoding="utf-8"?>
+ <presence xmlns="urn:ietf:params:xml:ns:pidf" entity="sip:test@mydomain.com"
+>
+ <tuple id="86ae65b7-42de-4399-b635-295caad13aac">
+ <status><basic>none</basic></status>
+ </tuple>
+ </presence>';
+
+xinfo("status: $xml(x=>xpath:/pidf:presence/pidf:tuple/pidf:status/pidf:basic)\n
+");
...
4. Pseudo-Variables
Module: kamailio
Branch: 5.5
Commit: 78710d9da5cfe117190694cd3b77ced54414a2e8
URL: https://github.com/kamailio/kamailio/commit/78710d9da5cfe117190694cd3b77ced…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2022-02-14T13:04:01+01:00
xmlops: docs - added the remark that xml_ns param can be set many times
(cherry picked from commit 56e26387b77536e6c9f13dd62e5aecabaaba2d9a)
---
Modified: src/modules/xmlops/doc/xmlops_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/78710d9da5cfe117190694cd3b77ced…
Patch: https://github.com/kamailio/kamailio/commit/78710d9da5cfe117190694cd3b77ced…
---
diff --git a/src/modules/xmlops/doc/xmlops_admin.xml b/src/modules/xmlops/doc/xmlops_admin.xml
index d78247d310..d9a6e04a5d 100644
--- a/src/modules/xmlops/doc/xmlops_admin.xml
+++ b/src/modules/xmlops/doc/xmlops_admin.xml
@@ -68,7 +68,8 @@ modparam("xmlops", "buf_size", 8192)
<title><varname>xml_ns</varname> (str)</title>
<para>
Register xml namespace prefix. Parameter value must have the format:
- 'prefix=uri'.
+ 'prefix=uri'. It can be set many times to cope with multiple namespaces
+ without prefix.
</para>
<para>
This is useful when it is needed to access XML documents that specify
@@ -80,6 +81,7 @@ modparam("xmlops", "buf_size", 8192)
<programlisting format="linespecific">
<![CDATA[
...
+modparam("xmlops", "xml_ns", "rpid=urn:ietf:params:xml:ns:pidf:rpid")
modparam("xmlops", "xml_ns", "pidf=urn:ietf:params:xml:ns:pidf")
...
$xml(x=>doc) = '<?xml version="1.0" encoding="utf-8"?>