Module: kamailio
Branch: master
Commit: 6dd359e3c55c43b385dc801ba76afe5ad1316c76
URL:
https://github.com/kamailio/kamailio/commit/6dd359e3c55c43b385dc801ba76afe5…
Author: Daniel-Constantin Mierla <miconda(a)gmail.com>
Committer: Daniel-Constantin Mierla <miconda(a)gmail.com>
Date: 2016-11-14T10:55:12+01:00
htable: documentation for event_callback parameter
---
Modified: modules/htable/doc/htable_admin.xml
---
Diff:
https://github.com/kamailio/kamailio/commit/6dd359e3c55c43b385dc801ba76afe5…
Patch:
https://github.com/kamailio/kamailio/commit/6dd359e3c55c43b385dc801ba76afe5…
---
diff --git a/modules/htable/doc/htable_admin.xml b/modules/htable/doc/htable_admin.xml
index 034733c..53ceb8b 100644
--- a/modules/htable/doc/htable_admin.xml
+++ b/modules/htable/doc/htable_admin.xml
@@ -10,9 +10,9 @@
<!-- Module User's Guide -->
<chapter>
-
+
<title>&adminguide;</title>
-
+
<section>
<title>Overview</title>
<para>
@@ -31,7 +31,7 @@
be adjusted per item via assignment operation at runtime.
</para>
<para>
- Replication between multiple servers is performed automatically (if
+ Replication between multiple servers is performed automatically (if
enabled) via the DMQ module.
</para>
<para>
@@ -621,9 +621,9 @@ modparam("htable", "db_expires", 1)
<section id="htable.p.enable_dmq">
<title><varname>enable_dmq</varname> (integer)</title>
<para>
- If set to 1, will enable DMQ replication of actions performed upon
- entries in all tables having "dmqreplicate" parameter set. Any update
- action performed via pseudo-variables, MI and RPC commands will be
+ If set to 1, will enable DMQ replication of actions performed upon
+ entries in all tables having "dmqreplicate" parameter set. Any update
+ action performed via pseudo-variables, MI and RPC commands will be
repeated on all other nodes. Therefore, it is important to ensure the
table definition (size, autoexpire etc.) is identical across all instances.
</para>
@@ -633,7 +633,7 @@ modparam("htable", "db_expires", 1)
</emphasis>
</para>
<para>
- Currently, values are not replicated on load from DB as it is expected
+ Currently, values are not replicated on load from DB as it is expected
that in these cases, all servers will load their values from the same DB.
</para>
<para>
@@ -672,6 +672,34 @@ modparam("htable", "timer_procs", 4)
</programlisting>
</example>
</section>
+ <section id="htable.p.event_callback">
+ <title><varname>event_callback</varname> (str)</title>
+ <para>
+ The name of the function in the kemi configuration file (embedded
+ scripting language such as Lua, Python, ...) to be executed instead
+ of event_route[...] blocks. The function receives a string parameter
+ with the name of the event.
+ </para>
+ <para>
+ <emphasis>
+ Default value is 'empty' (no function is executed for events).
+ </emphasis>
+ </para>
+ <example>
+ <title>Set <varname>event_callback</varname> parameter</title>
+ <programlisting format="linespecific">
+...
+modparam("htable", "event_callback", "ksr_htable_event")
+...
+-- event callback function implemented in Lua
+function ksr_htable_event(evname)
+ KSR.info("===== htable module triggered event: " .. evname ..
"\n");
+ return 1;
+end
+...
+</programlisting>
+ </example>
+ </section>
</section>
<section>
<title>Functions</title>