[sr-dev] git:master:66e3c96f: modules: readme files regenerated - dialog ... [skip ci]

[Kamailio Dev]

Module: kamailio
Branch: master
Commit: 66e3c96f49e25ef7d2441f95b20d34a138572231
URL: https://github.com/kamailio/kamailio/commit/66e3c96f49e25ef7d2441f95b20d34a138572231

Author: Kamailio Dev <kamailio.dev at kamailio.org>
Committer: Kamailio Dev <kamailio.dev at kamailio.org>
Date: 2018-04-06T09:31:52+02:00

modules: readme files regenerated - dialog ... [skip ci]

---

Modified: src/modules/dialog/README

---

Diff:  https://github.com/kamailio/kamailio/commit/66e3c96f49e25ef7d2441f95b20d34a138572231.diff
Patch: https://github.com/kamailio/kamailio/commit/66e3c96f49e25ef7d2441f95b20d34a138572231.patch

---

diff --git a/src/modules/dialog/README b/src/modules/dialog/README
index fbad4ab89f..962046c23d 100644
--- a/src/modules/dialog/README
+++ b/src/modules/dialog/README
@@ -130,6 +130,7 @@ Olle E. Johansson
               7.17. dlg_remote_profile(cmd, profile, value, uid, expires)
               7.18. dlg_set_ruri()
               7.19. dlg_db_load_callid(cival)
+              7.20. dlg_db_load_extra()
 
         8. Statistics
 
@@ -257,6 +258,7 @@ Olle E. Johansson
    1.77. dlg_remote_profile usage
    1.78. dlg_set_ruri() usage
    1.79. dlg_db_load_callid() usage
+   1.80. dlg_db_load_extra() usage
 
 Chapter 1. Admin Guide
 
@@ -355,6 +357,7 @@ Chapter 1. Admin Guide
         7.17. dlg_remote_profile(cmd, profile, value, uid, expires)
         7.18. dlg_set_ruri()
         7.19. dlg_db_load_callid(cival)
+        7.20. dlg_db_load_extra()
 
    8. Statistics
 
@@ -1354,11 +1357,11 @@ modparam("dialog", "h_id_start", 5)
    the rule: h_id_start + N * h_id_step. The first value of N is randomly
    selected at startup, then incremented by 1 for each new dialog. Setting
    h_id_start and h_id_step to non-default values should be done when
-   using dlg_db_load_callid(...) to load dialog records generated by
-   another Kamailio instance, making also sure that those Kamailio
-   instances are not going to generate overalapping dialog hash id values
-   by using different h_id_start and the same h_id_step (h_id_step has to
-   be greater than the maximum value of h_id_start).
+   using dlg_db_load_callid(...) or dlg_db_load_extra() to load dialog
+   records generated by another Kamailio instance, making also sure that
+   those Kamailio nstances are not going to generate overalapping dialog
+   hash id values by using different h_id_start and the same h_id_step
+   (h_id_step has to be greater than the maximum value of h_id_start).
 
    Default value is “1”.
 
@@ -1388,6 +1391,7 @@ modparam("dialog", "h_id_step", 10)
    7.17. dlg_remote_profile(cmd, profile, value, uid, expires)
    7.18. dlg_set_ruri()
    7.19. dlg_db_load_callid(cival)
+   7.20. dlg_db_load_extra()
 
 7.1.  set_dlg_profile(profile,[value])
 
@@ -1792,6 +1796,25 @@ if(has_totag()) {
 }
 ...
 
+7.20.  dlg_db_load_extra()
+
+   Load all dialog records from database that are not in memory of the
+   current Kamailio instance.
+
+   This function can be used from ANY_ROUTE.
+
+   Example 1.80. dlg_db_load_extra() usage
+...
+if(has_totag()) {
+    if(!is_known_dlg()) {
+        dlg_db_load_extra();
+            if(!is_known_dlg()) {
+            xlog("no dialog found with callid: $ci\n");
+        }
+    }
+}
+...
+
 8. Statistics
 
    8.1. active_dialogs