[sr-dev] git:master:cde68845: modules: readme files regenerated - topoh ... [skip ci]

Module: kamailio Branch: master Commit: cde68845a9322f0dcd84cf13932e8cbbe6c0d544 URL: https://github.com/kamailio/kamailio/commit/cde68845a9322f0dcd84cf13932e8cb… Author: Kamailio Dev <kamailio.dev(a)kamailio.org> Committer: Kamailio Dev <kamailio.dev(a)kamailio.org> Date: 2017-06-15T17:16:22+02:00 modules: readme files regenerated - topoh ... [skip ci] --- Modified: src/modules/topoh/README --- Diff: https://github.com/kamailio/kamailio/commit/cde68845a9322f0dcd84cf13932e8cb… Patch: https://github.com/kamailio/kamailio/commit/cde68845a9322f0dcd84cf13932e8cb… --- diff --git a/src/modules/topoh/README b/src/modules/topoh/README index 213524545c..932aa846b7 100644 --- a/src/modules/topoh/README +++ b/src/modules/topoh/README @@ -35,6 +35,10 @@ Daniel-Constantin Mierla 3.8. callid_prefix (str) 3.9. sanity_checks (integer) + 4. Event Routes + + 4.1. event_route[topoh:msg-outgoing] + List of Examples 1.1. Set mask_key parameter @@ -46,6 +50,7 @@ Daniel-Constantin Mierla 1.7. Set vparam_prefix parameter 1.8. Set callid_prefix parameter 1.9. Set sanity_checks parameter + 1.10. Usage of event_route[topoh:msg-outgoing] Chapter 1. Admin Guide @@ -69,6 +74,10 @@ Chapter 1. Admin Guide 3.8. callid_prefix (str) 3.9. sanity_checks (integer) + 4. Event Routes + + 4.1. event_route[topoh:msg-outgoing] + 1. Overview This module hides the SIP routing headers that show topology details. @@ -226,3 +235,28 @@ modparam("topoh", "callid_prefix", "***") ... modparam("topoh", "sanity_checks", 1) ... + +4. Event Routes + + 4.1. event_route[topoh:msg-outgoing] + +4.1. event_route[topoh:msg-outgoing] + + It is executed before doing topology hiding processing for an outgoing + SIP message. If 'drop' is executed inside the event route, then the + module skips doing the topology hiding. + + Inside the event route the variables $sndto(ip), $sndto(port) and + $sndto(proto) point to the destination. The SIP message is not the one + to be sent out, but an internally generated one at startup, to avoid + reparsing the outgoing SIP message for the cases when topology hiding + is not wanted. + + Example 1.10. Usage of event_route[topoh:msg-outgoing] +... +event_route[topoh:msg-outgoing] { + if($sndto(ip)=="10.1.1.10") { + drop; + } +} +...