(changelog debian)
[asterisk-config-auf.git] / etc-asterisk / iax.conf
1
2 ; Inter-Asterisk eXchange driver definition
3 ;
4 ; This configuration is re-read at reload
5 ; or with the CLI command
6 ;       reload chan_iax2.so
7 ;
8 ; General settings, like port number to bind to, and
9 ; an option address (the default is to bind to all
10 ; local addresses).
11 ;
12 [general]
13 ;bindport=4569                  ; bindport and bindaddr may be specified
14 ;                               ; NOTE: bindport must be specified BEFORE
15                                 ; bindaddr or may be specified on a specific
16                                 ; bindaddr if followed by colon and port
17                                 ;  (e.g. bindaddr=192.168.0.1:4569)
18 ;bindaddr=192.168.0.1           ; more than once to bind to multiple
19 ;                               ; addresses, but the first will be the 
20 ;                               ; default
21 ;
22 ; Set iaxcompat to yes if you plan to use layered switches or
23 ; some other scenario which may cause some delay when doing a
24 ; lookup in the dialplan. It incurs a small performance hit to
25 ; enable it. This option causes Asterisk to spawn a separate thread
26 ; when it receives an IAX DPREQ (Dialplan Request) instead of
27 ; blocking while it waits for a response.
28 ;
29 ;iaxcompat=yes
30 ;
31 ; Disable UDP checksums (if nochecksums is set, then no checkums will
32 ; be calculated/checked on systems supporting this feature)
33 ;
34 ;nochecksums=no
35 ;
36 ;
37 ; For increased security against brute force password attacks
38 ; enable "delayreject" which will delay the sending of authentication
39 ; reject for REGREQ or AUTHREP if there is a password.  
40 ;
41 ;delayreject=yes
42 ;
43 ; You may specify a global default AMA flag for iaxtel calls.  It must be
44 ; one of 'default', 'omit', 'billing', or 'documentation'.  These flags
45 ; are used in the generation of call detail records.
46 ;
47 ;amaflags=default
48 ;
49 ; ADSI (Analog Display Services Interface) can be enabled if you have
50 ; (or may have) ADSI compatible CPE equipment
51 ;
52 ;adsi=no
53 ;
54 ; You may specify a default account for Call Detail Records in addition
55 ; to specifying on a per-user basis
56 ;
57 ;accountcode=lss0101
58 ;
59 ; You may specify a global default language for users. 
60 ; Can be specified also on a per-user basis
61 ; If omitted, will fallback to english
62 ;
63 language=fr
64 ;
65 ; This option specifies a preference for which music on hold class this channel
66 ; should listen to when put on hold if the music class has not been set on the
67 ; channel with Set(CHANNEL(musicclass)=whatever) in the dialplan, and the peer
68 ; channel putting this one on hold did not suggest a music class.
69 ;
70 ; If this option is set to "passthrough", then the hold message will always be
71 ; passed through as signalling instead of generating hold music locally.
72 ;
73 ; This option may be specified globally, or on a per-user or per-peer basis.
74 ;
75 ;mohinterpret=default
76 ;
77 ; This option specifies which music on hold class to suggest to the peer channel
78 ; when this channel places the peer on hold. It may be specified globally or on
79 ; a per-user or per-peer basis.
80 ;
81 ;mohsuggest=default
82 ;
83 ; Specify bandwidth of low, medium, or high to control which codecs are used
84 ; in general.
85 ;
86 ;bandwidth=low
87 ;
88 ; You can also fine tune codecs here using "allow" and "disallow" clauses
89 ; with specific codecs.  Use "all" to represent all formats.
90 ;
91 ;allow=all                      ; same as bandwidth=high
92 ;disallow=g723.1                ; Hm...  Proprietary, don't use it...
93 ;disallow=lpc10                 ; Icky sound quality...  Mr. Roboto.
94 ;allow=gsm                      ; Always allow GSM, it's cool :)
95 ;
96
97 disallow=all
98
99 ; codec audio
100 allow=gsm     ; pour interconnexions
101 allow=ulaw    ; pour postes locaux (ou bonnes connexions)
102 ;allow=ilbc   ; pose des problèmes, pas de translation avec ulaw/gsm
103 ;allow=speex  ; drôles de bruits, à tester à l'occasion
104
105 ; codecs video
106 allow=h261
107 allow=h263
108 allow=h263p
109 allow=h264
110
111 ; You can adjust several parameters relating to the jitter buffer.
112 ; The jitter buffer's function is to compensate for varying
113 ; network delay.
114 ;
115 ; All the jitter buffer settings are in milliseconds.
116 ; The jitter buffer works for INCOMING audio - the outbound audio
117 ; will be dejittered by the jitter buffer at the other end.
118 ;
119 ; jitterbuffer=yes|no: global default as to whether you want
120 ; the jitter buffer at all.
121 ;
122 ; forcejitterbuffer=yes|no: in the ideal world, when we bridge VoIP channels
123 ; we don't want to do jitterbuffering on the switch, since the endpoints
124 ; can each handle this.  However, some endpoints may have poor jitterbuffers 
125 ; themselves, so this option will force * to always jitterbuffer, even in this
126 ; case.
127 ;
128 ; maxjitterbuffer: a maximum size for the jitter buffer.
129 ; Setting a reasonable maximum here will prevent the call delay
130 ; from rising to silly values in extreme situations; you'll hear
131 ; SOMETHING, even though it will be jittery.
132 ;
133 ; resyncthreshold: when the jitterbuffer notices a significant change in delay
134 ; that continues over a few frames, it will resync, assuming that the change in
135 ; delay was caused by a timestamping mix-up. The threshold for noticing a
136 ; change in delay is measured as twice the measured jitter plus this resync
137 ; threshold.
138 ; Resyncing can be disabled by setting this parameter to -1.
139 ;
140 ; maxjitterinterps: the maximum number of interpolation frames the jitterbuffer
141 ; should return in a row. Since some clients do not send CNG/DTX frames to
142 ; indicate silence, the jitterbuffer will assume silence has begun after
143 ; returning this many interpolations. This prevents interpolating throughout
144 ; a long silence.
145 ;
146
147 jitterbuffer=yes
148 forcejitterbuffer=yes
149 maxjitterbuffer=1500
150 resyncthreshold=2000
151 maxjitterinterps=10
152
153 ;trunkfreq=20                   ; How frequently to send trunk msgs (in ms)
154
155 ; Should we send timestamps for the individual sub-frames within trunk frames?
156 ; There is a small bandwidth use for these (less than 1kbps/call), but they
157 ; ensure that frame timestamps get sent end-to-end properly.  If both ends of
158 ; all your trunks go directly to TDM, _and_ your trunkfreq equals the frame
159 ; length for your codecs, you can probably suppress these.  The receiver must
160 ; also support this feature, although they do not also need to have it enabled.
161 ;
162 ; trunktimestamps=yes
163 ;
164 ; Minimum and maximum amounts of time that IAX peers can request as
165 ; a registration expiration interval (in seconds).
166 minregexpire = 60
167 maxregexpire = 120
168 ;
169 ; IAX helper threads
170 ; Establishes the number of iax helper threads to handle I/O.
171 ; iaxthreadcount = 10
172 ; Establishes the number of extra dynamic threads that may be spawned to handle I/O
173 ; iaxmaxthreadcount = 100
174 ;
175 ; We can register with another IAX server to let him know where we are
176 ; in case we have a dynamic IP address for example
177 ;
178 ; Register with tormenta using username marko and password secretpass
179 ;
180 ;register => marko:secretpass@tormenta.linux-support.net
181 ;
182 ; Register joe at remote host with no password
183 ;
184 ;register => joe@remotehost:5656
185 ;
186 ; Register marko at tormenta.linux-support.net using RSA key "torkey"
187 ;
188 ;register => marko:[torkey]@tormenta.linux-support.net
189 ;
190 ; Sample Registration for iaxtel
191 ;
192 ; Visit http://www.iaxtel.com to register with iaxtel.  Replace "user"
193 ; and "pass" with your username and password for iaxtel.  Incoming 
194 ; calls arrive at the "s" extension of "default" context.
195 ;
196 ;register => user:pass@iaxtel.com
197 ;
198 ; Sample Registration for IAX + FWD
199 ;
200 ; To register using IAX with FWD, it must be enabled by visiting the URL
201 ; http://www.fwdnet.net/index.php?section_id=112
202 ;
203 ; Note that you need an extension in you default context which matches
204 ; your free world dialup number.  Please replace "FWDNumber" with your
205 ; FWD number and "passwd" with your password.
206 ;
207 ;register => FWDNumber:passwd@iax.fwdnet.net
208 ;
209 ;
210 ; You can disable authentication debugging to reduce the amount of 
211 ; debugging traffic.
212 ;
213 ;authdebug=no
214 ;
215 ; See doc/README.tos for a description of the tos parameters.
216 tos=ef
217 ;
218 ; If regcontext is specified, Asterisk will dynamically create and destroy
219 ; a NoOp priority 1 extension for a given peer who registers or unregisters
220 ; with us.  The actual extension is the 'regexten' parameter of the registering
221 ; peer or its name if 'regexten' is not provided.  More than one regexten
222 ; may be supplied if they are separated by '&'.  Patterns may be used in
223 ; regexten.
224 ;
225 ;regcontext=iaxregistrations
226 ;
227 ; If we don't get ACK to our NEW within 2000ms, and autokill is set to yes,
228 ; then we cancel the whole thing (that's enough time for one retransmission
229 ; only).  This is used to keep things from stalling for a long time for a host
230 ; that is not available, but would be ill advised for bad connections.  In
231 ; addition to 'yes' or 'no' you can also specify a number of milliseconds.
232 ; See 'qualify' for individual peers to turn on for just a specific peer.
233 ;
234 ;autokill=yes
235 autokill=5000
236 ;
237 ; codecpriority controls the codec negotiation of an inbound IAX call.
238 ; This option is inherited to all user entities.  It can also be defined 
239 ; in each user entity separately which will override the setting in general.
240 ;
241 ; The valid values are:
242 ;
243 ; caller   - Consider the callers preferred order ahead of the host's.
244 ; host     - Consider the host's preferred order ahead of the caller's.
245 ; disabled - Disable the consideration of codec preference altogether.
246 ;            (this is the original behaviour before preferences were added)
247 ; reqonly  - Same as disabled, only do not consider capabilities if
248 ;            the requested format is not available the call will only
249 ;            be accepted if the requested format is available.
250 ;
251 ; The default value is 'host'
252 ;
253 codecpriority=host
254
255 ;rtcachefriends=yes     ; Cache realtime friends by adding them to the internal list
256                         ; just like friends added from the config file only on a
257                         ; as-needed basis? (yes|no)
258
259 ;rtupdate=yes           ; Send registry updates to database using realtime? (yes|no)
260                         ; If set to yes, when a IAX2 peer registers successfully,
261                         ; the ip address, the origination port, the registration period,
262                         ; and the username of the peer will be set to database via realtime.
263                         ; If not present, defaults to 'yes'.
264
265 ;rtautoclear=yes        ; Auto-Expire friends created on the fly on the same schedule
266                         ; as if it had just registered? (yes|no|<seconds>)
267                         ; If set to yes, when the registration expires, the friend will
268                         ; vanish from the configuration until requested again.
269                         ; If set to an integer, friends expire within this number of
270                         ; seconds instead of the registration interval.
271
272 ;rtignoreregexpire=yes  ; When reading a peer from Realtime, if the peer's registration
273                         ; has expired based on its registration interval, used the stored
274                         ; address information regardless. (yes|no)
275
276
277 ; un téléphone IP AUF peut recevoir 2 lignes en même temps...
278 incominglimit=2
279
280 ;
281 ; inclusion des configurations locales au site (AUF)
282
283 ; Comptes pour liaisons IAX inter implantations
284 ; Fichier fourni par le paquet asterisk-config-auf-connexions
285 #include "auf/iax.global"
286
287 ; Comptes pour postes clients locaux IAX
288 #include "auf/iax.local"
289