Deprecated macro usage for connected line, redirecting, and CCSS
[asterisk/asterisk.git] / apps / app_dial.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2008, Digium, Inc.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file
20  *
21  * \brief dial() & retrydial() - Trivial application to dial a channel and send an URL on answer
22  *
23  * \author Mark Spencer <markster@digium.com>
24  *
25  * \ingroup applications
26  */
27
28 /*** MODULEINFO
29         <depend>chan_local</depend>
30         <support_level>core</support_level>
31  ***/
32
33
34 #include "asterisk.h"
35
36 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
37
38 #include <sys/time.h>
39 #include <sys/signal.h>
40 #include <sys/stat.h>
41 #include <netinet/in.h>
42
43 #include "asterisk/paths.h" /* use ast_config_AST_DATA_DIR */
44 #include "asterisk/lock.h"
45 #include "asterisk/file.h"
46 #include "asterisk/channel.h"
47 #include "asterisk/pbx.h"
48 #include "asterisk/module.h"
49 #include "asterisk/translate.h"
50 #include "asterisk/say.h"
51 #include "asterisk/config.h"
52 #include "asterisk/features.h"
53 #include "asterisk/musiconhold.h"
54 #include "asterisk/callerid.h"
55 #include "asterisk/utils.h"
56 #include "asterisk/app.h"
57 #include "asterisk/causes.h"
58 #include "asterisk/rtp_engine.h"
59 #include "asterisk/cdr.h"
60 #include "asterisk/manager.h"
61 #include "asterisk/privacy.h"
62 #include "asterisk/stringfields.h"
63 #include "asterisk/global_datastores.h"
64 #include "asterisk/dsp.h"
65 #include "asterisk/cel.h"
66 #include "asterisk/aoc.h"
67 #include "asterisk/ccss.h"
68 #include "asterisk/indications.h"
69 #include "asterisk/framehook.h"
70
71 /*** DOCUMENTATION
72         <application name="Dial" language="en_US">
73                 <synopsis>
74                         Attempt to connect to another device or endpoint and bridge the call.
75                 </synopsis>
76                 <syntax>
77                         <parameter name="Technology/Resource" required="true" argsep="&amp;">
78                                 <argument name="Technology/Resource" required="true">
79                                         <para>Specification of the device(s) to dial.  These must be in the format of
80                                         <literal>Technology/Resource</literal>, where <replaceable>Technology</replaceable>
81                                         represents a particular channel driver, and <replaceable>Resource</replaceable>
82                                         represents a resource available to that particular channel driver.</para>
83                                 </argument>
84                                 <argument name="Technology2/Resource2" required="false" multiple="true">
85                                         <para>Optional extra devices to dial in parallel</para>
86                                         <para>If you need more then one enter them as
87                                         Technology2/Resource2&amp;Technology3/Resourse3&amp;.....</para>
88                                 </argument>
89                         </parameter>
90                         <parameter name="timeout" required="false">
91                                 <para>Specifies the number of seconds we attempt to dial the specified devices</para>
92                                 <para>If not specified, this defaults to 136 years.</para>
93                         </parameter>
94                         <parameter name="options" required="false">
95                            <optionlist>
96                                 <option name="A">
97                                         <argument name="x" required="true">
98                                                 <para>The file to play to the called party</para>
99                                         </argument>
100                                         <para>Play an announcement to the called party, where <replaceable>x</replaceable> is the prompt to be played</para>
101                                 </option>
102                                 <option name="a">
103                                         <para>Immediately answer the calling channel when the called channel answers in
104                                         all cases. Normally, the calling channel is answered when the called channel
105                                         answers, but when options such as A() and M() are used, the calling channel is
106                                         not answered until all actions on the called channel (such as playing an
107                                         announcement) are completed.  This option can be used to answer the calling
108                                         channel before doing anything on the called channel. You will rarely need to use
109                                         this option, the default behavior is adequate in most cases.</para>
110                                 </option>
111                                 <option name="C">
112                                         <para>Reset the call detail record (CDR) for this call.</para>
113                                 </option>
114                                 <option name="c">
115                                         <para>If the Dial() application cancels this call, always set the flag to tell the channel
116                                         driver that the call is answered elsewhere.</para>
117                                 </option>
118                                 <option name="d">
119                                         <para>Allow the calling user to dial a 1 digit extension while waiting for
120                                         a call to be answered. Exit to that extension if it exists in the
121                                         current context, or the context defined in the <variable>EXITCONTEXT</variable> variable,
122                                         if it exists.</para>
123                                         <note>
124                                                 <para>Many SIP and ISDN phones cannot send DTMF digits until the call is
125                                                 connected.  If you wish to use this option with these phones, you
126                                                 can use the <literal>Answer</literal> application before dialing.</para>
127                                         </note>
128                                 </option>
129                                 <option name="D" argsep=":">
130                                         <argument name="called" />
131                                         <argument name="calling" />
132                                         <argument name="progress" />
133                                         <para>Send the specified DTMF strings <emphasis>after</emphasis> the called
134                                         party has answered, but before the call gets bridged. The 
135                                         <replaceable>called</replaceable> DTMF string is sent to the called party, and the 
136                                         <replaceable>calling</replaceable> DTMF string is sent to the calling party. Both arguments 
137                                         can be used alone.  If <replaceable>progress</replaceable> is specified, its DTMF is sent
138                                         immediately after receiving a PROGRESS message.</para>
139                                 </option>
140                                 <option name="e">
141                                         <para>Execute the <literal>h</literal> extension for peer after the call ends</para>
142                                 </option>
143                                 <option name="f">
144                                         <argument name="x" required="false" />
145                                         <para>If <replaceable>x</replaceable> is not provided, force the CallerID sent on a call-forward or
146                                         deflection to the dialplan extension of this Dial() using a dialplan <literal>hint</literal>.
147                                         For example, some PSTNs do not allow CallerID to be set to anything
148                                         other than the numbers assigned to you.
149                                         If <replaceable>x</replaceable> is provided, force the CallerID sent to <replaceable>x</replaceable>.</para>
150                                 </option>
151                                 <option name="F" argsep="^">
152                                         <argument name="context" required="false" />
153                                         <argument name="exten" required="false" />
154                                         <argument name="priority" required="true" />
155                                         <para>When the caller hangs up, transfer the <emphasis>called</emphasis> party
156                                         to the specified destination and <emphasis>start</emphasis> execution at that location.</para>
157                                         <note>
158                                                 <para>Any channel variables you want the called channel to inherit from the caller channel must be
159                                                 prefixed with one or two underbars ('_').</para>
160                                         </note>
161                                 </option>
162                                 <option name="F">
163                                         <para>When the caller hangs up, transfer the <emphasis>called</emphasis> party to the next priority of the current extension
164                                         and <emphasis>start</emphasis> execution at that location.</para>
165                                         <note>
166                                                 <para>Any channel variables you want the called channel to inherit from the caller channel must be
167                                                 prefixed with one or two underbars ('_').</para>
168                                         </note>
169                                         <note>
170                                                 <para>Using this option from a Macro() or GoSub() might not make sense as there would be no return points.</para>
171                                         </note>
172                                 </option>
173                                 <option name="g">
174                                         <para>Proceed with dialplan execution at the next priority in the current extension if the
175                                         destination channel hangs up.</para>
176                                 </option>
177                                 <option name="G" argsep="^">
178                                         <argument name="context" required="false" />
179                                         <argument name="exten" required="false" />
180                                         <argument name="priority" required="true" />
181                                         <para>If the call is answered, transfer the calling party to
182                                         the specified <replaceable>priority</replaceable> and the called party to the specified 
183                                         <replaceable>priority</replaceable> plus one.</para>
184                                         <note>
185                                                 <para>You cannot use any additional action post answer options in conjunction with this option.</para>
186                                         </note>
187                                 </option>
188                                 <option name="h">
189                                         <para>Allow the called party to hang up by sending the DTMF sequence
190                                         defined for disconnect in <filename>features.conf</filename>.</para>
191                                 </option>
192                                 <option name="H">
193                                         <para>Allow the calling party to hang up by sending the DTMF sequence
194                                         defined for disconnect in <filename>features.conf</filename>.</para>
195                                         <note>
196                                                 <para>Many SIP and ISDN phones cannot send DTMF digits until the call is
197                                                 connected.  If you wish to allow DTMF disconnect before the dialed
198                                                 party answers with these phones, you can use the <literal>Answer</literal>
199                                                 application before dialing.</para>
200                                         </note>
201                                 </option>
202                                 <option name="i">
203                                         <para>Asterisk will ignore any forwarding requests it may receive on this dial attempt.</para>
204                                 </option>
205                                 <option name="I">
206                                         <para>Asterisk will ignore any connected line update requests or any redirecting party
207                                         update requests it may receive on this dial attempt.</para>
208                                 </option>
209                                 <option name="k">
210                                         <para>Allow the called party to enable parking of the call by sending
211                                         the DTMF sequence defined for call parking in <filename>features.conf</filename>.</para>
212                                 </option>
213                                 <option name="K">
214                                         <para>Allow the calling party to enable parking of the call by sending
215                                         the DTMF sequence defined for call parking in <filename>features.conf</filename>.</para>
216                                 </option>
217                                 <option name="L" argsep=":">
218                                         <argument name="x" required="true">
219                                                 <para>Maximum call time, in milliseconds</para>
220                                         </argument>
221                                         <argument name="y">
222                                                 <para>Warning time, in milliseconds</para>
223                                         </argument>
224                                         <argument name="z">
225                                                 <para>Repeat time, in milliseconds</para>
226                                         </argument>
227                                         <para>Limit the call to <replaceable>x</replaceable> milliseconds. Play a warning when <replaceable>y</replaceable> milliseconds are
228                                         left. Repeat the warning every <replaceable>z</replaceable> milliseconds until time expires.</para>
229                                         <para>This option is affected by the following variables:</para>
230                                         <variablelist>
231                                                 <variable name="LIMIT_PLAYAUDIO_CALLER">
232                                                         <value name="yes" default="true" />
233                                                         <value name="no" />
234                                                         <para>If set, this variable causes Asterisk to play the prompts to the caller.</para>
235                                                 </variable>
236                                                 <variable name="LIMIT_PLAYAUDIO_CALLEE">
237                                                         <value name="yes" />
238                                                         <value name="no" default="true"/>
239                                                         <para>If set, this variable causes Asterisk to play the prompts to the callee.</para>
240                                                 </variable>
241                                                 <variable name="LIMIT_TIMEOUT_FILE">
242                                                         <value name="filename"/>
243                                                         <para>If specified, <replaceable>filename</replaceable> specifies the sound prompt to play when the timeout is reached.
244                                                         If not set, the time remaining will be announced.</para>
245                                                 </variable>
246                                                 <variable name="LIMIT_CONNECT_FILE">
247                                                         <value name="filename"/>
248                                                         <para>If specified, <replaceable>filename</replaceable> specifies the sound prompt to play when the call begins.
249                                                         If not set, the time remaining will be announced.</para>
250                                                 </variable>
251                                                 <variable name="LIMIT_WARNING_FILE">
252                                                         <value name="filename"/>
253                                                         <para>If specified, <replaceable>filename</replaceable> specifies the sound prompt to play as
254                                                         a warning when time <replaceable>x</replaceable> is reached. If not set, the time remaining will be announced.</para>
255                                                 </variable>
256                                         </variablelist>
257                                 </option>
258                                 <option name="m">
259                                         <argument name="class" required="false"/>
260                                         <para>Provide hold music to the calling party until a requested
261                                         channel answers. A specific music on hold <replaceable>class</replaceable>
262                                         (as defined in <filename>musiconhold.conf</filename>) can be specified.</para>
263                                 </option>
264                                 <option name="M" argsep="^">
265                                         <argument name="macro" required="true">
266                                                 <para>Name of the macro that should be executed.</para>
267                                         </argument>
268                                         <argument name="arg" multiple="true">
269                                                 <para>Macro arguments</para>
270                                         </argument>
271                                         <para>Execute the specified <replaceable>macro</replaceable> for the <emphasis>called</emphasis> channel 
272                                         before connecting to the calling channel. Arguments can be specified to the Macro
273                                         using <literal>^</literal> as a delimiter. The macro can set the variable
274                                         <variable>MACRO_RESULT</variable> to specify the following actions after the macro is
275                                         finished executing:</para>
276                                         <variablelist>
277                                                 <variable name="MACRO_RESULT">
278                                                         <para>If set, this action will be taken after the macro finished executing.</para>
279                                                         <value name="ABORT">
280                                                                 Hangup both legs of the call
281                                                         </value>
282                                                         <value name="CONGESTION">
283                                                                 Behave as if line congestion was encountered
284                                                         </value>
285                                                         <value name="BUSY">
286                                                                 Behave as if a busy signal was encountered
287                                                         </value>
288                                                         <value name="CONTINUE">
289                                                                 Hangup the called party and allow the calling party to continue dialplan execution at the next priority
290                                                         </value>
291                                                         <!-- TODO: Fix this syntax up, once we've figured out how to specify the GOTO syntax -->
292                                                         <value name="GOTO:&lt;context&gt;^&lt;exten&gt;^&lt;priority&gt;">
293                                                                 Transfer the call to the specified destination.
294                                                         </value>
295                                                 </variable>
296                                         </variablelist>
297                                         <note>
298                                                 <para>You cannot use any additional action post answer options in conjunction
299                                                 with this option. Also, pbx services are not run on the peer (called) channel,
300                                                 so you will not be able to set timeouts via the TIMEOUT() function in this macro.</para>
301                                         </note>
302                                         <warning><para>Be aware of the limitations that macros have, specifically with regards to use of
303                                         the <literal>WaitExten</literal> application. For more information, see the documentation for
304                                         Macro()</para></warning>
305                                 </option>
306                                 <option name="n">
307                                         <argument name="delete">
308                                                 <para>With <replaceable>delete</replaceable> either not specified or set to <literal>0</literal>,
309                                                 the recorded introduction will not be deleted if the caller hangs up while the remote party has not
310                                                 yet answered.</para>
311                                                 <para>With <replaceable>delete</replaceable> set to <literal>1</literal>, the introduction will
312                                                 always be deleted.</para>
313                                         </argument>
314                                         <para>This option is a modifier for the call screening/privacy mode. (See the 
315                                         <literal>p</literal> and <literal>P</literal> options.) It specifies
316                                         that no introductions are to be saved in the <directory>priv-callerintros</directory>
317                                         directory.</para>
318                                 </option>
319                                 <option name="N">
320                                         <para>This option is a modifier for the call screening/privacy mode. It specifies
321                                         that if Caller*ID is present, do not screen the call.</para>
322                                 </option>
323                                 <option name="o">
324                                         <argument name="x" required="false" />
325                                         <para>If <replaceable>x</replaceable> is not provided, specify that the CallerID that was present on the
326                                         <emphasis>calling</emphasis> channel be stored as the CallerID on the <emphasis>called</emphasis> channel.
327                                         This was the behavior of Asterisk 1.0 and earlier.
328                                         If <replaceable>x</replaceable> is provided, specify the CallerID stored on the <emphasis>called</emphasis> channel.
329                                         Note that o(${CALLERID(all)}) is similar to option o without the parameter.</para>
330                                 </option>
331                                 <option name="O">
332                                         <argument name="mode">
333                                                 <para>With <replaceable>mode</replaceable> either not specified or set to <literal>1</literal>,
334                                                 the originator hanging up will cause the phone to ring back immediately.</para>
335                                                 <para>With <replaceable>mode</replaceable> set to <literal>2</literal>, when the operator 
336                                                 flashes the trunk, it will ring their phone back.</para>
337                                         </argument>
338                                         <para>Enables <emphasis>operator services</emphasis> mode.  This option only
339                                         works when bridging a DAHDI channel to another DAHDI channel
340                                         only. if specified on non-DAHDI interfaces, it will be ignored.
341                                         When the destination answers (presumably an operator services
342                                         station), the originator no longer has control of their line.
343                                         They may hang up, but the switch will not release their line
344                                         until the destination party (the operator) hangs up.</para>
345                                 </option>
346                                 <option name="p">
347                                         <para>This option enables screening mode. This is basically Privacy mode
348                                         without memory.</para>
349                                 </option>
350                                 <option name="P">
351                                         <argument name="x" />
352                                         <para>Enable privacy mode. Use <replaceable>x</replaceable> as the family/key in the AstDB database if
353                                         it is provided. The current extension is used if a database family/key is not specified.</para>
354                                 </option>
355                                 <option name="r">
356                                         <para>Default: Indicate ringing to the calling party, even if the called party isn't actually ringing. Pass no audio to the calling
357                                         party until the called channel has answered.</para>
358                                         <argument name="tone" required="false">
359                                                 <para>Indicate progress to calling party. Send audio 'tone' from indications.conf</para>
360                                         </argument>
361                                 </option>
362                                 <option name="S">
363                                         <argument name="x" required="true" />
364                                         <para>Hang up the call <replaceable>x</replaceable> seconds <emphasis>after</emphasis> the called party has
365                                         answered the call.</para>
366                                 </option>
367                                 <option name="s">
368                                         <argument name="x" required="true" />
369                                         <para>Force the outgoing callerid tag parameter to be set to the string <replaceable>x</replaceable>.</para>
370                                         <para>Works with the f option.</para>
371                                 </option>
372                                 <option name="t">
373                                         <para>Allow the called party to transfer the calling party by sending the
374                                         DTMF sequence defined in <filename>features.conf</filename>. This setting does not perform policy enforcement on
375                                         transfers initiated by other methods.</para>
376                                 </option>
377                                 <option name="T">
378                                         <para>Allow the calling party to transfer the called party by sending the
379                                         DTMF sequence defined in <filename>features.conf</filename>. This setting does not perform policy enforcement on
380                                         transfers initiated by other methods.</para>
381                                 </option>
382                                 <option name="U" argsep="^">
383                                         <argument name="x" required="true">
384                                                 <para>Name of the subroutine to execute via Gosub</para>
385                                         </argument>
386                                         <argument name="arg" multiple="true" required="false">
387                                                 <para>Arguments for the Gosub routine</para>
388                                         </argument>
389                                         <para>Execute via Gosub the routine <replaceable>x</replaceable> for the <emphasis>called</emphasis> channel before connecting
390                                         to the calling channel. Arguments can be specified to the Gosub
391                                         using <literal>^</literal> as a delimiter. The Gosub routine can set the variable
392                                         <variable>GOSUB_RESULT</variable> to specify the following actions after the Gosub returns.</para>
393                                         <variablelist>
394                                                 <variable name="GOSUB_RESULT">
395                                                         <value name="ABORT">
396                                                                 Hangup both legs of the call.
397                                                         </value>
398                                                         <value name="CONGESTION">
399                                                                 Behave as if line congestion was encountered.
400                                                         </value>
401                                                         <value name="BUSY">
402                                                                 Behave as if a busy signal was encountered.
403                                                         </value>
404                                                         <value name="CONTINUE">
405                                                                 Hangup the called party and allow the calling party
406                                                                 to continue dialplan execution at the next priority.
407                                                         </value>
408                                                         <!-- TODO: Fix this syntax up, once we've figured out how to specify the GOTO syntax -->
409                                                         <value name="GOTO:&lt;context&gt;^&lt;exten&gt;^&lt;priority&gt;">
410                                                                 Transfer the call to the specified priority. Optionally, an extension, or
411                                                                 extension and priority can be specified.
412                                                         </value>
413                                                 </variable>
414                                         </variablelist>
415                                         <note>
416                                                 <para>You cannot use any additional action post answer options in conjunction
417                                                 with this option. Also, pbx services are not run on the peer (called) channel,
418                                                 so you will not be able to set timeouts via the TIMEOUT() function in this routine.</para>
419                                         </note>
420                                 </option>
421                                 <option name="u">
422                                         <argument name = "x" required="true">
423                                                 <para>Force the outgoing callerid presentation indicator parameter to be set
424                                                 to one of the values passed in <replaceable>x</replaceable>:
425                                                 <literal>allowed_not_screened</literal>
426                                                 <literal>allowed_passed_screen</literal>
427                                                 <literal>allowed_failed_screen</literal>
428                                                 <literal>allowed</literal>
429                                                 <literal>prohib_not_screened</literal>
430                                                 <literal>prohib_passed_screen</literal>
431                                                 <literal>prohib_failed_screen</literal>
432                                                 <literal>prohib</literal>
433                                                 <literal>unavailable</literal></para>
434                                         </argument>
435                                         <para>Works with the f option.</para>
436                                 </option>
437                                 <option name="w">
438                                         <para>Allow the called party to enable recording of the call by sending
439                                         the DTMF sequence defined for one-touch recording in <filename>features.conf</filename>.</para>
440                                 </option>
441                                 <option name="W">
442                                         <para>Allow the calling party to enable recording of the call by sending
443                                         the DTMF sequence defined for one-touch recording in <filename>features.conf</filename>.</para>
444                                 </option>
445                                 <option name="x">
446                                         <para>Allow the called party to enable recording of the call by sending
447                                         the DTMF sequence defined for one-touch automixmonitor in <filename>features.conf</filename>.</para>
448                                 </option>
449                                 <option name="X">
450                                         <para>Allow the calling party to enable recording of the call by sending
451                                         the DTMF sequence defined for one-touch automixmonitor in <filename>features.conf</filename>.</para>
452                                 </option>
453                                 <option name="z">
454                                         <para>On a call forward, cancel any dial timeout which has been set for this call.</para>
455                                 </option>
456                                 </optionlist>
457                         </parameter>
458                         <parameter name="URL">
459                                 <para>The optional URL will be sent to the called party if the channel driver supports it.</para>
460                         </parameter>
461                 </syntax>
462                 <description>
463                         <para>This application will place calls to one or more specified channels. As soon
464                         as one of the requested channels answers, the originating channel will be
465                         answered, if it has not already been answered. These two channels will then
466                         be active in a bridged call. All other channels that were requested will then
467                         be hung up.</para>
468
469                         <para>Unless there is a timeout specified, the Dial application will wait
470                         indefinitely until one of the called channels answers, the user hangs up, or
471                         if all of the called channels are busy or unavailable. Dialplan executing will
472                         continue if no requested channels can be called, or if the timeout expires.
473                         This application will report normal termination if the originating channel
474                         hangs up, or if the call is bridged and either of the parties in the bridge
475                         ends the call.</para>
476                         <para>If the <variable>OUTBOUND_GROUP</variable> variable is set, all peer channels created by this
477                         application will be put into that group (as in Set(GROUP()=...).
478                         If the <variable>OUTBOUND_GROUP_ONCE</variable> variable is set, all peer channels created by this
479                         application will be put into that group (as in Set(GROUP()=...). Unlike <variable>OUTBOUND_GROUP</variable>,
480                         however, the variable will be unset after use.</para>
481
482                         <para>This application sets the following channel variables:</para>
483                         <variablelist>
484                                 <variable name="DIALEDTIME">
485                                         <para>This is the time from dialing a channel until when it is disconnected.</para>
486                                 </variable>
487                                 <variable name="ANSWEREDTIME">
488                                         <para>This is the amount of time for actual call.</para>
489                                 </variable>
490                                 <variable name="DIALSTATUS">
491                                         <para>This is the status of the call</para>
492                                         <value name="CHANUNAVAIL" />
493                                         <value name="CONGESTION" />
494                                         <value name="NOANSWER" />
495                                         <value name="BUSY" />
496                                         <value name="ANSWER" />
497                                         <value name="CANCEL" />
498                                         <value name="DONTCALL">
499                                                 For the Privacy and Screening Modes.
500                                                 Will be set if the called party chooses to send the calling party to the 'Go Away' script.
501                                         </value>
502                                         <value name="TORTURE">
503                                                 For the Privacy and Screening Modes.
504                                                 Will be set if the called party chooses to send the calling party to the 'torture' script.
505                                         </value>
506                                         <value name="INVALIDARGS" />
507                                 </variable>
508                         </variablelist>
509                 </description>
510         </application>
511         <application name="RetryDial" language="en_US">
512                 <synopsis>
513                         Place a call, retrying on failure allowing an optional exit extension.
514                 </synopsis>
515                 <syntax>
516                         <parameter name="announce" required="true">
517                                 <para>Filename of sound that will be played when no channel can be reached</para>
518                         </parameter>
519                         <parameter name="sleep" required="true">
520                                 <para>Number of seconds to wait after a dial attempt failed before a new attempt is made</para>
521                         </parameter>
522                         <parameter name="retries" required="true">
523                                 <para>Number of retries</para>
524                                 <para>When this is reached flow will continue at the next priority in the dialplan</para>
525                         </parameter>
526                         <parameter name="dialargs" required="true">
527                                 <para>Same format as arguments provided to the Dial application</para>
528                         </parameter>
529                 </syntax>
530                 <description>
531                         <para>This application will attempt to place a call using the normal Dial application.
532                         If no channel can be reached, the <replaceable>announce</replaceable> file will be played.
533                         Then, it will wait <replaceable>sleep</replaceable> number of seconds before retrying the call.
534                         After <replaceable>retries</replaceable> number of attempts, the calling channel will continue at the next priority in the dialplan.
535                         If the <replaceable>retries</replaceable> setting is set to 0, this application will retry endlessly.
536                         While waiting to retry a call, a 1 digit extension may be dialed. If that
537                         extension exists in either the context defined in <variable>EXITCONTEXT</variable> or the current
538                         one, The call will jump to that extension immediately.
539                         The <replaceable>dialargs</replaceable> are specified in the same format that arguments are provided
540                         to the Dial application.</para>
541                 </description>
542         </application>
543  ***/
544
545 static const char app[] = "Dial";
546 static const char rapp[] = "RetryDial";
547
548 enum {
549         OPT_ANNOUNCE =          (1 << 0),
550         OPT_RESETCDR =          (1 << 1),
551         OPT_DTMF_EXIT =         (1 << 2),
552         OPT_SENDDTMF =          (1 << 3),
553         OPT_FORCECLID =         (1 << 4),
554         OPT_GO_ON =             (1 << 5),
555         OPT_CALLEE_HANGUP =     (1 << 6),
556         OPT_CALLER_HANGUP =     (1 << 7),
557         OPT_ORIGINAL_CLID =     (1 << 8),
558         OPT_DURATION_LIMIT =    (1 << 9),
559         OPT_MUSICBACK =         (1 << 10),
560         OPT_CALLEE_MACRO =      (1 << 11),
561         OPT_SCREEN_NOINTRO =    (1 << 12),
562         OPT_SCREEN_NOCALLERID = (1 << 13),
563         OPT_IGNORE_CONNECTEDLINE = (1 << 14),
564         OPT_SCREENING =         (1 << 15),
565         OPT_PRIVACY =           (1 << 16),
566         OPT_RINGBACK =          (1 << 17),
567         OPT_DURATION_STOP =     (1 << 18),
568         OPT_CALLEE_TRANSFER =   (1 << 19),
569         OPT_CALLER_TRANSFER =   (1 << 20),
570         OPT_CALLEE_MONITOR =    (1 << 21),
571         OPT_CALLER_MONITOR =    (1 << 22),
572         OPT_GOTO =              (1 << 23),
573         OPT_OPERMODE =          (1 << 24),
574         OPT_CALLEE_PARK =       (1 << 25),
575         OPT_CALLER_PARK =       (1 << 26),
576         OPT_IGNORE_FORWARDING = (1 << 27),
577         OPT_CALLEE_GOSUB =      (1 << 28),
578         OPT_CALLEE_MIXMONITOR = (1 << 29),
579         OPT_CALLER_MIXMONITOR = (1 << 30),
580 };
581
582 /* flags are now 64 bits, so keep it up! */
583 #define DIAL_STILLGOING      (1LLU << 31)
584 #define DIAL_NOFORWARDHTML   (1LLU << 32)
585 #define DIAL_CALLERID_ABSENT (1LLU << 33) /* TRUE if caller id is not available for connected line. */
586 #define OPT_CANCEL_ELSEWHERE (1LLU << 34)
587 #define OPT_PEER_H           (1LLU << 35)
588 #define OPT_CALLEE_GO_ON     (1LLU << 36)
589 #define OPT_CANCEL_TIMEOUT   (1LLU << 37)
590 #define OPT_FORCE_CID_TAG    (1LLU << 38)
591 #define OPT_FORCE_CID_PRES   (1LLU << 39)
592 #define OPT_CALLER_ANSWER    (1LLU << 40)
593
594 enum {
595         OPT_ARG_ANNOUNCE = 0,
596         OPT_ARG_SENDDTMF,
597         OPT_ARG_GOTO,
598         OPT_ARG_DURATION_LIMIT,
599         OPT_ARG_MUSICBACK,
600         OPT_ARG_CALLEE_MACRO,
601         OPT_ARG_RINGBACK,
602         OPT_ARG_CALLEE_GOSUB,
603         OPT_ARG_CALLEE_GO_ON,
604         OPT_ARG_PRIVACY,
605         OPT_ARG_DURATION_STOP,
606         OPT_ARG_OPERMODE,
607         OPT_ARG_SCREEN_NOINTRO,
608         OPT_ARG_ORIGINAL_CLID,
609         OPT_ARG_FORCECLID,
610         OPT_ARG_FORCE_CID_TAG,
611         OPT_ARG_FORCE_CID_PRES,
612         /* note: this entry _MUST_ be the last one in the enum */
613         OPT_ARG_ARRAY_SIZE,
614 };
615
616 AST_APP_OPTIONS(dial_exec_options, BEGIN_OPTIONS
617         AST_APP_OPTION_ARG('A', OPT_ANNOUNCE, OPT_ARG_ANNOUNCE),
618         AST_APP_OPTION('a', OPT_CALLER_ANSWER),
619         AST_APP_OPTION('C', OPT_RESETCDR),
620         AST_APP_OPTION('c', OPT_CANCEL_ELSEWHERE),
621         AST_APP_OPTION('d', OPT_DTMF_EXIT),
622         AST_APP_OPTION_ARG('D', OPT_SENDDTMF, OPT_ARG_SENDDTMF),
623         AST_APP_OPTION('e', OPT_PEER_H),
624         AST_APP_OPTION_ARG('f', OPT_FORCECLID, OPT_ARG_FORCECLID),
625         AST_APP_OPTION_ARG('F', OPT_CALLEE_GO_ON, OPT_ARG_CALLEE_GO_ON),
626         AST_APP_OPTION('g', OPT_GO_ON),
627         AST_APP_OPTION_ARG('G', OPT_GOTO, OPT_ARG_GOTO),
628         AST_APP_OPTION('h', OPT_CALLEE_HANGUP),
629         AST_APP_OPTION('H', OPT_CALLER_HANGUP),
630         AST_APP_OPTION('i', OPT_IGNORE_FORWARDING),
631         AST_APP_OPTION('I', OPT_IGNORE_CONNECTEDLINE),
632         AST_APP_OPTION('k', OPT_CALLEE_PARK),
633         AST_APP_OPTION('K', OPT_CALLER_PARK),
634         AST_APP_OPTION_ARG('L', OPT_DURATION_LIMIT, OPT_ARG_DURATION_LIMIT),
635         AST_APP_OPTION_ARG('m', OPT_MUSICBACK, OPT_ARG_MUSICBACK),
636         AST_APP_OPTION_ARG('M', OPT_CALLEE_MACRO, OPT_ARG_CALLEE_MACRO),
637         AST_APP_OPTION_ARG('n', OPT_SCREEN_NOINTRO, OPT_ARG_SCREEN_NOINTRO),
638         AST_APP_OPTION('N', OPT_SCREEN_NOCALLERID),
639         AST_APP_OPTION_ARG('o', OPT_ORIGINAL_CLID, OPT_ARG_ORIGINAL_CLID),
640         AST_APP_OPTION_ARG('O', OPT_OPERMODE, OPT_ARG_OPERMODE),
641         AST_APP_OPTION('p', OPT_SCREENING),
642         AST_APP_OPTION_ARG('P', OPT_PRIVACY, OPT_ARG_PRIVACY),
643         AST_APP_OPTION_ARG('r', OPT_RINGBACK, OPT_ARG_RINGBACK),
644         AST_APP_OPTION_ARG('S', OPT_DURATION_STOP, OPT_ARG_DURATION_STOP),
645         AST_APP_OPTION_ARG('s', OPT_FORCE_CID_TAG, OPT_ARG_FORCE_CID_TAG),
646         AST_APP_OPTION_ARG('u', OPT_FORCE_CID_PRES, OPT_ARG_FORCE_CID_PRES),
647         AST_APP_OPTION('t', OPT_CALLEE_TRANSFER),
648         AST_APP_OPTION('T', OPT_CALLER_TRANSFER),
649         AST_APP_OPTION_ARG('U', OPT_CALLEE_GOSUB, OPT_ARG_CALLEE_GOSUB),
650         AST_APP_OPTION('w', OPT_CALLEE_MONITOR),
651         AST_APP_OPTION('W', OPT_CALLER_MONITOR),
652         AST_APP_OPTION('x', OPT_CALLEE_MIXMONITOR),
653         AST_APP_OPTION('X', OPT_CALLER_MIXMONITOR),
654         AST_APP_OPTION('z', OPT_CANCEL_TIMEOUT),
655 END_OPTIONS );
656
657 #define CAN_EARLY_BRIDGE(flags,chan,peer) (!ast_test_flag64(flags, OPT_CALLEE_HANGUP | \
658         OPT_CALLER_HANGUP | OPT_CALLEE_TRANSFER | OPT_CALLER_TRANSFER | \
659         OPT_CALLEE_MONITOR | OPT_CALLER_MONITOR | OPT_CALLEE_PARK |  \
660         OPT_CALLER_PARK | OPT_ANNOUNCE | OPT_CALLEE_MACRO | OPT_CALLEE_GOSUB) && \
661         !ast_channel_audiohooks(chan) && !ast_channel_audiohooks(peer) && \
662         ast_framehook_list_is_empty(ast_channel_framehooks(chan)) && ast_framehook_list_is_empty(ast_channel_framehooks(peer)))
663
664 /*
665  * The list of active channels
666  */
667 struct chanlist {
668         struct chanlist *next;
669         struct ast_channel *chan;
670         uint64_t flags;
671         /*! Saved connected party info from an AST_CONTROL_CONNECTED_LINE. */
672         struct ast_party_connected_line connected;
673         /*! TRUE if an AST_CONTROL_CONNECTED_LINE update was saved to the connected element. */
674         unsigned int pending_connected_update:1;
675         struct ast_aoc_decoded *aoc_s_rate_list;
676 };
677
678 static int detect_disconnect(struct ast_channel *chan, char code, struct ast_str *featurecode);
679
680 static void chanlist_free(struct chanlist *outgoing)
681 {
682         ast_party_connected_line_free(&outgoing->connected);
683         ast_aoc_destroy_decoded(outgoing->aoc_s_rate_list);
684         ast_free(outgoing);
685 }
686
687 static void hanguptree(struct chanlist *outgoing, struct ast_channel *exception, int answered_elsewhere)
688 {
689         /* Hang up a tree of stuff */
690         struct chanlist *oo;
691         while (outgoing) {
692                 /* Hangup any existing lines we have open */
693                 if (outgoing->chan && (outgoing->chan != exception)) {
694                         if (answered_elsewhere) {
695                                 /* The flag is used for local channel inheritance and stuff */
696                                 ast_set_flag(outgoing->chan, AST_FLAG_ANSWERED_ELSEWHERE);
697                                 /* This is for the channel drivers */
698                                 ast_channel_hangupcause_set(outgoing->chan, AST_CAUSE_ANSWERED_ELSEWHERE);
699                         }
700                         ast_hangup(outgoing->chan);
701                 }
702                 oo = outgoing;
703                 outgoing = outgoing->next;
704                 chanlist_free(oo);
705         }
706 }
707
708 #define AST_MAX_WATCHERS 256
709
710 /*
711  * argument to handle_cause() and other functions.
712  */
713 struct cause_args {
714         struct ast_channel *chan;
715         int busy;
716         int congestion;
717         int nochan;
718 };
719
720 static void handle_cause(int cause, struct cause_args *num)
721 {
722         struct ast_cdr *cdr = ast_channel_cdr(num->chan);
723
724         switch(cause) {
725         case AST_CAUSE_BUSY:
726                 if (cdr)
727                         ast_cdr_busy(cdr);
728                 num->busy++;
729                 break;
730
731         case AST_CAUSE_CONGESTION:
732                 if (cdr)
733                         ast_cdr_failed(cdr);
734                 num->congestion++;
735                 break;
736
737         case AST_CAUSE_NO_ROUTE_DESTINATION:
738         case AST_CAUSE_UNREGISTERED:
739                 if (cdr)
740                         ast_cdr_failed(cdr);
741                 num->nochan++;
742                 break;
743
744         case AST_CAUSE_NO_ANSWER:
745                 if (cdr) {
746                         ast_cdr_noanswer(cdr);
747                 }
748                 break;
749         case AST_CAUSE_NORMAL_CLEARING:
750                 break;
751
752         default:
753                 num->nochan++;
754                 break;
755         }
756 }
757
758 static int onedigit_goto(struct ast_channel *chan, const char *context, char exten, int pri)
759 {
760         char rexten[2] = { exten, '\0' };
761
762         if (context) {
763                 if (!ast_goto_if_exists(chan, context, rexten, pri))
764                         return 1;
765         } else {
766                 if (!ast_goto_if_exists(chan, ast_channel_context(chan), rexten, pri))
767                         return 1;
768                 else if (!ast_strlen_zero(ast_channel_macrocontext(chan))) {
769                         if (!ast_goto_if_exists(chan, ast_channel_macrocontext(chan), rexten, pri))
770                                 return 1;
771                 }
772         }
773         return 0;
774 }
775
776 /* do not call with chan lock held */
777 static const char *get_cid_name(char *name, int namelen, struct ast_channel *chan)
778 {
779         const char *context;
780         const char *exten;
781
782         ast_channel_lock(chan);
783         context = ast_strdupa(S_OR(ast_channel_macrocontext(chan), ast_channel_context(chan)));
784         exten = ast_strdupa(S_OR(ast_channel_macroexten(chan), ast_channel_exten(chan)));
785         ast_channel_unlock(chan);
786
787         return ast_get_hint(NULL, 0, name, namelen, chan, context, exten) ? name : "";
788 }
789
790 static void senddialevent(struct ast_channel *src, struct ast_channel *dst, const char *dialstring)
791 {
792         struct ast_channel *chans[] = { src, dst };
793         ast_manager_event_multichan(EVENT_FLAG_CALL, "Dial", 2, chans,
794                 "SubEvent: Begin\r\n"
795                 "Channel: %s\r\n"
796                 "Destination: %s\r\n"
797                 "CallerIDNum: %s\r\n"
798                 "CallerIDName: %s\r\n"
799                 "ConnectedLineNum: %s\r\n"
800                 "ConnectedLineName: %s\r\n"
801                 "UniqueID: %s\r\n"
802                 "DestUniqueID: %s\r\n"
803                 "Dialstring: %s\r\n",
804                 ast_channel_name(src), ast_channel_name(dst),
805                 S_COR(src->caller.id.number.valid, src->caller.id.number.str, "<unknown>"),
806                 S_COR(src->caller.id.name.valid, src->caller.id.name.str, "<unknown>"),
807                 S_COR(src->connected.id.number.valid, src->connected.id.number.str, "<unknown>"),
808                 S_COR(src->connected.id.name.valid, src->connected.id.name.str, "<unknown>"),
809                 ast_channel_uniqueid(src), ast_channel_uniqueid(dst),
810                 dialstring ? dialstring : "");
811 }
812
813 static void senddialendevent(struct ast_channel *src, const char *dialstatus)
814 {
815         ast_manager_event(src, EVENT_FLAG_CALL, "Dial",
816                 "SubEvent: End\r\n"
817                 "Channel: %s\r\n"
818                 "UniqueID: %s\r\n"
819                 "DialStatus: %s\r\n",
820                 ast_channel_name(src), ast_channel_uniqueid(src), dialstatus);
821 }
822
823 /*!
824  * helper function for wait_for_answer()
825  *
826  * XXX this code is highly suspicious, as it essentially overwrites
827  * the outgoing channel without properly deleting it.
828  *
829  * \todo eventually this function should be intergrated into and replaced by ast_call_forward() 
830  */
831 static void do_forward(struct chanlist *o,
832         struct cause_args *num, struct ast_flags64 *peerflags, int single, int *to,
833         struct ast_party_id *forced_clid, struct ast_party_id *stored_clid)
834 {
835         char tmpchan[256];
836         struct ast_channel *original = o->chan;
837         struct ast_channel *c = o->chan; /* the winner */
838         struct ast_channel *in = num->chan; /* the input channel */
839         char *stuff;
840         char *tech;
841         int cause;
842         struct ast_party_caller caller;
843
844         ast_copy_string(tmpchan, ast_channel_call_forward(c), sizeof(tmpchan));
845         if ((stuff = strchr(tmpchan, '/'))) {
846                 *stuff++ = '\0';
847                 tech = tmpchan;
848         } else {
849                 const char *forward_context;
850                 ast_channel_lock(c);
851                 forward_context = pbx_builtin_getvar_helper(c, "FORWARD_CONTEXT");
852                 if (ast_strlen_zero(forward_context)) {
853                         forward_context = NULL;
854                 }
855                 snprintf(tmpchan, sizeof(tmpchan), "%s@%s", ast_channel_call_forward(c), forward_context ? forward_context : ast_channel_context(c));
856                 ast_channel_unlock(c);
857                 stuff = tmpchan;
858                 tech = "Local";
859         }
860
861         ast_cel_report_event(in, AST_CEL_FORWARD, NULL, ast_channel_call_forward(c), NULL);
862
863         /* Before processing channel, go ahead and check for forwarding */
864         ast_verb(3, "Now forwarding %s to '%s/%s' (thanks to %s)\n", ast_channel_name(in), tech, stuff, ast_channel_name(c));
865         /* If we have been told to ignore forwards, just set this channel to null and continue processing extensions normally */
866         if (ast_test_flag64(peerflags, OPT_IGNORE_FORWARDING)) {
867                 ast_verb(3, "Forwarding %s to '%s/%s' prevented.\n", ast_channel_name(in), tech, stuff);
868                 c = o->chan = NULL;
869                 cause = AST_CAUSE_BUSY;
870         } else {
871                 /* Setup parameters */
872                 c = o->chan = ast_request(tech, ast_channel_nativeformats(in), in, stuff, &cause);
873                 if (c) {
874                         if (single)
875                                 ast_channel_make_compatible(o->chan, in);
876                         ast_channel_inherit_variables(in, o->chan);
877                         ast_channel_datastore_inherit(in, o->chan);
878                         /* When a call is forwarded, we don't want to track new interfaces
879                          * dialed for CC purposes. Setting the done flag will ensure that
880                          * any Dial operations that happen later won't record CC interfaces.
881                          */
882                         ast_ignore_cc(o->chan);
883                         ast_log(LOG_NOTICE, "Not accepting call completion offers from call-forward recipient %s\n", ast_channel_name(o->chan));
884                 } else
885                         ast_log(LOG_NOTICE,
886                                 "Forwarding failed to create channel to dial '%s/%s' (cause = %d)\n",
887                                 tech, stuff, cause);
888         }
889         if (!c) {
890                 ast_clear_flag64(o, DIAL_STILLGOING);
891                 handle_cause(cause, num);
892                 ast_hangup(original);
893         } else {
894                 struct ast_party_redirecting redirecting;
895
896                 if (single && CAN_EARLY_BRIDGE(peerflags, c, in)) {
897                         ast_rtp_instance_early_bridge_make_compatible(c, in);
898                 }
899
900                 ast_channel_set_redirecting(c, &original->redirecting, NULL);
901                 ast_channel_lock(c);
902                 while (ast_channel_trylock(in)) {
903                         CHANNEL_DEADLOCK_AVOIDANCE(c);
904                 }
905                 if (!c->redirecting.from.number.valid
906                         || ast_strlen_zero(c->redirecting.from.number.str)) {
907                         /*
908                          * The call was not previously redirected so it is
909                          * now redirected from this number.
910                          */
911                         ast_party_number_free(&c->redirecting.from.number);
912                         ast_party_number_init(&c->redirecting.from.number);
913                         c->redirecting.from.number.valid = 1;
914                         c->redirecting.from.number.str =
915                                 ast_strdup(S_OR(ast_channel_macroexten(in), ast_channel_exten(in)));
916                 }
917
918                 c->dialed.transit_network_select = in->dialed.transit_network_select;
919
920                 /* Determine CallerID to store in outgoing channel. */
921                 ast_party_caller_set_init(&caller, &c->caller);
922                 if (ast_test_flag64(peerflags, OPT_ORIGINAL_CLID)) {
923                         caller.id = *stored_clid;
924                         ast_channel_set_caller_event(c, &caller, NULL);
925                 } else if (ast_strlen_zero(S_COR(c->caller.id.number.valid,
926                         c->caller.id.number.str, NULL))) {
927                         /*
928                          * The new channel has no preset CallerID number by the channel
929                          * driver.  Use the dialplan extension and hint name.
930                          */
931                         caller.id = *stored_clid;
932                         ast_channel_set_caller_event(c, &caller, NULL);
933                 }
934
935                 /* Determine CallerID for outgoing channel to send. */
936                 if (ast_test_flag64(o, OPT_FORCECLID)) {
937                         struct ast_party_connected_line connected;
938
939                         ast_party_connected_line_init(&connected);
940                         connected.id = *forced_clid;
941                         ast_party_connected_line_copy(&c->connected, &connected);
942                 } else {
943                         ast_connected_line_copy_from_caller(&c->connected, &in->caller);
944                 }
945
946                 ast_channel_accountcode_set(c, ast_channel_accountcode(in));
947
948                 ast_channel_appl_set(c, "AppDial");
949                 ast_channel_data_set(c, "(Outgoing Line)");
950                 /*
951                  * We must unlock c before calling ast_channel_redirecting_macro, because
952                  * we put c into autoservice there. That is pretty much a guaranteed
953                  * deadlock. This is why the handling of c's lock may seem a bit unusual
954                  * here.
955                  */
956                 ast_party_redirecting_init(&redirecting);
957                 ast_party_redirecting_copy(&redirecting, &c->redirecting);
958                 ast_channel_unlock(c);
959                 if (ast_channel_redirecting_sub(c, in, &redirecting, 0) &&
960                         ast_channel_redirecting_macro(c, in, &redirecting, 1, 0)) {
961                         ast_channel_update_redirecting(in, &redirecting, NULL);
962                 }
963                 ast_party_redirecting_free(&redirecting);
964                 ast_channel_unlock(in);
965
966                 ast_clear_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE);
967                 if (ast_test_flag64(peerflags, OPT_CANCEL_TIMEOUT)) {
968                         *to = -1;
969                 }
970
971                 if (ast_call(c, stuff, 0)) {
972                         ast_log(LOG_NOTICE, "Forwarding failed to dial '%s/%s'\n",
973                                 tech, stuff);
974                         ast_clear_flag64(o, DIAL_STILLGOING);
975                         ast_hangup(original);
976                         ast_hangup(c);
977                         c = o->chan = NULL;
978                         num->nochan++;
979                 } else {
980                         ast_channel_lock(c);
981                         while (ast_channel_trylock(in)) {
982                                 CHANNEL_DEADLOCK_AVOIDANCE(c);
983                         }
984                         senddialevent(in, c, stuff);
985                         ast_channel_unlock(in);
986                         ast_channel_unlock(c);
987                         /* Hangup the original channel now, in case we needed it */
988                         ast_hangup(original);
989                 }
990                 if (single) {
991                         ast_indicate(in, -1);
992                 }
993         }
994 }
995
996 /* argument used for some functions. */
997 struct privacy_args {
998         int sentringing;
999         int privdb_val;
1000         char privcid[256];
1001         char privintro[1024];
1002         char status[256];
1003 };
1004
1005 static struct ast_channel *wait_for_answer(struct ast_channel *in,
1006         struct chanlist *outgoing, int *to, struct ast_flags64 *peerflags,
1007         char *opt_args[],
1008         struct privacy_args *pa,
1009         const struct cause_args *num_in, int *result, char *dtmf_progress,
1010         const int ignore_cc,
1011         struct ast_party_id *forced_clid, struct ast_party_id *stored_clid)
1012 {
1013         struct cause_args num = *num_in;
1014         int prestart = num.busy + num.congestion + num.nochan;
1015         int orig = *to;
1016         struct ast_channel *peer = NULL;
1017         /* single is set if only one destination is enabled */
1018         int single = outgoing && !outgoing->next;
1019 #ifdef HAVE_EPOLL
1020         struct chanlist *epollo;
1021 #endif
1022         struct ast_party_connected_line connected_caller;
1023         struct ast_str *featurecode = ast_str_alloca(FEATURE_MAX_LEN + 1);
1024         int cc_recall_core_id;
1025         int is_cc_recall;
1026         int cc_frame_received = 0;
1027         int num_ringing = 0;
1028
1029         ast_party_connected_line_init(&connected_caller);
1030         if (single) {
1031                 /* Turn off hold music, etc */
1032                 if (!ast_test_flag64(outgoing, OPT_MUSICBACK | OPT_RINGBACK)) {
1033                         ast_deactivate_generator(in);
1034                         /* If we are calling a single channel, and not providing ringback or music, */
1035                         /* then, make them compatible for in-band tone purpose */
1036                         if (ast_channel_make_compatible(outgoing->chan, in) < 0) {
1037                                 /* If these channels can not be made compatible, 
1038                                  * there is no point in continuing.  The bridge
1039                                  * will just fail if it gets that far.
1040                                  */
1041                                 *to = -1;
1042                                 strcpy(pa->status, "CONGESTION");
1043                                 ast_cdr_failed(ast_channel_cdr(in));
1044                                 return NULL;
1045                         }
1046                 }
1047
1048                 if (!ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE) && !ast_test_flag64(outgoing, DIAL_CALLERID_ABSENT)) {
1049                         ast_channel_lock(outgoing->chan);
1050                         ast_connected_line_copy_from_caller(&connected_caller, &outgoing->chan->caller);
1051                         ast_channel_unlock(outgoing->chan);
1052                         connected_caller.source = AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER;
1053                         ast_channel_update_connected_line(in, &connected_caller, NULL);
1054                         ast_party_connected_line_free(&connected_caller);
1055                 }
1056         }
1057
1058         is_cc_recall = ast_cc_is_recall(in, &cc_recall_core_id, NULL);
1059
1060 #ifdef HAVE_EPOLL
1061         for (epollo = outgoing; epollo; epollo = epollo->next)
1062                 ast_poll_channel_add(in, epollo->chan);
1063 #endif
1064
1065         while (*to && !peer) {
1066                 struct chanlist *o;
1067                 int pos = 0; /* how many channels do we handle */
1068                 int numlines = prestart;
1069                 struct ast_channel *winner;
1070                 struct ast_channel *watchers[AST_MAX_WATCHERS];
1071
1072                 watchers[pos++] = in;
1073                 for (o = outgoing; o; o = o->next) {
1074                         /* Keep track of important channels */
1075                         if (ast_test_flag64(o, DIAL_STILLGOING) && o->chan)
1076                                 watchers[pos++] = o->chan;
1077                         numlines++;
1078                 }
1079                 if (pos == 1) { /* only the input channel is available */
1080                         if (numlines == (num.busy + num.congestion + num.nochan)) {
1081                                 ast_verb(2, "Everyone is busy/congested at this time (%d:%d/%d/%d)\n", numlines, num.busy, num.congestion, num.nochan);
1082                                 if (num.busy)
1083                                         strcpy(pa->status, "BUSY");
1084                                 else if (num.congestion)
1085                                         strcpy(pa->status, "CONGESTION");
1086                                 else if (num.nochan)
1087                                         strcpy(pa->status, "CHANUNAVAIL");
1088                         } else {
1089                                 ast_verb(3, "No one is available to answer at this time (%d:%d/%d/%d)\n", numlines, num.busy, num.congestion, num.nochan);
1090                         }
1091                         *to = 0;
1092                         if (is_cc_recall) {
1093                                 ast_cc_failed(cc_recall_core_id, "Everyone is busy/congested for the recall. How sad");
1094                         }
1095                         return NULL;
1096                 }
1097                 winner = ast_waitfor_n(watchers, pos, to);
1098                 for (o = outgoing; o; o = o->next) {
1099                         struct ast_frame *f;
1100                         struct ast_channel *c = o->chan;
1101
1102                         if (c == NULL)
1103                                 continue;
1104                         if (ast_test_flag64(o, DIAL_STILLGOING) && ast_channel_state(c) == AST_STATE_UP) {
1105                                 if (!peer) {
1106                                         ast_verb(3, "%s answered %s\n", ast_channel_name(c), ast_channel_name(in));
1107                                         if (!single && !ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE)) {
1108                                                 if (o->pending_connected_update) {
1109                                                         if (ast_channel_connected_line_sub(c, in, &o->connected, 0) &&
1110                                                                 ast_channel_connected_line_macro(c, in, &o->connected, 1, 0)) {
1111                                                                 ast_channel_update_connected_line(in, &o->connected, NULL);
1112                                                         }
1113                                                 } else if (!ast_test_flag64(o, DIAL_CALLERID_ABSENT)) {
1114                                                         ast_channel_lock(c);
1115                                                         ast_connected_line_copy_from_caller(&connected_caller, &c->caller);
1116                                                         ast_channel_unlock(c);
1117                                                         connected_caller.source = AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER;
1118                                                         ast_channel_update_connected_line(in, &connected_caller, NULL);
1119                                                         ast_party_connected_line_free(&connected_caller);
1120                                                 }
1121                                         }
1122                                         if (o->aoc_s_rate_list) {
1123                                                 size_t encoded_size;
1124                                                 struct ast_aoc_encoded *encoded;
1125                                                 if ((encoded = ast_aoc_encode(o->aoc_s_rate_list, &encoded_size, o->chan))) {
1126                                                         ast_indicate_data(in, AST_CONTROL_AOC, encoded, encoded_size);
1127                                                         ast_aoc_destroy_encoded(encoded);
1128                                                 }
1129                                         }
1130                                         peer = c;
1131                                         ast_copy_flags64(peerflags, o,
1132                                                 OPT_CALLEE_TRANSFER | OPT_CALLER_TRANSFER |
1133                                                 OPT_CALLEE_HANGUP | OPT_CALLER_HANGUP |
1134                                                 OPT_CALLEE_MONITOR | OPT_CALLER_MONITOR |
1135                                                 OPT_CALLEE_PARK | OPT_CALLER_PARK |
1136                                                 OPT_CALLEE_MIXMONITOR | OPT_CALLER_MIXMONITOR |
1137                                                 DIAL_NOFORWARDHTML);
1138                                         ast_channel_dialcontext_set(c, "");
1139                                         ast_channel_exten_set(c, "");
1140                                 }
1141                                 continue;
1142                         }
1143                         if (c != winner)
1144                                 continue;
1145                         /* here, o->chan == c == winner */
1146                         if (!ast_strlen_zero(ast_channel_call_forward(c))) {
1147                                 pa->sentringing = 0;
1148                                 if (!ignore_cc && (f = ast_read(c))) {
1149                                         if (f->frametype == AST_FRAME_CONTROL && f->subclass.integer == AST_CONTROL_CC) {
1150                                                 /* This channel is forwarding the call, and is capable of CC, so
1151                                                  * be sure to add the new device interface to the list
1152                                                  */
1153                                                 ast_handle_cc_control_frame(in, c, f->data.ptr);
1154                                         }
1155                                         ast_frfree(f);
1156                                 }
1157                                 do_forward(o, &num, peerflags, single, to, forced_clid, stored_clid);
1158                                 continue;
1159                         }
1160                         f = ast_read(winner);
1161                         if (!f) {
1162                                 ast_channel_hangupcause_set(in, ast_channel_hangupcause(c));
1163 #ifdef HAVE_EPOLL
1164                                 ast_poll_channel_del(in, c);
1165 #endif
1166                                 ast_hangup(c);
1167                                 c = o->chan = NULL;
1168                                 ast_clear_flag64(o, DIAL_STILLGOING);
1169                                 handle_cause(ast_channel_hangupcause(in), &num);
1170                                 continue;
1171                         }
1172                         if (f->frametype == AST_FRAME_CONTROL) {
1173                                 switch (f->subclass.integer) {
1174                                 case AST_CONTROL_ANSWER:
1175                                         /* This is our guy if someone answered. */
1176                                         if (!peer) {
1177                                                 ast_verb(3, "%s answered %s\n", ast_channel_name(c), ast_channel_name(in));
1178                                                 if (!single && !ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE)) {
1179                                                         if (o->pending_connected_update) {
1180                                                                 if (ast_channel_connected_line_sub(c, in, &o->connected, 0) &&
1181                                                                         ast_channel_connected_line_macro(c, in, &o->connected, 1, 0)) {
1182                                                                         ast_channel_update_connected_line(in, &o->connected, NULL);
1183                                                                 }
1184                                                         } else if (!ast_test_flag64(o, DIAL_CALLERID_ABSENT)) {
1185                                                                 ast_channel_lock(c);
1186                                                                 ast_connected_line_copy_from_caller(&connected_caller, &c->caller);
1187                                                                 ast_channel_unlock(c);
1188                                                                 connected_caller.source = AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER;
1189                                                                 ast_channel_update_connected_line(in, &connected_caller, NULL);
1190                                                                 ast_party_connected_line_free(&connected_caller);
1191                                                         }
1192                                                 }
1193                                                 if (o->aoc_s_rate_list) {
1194                                                         size_t encoded_size;
1195                                                         struct ast_aoc_encoded *encoded;
1196                                                         if ((encoded = ast_aoc_encode(o->aoc_s_rate_list, &encoded_size, o->chan))) {
1197                                                                 ast_indicate_data(in, AST_CONTROL_AOC, encoded, encoded_size);
1198                                                                 ast_aoc_destroy_encoded(encoded);
1199                                                         }
1200                                                 }
1201                                                 peer = c;
1202                                                 if (ast_channel_cdr(peer)) {
1203                                                         ast_channel_cdr(peer)->answer = ast_tvnow();
1204                                                         ast_channel_cdr(peer)->disposition = AST_CDR_ANSWERED;
1205                                                 }
1206                                                 ast_copy_flags64(peerflags, o,
1207                                                         OPT_CALLEE_TRANSFER | OPT_CALLER_TRANSFER |
1208                                                         OPT_CALLEE_HANGUP | OPT_CALLER_HANGUP |
1209                                                         OPT_CALLEE_MONITOR | OPT_CALLER_MONITOR |
1210                                                         OPT_CALLEE_PARK | OPT_CALLER_PARK |
1211                                                         OPT_CALLEE_MIXMONITOR | OPT_CALLER_MIXMONITOR |
1212                                                         DIAL_NOFORWARDHTML);
1213                                                 ast_channel_dialcontext_set(c, "");
1214                                                 ast_channel_exten_set(c, "");
1215                                                 if (CAN_EARLY_BRIDGE(peerflags, in, peer))
1216                                                         /* Setup early bridge if appropriate */
1217                                                         ast_channel_early_bridge(in, peer);
1218                                         }
1219                                         /* If call has been answered, then the eventual hangup is likely to be normal hangup */
1220                                         ast_channel_hangupcause_set(in, AST_CAUSE_NORMAL_CLEARING);
1221                                         ast_channel_hangupcause_set(c, AST_CAUSE_NORMAL_CLEARING);
1222                                         break;
1223                                 case AST_CONTROL_BUSY:
1224                                         ast_verb(3, "%s is busy\n", ast_channel_name(c));
1225                                         ast_channel_hangupcause_set(in, ast_channel_hangupcause(c));
1226                                         ast_hangup(c);
1227                                         c = o->chan = NULL;
1228                                         ast_clear_flag64(o, DIAL_STILLGOING);
1229                                         handle_cause(AST_CAUSE_BUSY, &num);
1230                                         break;
1231                                 case AST_CONTROL_CONGESTION:
1232                                         ast_verb(3, "%s is circuit-busy\n", ast_channel_name(c));
1233                                         ast_channel_hangupcause_set(in, ast_channel_hangupcause(c));
1234                                         ast_hangup(c);
1235                                         c = o->chan = NULL;
1236                                         ast_clear_flag64(o, DIAL_STILLGOING);
1237                                         handle_cause(AST_CAUSE_CONGESTION, &num);
1238                                         break;
1239                                 case AST_CONTROL_RINGING:
1240                                         /* This is a tricky area to get right when using a native
1241                                          * CC agent. The reason is that we do the best we can to send only a
1242                                          * single ringing notification to the caller.
1243                                          *
1244                                          * Call completion complicates the logic used here. CCNR is typically
1245                                          * offered during a ringing message. Let's say that party A calls
1246                                          * parties B, C, and D. B and C do not support CC requests, but D
1247                                          * does. If we were to receive a ringing notification from B before
1248                                          * the others, then we would end up sending a ringing message to
1249                                          * A with no CCNR offer present.
1250                                          *
1251                                          * The approach that we have taken is that if we receive a ringing
1252                                          * response from a party and no CCNR offer is present, we need to
1253                                          * wait. Specifically, we need to wait until either a) a called party
1254                                          * offers CCNR in its ringing response or b) all called parties have
1255                                          * responded in some way to our call and none offers CCNR.
1256                                          *
1257                                          * The drawback to this is that if one of the parties has a delayed
1258                                          * response or, god forbid, one just plain doesn't respond to our
1259                                          * outgoing call, then this will result in a significant delay between
1260                                          * when the caller places the call and hears ringback.
1261                                          *
1262                                          * Note also that if CC is disabled for this call, then it is perfectly
1263                                          * fine for ringing frames to get sent through.
1264                                          */
1265                                         ++num_ringing;
1266                                         if (ignore_cc || cc_frame_received || num_ringing == numlines) {
1267                                                 ast_verb(3, "%s is ringing\n", ast_channel_name(c));
1268                                                 /* Setup early media if appropriate */
1269                                                 if (single && CAN_EARLY_BRIDGE(peerflags, in, c))
1270                                                         ast_channel_early_bridge(in, c);
1271                                                 if (!(pa->sentringing) && !ast_test_flag64(outgoing, OPT_MUSICBACK) && ast_strlen_zero(opt_args[OPT_ARG_RINGBACK])) {
1272                                                         ast_indicate(in, AST_CONTROL_RINGING);
1273                                                         pa->sentringing++;
1274                                                 }
1275                                         }
1276                                         break;
1277                                 case AST_CONTROL_PROGRESS:
1278                                         ast_verb(3, "%s is making progress passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
1279                                         /* Setup early media if appropriate */
1280                                         if (single && CAN_EARLY_BRIDGE(peerflags, in, c))
1281                                                 ast_channel_early_bridge(in, c);
1282                                         if (!ast_test_flag64(outgoing, OPT_RINGBACK)) {
1283                                                 if (single || (!single && !pa->sentringing)) {
1284                                                         ast_indicate(in, AST_CONTROL_PROGRESS);
1285                                                 }
1286                                         }
1287                                         if (!ast_strlen_zero(dtmf_progress)) {
1288                                                 ast_verb(3,
1289                                                         "Sending DTMF '%s' to the called party as result of receiving a PROGRESS message.\n",
1290                                                         dtmf_progress);
1291                                                 ast_dtmf_stream(c, in, dtmf_progress, 250, 0);
1292                                         }
1293                                         break;
1294                                 case AST_CONTROL_VIDUPDATE:
1295                                         ast_verb(3, "%s requested a video update, passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
1296                                         ast_indicate(in, AST_CONTROL_VIDUPDATE);
1297                                         break;
1298                                 case AST_CONTROL_SRCUPDATE:
1299                                         ast_verb(3, "%s requested a source update, passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
1300                                         ast_indicate(in, AST_CONTROL_SRCUPDATE);
1301                                         break;
1302                                 case AST_CONTROL_CONNECTED_LINE:
1303                                         if (ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE)) {
1304                                                 ast_verb(3, "Connected line update to %s prevented.\n", ast_channel_name(in));
1305                                         } else if (!single) {
1306                                                 struct ast_party_connected_line connected;
1307                                                 ast_verb(3, "%s connected line has changed. Saving it until answer for %s\n", ast_channel_name(c), ast_channel_name(in));
1308                                                 ast_party_connected_line_set_init(&connected, &o->connected);
1309                                                 ast_connected_line_parse_data(f->data.ptr, f->datalen, &connected);
1310                                                 ast_party_connected_line_set(&o->connected, &connected, NULL);
1311                                                 ast_party_connected_line_free(&connected);
1312                                                 o->pending_connected_update = 1;
1313                                         } else {
1314                                                 if (ast_channel_connected_line_sub(c, in, f, 1) &&
1315                                                         ast_channel_connected_line_macro(c, in, f, 1, 1)) {
1316                                                         ast_indicate_data(in, AST_CONTROL_CONNECTED_LINE, f->data.ptr, f->datalen);
1317                                                 }
1318                                         }
1319                                         break;
1320                                 case AST_CONTROL_AOC:
1321                                         {
1322                                                 struct ast_aoc_decoded *decoded = ast_aoc_decode(f->data.ptr, f->datalen, o->chan);
1323                                                 if (decoded && (ast_aoc_get_msg_type(decoded) == AST_AOC_S)) {
1324                                                         ast_aoc_destroy_decoded(o->aoc_s_rate_list);
1325                                                         o->aoc_s_rate_list = decoded;
1326                                                 } else {
1327                                                         ast_aoc_destroy_decoded(decoded);
1328                                                 }
1329                                         }
1330                                         break;
1331                                 case AST_CONTROL_REDIRECTING:
1332                                         if (ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE)) {
1333                                                 ast_verb(3, "Redirecting update to %s prevented.\n", ast_channel_name(in));
1334                                         } else if (single) {
1335                                                 ast_verb(3, "%s redirecting info has changed, passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
1336                                                 if (ast_channel_redirecting_sub(c, in, f, 1) &&
1337                                                         ast_channel_redirecting_macro(c, in, f, 1, 1)) {
1338                                                         ast_indicate_data(in, AST_CONTROL_REDIRECTING, f->data.ptr, f->datalen);
1339                                                 }
1340                                                 pa->sentringing = 0;
1341                                         }
1342                                         break;
1343                                 case AST_CONTROL_PROCEEDING:
1344                                         ast_verb(3, "%s is proceeding passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
1345                                         if (single && CAN_EARLY_BRIDGE(peerflags, in, c))
1346                                                 ast_channel_early_bridge(in, c);
1347                                         if (!ast_test_flag64(outgoing, OPT_RINGBACK))
1348                                                 ast_indicate(in, AST_CONTROL_PROCEEDING);
1349                                         break;
1350                                 case AST_CONTROL_HOLD:
1351                                         ast_verb(3, "Call on %s placed on hold\n", ast_channel_name(c));
1352                                         ast_indicate(in, AST_CONTROL_HOLD);
1353                                         break;
1354                                 case AST_CONTROL_UNHOLD:
1355                                         ast_verb(3, "Call on %s left from hold\n", ast_channel_name(c));
1356                                         ast_indicate(in, AST_CONTROL_UNHOLD);
1357                                         break;
1358                                 case AST_CONTROL_OFFHOOK:
1359                                 case AST_CONTROL_FLASH:
1360                                         /* Ignore going off hook and flash */
1361                                         break;
1362                                 case AST_CONTROL_CC:
1363                                         if (!ignore_cc) {
1364                                                 ast_handle_cc_control_frame(in, c, f->data.ptr);
1365                                                 cc_frame_received = 1;
1366                                         }
1367                                         break;
1368                                 case -1:
1369                                         if (!ast_test_flag64(outgoing, OPT_RINGBACK | OPT_MUSICBACK)) {
1370                                                 ast_verb(3, "%s stopped sounds\n", ast_channel_name(c));
1371                                                 ast_indicate(in, -1);
1372                                                 pa->sentringing = 0;
1373                                         }
1374                                         break;
1375                                 default:
1376                                         ast_debug(1, "Dunno what to do with control type %d\n", f->subclass.integer);
1377                                 }
1378                         } else if (single) {
1379                                 switch (f->frametype) {
1380                                 case AST_FRAME_VOICE:
1381                                 case AST_FRAME_IMAGE:
1382                                 case AST_FRAME_TEXT:
1383                                         if (!ast_test_flag64(outgoing, OPT_RINGBACK | OPT_MUSICBACK) && ast_write(in, f)) {
1384                                                 ast_log(LOG_WARNING, "Unable to write frametype: %d\n",
1385                                                         f->frametype);
1386                                         }
1387                                         break;
1388                                 case AST_FRAME_HTML:
1389                                         if (!ast_test_flag64(outgoing, DIAL_NOFORWARDHTML)
1390                                                 && ast_channel_sendhtml(in, f->subclass.integer, f->data.ptr, f->datalen) == -1) {
1391                                                 ast_log(LOG_WARNING, "Unable to send URL\n");
1392                                         }
1393                                         break;
1394                                 default:
1395                                         break;
1396                                 }
1397                         }
1398                         ast_frfree(f);
1399                 } /* end for */
1400                 if (winner == in) {
1401                         struct ast_frame *f = ast_read(in);
1402 #if 0
1403                         if (f && (f->frametype != AST_FRAME_VOICE))
1404                                 printf("Frame type: %d, %d\n", f->frametype, f->subclass);
1405                         else if (!f || (f->frametype != AST_FRAME_VOICE))
1406                                 printf("Hangup received on %s\n", in->name);
1407 #endif
1408                         if (!f || ((f->frametype == AST_FRAME_CONTROL) && (f->subclass.integer == AST_CONTROL_HANGUP))) {
1409                                 /* Got hung up */
1410                                 *to = -1;
1411                                 strcpy(pa->status, "CANCEL");
1412                                 ast_cdr_noanswer(ast_channel_cdr(in));
1413                                 if (f) {
1414                                         if (f->data.uint32) {
1415                                                 ast_channel_hangupcause_set(in, f->data.uint32);
1416                                         }
1417                                         ast_frfree(f);
1418                                 }
1419                                 if (is_cc_recall) {
1420                                         ast_cc_completed(in, "CC completed, although the caller hung up (cancelled)");
1421                                 }
1422                                 return NULL;
1423                         }
1424
1425                         /* now f is guaranteed non-NULL */
1426                         if (f->frametype == AST_FRAME_DTMF) {
1427                                 if (ast_test_flag64(peerflags, OPT_DTMF_EXIT)) {
1428                                         const char *context;
1429                                         ast_channel_lock(in);
1430                                         context = pbx_builtin_getvar_helper(in, "EXITCONTEXT");
1431                                         if (onedigit_goto(in, context, (char) f->subclass.integer, 1)) {
1432                                                 ast_verb(3, "User hit %c to disconnect call.\n", f->subclass.integer);
1433                                                 *to = 0;
1434                                                 ast_cdr_noanswer(ast_channel_cdr(in));
1435                                                 *result = f->subclass.integer;
1436                                                 strcpy(pa->status, "CANCEL");
1437                                                 ast_frfree(f);
1438                                                 ast_channel_unlock(in);
1439                                                 if (is_cc_recall) {
1440                                                         ast_cc_completed(in, "CC completed, but the caller used DTMF to exit");
1441                                                 }
1442                                                 return NULL;
1443                                         }
1444                                         ast_channel_unlock(in);
1445                                 }
1446
1447                                 if (ast_test_flag64(peerflags, OPT_CALLER_HANGUP) &&
1448                                         detect_disconnect(in, f->subclass.integer, featurecode)) {
1449                                         ast_verb(3, "User requested call disconnect.\n");
1450                                         *to = 0;
1451                                         strcpy(pa->status, "CANCEL");
1452                                         ast_cdr_noanswer(ast_channel_cdr(in));
1453                                         ast_frfree(f);
1454                                         if (is_cc_recall) {
1455                                                 ast_cc_completed(in, "CC completed, but the caller hung up with DTMF");
1456                                         }
1457                                         return NULL;
1458                                 }
1459                         }
1460
1461                         /* Send the frame from the in channel to all outgoing channels. */
1462                         for (o = outgoing; o; o = o->next) {
1463                                 if (!o->chan || !ast_test_flag64(o, DIAL_STILLGOING)) {
1464                                         /* This outgoing channel has died so don't send the frame to it. */
1465                                         continue;
1466                                 }
1467                                 switch (f->frametype) {
1468                                 case AST_FRAME_HTML:
1469                                         /* Forward HTML stuff */
1470                                         if (!ast_test_flag64(o, DIAL_NOFORWARDHTML)
1471                                                 && ast_channel_sendhtml(o->chan, f->subclass.integer, f->data.ptr, f->datalen) == -1) {
1472                                                 ast_log(LOG_WARNING, "Unable to send URL\n");
1473                                         }
1474                                         break;
1475                                 case AST_FRAME_VOICE:
1476                                 case AST_FRAME_IMAGE:
1477                                 case AST_FRAME_TEXT:
1478                                 case AST_FRAME_DTMF_BEGIN:
1479                                 case AST_FRAME_DTMF_END:
1480                                         if (ast_write(o->chan, f)) {
1481                                                 ast_log(LOG_WARNING, "Unable to forward frametype: %d\n",
1482                                                         f->frametype);
1483                                         }
1484                                         break;
1485                                 case AST_FRAME_CONTROL:
1486                                         switch (f->subclass.integer) {
1487                                         case AST_CONTROL_HOLD:
1488                                         case AST_CONTROL_UNHOLD:
1489                                         case AST_CONTROL_VIDUPDATE:
1490                                         case AST_CONTROL_SRCUPDATE:
1491                                                 ast_verb(3, "%s requested special control %d, passing it to %s\n",
1492                                                         ast_channel_name(in), f->subclass.integer, ast_channel_name(o->chan));
1493                                                 ast_indicate_data(o->chan, f->subclass.integer, f->data.ptr, f->datalen);
1494                                                 break;
1495                                         case AST_CONTROL_CONNECTED_LINE:
1496                                                 if (ast_channel_connected_line_sub(in, o->chan, f, 1) &&
1497                                                         ast_channel_connected_line_macro(in, o->chan, f, 0, 1)) {
1498                                                         ast_indicate_data(o->chan, f->subclass.integer, f->data.ptr, f->datalen);
1499                                                 }
1500                                                 break;
1501                                         case AST_CONTROL_REDIRECTING:
1502                                                 if (ast_channel_redirecting_sub(in, o->chan, f, 1) &&
1503                                                         ast_channel_redirecting_macro(in, o->chan, f, 0, 1)) {
1504                                                         ast_indicate_data(o->chan, f->subclass.integer, f->data.ptr, f->datalen);
1505                                                 }
1506                                                 break;
1507                                         default:
1508                                                 break;
1509                                         }
1510                                         break;
1511                                 default:
1512                                         break;
1513                                 }
1514                         }
1515                         ast_frfree(f);
1516                 }
1517                 if (!*to)
1518                         ast_verb(3, "Nobody picked up in %d ms\n", orig);
1519                 if (!*to || ast_check_hangup(in))
1520                         ast_cdr_noanswer(ast_channel_cdr(in));
1521         }
1522
1523 #ifdef HAVE_EPOLL
1524         for (epollo = outgoing; epollo; epollo = epollo->next) {
1525                 if (epollo->chan)
1526                         ast_poll_channel_del(in, epollo->chan);
1527         }
1528 #endif
1529
1530         if (is_cc_recall) {
1531                 ast_cc_completed(in, "Recall completed!");
1532         }
1533         return peer;
1534 }
1535
1536 static int detect_disconnect(struct ast_channel *chan, char code, struct ast_str *featurecode)
1537 {
1538         struct ast_flags features = { AST_FEATURE_DISCONNECT }; /* only concerned with disconnect feature */
1539         struct ast_call_feature feature = { 0, };
1540         int res;
1541
1542         ast_str_append(&featurecode, 1, "%c", code);
1543
1544         res = ast_feature_detect(chan, &features, ast_str_buffer(featurecode), &feature);
1545
1546         if (res != AST_FEATURE_RETURN_STOREDIGITS) {
1547                 ast_str_reset(featurecode);
1548         }
1549         if (feature.feature_mask & AST_FEATURE_DISCONNECT) {
1550                 return 1;
1551         }
1552
1553         return 0;
1554 }
1555
1556 static void replace_macro_delimiter(char *s)
1557 {
1558         for (; *s; s++)
1559                 if (*s == '^')
1560                         *s = ',';
1561 }
1562
1563 /* returns true if there is a valid privacy reply */
1564 static int valid_priv_reply(struct ast_flags64 *opts, int res)
1565 {
1566         if (res < '1')
1567                 return 0;
1568         if (ast_test_flag64(opts, OPT_PRIVACY) && res <= '5')
1569                 return 1;
1570         if (ast_test_flag64(opts, OPT_SCREENING) && res <= '4')
1571                 return 1;
1572         return 0;
1573 }
1574
1575 static int do_privacy(struct ast_channel *chan, struct ast_channel *peer,
1576         struct ast_flags64 *opts, char **opt_args, struct privacy_args *pa)
1577 {
1578
1579         int res2;
1580         int loopcount = 0;
1581
1582         /* Get the user's intro, store it in priv-callerintros/$CID,
1583            unless it is already there-- this should be done before the
1584            call is actually dialed  */
1585
1586         /* all ring indications and moh for the caller has been halted as soon as the
1587            target extension was picked up. We are going to have to kill some
1588            time and make the caller believe the peer hasn't picked up yet */
1589
1590         if (ast_test_flag64(opts, OPT_MUSICBACK) && !ast_strlen_zero(opt_args[OPT_ARG_MUSICBACK])) {
1591                 char *original_moh = ast_strdupa(ast_channel_musicclass(chan));
1592                 ast_indicate(chan, -1);
1593                 ast_channel_musicclass_set(chan, opt_args[OPT_ARG_MUSICBACK]);
1594                 ast_moh_start(chan, opt_args[OPT_ARG_MUSICBACK], NULL);
1595                 ast_channel_musicclass_set(chan, original_moh);
1596         } else if (ast_test_flag64(opts, OPT_RINGBACK)) {
1597                 ast_indicate(chan, AST_CONTROL_RINGING);
1598                 pa->sentringing++;
1599         }
1600
1601         /* Start autoservice on the other chan ?? */
1602         res2 = ast_autoservice_start(chan);
1603         /* Now Stream the File */
1604         for (loopcount = 0; loopcount < 3; loopcount++) {
1605                 if (res2 && loopcount == 0) /* error in ast_autoservice_start() */
1606                         break;
1607                 if (!res2) /* on timeout, play the message again */
1608                         res2 = ast_play_and_wait(peer, "priv-callpending");
1609                 if (!valid_priv_reply(opts, res2))
1610                         res2 = 0;
1611                 /* priv-callpending script:
1612                    "I have a caller waiting, who introduces themselves as:"
1613                 */
1614                 if (!res2)
1615                         res2 = ast_play_and_wait(peer, pa->privintro);
1616                 if (!valid_priv_reply(opts, res2))
1617                         res2 = 0;
1618                 /* now get input from the called party, as to their choice */
1619                 if (!res2) {
1620                         /* XXX can we have both, or they are mutually exclusive ? */
1621                         if (ast_test_flag64(opts, OPT_PRIVACY))
1622                                 res2 = ast_play_and_wait(peer, "priv-callee-options");
1623                         if (ast_test_flag64(opts, OPT_SCREENING))
1624                                 res2 = ast_play_and_wait(peer, "screen-callee-options");
1625                 }
1626                 /*! \page DialPrivacy Dial Privacy scripts
1627                 \par priv-callee-options script:
1628                         "Dial 1 if you wish this caller to reach you directly in the future,
1629                                 and immediately connect to their incoming call
1630                          Dial 2 if you wish to send this caller to voicemail now and
1631                                 forevermore.
1632                          Dial 3 to send this caller to the torture menus, now and forevermore.
1633                          Dial 4 to send this caller to a simple "go away" menu, now and forevermore.
1634                          Dial 5 to allow this caller to come straight thru to you in the future,
1635                                 but right now, just this once, send them to voicemail."
1636                 \par screen-callee-options script:
1637                         "Dial 1 if you wish to immediately connect to the incoming call
1638                          Dial 2 if you wish to send this caller to voicemail.
1639                          Dial 3 to send this caller to the torture menus.
1640                          Dial 4 to send this caller to a simple "go away" menu.
1641                 */
1642                 if (valid_priv_reply(opts, res2))
1643                         break;
1644                 /* invalid option */
1645                 res2 = ast_play_and_wait(peer, "vm-sorry");
1646         }
1647
1648         if (ast_test_flag64(opts, OPT_MUSICBACK)) {
1649                 ast_moh_stop(chan);
1650         } else if (ast_test_flag64(opts, OPT_RINGBACK)) {
1651                 ast_indicate(chan, -1);
1652                 pa->sentringing = 0;
1653         }
1654         ast_autoservice_stop(chan);
1655         if (ast_test_flag64(opts, OPT_PRIVACY) && (res2 >= '1' && res2 <= '5')) {
1656                 /* map keypresses to various things, the index is res2 - '1' */
1657                 static const char * const _val[] = { "ALLOW", "DENY", "TORTURE", "KILL", "ALLOW" };
1658                 static const int _flag[] = { AST_PRIVACY_ALLOW, AST_PRIVACY_DENY, AST_PRIVACY_TORTURE, AST_PRIVACY_KILL, AST_PRIVACY_ALLOW};
1659                 int i = res2 - '1';
1660                 ast_verb(3, "--Set privacy database entry %s/%s to %s\n",
1661                         opt_args[OPT_ARG_PRIVACY], pa->privcid, _val[i]);
1662                 ast_privacy_set(opt_args[OPT_ARG_PRIVACY], pa->privcid, _flag[i]);
1663         }
1664         switch (res2) {
1665         case '1':
1666                 break;
1667         case '2':
1668                 ast_copy_string(pa->status, "NOANSWER", sizeof(pa->status));
1669                 break;
1670         case '3':
1671                 ast_copy_string(pa->status, "TORTURE", sizeof(pa->status));
1672                 break;
1673         case '4':
1674                 ast_copy_string(pa->status, "DONTCALL", sizeof(pa->status));
1675                 break;
1676         case '5':
1677                 /* XXX should we set status to DENY ? */
1678                 if (ast_test_flag64(opts, OPT_PRIVACY))
1679                         break;
1680                 /* if not privacy, then 5 is the same as "default" case */
1681         default: /* bad input or -1 if failure to start autoservice */
1682                 /* well, if the user messes up, ... he had his chance... What Is The Best Thing To Do?  */
1683                 /* well, there seems basically two choices. Just patch the caller thru immediately,
1684                           or,... put 'em thru to voicemail. */
1685                 /* since the callee may have hung up, let's do the voicemail thing, no database decision */
1686                 ast_log(LOG_NOTICE, "privacy: no valid response from the callee. Sending the caller to voicemail, the callee isn't responding\n");
1687                 /* XXX should we set status to DENY ? */
1688                 /* XXX what about the privacy flags ? */
1689                 break;
1690         }
1691
1692         if (res2 == '1') { /* the only case where we actually connect */
1693                 /* if the intro is NOCALLERID, then there's no reason to leave it on disk, it'll
1694                    just clog things up, and it's not useful information, not being tied to a CID */
1695                 if (strncmp(pa->privcid, "NOCALLERID", 10) == 0 || ast_test_flag64(opts, OPT_SCREEN_NOINTRO)) {
1696                         ast_filedelete(pa->privintro, NULL);
1697                         if (ast_fileexists(pa->privintro, NULL, NULL) > 0)
1698                                 ast_log(LOG_NOTICE, "privacy: ast_filedelete didn't do its job on %s\n", pa->privintro);
1699                         else
1700                                 ast_verb(3, "Successfully deleted %s intro file\n", pa->privintro);
1701                 }
1702                 return 0; /* the good exit path */
1703         } else {
1704                 ast_hangup(peer); /* hang up on the callee -- he didn't want to talk anyway! */
1705                 return -1;
1706         }
1707 }
1708
1709 /*! \brief returns 1 if successful, 0 or <0 if the caller should 'goto out' */
1710 static int setup_privacy_args(struct privacy_args *pa,
1711         struct ast_flags64 *opts, char *opt_args[], struct ast_channel *chan)
1712 {
1713         char callerid[60];
1714         int res;
1715         char *l;
1716
1717         if (chan->caller.id.number.valid
1718                 && !ast_strlen_zero(chan->caller.id.number.str)) {
1719                 l = ast_strdupa(chan->caller.id.number.str);
1720                 ast_shrink_phone_number(l);
1721                 if (ast_test_flag64(opts, OPT_PRIVACY) ) {
1722                         ast_verb(3, "Privacy DB is '%s', clid is '%s'\n", opt_args[OPT_ARG_PRIVACY], l);
1723                         pa->privdb_val = ast_privacy_check(opt_args[OPT_ARG_PRIVACY], l);
1724                 } else {
1725                         ast_verb(3, "Privacy Screening, clid is '%s'\n", l);
1726                         pa->privdb_val = AST_PRIVACY_UNKNOWN;
1727                 }
1728         } else {
1729                 char *tnam, *tn2;
1730
1731                 tnam = ast_strdupa(ast_channel_name(chan));
1732                 /* clean the channel name so slashes don't try to end up in disk file name */
1733                 for (tn2 = tnam; *tn2; tn2++) {
1734                         if (*tn2 == '/')  /* any other chars to be afraid of? */
1735                                 *tn2 = '=';
1736                 }
1737                 ast_verb(3, "Privacy-- callerid is empty\n");
1738
1739                 snprintf(callerid, sizeof(callerid), "NOCALLERID_%s%s", ast_channel_exten(chan), tnam);
1740                 l = callerid;
1741                 pa->privdb_val = AST_PRIVACY_UNKNOWN;
1742         }
1743
1744         ast_copy_string(pa->privcid, l, sizeof(pa->privcid));
1745
1746         if (strncmp(pa->privcid, "NOCALLERID", 10) != 0 && ast_test_flag64(opts, OPT_SCREEN_NOCALLERID)) {
1747                 /* if callerid is set and OPT_SCREEN_NOCALLERID is set also */
1748                 ast_verb(3, "CallerID set (%s); N option set; Screening should be off\n", pa->privcid);
1749                 pa->privdb_val = AST_PRIVACY_ALLOW;
1750         } else if (ast_test_flag64(opts, OPT_SCREEN_NOCALLERID) && strncmp(pa->privcid, "NOCALLERID", 10) == 0) {
1751                 ast_verb(3, "CallerID blank; N option set; Screening should happen; dbval is %d\n", pa->privdb_val);
1752         }
1753         
1754         if (pa->privdb_val == AST_PRIVACY_DENY) {
1755                 ast_verb(3, "Privacy DB reports PRIVACY_DENY for this callerid. Dial reports unavailable\n");
1756                 ast_copy_string(pa->status, "NOANSWER", sizeof(pa->status));
1757                 return 0;
1758         } else if (pa->privdb_val == AST_PRIVACY_KILL) {
1759                 ast_copy_string(pa->status, "DONTCALL", sizeof(pa->status));
1760                 return 0; /* Is this right? */
1761         } else if (pa->privdb_val == AST_PRIVACY_TORTURE) {
1762                 ast_copy_string(pa->status, "TORTURE", sizeof(pa->status));
1763                 return 0; /* is this right??? */
1764         } else if (pa->privdb_val == AST_PRIVACY_UNKNOWN) {
1765                 /* Get the user's intro, store it in priv-callerintros/$CID,
1766                    unless it is already there-- this should be done before the
1767                    call is actually dialed  */
1768
1769                 /* make sure the priv-callerintros dir actually exists */
1770                 snprintf(pa->privintro, sizeof(pa->privintro), "%s/sounds/priv-callerintros", ast_config_AST_DATA_DIR);
1771                 if ((res = ast_mkdir(pa->privintro, 0755))) {
1772                         ast_log(LOG_WARNING, "privacy: can't create directory priv-callerintros: %s\n", strerror(res));
1773                         return -1;
1774                 }
1775
1776                 snprintf(pa->privintro, sizeof(pa->privintro), "priv-callerintros/%s", pa->privcid);
1777                 if (ast_fileexists(pa->privintro, NULL, NULL ) > 0 && strncmp(pa->privcid, "NOCALLERID", 10) != 0) {
1778                         /* the DELUX version of this code would allow this caller the
1779                            option to hear and retape their previously recorded intro.
1780                         */
1781                 } else {
1782                         int duration; /* for feedback from play_and_wait */
1783                         /* the file doesn't exist yet. Let the caller submit his
1784                            vocal intro for posterity */
1785                         /* priv-recordintro script:
1786
1787                            "At the tone, please say your name:"
1788
1789                         */
1790                         int silencethreshold = ast_dsp_get_threshold_from_settings(THRESHOLD_SILENCE);
1791                         ast_answer(chan);
1792                         res = ast_play_and_record(chan, "priv-recordintro", pa->privintro, 4, "sln", &duration, NULL, silencethreshold, 2000, 0);  /* NOTE: I've reduced the total time to 4 sec */
1793                                                                         /* don't think we'll need a lock removed, we took care of
1794                                                                            conflicts by naming the pa.privintro file */
1795                         if (res == -1) {
1796                                 /* Delete the file regardless since they hung up during recording */
1797                                 ast_filedelete(pa->privintro, NULL);
1798                                 if (ast_fileexists(pa->privintro, NULL, NULL) > 0)
1799                                         ast_log(LOG_NOTICE, "privacy: ast_filedelete didn't do its job on %s\n", pa->privintro);
1800                                 else
1801                                         ast_verb(3, "Successfully deleted %s intro file\n", pa->privintro);
1802                                 return -1;
1803                         }
1804                         if (!ast_streamfile(chan, "vm-dialout", ast_channel_language(chan)) )
1805                                 ast_waitstream(chan, "");
1806                 }
1807         }
1808         return 1; /* success */
1809 }
1810
1811 static void end_bridge_callback(void *data)
1812 {
1813         char buf[80];
1814         time_t end;
1815         struct ast_channel *chan = data;
1816
1817         if (!ast_channel_cdr(chan)) {
1818                 return;
1819         }
1820
1821         time(&end);
1822
1823         ast_channel_lock(chan);
1824         if (ast_channel_cdr(chan)->answer.tv_sec) {
1825                 snprintf(buf, sizeof(buf), "%ld", (long) end - ast_channel_cdr(chan)->answer.tv_sec);
1826                 pbx_builtin_setvar_helper(chan, "ANSWEREDTIME", buf);
1827         }
1828
1829         if (ast_channel_cdr(chan)->start.tv_sec) {
1830                 snprintf(buf, sizeof(buf), "%ld", (long) end - ast_channel_cdr(chan)->start.tv_sec);
1831                 pbx_builtin_setvar_helper(chan, "DIALEDTIME", buf);
1832         }
1833         ast_channel_unlock(chan);
1834 }
1835
1836 static void end_bridge_callback_data_fixup(struct ast_bridge_config *bconfig, struct ast_channel *originator, struct ast_channel *terminator) {
1837         bconfig->end_bridge_callback_data = originator;
1838 }
1839
1840 static int dial_handle_playtones(struct ast_channel *chan, const char *data)
1841 {
1842         struct ast_tone_zone_sound *ts = NULL;
1843         int res;
1844         const char *str = data;
1845
1846         if (ast_strlen_zero(str)) {
1847                 ast_debug(1,"Nothing to play\n");
1848                 return -1;
1849         }
1850
1851         ts = ast_get_indication_tone(ast_channel_zone(chan), str);
1852
1853         if (ts && ts->data[0]) {
1854                 res = ast_playtones_start(chan, 0, ts->data, 0);
1855         } else {
1856                 res = -1;
1857         }
1858
1859         if (ts) {
1860                 ts = ast_tone_zone_sound_unref(ts);
1861         }
1862
1863         if (res) {
1864                 ast_log(LOG_WARNING, "Unable to start playtone \'%s\'\n", str);
1865         }
1866
1867         return res;
1868 }
1869
1870 static int dial_exec_full(struct ast_channel *chan, const char *data, struct ast_flags64 *peerflags, int *continue_exec)
1871 {
1872         int res = -1; /* default: error */
1873         char *rest, *cur; /* scan the list of destinations */
1874         struct chanlist *outgoing = NULL; /* list of destinations */
1875         struct ast_channel *peer;
1876         int to; /* timeout */
1877         struct cause_args num = { chan, 0, 0, 0 };
1878         int cause;
1879         char numsubst[256];
1880
1881         struct ast_bridge_config config = { { 0, } };
1882         struct timeval calldurationlimit = { 0, };
1883         char *dtmfcalled = NULL, *dtmfcalling = NULL, *dtmf_progress=NULL;
1884         struct privacy_args pa = {
1885                 .sentringing = 0,
1886                 .privdb_val = 0,
1887                 .status = "INVALIDARGS",
1888         };
1889         int sentringing = 0, moh = 0;
1890         const char *outbound_group = NULL;
1891         int result = 0;
1892         char *parse;
1893         int opermode = 0;
1894         int delprivintro = 0;
1895         AST_DECLARE_APP_ARGS(args,
1896                 AST_APP_ARG(peers);
1897                 AST_APP_ARG(timeout);
1898                 AST_APP_ARG(options);
1899                 AST_APP_ARG(url);
1900         );
1901         struct ast_flags64 opts = { 0, };
1902         char *opt_args[OPT_ARG_ARRAY_SIZE];
1903         struct ast_datastore *datastore = NULL;
1904         int fulldial = 0, num_dialed = 0;
1905         int ignore_cc = 0;
1906         char device_name[AST_CHANNEL_NAME];
1907         char forced_clid_name[AST_MAX_EXTENSION];
1908         char stored_clid_name[AST_MAX_EXTENSION];
1909         int force_forwards_only;        /*!< TRUE if force CallerID on call forward only. Legacy behaviour.*/
1910         /*!
1911          * \brief Forced CallerID party information to send.
1912          * \note This will not have any malloced strings so do not free it.
1913          */
1914         struct ast_party_id forced_clid;
1915         /*!
1916          * \brief Stored CallerID information if needed.
1917          *
1918          * \note If OPT_ORIGINAL_CLID set then this is the o option
1919          * CallerID.  Otherwise it is the dialplan extension and hint
1920          * name.
1921          *
1922          * \note This will not have any malloced strings so do not free it.
1923          */
1924         struct ast_party_id stored_clid;
1925         /*!
1926          * \brief CallerID party information to store.
1927          * \note This will not have any malloced strings so do not free it.
1928          */
1929         struct ast_party_caller caller;
1930
1931         /* Reset all DIAL variables back to blank, to prevent confusion (in case we don't reset all of them). */
1932         pbx_builtin_setvar_helper(chan, "DIALSTATUS", "");
1933         pbx_builtin_setvar_helper(chan, "DIALEDPEERNUMBER", "");
1934         pbx_builtin_setvar_helper(chan, "DIALEDPEERNAME", "");
1935         pbx_builtin_setvar_helper(chan, "ANSWEREDTIME", "");
1936         pbx_builtin_setvar_helper(chan, "DIALEDTIME", "");
1937
1938         if (ast_strlen_zero(data)) {
1939                 ast_log(LOG_WARNING, "Dial requires an argument (technology/number)\n");
1940                 pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
1941                 return -1;
1942         }
1943
1944         parse = ast_strdupa(data);
1945
1946         AST_STANDARD_APP_ARGS(args, parse);
1947
1948         if (!ast_strlen_zero(args.options) &&
1949                 ast_app_parse_options64(dial_exec_options, &opts, opt_args, args.options)) {
1950                 pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
1951                 goto done;
1952         }
1953
1954         if (ast_strlen_zero(args.peers)) {
1955                 ast_log(LOG_WARNING, "Dial requires an argument (technology/number)\n");
1956                 pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
1957                 goto done;
1958         }
1959
1960         if (ast_cc_call_init(chan, &ignore_cc)) {
1961                 goto done;
1962         }
1963
1964         if (ast_test_flag64(&opts, OPT_SCREEN_NOINTRO) && !ast_strlen_zero(opt_args[OPT_ARG_SCREEN_NOINTRO])) {
1965                 delprivintro = atoi(opt_args[OPT_ARG_SCREEN_NOINTRO]);
1966
1967                 if (delprivintro < 0 || delprivintro > 1) {
1968                         ast_log(LOG_WARNING, "Unknown argument %d specified to n option, ignoring\n", delprivintro);
1969                         delprivintro = 0;
1970                 }
1971         }
1972
1973         if (!ast_test_flag64(&opts, OPT_RINGBACK)) {
1974                 opt_args[OPT_ARG_RINGBACK] = NULL;
1975         }
1976
1977         if (ast_test_flag64(&opts, OPT_OPERMODE)) {
1978                 opermode = ast_strlen_zero(opt_args[OPT_ARG_OPERMODE]) ? 1 : atoi(opt_args[OPT_ARG_OPERMODE]);
1979                 ast_verb(3, "Setting operator services mode to %d.\n", opermode);
1980         }
1981
1982         if (ast_test_flag64(&opts, OPT_DURATION_STOP) && !ast_strlen_zero(opt_args[OPT_ARG_DURATION_STOP])) {
1983                 calldurationlimit.tv_sec = atoi(opt_args[OPT_ARG_DURATION_STOP]);
1984                 if (!calldurationlimit.tv_sec) {
1985                         ast_log(LOG_WARNING, "Dial does not accept S(%s), hanging up.\n", opt_args[OPT_ARG_DURATION_STOP]);
1986                         pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
1987                         goto done;
1988                 }
1989                 ast_verb(3, "Setting call duration limit to %.3lf seconds.\n", calldurationlimit.tv_sec + calldurationlimit.tv_usec / 1000000.0);
1990         }
1991
1992         if (ast_test_flag64(&opts, OPT_SENDDTMF) && !ast_strlen_zero(opt_args[OPT_ARG_SENDDTMF])) {
1993                 dtmf_progress = opt_args[OPT_ARG_SENDDTMF];
1994                 dtmfcalled = strsep(&dtmf_progress, ":");
1995                 dtmfcalling = strsep(&dtmf_progress, ":");
1996         }
1997
1998         if (ast_test_flag64(&opts, OPT_DURATION_LIMIT) && !ast_strlen_zero(opt_args[OPT_ARG_DURATION_LIMIT])) {
1999                 if (ast_bridge_timelimit(chan, &config, opt_args[OPT_ARG_DURATION_LIMIT], &calldurationlimit))
2000                         goto done;
2001         }
2002
2003         /* Setup the forced CallerID information to send if used. */
2004         ast_party_id_init(&forced_clid);
2005         force_forwards_only = 0;
2006         if (ast_test_flag64(&opts, OPT_FORCECLID)) {
2007                 if (ast_strlen_zero(opt_args[OPT_ARG_FORCECLID])) {
2008                         ast_channel_lock(chan);
2009                         forced_clid.number.str = ast_strdupa(S_OR(ast_channel_macroexten(chan), ast_channel_exten(chan)));
2010                         ast_channel_unlock(chan);
2011                         forced_clid_name[0] = '\0';
2012                         forced_clid.name.str = (char *) get_cid_name(forced_clid_name,
2013                                 sizeof(forced_clid_name), chan);
2014                         force_forwards_only = 1;
2015                 } else {
2016                         /* Note: The opt_args[OPT_ARG_FORCECLID] string value is altered here. */
2017                         ast_callerid_parse(opt_args[OPT_ARG_FORCECLID], &forced_clid.name.str,
2018                                 &forced_clid.number.str);
2019                 }
2020                 if (!ast_strlen_zero(forced_clid.name.str)) {
2021                         forced_clid.name.valid = 1;
2022                 }
2023                 if (!ast_strlen_zero(forced_clid.number.str)) {
2024                         forced_clid.number.valid = 1;
2025                 }
2026         }
2027         if (ast_test_flag64(&opts, OPT_FORCE_CID_TAG)
2028                 && !ast_strlen_zero(opt_args[OPT_ARG_FORCE_CID_TAG])) {
2029                 forced_clid.tag = opt_args[OPT_ARG_FORCE_CID_TAG];
2030         }
2031         forced_clid.number.presentation = AST_PRES_ALLOWED_USER_NUMBER_PASSED_SCREEN;
2032         if (ast_test_flag64(&opts, OPT_FORCE_CID_PRES)
2033                 && !ast_strlen_zero(opt_args[OPT_ARG_FORCE_CID_PRES])) {
2034                 int pres;
2035
2036                 pres = ast_parse_caller_presentation(opt_args[OPT_ARG_FORCE_CID_PRES]);
2037                 if (0 <= pres) {
2038                         forced_clid.number.presentation = pres;
2039                 }
2040         }
2041
2042         /* Setup the stored CallerID information if needed. */
2043         ast_party_id_init(&stored_clid);
2044         if (ast_test_flag64(&opts, OPT_ORIGINAL_CLID)) {
2045                 if (ast_strlen_zero(opt_args[OPT_ARG_ORIGINAL_CLID])) {
2046                         ast_channel_lock(chan);
2047                         ast_party_id_set_init(&stored_clid, &chan->caller.id);
2048                         if (!ast_strlen_zero(chan->caller.id.name.str)) {
2049                                 stored_clid.name.str = ast_strdupa(chan->caller.id.name.str);
2050                         }
2051                         if (!ast_strlen_zero(chan->caller.id.number.str)) {
2052                                 stored_clid.number.str = ast_strdupa(chan->caller.id.number.str);
2053                         }
2054                         if (!ast_strlen_zero(chan->caller.id.subaddress.str)) {
2055                                 stored_clid.subaddress.str = ast_strdupa(chan->caller.id.subaddress.str);
2056                         }
2057                         if (!ast_strlen_zero(chan->caller.id.tag)) {
2058                                 stored_clid.tag = ast_strdupa(chan->caller.id.tag);
2059                         }
2060                         ast_channel_unlock(chan);
2061                 } else {
2062                         /* Note: The opt_args[OPT_ARG_ORIGINAL_CLID] string value is altered here. */
2063                         ast_callerid_parse(opt_args[OPT_ARG_ORIGINAL_CLID], &stored_clid.name.str,
2064                                 &stored_clid.number.str);
2065                         if (!ast_strlen_zero(stored_clid.name.str)) {
2066                                 stored_clid.name.valid = 1;
2067                         }
2068                         if (!ast_strlen_zero(stored_clid.number.str)) {
2069                                 stored_clid.number.valid = 1;
2070                         }
2071                 }
2072         } else {
2073                 /*
2074                  * In case the new channel has no preset CallerID number by the
2075                  * channel driver, setup the dialplan extension and hint name.
2076                  */
2077                 stored_clid_name[0] = '\0';
2078                 stored_clid.name.str = (char *) get_cid_name(stored_clid_name,
2079                         sizeof(stored_clid_name), chan);
2080                 if (ast_strlen_zero(stored_clid.name.str)) {
2081                         stored_clid.name.str = NULL;
2082                 } else {
2083                         stored_clid.name.valid = 1;
2084                 }
2085                 ast_channel_lock(chan);
2086                 stored_clid.number.str = ast_strdupa(S_OR(ast_channel_macroexten(chan), ast_channel_exten(chan)));
2087                 stored_clid.number.valid = 1;
2088                 ast_channel_unlock(chan);
2089         }
2090
2091         if (ast_test_flag64(&opts, OPT_RESETCDR) && ast_channel_cdr(chan))
2092                 ast_cdr_reset(ast_channel_cdr(chan), NULL);
2093         if (ast_test_flag64(&opts, OPT_PRIVACY) && ast_strlen_zero(opt_args[OPT_ARG_PRIVACY]))
2094                 opt_args[OPT_ARG_PRIVACY] = ast_strdupa(ast_channel_exten(chan));
2095
2096         if (ast_test_flag64(&opts, OPT_PRIVACY) || ast_test_flag64(&opts, OPT_SCREENING)) {
2097                 res = setup_privacy_args(&pa, &opts, opt_args, chan);
2098                 if (res <= 0)
2099                         goto out;
2100                 res = -1; /* reset default */
2101         }
2102
2103         if (continue_exec)
2104                 *continue_exec = 0;
2105
2106         /* If a channel group has been specified, get it for use when we create peer channels */
2107
2108         ast_channel_lock(chan);
2109         if ((outbound_group = pbx_builtin_getvar_helper(chan, "OUTBOUND_GROUP_ONCE"))) {
2110                 outbound_group = ast_strdupa(outbound_group);   
2111                 pbx_builtin_setvar_helper(chan, "OUTBOUND_GROUP_ONCE", NULL);
2112         } else if ((outbound_group = pbx_builtin_getvar_helper(chan, "OUTBOUND_GROUP"))) {
2113                 outbound_group = ast_strdupa(outbound_group);
2114         }
2115         ast_channel_unlock(chan);       
2116         ast_copy_flags64(peerflags, &opts, OPT_DTMF_EXIT | OPT_GO_ON | OPT_ORIGINAL_CLID | OPT_CALLER_HANGUP | OPT_IGNORE_FORWARDING | OPT_IGNORE_CONNECTEDLINE |
2117                          OPT_CANCEL_TIMEOUT | OPT_ANNOUNCE | OPT_CALLEE_MACRO | OPT_CALLEE_GOSUB | OPT_FORCECLID);
2118
2119         /* loop through the list of dial destinations */
2120         rest = args.peers;
2121         while ((cur = strsep(&rest, "&")) ) {
2122                 struct chanlist *tmp;
2123                 struct ast_channel *tc; /* channel for this destination */
2124                 /* Get a technology/[device:]number pair */
2125                 char *number = cur;
2126                 char *interface = ast_strdupa(number);
2127                 char *tech = strsep(&number, "/");
2128                 /* find if we already dialed this interface */
2129                 struct ast_dialed_interface *di;
2130                 AST_LIST_HEAD(, ast_dialed_interface) *dialed_interfaces;
2131                 num_dialed++;
2132                 if (ast_strlen_zero(number)) {
2133                         ast_log(LOG_WARNING, "Dial argument takes format (technology/[device:]number1)\n");
2134                         goto out;
2135                 }
2136                 if (!(tmp = ast_calloc(1, sizeof(*tmp))))
2137                         goto out;
2138                 if (opts.flags) {
2139                         ast_copy_flags64(tmp, &opts,
2140                                 OPT_CANCEL_ELSEWHERE |
2141                                 OPT_CALLEE_TRANSFER | OPT_CALLER_TRANSFER |
2142                                 OPT_CALLEE_HANGUP | OPT_CALLER_HANGUP |
2143                                 OPT_CALLEE_MONITOR | OPT_CALLER_MONITOR |
2144                                 OPT_CALLEE_PARK | OPT_CALLER_PARK |
2145                                 OPT_CALLEE_MIXMONITOR | OPT_CALLER_MIXMONITOR |
2146                                 OPT_RINGBACK | OPT_MUSICBACK | OPT_FORCECLID);
2147                         ast_set2_flag64(tmp, args.url, DIAL_NOFORWARDHTML);
2148                 }
2149                 ast_copy_string(numsubst, number, sizeof(numsubst));
2150                 /* Request the peer */
2151
2152                 ast_channel_lock(chan);
2153                 datastore = ast_channel_datastore_find(chan, &dialed_interface_info, NULL);
2154                 /*
2155                  * Seed the chanlist's connected line information with previously
2156                  * acquired connected line info from the incoming channel.  The
2157                  * previously acquired connected line info could have been set
2158                  * through the CONNECTED_LINE dialplan function.
2159                  */
2160                 ast_party_connected_line_copy(&tmp->connected, &chan->connected);
2161                 ast_channel_unlock(chan);
2162
2163                 if (datastore)
2164                         dialed_interfaces = datastore->data;
2165                 else {
2166                         if (!(datastore = ast_datastore_alloc(&dialed_interface_info, NULL))) {
2167                                 ast_log(LOG_WARNING, "Unable to create channel datastore for dialed interfaces. Aborting!\n");
2168                                 chanlist_free(tmp);
2169                                 goto out;
2170                         }
2171
2172                         datastore->inheritance = DATASTORE_INHERIT_FOREVER;
2173
2174                         if (!(dialed_interfaces = ast_calloc(1, sizeof(*dialed_interfaces)))) {
2175                                 ast_datastore_free(datastore);
2176                                 chanlist_free(tmp);
2177                                 goto out;
2178                         }
2179
2180                         datastore->data = dialed_interfaces;
2181                         AST_LIST_HEAD_INIT(dialed_interfaces);
2182
2183                         ast_channel_lock(chan);
2184                         ast_channel_datastore_add(chan, datastore);
2185                         ast_channel_unlock(chan);
2186                 }
2187
2188                 AST_LIST_LOCK(dialed_interfaces);
2189                 AST_LIST_TRAVERSE(dialed_interfaces, di, list) {
2190                         if (!strcasecmp(di->interface, interface)) {
2191                                 ast_log(LOG_WARNING, "Skipping dialing interface '%s' again since it has already been dialed\n",
2192                                         di->interface);
2193                                 break;
2194                         }
2195                 }
2196                 AST_LIST_UNLOCK(dialed_interfaces);
2197
2198                 if (di) {
2199                         fulldial++;
2200                         chanlist_free(tmp);
2201                         continue;
2202                 }
2203
2204                 /* It is always ok to dial a Local interface.  We only keep track of
2205                  * which "real" interfaces have been dialed.  The Local channel will
2206                  * inherit this list so that if it ends up dialing a real interface,
2207                  * it won't call one that has already been called. */
2208                 if (strcasecmp(tech, "Local")) {
2209                         if (!(di = ast_calloc(1, sizeof(*di) + strlen(interface)))) {
2210                                 AST_LIST_UNLOCK(dialed_interfaces);
2211                                 chanlist_free(tmp);
2212                                 goto out;
2213                         }
2214                         strcpy(di->interface, interface);
2215
2216                         AST_LIST_LOCK(dialed_interfaces);
2217                         AST_LIST_INSERT_TAIL(dialed_interfaces, di, list);
2218                         AST_LIST_UNLOCK(dialed_interfaces);
2219                 }
2220
2221                 tc = ast_request(tech, ast_channel_nativeformats(chan), chan, numsubst, &cause);
2222                 if (!tc) {
2223                         /* If we can't, just go on to the next call */
2224                         ast_log(LOG_WARNING, "Unable to create channel of type '%s' (cause %d - %s)\n",
2225                                 tech, cause, ast_cause2str(cause));
2226                         handle_cause(cause, &num);
2227                         if (!rest) /* we are on the last destination */
2228                                 ast_channel_hangupcause_set(chan, cause);
2229                         chanlist_free(tmp);
2230                         if (!ignore_cc && (cause == AST_CAUSE_BUSY || cause == AST_CAUSE_CONGESTION)) {
2231                                 if (!ast_cc_callback(chan, tech, numsubst, ast_cc_busy_interface)) {
2232                                         ast_cc_extension_monitor_add_dialstring(chan, interface, "");
2233                                 }
2234                         }
2235                         continue;
2236                 }
2237                 ast_channel_get_device_name(tc, device_name, sizeof(device_name));
2238                 if (!ignore_cc) {
2239                         ast_cc_extension_monitor_add_dialstring(chan, interface, device_name);
2240                 }
2241                 pbx_builtin_setvar_helper(tc, "DIALEDPEERNUMBER", numsubst);
2242
2243                 ast_channel_lock(tc);
2244                 while (ast_channel_trylock(chan)) {
2245                         CHANNEL_DEADLOCK_AVOIDANCE(tc);
2246                 }
2247                 /* Setup outgoing SDP to match incoming one */
2248                 if (!outgoing && !rest && CAN_EARLY_BRIDGE(peerflags, chan, tc)) {
2249                         ast_rtp_instance_early_bridge_make_compatible(tc, chan);
2250                 }
2251                 
2252                 /* Inherit specially named variables from parent channel */
2253                 ast_channel_inherit_variables(chan, tc);
2254                 ast_channel_datastore_inherit(chan, tc);
2255
2256                 ast_channel_appl_set(tc, "AppDial");
2257                 ast_channel_data_set(tc, "(Outgoing Line)");
2258                 memset(&tc->whentohangup, 0, sizeof(tc->whentohangup));
2259
2260                 /* Determine CallerID to store in outgoing channel. */
2261                 ast_party_caller_set_init(&caller, &tc->caller);
2262                 if (ast_test_flag64(peerflags, OPT_ORIGINAL_CLID)) {
2263                         caller.id = stored_clid;
2264                         ast_channel_set_caller_event(tc, &caller, NULL);
2265                         ast_set_flag64(tmp, DIAL_CALLERID_ABSENT);
2266                 } else if (ast_strlen_zero(S_COR(tc->caller.id.number.valid,
2267                         tc->caller.id.number.str, NULL))) {
2268                         /*
2269                          * The new channel has no preset CallerID number by the channel
2270                          * driver.  Use the dialplan extension and hint name.
2271                          */
2272                         caller.id = stored_clid;
2273                         if (!caller.id.name.valid
2274                                 && !ast_strlen_zero(S_COR(chan->connected.id.name.valid,
2275                                         chan->connected.id.name.str, NULL))) {
2276                                 /*
2277                                  * No hint name available.  We have a connected name supplied by
2278                                  * the dialplan we can use instead.
2279                                  */
2280                                 caller.id.name.valid = 1;
2281                                 caller.id.name = chan->connected.id.name;
2282                         }
2283                         ast_channel_set_caller_event(tc, &caller, NULL);
2284                         ast_set_flag64(tmp, DIAL_CALLERID_ABSENT);
2285                 } else if (ast_strlen_zero(S_COR(tc->caller.id.name.valid, tc->caller.id.name.str,
2286                         NULL))) {
2287                         /* The new channel has no preset CallerID name by the channel driver. */
2288                         if (!ast_strlen_zero(S_COR(chan->connected.id.name.valid,
2289                                 chan->connected.id.name.str, NULL))) {
2290                                 /*
2291                                  * We have a connected name supplied by the dialplan we can
2292                                  * use instead.
2293                                  */
2294                                 caller.id.name.valid = 1;
2295                                 caller.id.name = chan->connected.id.name;
2296                                 ast_channel_set_caller_event(tc, &caller, NULL);
2297                         }
2298                 }
2299
2300                 /* Determine CallerID for outgoing channel to send. */
2301                 if (ast_test_flag64(peerflags, OPT_FORCECLID) && !force_forwards_only) {
2302                         struct ast_party_connected_line connected;
2303
2304                         ast_party_connected_line_set_init(&connected, &tc->connected);
2305                         connected.id = forced_clid;
2306                         ast_channel_set_connected_line(tc, &connected, NULL);
2307                 } else {
2308                         ast_connected_line_copy_from_caller(&tc->connected, &chan->caller);
2309                 }
2310
2311                 ast_party_redirecting_copy(&tc->redirecting, &chan->redirecting);
2312
2313                 tc->dialed.transit_network_select = chan->dialed.transit_network_select;
2314
2315                 if (!ast_strlen_zero(ast_channel_accountcode(chan))) {
2316                         ast_channel_peeraccount_set(tc, ast_channel_accountcode(chan));
2317                 }
2318                 if (ast_strlen_zero(ast_channel_musicclass(tc)))
2319                         ast_channel_musicclass_set(tc, ast_channel_musicclass(chan));
2320
2321                 /* Pass ADSI CPE and transfer capability */
2322                 ast_channel_adsicpe_set(tc, ast_channel_adsicpe(chan));
2323                 ast_channel_transfercapability_set(tc, ast_channel_transfercapability(chan));
2324
2325                 /* If we have an outbound group, set this peer channel to it */
2326                 if (outbound_group)
2327                         ast_app_group_set_channel(tc, outbound_group);
2328                 /* If the calling channel has the ANSWERED_ELSEWHERE flag set, inherit it. This is to support local channels */
2329                 if (ast_test_flag(chan, AST_FLAG_ANSWERED_ELSEWHERE))
2330                         ast_set_flag(tc, AST_FLAG_ANSWERED_ELSEWHERE);
2331
2332                 /* Check if we're forced by configuration */
2333                 if (ast_test_flag64(&opts, OPT_CANCEL_ELSEWHERE))
2334                          ast_set_flag(tc, AST_FLAG_ANSWERED_ELSEWHERE);
2335
2336
2337                 /* Inherit context and extension */
2338                 ast_channel_dialcontext_set(tc, ast_strlen_zero(ast_channel_macrocontext(chan)) ? ast_channel_context(chan) : ast_channel_macrocontext(chan));
2339                 if (!ast_strlen_zero(ast_channel_macroexten(chan)))
2340                         ast_channel_exten_set(tc, ast_channel_macroexten(chan));
2341                 else
2342                         ast_channel_exten_set(tc, ast_channel_exten(chan));
2343
2344                 ast_channel_unlock(tc);
2345                 ast_channel_unlock(chan);
2346                 res = ast_call(tc, numsubst, 0); /* Place the call, but don't wait on the answer */
2347                 ast_channel_lock(chan);
2348
2349                 /* Save the info in cdr's that we called them */
2350                 if (ast_channel_cdr(chan))
2351                         ast_cdr_setdestchan(ast_channel_cdr(chan), ast_channel_name(tc));
2352
2353                 /* check the results of ast_call */
2354                 if (res) {
2355                         /* Again, keep going even if there's an error */
2356                         ast_debug(1, "ast call on peer returned %d\n", res);
2357                         ast_verb(3, "Couldn't call %s/%s\n", tech, numsubst);
2358                         if (ast_channel_hangupcause(tc)) {
2359                                 ast_channel_hangupcause_set(chan, ast_channel_hangupcause(tc));
2360                         }
2361                         ast_channel_unlock(chan);
2362                         ast_cc_call_failed(chan, tc, interface);
2363                         ast_hangup(tc);
2364                         tc = NULL;
2365                         chanlist_free(tmp);
2366                         continue;
2367                 } else {
2368                         senddialevent(chan, tc, numsubst);
2369                         ast_verb(3, "Called %s/%s\n", tech, numsubst);
2370                         ast_channel_unlock(chan);
2371                 }
2372                 /* Put them in the list of outgoing thingies...  We're ready now.
2373                    XXX If we're forcibly removed, these outgoing calls won't get
2374                    hung up XXX */
2375                 ast_set_flag64(tmp, DIAL_STILLGOING);
2376                 tmp->chan = tc;
2377                 tmp->next = outgoing;
2378                 outgoing = tmp;
2379                 /* If this line is up, don't try anybody else */
2380                 if (ast_channel_state(outgoing->chan) == AST_STATE_UP)
2381                         break;
2382         }
2383         
2384         if (ast_strlen_zero(args.timeout)) {
2385                 to = -1;
2386         } else {
2387                 to = atoi(args.timeout);
2388                 if (to > 0)
2389                         to *= 1000;
2390                 else {
2391                         ast_log(LOG_WARNING, "Invalid timeout specified: '%s'. Setting timeout to infinite\n", args.timeout);
2392                         to = -1;
2393                 }
2394         }
2395
2396         if (!outgoing) {
2397                 strcpy(pa.status, "CHANUNAVAIL");
2398                 if (fulldial == num_dialed) {
2399                         res = -1;
2400                         goto out;
2401                 }
2402         } else {
2403                 /* Our status will at least be NOANSWER */
2404                 strcpy(pa.status, "NOANSWER");
2405                 if (ast_test_flag64(outgoing, OPT_MUSICBACK)) {
2406                         moh = 1;
2407                         if (!ast_strlen_zero(opt_args[OPT_ARG_MUSICBACK])) {
2408                                 char *original_moh = ast_strdupa(ast_channel_musicclass(chan));
2409                                 ast_channel_musicclass_set(chan, opt_args[OPT_ARG_MUSICBACK]);
2410                                 ast_moh_start(chan, opt_args[OPT_ARG_MUSICBACK], NULL);
2411                                 ast_channel_musicclass_set(chan, original_moh);
2412                         } else {
2413                                 ast_moh_start(chan, NULL, NULL);
2414                         }
2415                         ast_indicate(chan, AST_CONTROL_PROGRESS);
2416                 } else if (ast_test_flag64(outgoing, OPT_RINGBACK)) {
2417                         if (!ast_strlen_zero(opt_args[OPT_ARG_RINGBACK])) {
2418                                 if (dial_handle_playtones(chan, opt_args[OPT_ARG_RINGBACK])){
2419                                         ast_indicate(chan, AST_CONTROL_RINGING);
2420                                         sentringing++;
2421                                 } else {
2422                                         ast_indicate(chan, AST_CONTROL_PROGRESS);
2423                                 }
2424                         } else {
2425                                 ast_indicate(chan, AST_CONTROL_RINGING);
2426                                 sentringing++;
2427                         }
2428                 }
2429         }
2430
2431         peer = wait_for_answer(chan, outgoing, &to, peerflags, opt_args, &pa, &num, &result,
2432                 dtmf_progress, ignore_cc, &forced_clid, &stored_clid);
2433
2434         /* The ast_channel_datastore_remove() function could fail here if the
2435          * datastore was moved to another channel during a masquerade. If this is
2436          * the case, don't free the datastore here because later, when the channel
2437          * to which the datastore was moved hangs up, it will attempt to free this
2438          * datastore again, causing a crash
2439          */
2440         ast_channel_lock(chan);
2441         datastore = ast_channel_datastore_find(chan, &dialed_interface_info, NULL); /* make sure we weren't cleaned up already */
2442         if (datastore && !ast_channel_datastore_remove(chan, datastore)) {
2443                 ast_datastore_free(datastore);
2444         }
2445         ast_channel_unlock(chan);
2446         if (!peer) {
2447                 if (result) {
2448                         res = result;
2449                 } else if (to) { /* Musta gotten hung up */
2450                         res = -1;
2451                 } else { /* Nobody answered, next please? */
2452                         res = 0;
2453                 }
2454         } else {
2455                 const char *number;
2456
2457                 if (ast_test_flag64(&opts, OPT_CALLER_ANSWER))
2458                         ast_answer(chan);
2459
2460                 strcpy(pa.status, "ANSWER");
2461                 pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
2462                 /* Ah ha!  Someone answered within the desired timeframe.  Of course after this
2463                    we will always return with -1 so that it is hung up properly after the
2464                    conversation.  */
2465                 hanguptree(outgoing, peer, 1);
2466                 outgoing = NULL;
2467                 /* If appropriate, log that we have a destination channel and set the answer time */
2468                 if (ast_channel_cdr(chan)) {
2469                         ast_cdr_setdestchan(ast_channel_cdr(chan), ast_channel_name(peer));
2470                         ast_cdr_setanswer(ast_channel_cdr(chan), ast_channel_cdr(peer)->answer);
2471                 }
2472                 if (ast_channel_name(peer))
2473                         pbx_builtin_setvar_helper(chan, "DIALEDPEERNAME", ast_channel_name(peer));
2474                 
2475                 ast_channel_lock(peer);
2476                 number = pbx_builtin_getvar_helper(peer, "DIALEDPEERNUMBER"); 
2477                 if (!number)
2478                         number = numsubst;
2479                 pbx_builtin_setvar_helper(chan, "DIALEDPEERNUMBER", number);
2480                 ast_channel_unlock(peer);
2481
2482                 if (!ast_strlen_zero(args.url) && ast_channel_supports_html(peer) ) {
2483                         ast_debug(1, "app_dial: sendurl=%s.\n", args.url);
2484                         ast_channel_sendurl( peer, args.url );
2485                 }
2486                 if ( (ast_test_flag64(&opts, OPT_PRIVACY) || ast_test_flag64(&opts, OPT_SCREENING)) && pa.privdb_val == AST_PRIVACY_UNKNOWN) {
2487                         if (do_privacy(chan, peer, &opts, opt_args, &pa)) {
2488                                 res = 0;
2489                                 goto out;
2490                         }
2491                 }
2492                 if (!ast_test_flag64(&opts, OPT_ANNOUNCE) || ast_strlen_zero(opt_args[OPT_ARG_ANNOUNCE])) {
2493                         res = 0;
2494                 } else {
2495                         int digit = 0;
2496                         struct ast_channel *chans[2];
2497                         struct ast_channel *active_chan;
2498
2499                         chans[0] = chan;
2500                         chans[1] = peer;
2501
2502                         /* we need to stream the announcment while monitoring the caller for a hangup */
2503
2504                         /* stream the file */
2505                         res = ast_streamfile(peer, opt_args[OPT_ARG_ANNOUNCE], ast_channel_language(peer));
2506                         if (res) {
2507                                 res = 0;
2508                                 ast_log(LOG_ERROR, "error streaming file '%s' to callee\n", opt_args[OPT_ARG_ANNOUNCE]);
2509                         }
2510
2511                         ast_set_flag(peer, AST_FLAG_END_DTMF_ONLY);
2512                         while (ast_channel_stream(peer)) {
2513                                 int ms;
2514
2515                                 ms = ast_sched_wait(ast_channel_sched(peer));
2516
2517                                 if (ms < 0 && !peer->timingfunc) {
2518                                         ast_stopstream(peer);
2519                                         break;
2520                                 }
2521                                 if (ms < 0)
2522                                         ms = 1000;
2523
2524                                 active_chan = ast_waitfor_n(chans, 2, &ms);
2525                                 if (active_chan) {
2526                                         struct ast_frame *fr = ast_read(active_chan);
2527                                         if (!fr) {
2528                                                 ast_hangup(peer);
2529                                                 res = -1;
2530                                                 goto done;
2531                                         }
2532                                         switch(fr->frametype) {
2533                                                 case AST_FRAME_DTMF_END:
2534                                                         digit = fr->subclass.integer;
2535                                                         if (active_chan == peer && strchr(AST_DIGIT_ANY, res)) {
2536                                                                 ast_stopstream(peer);
2537                                                                 res = ast_senddigit(chan, digit, 0);
2538                                                         }
2539                                                         break;
2540                                                 case AST_FRAME_CONTROL:
2541                        &nbs