res_pjsip_session: Add ability to accept multiple sdp answers
[asterisk/asterisk.git] / res / res_pjsip.c
index b6a736b..9a6b310 100644 (file)
                                                changes.  If not set, incoming MWI NOTIFYs are ignored.
                                        </para></description>
                                </configOption>
+                               <configOption name="follow_early_media_fork">
+                                       <synopsis>Follow SDP forked media when To tag is different</synopsis>
+                                       <description><para>
+                                               On outgoing calls, if the UAS responds with different SDP attributes
+                                               on subsequent 18X or 2XX responses (such as a port update) AND the
+                                               To tag on the subsequent response is different than that on the previous
+                                               one, follow it. This usually happens when the INVITE is forked to multiple
+                                               UASs and more than one sends an SDP answer.
+                                               </para>
+                                               <note><para>
+                                                       This option must also be enabled in the <literal>system</literal>
+                                                       section for it to take effect here.
+                                               </para></note>
+                                       </description>
+                               </configOption>
+                               <configOption name="accept_multiple_sdp_answers" default="no">
+                                       <synopsis>Accept multiple SDP answers on non-100rel responses</synopsis>
+                                       <description><para>
+                                               On outgoing calls, if the UAS responds with different SDP attributes
+                                               on non-100rel 18X or 2XX responses (such as a port update) AND the
+                                               To tag on the subsequent response is the same as that on the previous one,
+                                               process the updated SDP.  This can happen when the UAS needs to change ports
+                                               for some reason such as using a separate port for custom ringback.
+                                               </para>
+                                               <note><para>
+                                                       This option must also be enabled in the <literal>system</literal>
+                                                       section for it to take effect here.
+                                               </para></note>
+                                       </description>
+                               </configOption>
                        </configObject>
                        <configObject name="auth">
                                <synopsis>Authentication type</synopsis>
                                                request is too large.  See RFC 3261 section 18.1.1.
                                        </para></description>
                                </configOption>
+                               <configOption name="follow_early_media_fork">
+                                       <synopsis>Follow SDP forked media when To tag is different</synopsis>
+                                       <description><para>
+                                               On outgoing calls, if the UAS responds with different SDP attributes
+                                               on subsequent 18X or 2XX responses (such as a port update) AND the
+                                               To tag on the subsequent response is different than that on the previous
+                                               one, follow it.
+                                               </para>
+                                               <note><para>
+                                                       This option must also be enabled on endpoints that require
+                                                       this functionality.
+                                               </para></note>
+                                       </description>
+                               </configOption>
+                               <configOption name="accept_multiple_sdp_answers">
+                                       <synopsis>Follow SDP forked media when To tag is the same</synopsis>
+                                       <description><para>
+                                               On outgoing calls, if the UAS responds with different SDP attributes
+                                               on non-100rel 18X or 2XX responses (such as a port update) AND the
+                                               To tag on the subsequent response is the same as that on the previous one,
+                                               process the updated SDP.
+                                               </para>
+                                               <note><para>
+                                                       This option must also be enabled on endpoints that require
+                                                       this functionality.
+                                               </para></note>
+                                       </description>
+                               </configOption>
                                <configOption name="type">
                                        <synopsis>Must be of type 'system'.</synopsis>
                                </configOption>