Skip to content

Commit

Permalink
path: note in docs that some registrars check for supported header
Browse files Browse the repository at this point in the history
  • Loading branch information
miconda committed Feb 9, 2017
1 parent e53bc78 commit bbf51ef
Showing 1 changed file with 15 additions and 5 deletions.
20 changes: 15 additions & 5 deletions src/modules/path/doc/path_admin.xml
Expand Up @@ -10,9 +10,9 @@
<!-- Module User's Guide -->

<chapter>

<title>&adminguide;</title>

<section>
<title>Overview</title>
<para>
Expand All @@ -22,9 +22,9 @@
for evaluating this parameter in subsequent requests and to set the destination &uri; according to it.
</para>
<section>
<title>Path insertion for registrations</title>
<title>Path Insertion For Registrations</title>
<para>
For registrations in a scenario like <quote>[UAC] -> [P1] -> [REG]</quote>,
For registrations in a scenario like <quote>[UAC] -> [P1] -> [REG]</quote>,
the "path" module can be used at the intermediate proxy P1 to insert a Path
header into the message before forwarding it to the registrar REG. Two functions
can be used to achieve this:
Expand All @@ -46,7 +46,7 @@
<para>
<emphasis>add_path_received(...)</emphasis> also add a Path header in the
same form as above, but also adds a parameter indicating the received-&uri;
of the message, like
of the message, like
<quote>Path: &lt;sip:1.2.3.4;received=sip:2.3.4.5:1234;lr&gt;</quote>. This
is especially useful if the proxy does NAT detection and wants to pass
the NAT'ed address to the registrar.
Expand All @@ -58,7 +58,17 @@
</itemizedlist>
</para>
<para>
Note that some SIP registrars may check if header Supported includes 'path'. It
can be added in &kamailio;.cfg using append_hf() from textops module.
</para>
<example>
<title>Add Supported header</title>
<programlisting format="linespecific">
...
append_hf("Supported: path\r\n");
...
</programlisting>
</example>
</section>
<section>
<title>Outbound routing to NAT'ed UACs</title>
Expand Down

0 comments on commit bbf51ef

Please sign in to comment.