kenmirrors/asterisk
1
0
Fork 0
mirror of https://github.com/asterisk/asterisk.git synced 2025-10-31 10:47:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

pjsip: Add PJSIP_PARSE_URI_FROM dialplan function.

Browse Source 
Various SIP headers permit a URI to be prefaced with a `display-name`
production that can include characters (like commas and parentheses)
that are problematic for Asterisk's dialplan parser and, specifically
in the case of this patch, the PJSIP_PARSE_URI function.

This patch introduces a new function - `PJSIP_PARSE_URI_FROM` - that
behaves identically to `PJSIP_PARSE_URI` except that the first
argument is now a variable name and not a literal URI.

Fixes #756

(cherry picked from commit 5068cc814f)
This commit is contained in:
Sean Bright
2024-06-02 12:51:07 -04:00
committed by Asterisk Development Team
parent 9afc995824
commit d18159a008
3 changed files with 96 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

63
channels/pjsip/dialplan_functions_doc.xml
View File

@@ -223,7 +223,7 @@
<version>17.0.0</version>
</since>
<synopsis>
Parse an uri and return a type part of the URI.
Parse a URI and return a type part of the URI.
</synopsis>
<syntax>
<parameter name="uri" required="true">
@@ -272,7 +272,66 @@
</parameter>
</syntax>
<description>
<para>Parse an URI and return a specified part of the URI.</para>
<para>Parse a URI and return a specified part of the URI.</para>
</description>
</function>
<function name="PJSIP_PARSE_URI_FROM" language="en_US">
<since>
<version>18.24.0</version>
<version>20.9.0</version>
<version>21.4.0</version>
</since>
<synopsis>
Parse the contents of a variable as a URI and return a type part of the URI.
</synopsis>
<syntax>
<parameter name="uri" required="true">
<para>Name of a variable that contains a URI to parse</para>
</parameter>
<parameter name="type" required="true">
<para>The <literal>type</literal> parameter specifies which URI part to read</para>
<enumlist>
<enum name="display">
<para>Display name.</para>
</enum>
<enum name="scheme">
<para>URI scheme.</para>
</enum>
<enum name="user">
<para>User part.</para>
</enum>
<enum name="passwd">
<para>Password part.</para>
</enum>
<enum name="host">
<para>Host part.</para>
</enum>
<enum name="port">
<para>Port number, or zero.</para>
</enum>
<enum name="user_param">
<para>User parameter.</para>
</enum>
<enum name="method_param">
<para>Method parameter.</para>
</enum>
<enum name="transport_param">
<para>Transport parameter.</para>
</enum>
<enum name="ttl_param">
<para>TTL param, or -1.</para>
</enum>
<enum name="lr_param">
<para>Loose routing param, or zero.</para>
</enum>
<enum name="maddr_param">
<para>Maddr param.</para>
</enum>
</enumlist>
</parameter>
</syntax>
<description>
<para>Parse the contents of the provided variable as a URI and return a specified part of the URI.</para>
</description>
</function>