Fix segfault
[asterisk/asterisk.git] / configs / iax.conf.sample
1
2 ; Inter-Asterisk eXchange driver definition
3 ;
4 ;
5 ; General settings, like port number to bind to, and
6 ; an option address (the default is to bind to all
7 ; local addresses).
8 ;
9 [general]
10 ;bindport=4569
11 ;bindaddr=192.168.0.1
12 ;
13 ; Set iaxcompat to yes if you plan to use layered 
14 ; switches.  It incurs a small performance hit to enable it
15 ;
16 ;iaxcompat=yes
17 ;
18 ; For increased security against brute force password attacks
19 ; enable "delayreject" which will delay the sending of authentication
20 ; reject for REGREQ or AUTHREP if there is a password.  
21 ;
22 ;delayreject=yes
23 ;
24 ; You may specify a global default AMA flag for iaxtel calls.  It must be
25 ; one of 'default', 'omit', 'billing', or 'documentation'.  These flags
26 ; are used in the generation of call detail records.
27 ;
28 ;amaflags=default
29 ;
30 ; You may specify a default account for Call Detail Records in addition
31 ; to specifying on a per-user basis
32 ;
33 ;accountcode=lss0101
34 ;
35 ; You may specify a global default language for users. 
36 ; Can be specified also on a per-user basis
37 ; If omitted, will fallback to english
38 ;
39 ;language=en
40 ;
41 ; Specify bandwidth of low, medium, or high to control which codecs are used
42 ; in general.
43 ;
44 bandwidth=low
45 ;
46 ; You can also fine tune codecs here using "allow" and "disallow" clauses
47 ; with specific codecs.  Use "all" to represent all formats.
48 ;
49 ;allow=all                      ; same as bandwidth=high
50 ;disallow=g723.1                ; Hm...  Proprietary, don't use it...
51 disallow=lpc10                  ; Icky sound quality...  Mr. Roboto.
52 ;allow=gsm                      ; Always allow GSM, it's cool :)
53 ;
54
55 ; You can adjust several parameters relating to the jitter buffer.
56 ; The jitter buffer's function is to compensate for varying
57 ; network delay.
58 ;
59 ; All the jitter buffer settings except dropcount are in milliseconds.
60 ; The jitter buffer works for INCOMING audio - the outbound audio
61 ; will be dejittered by the jitter buffer at the other end.
62 ;
63 ; jitterbuffer=yes|no: global default as to whether you want
64 ; the jitter buffer at all.
65 ;
66 ; dropcount: the jitter buffer is sized such that no more than "dropcount"
67 ; frames would have been "too late" over the last 2 seconds.
68 ; Set to a small number.  "3" represents 1.5% of frames dropped
69 ;
70 ; maxjitterbuffer: a maximum size for the jitter buffer.
71 ; Setting a reasonable maximum here will prevent the call delay
72 ; from rising to silly values in extreme situations; you'll hear
73 ; SOMETHING, even though it will be jittery.
74 ;
75 ; maxexcessbuffer: If conditions improve after a period of high jitter,
76 ; the jitter buffer can end up bigger than necessary.  If it ends up
77 ; more than "maxexcessbuffer" bigger than needed, Asterisk will start
78 ; gradually decreasing the amount of jitter buffering.
79 ;
80 ; minexcessbuffer: Sets a desired mimimum amount of headroom in 
81 ; the jitter buffer.  If Asterisk has less headroom than this, then
82 ; it will start gradually increasing the amount of jitter buffering.
83 ;
84 ; jittershrinkrate: when the jitter buffer is being gradually shrunk 
85 ; (or enlarged), how many millisecs shall we take off per 20ms frame
86 ; received?  Use a small number, or you will be able to hear it
87 ; changing.  An example: if you set this to 2, then the jitter buffer
88 ; size will change by 100 millisecs per second.
89
90 jitterbuffer=no
91 ;dropcount=2
92 ;maxjitterbuffer=500
93 ;maxexcessbuffer=80
94 ;minexcessbuffer=10
95 ;jittershrinkrate=1
96
97 ;trunkfreq=20                   ; How frequently to send trunk msgs (in ms)
98 ;
99 ;
100 ; We can register with another IAX server to let him know where we are
101 ; in case we have a dynamic IP address for example
102 ;
103 ; Register with tormenta using username marko and password secretpass
104 ;
105 ;register => marko:secretpass@tormenta.linux-support.net
106 ;
107 ; Register joe at remote host with no password
108 ;
109 ;register => joe@remotehost:5656
110 ;
111 ; Register marko at tormenta.linux-support.net using RSA key "torkey"
112 ;
113 ;register => marko:[torkey]@tormenta.linux-support.net
114 ;
115 ; Sample Registration for iaxtel
116 ;
117 ; Visit http://www.iaxtel.com to register with iaxtel.  Replace "user"
118 ; and "pass" with your username and password for iaxtel.  Incoming 
119 ; calls arrive at the "s" extension of "default" context.
120 ;
121 ;register => user:pass@iaxtel.com
122 ;
123 ; Sample Registration for IAX + FWD
124 ;
125 ; To register using IAX with FWD, it must be enabled by visiting the URL
126 ; http://www.fwdnet.net/index.php?section_id=112
127 ;
128 ; Note that you need an extension in you default context which matches
129 ; your free world dialup number.  Please replace "FWDNumber" with your
130 ; FWD number and "passwd" with your password.
131 ;
132 ;register => FWDNumber:passwd@iax.fwdnet.net
133 ;
134 ;
135 ; You can disable authentication debugging to reduce the amount of 
136 ; debugging traffic.
137 ;
138 ;authdebug=no
139 ;
140 ; Finally, you can set values for your TOS bits to help improve 
141 ; performance.  Valid values are:
142 ;   lowdelay            -- Minimize delay
143 ;   throughput          -- Maximize throughput
144 ;   reliability         -- Maximize reliability
145 ;   mincost             -- Minimize cost
146 ;   none                -- No flags
147 ;
148 tos=lowdelay
149 ;
150 ; If mailboxdetail is set to "yes", the user receives
151 ; the actual new/old message counts, not just a yes/no
152 ; as to whether they have messages.  this can be set on
153 ; a per-peer basis as well
154 ;
155 ;mailboxdetail=yes
156 ;
157 ; If regcontext is specified, Asterisk will dynamically 
158 ; create and destroy a NoOp priority 1 extension for a given
159 ; peer who registers or unregisters with us.  The actual extension
160 ; is the 'regexten' parameter of the registering peer or its
161 ; name if 'regexten' is not provided.  More than one regexten may be supplied
162 ; if they are separated by '&'.  Patterns may be used in regexten.
163 ;
164 ;regcontext=iaxregistrations
165 ;
166 ; If we don't get ACK to our NEW within 2000ms, and autokill is set
167 ; to yes, then we cancel the whole thing (that's enough time for one 
168 ; retransmission only).  This is used to keep things from stalling for a long
169 ; time for a host that is not available, but would be ill advised for bad 
170 ; connections.  In addition to 'yes' or 'no' you can also specify a number
171 ; of milliseconds.  See 'qualify' for individual peers to turn on for just
172 ; a specific peer.
173 ;
174 autokill=yes
175 ;
176 ; Guest sections for unauthenticated connection attempts.  Just
177 ; specify an empty secret, or provide no secret section.
178 ;
179 [guest]
180 type=user
181 context=default
182 callerid="Guest IAX User"
183
184 ;
185 ; Trust Caller*ID Coming from iaxtel.com
186 ;
187 [iaxtel]
188 type=user
189 context=default
190 auth=rsa
191 inkeys=iaxtel
192
193 ;
194 ; Trust Caller*ID Coming from iax.fwdnet.net
195 ;
196 [iaxfwd]
197 type=user
198 context=default
199 auth=rsa
200 inkeys=freeworlddialup
201
202 ;
203 ; Trust callerid delivered over DUNDi/e164
204 ;
205 ;
206 ;[dundi]
207 ;type=user
208 ;dbsecret=dundi/secret
209 ;context=dundi-e164-local
210
211 ;
212 ; Further user sections may be added, specifying a context and a
213 ; secret used for connections with that given authentication name.
214 ; Limited IP based access control is allowed by use of "allow" and
215 ; "deny" keywords.  Multiple rules are permitted.  Multiple permitted
216 ; contexts may be specified, in which case the first will be the default.
217 ; You can also override caller*ID so that when you receive a call you
218 ; set the Caller*ID to be what you want instead of trusting what
219 ; the remote user provides
220 ;
221 ; There are three authentication methods that are supported:  md5, plaintext,
222 ; and rsa.  The least secure is "plaintext", which sends passwords cleartext
223 ; across the net.  "md5" uses a challenge/response md5 sum arrangement, but
224 ; still requires both ends have plain text access to the secret.  "rsa" allows
225 ; unidirectional secret knowledge through public/private keys.  If "rsa"
226 ; authentication is used, "inkeys" is a list of acceptable public keys on the 
227 ; local system that can be used to authenticate the remote peer, separated by
228 ; the ":" character.  "outkey" is a single, private key to use to authenticate
229 ; to the other side.  Public keys are named /var/lib/asterisk/keys/<name>.pub
230 ; while private keys are named /var/lib/asterisk/keys/<name>.key.  Private
231 ; keys should always be 3DES encrypted.
232 ;
233 ;
234 ;[markster]
235 ;type=user
236 ;context=default
237 ;context=local
238 ;auth=md5,plaintext,rsa
239 ;secret=markpasswd
240 ;dbsecret=mysecrets/place       ; Secrets can be stored in astdb, too
241 ;notransfer=yes         ; Disable IAX native transfer
242 ;jitterbuffer=yes       ; Override global setting an enable jitter buffer
243 ;                       ; for this user
244 ;callerid="Mark Spencer" <(256) 428-6275>
245 ;deny=0.0.0.0/0.0.0.0
246 ;accountcode=markster0101
247 ;permit=209.16.236.73/255.255.255.0
248 ;language=en            ; Use english as default language
249 ;
250 ; Peers may also be specified, with a secret and
251 ; a remote hostname.
252 ;
253 [demo]
254 type=peer
255 username=asterisk
256 secret=supersecret
257 host=216.207.245.47
258 ;sendani=no
259 ;host=asterisk.linux-support.net
260 ;port=5036
261 ;mask=255.255.255.255
262 ;qualify=yes    ; Make sure this peer is alive
263 ;jitterbuffer=no        ; Turn off jitter buffer for this peer
264
265 ;
266 ; Peers can remotely register as well, so that they can be
267 ; mobile.  Default IP's can also optionally be given but
268 ; are not required.  Caller*ID can be suggested to the other
269 ; side as well if it is for example a phone instead of another
270 ; PBX.
271 ;
272
273 ;[dynamichost]
274 ;host=dynamic
275 ;secret=mysecret
276 ;mailbox=1234           ; Notify about mailbox 1234
277 ;inkeys=key1:key2
278 ;peercontext=local      ; Default context to request for calls to peer
279 ;defaultip=216.207.245.34
280 ;callerid="Some Host" <(256) 428-6011>
281 ;
282
283 ;
284 ;[biggateway]
285 ;type=peer
286 ;host=192.168.0.1
287 ;context=*
288 ;secret=myscret
289 ;trunk=yes              ; Use IAX2 trunking with this host
290 ;
291
292 ;
293 ; Friends are a short cut for creating a user and
294 ; a peer with the same values.
295 ;
296 ;[marko]
297 ;type=friend
298 ;host=dynamic
299 ;regexten=1234
300 ;secret=moofoo
301 ;context=default
302 ;permit=0.0.0.0/0.0.0.0