[sr-dev] git:master:1968b324: usrloc: docs for ka_filter parameter

Module: kamailio Branch: master Commit: 1968b3248acc9d71974f5765e489af82ecf4849a URL: https://github.com/kamailio/kamailio/commit/1968b3248acc9d71974f5765e489af8… Author: Daniel-Constantin Mierla &lt;miconda(a)gmail.com&gt; Committer: Daniel-Constantin Mierla &lt;miconda(a)gmail.com&gt; Date: 2020-03-27T18:06:46+01:00 usrloc: docs for ka_filter parameter --- Modified: src/modules/usrloc/doc/usrloc_admin.xml --- Diff: https://github.com/kamailio/kamailio/commit/1968b3248acc9d71974f5765e489af8… Patch: https://github.com/kamailio/kamailio/commit/1968b3248acc9d71974f5765e489af8… --- diff --git a/src/modules/usrloc/doc/usrloc_admin.xml b/src/modules/usrloc/doc/usrloc_admin.xml index d4f96db94f..7b945a76bb 100644 --- a/src/modules/usrloc/doc/usrloc_admin.xml +++ b/src/modules/usrloc/doc/usrloc_admin.xml @@ -1229,9 +1229,12 @@ modparam("usrloc", "rm_expired_delay", 30) <section id="usrloc.p.server_id_filter"> <title><varname>server_id_filter</varname> (int)</title> <para> - Enable (1) or disable (0) filter records by server_id on load and during cleaning of expired db records. - It could be useful when you want to use the same location table for several kamailio instances which are configured to work in db_mode=1 or db_mode=2 (cache modes). - Otherwise one instance of proxy cleans records made by another proxy and that breaks its cache. + Enable (1) or disable (0) filter records by server_id on load and + during cleaning of expired db records. It could be useful when you + want to use the same location table for several kamailio instances + which are configured to work in db_mode=1 or db_mode=2 (cache modes). + Otherwise one instance of proxy cleans records made by another proxy + and that breaks its cache. </para> <para> <emphasis> @@ -1271,7 +1274,7 @@ modparam("usrloc", "version_table", 0) <title><varname>ka_mode</varname> (int)</title> <para> Keepalive mode - control the internal keepalive mechanism. With this feature - enable, the module sends periodically (based on timer interval) SIP requests + enabled, the module sends periodically (based on timer interval) SIP requests to location contacts and measures the round trip in microseconds (the round trip value can be seen in the response of the RPC command 'ul.dump'). </para> @@ -1286,7 +1289,7 @@ modparam("usrloc", "version_table", 0) </listitem> <listitem> <para> - 1 - if set to 1, the keepalive is enabled for all contacts + 1 (bit 1 set) - if set to 1, the keepalive is enabled for all contacts </para> </listitem> <listitem> @@ -1349,7 +1352,7 @@ modparam("usrloc", "ka_method", "NOTIFY") </example> </section> - <section id="usrloc.p.from"> + <section id="usrloc.p.ka_from"> <title><varname>ka_from</varname> (str)</title> <para> The SIP URI to be set in the From header of the keepalive requests. @@ -1367,7 +1370,7 @@ modparam("usrloc", "ka_from", "sip:server@mydomain.com") </example> </section> - <section id="usrloc.p.domain"> + <section id="usrloc.p.ka_domain"> <title><varname>ka_domain</varname> (str)</title> <para> The domain to be set in To header URI if the multi-domain is not enabled. @@ -1387,6 +1390,40 @@ modparam("usrloc", "ka_domain", "mydomain.com") </example> </section> + <section id="usrloc.p.ka_filter"> + <title><varname>ka_filter</varname> (int)</title> + <para> + Set filters for keepalive processing. + </para> + <para> + Its value is a set of flags: + </para> + <itemizedlist> + <listitem> + <para> + 0 - if the value is zero, no filter is enabled for keepalives + </para> + </listitem> + <listitem> + <para> + 1 (bit 1 set) - keepalives sent only to records matching the + server_id global parameter. + </para> + </listitem> + </itemizedlist> + <para> + Default value is <quote>0</quote> (no filter). + </para> + <example> + <title><varname>ka_filter</varname> parameter usage</title> + <programlisting format="linespecific"> +... +modparam("usrloc", "ka_filter", 1) +... + </programlisting> + </example> + </section> + </section> <section>