diff --git a/src/modules/dialplan/README b/src/modules/dialplan/README index c5bdaea8ebc..3b89fbd7da4 100644 --- a/src/modules/dialplan/README +++ b/src/modules/dialplan/README @@ -55,6 +55,7 @@ Luis Martin 5.12. fetch_rows (int) 5.13. match_dynamic (int) 5.14. append_branch (int) + 5.15. reload_delta (int) 6. Functions @@ -89,11 +90,12 @@ Luis Martin 1.12. Set fetch_rows parameter 1.13. Set match_dynamic parameter 1.14. Set append_branch parameter - 1.15. dp_replace usage - 1.16. dp_match usage - 1.17. dp_translate usage + 1.15. Set reload_delta parameter + 1.16. dp_replace usage + 1.17. dp_match usage 1.18. dp_translate usage - 1.19. Example of rules + 1.19. dp_translate usage + 1.20. Example of rules Chapter 1. Admin Guide @@ -123,6 +125,7 @@ Chapter 1. Admin Guide 5.12. fetch_rows (int) 5.13. match_dynamic (int) 5.14. append_branch (int) + 5.15. reload_delta (int) 6. Functions @@ -223,6 +226,7 @@ Chapter 1. Admin Guide 5.12. fetch_rows (int) 5.13. match_dynamic (int) 5.14. append_branch (int) + 5.15. reload_delta (int) 5.1. db_url (string) @@ -393,6 +397,23 @@ modparam("dialplan", "match_dynamic", 1) modparam("dialplan", "append_branch", 0) ... +5.15. reload_delta (int) + + The number of seconds that have to be waited before executing a new + reload of dialplan rules. By default there is a rate limiting of + maximum one reload in five seconds. + + If set to 0, no rate limit is configured. Note carefully: use this + configuration only in tests environments because executing two dialplan + reloads at the same time can cause to kamailio to crash. + + Default value is “5”. + + Example 1.15. Set reload_delta parameter +... +modparam("dialplan", "reload_delta", 1) +... + 6. Functions 6.1. dp_replace(dpid, inval, outvar) @@ -423,7 +444,7 @@ modparam("dialplan", "append_branch", 0) This function can be used from ANY_ROUTE. - Example 1.15. dp_replace usage + Example 1.16. dp_replace usage ... dp_replace("240", "$rU", "$var(newru)"); xlog("'$rU' was translated to '$var(newru)'\n"); @@ -450,7 +471,7 @@ dp_replace("240", "+49$rU", "$var(newval)"); This function can be used from ANY_ROUTE. - Example 1.16. dp_match usage + Example 1.17. dp_match usage ... dp_match("240", "+49$rU"); xlog("the attributes associated with '+49$rU' are '$var(attrs)'\n"); @@ -491,13 +512,13 @@ xlog("the attributes associated with '+49$rU' are '$var(attrs)'\n"); This function can be used from ANY_ROUTE. - Example 1.17. dp_translate usage + Example 1.18. dp_translate usage ... dp_translate("240", "$ruri.user/$avp(s:dest)"); xlog("translated to var $avp(s:dest) \n"); ... - Example 1.18. dp_translate usage + Example 1.19. dp_translate usage ... $avp(s:src) = $ruri.user; dp_translate("$var(x)", "$avp(s:src)/$var(y)"); @@ -507,7 +528,8 @@ xlog("translated to var $var(y) \n"); 6.4. dp_reload() Reload the translation rules from the database. Note that there is a - rate limiting of maximum one reload in five seconds. + rate limiting defined by 'reload_delta' paramenter. By default is + allowed maximum one reload in five seconds. Name: dp_reload @@ -571,7 +593,7 @@ xlog("translated to var $var(y) \n"); Some sample records from a dialplan table are presented in the next figure. - Example 1.19. Example of rules + Example 1.20. Example of rules ... dpid: 1 pr: 1