Module: kamailio
Branch: master
Commit: 3d6fecc6bc6d52f56d0fdd4e075a15032da91421
URL: 
https://github.com/kamailio/kamailio/commit/3d6fecc6bc6d52f56d0fdd4e075a15032da91421

Author: Daniel-Constantin Mierla <mico...@gmail.com>
Committer: Daniel-Constantin Mierla <mico...@gmail.com>
Date: 2023-12-29T09:55:33+01:00

siputils: docs for tel2sip2() function

---

Modified: src/modules/siputils/doc/siputils_admin.xml

---

Diff:  
https://github.com/kamailio/kamailio/commit/3d6fecc6bc6d52f56d0fdd4e075a15032da91421.diff
Patch: 
https://github.com/kamailio/kamailio/commit/3d6fecc6bc6d52f56d0fdd4e075a15032da91421.patch

---

diff --git a/src/modules/siputils/doc/siputils_admin.xml 
b/src/modules/siputils/doc/siputils_admin.xml
index 63984c60c67..d2197b1c3f4 100644
--- a/src/modules/siputils/doc/siputils_admin.xml
+++ b/src/modules/siputils/doc/siputils_admin.xml
@@ -539,13 +539,15 @@ if (uri_param_rm("param1")) {
                <para>
                The conversion follows the rules in RFC 3261 section 19.1.6:
                <itemizedlist>
-                <listitem>
-                        <para>Visual separators ( "-", ".", "(", ")" ) are 
removed from tel URI number before converting it to SIP URI userinfo.</para>
+        <listitem>
+                       <para>Visual separators ( "-", ".", "(", ")" ) are 
removed
+                       from tel URI number before converting it to SIP URI 
userinfo.</para>
                </listitem>
                <listitem>
-                       <para>tel URI parameters are downcased before appending 
them to SIP URI userinfo</para>
-                </listitem>
-                </itemizedlist>
+                       <para>tel URI parameters are downcased before appending 
them
+                       to SIP URI userinfo</para>
+        </listitem>
+        </itemizedlist>
                </para>
                <para>
                The SIP URI hostpart is taken from second param
@@ -569,6 +571,36 @@ tel2sip("$ru", $fd", "$ru");
 tel2sip("$ru", $fd", "$ru");
 # $ru:  sip:+12345678;ext=200;isub=+123-...@foo.com;user=phone
 ...
+</programlisting>
+               </example>
+       </section>
+       <section id="siputils.f.tel2sip2">
+               <title>
+               <function moreinfo="none">tel2sip2(uri, hostpart, 
result)</function>
+               </title>
+               <para>
+               Alternative to sip2tel() function that tries to follow closer 
the RFC
+               requrements (e.g., sort tel: uri parameters copied to the sip: 
uri in
+               the manner defined in the standard; deletes the phone-context 
parameter
+               if it is a domain, and, takes visual separators from the 
phone-context
+               parameter if it is a telephone number).
+               </para>
+               <para>
+               Its parameters have the same meaning as for tel2sip().
+               </para>
+               <para>
+               This function can be used from REQUEST_ROUTE, FAILURE_ROUTE,
+               BRANCH_ROUTE, or ONREPLY_ROUTE.
+               </para>
+               <example>
+               <title><function>tel2sip2</function> usage</title>
+               <programlisting format="linespecific">
+...
+# $ru: tel:+(34)-999-888-777
+# $fu: sip:t...@foo.com
+tel2sip2("$ru", $fd", "$ru");
+# $ru:  sip:+34999888...@foo.com;user=phone
+...
 </programlisting>
                </example>
        </section>

_______________________________________________
Kamailio (SER) - Development Mailing List
To unsubscribe send an email to sr-dev-le...@lists.kamailio.org

Reply via email to