Module: sip-router Branch: master Commit: 102074ce6085f963ac03dcb087e1c00941c0337d URL: http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=102074ce...

Author: Daniel-Constantin Mierla miconda@gmail.com Committer: Daniel-Constantin Mierla miconda@gmail.com Date: Sat Sep 14 09:46:50 2013 +0200

tm: readme regenerated

---

modules/tm/README | 120 +++++++++++++++++++++++++++++++--------------------- 1 files changed, 71 insertions(+), 49 deletions(-)

diff --git a/modules/tm/README b/modules/tm/README index 2462d12..6b9e8b5 100644 --- a/modules/tm/README +++ b/modules/tm/README @@ -110,14 +110,15 @@ Juha Heinanen 5.38. t_load_contacts() 5.39. t_next_contacts() 5.40. t_next_contact_flow() - 5.41. t_check_trans() - 5.42. t_set_disable_6xx(0|1) - 5.43. t_set_disable_failover(0|1) - 5.44. t_set_disable_internal_reply(0|1) - 5.45. t_replicate(params) - 5.46. t_relay_to(proxy, flags) - 5.47. t_set_no_e2e_cancel_reason(0|1) - 5.48. t_is_set(target) + 5.41. t_check_status(re) + 5.42. t_check_trans() + 5.43. t_set_disable_6xx(0|1) + 5.44. t_set_disable_failover(0|1) + 5.45. t_set_disable_internal_reply(0|1) + 5.46. t_replicate(params) + 5.47. t_relay_to(proxy, flags) + 5.48. t_set_no_e2e_cancel_reason(0|1) + 5.49. t_is_set(target)

6. TM Module API

@@ -219,15 +220,16 @@ Juha Heinanen 1.76. t_load_contacts usage 1.77. t_next_contacts usage 1.78. t_next_contact_flow usage - 1.79. t_check_trans usage - 1.80. t_set_disable_6xx usage - 1.81. t_set_disable_failover usage - 1.82. t_set_disable_internal_reply usage - 1.83. t_replicate usage + 1.79. t_check_status usage + 1.80. t_check_trans usage + 1.81. t_set_disable_6xx usage + 1.82. t_set_disable_failover usage + 1.83. t_set_disable_internal_reply usage 1.84. t_replicate usage - 1.85. t_set_no_e2e_cancel_reason usage - 1.86. t_replicate usage - 1.87. event_route[tm:branch-failure] usage + 1.85. t_replicate usage + 1.86. t_set_no_e2e_cancel_reason usage + 1.87. t_replicate usage + 1.88. event_route[tm:branch-failure] usage

Chapter 1. Admin Guide

@@ -326,14 +328,15 @@ Chapter 1. Admin Guide 5.38. t_load_contacts() 5.39. t_next_contacts() 5.40. t_next_contact_flow() - 5.41. t_check_trans() - 5.42. t_set_disable_6xx(0|1) - 5.43. t_set_disable_failover(0|1) - 5.44. t_set_disable_internal_reply(0|1) - 5.45. t_replicate(params) - 5.46. t_relay_to(proxy, flags) - 5.47. t_set_no_e2e_cancel_reason(0|1) - 5.48. t_is_set(target) + 5.41. t_check_status(re) + 5.42. t_check_trans() + 5.43. t_set_disable_6xx(0|1) + 5.44. t_set_disable_failover(0|1) + 5.45. t_set_disable_internal_reply(0|1) + 5.46. t_replicate(params) + 5.47. t_relay_to(proxy, flags) + 5.48. t_set_no_e2e_cancel_reason(0|1) + 5.49. t_is_set(target)

6. TM Module API

@@ -1594,14 +1597,15 @@ modparam("tm", "dns_reuse_rcv_socket", 1) 5.38. t_load_contacts() 5.39. t_next_contacts() 5.40. t_next_contact_flow() - 5.41. t_check_trans() - 5.42. t_set_disable_6xx(0|1) - 5.43. t_set_disable_failover(0|1) - 5.44. t_set_disable_internal_reply(0|1) - 5.45. t_replicate(params) - 5.46. t_relay_to(proxy, flags) - 5.47. t_set_no_e2e_cancel_reason(0|1) - 5.48. t_is_set(target) + 5.41. t_check_status(re) + 5.42. t_check_trans() + 5.43. t_set_disable_6xx(0|1) + 5.44. t_set_disable_failover(0|1) + 5.45. t_set_disable_internal_reply(0|1) + 5.46. t_replicate(params) + 5.47. t_relay_to(proxy, flags) + 5.48. t_set_no_e2e_cancel_reason(0|1) + 5.49. t_is_set(target)

5.1. t_relay([host, port])

@@ -2425,7 +2429,25 @@ event_route[tm:branch-failure:outbound] } ...

