From 7ff8f04079fc9c7e6710b43c3e893518f17ef48e Mon Sep 17 00:00:00 2001
From: Daniel-Constantin Mierla <miconda@gmail.com>
Date: Fri, 6 Apr 2018 09:21:56 +0200
Subject: [PATCH] dialog: documented dlg_db_load_extra() function

- related to #1274
---
 src/modules/dialog/doc/dialog_admin.xml | 39 +++++++++++++++++++++----
 1 file changed, 33 insertions(+), 6 deletions(-)

diff --git a/src/modules/dialog/doc/dialog_admin.xml b/src/modules/dialog/doc/dialog_admin.xml
index d231d9a2f6d..5ed51d450de 100644
--- a/src/modules/dialog/doc/dialog_admin.xml
+++ b/src/modules/dialog/doc/dialog_admin.xml
@@ -1552,12 +1552,12 @@ modparam("dialog", "h_id_start", 5)
 			with 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).
+			should be done when 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).
 		</para>
 		<para>
 		<emphasis>
@@ -2281,6 +2281,33 @@ if(has_totag()) {
     }
 }
 ...
+</programlisting>
+		</example>
+	</section>
+	<section id="dialog.f.dlg_db_load_extra">
+		<title>
+		<function moreinfo="none">dlg_db_load_extra()</function>
+		</title>
+		<para>
+		Load all dialog records from database that are not in memory of the
+		current &kamailio; instance.
+		</para>
+		<para>
+		This function can be used from ANY_ROUTE.
+		</para>
+		<example>
+		<title><function>dlg_db_load_extra()</function> usage</title>
+		<programlisting format="linespecific">
+...
+if(has_totag()) {
+    if(!is_known_dlg()) {
+        dlg_db_load_extra();
+	    if(!is_known_dlg()) {
+            xlog("no dialog found with callid: $ci\n");
+        }
+    }
+}
+...
 </programlisting>
 		</example>
 	</section>