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