Module: sip-router Branch: master Commit: 0b2462d745ac05587539f6c937aed5580ad92c8c URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=0b2462d… Author: Daniel-Constantin Mierla <miconda(a)gmail.com> Committer: Daniel-Constantin Mierla <miconda(a)gmail.com> Date: Fri Aug 22 15:58:31 2014 +0200 dispatcher: regenerated the documentation for update on ds_select_dst() --- modules/dispatcher/README | 34 ++++++++++++++++++++-------------- 1 files changed, 20 insertions(+), 14 deletions(-) diff --git a/modules/dispatcher/README b/modules/dispatcher/README index 2357883..50b7d1b 100644 --- a/modules/dispatcher/README +++ b/modules/dispatcher/README @@ -67,8 +67,8 @@ Carsten Bock 4. Functions - 4.1. ds_select_dst(set, alg) - 4.2. ds_select_domain(set, alg) + 4.1. ds_select_dst(set, alg[, limit]) + 4.2. ds_select_domain(set, alg[, limit]) 4.3. ds_next_dst() 4.4. ds_next_domain() 4.5. ds_mark_dst([state]) @@ -183,8 +183,8 @@ Chapter 1. Admin Guide 4. Functions - 4.1. ds_select_dst(set, alg) - 4.2. ds_select_domain(set, alg) + 4.1. ds_select_dst(set, alg[, limit]) + 4.2. ds_select_domain(set, alg[, limit]) 4.3. ds_next_dst() 4.4. ds_next_domain() 4.5. ds_mark_dst([state]) @@ -690,8 +690,8 @@ Note 4. Functions - 4.1. ds_select_dst(set, alg) - 4.2. ds_select_domain(set, alg) + 4.1. ds_select_dst(set, alg[, limit]) + 4.2. ds_select_domain(set, alg[, limit]) 4.3. ds_next_dst() 4.4. ds_next_domain() 4.5. ds_mark_dst([state]) @@ -699,7 +699,7 @@ Note 4.7. ds_load_update() 4.8. ds_load_unset() -4.1. ds_select_dst(set, alg) +4.1. ds_select_dst(set, alg[, limit]) The method selects a destination from addresses set. It returns true if a new destination is set. The selected address is set to dst_uri field @@ -707,9 +707,10 @@ Note in the SIP request. If the bit 2 in 'flags' parameter is set, the rest of the addresses - from the destination set is stored in AVP list. You can use - 'ds_next_dst()' to use next address in order to achieve serial forking - to all possible destinations. + from the destination set is stored in AVP list (limited with an + optional 'limit' parameter). You can use 'ds_next_dst()' to use next + address in order to achieve serial forking to all possible + destinations. Meaning of the parameters is as follows: * set - the id of the set from where to pick up destination address. @@ -748,6 +749,9 @@ Note requests as it is the only SIP method creating a SIP call. + "X" - if the algorithm is not implemented, the first entry in set is chosen. + * limit - the maximum number of items to be stored in AVP list for + further failovers (the first selected destination and default + destination are the first to be put in the list) If the bit 2 in 'flags' is set, the rest of the addresses from the destination set is stored in AVP list. You can use 'ds_next_dst()' to @@ -763,17 +767,19 @@ ds_select_dst("1", "0"); $var(a) = 4; ds_select_dst("1", "$var(a)"); ... +ds_select_dst("1", "4", "3"); +... -4.2. ds_select_domain(set, alg) +4.2. ds_select_domain(set, alg[, limit]) The method selects a destination from addresses set and rewrites the host and port from R-URI. The parameters have same meaning as for ds_select_dst(). If the bit 2 in 'flags' is set, the rest of the addresses from the - destination set is stored in AVP list. You can use 'ds_next_domain()' - to use next address to achieve serial forking to all possible - destinations. + destination set is stored in AVP list (limited with an optional 'limit' + parameter). You can use 'ds_next_domain()' to use next address to + achieve serial forking to all possible destinations. This function can be used from REQUEST_ROUTE, FAILURE_ROUTE.