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

[Henning Westerholt]

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

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

uac: document limitation regarding uac_replace_* with loose_route and msg_apply_changes

---

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

---

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

---

diff --git a/src/modules/uac/doc/uac_admin.xml b/src/modules/uac/doc/uac_admin.xml
index fe4046a733..6e514eeea1 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>