Review Board 1.7.16


XML Config documentation for external_media_address in res_pjsip, transport and endpoint configurations

Review Request #2850 - Created Sept. 12, 2013 and submitted

rnewton
12
ASTERISK-22405
Reviewers
asterisk-dev
Asterisk
Both endpoint and transport config objects have "external_media_address" options. The documentation doesn't currently clarify their behavior.

Mark Michelson described the behavior to me and I've taken his descriptions and used most of them for the help text.

* Modifying synopsis for both options
* Adding description to both options
* Changing name of "external_media_address" for Endpoint configuration to "media_address" in anticipation of the option name being changed. (As it is not really specific to external destinations)

 

Diff revision 1 (Latest)

  1. branches/12/res/res_pjsip.c: Loading...
branches/12/res/res_pjsip.c
Revision 399030 New Change
[20] 205 lines
[+20]
206
								<para>DTMF is sent as SIP INFO packets.</para>
206
								<para>DTMF is sent as SIP INFO packets.</para>
207
							</enum>
207
							</enum>
208
						</enumlist>
208
						</enumlist>
209
					</description>
209
					</description>
210
				</configOption>
210
				</configOption>
211
				<configOption name="external_media_address">
211
				<configOption name="media_address">
212
					<synopsis>IP used for External Media handling</synopsis>
212
					<synopsis>IP address used in SDP for media handling</synopsis>

    
   
213
					<description><para>

    
   
214
						At the time of SDP creation, the IP address defined here will be used as

    
   
215
						the media address for individual streams in the SDP.

    
   
216
					</para><note>

    
   
217
						Be aware that the <literal>external_media_address</literal> option, set in Transport

    
   
218
						configuration, can also affect the final media address used in the SDP.

    
   
219
					</note></description>
213
				</configOption>
220
				</configOption>
214
				<configOption name="force_rport" default="yes">
221
				<configOption name="force_rport" default="yes">
215
					<synopsis>Force use of return port</synopsis>
222
					<synopsis>Force use of return port</synopsis>
216
				</configOption>
223
				</configOption>
217
				<configOption name="ice_support" default="no">
224
				<configOption name="ice_support" default="no">
[+20] [20] 510 lines
[+20]
728
				</configOption>
735
				</configOption>
729
				<configOption name="domain">
736
				<configOption name="domain">
730
					<synopsis>Domain the transport comes from</synopsis>
737
					<synopsis>Domain the transport comes from</synopsis>
731
				</configOption>
738
				</configOption>
732
				<configOption name="external_media_address">
739
				<configOption name="external_media_address">
733
					<synopsis>External Address to use in RTP handling</synopsis>
740
					<synopsis>External IP address to use in RTP handling</synopsis>

    
   
741
					<description><para>

    
   
742
						When a request or response is sent out, if the destination of the

    
   
743
						message is outside the IP network defined in the option <literal>localnet</literal>,

    
   
744
						and the media address in the SDP is within the localnet network, then the

    
   
745
						media address in the SDP will be rewritten to the value defined for

    
   
746
						<literal>external_media_address</literal>.

    
   
747
					</para></description>
734
				</configOption>
748
				</configOption>
735
				<configOption name="external_signaling_address">
749
				<configOption name="external_signaling_address">
736
					<synopsis>External address for SIP signalling</synopsis>
750
					<synopsis>External address for SIP signalling</synopsis>
737
				</configOption>
751
				</configOption>
738
				<configOption name="external_signaling_port" default="0">
752
				<configOption name="external_signaling_port" default="0">
[+20] [20] 1213 lines
  1. branches/12/res/res_pjsip.c: Loading...

https://reviewboard.asterisk.org/ runs on a server provided by Digium, Inc. and uses bandwidth donated to the open source Asterisk community by API Digital Communications in Huntsville, AL USA.
Please report problems with this site to asteriskteam@digium.com.