[sr-dev] git:master: dispatcher(k): clarification about trying transition state from active to inactive

[Daniel-Constantin Mierla]

Module: sip-router
Branch: master
Commit: 0b8f2ee4c128cd2b532356087272445519c1c08b
URL:    http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=0b8f2ee4c128cd2b532356087272445519c1c08b

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date:   Thu Oct 27 16:45:17 2011 +0200

dispatcher(k): clarification about trying transition state from active to inactive

---

 modules_k/dispatcher/README                   |   14 ++++++++------
 modules_k/dispatcher/doc/dispatcher_admin.xml |    9 ++++++---
 2 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/modules_k/dispatcher/README b/modules_k/dispatcher/README
index 19b17de..4d3403d 100644
--- a/modules_k/dispatcher/README
+++ b/modules_k/dispatcher/README
@@ -559,12 +559,14 @@ Note
 
 3.21. ds_probing_threshhold (int)
 
-   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. This
-   parameter can be modified via ser config framework.
-
-   Default value is "3".
+   If you want to set a gateway into inactive mode, there can be a
+   specific number of failed requests until it will change from "active"
+   to "inactive". It is using the state "trying", that allows selection of
+   gateway but indicates there was a failure previously with the gateway.
+   The number of attempts can be set with this parameter. This parameter
+   can be modified via ser config framework.
+
+   Default value is "1" (set inactive with first failure).
 
    Example 1.22. Set the "ds_probing_threshhold" parameter
  ...
diff --git a/modules_k/dispatcher/doc/dispatcher_admin.xml b/modules_k/dispatcher/doc/dispatcher_admin.xml
index 9fc5fdb..037ad19 100644
--- a/modules_k/dispatcher/doc/dispatcher_admin.xml
+++ b/modules_k/dispatcher/doc/dispatcher_admin.xml
@@ -542,13 +542,16 @@ modparam("dispatcher", "force_dst", 1)
  	<section>
  		<title><varname>ds_probing_threshhold</varname> (int)</title>
  		<para>
-		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.
+		If you want to set a gateway into inactive mode, there can be
+		a specific number of failed requests until it will change from "active"
+		to "inactive". It is using the state "trying", that allows selection
+		of gateway but indicates there was a failure previously with the
+		gateway. The number of attempts can be set with this parameter.
 		This parameter can be modified via ser config framework.
  		</para>
  		<para>
  		<emphasis>
- 			Default value is <quote>3</quote>.
+		Default value is <quote>1</quote> (set inactive with first failure).
  		</emphasis>
  		</para>
  		<example>