From b27475511756b04fe4d4ee5f76bcc14e4186bc58 Mon Sep 17 00:00:00 2001
From: Kamailio Dev <kamailio.dev@kamailio.org>
Date: Wed, 4 Apr 2018 09:01:55 +0200
Subject: [PATCH] modules: readme files regenerated - dialog ... [skip ci]

---
 src/modules/dialog/README | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/modules/dialog/README b/src/modules/dialog/README
index 506e066948f..597e06efd14 100644
--- a/src/modules/dialog/README
+++ b/src/modules/dialog/README
@@ -127,6 +127,7 @@ Olle E. Johansson
               7.16. dlg_set_property(attr)
               7.17. dlg_remote_profile(cmd, profile, value, uid, expires)
               7.18. dlg_set_ruri()
+              7.19. dlg_db_load_callid(cival)
 
         8. Statistics
 
@@ -251,6 +252,7 @@ Olle E. Johansson
    1.74. dlg_set_property usage
    1.75. dlg_remote_profile usage
    1.76. dlg_set_ruri() usage
+   1.77. dlg_db_load_callid() usage
 
 Chapter 1. Admin Guide
 
@@ -346,6 +348,7 @@ Chapter 1. Admin Guide
         7.16. dlg_set_property(attr)
         7.17. dlg_remote_profile(cmd, profile, value, uid, expires)
         7.18. dlg_set_ruri()
+        7.19. dlg_db_load_callid(cival)
 
    8. Statistics
 
@@ -1342,6 +1345,7 @@ end
    7.16. dlg_set_property(attr)
    7.17. dlg_remote_profile(cmd, profile, value, uid, expires)
    7.18. dlg_set_ruri()
+   7.19. dlg_db_load_callid(cival)
 
 7.1.  set_dlg_profile(profile,[value])
 
@@ -1727,6 +1731,25 @@ if(has_totag() and is_present_hf("Route") and uri==myself ) {
 }
 ...
 
+7.19.  dlg_db_load_callid(cival)
+
+   Load dialog record from database matching on Call-Id provided as
+   parameter.
+
+   This function can be used from ANY_ROUTE.
+
+   Example 1.77. dlg_db_load_callid() usage
+...
+if(has_totag()) {
+    if(!is_known_dlg()) {
+        dlg_db_load_callid("$ci");
+            if(!is_known_dlg()) {
+            xlog("no dialog found with callid: $ci\n");
+        }
+    }
+}
+...
+
 8. Statistics
 
    8.1. active_dialogs