[sr-dev] git:4.2:de215078: tm: extended docs for t_reply()

Daniel-Constantin Mierla miconda at gmail.com
Wed Jul 29 12:38:38 CEST 2015


Module: kamailio
Branch: 4.2
Commit: de21507868af81ef3155e6de4b1e788058578459
URL: https://github.com/kamailio/kamailio/commit/de21507868af81ef3155e6de4b1e788058578459

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date: 2015-07-29T12:31:00+02:00

tm: extended docs for t_reply()

(cherry picked from commit a221ec34074c25838f470070cb6c7e604a33fc98)
(cherry picked from commit f050389b568aaab3717484b67b9b157199c63bbc)

---

Modified: modules/tm/README
Modified: modules/tm/doc/functions.xml

---

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

---

diff --git a/modules/tm/README b/modules/tm/README
index 892f778..cbf7de9 100644
--- a/modules/tm/README
+++ b/modules/tm/README
@@ -1721,7 +1721,7 @@ failure_route[1] {
    deciding if the transaction is complete. In the referred block, you can
    start a new branch which is required for failover of multiple outbound
    flows (RFC 5626). Note that the set of commands which are usable within
-   a branch_failure route is limited to a subset of the failure_rotue
+   a branch_failure route is limited to a subset of the failure_route
    commands including logging, rewriting URI and initiating new branches.
    Any other commands may generate errors or result in unpredictable
    behavior. Note that whenever failure_route is entered, uri is reset to
@@ -1822,6 +1822,17 @@ if (t_newtran()) {
    Sends a stateful reply after a transaction has been established. See
    t_newtran for usage.
 
+   If the code is in the range 300-399 (redirect reply), the current
+   destination set is appended to the reply as Contact headers. The
+   destination set contains the request URI (R-URI), if it is modified
+   compared to the received one, plus the branches added to the request
+   (e.g., after an append_branch() or lookup("location")). If the R-URI
+   was changed but it is not desired to be part of the destination set, it
+   can be reverted using the function revert_uri().
+
+   Custom headers to the reply can be added using append_to_reply()
+   function from textops module.
+
    Meaning of the parameters is as follows:
      * code - Reply code number.
      * reason_phrase - Reason string.
diff --git a/modules/tm/doc/functions.xml b/modules/tm/doc/functions.xml
index af7d11d..e2da84c 100644
--- a/modules/tm/doc/functions.xml
+++ b/modules/tm/doc/functions.xml
@@ -326,6 +326,19 @@ if (t_newtran()) {
 	    Sends a stateful reply after a transaction has been
 	    established. See <function>t_newtran</function> for usage.
 	</para>
+	<para>
+		If the code is in the range 300-399 (redirect reply), the current
+		destination set is appended to the reply as Contact headers.
+		The destination set contains the request URI (R-URI), if it is
+		modified compared to the received one, plus the branches added to the
+		request (e.g., after an append_branch() or lookup("location")).
+		If the R-URI was changed but it is not desired to be part of the
+		destination set, it can be reverted using the function revert_uri().
+	</para>
+	<para>
+		Custom headers to the reply can be added using append_to_reply()
+		function from textops module.
+	</para>
 	<para>Meaning of the parameters is as follows:</para>
 	<itemizedlist>
 	    <listitem>




More information about the sr-dev mailing list