[sr-dev] git:master:b241fc7e: tm: docs - clarifications about event routes

Daniel-Constantin Mierla miconda at gmail.com
Tue Aug 27 09:17:55 CEST 2019


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

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date: 2019-08-27T09:17:18+02:00

tm: docs - clarifications about event routes

---

Modified: src/modules/tm/doc/event_routes.xml

---

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

---

diff --git a/src/modules/tm/doc/event_routes.xml b/src/modules/tm/doc/event_routes.xml
index adda5536ed..b969695c9a 100644
--- a/src/modules/tm/doc/event_routes.xml
+++ b/src/modules/tm/doc/event_routes.xml
@@ -10,20 +10,20 @@
 
     <section id="tm.e.branch-failure">
 	<title>
-	    <function moreinfo="none">event_route[tm:branch-failure]</function>
+	    <function moreinfo="none">event_route[tm:branch-failure:id]</function>
 	</title>
 	<para>
 		Named branch failure routes can be defined to run when when a failure
 		response is received. This allows handling failures on individual
 		branches, for example, retrying an alternative outbound flow.
 	</para>
-        <para>
-			The format of the event_route name is "tm:branch-failure:<name>"
-			and is enabled with the t_on_branch_failure function.
-            This event_route uses the BRANCH_FAILURE_ROUTE route type.
-        </para>
+    <para>
+		The format of the event_route name is "tm:branch-failure:<id>"
+		and is enabled with the t_on_branch_failure function.
+		This event_route uses the BRANCH_FAILURE_ROUTE route type.
+    </para>
 	<example>
-	    <title><function>event_route[tm:branch-failure]</function> usage</title>
+	    <title><function>event_route[tm:branch-failure:id]</function> usage</title>
 	    <programlisting>
 ...
 request_route {
@@ -44,7 +44,17 @@ event_route[tm:branch-failure:myroute] {
 			<function moreinfo="none">event_route[tm:local-request]</function>
 		</title>
 		<para>
-			Executed after the tm module has sent a local generated, transaction stateful request.
+			Executed when the tm module generates a request, in other words,
+			the request originates from &kamailio; and a transaction is created
+			for it. The source of the requests can be tm itself or other modules
+			that use tm internally (e.g., msilo, uac). The event route is executed
+			if it is defined in the native &kamailio; config file. To execute
+			the equivalent callback when using KEMI scripting, see the
+			'event_callback' module parameter.
+		</para>
+		<para>
+			The request can still be updated, i.e., changes are possible to
+			R-URI ($ru), destination URI ($du) or the send socket ($fs).
 		</para>
 		<example>
 			<title><function>event_route[tm:local-request]</function> usage</title>
@@ -63,7 +73,8 @@ event_route [tm:local-request] {
 			<function moreinfo="none">event_route[tm:local-response]</function>
 		</title>
 		<para>
-			Executed after the tm module has sent a local generated, transaction stateful response.
+			Executed when the tm module is about to send a local generated,
+			transaction stateful response.
 		</para>
 		<example>
 			<title><function>event_route[tm:local-response]</function> usage</title>




More information about the sr-dev mailing list