Module: kamailio Branch: master Commit: b0a776b31220fc5e8599288b14ddb9ffccb24c0f URL: https://github.com/kamailio/kamailio/commit/b0a776b31220fc5e8599288b14ddb9ff...
Author: Daniel-Constantin Mierla miconda@gmail.com Committer: Daniel-Constantin Mierla miconda@gmail.com Date: 2015-07-31T18:40:31+02:00
registrar: updated the docs for registered(...) function
---
Modified: modules/registrar/README Modified: modules/registrar/doc/registrar_admin.xml
---
Diff: https://github.com/kamailio/kamailio/commit/b0a776b31220fc5e8599288b14ddb9ff... Patch: https://github.com/kamailio/kamailio/commit/b0a776b31220fc5e8599288b14ddb9ff...
---
diff --git a/modules/registrar/README b/modules/registrar/README index e3f5a7f..8756816 100644 --- a/modules/registrar/README +++ b/modules/registrar/README @@ -891,15 +891,16 @@ lookup_branches("location");
4.4. registered(domain [, uri [, match_option [, match_action]]])
- The function returns true if the AOR in the Request-URI is registered, - false otherwise. The function does not modify the message being - process, it neither rewrites the Request-URI if a contact is found nor - append branches. + The function returns true if the AOR in the URI is registered, false + otherwise. The function does not modify the message being process, it + neither rewrites the Request-URI if a contact is found nor append + branches. If uri parameter is not provided, then it considered to be + the Request-URI for SIP requests and To-URI for SIP replies.
Meaning of the parameters is as follows: * domain - Name of table that should be used for the lookup. - * uri (optional) - SIP URI to do be used instead of R-URI. It can be - a dynamic string with pseudo-variables. + * uri (optional) - SIP URI to do be used instead of Request/To-URI. + It can be a dynamic string with pseudo-variables. * match_option (optional) - flag parameter to restrict contact search. use reg_xavp_cfg to set the values to compare to. flag values is as follows: @@ -911,7 +912,7 @@ lookup_branches("location"); flag values is as follows: + 1 - set xavp_rcd with value from matched contact
- This function can be used from REQUEST_ROUTE, FAILURE_ROUTE. + This function can be used from ANY_ROUTE.
Example 1.31. registered usage ... diff --git a/modules/registrar/doc/registrar_admin.xml b/modules/registrar/doc/registrar_admin.xml index 672cee8..f1c7063 100644 --- a/modules/registrar/doc/registrar_admin.xml +++ b/modules/registrar/doc/registrar_admin.xml @@ -1110,10 +1110,12 @@ lookup_branches("location"); <function moreinfo="none">registered(domain [, uri [, match_option [, match_action]]])</function> </title> <para> - The function returns true if the AOR in the Request-URI is + The function returns true if the AOR in the URI is registered, false otherwise. The function does not modify the message being process, it neither rewrites the Request-URI if a - contact is found nor append branches. + contact is found nor append branches. If uri parameter is not + provided, then it considered to be the Request-URI for SIP requests + and To-URI for SIP replies. </para> <para>Meaning of the parameters is as follows:</para> <itemizedlist> @@ -1126,7 +1128,7 @@ lookup_branches("location"); <listitem> <para> <emphasis>uri</emphasis> (optional) - SIP URI to do be used instead - of R-URI. It can be a dynamic string with pseudo-variables. + of Request/To-URI. It can be a dynamic string with pseudo-variables. </para> </listitem> <listitem> @@ -1160,7 +1162,7 @@ lookup_branches("location"); </listitem> </itemizedlist> <para> - This function can be used from REQUEST_ROUTE, FAILURE_ROUTE. + This function can be used from ANY_ROUTE. </para> <example> <title><function>registered</function> usage</title>
-
Daniel-Constantin Mierla