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

Author: Federico Cabiddu <federico.cabi...@gmail.com>
Committer: Federico Cabiddu <federico.cabi...@gmail.com>
Date: 2019-02-06T17:17:17+01:00

http_async_client: add documentation for new TCP keepalive parameters

---

Modified: src/modules/http_async_client/doc/http_async_client_admin.xml

---

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

---

diff --git a/src/modules/http_async_client/doc/http_async_client_admin.xml 
b/src/modules/http_async_client/doc/http_async_client_admin.xml
index 605964e268..73fdf32841 100644
--- a/src/modules/http_async_client/doc/http_async_client_admin.xml
+++ b/src/modules/http_async_client/doc/http_async_client_admin.xml
@@ -291,6 +291,63 @@ modparam("http_async_client", "tls_client_key", 
"/etc/kamailio/ssl/clientcert.ke
 ...
 modparam("http_async_client", "tls_ca_path", "/etc/kamailio/ssl/ca/")
 ...
+</programlisting>
+               </example>
+       </section>
+       <section>
+               <title><varname>tcp_keepalive</varname> (integer)</title>
+        <para>
+                   If defined to a non-zero value, TCP keepalive will be 
enabled on cURL connections.
+               </para>
+               <para>
+               <emphasis>
+                       Default value is 0 (disabled).
+               </emphasis>
+               </para>
+               <example>
+               <title>Set <varname>tcp_keepalive</varname> parameter</title>
+               <programlisting format="linespecific">
+...
+modparam("http_async_client", "tcp_keepalive", 1)
+...
+</programlisting>
+               </example>
+       </section>
+       <section>
+               <title><varname>tcp_ka_idle</varname> (integer)</title>
+        <para>
+                       TCP keep-alive idle time wait value (in seconds).
+               </para>
+               <para>
+               <emphasis>
+                       Default value is 0 (use cURL default value, 60s).
+               </emphasis>
+               </para>
+               <example>
+               <title>Set <varname>tcp_ka_idle</varname> parameter</title>
+               <programlisting format="linespecific">
+...
+modparam("http_async_client", "tcp_ka_idle", 30)
+...
+</programlisting>
+               </example>
+       </section>
+       <section>
+               <title><varname>tcp_ka_interval</varname> (integer)</title>
+        <para>
+                       TCP keep-alive interval (in seconds).
+               </para>
+               <para>
+               <emphasis>
+                       Default value is 0 (use cURL default value, 60s).
+               </emphasis>
+               </para>
+               <example>
+               <title>Set <varname>tcp_ka_interval</varname> parameter</title>
+               <programlisting format="linespecific">
+...
+modparam("http_async_client", "tcp_ka_interval", 120)
+...
 </programlisting>
                </example>
        </section>
@@ -397,6 +454,9 @@ xlog("L_INFO", "received reply for query $http_req_id\n");
                <listitem><para><emphasis>username</emphasis>: sets the 
username to use for authenticated requests</para></listitem>
                <listitem><para><emphasis>password</emphasis>: sets the 
password to use for authenticated requests</para></listitem>
                <listitem><para><emphasis>suspend</emphasis>: if set to 0 it 
doesn't suspend the current transaction before performing the 
query</para></listitem>
+               <listitem><para><emphasis>tcp_keepalive</emphasis>: enable TCP 
keepalive</para></listitem>
+               <listitem><para><emphasis>tcp_ka_idle</emphasis>: set TCP 
keepalive idle time wait</para></listitem>
+               <listitem><para><emphasis>tcp_ka_interval</emphasis>: set TCP 
keepalive interval</para></listitem>
        </itemizedlist>
        <example>
                <title><literal>$http_req(key)</literal> variable usage</title>


_______________________________________________
Kamailio (SER) - Development Mailing List
sr-dev@lists.kamailio.org
https://lists.kamailio.org/cgi-bin/mailman/listinfo/sr-dev

Reply via email to