res_rtp_asterisk: Correct default in sample configuration file.
[asterisk/asterisk.git] / configs / samples / rtp.conf.sample
1 ;
2 ; RTP Configuration
3 ;
4 [general]
5 ;
6 ; RTP start and RTP end configure start and end addresses
7 ;
8 ; Defaults are rtpstart=5000 and rtpend=31000
9 ;
10 rtpstart=10000
11 rtpend=20000
12 ;
13 ; Whether to enable or disable UDP checksums on RTP traffic
14 ;
15 ;rtpchecksums=no
16 ;
17 ; The amount of time a DTMF digit with no 'end' marker should be
18 ; allowed to continue (in 'samples', 1/8000 of a second)
19 ;
20 ;dtmftimeout=3000
21 ; rtcpinterval = 5000   ; Milliseconds between rtcp reports
22                         ;(min 500, max 60000, default 5000)
23 ;
24 ; Enable strict RTP protection. This will drop RTP packets that
25 ; do not come from the source of the RTP stream. This option is
26 ; enabled by default.
27 ; strictrtp=yes
28 ;
29 ; Number of packets containing consecutive sequence values needed
30 ; to change the RTP source socket address. This option only comes
31 ; into play while using strictrtp=yes. Consider changing this value
32 ; if rtp packets are dropped from one or both ends after a call is
33 ; connected. This option is set to 4 by default.
34 ; probation=8
35 ;
36 ; Whether to enable or disable ICE support. This option is enabled by default.
37 ; icesupport=false
38 ;
39 ; Hostname or address for the STUN server used when determining the external
40 ; IP address and port an RTP session can be reached at. The port number is
41 ; optional. If omitted the default value of 3478 will be used. This option is
42 ; disabled by default.
43 ;
44 ; e.g. stundaddr=mystun.server.com:3478
45 ;
46 ; stunaddr=
47 ;
48 ; Some multihomed servers have IP interfaces that cannot reach the STUN
49 ; server specified by stunaddr.  Blacklist those interface subnets from
50 ; trying to send a STUN packet to find the external IP address.
51 ; Attempting to send the STUN packet needlessly delays processing incoming
52 ; and outgoing SIP INVITEs because we will wait for a response that can
53 ; never come until we give up on the response.
54 ; * Multiple subnets may be listed.
55 ; * Blacklisting applies to IPv4 only.  STUN isn't needed for IPv6.
56 ; * Blacklisting applies when binding RTP to specific IP addresses and not
57 ; the wildcard 0.0.0.0 address.  e.g., A PJSIP endpoint binding RTP to a
58 ; specific address using the bind_rtp_to_media_address and media_address
59 ; options.  Or the PJSIP endpoint specifies an explicit transport that binds
60 ; to a specific IP address.
61 ;
62 ; e.g. stun_blacklist = 192.168.1.0/255.255.255.0
63 ;      stun_blacklist = 10.32.77.0/255.255.255.0
64 ;
65 ; stun_blacklist =
66 ;
67 ; Hostname or address for the TURN server to be used as a relay. The port
68 ; number is optional. If omitted the default value of 3478 will be used.
69 ; This option is disabled by default.
70 ;
71 ; e.g. turnaddr=myturn.server.com:34780
72 ;
73 ; turnaddr=
74 ;
75 ; Username used to authenticate with TURN relay server.
76 ; turnusername=
77 ;
78 ; Password used to authenticate with TURN relay server.
79 ; turnpassword=
80 ;
81 ; Subnets to exclude from ICE host, srflx and relay discovery. This is useful
82 ; to optimize the ICE process where a system has multiple host address ranges
83 ; and/or physical interfaces and certain of them are not expected to be used
84 ; for RTP. For example, VPNs and local interconnections may not be suitable or
85 ; necessary for ICE. Multiple subnets may be listed. If left unconfigured,
86 ; all discovered host addresses are used.
87 ;
88 ; e.g. ice_blacklist = 192.168.1.0/255.255.255.0
89 ;      ice_blacklist = 10.32.77.0/255.255.255.0
90 ;
91 ; ice_blacklist =
92 ;
93 [ice_host_candidates]
94 ;
95 ; When Asterisk is behind a static one-to-one NAT and ICE is in use, ICE will
96 ; expose the server's internal IP address as one of the host candidates.
97 ; Although using STUN (see the 'stunaddr' configuration option) will provide a
98 ; publicly accessible IP, the internal IP will still be sent to the remote
99 ; peer. To help hide the topology of your internal network, you can override
100 ; the host candidates that Asterisk will send to the remote peer.
101 ;
102 ; IMPORTANT: Only use this functionality when your Asterisk server is behind a
103 ; one-to-one NAT and you know what you're doing. If you do define anything
104 ; here, you almost certainly will NOT want to specify 'stunaddr' or 'turnaddr'
105 ; above.
106 ;
107 ; The format for these overrides is:
108 ;
109 ;    <local address> => <advertised address>
110 ;
111 ; The following will replace 192.168.1.10 with 1.2.3.4 during ICE
112 ; negotiation:
113 ;
114 ;192.168.1.10 => 1.2.3.4
115 ;
116 ; You can define an override for more than 1 interface if you have a multihomed
117 ; server. Any local interface that is not matched will be passed through
118 ; unaltered. Both IPv4 and IPv6 addresses are supported.