From d867d8abfd503a2e7d979d4979d2b0a209d5c430 Mon Sep 17 00:00:00 2001
From: Daniel-Constantin Mierla <miconda@gmail.com>
Date: Wed, 2 May 2018 12:18:57 +0200
Subject: [PATCH] sipcapture: docs for sip_capture_forward(uri)

---
 .../sipcapture/doc/sipcapture_admin.xml       | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/src/modules/sipcapture/doc/sipcapture_admin.xml b/src/modules/sipcapture/doc/sipcapture_admin.xml
index 5f7055a4b65..0dbfafae963 100644
--- a/src/modules/sipcapture/doc/sipcapture_admin.xml
+++ b/src/modules/sipcapture/doc/sipcapture_admin.xml
@@ -648,6 +648,36 @@ report_capture("report_data", "$ci", "{\"MOS\":4.1,\"PACKET_LOST\":100"});
 ...
 $var(res) = float2int("10.5", "1");
 ...
+</programlisting>
+		</example>
+	</section>
+	<section id="sipcapture.f.sip_capture_forward">
+		<title>
+		<function moreinfo="none">sip_capture_forward(uri)</function>
+		</title>
+		<para>
+		Forward the HEP packet to an address specified by the parameter uri
+		(it has to be a sip uri format). The function should be used inside
+		event_route[sipcapture:request]. After using this function, add a
+		return 0 in order to stop processing further the packet in the local
+		&kamailio; instance.
+		</para>
+		<para>
+		This function can be used from ANY_ROUTE.
+		</para>
+		<example>
+		<title><function>sip_capture_forward()</function> usage</title>
+		<programlisting format="linespecific">
+...
+    event_route[sipcapture:request] {
+        ...
+        if(src_ip==1.2.3.4) {
+            sip_capture_forward("sip:2.3.4.5:5090");
+            return 0;
+        }
+        ...
+    }
+...
 </programlisting>
 		</example>
 	</section>