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

[Henning Westerholt]

Module: kamailio
Branch: 5.2
Commit: ecb15d3f84185c00450e8ab68df52ffbb9003d83
URL: https://github.com/kamailio/kamailio/commit/ecb15d3f84185c00450e8ab68df52ffbb9003d83

Author: Henning Westerholt <hw at kamailio.org>
Committer: Henning Westerholt <hw at kamailio.org>
Date: 2019-04-03T09:06:38+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/ecb15d3f84185c00450e8ab68df52ffbb9003d83.diff
Patch: https://github.com/kamailio/kamailio/commit/ecb15d3f84185c00450e8ab68df52ffbb9003d83.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>