[sr-dev] git:master:0180884c: dialog: documentation for dlg_db_load_callid()

[Daniel-Constantin Mierla]

Module: kamailio
Branch: master
Commit: 0180884c6111b6a1d88fc558acbc801718c011b8
URL: https://github.com/kamailio/kamailio/commit/0180884c6111b6a1d88fc558acbc801718c011b8

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date: 2018-04-04T08:45:25+02:00

dialog: documentation for dlg_db_load_callid()

---

Modified: src/modules/dialog/doc/dialog_admin.xml

---

Diff:  https://github.com/kamailio/kamailio/commit/0180884c6111b6a1d88fc558acbc801718c011b8.diff
Patch: https://github.com/kamailio/kamailio/commit/0180884c6111b6a1d88fc558acbc801718c011b8.patch

---

diff --git a/src/modules/dialog/doc/dialog_admin.xml b/src/modules/dialog/doc/dialog_admin.xml
index ddceb4e634..3a5a348abc 100644
--- a/src/modules/dialog/doc/dialog_admin.xml
+++ b/src/modules/dialog/doc/dialog_admin.xml
@@ -2200,6 +2200,33 @@ if(has_totag() and is_present_hf("Route") and uri==myself ) {
 	}
 }
 ...
+</programlisting>
+		</example>
+	</section>
+	<section id="dialog.f.dlg_db_load_callid">
+		<title>
+		<function moreinfo="none">dlg_db_load_callid(cival)</function>
+		</title>
+		<para>
+		Load dialog record from database matching on Call-Id provided
+		as parameter.
+		</para>
+		<para>
+		This function can be used from ANY_ROUTE.
+		</para>
+		<example>
+		<title><function>dlg_db_load_callid()</function> usage</title>
+		<programlisting format="linespecific">
+...
+if(has_totag()) {
+    if(!is_known_dlg()) {
+        dlg_db_load_callid("$ci");
+	    if(!is_known_dlg()) {
+            xlog("no dialog found with callid: $ci\n");
+        }
+    }
+}
+...
 </programlisting>
 		</example>
 	</section>