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

Author: Daniel-Constantin Mierla <[email protected]>
Committer: Daniel-Constantin Mierla <[email protected]>
Date: 2025-10-23T22:05:31+02:00

dialog: docs - note about vars set before dialog creation

---

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

---

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

---

diff --git a/src/modules/dialog/doc/dialog_admin.xml 
b/src/modules/dialog/doc/dialog_admin.xml
index 57aca666f80..0dcdcf7bb71 100644
--- a/src/modules/dialog/doc/dialog_admin.xml
+++ b/src/modules/dialog/doc/dialog_admin.xml
@@ -3404,15 +3404,23 @@ kamctl rpc dlg.briefing "ft"
                        <title><varname>$dlg_var(key)</varname></title>
                        <para>
                        This is a read/write variable that can be used to store
-                       custom values assigned with a dialog (e.g. the URI of a
-                       billing-server, an assigned emergency-server).
-                       This pseudo-variable will be available only for 
subsequential
-                       requests after doing loose_route().
+                       custom values associated to a dialog (e.g. the URI of a
+                       billing-server, an assigned emergency-server). The 
value has to
+                       be a string. This pseudo-variable will be available for 
subsequential
+                       requests only after loose_route() or dlg_manage().
                        </para>
                        <para>
-                       Note: You will receive "NULL", if there is no dialog 
for this
+                       Note: "NULL" is returned, if there is no dialog for this
                        request.
                        </para>
+                       <para>
+                       Note: dialog variables set before the dialog is created 
for the
+                       initial INVITE can be associated to the dialog only 
when the dialog
+                       is created by the same Kamailio process. They are lost 
if the
+                       variables are set in a process that calls an 
asynchronous function
+                       that resumes the processing in another process, which 
then creates
+                       the dialog.
+                       </para>
                </section>
 
        </section>

_______________________________________________
Kamailio - Development Mailing List -- [email protected]
To unsubscribe send an email to [email protected]
Important: keep the mailing list in the recipients, do not reply only to the 
sender!

Reply via email to