Module: sip-router Branch: master Commit: 671bc7b32097bb690a95253e9585236e99b67310 URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=671bc7b… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Thu Sep 30 00:17:35 2010 +0200 dispatcher(k): regenerated readme file --- modules_k/dispatcher/README | 116 ++++++++++++++++++++++++++----------------- 1 files changed, 70 insertions(+), 46 deletions(-) diff --git a/modules_k/dispatcher/README b/modules_k/dispatcher/README index f5fabd3..78d0b8c 100644 --- a/modules_k/dispatcher/README +++ b/modules_k/dispatcher/README @@ -56,12 +56,13 @@ Carsten Bock 3.19. ds_ping_from (string) 3.20. ds_ping_interval (int) 3.21. ds_probing_threshhold (int) - 3.22. ds_probing_mode (int) - 3.23. ds_append_branch (int) - 3.24. ds_hash_size (int) - 3.25. ds_hash_expire (int) - 3.26. ds_hash_initexpire (int) - 3.27. ds_hash_check_interval (int) + 3.22. ds_ping_reply_codes (string) + 3.23. ds_probing_mode (int) + 3.24. ds_append_branch (int) + 3.25. ds_hash_size (int) + 3.26. ds_hash_expire (int) + 3.27. ds_hash_initexpire (int) + 3.28. ds_hash_check_interval (int) 4. Exported Functions @@ -113,16 +114,17 @@ Carsten Bock 1.20. Set the “ds_ping_from” parameter 1.21. Set the “ds_ping_interval” parameter 1.22. Set the “ds_probing_threshhold” parameter - 1.23. Set the “ds_probing_mode” parameter - 1.24. Set the “ds_append_branch” parameter - 1.25. Set the “ds_hash_size” parameter - 1.26. Set the “ds_hash_expire” parameter - 1.27. Set the “ds_hash_initexpire” parameter - 1.28. Set the “ds_hash_check_interval” parameter - 1.29. ds_select_dst usage - 1.30. ds_load_unset usage - 1.31. dispatcher list file - 1.32. Kamailio config script - sample dispatcher usage + 1.23. Set the “ds_ping_reply_codes” parameter + 1.24. Set the “ds_probing_mode” parameter + 1.25. Set the “ds_append_branch” parameter + 1.26. Set the “ds_hash_size” parameter + 1.27. Set the “ds_hash_expire” parameter + 1.28. Set the “ds_hash_initexpire” parameter + 1.29. Set the “ds_hash_check_interval” parameter + 1.30. ds_select_dst usage + 1.31. ds_load_unset usage + 1.32. dispatcher list file + 1.33. Kamailio config script - sample dispatcher usage Chapter 1. Admin Guide @@ -157,12 +159,13 @@ Chapter 1. Admin Guide 3.19. ds_ping_from (string) 3.20. ds_ping_interval (int) 3.21. ds_probing_threshhold (int) - 3.22. ds_probing_mode (int) - 3.23. ds_append_branch (int) - 3.24. ds_hash_size (int) - 3.25. ds_hash_expire (int) - 3.26. ds_hash_initexpire (int) - 3.27. ds_hash_check_interval (int) + 3.22. ds_ping_reply_codes (string) + 3.23. ds_probing_mode (int) + 3.24. ds_append_branch (int) + 3.25. ds_hash_size (int) + 3.26. ds_hash_expire (int) + 3.27. ds_hash_initexpire (int) + 3.28. ds_hash_check_interval (int) 4. Exported Functions @@ -236,12 +239,13 @@ Chapter 1. Admin Guide 3.19. ds_ping_from (string) 3.20. ds_ping_interval (int) 3.21. ds_probing_threshhold (int) - 3.22. ds_probing_mode (int) - 3.23. ds_append_branch (int) - 3.24. ds_hash_size (int) - 3.25. ds_hash_expire (int) - 3.26. ds_hash_initexpire (int) - 3.27. ds_hash_check_interval (int) + 3.22. ds_ping_reply_codes (string) + 3.23. ds_probing_mode (int) + 3.24. ds_append_branch (int) + 3.25. ds_hash_size (int) + 3.26. ds_hash_expire (int) + 3.27. ds_hash_initexpire (int) + 3.28. ds_hash_check_interval (int) 3.1. list_file (string) @@ -531,7 +535,8 @@ Note If you want to set a gateway into probing mode, you will need a specific number of requests until it will change from "active" to - probing. The number of attempts can be set with this parameter. + probing. The number of attempts can be set with this parameter. This + parameter can be modified via ser config framework. Default value is “3”. @@ -540,7 +545,25 @@ Note modparam("dispatcher", "ds_probing_threshhold", 10) ... -3.22. ds_probing_mode (int) +3.22. ds_ping_reply_codes (string) + + This parameter defines the valid response codes, which are accepted as + a valid reply to the PING-Method. It is a list separated by colons, + whery you may define either a single code (e.g. "code=202" would accept + 202 as an additional, valid response) or a class of responses, you want + to accept (e.g. "class=2" would accept everything from 200 to 299 as + valid response). This parameter can be modified via ser config + framework. + + Default value is “” (only 200 OK is accepted). + + Example 1.23. Set the “ds_ping_reply_codes” parameter + ... + modparam("dispatcher", "ds_ping_reply_codes", "class=2;code=403;code=488;class= +3") + ... + +3.23. ds_probing_mode (int) Controls what gateways are tested to see if they are reachable. If set to 0, only the gateways with state PROBING are tested, if set to 1, all @@ -549,12 +572,12 @@ Note Default value is “0”. - Example 1.23. Set the “ds_probing_mode” parameter + Example 1.24. Set the “ds_probing_mode” parameter ... modparam("dispatcher", "ds_probing_mode", 1) ... -3.23. ds_append_branch (int) +3.24. ds_append_branch (int) If set to 1, functions will automaticall append a new branch if called in FAILURE_ROUTE. If set to 0, script writer has to call @@ -562,12 +585,12 @@ Note Default value is “1”. - Example 1.24. Set the “ds_append_branch” parameter + Example 1.25. Set the “ds_append_branch” parameter ... modparam("dispatcher", "ds_append_branch", 0) ... -3.24. ds_hash_size (int) +3.25. ds_hash_size (int) The value to be used as power of two to set the number of slots to hash table storing data for call load dispatching (e.g., value 8 will create @@ -576,24 +599,24 @@ Note Default value is “0”. - Example 1.25. Set the “ds_hash_size” parameter + Example 1.26. Set the “ds_hash_size” parameter ... modparam("dispatcher", "ds_hash_size", 9) ... -3.25. ds_hash_expire (int) +3.26. ds_hash_expire (int) Expiration time in seconds to remove the load on a destination if no BYE was received meanwhile. Default value is “7200”. - Example 1.26. Set the “ds_hash_expire” parameter + Example 1.27. Set the “ds_hash_expire” parameter ... modparam("dispatcher", "ds_hash_expire", 3600) ... -3.26. ds_hash_initexpire (int) +3.27. ds_hash_initexpire (int) Expiration time in seconds to remove the load on a destination if no 200 for INVITE was received meanwhile and state updated with @@ -601,19 +624,19 @@ Note Default value is “7200”. - Example 1.27. Set the “ds_hash_initexpire” parameter + Example 1.28. Set the “ds_hash_initexpire” parameter ... modparam("dispatcher", "ds_hash_initexpire", 60) ... -3.27. ds_hash_check_interval (int) +3.28. ds_hash_check_interval (int) Time interval in seconds to scan internal hash table with call load dispatching data for expired items. Default value is “30”. - Example 1.28. Set the “ds_hash_check_interval” parameter + Example 1.29. Set the “ds_hash_check_interval” parameter ... modparam("dispatcher", "ds_hash_check_interval", 60) ... @@ -680,7 +703,7 @@ Note This function can be used from REQUEST_ROUTE. - Example 1.29. ds_select_dst usage + Example 1.30. ds_select_dst usage ... ds_select_dst("1", "0"); ... @@ -776,7 +799,7 @@ ds_select_dst("1", "$var(a)"); This function can be used from REQUEST_ROUTE, FAILURE_ROUTE, BRANCH_ROUTE and ONREPLY_ROUTE. - Example 1.30. ds_load_unset usage + Example 1.31. ds_load_unset usage ... route { ... @@ -884,14 +907,15 @@ setid(int) destination(sip uri) flags(int,opt) priority(int,opt) attrs(str,opt) For database, each element of a line resides in a different column. Next is a dispatcher.list file example: - Example 1.31. dispatcher list file + Example 1.32. dispatcher list file ... # $Id$ # dispatcher destination sets # # line format -# setit(integer) destination(sip uri) flags (integer, optional) +# setit(int) destination(sip uri) flags(int,opt) priority(int,opt) attributes(st +r,opt) # proxies 2 sip:127.0.0.1:5080 @@ -908,7 +932,7 @@ setid(int) destination(sip uri) flags(int,opt) priority(int,opt) attrs(str,opt) Next picture displays a sample usage of dispatcher. - Example 1.32. Kamailio config script - sample dispatcher usage + Example 1.33. Kamailio config script - sample dispatcher usage ... # $Id$ # sample config file for dispatcher module