[sr-dev] git:5.1:b0a9b150: uac: document limitation regarding uac_replace_* with loose_route and msg_apply_changes

[Henning Westerholt]

Module: kamailio
Branch: 5.1
Commit: b0a9b1509c08af68e13ee5cef1214ae416d4c542
URL: https://github.com/kamailio/kamailio/commit/b0a9b1509c08af68e13ee5cef1214ae416d4c542

Author: Henning Westerholt <hw at kamailio.org>
Committer: Henning Westerholt <hw at kamailio.org>
Date: 2019-04-03T09:06:45+02:00

uac: document limitation regarding uac_replace_* with loose_route and msg_apply_changes

(cherry picked from commit 05696125b775d3c275b2516ae34e73b91ce51c9a)

---

Modified: src/modules/uac/doc/uac_admin.xml

---

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

---

diff --git a/src/modules/uac/doc/uac_admin.xml b/src/modules/uac/doc/uac_admin.xml
index 78b8f5615b..94a703218f 100644
--- a/src/modules/uac/doc/uac_admin.xml
+++ b/src/modules/uac/doc/uac_admin.xml
@@ -54,6 +54,16 @@
 				SIP request. Try to save needed changes in a pseudovariable and
 				apply them once.
 			</para>
+			<para>
+				There is also a limitation regarding the use of the
+				<quote>msg_apply_changes()</quote> function together with the
+				<quote>uac_replace_*</quote> functions for messages that are
+				loose-routed (e.g. Re-INVITE requests). In this case you need
+				to call the <quote>loose_route()</quote> function after the
+				replace and msg_apply_changes. Otherwise Kamailio can create
+				replies with wrong From/To headers (e.g. for the 100 - Trying
+				reply in the Re-INVITE example).
+			</para>
 			</listitem>
 		</itemizedlist>
 	</section>