Module: kamailio Branch: master Commit: 7284a61125bb0cacd1adc2289af616061df03258 URL: https://github.com/kamailio/kamailio/commit/7284a61125bb0cacd1adc2289af6160… Author: Daniel-Constantin Mierla &lt;miconda(a)gmail.com&gt; Committer: Daniel-Constantin Mierla &lt;miconda(a)gmail.com&gt; Date: 2020-08-24T09:35:19+02:00 keepalive: docs - documented owner parameter for add/delete functions - related to GH #2438 --- Modified: src/modules/keepalive/doc/keepalive_admin.xml --- Diff: https://github.com/kamailio/kamailio/commit/7284a61125bb0cacd1adc2289af6160… Patch: https://github.com/kamailio/kamailio/commit/7284a61125bb0cacd1adc2289af6160… --- diff --git a/src/modules/keepalive/doc/keepalive_admin.xml b/src/modules/keepalive/doc/keepalive_admin.xml index 98e55222ea..5b74c6e4cc 100644 --- a/src/modules/keepalive/doc/keepalive_admin.xml +++ b/src/modules/keepalive/doc/keepalive_admin.xml @@ -169,10 +169,22 @@ if(ka_is_alive("192.168.10.20") == 1) { </section> <section id="keepalive.ka_add_destination"> <title> - <function moreinfo="none">ka_add_destination(sip_uri)</function> + <function moreinfo="none">ka_add_destination(sip_uri, owner)</function> </title> <para> - Adds destination sip/sips uri in memory list to keep alive . + Adds SIP URI in the memory destinations list to perform keep alive to it. + </para> + <para> + Meaning of the parameters: + <itemizedlist> + <listitem>sip_uri (string) - address of destination to monitor. + Valid format is [protoschema:]ip[:port], with: 'protoschema' being + one of 'sip' or 'sips' (SIP over TLS) - if omitted, 'sip'is used + by default; 'port' is optional (using default standard port 5060 + for sip and 5061 for sips)</listitem> + <listitem>owner (string) - module name “owning” the destination + (for informational purpose)</listitem> + </itemizedlist> </para> <para> Returned value: @@ -185,25 +197,38 @@ if(ka_is_alive("192.168.10.20") == 1) { This function can be used from REQUEST_ROUTE,BRANCH_ROUTE,ONREPLY_ROUTE. </para> <example> - <title><function>ka_add_destination(sip_uri)</function> usage</title> + <title><function>ka_add_destination(sip_uri, ownder)</function> usage</title> <programlisting format="linespecific"> ... $avp(duri1)="sip:192.168.1.10:5060;transport=tcp"; $avp(duri2)="sip:192.168.1.11:5061"; $avp(duri3)="sip:192.168.1.12" -ka_add_destination("$avp(duri3)"); -ka_add_destination("sip:192.168.1.10:5060;transport=tcp"); +ka_add_destination("$avp(duri3)", "config"); +ka_add_destination("sip:192.168.1.10:5060;transport=tcp", "config"); ... </programlisting> </example> </section> <section id="keepalive.ka_del_destination"> <title> - <function moreinfo="none">ka_del_destination(sip_uri)</function> + <function moreinfo="none">ka_del_destination(sip_uri, owner)</function> </title> <para> - Deletes destination sip/sips uri in memory list . + Deletes the SIP URI from the memory destinations list used for monitoring. </para> + <para> + Meaning of the parameters: + <itemizedlist> + <listitem>sip_uri (string) - address of monitored destination. + Valid format is [protoschema:]ip[:port], with: 'protoschema' being + one of 'sip' or 'sips' (SIP over TLS) - if omitted, 'sip'is used + by default; 'port' is optional (using default standard port 5060 + for sip and 5061 for sips)</listitem> + <listitem>owner (string) - module name “owning” the destination + (for informational purpose)</listitem> + </itemizedlist> + </para> + <para> Returned value: <itemizedlist> @@ -215,14 +240,14 @@ ka_add_destination("sip:192.168.1.10:5060;transport=tcp"); This function can be used from ANY_ROUTE. </para> <example> - <title><function>ka_del_destination(sip_uri)</function> usage</title> + <title><function>ka_del_destination(sip_uri, owner)</function> usage</title> <programlisting format="linespecific"> ... $avp(duri1)="sip:192.168.1.10:5060;transport=tcp"; $avp(duri2)="sip:192.168.1.11:5061"; $avp(duri3)="sip:192.168.1.12" -ka_del_destination("$avp(duri3)"); -ka_del_destination("sip:192.168.1.10:5060;transport=tcp"); +ka_del_destination("$avp(duri3)", "config"); +ka_del_destination("sip:192.168.1.10:5060;transport=tcp", "config"); ... </programlisting> </example>