-5.41. t_check_trans() +5.41. t_check_status(re) + + Returns true if the regular expresion "re" match the reply code of the + response message as follows: + * in routing block - the code of the last sent reply. + * in on_reply block - the code of the current received reply. + * in on_failure block - the code of the selected negative final + reply. + + This function can be used from ANY_ROUTE . + + Example 1.79. t_check_status usage +... +if (t_check_status("(487)|(408)")) { + log("487 or 408 negative reply\n"); +} +... + +5.42. t_check_trans()

t_check_trans() can be used to quickly check if a message belongs or is related to a transaction. It behaves differently for different types of @@ -2470,12 +2492,12 @@ Note

See also: t_lookup_request(), t_lookup_cancel().

- Example 1.79. t_check_trans usage + Example 1.80. t_check_trans usage if ( method == "CANCEL" && !t_check_trans()) sl_reply("403", "cancel out of the blue forbidden"); # note: in this example t_check_trans() can be replaced by t_lookup_cancel()

-5.42. t_set_disable_6xx(0|1) +5.43. t_set_disable_6xx(0|1)

Turn off/on 6xx replies special rfc conformant handling on a per transaction basis. If turned off (t_set_disable_6xx("1")) 6XXs will be @@ -2485,7 +2507,7 @@ if ( method == "CANCEL" && !t_check_trans())

See also: disable_6xx_block.

- Example 1.80. t_set_disable_6xx usage + Example 1.81. t_set_disable_6xx usage ... route { ... @@ -2494,13 +2516,13 @@ route { ... }

-5.43. t_set_disable_failover(0|1) +5.44. t_set_disable_failover(0|1)

Turn off/on dns failover on a per transaction basis.

See also: use_dns_failover.

- Example 1.81. t_set_disable_failover usage + Example 1.82. t_set_disable_failover usage ... route { ... @@ -2509,11 +2531,11 @@ route { ... }

-5.44. t_set_disable_internal_reply(0|1) +5.45. t_set_disable_internal_reply(0|1)

Turn off/on sending internally a SIP reply in case of relay errors.

- Example 1.82. t_set_disable_internal_reply usage + Example 1.83. t_set_disable_internal_reply usage ... t_set_disable_internal_reply(1); # turn off sending internal reply on error if(!t_relay()) { @@ -2521,7 +2543,7 @@ if(!t_relay()) { } ...

-5.45. t_replicate(params) +5.46. t_replicate(params)

Replicate the SIP request to a specific address.

@@ -2543,7 +2565,7 @@ if(!t_relay()) { * hostport - address in "host:port" format. It can be given via an AVP.

- Example 1.83. t_replicate usage + Example 1.84. t_replicate usage ... # sent to 1.2.3.4:5060 over tcp t_replicate("sip:1.2.3.4:5060;transport=tcp"); @@ -2556,7 +2578,7 @@ t_replicate("sip:$var(h);transport=tls"); t_replicate_to_udp("1.2.3.4", "5060"); ...

-5.46. t_relay_to(proxy, flags) +5.47. t_relay_to(proxy, flags)

Forward the SIP request to a specific address, controlling internal behavior via flags. @@ -2577,7 +2599,7 @@ t_replicate_to_udp("1.2.3.4", "5060"); + 0x02 - do not generate reply on internal error. + 0x04 - disable dns failover.

- Example 1.84. t_replicate usage + Example 1.85. t_replicate usage ... # sent to 1.2.3.4:5060 over tcp t_relay_to("tcp:1.2.3.4:5060"); @@ -2589,7 +2611,7 @@ t_relay_to("tls:1.2.3.4"); t_relay_to("0x01"); ...

-5.47. t_set_no_e2e_cancel_reason(0|1) +5.48. t_set_no_e2e_cancel_reason(0|1)

Enables/disables reason header (RFC 3326) copying from the triggering received CANCEL to the generated hop-by-hop CANCEL. 0 enables and 1 @@ -2600,7 +2622,7 @@ t_relay_to("0x01");

See also: e2e_cancel_reason.

- Example 1.85. t_set_no_e2e_cancel_reason usage + Example 1.86. t_set_no_e2e_cancel_reason usage ... route { ... @@ -2610,7 +2632,7 @@ opying ... }

-5.48. t_is_set(target) +5.49. t_is_set(target)

Return true if the attribute specified by 'target' is set for transaction. @@ -2623,7 +2645,7 @@ opying * onreply_route - the function returns true if an onreply route is set to be executed.

- Example 1.86. t_replicate usage + Example 1.87. t_replicate usage ... if(!t_is_set("failure_route")) LM_DBG("no failure route will be executed for current transaction\n"); @@ -2810,7 +2832,7 @@ action *route) enabled with the t_on_branch_failure function. This event_route uses the BRANCH_FAILURE_ROUTE route type.

- Example 1.87. event_route[tm:branch-failure] usage + Example 1.88. event_route[tm:branch-failure] usage ... route { t_on_branch_failure("myroute");