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

[Kamailio Dev]

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

Author: Kamailio Dev <kamailio.dev at kamailio.org>
Committer: Kamailio Dev <kamailio.dev at 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/cde68845a9322f0dcd84cf13932e8cbbe6c0d544.diff
Patch: https://github.com/kamailio/kamailio/commit/cde68845a9322f0dcd84cf13932e8cbbe6c0d544.patch

---

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;
+  }
+}
+...