Module: kamailio Branch: master Commit: 17f5db5b934a6ba35835aa99545d79deb99b35af URL: https://github.com/kamailio/kamailio/commit/17f5db5b934a6ba35835aa99545d79de...
Author: Kamailio Dev kamailio.dev@kamailio.org Committer: Kamailio Dev kamailio.dev@kamailio.org Date: 2017-10-27T15:31:22+02:00
modules: readme files regenerated - timer ... [skip ci]
---
Modified: src/modules/timer/README
---
Diff: https://github.com/kamailio/kamailio/commit/17f5db5b934a6ba35835aa99545d79de... Patch: https://github.com/kamailio/kamailio/commit/17f5db5b934a6ba35835aa99545d79de...
---
diff --git a/src/modules/timer/README b/src/modules/timer/README index 23cd3e49b9..bc20dd0953 100644 --- a/src/modules/timer/README +++ b/src/modules/timer/README @@ -26,10 +26,13 @@ Tomas Mandys 5. Functions
5.1. timer_enable(timer_id, enable_disable) - 5.2. @timer.timer.timer_id.enabled - 5.3. @timer.executed
- 6. Examples + 6. Selects + + 6.1. @timer.timer.timer_id.enabled + 6.2. @timer.executed + + 7. Examples
List of Examples
@@ -58,10 +61,13 @@ Chapter 1. Admin Guide 5. Functions
5.1. timer_enable(timer_id, enable_disable) - 5.2. @timer.timer.timer_id.enabled - 5.3. @timer.executed
- 6. Examples + 6. Selects + + 6.1. @timer.timer.timer_id.enabled + 6.2. @timer.executed + + 7. Examples
1. Overview
@@ -87,11 +93,13 @@ Chapter 1. Admin Guide
3. ABNF syntax
+... timer_id = alphanum slow_fast = "slow" | "fast" declare_timer_syntax = timer_id "=" (route#|route_name) "," interval "," slow_fast "," ["enable"] enable_disable = "0" | "1" +...
4. Parameters
@@ -115,16 +123,13 @@ Chapter 1. Admin Guide timer_enable to start it later.
Example 1.1. Example declare_timer - ... - modparam("timer", "declare_timer", "MY_TIMER=MY_TIMER_ROUTE,10,slow,enab -le"); - ... +... +modparam("timer", "declare_timer", "MY_TIMER=MY_TIMER_ROUTE,10,slow,enable"); +...
5. Functions
5.1. timer_enable(timer_id, enable_disable) - 5.2. @timer.timer.timer_id.enabled - 5.3. @timer.executed
5.1. timer_enable(timer_id, enable_disable)
@@ -136,34 +141,44 @@ le"); * enable_distable - set to 1 to enable timer, to 0 to disable.
Example 1.2. timer_enable usage - ... - timer_enable("MY_TIMER", 1); - ... +... +timer_enable("MY_TIMER", 1); +... + +6. Selects
-5.2. @timer.timer.timer_id.enabled + 6.1. @timer.timer.timer_id.enabled + 6.2. @timer.executed + +6.1. @timer.timer.timer_id.enabled
Return true ("1") if timer specified by timer_id is enabled, otherwise returns false ("0").
Example 1.3. timer.timer.timer_id.enabled usage - if (@timer.timer.MY_TIMER.enabled == "1") { - .... - } +... +if (@timer.timer.MY_TIMER.enabled == "1") { + ... +} +...
-5.3. @timer.executed +6.2. @timer.executed
Returns name of timer which has been executed, i.e. non empty value is returned only when handler is being processed.
Example 1.4. timer.executed usage - if (@timer.executed != "") { - # timer is being handled - .... - } +... +if (@timer.executed != "") { + # timer is being handled + ... +} +...
-6. Examples +7. Examples
Example 1.5. timer common example +... loadmodule "modules/xprint/xprint.so" loadmodule "modules/timer/timer.so"
@@ -184,18 +199,20 @@ route["ONTIMER2"] { timer_enable("tmr1", 0); route("print"); } +...
Example 1.6. Using timer module for testing a functionality
The timer module may be used to test a functionality being developed and not requiring real request. A developer may put tested code in route section which is called once after Kamailio starts. +... loadmodule "timer"; loadmodule "xprint";
modparam("timer", "declare_timer", "TIMER_TEST=TEST,100,,enable");
-route { +request_route { xplog("L_E","main route"); }
@@ -206,4 +223,5 @@ route[TEST] { # add here tested functionality
xplog("L_E","test end\n"); -} + } +...
-
Kamailio Dev