Sat Feb 11 06:33:00 2012

Asterisk developer's documentation


app_dial.c

Go to the documentation of this file.
00001 /*
00002  * Asterisk -- An open source telephony toolkit.
00003  *
00004  * Copyright (C) 1999 - 2008, Digium, Inc.
00005  *
00006  * Mark Spencer <markster@digium.com>
00007  *
00008  * See http://www.asterisk.org for more information about
00009  * the Asterisk project. Please do not directly contact
00010  * any of the maintainers of this project for assistance;
00011  * the project provides a web site, mailing lists and IRC
00012  * channels for your use.
00013  *
00014  * This program is free software, distributed under the terms of
00015  * the GNU General Public License Version 2. See the LICENSE file
00016  * at the top of the source tree.
00017  */
00018 
00019 /*! \file
00020  *
00021  * \brief dial() & retrydial() - Trivial application to dial a channel and send an URL on answer
00022  *
00023  * \author Mark Spencer <markster@digium.com>
00024  *
00025  * \ingroup applications
00026  */
00027 
00028 /*** MODULEINFO
00029    <depend>chan_local</depend>
00030    <support_level>core</support_level>
00031  ***/
00032 
00033 
00034 #include "asterisk.h"
00035 
00036 ASTERISK_FILE_VERSION(__FILE__, "$Revision: 354429 $")
00037 
00038 #include <sys/time.h>
00039 #include <sys/signal.h>
00040 #include <sys/stat.h>
00041 #include <netinet/in.h>
00042 
00043 #include "asterisk/paths.h" /* use ast_config_AST_DATA_DIR */
00044 #include "asterisk/lock.h"
00045 #include "asterisk/file.h"
00046 #include "asterisk/channel.h"
00047 #include "asterisk/pbx.h"
00048 #include "asterisk/module.h"
00049 #include "asterisk/translate.h"
00050 #include "asterisk/say.h"
00051 #include "asterisk/config.h"
00052 #include "asterisk/features.h"
00053 #include "asterisk/musiconhold.h"
00054 #include "asterisk/callerid.h"
00055 #include "asterisk/utils.h"
00056 #include "asterisk/app.h"
00057 #include "asterisk/causes.h"
00058 #include "asterisk/rtp_engine.h"
00059 #include "asterisk/cdr.h"
00060 #include "asterisk/manager.h"
00061 #include "asterisk/privacy.h"
00062 #include "asterisk/stringfields.h"
00063 #include "asterisk/global_datastores.h"
00064 #include "asterisk/dsp.h"
00065 #include "asterisk/cel.h"
00066 #include "asterisk/aoc.h"
00067 #include "asterisk/ccss.h"
00068 #include "asterisk/indications.h"
00069 #include "asterisk/framehook.h"
00070 
00071 /*** DOCUMENTATION
00072    <application name="Dial" language="en_US">
00073       <synopsis>
00074          Attempt to connect to another device or endpoint and bridge the call.
00075       </synopsis>
00076       <syntax>
00077          <parameter name="Technology/Resource" required="true" argsep="&amp;">
00078             <argument name="Technology/Resource" required="true">
00079                <para>Specification of the device(s) to dial.  These must be in the format of
00080                <literal>Technology/Resource</literal>, where <replaceable>Technology</replaceable>
00081                represents a particular channel driver, and <replaceable>Resource</replaceable>
00082                represents a resource available to that particular channel driver.</para>
00083             </argument>
00084             <argument name="Technology2/Resource2" required="false" multiple="true">
00085                <para>Optional extra devices to dial in parallel</para>
00086                <para>If you need more then one enter them as
00087                Technology2/Resource2&amp;Technology3/Resourse3&amp;.....</para>
00088             </argument>
00089          </parameter>
00090          <parameter name="timeout" required="false">
00091             <para>Specifies the number of seconds we attempt to dial the specified devices</para>
00092             <para>If not specified, this defaults to 136 years.</para>
00093          </parameter>
00094          <parameter name="options" required="false">
00095             <optionlist>
00096             <option name="A">
00097                <argument name="x" required="true">
00098                   <para>The file to play to the called party</para>
00099                </argument>
00100                <para>Play an announcement to the called party, where <replaceable>x</replaceable> is the prompt to be played</para>
00101             </option>
00102             <option name="a">
00103                <para>Immediately answer the calling channel when the called channel answers in
00104                all cases. Normally, the calling channel is answered when the called channel
00105                answers, but when options such as A() and M() are used, the calling channel is
00106                not answered until all actions on the called channel (such as playing an
00107                announcement) are completed.  This option can be used to answer the calling
00108                channel before doing anything on the called channel. You will rarely need to use
00109                this option, the default behavior is adequate in most cases.</para>
00110             </option>
00111             <option name="C">
00112                <para>Reset the call detail record (CDR) for this call.</para>
00113             </option>
00114             <option name="c">
00115                <para>If the Dial() application cancels this call, always set the flag to tell the channel
00116                driver that the call is answered elsewhere.</para>
00117             </option>
00118             <option name="d">
00119                <para>Allow the calling user to dial a 1 digit extension while waiting for
00120                a call to be answered. Exit to that extension if it exists in the
00121                current context, or the context defined in the <variable>EXITCONTEXT</variable> variable,
00122                if it exists.</para>
00123                <note>
00124                   <para>Many SIP and ISDN phones cannot send DTMF digits until the call is
00125                   connected.  If you wish to use this option with these phones, you
00126                   can use the <literal>Answer</literal> application before dialing.</para>
00127                </note>
00128             </option>
00129             <option name="D" argsep=":">
00130                <argument name="called" />
00131                <argument name="calling" />
00132                <argument name="progress" />
00133                <para>Send the specified DTMF strings <emphasis>after</emphasis> the called
00134                party has answered, but before the call gets bridged. The 
00135                <replaceable>called</replaceable> DTMF string is sent to the called party, and the 
00136                <replaceable>calling</replaceable> DTMF string is sent to the calling party. Both arguments 
00137                can be used alone.  If <replaceable>progress</replaceable> is specified, its DTMF is sent
00138                immediately after receiving a PROGRESS message.</para>
00139             </option>
00140             <option name="e">
00141                <para>Execute the <literal>h</literal> extension for peer after the call ends</para>
00142             </option>
00143             <option name="f">
00144                <argument name="x" required="false" />
00145                <para>If <replaceable>x</replaceable> is not provided, force the CallerID sent on a call-forward or
00146                deflection to the dialplan extension of this Dial() using a dialplan <literal>hint</literal>.
00147                For example, some PSTNs do not allow CallerID to be set to anything
00148                other than the numbers assigned to you.
00149                If <replaceable>x</replaceable> is provided, force the CallerID sent to <replaceable>x</replaceable>.</para>
00150             </option>
00151             <option name="F" argsep="^">
00152                <argument name="context" required="false" />
00153                <argument name="exten" required="false" />
00154                <argument name="priority" required="true" />
00155                <para>When the caller hangs up, transfer the <emphasis>called</emphasis> party
00156                to the specified destination and <emphasis>start</emphasis> execution at that location.</para>
00157                <note>
00158                   <para>Any channel variables you want the called channel to inherit from the caller channel must be
00159                   prefixed with one or two underbars ('_').</para>
00160                </note>
00161             </option>
00162             <option name="F">
00163                <para>When the caller hangs up, transfer the <emphasis>called</emphasis> party to the next priority of the current extension
00164                and <emphasis>start</emphasis> execution at that location.</para>
00165                <note>
00166                   <para>Any channel variables you want the called channel to inherit from the caller channel must be
00167                   prefixed with one or two underbars ('_').</para>
00168                </note>
00169                <note>
00170                   <para>Using this option from a Macro() or GoSub() might not make sense as there would be no return points.</para>
00171                </note>
00172             </option>
00173             <option name="g">
00174                <para>Proceed with dialplan execution at the next priority in the current extension if the
00175                destination channel hangs up.</para>
00176             </option>
00177             <option name="G" argsep="^">
00178                <argument name="context" required="false" />
00179                <argument name="exten" required="false" />
00180                <argument name="priority" required="true" />
00181                <para>If the call is answered, transfer the calling party to
00182                the specified <replaceable>priority</replaceable> and the called party to the specified 
00183                <replaceable>priority</replaceable> plus one.</para>
00184                <note>
00185                   <para>You cannot use any additional action post answer options in conjunction with this option.</para>
00186                </note>
00187             </option>
00188             <option name="h">
00189                <para>Allow the called party to hang up by sending the DTMF sequence
00190                defined for disconnect in <filename>features.conf</filename>.</para>
00191             </option>
00192             <option name="H">
00193                <para>Allow the calling party to hang up by sending the DTMF sequence
00194                defined for disconnect in <filename>features.conf</filename>.</para>
00195                <note>
00196                   <para>Many SIP and ISDN phones cannot send DTMF digits until the call is
00197                   connected.  If you wish to allow DTMF disconnect before the dialed
00198                   party answers with these phones, you can use the <literal>Answer</literal>
00199                   application before dialing.</para>
00200                </note>
00201             </option>
00202             <option name="i">
00203                <para>Asterisk will ignore any forwarding requests it may receive on this dial attempt.</para>
00204             </option>
00205             <option name="I">
00206                <para>Asterisk will ignore any connected line update requests or any redirecting party
00207                update requests it may receive on this dial attempt.</para>
00208             </option>
00209             <option name="k">
00210                <para>Allow the called party to enable parking of the call by sending
00211                the DTMF sequence defined for call parking in <filename>features.conf</filename>.</para>
00212             </option>
00213             <option name="K">
00214                <para>Allow the calling party to enable parking of the call by sending
00215                the DTMF sequence defined for call parking in <filename>features.conf</filename>.</para>
00216             </option>
00217             <option name="L" argsep=":">
00218                <argument name="x" required="true">
00219                   <para>Maximum call time, in milliseconds</para>
00220                </argument>
00221                <argument name="y">
00222                   <para>Warning time, in milliseconds</para>
00223                </argument>
00224                <argument name="z">
00225                   <para>Repeat time, in milliseconds</para>
00226                </argument>
00227                <para>Limit the call to <replaceable>x</replaceable> milliseconds. Play a warning when <replaceable>y</replaceable> milliseconds are
00228                left. Repeat the warning every <replaceable>z</replaceable> milliseconds until time expires.</para>
00229                <para>This option is affected by the following variables:</para>
00230                <variablelist>
00231                   <variable name="LIMIT_PLAYAUDIO_CALLER">
00232                      <value name="yes" default="true" />
00233                      <value name="no" />
00234                      <para>If set, this variable causes Asterisk to play the prompts to the caller.</para>
00235                   </variable>
00236                   <variable name="LIMIT_PLAYAUDIO_CALLEE">
00237                      <value name="yes" />
00238                      <value name="no" default="true"/>
00239                      <para>If set, this variable causes Asterisk to play the prompts to the callee.</para>
00240                   </variable>
00241                   <variable name="LIMIT_TIMEOUT_FILE">
00242                      <value name="filename"/>
00243                      <para>If specified, <replaceable>filename</replaceable> specifies the sound prompt to play when the timeout is reached.
00244                      If not set, the time remaining will be announced.</para>
00245                   </variable>
00246                   <variable name="LIMIT_CONNECT_FILE">
00247                      <value name="filename"/>
00248                      <para>If specified, <replaceable>filename</replaceable> specifies the sound prompt to play when the call begins.
00249                      If not set, the time remaining will be announced.</para>
00250                   </variable>
00251                   <variable name="LIMIT_WARNING_FILE">
00252                      <value name="filename"/>
00253                      <para>If specified, <replaceable>filename</replaceable> specifies the sound prompt to play as
00254                      a warning when time <replaceable>x</replaceable> is reached. If not set, the time remaining will be announced.</para>
00255                   </variable>
00256                </variablelist>
00257             </option>
00258             <option name="m">
00259                <argument name="class" required="false"/>
00260                <para>Provide hold music to the calling party until a requested
00261                channel answers. A specific music on hold <replaceable>class</replaceable>
00262                (as defined in <filename>musiconhold.conf</filename>) can be specified.</para>
00263             </option>
00264             <option name="M" argsep="^">
00265                <argument name="macro" required="true">
00266                   <para>Name of the macro that should be executed.</para>
00267                </argument>
00268                <argument name="arg" multiple="true">
00269                   <para>Macro arguments</para>
00270                </argument>
00271                <para>Execute the specified <replaceable>macro</replaceable> for the <emphasis>called</emphasis> channel 
00272                before connecting to the calling channel. Arguments can be specified to the Macro
00273                using <literal>^</literal> as a delimiter. The macro can set the variable
00274                <variable>MACRO_RESULT</variable> to specify the following actions after the macro is
00275                finished executing:</para>
00276                <variablelist>
00277                   <variable name="MACRO_RESULT">
00278                      <para>If set, this action will be taken after the macro finished executing.</para>
00279                      <value name="ABORT">
00280                         Hangup both legs of the call
00281                      </value>
00282                      <value name="CONGESTION">
00283                         Behave as if line congestion was encountered
00284                      </value>
00285                      <value name="BUSY">
00286                         Behave as if a busy signal was encountered
00287                      </value>
00288                      <value name="CONTINUE">
00289                         Hangup the called party and allow the calling party to continue dialplan execution at the next priority
00290                      </value>
00291                      <!-- TODO: Fix this syntax up, once we've figured out how to specify the GOTO syntax -->
00292                      <value name="GOTO:&lt;context&gt;^&lt;exten&gt;^&lt;priority&gt;">
00293                         Transfer the call to the specified destination.
00294                      </value>
00295                   </variable>
00296                </variablelist>
00297                <note>
00298                   <para>You cannot use any additional action post answer options in conjunction
00299                   with this option. Also, pbx services are not run on the peer (called) channel,
00300                   so you will not be able to set timeouts via the TIMEOUT() function in this macro.</para>
00301                </note>
00302                <warning><para>Be aware of the limitations that macros have, specifically with regards to use of
00303                the <literal>WaitExten</literal> application. For more information, see the documentation for
00304                Macro()</para></warning>
00305             </option>
00306             <option name="n">
00307                     <argument name="delete">
00308                        <para>With <replaceable>delete</replaceable> either not specified or set to <literal>0</literal>,
00309                   the recorded introduction will not be deleted if the caller hangs up while the remote party has not
00310                   yet answered.</para>
00311                   <para>With <replaceable>delete</replaceable> set to <literal>1</literal>, the introduction will
00312                   always be deleted.</para>
00313                </argument>
00314                <para>This option is a modifier for the call screening/privacy mode. (See the 
00315                <literal>p</literal> and <literal>P</literal> options.) It specifies
00316                that no introductions are to be saved in the <directory>priv-callerintros</directory>
00317                directory.</para>
00318             </option>
00319             <option name="N">
00320                <para>This option is a modifier for the call screening/privacy mode. It specifies
00321                that if Caller*ID is present, do not screen the call.</para>
00322             </option>
00323             <option name="o">
00324                <argument name="x" required="false" />
00325                <para>If <replaceable>x</replaceable> is not provided, specify that the CallerID that was present on the
00326                <emphasis>calling</emphasis> channel be stored as the CallerID on the <emphasis>called</emphasis> channel.
00327                This was the behavior of Asterisk 1.0 and earlier.
00328                If <replaceable>x</replaceable> is provided, specify the CallerID stored on the <emphasis>called</emphasis> channel.
00329                Note that o(${CALLERID(all)}) is similar to option o without the parameter.</para>
00330             </option>
00331             <option name="O">
00332                <argument name="mode">
00333                   <para>With <replaceable>mode</replaceable> either not specified or set to <literal>1</literal>,
00334                   the originator hanging up will cause the phone to ring back immediately.</para>
00335                   <para>With <replaceable>mode</replaceable> set to <literal>2</literal>, when the operator 
00336                   flashes the trunk, it will ring their phone back.</para>
00337                </argument>
00338                <para>Enables <emphasis>operator services</emphasis> mode.  This option only
00339                works when bridging a DAHDI channel to another DAHDI channel
00340                only. if specified on non-DAHDI interfaces, it will be ignored.
00341                When the destination answers (presumably an operator services
00342                station), the originator no longer has control of their line.
00343                They may hang up, but the switch will not release their line
00344                until the destination party (the operator) hangs up.</para>
00345             </option>
00346             <option name="p">
00347                <para>This option enables screening mode. This is basically Privacy mode
00348                without memory.</para>
00349             </option>
00350             <option name="P">
00351                <argument name="x" />
00352                <para>Enable privacy mode. Use <replaceable>x</replaceable> as the family/key in the AstDB database if
00353                it is provided. The current extension is used if a database family/key is not specified.</para>
00354             </option>
00355             <option name="r">
00356                <para>Default: Indicate ringing to the calling party, even if the called party isn't actually ringing. Pass no audio to the calling
00357                party until the called channel has answered.</para>
00358                <argument name="tone" required="false">
00359                   <para>Indicate progress to calling party. Send audio 'tone' from indications.conf</para>
00360                </argument>
00361             </option>
00362             <option name="S">
00363                <argument name="x" required="true" />
00364                <para>Hang up the call <replaceable>x</replaceable> seconds <emphasis>after</emphasis> the called party has
00365                answered the call.</para>
00366             </option>
00367             <option name="s">
00368                <argument name="x" required="true" />
00369                <para>Force the outgoing callerid tag parameter to be set to the string <replaceable>x</replaceable>.</para>
00370                <para>Works with the f option.</para>
00371             </option>
00372             <option name="t">
00373                <para>Allow the called party to transfer the calling party by sending the
00374                DTMF sequence defined in <filename>features.conf</filename>. This setting does not perform policy enforcement on
00375                transfers initiated by other methods.</para>
00376             </option>
00377             <option name="T">
00378                <para>Allow the calling party to transfer the called party by sending the
00379                DTMF sequence defined in <filename>features.conf</filename>. This setting does not perform policy enforcement on
00380                transfers initiated by other methods.</para>
00381             </option>
00382             <option name="U" argsep="^">
00383                <argument name="x" required="true">
00384                   <para>Name of the subroutine to execute via Gosub</para>
00385                </argument>
00386                <argument name="arg" multiple="true" required="false">
00387                   <para>Arguments for the Gosub routine</para>
00388                </argument>
00389                <para>Execute via Gosub the routine <replaceable>x</replaceable> for the <emphasis>called</emphasis> channel before connecting
00390                to the calling channel. Arguments can be specified to the Gosub
00391                using <literal>^</literal> as a delimiter. The Gosub routine can set the variable
00392                <variable>GOSUB_RESULT</variable> to specify the following actions after the Gosub returns.</para>
00393                <variablelist>
00394                   <variable name="GOSUB_RESULT">
00395                      <value name="ABORT">
00396                         Hangup both legs of the call.
00397                      </value>
00398                      <value name="CONGESTION">
00399                         Behave as if line congestion was encountered.
00400                      </value>
00401                      <value name="BUSY">
00402                         Behave as if a busy signal was encountered.
00403                      </value>
00404                      <value name="CONTINUE">
00405                         Hangup the called party and allow the calling party
00406                         to continue dialplan execution at the next priority.
00407                      </value>
00408                      <!-- TODO: Fix this syntax up, once we've figured out how to specify the GOTO syntax -->
00409                      <value name="GOTO:&lt;context&gt;^&lt;exten&gt;^&lt;priority&gt;">
00410                         Transfer the call to the specified priority. Optionally, an extension, or
00411                         extension and priority can be specified.
00412                      </value>
00413                   </variable>
00414                </variablelist>
00415                <note>
00416                   <para>You cannot use any additional action post answer options in conjunction
00417                   with this option. Also, pbx services are not run on the peer (called) channel,
00418                   so you will not be able to set timeouts via the TIMEOUT() function in this routine.</para>
00419                </note>
00420             </option>
00421             <option name="u">
00422                <argument name = "x" required="true">
00423                   <para>Force the outgoing callerid presentation indicator parameter to be set
00424                   to one of the values passed in <replaceable>x</replaceable>:
00425                   <literal>allowed_not_screened</literal>
00426                   <literal>allowed_passed_screen</literal>
00427                   <literal>allowed_failed_screen</literal>
00428                   <literal>allowed</literal>
00429                   <literal>prohib_not_screened</literal>
00430                   <literal>prohib_passed_screen</literal>
00431                   <literal>prohib_failed_screen</literal>
00432                   <literal>prohib</literal>
00433                   <literal>unavailable</literal></para>
00434                </argument>
00435                <para>Works with the f option.</para>
00436             </option>
00437             <option name="w">
00438                <para>Allow the called party to enable recording of the call by sending
00439                the DTMF sequence defined for one-touch recording in <filename>features.conf</filename>.</para>
00440             </option>
00441             <option name="W">
00442                <para>Allow the calling party to enable recording of the call by sending
00443                the DTMF sequence defined for one-touch recording in <filename>features.conf</filename>.</para>
00444             </option>
00445             <option name="x">
00446                <para>Allow the called party to enable recording of the call by sending
00447                the DTMF sequence defined for one-touch automixmonitor in <filename>features.conf</filename>.</para>
00448             </option>
00449             <option name="X">
00450                <para>Allow the calling party to enable recording of the call by sending
00451                the DTMF sequence defined for one-touch automixmonitor in <filename>features.conf</filename>.</para>
00452             </option>
00453             <option name="z">
00454                <para>On a call forward, cancel any dial timeout which has been set for this call.</para>
00455             </option>
00456             </optionlist>
00457          </parameter>
00458          <parameter name="URL">
00459             <para>The optional URL will be sent to the called party if the channel driver supports it.</para>
00460          </parameter>
00461       </syntax>
00462       <description>
00463          <para>This application will place calls to one or more specified channels. As soon
00464          as one of the requested channels answers, the originating channel will be
00465          answered, if it has not already been answered. These two channels will then
00466          be active in a bridged call. All other channels that were requested will then
00467          be hung up.</para>
00468 
00469          <para>Unless there is a timeout specified, the Dial application will wait
00470          indefinitely until one of the called channels answers, the user hangs up, or
00471          if all of the called channels are busy or unavailable. Dialplan executing will
00472          continue if no requested channels can be called, or if the timeout expires.
00473          This application will report normal termination if the originating channel
00474          hangs up, or if the call is bridged and either of the parties in the bridge
00475          ends the call.</para>
00476          <para>If the <variable>OUTBOUND_GROUP</variable> variable is set, all peer channels created by this
00477          application will be put into that group (as in Set(GROUP()=...).
00478          If the <variable>OUTBOUND_GROUP_ONCE</variable> variable is set, all peer channels created by this
00479          application will be put into that group (as in Set(GROUP()=...). Unlike <variable>OUTBOUND_GROUP</variable>,
00480          however, the variable will be unset after use.</para>
00481 
00482          <para>This application sets the following channel variables:</para>
00483          <variablelist>
00484             <variable name="DIALEDTIME">
00485                <para>This is the time from dialing a channel until when it is disconnected.</para>
00486             </variable>
00487             <variable name="ANSWEREDTIME">
00488                <para>This is the amount of time for actual call.</para>
00489             </variable>
00490             <variable name="DIALSTATUS">
00491                <para>This is the status of the call</para>
00492                <value name="CHANUNAVAIL" />
00493                <value name="CONGESTION" />
00494                <value name="NOANSWER" />
00495                <value name="BUSY" />
00496                <value name="ANSWER" />
00497                <value name="CANCEL" />
00498                <value name="DONTCALL">
00499                   For the Privacy and Screening Modes.
00500                   Will be set if the called party chooses to send the calling party to the 'Go Away' script.
00501                </value>
00502                <value name="TORTURE">
00503                   For the Privacy and Screening Modes.
00504                   Will be set if the called party chooses to send the calling party to the 'torture' script.
00505                </value>
00506                <value name="INVALIDARGS" />
00507             </variable>
00508          </variablelist>
00509       </description>
00510    </application>
00511    <application name="RetryDial" language="en_US">
00512       <synopsis>
00513          Place a call, retrying on failure allowing an optional exit extension.
00514       </synopsis>
00515       <syntax>
00516          <parameter name="announce" required="true">
00517             <para>Filename of sound that will be played when no channel can be reached</para>
00518          </parameter>
00519          <parameter name="sleep" required="true">
00520             <para>Number of seconds to wait after a dial attempt failed before a new attempt is made</para>
00521          </parameter>
00522          <parameter name="retries" required="true">
00523             <para>Number of retries</para>
00524             <para>When this is reached flow will continue at the next priority in the dialplan</para>
00525          </parameter>
00526          <parameter name="dialargs" required="true">
00527             <para>Same format as arguments provided to the Dial application</para>
00528          </parameter>
00529       </syntax>
00530       <description>
00531          <para>This application will attempt to place a call using the normal Dial application.
00532          If no channel can be reached, the <replaceable>announce</replaceable> file will be played.
00533          Then, it will wait <replaceable>sleep</replaceable> number of seconds before retrying the call.
00534          After <replaceable>retries</replaceable> number of attempts, the calling channel will continue at the next priority in the dialplan.
00535          If the <replaceable>retries</replaceable> setting is set to 0, this application will retry endlessly.
00536          While waiting to retry a call, a 1 digit extension may be dialed. If that
00537          extension exists in either the context defined in <variable>EXITCONTEXT</variable> or the current
00538          one, The call will jump to that extension immediately.
00539          The <replaceable>dialargs</replaceable> are specified in the same format that arguments are provided
00540          to the Dial application.</para>
00541       </description>
00542    </application>
00543  ***/
00544 
00545 static const char app[] = "Dial";
00546 static const char rapp[] = "RetryDial";
00547 
00548 enum {
00549    OPT_ANNOUNCE =          (1 << 0),
00550    OPT_RESETCDR =          (1 << 1),
00551    OPT_DTMF_EXIT =         (1 << 2),
00552    OPT_SENDDTMF =          (1 << 3),
00553    OPT_FORCECLID =         (1 << 4),
00554    OPT_GO_ON =             (1 << 5),
00555    OPT_CALLEE_HANGUP =     (1 << 6),
00556    OPT_CALLER_HANGUP =     (1 << 7),
00557    OPT_ORIGINAL_CLID =     (1 << 8),
00558    OPT_DURATION_LIMIT =    (1 << 9),
00559    OPT_MUSICBACK =         (1 << 10),
00560    OPT_CALLEE_MACRO =      (1 << 11),
00561    OPT_SCREEN_NOINTRO =    (1 << 12),
00562    OPT_SCREEN_NOCALLERID = (1 << 13),
00563    OPT_IGNORE_CONNECTEDLINE = (1 << 14),
00564    OPT_SCREENING =         (1 << 15),
00565    OPT_PRIVACY =           (1 << 16),
00566    OPT_RINGBACK =          (1 << 17),
00567    OPT_DURATION_STOP =     (1 << 18),
00568    OPT_CALLEE_TRANSFER =   (1 << 19),
00569    OPT_CALLER_TRANSFER =   (1 << 20),
00570    OPT_CALLEE_MONITOR =    (1 << 21),
00571    OPT_CALLER_MONITOR =    (1 << 22),
00572    OPT_GOTO =              (1 << 23),
00573    OPT_OPERMODE =          (1 << 24),
00574    OPT_CALLEE_PARK =       (1 << 25),
00575    OPT_CALLER_PARK =       (1 << 26),
00576    OPT_IGNORE_FORWARDING = (1 << 27),
00577    OPT_CALLEE_GOSUB =      (1 << 28),
00578    OPT_CALLEE_MIXMONITOR = (1 << 29),
00579    OPT_CALLER_MIXMONITOR = (1 << 30),
00580 };
00581 
00582 /* flags are now 64 bits, so keep it up! */
00583 #define DIAL_STILLGOING      (1LLU << 31)
00584 #define DIAL_NOFORWARDHTML   (1LLU << 32)
00585 #define DIAL_CALLERID_ABSENT (1LLU << 33) /* TRUE if caller id is not available for connected line. */
00586 #define OPT_CANCEL_ELSEWHERE (1LLU << 34)
00587 #define OPT_PEER_H           (1LLU << 35)
00588 #define OPT_CALLEE_GO_ON     (1LLU << 36)
00589 #define OPT_CANCEL_TIMEOUT   (1LLU << 37)
00590 #define OPT_FORCE_CID_TAG    (1LLU << 38)
00591 #define OPT_FORCE_CID_PRES   (1LLU << 39)
00592 #define OPT_CALLER_ANSWER    (1LLU << 40)
00593 
00594 enum {
00595    OPT_ARG_ANNOUNCE = 0,
00596    OPT_ARG_SENDDTMF,
00597    OPT_ARG_GOTO,
00598    OPT_ARG_DURATION_LIMIT,
00599    OPT_ARG_MUSICBACK,
00600    OPT_ARG_CALLEE_MACRO,
00601    OPT_ARG_RINGBACK,
00602    OPT_ARG_CALLEE_GOSUB,
00603    OPT_ARG_CALLEE_GO_ON,
00604    OPT_ARG_PRIVACY,
00605    OPT_ARG_DURATION_STOP,
00606    OPT_ARG_OPERMODE,
00607    OPT_ARG_SCREEN_NOINTRO,
00608    OPT_ARG_ORIGINAL_CLID,
00609    OPT_ARG_FORCECLID,
00610    OPT_ARG_FORCE_CID_TAG,
00611    OPT_ARG_FORCE_CID_PRES,
00612    /* note: this entry _MUST_ be the last one in the enum */
00613    OPT_ARG_ARRAY_SIZE,
00614 };
00615 
00616 AST_APP_OPTIONS(dial_exec_options, BEGIN_OPTIONS
00617    AST_APP_OPTION_ARG('A', OPT_ANNOUNCE, OPT_ARG_ANNOUNCE),
00618    AST_APP_OPTION('a', OPT_CALLER_ANSWER),
00619    AST_APP_OPTION('C', OPT_RESETCDR),
00620    AST_APP_OPTION('c', OPT_CANCEL_ELSEWHERE),
00621    AST_APP_OPTION('d', OPT_DTMF_EXIT),
00622    AST_APP_OPTION_ARG('D', OPT_SENDDTMF, OPT_ARG_SENDDTMF),
00623    AST_APP_OPTION('e', OPT_PEER_H),
00624    AST_APP_OPTION_ARG('f', OPT_FORCECLID, OPT_ARG_FORCECLID),
00625    AST_APP_OPTION_ARG('F', OPT_CALLEE_GO_ON, OPT_ARG_CALLEE_GO_ON),
00626    AST_APP_OPTION('g', OPT_GO_ON),
00627    AST_APP_OPTION_ARG('G', OPT_GOTO, OPT_ARG_GOTO),
00628    AST_APP_OPTION('h', OPT_CALLEE_HANGUP),
00629    AST_APP_OPTION('H', OPT_CALLER_HANGUP),
00630    AST_APP_OPTION('i', OPT_IGNORE_FORWARDING),
00631    AST_APP_OPTION('I', OPT_IGNORE_CONNECTEDLINE),
00632    AST_APP_OPTION('k', OPT_CALLEE_PARK),
00633    AST_APP_OPTION('K', OPT_CALLER_PARK),
00634    AST_APP_OPTION_ARG('L', OPT_DURATION_LIMIT, OPT_ARG_DURATION_LIMIT),
00635    AST_APP_OPTION_ARG('m', OPT_MUSICBACK, OPT_ARG_MUSICBACK),
00636    AST_APP_OPTION_ARG('M', OPT_CALLEE_MACRO, OPT_ARG_CALLEE_MACRO),
00637    AST_APP_OPTION_ARG('n', OPT_SCREEN_NOINTRO, OPT_ARG_SCREEN_NOINTRO),
00638    AST_APP_OPTION('N', OPT_SCREEN_NOCALLERID),
00639    AST_APP_OPTION_ARG('o', OPT_ORIGINAL_CLID, OPT_ARG_ORIGINAL_CLID),
00640    AST_APP_OPTION_ARG('O', OPT_OPERMODE, OPT_ARG_OPERMODE),
00641    AST_APP_OPTION('p', OPT_SCREENING),
00642    AST_APP_OPTION_ARG('P', OPT_PRIVACY, OPT_ARG_PRIVACY),
00643    AST_APP_OPTION_ARG('r', OPT_RINGBACK, OPT_ARG_RINGBACK),
00644    AST_APP_OPTION_ARG('S', OPT_DURATION_STOP, OPT_ARG_DURATION_STOP),
00645    AST_APP_OPTION_ARG('s', OPT_FORCE_CID_TAG, OPT_ARG_FORCE_CID_TAG),
00646    AST_APP_OPTION_ARG('u', OPT_FORCE_CID_PRES, OPT_ARG_FORCE_CID_PRES),
00647    AST_APP_OPTION('t', OPT_CALLEE_TRANSFER),
00648    AST_APP_OPTION('T', OPT_CALLER_TRANSFER),
00649    AST_APP_OPTION_ARG('U', OPT_CALLEE_GOSUB, OPT_ARG_CALLEE_GOSUB),
00650    AST_APP_OPTION('w', OPT_CALLEE_MONITOR),
00651    AST_APP_OPTION('W', OPT_CALLER_MONITOR),
00652    AST_APP_OPTION('x', OPT_CALLEE_MIXMONITOR),
00653    AST_APP_OPTION('X', OPT_CALLER_MIXMONITOR),
00654    AST_APP_OPTION('z', OPT_CANCEL_TIMEOUT),
00655 END_OPTIONS );
00656 
00657 #define CAN_EARLY_BRIDGE(flags,chan,peer) (!ast_test_flag64(flags, OPT_CALLEE_HANGUP | \
00658    OPT_CALLER_HANGUP | OPT_CALLEE_TRANSFER | OPT_CALLER_TRANSFER | \
00659    OPT_CALLEE_MONITOR | OPT_CALLER_MONITOR | OPT_CALLEE_PARK |  \
00660    OPT_CALLER_PARK | OPT_ANNOUNCE | OPT_CALLEE_MACRO | OPT_CALLEE_GOSUB) && \
00661    !chan->audiohooks && !peer->audiohooks && \
00662    ast_framehook_list_is_empty(chan->framehooks) && ast_framehook_list_is_empty(peer->framehooks))
00663 
00664 /*
00665  * The list of active channels
00666  */
00667 struct chanlist {
00668    struct chanlist *next;
00669    struct ast_channel *chan;
00670    uint64_t flags;
00671    /*! Saved connected party info from an AST_CONTROL_CONNECTED_LINE. */
00672    struct ast_party_connected_line connected;
00673    /*! TRUE if an AST_CONTROL_CONNECTED_LINE update was saved to the connected element. */
00674    unsigned int pending_connected_update:1;
00675    struct ast_aoc_decoded *aoc_s_rate_list;
00676 };
00677 
00678 static int detect_disconnect(struct ast_channel *chan, char code, struct ast_str *featurecode);
00679 
00680 static void chanlist_free(struct chanlist *outgoing)
00681 {
00682    ast_party_connected_line_free(&outgoing->connected);
00683    ast_aoc_destroy_decoded(outgoing->aoc_s_rate_list);
00684    ast_free(outgoing);
00685 }
00686 
00687 static void hanguptree(struct chanlist *outgoing, struct ast_channel *exception, int answered_elsewhere)
00688 {
00689    /* Hang up a tree of stuff */
00690    struct chanlist *oo;
00691    while (outgoing) {
00692       /* Hangup any existing lines we have open */
00693       if (outgoing->chan && (outgoing->chan != exception)) {
00694          if (answered_elsewhere) {
00695             /* The flag is used for local channel inheritance and stuff */
00696             ast_set_flag(outgoing->chan, AST_FLAG_ANSWERED_ELSEWHERE);
00697             /* This is for the channel drivers */
00698             outgoing->chan->hangupcause = AST_CAUSE_ANSWERED_ELSEWHERE;
00699          }
00700          ast_hangup(outgoing->chan);
00701       }
00702       oo = outgoing;
00703       outgoing = outgoing->next;
00704       chanlist_free(oo);
00705    }
00706 }
00707 
00708 #define AST_MAX_WATCHERS 256
00709 
00710 /*
00711  * argument to handle_cause() and other functions.
00712  */
00713 struct cause_args {
00714    struct ast_channel *chan;
00715    int busy;
00716    int congestion;
00717    int nochan;
00718 };
00719 
00720 static void handle_cause(int cause, struct cause_args *num)
00721 {
00722    struct ast_cdr *cdr = num->chan->cdr;
00723 
00724    switch(cause) {
00725    case AST_CAUSE_BUSY:
00726       if (cdr)
00727          ast_cdr_busy(cdr);
00728       num->busy++;
00729       break;
00730 
00731    case AST_CAUSE_CONGESTION:
00732       if (cdr)
00733          ast_cdr_failed(cdr);
00734       num->congestion++;
00735       break;
00736 
00737    case AST_CAUSE_NO_ROUTE_DESTINATION:
00738    case AST_CAUSE_UNREGISTERED:
00739       if (cdr)
00740          ast_cdr_failed(cdr);
00741       num->nochan++;
00742       break;
00743 
00744    case AST_CAUSE_NO_ANSWER:
00745       if (cdr) {
00746          ast_cdr_noanswer(cdr);
00747       }
00748       break;
00749    case AST_CAUSE_NORMAL_CLEARING:
00750       break;
00751 
00752    default:
00753       num->nochan++;
00754       break;
00755    }
00756 }
00757 
00758 static int onedigit_goto(struct ast_channel *chan, const char *context, char exten, int pri)
00759 {
00760    char rexten[2] = { exten, '\0' };
00761 
00762    if (context) {
00763       if (!ast_goto_if_exists(chan, context, rexten, pri))
00764          return 1;
00765    } else {
00766       if (!ast_goto_if_exists(chan, chan->context, rexten, pri))
00767          return 1;
00768       else if (!ast_strlen_zero(chan->macrocontext)) {
00769          if (!ast_goto_if_exists(chan, chan->macrocontext, rexten, pri))
00770             return 1;
00771       }
00772    }
00773    return 0;
00774 }
00775 
00776 /* do not call with chan lock held */
00777 static const char *get_cid_name(char *name, int namelen, struct ast_channel *chan)
00778 {
00779    const char *context;
00780    const char *exten;
00781 
00782    ast_channel_lock(chan);
00783    context = ast_strdupa(S_OR(chan->macrocontext, chan->context));
00784    exten = ast_strdupa(S_OR(chan->macroexten, chan->exten));
00785    ast_channel_unlock(chan);
00786 
00787    return ast_get_hint(NULL, 0, name, namelen, chan, context, exten) ? name : "";
00788 }
00789 
00790 static void senddialevent(struct ast_channel *src, struct ast_channel *dst, const char *dialstring)
00791 {
00792    struct ast_channel *chans[] = { src, dst };
00793    ast_manager_event_multichan(EVENT_FLAG_CALL, "Dial", 2, chans,
00794       "SubEvent: Begin\r\n"
00795       "Channel: %s\r\n"
00796       "Destination: %s\r\n"
00797       "CallerIDNum: %s\r\n"
00798       "CallerIDName: %s\r\n"
00799       "ConnectedLineNum: %s\r\n"
00800       "ConnectedLineName: %s\r\n"
00801       "UniqueID: %s\r\n"
00802       "DestUniqueID: %s\r\n"
00803       "Dialstring: %s\r\n",
00804       ast_channel_name(src), ast_channel_name(dst),
00805       S_COR(src->caller.id.number.valid, src->caller.id.number.str, "<unknown>"),
00806       S_COR(src->caller.id.name.valid, src->caller.id.name.str, "<unknown>"),
00807       S_COR(src->connected.id.number.valid, src->connected.id.number.str, "<unknown>"),
00808       S_COR(src->connected.id.name.valid, src->connected.id.name.str, "<unknown>"),
00809       ast_channel_uniqueid(src), ast_channel_uniqueid(dst),
00810       dialstring ? dialstring : "");
00811 }
00812 
00813 static void senddialendevent(struct ast_channel *src, const char *dialstatus)
00814 {
00815    ast_manager_event(src, EVENT_FLAG_CALL, "Dial",
00816       "SubEvent: End\r\n"
00817       "Channel: %s\r\n"
00818       "UniqueID: %s\r\n"
00819       "DialStatus: %s\r\n",
00820       ast_channel_name(src), ast_channel_uniqueid(src), dialstatus);
00821 }
00822 
00823 /*!
00824  * helper function for wait_for_answer()
00825  *
00826  * XXX this code is highly suspicious, as it essentially overwrites
00827  * the outgoing channel without properly deleting it.
00828  *
00829  * \todo eventually this function should be intergrated into and replaced by ast_call_forward() 
00830  */
00831 static void do_forward(struct chanlist *o,
00832    struct cause_args *num, struct ast_flags64 *peerflags, int single, int *to,
00833    struct ast_party_id *forced_clid, struct ast_party_id *stored_clid)
00834 {
00835    char tmpchan[256];
00836    struct ast_channel *original = o->chan;
00837    struct ast_channel *c = o->chan; /* the winner */
00838    struct ast_channel *in = num->chan; /* the input channel */
00839    char *stuff;
00840    char *tech;
00841    int cause;
00842    struct ast_party_caller caller;
00843 
00844    ast_copy_string(tmpchan, ast_channel_call_forward(c), sizeof(tmpchan));
00845    if ((stuff = strchr(tmpchan, '/'))) {
00846       *stuff++ = '\0';
00847       tech = tmpchan;
00848    } else {
00849       const char *forward_context;
00850       ast_channel_lock(c);
00851       forward_context = pbx_builtin_getvar_helper(c, "FORWARD_CONTEXT");
00852       if (ast_strlen_zero(forward_context)) {
00853          forward_context = NULL;
00854       }
00855       snprintf(tmpchan, sizeof(tmpchan), "%s@%s", ast_channel_call_forward(c), forward_context ? forward_context : c->context);
00856       ast_channel_unlock(c);
00857       stuff = tmpchan;
00858       tech = "Local";
00859    }
00860 
00861    ast_cel_report_event(in, AST_CEL_FORWARD, NULL, ast_channel_call_forward(c), NULL);
00862 
00863    /* Before processing channel, go ahead and check for forwarding */
00864    ast_verb(3, "Now forwarding %s to '%s/%s' (thanks to %s)\n", ast_channel_name(in), tech, stuff, ast_channel_name(c));
00865    /* If we have been told to ignore forwards, just set this channel to null and continue processing extensions normally */
00866    if (ast_test_flag64(peerflags, OPT_IGNORE_FORWARDING)) {
00867       ast_verb(3, "Forwarding %s to '%s/%s' prevented.\n", ast_channel_name(in), tech, stuff);
00868       c = o->chan = NULL;
00869       cause = AST_CAUSE_BUSY;
00870    } else {
00871       /* Setup parameters */
00872       c = o->chan = ast_request(tech, in->nativeformats, in, stuff, &cause);
00873       if (c) {
00874          if (single)
00875             ast_channel_make_compatible(o->chan, in);
00876          ast_channel_inherit_variables(in, o->chan);
00877          ast_channel_datastore_inherit(in, o->chan);
00878          /* When a call is forwarded, we don't want to track new interfaces
00879           * dialed for CC purposes. Setting the done flag will ensure that
00880           * any Dial operations that happen later won't record CC interfaces.
00881           */
00882          ast_ignore_cc(o->chan);
00883          ast_log(LOG_NOTICE, "Not accepting call completion offers from call-forward recipient %s\n", ast_channel_name(o->chan));
00884       } else
00885          ast_log(LOG_NOTICE,
00886             "Forwarding failed to create channel to dial '%s/%s' (cause = %d)\n",
00887             tech, stuff, cause);
00888    }
00889    if (!c) {
00890       ast_clear_flag64(o, DIAL_STILLGOING);
00891       handle_cause(cause, num);
00892       ast_hangup(original);
00893    } else {
00894       struct ast_party_redirecting redirecting;
00895 
00896       if (single && CAN_EARLY_BRIDGE(peerflags, c, in)) {
00897          ast_rtp_instance_early_bridge_make_compatible(c, in);
00898       }
00899 
00900       ast_channel_set_redirecting(c, &original->redirecting, NULL);
00901       ast_channel_lock(c);
00902       while (ast_channel_trylock(in)) {
00903          CHANNEL_DEADLOCK_AVOIDANCE(c);
00904       }
00905       if (!c->redirecting.from.number.valid
00906          || ast_strlen_zero(c->redirecting.from.number.str)) {
00907          /*
00908           * The call was not previously redirected so it is
00909           * now redirected from this number.
00910           */
00911          ast_party_number_free(&c->redirecting.from.number);
00912          ast_party_number_init(&c->redirecting.from.number);
00913          c->redirecting.from.number.valid = 1;
00914          c->redirecting.from.number.str =
00915             ast_strdup(S_OR(in->macroexten, in->exten));
00916       }
00917 
00918       c->dialed.transit_network_select = in->dialed.transit_network_select;
00919 
00920       /* Determine CallerID to store in outgoing channel. */
00921       ast_party_caller_set_init(&caller, &c->caller);
00922       if (ast_test_flag64(peerflags, OPT_ORIGINAL_CLID)) {
00923          caller.id = *stored_clid;
00924          ast_channel_set_caller_event(c, &caller, NULL);
00925       } else if (ast_strlen_zero(S_COR(c->caller.id.number.valid,
00926          c->caller.id.number.str, NULL))) {
00927          /*
00928           * The new channel has no preset CallerID number by the channel
00929           * driver.  Use the dialplan extension and hint name.
00930           */
00931          caller.id = *stored_clid;
00932          ast_channel_set_caller_event(c, &caller, NULL);
00933       }
00934 
00935       /* Determine CallerID for outgoing channel to send. */
00936       if (ast_test_flag64(o, OPT_FORCECLID)) {
00937          struct ast_party_connected_line connected;
00938 
00939          ast_party_connected_line_init(&connected);
00940          connected.id = *forced_clid;
00941          ast_party_connected_line_copy(&c->connected, &connected);
00942       } else {
00943          ast_connected_line_copy_from_caller(&c->connected, &in->caller);
00944       }
00945 
00946       ast_channel_accountcode_set(c, ast_channel_accountcode(in));
00947 
00948       c->appl = "AppDial";
00949       c->data = "(Outgoing Line)";
00950       /*
00951        * We must unlock c before calling ast_channel_redirecting_macro, because
00952        * we put c into autoservice there. That is pretty much a guaranteed
00953        * deadlock. This is why the handling of c's lock may seem a bit unusual
00954        * here.
00955        */
00956       ast_party_redirecting_init(&redirecting);
00957       ast_party_redirecting_copy(&redirecting, &c->redirecting);
00958       ast_channel_unlock(c);
00959       if (ast_channel_redirecting_macro(c, in, &redirecting, 1, 0)) {
00960          ast_channel_update_redirecting(in, &redirecting, NULL);
00961       }
00962       ast_party_redirecting_free(&redirecting);
00963       ast_channel_unlock(in);
00964 
00965       ast_clear_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE);
00966       if (ast_test_flag64(peerflags, OPT_CANCEL_TIMEOUT)) {
00967          *to = -1;
00968       }
00969 
00970       if (ast_call(c, stuff, 0)) {
00971          ast_log(LOG_NOTICE, "Forwarding failed to dial '%s/%s'\n",
00972             tech, stuff);
00973          ast_clear_flag64(o, DIAL_STILLGOING);
00974          ast_hangup(original);
00975          ast_hangup(c);
00976          c = o->chan = NULL;
00977          num->nochan++;
00978       } else {
00979          ast_channel_lock(c);
00980          while (ast_channel_trylock(in)) {
00981             CHANNEL_DEADLOCK_AVOIDANCE(c);
00982          }
00983          senddialevent(in, c, stuff);
00984          ast_channel_unlock(in);
00985          ast_channel_unlock(c);
00986          /* Hangup the original channel now, in case we needed it */
00987          ast_hangup(original);
00988       }
00989       if (single) {
00990          ast_indicate(in, -1);
00991       }
00992    }
00993 }
00994 
00995 /* argument used for some functions. */
00996 struct privacy_args {
00997    int sentringing;
00998    int privdb_val;
00999    char privcid[256];
01000    char privintro[1024];
01001    char status[256];
01002 };
01003 
01004 static struct ast_channel *wait_for_answer(struct ast_channel *in,
01005    struct chanlist *outgoing, int *to, struct ast_flags64 *peerflags,
01006    char *opt_args[],
01007    struct privacy_args *pa,
01008    const struct cause_args *num_in, int *result, char *dtmf_progress,
01009    const int ignore_cc,
01010    struct ast_party_id *forced_clid, struct ast_party_id *stored_clid)
01011 {
01012    struct cause_args num = *num_in;
01013    int prestart = num.busy + num.congestion + num.nochan;
01014    int orig = *to;
01015    struct ast_channel *peer = NULL;
01016    /* single is set if only one destination is enabled */
01017    int single = outgoing && !outgoing->next;
01018 #ifdef HAVE_EPOLL
01019    struct chanlist *epollo;
01020 #endif
01021    struct ast_party_connected_line connected_caller;
01022    struct ast_str *featurecode = ast_str_alloca(FEATURE_MAX_LEN + 1);
01023    int cc_recall_core_id;
01024    int is_cc_recall;
01025    int cc_frame_received = 0;
01026    int num_ringing = 0;
01027 
01028    ast_party_connected_line_init(&connected_caller);
01029    if (single) {
01030       /* Turn off hold music, etc */
01031       if (!ast_test_flag64(outgoing, OPT_MUSICBACK | OPT_RINGBACK)) {
01032          ast_deactivate_generator(in);
01033          /* If we are calling a single channel, and not providing ringback or music, */
01034          /* then, make them compatible for in-band tone purpose */
01035          if (ast_channel_make_compatible(outgoing->chan, in) < 0) {
01036             /* If these channels can not be made compatible, 
01037              * there is no point in continuing.  The bridge
01038              * will just fail if it gets that far.
01039              */
01040             *to = -1;
01041             strcpy(pa->status, "CONGESTION");
01042             ast_cdr_failed(in->cdr);
01043             return NULL;
01044          }
01045       }
01046 
01047       if (!ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE) && !ast_test_flag64(outgoing, DIAL_CALLERID_ABSENT)) {
01048          ast_channel_lock(outgoing->chan);
01049          ast_connected_line_copy_from_caller(&connected_caller, &outgoing->chan->caller);
01050          ast_channel_unlock(outgoing->chan);
01051          connected_caller.source = AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER;
01052          ast_channel_update_connected_line(in, &connected_caller, NULL);
01053          ast_party_connected_line_free(&connected_caller);
01054       }
01055    }
01056 
01057    is_cc_recall = ast_cc_is_recall(in, &cc_recall_core_id, NULL);
01058 
01059 #ifdef HAVE_EPOLL
01060    for (epollo = outgoing; epollo; epollo = epollo->next)
01061       ast_poll_channel_add(in, epollo->chan);
01062 #endif
01063 
01064    while (*to && !peer) {
01065       struct chanlist *o;
01066       int pos = 0; /* how many channels do we handle */
01067       int numlines = prestart;
01068       struct ast_channel *winner;
01069       struct ast_channel *watchers[AST_MAX_WATCHERS];
01070 
01071       watchers[pos++] = in;
01072       for (o = outgoing; o; o = o->next) {
01073          /* Keep track of important channels */
01074          if (ast_test_flag64(o, DIAL_STILLGOING) && o->chan)
01075             watchers[pos++] = o->chan;
01076          numlines++;
01077       }
01078       if (pos == 1) { /* only the input channel is available */
01079          if (numlines == (num.busy + num.congestion + num.nochan)) {
01080             ast_verb(2, "Everyone is busy/congested at this time (%d:%d/%d/%d)\n", numlines, num.busy, num.congestion, num.nochan);
01081             if (num.busy)
01082                strcpy(pa->status, "BUSY");
01083             else if (num.congestion)
01084                strcpy(pa->status, "CONGESTION");
01085             else if (num.nochan)
01086                strcpy(pa->status, "CHANUNAVAIL");
01087          } else {
01088             ast_verb(3, "No one is available to answer at this time (%d:%d/%d/%d)\n", numlines, num.busy, num.congestion, num.nochan);
01089          }
01090          *to = 0;
01091          if (is_cc_recall) {
01092             ast_cc_failed(cc_recall_core_id, "Everyone is busy/congested for the recall. How sad");
01093          }
01094          return NULL;
01095       }
01096       winner = ast_waitfor_n(watchers, pos, to);
01097       for (o = outgoing; o; o = o->next) {
01098          struct ast_frame *f;
01099          struct ast_channel *c = o->chan;
01100 
01101          if (c == NULL)
01102             continue;
01103          if (ast_test_flag64(o, DIAL_STILLGOING) && c->_state == AST_STATE_UP) {
01104             if (!peer) {
01105                ast_verb(3, "%s answered %s\n", ast_channel_name(c), ast_channel_name(in));
01106                if (!single && !ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE)) {
01107                   if (o->pending_connected_update) {
01108                      if (ast_channel_connected_line_macro(c, in, &o->connected, 1, 0)) {
01109                         ast_channel_update_connected_line(in, &o->connected, NULL);
01110                      }
01111                   } else if (!ast_test_flag64(o, DIAL_CALLERID_ABSENT)) {
01112                      ast_channel_lock(c);
01113                      ast_connected_line_copy_from_caller(&connected_caller, &c->caller);
01114                      ast_channel_unlock(c);
01115                      connected_caller.source = AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER;
01116                      ast_channel_update_connected_line(in, &connected_caller, NULL);
01117                      ast_party_connected_line_free(&connected_caller);
01118                   }
01119                }
01120                if (o->aoc_s_rate_list) {
01121                   size_t encoded_size;
01122                   struct ast_aoc_encoded *encoded;
01123                   if ((encoded = ast_aoc_encode(o->aoc_s_rate_list, &encoded_size, o->chan))) {
01124                      ast_indicate_data(in, AST_CONTROL_AOC, encoded, encoded_size);
01125                      ast_aoc_destroy_encoded(encoded);
01126                   }
01127                }
01128                peer = c;
01129                ast_copy_flags64(peerflags, o,
01130                   OPT_CALLEE_TRANSFER | OPT_CALLER_TRANSFER |
01131                   OPT_CALLEE_HANGUP | OPT_CALLER_HANGUP |
01132                   OPT_CALLEE_MONITOR | OPT_CALLER_MONITOR |
01133                   OPT_CALLEE_PARK | OPT_CALLER_PARK |
01134                   OPT_CALLEE_MIXMONITOR | OPT_CALLER_MIXMONITOR |
01135                   DIAL_NOFORWARDHTML);
01136                ast_channel_dialcontext_set(c, "");
01137                ast_copy_string(c->exten, "", sizeof(c->exten));
01138             }
01139             continue;
01140          }
01141          if (c != winner)
01142             continue;
01143          /* here, o->chan == c == winner */
01144          if (!ast_strlen_zero(ast_channel_call_forward(c))) {
01145             pa->sentringing = 0;
01146             if (!ignore_cc && (f = ast_read(c))) {
01147                if (f->frametype == AST_FRAME_CONTROL && f->subclass.integer == AST_CONTROL_CC) {
01148                   /* This channel is forwarding the call, and is capable of CC, so
01149                    * be sure to add the new device interface to the list
01150                    */
01151                   ast_handle_cc_control_frame(in, c, f->data.ptr);
01152                }
01153                ast_frfree(f);
01154             }
01155             do_forward(o, &num, peerflags, single, to, forced_clid, stored_clid);
01156             continue;
01157          }
01158          f = ast_read(winner);
01159          if (!f) {
01160             in->hangupcause = c->hangupcause;
01161 #ifdef HAVE_EPOLL
01162             ast_poll_channel_del(in, c);
01163 #endif
01164             ast_hangup(c);
01165             c = o->chan = NULL;
01166             ast_clear_flag64(o, DIAL_STILLGOING);
01167             handle_cause(in->hangupcause, &num);
01168             continue;
01169          }
01170          if (f->frametype == AST_FRAME_CONTROL) {
01171             switch (f->subclass.integer) {
01172             case AST_CONTROL_ANSWER:
01173                /* This is our guy if someone answered. */
01174                if (!peer) {
01175                   ast_verb(3, "%s answered %s\n", ast_channel_name(c), ast_channel_name(in));
01176                   if (!single && !ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE)) {
01177                      if (o->pending_connected_update) {
01178                         if (ast_channel_connected_line_macro(c, in, &o->connected, 1, 0)) {
01179                            ast_channel_update_connected_line(in, &o->connected, NULL);
01180                         }
01181                      } else if (!ast_test_flag64(o, DIAL_CALLERID_ABSENT)) {
01182                         ast_channel_lock(c);
01183                         ast_connected_line_copy_from_caller(&connected_caller, &c->caller);
01184                         ast_channel_unlock(c);
01185                         connected_caller.source = AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER;
01186                         ast_channel_update_connected_line(in, &connected_caller, NULL);
01187                         ast_party_connected_line_free(&connected_caller);
01188                      }
01189                   }
01190                   if (o->aoc_s_rate_list) {
01191                      size_t encoded_size;
01192                      struct ast_aoc_encoded *encoded;
01193                      if ((encoded = ast_aoc_encode(o->aoc_s_rate_list, &encoded_size, o->chan))) {
01194                         ast_indicate_data(in, AST_CONTROL_AOC, encoded, encoded_size);
01195                         ast_aoc_destroy_encoded(encoded);
01196                      }
01197                   }
01198                   peer = c;
01199                   if (peer->cdr) {
01200                      peer->cdr->answer = ast_tvnow();
01201                      peer->cdr->disposition = AST_CDR_ANSWERED;
01202                   }
01203                   ast_copy_flags64(peerflags, o,
01204                      OPT_CALLEE_TRANSFER | OPT_CALLER_TRANSFER |
01205                      OPT_CALLEE_HANGUP | OPT_CALLER_HANGUP |
01206                      OPT_CALLEE_MONITOR | OPT_CALLER_MONITOR |
01207                      OPT_CALLEE_PARK | OPT_CALLER_PARK |
01208                      OPT_CALLEE_MIXMONITOR | OPT_CALLER_MIXMONITOR |
01209                      DIAL_NOFORWARDHTML);
01210                   ast_channel_dialcontext_set(c, "");
01211                   ast_copy_string(c->exten, "", sizeof(c->exten));
01212                   if (CAN_EARLY_BRIDGE(peerflags, in, peer))
01213                      /* Setup early bridge if appropriate */
01214                      ast_channel_early_bridge(in, peer);
01215                }
01216                /* If call has been answered, then the eventual hangup is likely to be normal hangup */
01217                in->hangupcause = AST_CAUSE_NORMAL_CLEARING;
01218                c->hangupcause = AST_CAUSE_NORMAL_CLEARING;
01219                break;
01220             case AST_CONTROL_BUSY:
01221                ast_verb(3, "%s is busy\n", ast_channel_name(c));
01222                in->hangupcause = c->hangupcause;
01223                ast_hangup(c);
01224                c = o->chan = NULL;
01225                ast_clear_flag64(o, DIAL_STILLGOING);
01226                handle_cause(AST_CAUSE_BUSY, &num);
01227                break;
01228             case AST_CONTROL_CONGESTION:
01229                ast_verb(3, "%s is circuit-busy\n", ast_channel_name(c));
01230                in->hangupcause = c->hangupcause;
01231                ast_hangup(c);
01232                c = o->chan = NULL;
01233                ast_clear_flag64(o, DIAL_STILLGOING);
01234                handle_cause(AST_CAUSE_CONGESTION, &num);
01235                break;
01236             case AST_CONTROL_RINGING:
01237                /* This is a tricky area to get right when using a native
01238                 * CC agent. The reason is that we do the best we can to send only a
01239                 * single ringing notification to the caller.
01240                 *
01241                 * Call completion complicates the logic used here. CCNR is typically
01242                 * offered during a ringing message. Let's say that party A calls
01243                 * parties B, C, and D. B and C do not support CC requests, but D
01244                 * does. If we were to receive a ringing notification from B before
01245                 * the others, then we would end up sending a ringing message to
01246                 * A with no CCNR offer present.
01247                 *
01248                 * The approach that we have taken is that if we receive a ringing
01249                 * response from a party and no CCNR offer is present, we need to
01250                 * wait. Specifically, we need to wait until either a) a called party
01251                 * offers CCNR in its ringing response or b) all called parties have
01252                 * responded in some way to our call and none offers CCNR.
01253                 *
01254                 * The drawback to this is that if one of the parties has a delayed
01255                 * response or, god forbid, one just plain doesn't respond to our
01256                 * outgoing call, then this will result in a significant delay between
01257                 * when the caller places the call and hears ringback.
01258                 *
01259                 * Note also that if CC is disabled for this call, then it is perfectly
01260                 * fine for ringing frames to get sent through.
01261                 */
01262                ++num_ringing;
01263                if (ignore_cc || cc_frame_received || num_ringing == numlines) {
01264                   ast_verb(3, "%s is ringing\n", ast_channel_name(c));
01265                   /* Setup early media if appropriate */
01266                   if (single && CAN_EARLY_BRIDGE(peerflags, in, c))
01267                      ast_channel_early_bridge(in, c);
01268                   if (!(pa->sentringing) && !ast_test_flag64(outgoing, OPT_MUSICBACK) && ast_strlen_zero(opt_args[OPT_ARG_RINGBACK])) {
01269                      ast_indicate(in, AST_CONTROL_RINGING);
01270                      pa->sentringing++;
01271                   }
01272                }
01273                break;
01274             case AST_CONTROL_PROGRESS:
01275                ast_verb(3, "%s is making progress passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
01276                /* Setup early media if appropriate */
01277                if (single && CAN_EARLY_BRIDGE(peerflags, in, c))
01278                   ast_channel_early_bridge(in, c);
01279                if (!ast_test_flag64(outgoing, OPT_RINGBACK)) {
01280                   if (single || (!single && !pa->sentringing)) {
01281                      ast_indicate(in, AST_CONTROL_PROGRESS);
01282                   }
01283                }
01284                if (!ast_strlen_zero(dtmf_progress)) {
01285                   ast_verb(3,
01286                      "Sending DTMF '%s' to the called party as result of receiving a PROGRESS message.\n",
01287                      dtmf_progress);
01288                   ast_dtmf_stream(c, in, dtmf_progress, 250, 0);
01289                }
01290                break;
01291             case AST_CONTROL_VIDUPDATE:
01292                ast_verb(3, "%s requested a video update, passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
01293                ast_indicate(in, AST_CONTROL_VIDUPDATE);
01294                break;
01295             case AST_CONTROL_SRCUPDATE:
01296                ast_verb(3, "%s requested a source update, passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
01297                ast_indicate(in, AST_CONTROL_SRCUPDATE);
01298                break;
01299             case AST_CONTROL_CONNECTED_LINE:
01300                if (ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE)) {
01301                   ast_verb(3, "Connected line update to %s prevented.\n", ast_channel_name(in));
01302                } else if (!single) {
01303                   struct ast_party_connected_line connected;
01304                   ast_verb(3, "%s connected line has changed. Saving it until answer for %s\n", ast_channel_name(c), ast_channel_name(in));
01305                   ast_party_connected_line_set_init(&connected, &o->connected);
01306                   ast_connected_line_parse_data(f->data.ptr, f->datalen, &connected);
01307                   ast_party_connected_line_set(&o->connected, &connected, NULL);
01308                   ast_party_connected_line_free(&connected);
01309                   o->pending_connected_update = 1;
01310                } else {
01311                   if (ast_channel_connected_line_macro(c, in, f, 1, 1)) {
01312                      ast_indicate_data(in, AST_CONTROL_CONNECTED_LINE, f->data.ptr, f->datalen);
01313                   }
01314                }
01315                break;
01316             case AST_CONTROL_AOC:
01317                {
01318                   struct ast_aoc_decoded *decoded = ast_aoc_decode(f->data.ptr, f->datalen, o->chan);
01319                   if (decoded && (ast_aoc_get_msg_type(decoded) == AST_AOC_S)) {
01320                      ast_aoc_destroy_decoded(o->aoc_s_rate_list);
01321                      o->aoc_s_rate_list = decoded;
01322                   } else {
01323                      ast_aoc_destroy_decoded(decoded);
01324                   }
01325                }
01326                break;
01327             case AST_CONTROL_REDIRECTING:
01328                if (ast_test_flag64(peerflags, OPT_IGNORE_CONNECTEDLINE)) {
01329                   ast_verb(3, "Redirecting update to %s prevented.\n", ast_channel_name(in));
01330                } else if (single) {
01331                   ast_verb(3, "%s redirecting info has changed, passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
01332                   if (ast_channel_redirecting_macro(c, in, f, 1, 1)) {
01333                      ast_indicate_data(in, AST_CONTROL_REDIRECTING, f->data.ptr, f->datalen);
01334                   }
01335                   pa->sentringing = 0;
01336                }
01337                break;
01338             case AST_CONTROL_PROCEEDING:
01339                ast_verb(3, "%s is proceeding passing it to %s\n", ast_channel_name(c), ast_channel_name(in));
01340                if (single && CAN_EARLY_BRIDGE(peerflags, in, c))
01341                   ast_channel_early_bridge(in, c);
01342                if (!ast_test_flag64(outgoing, OPT_RINGBACK))
01343                   ast_indicate(in, AST_CONTROL_PROCEEDING);
01344                break;
01345             case AST_CONTROL_HOLD:
01346                ast_verb(3, "Call on %s placed on hold\n", ast_channel_name(c));
01347                ast_indicate(in, AST_CONTROL_HOLD);
01348                break;
01349             case AST_CONTROL_UNHOLD:
01350                ast_verb(3, "Call on %s left from hold\n", ast_channel_name(c));
01351                ast_indicate(in, AST_CONTROL_UNHOLD);
01352                break;
01353             case AST_CONTROL_OFFHOOK:
01354             case AST_CONTROL_FLASH:
01355                /* Ignore going off hook and flash */
01356                break;
01357             case AST_CONTROL_CC:
01358                if (!ignore_cc) {
01359                   ast_handle_cc_control_frame(in, c, f->data.ptr);
01360                   cc_frame_received = 1;
01361                }
01362                break;
01363             case -1:
01364                if (!ast_test_flag64(outgoing, OPT_RINGBACK | OPT_MUSICBACK)) {
01365                   ast_verb(3, "%s stopped sounds\n", ast_channel_name(c));
01366                   ast_indicate(in, -1);
01367                   pa->sentringing = 0;
01368                }
01369                break;
01370             default:
01371                ast_debug(1, "Dunno what to do with control type %d\n", f->subclass.integer);
01372             }
01373          } else if (single) {
01374             switch (f->frametype) {
01375             case AST_FRAME_VOICE:
01376             case AST_FRAME_IMAGE:
01377             case AST_FRAME_TEXT:
01378                if (!ast_test_flag64(outgoing, OPT_RINGBACK | OPT_MUSICBACK) && ast_write(in, f)) {
01379                   ast_log(LOG_WARNING, "Unable to write frametype: %d\n",
01380                      f->frametype);
01381                }
01382                break;
01383             case AST_FRAME_HTML:
01384                if (!ast_test_flag64(outgoing, DIAL_NOFORWARDHTML)
01385                   && ast_channel_sendhtml(in, f->subclass.integer, f->data.ptr, f->datalen) == -1) {
01386                   ast_log(LOG_WARNING, "Unable to send URL\n");
01387                }
01388                break;
01389             default:
01390                break;
01391             }
01392          }
01393          ast_frfree(f);
01394       } /* end for */
01395       if (winner == in) {
01396          struct ast_frame *f = ast_read(in);
01397 #if 0
01398          if (f && (f->frametype != AST_FRAME_VOICE))
01399             printf("Frame type: %d, %d\n", f->frametype, f->subclass);
01400          else if (!f || (f->frametype != AST_FRAME_VOICE))
01401             printf("Hangup received on %s\n", in->name);
01402 #endif
01403          if (!f || ((f->frametype == AST_FRAME_CONTROL) && (f->subclass.integer == AST_CONTROL_HANGUP))) {
01404             /* Got hung up */
01405             *to = -1;
01406             strcpy(pa->status, "CANCEL");
01407             ast_cdr_noanswer(in->cdr);
01408             if (f) {
01409                if (f->data.uint32) {
01410                   in->hangupcause = f->data.uint32;
01411                }
01412                ast_frfree(f);
01413             }
01414             if (is_cc_recall) {
01415                ast_cc_completed(in, "CC completed, although the caller hung up (cancelled)");
01416             }
01417             return NULL;
01418          }
01419 
01420          /* now f is guaranteed non-NULL */
01421          if (f->frametype == AST_FRAME_DTMF) {
01422             if (ast_test_flag64(peerflags, OPT_DTMF_EXIT)) {
01423                const char *context;
01424                ast_channel_lock(in);
01425                context = pbx_builtin_getvar_helper(in, "EXITCONTEXT");
01426                if (onedigit_goto(in, context, (char) f->subclass.integer, 1)) {
01427                   ast_verb(3, "User hit %c to disconnect call.\n", f->subclass.integer);
01428                   *to = 0;
01429                   ast_cdr_noanswer(in->cdr);
01430                   *result = f->subclass.integer;
01431                   strcpy(pa->status, "CANCEL");
01432                   ast_frfree(f);
01433                   ast_channel_unlock(in);
01434                   if (is_cc_recall) {
01435                      ast_cc_completed(in, "CC completed, but the caller used DTMF to exit");
01436                   }
01437                   return NULL;
01438                }
01439                ast_channel_unlock(in);
01440             }
01441 
01442             if (ast_test_flag64(peerflags, OPT_CALLER_HANGUP) &&
01443                detect_disconnect(in, f->subclass.integer, featurecode)) {
01444                ast_verb(3, "User requested call disconnect.\n");
01445                *to = 0;
01446                strcpy(pa->status, "CANCEL");
01447                ast_cdr_noanswer(in->cdr);
01448                ast_frfree(f);
01449                if (is_cc_recall) {
01450                   ast_cc_completed(in, "CC completed, but the caller hung up with DTMF");
01451                }
01452                return NULL;
01453             }
01454          }
01455 
01456          /* Send the frame from the in channel to all outgoing channels. */
01457          for (o = outgoing; o; o = o->next) {
01458             if (!o->chan || !ast_test_flag64(o, DIAL_STILLGOING)) {
01459                /* This outgoing channel has died so don't send the frame to it. */
01460                continue;
01461             }
01462             switch (f->frametype) {
01463             case AST_FRAME_HTML:
01464                /* Forward HTML stuff */
01465                if (!ast_test_flag64(o, DIAL_NOFORWARDHTML)
01466                   && ast_channel_sendhtml(o->chan, f->subclass.integer, f->data.ptr, f->datalen) == -1) {
01467                   ast_log(LOG_WARNING, "Unable to send URL\n");
01468                }
01469                break;
01470             case AST_FRAME_VOICE:
01471             case AST_FRAME_IMAGE:
01472             case AST_FRAME_TEXT:
01473             case AST_FRAME_DTMF_BEGIN:
01474             case AST_FRAME_DTMF_END:
01475                if (ast_write(o->chan, f)) {
01476                   ast_log(LOG_WARNING, "Unable to forward frametype: %d\n",
01477                      f->frametype);
01478                }
01479                break;
01480             case AST_FRAME_CONTROL:
01481                switch (f->subclass.integer) {
01482                case AST_CONTROL_HOLD:
01483                case AST_CONTROL_UNHOLD:
01484                case AST_CONTROL_VIDUPDATE:
01485                case AST_CONTROL_SRCUPDATE:
01486                   ast_verb(3, "%s requested special control %d, passing it to %s\n",
01487                      ast_channel_name(in), f->subclass.integer, ast_channel_name(o->chan));
01488                   ast_indicate_data(o->chan, f->subclass.integer, f->data.ptr, f->datalen);
01489                   break;
01490                case AST_CONTROL_CONNECTED_LINE:
01491                   if (ast_channel_connected_line_macro(in, o->chan, f, 0, 1)) {
01492                      ast_indicate_data(o->chan, f->subclass.integer, f->data.ptr, f->datalen);
01493                   }
01494                   break;
01495                case AST_CONTROL_REDIRECTING:
01496                   if (ast_channel_redirecting_macro(in, o->chan, f, 0, 1)) {
01497                      ast_indicate_data(o->chan, f->subclass.integer, f->data.ptr, f->datalen);
01498                   }
01499                   break;
01500                default:
01501                   break;
01502                }
01503                break;
01504             default:
01505                break;
01506             }
01507          }
01508          ast_frfree(f);
01509       }
01510       if (!*to)
01511          ast_verb(3, "Nobody picked up in %d ms\n", orig);
01512       if (!*to || ast_check_hangup(in))
01513          ast_cdr_noanswer(in->cdr);
01514    }
01515 
01516 #ifdef HAVE_EPOLL
01517    for (epollo = outgoing; epollo; epollo = epollo->next) {
01518       if (epollo->chan)
01519          ast_poll_channel_del(in, epollo->chan);
01520    }
01521 #endif
01522 
01523    if (is_cc_recall) {
01524       ast_cc_completed(in, "Recall completed!");
01525    }
01526    return peer;
01527 }
01528 
01529 static int detect_disconnect(struct ast_channel *chan, char code, struct ast_str *featurecode)
01530 {
01531    struct ast_flags features = { AST_FEATURE_DISCONNECT }; /* only concerned with disconnect feature */
01532    struct ast_call_feature feature = { 0, };
01533    int res;
01534 
01535    ast_str_append(&featurecode, 1, "%c", code);
01536 
01537    res = ast_feature_detect(chan, &features, ast_str_buffer(featurecode), &feature);
01538 
01539    if (res != AST_FEATURE_RETURN_STOREDIGITS) {
01540       ast_str_reset(featurecode);
01541    }
01542    if (feature.feature_mask & AST_FEATURE_DISCONNECT) {
01543       return 1;
01544    }
01545 
01546    return 0;
01547 }
01548 
01549 static void replace_macro_delimiter(char *s)
01550 {
01551    for (; *s; s++)
01552       if (*s == '^')
01553          *s = ',';
01554 }
01555 
01556 /* returns true if there is a valid privacy reply */
01557 static int valid_priv_reply(struct ast_flags64 *opts, int res)
01558 {
01559    if (res < '1')
01560       return 0;
01561    if (ast_test_flag64(opts, OPT_PRIVACY) && res <= '5')
01562       return 1;
01563    if (ast_test_flag64(opts, OPT_SCREENING) && res <= '4')
01564       return 1;
01565    return 0;
01566 }
01567 
01568 static int do_privacy(struct ast_channel *chan, struct ast_channel *peer,
01569    struct ast_flags64 *opts, char **opt_args, struct privacy_args *pa)
01570 {
01571 
01572    int res2;
01573    int loopcount = 0;
01574 
01575    /* Get the user's intro, store it in priv-callerintros/$CID,
01576       unless it is already there-- this should be done before the
01577       call is actually dialed  */
01578 
01579    /* all ring indications and moh for the caller has been halted as soon as the
01580       target extension was picked up. We are going to have to kill some
01581       time and make the caller believe the peer hasn't picked up yet */
01582 
01583    if (ast_test_flag64(opts, OPT_MUSICBACK) && !ast_strlen_zero(opt_args[OPT_ARG_MUSICBACK])) {
01584       char *original_moh = ast_strdupa(ast_channel_musicclass(chan));
01585       ast_indicate(chan, -1);
01586       ast_channel_musicclass_set(chan, opt_args[OPT_ARG_MUSICBACK]);
01587       ast_moh_start(chan, opt_args[OPT_ARG_MUSICBACK], NULL);
01588       ast_channel_musicclass_set(chan, original_moh);
01589    } else if (ast_test_flag64(opts, OPT_RINGBACK)) {
01590       ast_indicate(chan, AST_CONTROL_RINGING);
01591       pa->sentringing++;
01592    }
01593 
01594    /* Start autoservice on the other chan ?? */
01595    res2 = ast_autoservice_start(chan);
01596    /* Now Stream the File */
01597    for (loopcount = 0; loopcount < 3; loopcount++) {
01598       if (res2 && loopcount == 0) /* error in ast_autoservice_start() */
01599          break;
01600       if (!res2) /* on timeout, play the message again */
01601          res2 = ast_play_and_wait(peer, "priv-callpending");
01602       if (!valid_priv_reply(opts, res2))
01603          res2 = 0;
01604       /* priv-callpending script:
01605          "I have a caller waiting, who introduces themselves as:"
01606       */
01607       if (!res2)
01608          res2 = ast_play_and_wait(peer, pa->privintro);
01609       if (!valid_priv_reply(opts, res2))
01610          res2 = 0;
01611       /* now get input from the called party, as to their choice */
01612       if (!res2) {
01613          /* XXX can we have both, or they are mutually exclusive ? */
01614          if (ast_test_flag64(opts, OPT_PRIVACY))
01615             res2 = ast_play_and_wait(peer, "priv-callee-options");
01616          if (ast_test_flag64(opts, OPT_SCREENING))
01617             res2 = ast_play_and_wait(peer, "screen-callee-options");
01618       }
01619       /*! \page DialPrivacy Dial Privacy scripts
01620       \par priv-callee-options script:
01621          "Dial 1 if you wish this caller to reach you directly in the future,
01622             and immediately connect to their incoming call
01623           Dial 2 if you wish to send this caller to voicemail now and
01624             forevermore.
01625           Dial 3 to send this caller to the torture menus, now and forevermore.
01626           Dial 4 to send this caller to a simple "go away" menu, now and forevermore.
01627           Dial 5 to allow this caller to come straight thru to you in the future,
01628             but right now, just this once, send them to voicemail."
01629       \par screen-callee-options script:
01630          "Dial 1 if you wish to immediately connect to the incoming call
01631           Dial 2 if you wish to send this caller to voicemail.
01632           Dial 3 to send this caller to the torture menus.
01633           Dial 4 to send this caller to a simple "go away" menu.
01634       */
01635       if (valid_priv_reply(opts, res2))
01636          break;
01637       /* invalid option */
01638       res2 = ast_play_and_wait(peer, "vm-sorry");
01639    }
01640 
01641    if (ast_test_flag64(opts, OPT_MUSICBACK)) {
01642       ast_moh_stop(chan);
01643    } else if (ast_test_flag64(opts, OPT_RINGBACK)) {
01644       ast_indicate(chan, -1);
01645       pa->sentringing = 0;
01646    }
01647    ast_autoservice_stop(chan);
01648    if (ast_test_flag64(opts, OPT_PRIVACY) && (res2 >= '1' && res2 <= '5')) {
01649       /* map keypresses to various things, the index is res2 - '1' */
01650       static const char * const _val[] = { "ALLOW", "DENY", "TORTURE", "KILL", "ALLOW" };
01651       static const int _flag[] = { AST_PRIVACY_ALLOW, AST_PRIVACY_DENY, AST_PRIVACY_TORTURE, AST_PRIVACY_KILL, AST_PRIVACY_ALLOW};
01652       int i = res2 - '1';
01653       ast_verb(3, "--Set privacy database entry %s/%s to %s\n",
01654          opt_args[OPT_ARG_PRIVACY], pa->privcid, _val[i]);
01655       ast_privacy_set(opt_args[OPT_ARG_PRIVACY], pa->privcid, _flag[i]);
01656    }
01657    switch (res2) {
01658    case '1':
01659       break;
01660    case '2':
01661       ast_copy_string(pa->status, "NOANSWER", sizeof(pa->status));
01662       break;
01663    case '3':
01664       ast_copy_string(pa->status, "TORTURE", sizeof(pa->status));
01665       break;
01666    case '4':
01667       ast_copy_string(pa->status, "DONTCALL", sizeof(pa->status));
01668       break;
01669    case '5':
01670       /* XXX should we set status to DENY ? */
01671       if (ast_test_flag64(opts, OPT_PRIVACY))
01672          break;
01673       /* if not privacy, then 5 is the same as "default" case */
01674    default: /* bad input or -1 if failure to start autoservice */
01675       /* well, if the user messes up, ... he had his chance... What Is The Best Thing To Do?  */
01676       /* well, there seems basically two choices. Just patch the caller thru immediately,
01677            or,... put 'em thru to voicemail. */
01678       /* since the callee may have hung up, let's do the voicemail thing, no database decision */
01679       ast_log(LOG_NOTICE, "privacy: no valid response from the callee. Sending the caller to voicemail, the callee isn't responding\n");
01680       /* XXX should we set status to DENY ? */
01681       /* XXX what about the privacy flags ? */
01682       break;
01683    }
01684 
01685    if (res2 == '1') { /* the only case where we actually connect */
01686       /* if the intro is NOCALLERID, then there's no reason to leave it on disk, it'll
01687          just clog things up, and it's not useful information, not being tied to a CID */
01688       if (strncmp(pa->privcid, "NOCALLERID", 10) == 0 || ast_test_flag64(opts, OPT_SCREEN_NOINTRO)) {
01689          ast_filedelete(pa->privintro, NULL);
01690          if (ast_fileexists(pa->privintro, NULL, NULL) > 0)
01691             ast_log(LOG_NOTICE, "privacy: ast_filedelete didn't do its job on %s\n", pa->privintro);
01692          else
01693             ast_verb(3, "Successfully deleted %s intro file\n", pa->privintro);
01694       }
01695       return 0; /* the good exit path */
01696    } else {
01697       ast_hangup(peer); /* hang up on the callee -- he didn't want to talk anyway! */
01698       return -1;
01699    }
01700 }
01701 
01702 /*! \brief returns 1 if successful, 0 or <0 if the caller should 'goto out' */
01703 static int setup_privacy_args(struct privacy_args *pa,
01704    struct ast_flags64 *opts, char *opt_args[], struct ast_channel *chan)
01705 {
01706    char callerid[60];
01707    int res;
01708    char *l;
01709 
01710    if (chan->caller.id.number.valid
01711       && !ast_strlen_zero(chan->caller.id.number.str)) {
01712       l = ast_strdupa(chan->caller.id.number.str);
01713       ast_shrink_phone_number(l);
01714       if (ast_test_flag64(opts, OPT_PRIVACY) ) {
01715          ast_verb(3, "Privacy DB is '%s', clid is '%s'\n", opt_args[OPT_ARG_PRIVACY], l);
01716          pa->privdb_val = ast_privacy_check(opt_args[OPT_ARG_PRIVACY], l);
01717       } else {
01718          ast_verb(3, "Privacy Screening, clid is '%s'\n", l);
01719          pa->privdb_val = AST_PRIVACY_UNKNOWN;
01720       }
01721    } else {
01722       char *tnam, *tn2;
01723 
01724       tnam = ast_strdupa(ast_channel_name(chan));
01725       /* clean the channel name so slashes don't try to end up in disk file name */
01726       for (tn2 = tnam; *tn2; tn2++) {
01727          if (*tn2 == '/')  /* any other chars to be afraid of? */
01728             *tn2 = '=';
01729       }
01730       ast_verb(3, "Privacy-- callerid is empty\n");
01731 
01732       snprintf(callerid, sizeof(callerid), "NOCALLERID_%s%s", chan->exten, tnam);
01733       l = callerid;
01734       pa->privdb_val = AST_PRIVACY_UNKNOWN;
01735    }
01736 
01737    ast_copy_string(pa->privcid, l, sizeof(pa->privcid));
01738 
01739    if (strncmp(pa->privcid, "NOCALLERID", 10) != 0 && ast_test_flag64(opts, OPT_SCREEN_NOCALLERID)) {
01740       /* if callerid is set and OPT_SCREEN_NOCALLERID is set also */
01741       ast_verb(3, "CallerID set (%s); N option set; Screening should be off\n", pa->privcid);
01742       pa->privdb_val = AST_PRIVACY_ALLOW;
01743    } else if (ast_test_flag64(opts, OPT_SCREEN_NOCALLERID) && strncmp(pa->privcid, "NOCALLERID", 10) == 0) {
01744       ast_verb(3, "CallerID blank; N option set; Screening should happen; dbval is %d\n", pa->privdb_val);
01745    }
01746    
01747    if (pa->privdb_val == AST_PRIVACY_DENY) {
01748       ast_verb(3, "Privacy DB reports PRIVACY_DENY for this callerid. Dial reports unavailable\n");
01749       ast_copy_string(pa->status, "NOANSWER", sizeof(pa->status));
01750       return 0;
01751    } else if (pa->privdb_val == AST_PRIVACY_KILL) {
01752       ast_copy_string(pa->status, "DONTCALL", sizeof(pa->status));
01753       return 0; /* Is this right? */
01754    } else if (pa->privdb_val == AST_PRIVACY_TORTURE) {
01755       ast_copy_string(pa->status, "TORTURE", sizeof(pa->status));
01756       return 0; /* is this right??? */
01757    } else if (pa->privdb_val == AST_PRIVACY_UNKNOWN) {
01758       /* Get the user's intro, store it in priv-callerintros/$CID,
01759          unless it is already there-- this should be done before the
01760          call is actually dialed  */
01761 
01762       /* make sure the priv-callerintros dir actually exists */
01763       snprintf(pa->privintro, sizeof(pa->privintro), "%s/sounds/priv-callerintros", ast_config_AST_DATA_DIR);
01764       if ((res = ast_mkdir(pa->privintro, 0755))) {
01765          ast_log(LOG_WARNING, "privacy: can't create directory priv-callerintros: %s\n", strerror(res));
01766          return -1;
01767       }
01768 
01769       snprintf(pa->privintro, sizeof(pa->privintro), "priv-callerintros/%s", pa->privcid);
01770       if (ast_fileexists(pa->privintro, NULL, NULL ) > 0 && strncmp(pa->privcid, "NOCALLERID", 10) != 0) {
01771          /* the DELUX version of this code would allow this caller the
01772             option to hear and retape their previously recorded intro.
01773          */
01774       } else {
01775          int duration; /* for feedback from play_and_wait */
01776          /* the file doesn't exist yet. Let the caller submit his
01777             vocal intro for posterity */
01778          /* priv-recordintro script:
01779 
01780             "At the tone, please say your name:"
01781 
01782          */
01783          int silencethreshold = ast_dsp_get_threshold_from_settings(THRESHOLD_SILENCE);
01784          ast_answer(chan);
01785          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 */
01786                            /* don't think we'll need a lock removed, we took care of
01787                               conflicts by naming the pa.privintro file */
01788          if (res == -1) {
01789             /* Delete the file regardless since they hung up during recording */
01790             ast_filedelete(pa->privintro, NULL);
01791             if (ast_fileexists(pa->privintro, NULL, NULL) > 0)
01792                ast_log(LOG_NOTICE, "privacy: ast_filedelete didn't do its job on %s\n", pa->privintro);
01793             else
01794                ast_verb(3, "Successfully deleted %s intro file\n", pa->privintro);
01795             return -1;
01796          }
01797          if (!ast_streamfile(chan, "vm-dialout", ast_channel_language(chan)) )
01798             ast_waitstream(chan, "");
01799       }
01800    }
01801    return 1; /* success */
01802 }
01803 
01804 static void end_bridge_callback(void *data)
01805 {
01806    char buf[80];
01807    time_t end;
01808    struct ast_channel *chan = data;
01809 
01810    if (!chan->cdr) {
01811       return;
01812    }
01813 
01814    time(&end);
01815 
01816    ast_channel_lock(chan);
01817    if (chan->cdr->answer.tv_sec) {
01818       snprintf(buf, sizeof(buf), "%ld", (long) end - chan->cdr->answer.tv_sec);
01819       pbx_builtin_setvar_helper(chan, "ANSWEREDTIME", buf);
01820    }
01821 
01822    if (chan->cdr->start.tv_sec) {
01823       snprintf(buf, sizeof(buf), "%ld", (long) end - chan->cdr->start.tv_sec);
01824       pbx_builtin_setvar_helper(chan, "DIALEDTIME", buf);
01825    }
01826    ast_channel_unlock(chan);
01827 }
01828 
01829 static void end_bridge_callback_data_fixup(struct ast_bridge_config *bconfig, struct ast_channel *originator, struct ast_channel *terminator) {
01830    bconfig->end_bridge_callback_data = originator;
01831 }
01832 
01833 static int dial_handle_playtones(struct ast_channel *chan, const char *data)
01834 {
01835    struct ast_tone_zone_sound *ts = NULL;
01836    int res;
01837    const char *str = data;
01838 
01839    if (ast_strlen_zero(str)) {
01840       ast_debug(1,"Nothing to play\n");
01841       return -1;
01842    }
01843 
01844    ts = ast_get_indication_tone(chan->zone, str);
01845 
01846    if (ts && ts->data[0]) {
01847       res = ast_playtones_start(chan, 0, ts->data, 0);
01848    } else {
01849       res = -1;
01850    }
01851 
01852    if (ts) {
01853       ts = ast_tone_zone_sound_unref(ts);
01854    }
01855 
01856    if (res) {
01857       ast_log(LOG_WARNING, "Unable to start playtone \'%s\'\n", str);
01858    }
01859 
01860    return res;
01861 }
01862 
01863 static int dial_exec_full(struct ast_channel *chan, const char *data, struct ast_flags64 *peerflags, int *continue_exec)
01864 {
01865    int res = -1; /* default: error */
01866    char *rest, *cur; /* scan the list of destinations */
01867    struct chanlist *outgoing = NULL; /* list of destinations */
01868    struct ast_channel *peer;
01869    int to; /* timeout */
01870    struct cause_args num = { chan, 0, 0, 0 };
01871    int cause;
01872    char numsubst[256];
01873 
01874    struct ast_bridge_config config = { { 0, } };
01875    struct timeval calldurationlimit = { 0, };
01876    char *dtmfcalled = NULL, *dtmfcalling = NULL, *dtmf_progress=NULL;
01877    struct privacy_args pa = {
01878       .sentringing = 0,
01879       .privdb_val = 0,
01880       .status = "INVALIDARGS",
01881    };
01882    int sentringing = 0, moh = 0;
01883    const char *outbound_group = NULL;
01884    int result = 0;
01885    char *parse;
01886    int opermode = 0;
01887    int delprivintro = 0;
01888    AST_DECLARE_APP_ARGS(args,
01889       AST_APP_ARG(peers);
01890       AST_APP_ARG(timeout);
01891       AST_APP_ARG(options);
01892       AST_APP_ARG(url);
01893    );
01894    struct ast_flags64 opts = { 0, };
01895    char *opt_args[OPT_ARG_ARRAY_SIZE];
01896    struct ast_datastore *datastore = NULL;
01897    int fulldial = 0, num_dialed = 0;
01898    int ignore_cc = 0;
01899    char device_name[AST_CHANNEL_NAME];
01900    char forced_clid_name[AST_MAX_EXTENSION];
01901    char stored_clid_name[AST_MAX_EXTENSION];
01902    int force_forwards_only;   /*!< TRUE if force CallerID on call forward only. Legacy behaviour.*/
01903    /*!
01904     * \brief Forced CallerID party information to send.
01905     * \note This will not have any malloced strings so do not free it.
01906     */
01907    struct ast_party_id forced_clid;
01908    /*!
01909     * \brief Stored CallerID information if needed.
01910     *
01911     * \note If OPT_ORIGINAL_CLID set then this is the o option
01912     * CallerID.  Otherwise it is the dialplan extension and hint
01913     * name.
01914     *
01915     * \note This will not have any malloced strings so do not free it.
01916     */
01917    struct ast_party_id stored_clid;
01918    /*!
01919     * \brief CallerID party information to store.
01920     * \note This will not have any malloced strings so do not free it.
01921     */
01922    struct ast_party_caller caller;
01923 
01924    /* Reset all DIAL variables back to blank, to prevent confusion (in case we don't reset all of them). */
01925    pbx_builtin_setvar_helper(chan, "DIALSTATUS", "");
01926    pbx_builtin_setvar_helper(chan, "DIALEDPEERNUMBER", "");
01927    pbx_builtin_setvar_helper(chan, "DIALEDPEERNAME", "");
01928    pbx_builtin_setvar_helper(chan, "ANSWEREDTIME", "");
01929    pbx_builtin_setvar_helper(chan, "DIALEDTIME", "");
01930 
01931    if (ast_strlen_zero(data)) {
01932       ast_log(LOG_WARNING, "Dial requires an argument (technology/number)\n");
01933       pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
01934       return -1;
01935    }
01936 
01937    parse = ast_strdupa(data);
01938 
01939    AST_STANDARD_APP_ARGS(args, parse);
01940 
01941    if (!ast_strlen_zero(args.options) &&
01942       ast_app_parse_options64(dial_exec_options, &opts, opt_args, args.options)) {
01943       pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
01944       goto done;
01945    }
01946 
01947    if (ast_strlen_zero(args.peers)) {
01948       ast_log(LOG_WARNING, "Dial requires an argument (technology/number)\n");
01949       pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
01950       goto done;
01951    }
01952 
01953    if (ast_cc_call_init(chan, &ignore_cc)) {
01954       goto done;
01955    }
01956 
01957    if (ast_test_flag64(&opts, OPT_SCREEN_NOINTRO) && !ast_strlen_zero(opt_args[OPT_ARG_SCREEN_NOINTRO])) {
01958       delprivintro = atoi(opt_args[OPT_ARG_SCREEN_NOINTRO]);
01959 
01960       if (delprivintro < 0 || delprivintro > 1) {
01961          ast_log(LOG_WARNING, "Unknown argument %d specified to n option, ignoring\n", delprivintro);
01962          delprivintro = 0;
01963       }
01964    }
01965 
01966    if (!ast_test_flag64(&opts, OPT_RINGBACK)) {
01967       opt_args[OPT_ARG_RINGBACK] = NULL;
01968    }
01969 
01970    if (ast_test_flag64(&opts, OPT_OPERMODE)) {
01971       opermode = ast_strlen_zero(opt_args[OPT_ARG_OPERMODE]) ? 1 : atoi(opt_args[OPT_ARG_OPERMODE]);
01972       ast_verb(3, "Setting operator services mode to %d.\n", opermode);
01973    }
01974 
01975    if (ast_test_flag64(&opts, OPT_DURATION_STOP) && !ast_strlen_zero(opt_args[OPT_ARG_DURATION_STOP])) {
01976       calldurationlimit.tv_sec = atoi(opt_args[OPT_ARG_DURATION_STOP]);
01977       if (!calldurationlimit.tv_sec) {
01978          ast_log(LOG_WARNING, "Dial does not accept S(%s), hanging up.\n", opt_args[OPT_ARG_DURATION_STOP]);
01979          pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
01980          goto done;
01981       }
01982       ast_verb(3, "Setting call duration limit to %.3lf seconds.\n", calldurationlimit.tv_sec + calldurationlimit.tv_usec / 1000000.0);
01983    }
01984 
01985    if (ast_test_flag64(&opts, OPT_SENDDTMF) && !ast_strlen_zero(opt_args[OPT_ARG_SENDDTMF])) {
01986       dtmf_progress = opt_args[OPT_ARG_SENDDTMF];
01987       dtmfcalled = strsep(&dtmf_progress, ":");
01988       dtmfcalling = strsep(&dtmf_progress, ":");
01989    }
01990 
01991    if (ast_test_flag64(&opts, OPT_DURATION_LIMIT) && !ast_strlen_zero(opt_args[OPT_ARG_DURATION_LIMIT])) {
01992       if (ast_bridge_timelimit(chan, &config, opt_args[OPT_ARG_DURATION_LIMIT], &calldurationlimit))
01993          goto done;
01994    }
01995 
01996    /* Setup the forced CallerID information to send if used. */
01997    ast_party_id_init(&forced_clid);
01998    force_forwards_only = 0;
01999    if (ast_test_flag64(&opts, OPT_FORCECLID)) {
02000       if (ast_strlen_zero(opt_args[OPT_ARG_FORCECLID])) {
02001          ast_channel_lock(chan);
02002          forced_clid.number.str = ast_strdupa(S_OR(chan->macroexten, chan->exten));
02003          ast_channel_unlock(chan);
02004          forced_clid_name[0] = '\0';
02005          forced_clid.name.str = (char *) get_cid_name(forced_clid_name,
02006             sizeof(forced_clid_name), chan);
02007          force_forwards_only = 1;
02008       } else {
02009          /* Note: The opt_args[OPT_ARG_FORCECLID] string value is altered here. */
02010          ast_callerid_parse(opt_args[OPT_ARG_FORCECLID], &forced_clid.name.str,
02011             &forced_clid.number.str);
02012       }
02013       if (!ast_strlen_zero(forced_clid.name.str)) {
02014          forced_clid.name.valid = 1;
02015       }
02016       if (!ast_strlen_zero(forced_clid.number.str)) {
02017          forced_clid.number.valid = 1;
02018       }
02019    }
02020    if (ast_test_flag64(&opts, OPT_FORCE_CID_TAG)
02021       && !ast_strlen_zero(opt_args[OPT_ARG_FORCE_CID_TAG])) {
02022       forced_clid.tag = opt_args[OPT_ARG_FORCE_CID_TAG];
02023    }
02024    forced_clid.number.presentation = AST_PRES_ALLOWED_USER_NUMBER_PASSED_SCREEN;
02025    if (ast_test_flag64(&opts, OPT_FORCE_CID_PRES)
02026       && !ast_strlen_zero(opt_args[OPT_ARG_FORCE_CID_PRES])) {
02027       int pres;
02028 
02029       pres = ast_parse_caller_presentation(opt_args[OPT_ARG_FORCE_CID_PRES]);
02030       if (0 <= pres) {
02031          forced_clid.number.presentation = pres;
02032       }
02033    }
02034 
02035    /* Setup the stored CallerID information if needed. */
02036    ast_party_id_init(&stored_clid);
02037    if (ast_test_flag64(&opts, OPT_ORIGINAL_CLID)) {
02038       if (ast_strlen_zero(opt_args[OPT_ARG_ORIGINAL_CLID])) {
02039          ast_channel_lock(chan);
02040          ast_party_id_set_init(&stored_clid, &chan->caller.id);
02041          if (!ast_strlen_zero(chan->caller.id.name.str)) {
02042             stored_clid.name.str = ast_strdupa(chan->caller.id.name.str);
02043          }
02044          if (!ast_strlen_zero(chan->caller.id.number.str)) {
02045             stored_clid.number.str = ast_strdupa(chan->caller.id.number.str);
02046          }
02047          if (!ast_strlen_zero(chan->caller.id.subaddress.str)) {
02048             stored_clid.subaddress.str = ast_strdupa(chan->caller.id.subaddress.str);
02049          }
02050          if (!ast_strlen_zero(chan->caller.id.tag)) {
02051             stored_clid.tag = ast_strdupa(chan->caller.id.tag);
02052          }
02053          ast_channel_unlock(chan);
02054       } else {
02055          /* Note: The opt_args[OPT_ARG_ORIGINAL_CLID] string value is altered here. */
02056          ast_callerid_parse(opt_args[OPT_ARG_ORIGINAL_CLID], &stored_clid.name.str,
02057             &stored_clid.number.str);
02058          if (!ast_strlen_zero(stored_clid.name.str)) {
02059             stored_clid.name.valid = 1;
02060          }
02061          if (!ast_strlen_zero(stored_clid.number.str)) {
02062             stored_clid.number.valid = 1;
02063          }
02064       }
02065    } else {
02066       /*
02067        * In case the new channel has no preset CallerID number by the
02068        * channel driver, setup the dialplan extension and hint name.
02069        */
02070       stored_clid_name[0] = '\0';
02071       stored_clid.name.str = (char *) get_cid_name(stored_clid_name,
02072          sizeof(stored_clid_name), chan);
02073       if (ast_strlen_zero(stored_clid.name.str)) {
02074          stored_clid.name.str = NULL;
02075       } else {
02076          stored_clid.name.valid = 1;
02077       }
02078       ast_channel_lock(chan);
02079       stored_clid.number.str = ast_strdupa(S_OR(chan->macroexten, chan->exten));
02080       stored_clid.number.valid = 1;
02081       ast_channel_unlock(chan);
02082    }
02083 
02084    if (ast_test_flag64(&opts, OPT_RESETCDR) && chan->cdr)
02085       ast_cdr_reset(chan->cdr, NULL);
02086    if (ast_test_flag64(&opts, OPT_PRIVACY) && ast_strlen_zero(opt_args[OPT_ARG_PRIVACY]))
02087       opt_args[OPT_ARG_PRIVACY] = ast_strdupa(chan->exten);
02088 
02089    if (ast_test_flag64(&opts, OPT_PRIVACY) || ast_test_flag64(&opts, OPT_SCREENING)) {
02090       res = setup_privacy_args(&pa, &opts, opt_args, chan);
02091       if (res <= 0)
02092          goto out;
02093       res = -1; /* reset default */
02094    }
02095 
02096    if (continue_exec)
02097       *continue_exec = 0;
02098 
02099    /* If a channel group has been specified, get it for use when we create peer channels */
02100 
02101    ast_channel_lock(chan);
02102    if ((outbound_group = pbx_builtin_getvar_helper(chan, "OUTBOUND_GROUP_ONCE"))) {
02103       outbound_group = ast_strdupa(outbound_group);   
02104       pbx_builtin_setvar_helper(chan, "OUTBOUND_GROUP_ONCE", NULL);
02105    } else if ((outbound_group = pbx_builtin_getvar_helper(chan, "OUTBOUND_GROUP"))) {
02106       outbound_group = ast_strdupa(outbound_group);
02107    }
02108    ast_channel_unlock(chan);  
02109    ast_copy_flags64(peerflags, &opts, OPT_DTMF_EXIT | OPT_GO_ON | OPT_ORIGINAL_CLID | OPT_CALLER_HANGUP | OPT_IGNORE_FORWARDING | OPT_IGNORE_CONNECTEDLINE |
02110           OPT_CANCEL_TIMEOUT | OPT_ANNOUNCE | OPT_CALLEE_MACRO | OPT_CALLEE_GOSUB | OPT_FORCECLID);
02111 
02112    /* loop through the list of dial destinations */
02113    rest = args.peers;
02114    while ((cur = strsep(&rest, "&")) ) {
02115       struct chanlist *tmp;
02116       struct ast_channel *tc; /* channel for this destination */
02117       /* Get a technology/[device:]number pair */
02118       char *number = cur;
02119       char *interface = ast_strdupa(number);
02120       char *tech = strsep(&number, "/");
02121       /* find if we already dialed this interface */
02122       struct ast_dialed_interface *di;
02123       AST_LIST_HEAD(, ast_dialed_interface) *dialed_interfaces;
02124       num_dialed++;
02125       if (ast_strlen_zero(number)) {
02126          ast_log(LOG_WARNING, "Dial argument takes format (technology/[device:]number1)\n");
02127          goto out;
02128       }
02129       if (!(tmp = ast_calloc(1, sizeof(*tmp))))
02130          goto out;
02131       if (opts.flags) {
02132          ast_copy_flags64(tmp, &opts,
02133             OPT_CANCEL_ELSEWHERE |
02134             OPT_CALLEE_TRANSFER | OPT_CALLER_TRANSFER |
02135             OPT_CALLEE_HANGUP | OPT_CALLER_HANGUP |
02136             OPT_CALLEE_MONITOR | OPT_CALLER_MONITOR |
02137             OPT_CALLEE_PARK | OPT_CALLER_PARK |
02138             OPT_CALLEE_MIXMONITOR | OPT_CALLER_MIXMONITOR |
02139             OPT_RINGBACK | OPT_MUSICBACK | OPT_FORCECLID);
02140          ast_set2_flag64(tmp, args.url, DIAL_NOFORWARDHTML);
02141       }
02142       ast_copy_string(numsubst, number, sizeof(numsubst));
02143       /* Request the peer */
02144 
02145       ast_channel_lock(chan);
02146       datastore = ast_channel_datastore_find(chan, &dialed_interface_info, NULL);
02147       /*
02148        * Seed the chanlist's connected line information with previously
02149        * acquired connected line info from the incoming channel.  The
02150        * previously acquired connected line info could have been set
02151        * through the CONNECTED_LINE dialplan function.
02152        */
02153       ast_party_connected_line_copy(&tmp->connected, &chan->connected);
02154       ast_channel_unlock(chan);
02155 
02156       if (datastore)
02157          dialed_interfaces = datastore->data;
02158       else {
02159          if (!(datastore = ast_datastore_alloc(&dialed_interface_info, NULL))) {
02160             ast_log(LOG_WARNING, "Unable to create channel datastore for dialed interfaces. Aborting!\n");
02161             chanlist_free(tmp);
02162             goto out;
02163          }
02164 
02165          datastore->inheritance = DATASTORE_INHERIT_FOREVER;
02166 
02167          if (!(dialed_interfaces = ast_calloc(1, sizeof(*dialed_interfaces)))) {
02168             ast_datastore_free(datastore);
02169             chanlist_free(tmp);
02170             goto out;
02171          }
02172 
02173          datastore->data = dialed_interfaces;
02174          AST_LIST_HEAD_INIT(dialed_interfaces);
02175 
02176          ast_channel_lock(chan);
02177          ast_channel_datastore_add(chan, datastore);
02178          ast_channel_unlock(chan);
02179       }
02180 
02181       AST_LIST_LOCK(dialed_interfaces);
02182       AST_LIST_TRAVERSE(dialed_interfaces, di, list) {
02183          if (!strcasecmp(di->interface, interface)) {
02184             ast_log(LOG_WARNING, "Skipping dialing interface '%s' again since it has already been dialed\n",
02185                di->interface);
02186             break;
02187          }
02188       }
02189       AST_LIST_UNLOCK(dialed_interfaces);
02190 
02191       if (di) {
02192          fulldial++;
02193          chanlist_free(tmp);
02194          continue;
02195       }
02196 
02197       /* It is always ok to dial a Local interface.  We only keep track of
02198        * which "real" interfaces have been dialed.  The Local channel will
02199        * inherit this list so that if it ends up dialing a real interface,
02200        * it won't call one that has already been called. */
02201       if (strcasecmp(tech, "Local")) {
02202          if (!(di = ast_calloc(1, sizeof(*di) + strlen(interface)))) {
02203             AST_LIST_UNLOCK(dialed_interfaces);
02204             chanlist_free(tmp);
02205             goto out;
02206          }
02207          strcpy(di->interface, interface);
02208 
02209          AST_LIST_LOCK(dialed_interfaces);
02210          AST_LIST_INSERT_TAIL(dialed_interfaces, di, list);
02211          AST_LIST_UNLOCK(dialed_interfaces);
02212       }
02213 
02214       tc = ast_request(tech, chan->nativeformats, chan, numsubst, &cause);
02215       if (!tc) {
02216          /* If we can't, just go on to the next call */
02217          ast_log(LOG_WARNING, "Unable to create channel of type '%s' (cause %d - %s)\n",
02218             tech, cause, ast_cause2str(cause));
02219          handle_cause(cause, &num);
02220          if (!rest) /* we are on the last destination */
02221             chan->hangupcause = cause;
02222          chanlist_free(tmp);
02223          if (!ignore_cc && (cause == AST_CAUSE_BUSY || cause == AST_CAUSE_CONGESTION)) {
02224             if (!ast_cc_callback(chan, tech, numsubst, ast_cc_busy_interface)) {
02225                ast_cc_extension_monitor_add_dialstring(chan, interface, "");
02226             }
02227          }
02228          continue;
02229       }
02230       ast_channel_get_device_name(tc, device_name, sizeof(device_name));
02231       if (!ignore_cc) {
02232          ast_cc_extension_monitor_add_dialstring(chan, interface, device_name);
02233       }
02234       pbx_builtin_setvar_helper(tc, "DIALEDPEERNUMBER", numsubst);
02235 
02236       ast_channel_lock(tc);
02237       while (ast_channel_trylock(chan)) {
02238          CHANNEL_DEADLOCK_AVOIDANCE(tc);
02239       }
02240       /* Setup outgoing SDP to match incoming one */
02241       if (!outgoing && !rest && CAN_EARLY_BRIDGE(peerflags, chan, tc)) {
02242          ast_rtp_instance_early_bridge_make_compatible(tc, chan);
02243       }
02244       
02245       /* Inherit specially named variables from parent channel */
02246       ast_channel_inherit_variables(chan, tc);
02247       ast_channel_datastore_inherit(chan, tc);
02248 
02249       tc->appl = "AppDial";
02250       tc->data = "(Outgoing Line)";
02251       memset(&tc->whentohangup, 0, sizeof(tc->whentohangup));
02252 
02253       /* Determine CallerID to store in outgoing channel. */
02254       ast_party_caller_set_init(&caller, &tc->caller);
02255       if (ast_test_flag64(peerflags, OPT_ORIGINAL_CLID)) {
02256          caller.id = stored_clid;
02257          ast_channel_set_caller_event(tc, &caller, NULL);
02258          ast_set_flag64(tmp, DIAL_CALLERID_ABSENT);
02259       } else if (ast_strlen_zero(S_COR(tc->caller.id.number.valid,
02260          tc->caller.id.number.str, NULL))) {
02261          /*
02262           * The new channel has no preset CallerID number by the channel
02263           * driver.  Use the dialplan extension and hint name.
02264           */
02265          caller.id = stored_clid;
02266          if (!caller.id.name.valid
02267             && !ast_strlen_zero(S_COR(chan->connected.id.name.valid,
02268                chan->connected.id.name.str, NULL))) {
02269             /*
02270              * No hint name available.  We have a connected name supplied by
02271              * the dialplan we can use instead.
02272              */
02273             caller.id.name.valid = 1;
02274             caller.id.name = chan->connected.id.name;
02275          }
02276          ast_channel_set_caller_event(tc, &caller, NULL);
02277          ast_set_flag64(tmp, DIAL_CALLERID_ABSENT);
02278       } else if (ast_strlen_zero(S_COR(tc->caller.id.name.valid, tc->caller.id.name.str,
02279          NULL))) {
02280          /* The new channel has no preset CallerID name by the channel driver. */
02281          if (!ast_strlen_zero(S_COR(chan->connected.id.name.valid,
02282             chan->connected.id.name.str, NULL))) {
02283             /*
02284              * We have a connected name supplied by the dialplan we can
02285              * use instead.
02286              */
02287             caller.id.name.valid = 1;
02288             caller.id.name = chan->connected.id.name;
02289             ast_channel_set_caller_event(tc, &caller, NULL);
02290          }
02291       }
02292 
02293       /* Determine CallerID for outgoing channel to send. */
02294       if (ast_test_flag64(peerflags, OPT_FORCECLID) && !force_forwards_only) {
02295          struct ast_party_connected_line connected;
02296 
02297          ast_party_connected_line_set_init(&connected, &tc->connected);
02298          connected.id = forced_clid;
02299          ast_channel_set_connected_line(tc, &connected, NULL);
02300       } else {
02301          ast_connected_line_copy_from_caller(&tc->connected, &chan->caller);
02302       }
02303 
02304       ast_party_redirecting_copy(&tc->redirecting, &chan->redirecting);
02305 
02306       tc->dialed.transit_network_select = chan->dialed.transit_network_select;
02307 
02308       if (!ast_strlen_zero(ast_channel_accountcode(chan))) {
02309          ast_channel_peeraccount_set(tc, ast_channel_accountcode(chan));
02310       }
02311       if (ast_strlen_zero(ast_channel_musicclass(tc)))
02312          ast_channel_musicclass_set(tc, ast_channel_musicclass(chan));
02313 
02314       /* Pass ADSI CPE and transfer capability */
02315       tc->adsicpe = chan->adsicpe;
02316       tc->transfercapability = chan->transfercapability;
02317 
02318       /* If we have an outbound group, set this peer channel to it */
02319       if (outbound_group)
02320          ast_app_group_set_channel(tc, outbound_group);
02321       /* If the calling channel has the ANSWERED_ELSEWHERE flag set, inherit it. This is to support local channels */
02322       if (ast_test_flag(chan, AST_FLAG_ANSWERED_ELSEWHERE))
02323          ast_set_flag(tc, AST_FLAG_ANSWERED_ELSEWHERE);
02324 
02325       /* Check if we're forced by configuration */
02326       if (ast_test_flag64(&opts, OPT_CANCEL_ELSEWHERE))
02327           ast_set_flag(tc, AST_FLAG_ANSWERED_ELSEWHERE);
02328 
02329 
02330       /* Inherit context and extension */
02331       ast_channel_dialcontext_set(tc, ast_strlen_zero(chan->macrocontext) ? chan->context : chan->macrocontext);
02332       if (!ast_strlen_zero(chan->macroexten))
02333          ast_copy_string(tc->exten, chan->macroexten, sizeof(tc->exten));
02334       else
02335          ast_copy_string(tc->exten, chan->exten, sizeof(tc->exten));
02336 
02337       ast_channel_unlock(tc);
02338       ast_channel_unlock(chan);
02339       res = ast_call(tc, numsubst, 0); /* Place the call, but don't wait on the answer */
02340       ast_channel_lock(chan);
02341 
02342       /* Save the info in cdr's that we called them */
02343       if (chan->cdr)
02344          ast_cdr_setdestchan(chan->cdr, ast_channel_name(tc));
02345 
02346       /* check the results of ast_call */
02347       if (res) {
02348          /* Again, keep going even if there's an error */
02349          ast_debug(1, "ast call on peer returned %d\n", res);
02350          ast_verb(3, "Couldn't call %s/%s\n", tech, numsubst);
02351          if (tc->hangupcause) {
02352             chan->hangupcause = tc->hangupcause;
02353          }
02354          ast_channel_unlock(chan);
02355          ast_cc_call_failed(chan, tc, interface);
02356          ast_hangup(tc);
02357          tc = NULL;
02358          chanlist_free(tmp);
02359          continue;
02360       } else {
02361          senddialevent(chan, tc, numsubst);
02362          ast_verb(3, "Called %s/%s\n", tech, numsubst);
02363          ast_channel_unlock(chan);
02364       }
02365       /* Put them in the list of outgoing thingies...  We're ready now.
02366          XXX If we're forcibly removed, these outgoing calls won't get
02367          hung up XXX */
02368       ast_set_flag64(tmp, DIAL_STILLGOING);
02369       tmp->chan = tc;
02370       tmp->next = outgoing;
02371       outgoing = tmp;
02372       /* If this line is up, don't try anybody else */
02373       if (outgoing->chan->_state == AST_STATE_UP)
02374          break;
02375    }
02376    
02377    if (ast_strlen_zero(args.timeout)) {
02378       to = -1;
02379    } else {
02380       to = atoi(args.timeout);
02381       if (to > 0)
02382          to *= 1000;
02383       else {
02384          ast_log(LOG_WARNING, "Invalid timeout specified: '%s'. Setting timeout to infinite\n", args.timeout);
02385          to = -1;
02386       }
02387    }
02388 
02389    if (!outgoing) {
02390       strcpy(pa.status, "CHANUNAVAIL");
02391       if (fulldial == num_dialed) {
02392          res = -1;
02393          goto out;
02394       }
02395    } else {
02396       /* Our status will at least be NOANSWER */
02397       strcpy(pa.status, "NOANSWER");
02398       if (ast_test_flag64(outgoing, OPT_MUSICBACK)) {
02399          moh = 1;
02400          if (!ast_strlen_zero(opt_args[OPT_ARG_MUSICBACK])) {
02401             char *original_moh = ast_strdupa(ast_channel_musicclass(chan));
02402             ast_channel_musicclass_set(chan, opt_args[OPT_ARG_MUSICBACK]);
02403             ast_moh_start(chan, opt_args[OPT_ARG_MUSICBACK], NULL);
02404             ast_channel_musicclass_set(chan, original_moh);
02405          } else {
02406             ast_moh_start(chan, NULL, NULL);
02407          }
02408          ast_indicate(chan, AST_CONTROL_PROGRESS);
02409       } else if (ast_test_flag64(outgoing, OPT_RINGBACK)) {
02410          if (!ast_strlen_zero(opt_args[OPT_ARG_RINGBACK])) {
02411             if (dial_handle_playtones(chan, opt_args[OPT_ARG_RINGBACK])){
02412                ast_indicate(chan, AST_CONTROL_RINGING);
02413                sentringing++;
02414             } else {
02415                ast_indicate(chan, AST_CONTROL_PROGRESS);
02416             }
02417          } else {
02418             ast_indicate(chan, AST_CONTROL_RINGING);
02419             sentringing++;
02420          }
02421       }
02422    }
02423 
02424    peer = wait_for_answer(chan, outgoing, &to, peerflags, opt_args, &pa, &num, &result,
02425       dtmf_progress, ignore_cc, &forced_clid, &stored_clid);
02426 
02427    /* The ast_channel_datastore_remove() function could fail here if the
02428     * datastore was moved to another channel during a masquerade. If this is
02429     * the case, don't free the datastore here because later, when the channel
02430     * to which the datastore was moved hangs up, it will attempt to free this
02431     * datastore again, causing a crash
02432     */
02433    ast_channel_lock(chan);
02434    datastore = ast_channel_datastore_find(chan, &dialed_interface_info, NULL); /* make sure we weren't cleaned up already */
02435    if (datastore && !ast_channel_datastore_remove(chan, datastore)) {
02436       ast_datastore_free(datastore);
02437    }
02438    ast_channel_unlock(chan);
02439    if (!peer) {
02440       if (result) {
02441          res = result;
02442       } else if (to) { /* Musta gotten hung up */
02443          res = -1;
02444       } else { /* Nobody answered, next please? */
02445          res = 0;
02446       }
02447    } else {
02448       const char *number;
02449 
02450       if (ast_test_flag64(&opts, OPT_CALLER_ANSWER))
02451          ast_answer(chan);
02452 
02453       strcpy(pa.status, "ANSWER");
02454       pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
02455       /* Ah ha!  Someone answered within the desired timeframe.  Of course after this
02456          we will always return with -1 so that it is hung up properly after the
02457          conversation.  */
02458       hanguptree(outgoing, peer, 1);
02459       outgoing = NULL;
02460       /* If appropriate, log that we have a destination channel and set the answer time */
02461       if (chan->cdr) {
02462          ast_cdr_setdestchan(chan->cdr, ast_channel_name(peer));
02463          ast_cdr_setanswer(chan->cdr, peer->cdr->answer);
02464       }
02465       if (ast_channel_name(peer))
02466          pbx_builtin_setvar_helper(chan, "DIALEDPEERNAME", ast_channel_name(peer));
02467       
02468       ast_channel_lock(peer);
02469       number = pbx_builtin_getvar_helper(peer, "DIALEDPEERNUMBER"); 
02470       if (!number)
02471          number = numsubst;
02472       pbx_builtin_setvar_helper(chan, "DIALEDPEERNUMBER", number);
02473       ast_channel_unlock(peer);
02474 
02475       if (!ast_strlen_zero(args.url) && ast_channel_supports_html(peer) ) {
02476          ast_debug(1, "app_dial: sendurl=%s.\n", args.url);
02477          ast_channel_sendurl( peer, args.url );
02478       }
02479       if ( (ast_test_flag64(&opts, OPT_PRIVACY) || ast_test_flag64(&opts, OPT_SCREENING)) && pa.privdb_val == AST_PRIVACY_UNKNOWN) {
02480          if (do_privacy(chan, peer, &opts, opt_args, &pa)) {
02481             res = 0;
02482             goto out;
02483          }
02484       }
02485       if (!ast_test_flag64(&opts, OPT_ANNOUNCE) || ast_strlen_zero(opt_args[OPT_ARG_ANNOUNCE])) {
02486          res = 0;
02487       } else {
02488          int digit = 0;
02489          struct ast_channel *chans[2];
02490          struct ast_channel *active_chan;
02491 
02492          chans[0] = chan;
02493          chans[1] = peer;
02494 
02495          /* we need to stream the announcment while monitoring the caller for a hangup */
02496 
02497          /* stream the file */
02498          res = ast_streamfile(peer, opt_args[OPT_ARG_ANNOUNCE], ast_channel_language(peer));
02499          if (res) {
02500             res = 0;
02501             ast_log(LOG_ERROR, "error streaming file '%s' to callee\n", opt_args[OPT_ARG_ANNOUNCE]);
02502          }
02503 
02504          ast_set_flag(peer, AST_FLAG_END_DTMF_ONLY);
02505          while (peer->stream) {
02506             int ms;
02507 
02508             ms = ast_sched_wait(peer->sched);
02509 
02510             if (ms < 0 && !peer->timingfunc) {
02511                ast_stopstream(peer);
02512                break;
02513             }
02514             if (ms < 0)
02515                ms = 1000;
02516 
02517             active_chan = ast_waitfor_n(chans, 2, &ms);
02518             if (active_chan) {
02519                struct ast_frame *fr = ast_read(active_chan);
02520                if (!fr) {
02521                   ast_hangup(peer);
02522                   res = -1;
02523                   goto done;
02524                }
02525                switch(fr->frametype) {
02526                   case AST_FRAME_DTMF_END:
02527                      digit = fr->subclass.integer;
02528                      if (active_chan == peer && strchr(AST_DIGIT_ANY, res)) {
02529                         ast_stopstream(peer);
02530                         res = ast_senddigit(chan, digit, 0);
02531                      }
02532                      break;
02533                   case AST_FRAME_CONTROL:
02534                      switch (fr->subclass.integer) {
02535                         case AST_CONTROL_HANGUP:
02536                            ast_frfree(fr);
02537                            ast_hangup(peer);
02538                            res = -1;
02539                            goto done;
02540                         default:
02541                            break;
02542                      }
02543                      break;
02544                   default:
02545                      /* Ignore all others */
02546                      break;
02547                }
02548                ast_frfree(fr);
02549             }
02550             ast_sched_runq(peer->sched);
02551          }
02552          ast_clear_flag(peer, AST_FLAG_END_DTMF_ONLY);
02553       }
02554 
02555       if (chan && peer && ast_test_flag64(&opts, OPT_GOTO) && !ast_strlen_zero(opt_args[OPT_ARG_GOTO])) {
02556          /* chan and peer are going into the PBX, they both
02557           * should probably get CDR records. */
02558          ast_clear_flag(chan->cdr, AST_CDR_FLAG_DIALED);
02559          ast_clear_flag(peer->cdr, AST_CDR_FLAG_DIALED);
02560 
02561          replace_macro_delimiter(opt_args[OPT_ARG_GOTO]);
02562          ast_parseable_goto(chan, opt_args[OPT_ARG_GOTO]);
02563          /* peer goes to the same context and extension as chan, so just copy info from chan*/
02564          ast_copy_string(peer->context, chan->context, sizeof(peer->context));
02565          ast_copy_string(peer->exten, chan->exten, sizeof(peer->exten));
02566          peer->priority = chan->priority + 2;
02567          ast_pbx_start(peer);
02568          hanguptree(outgoing, NULL, ast_test_flag64(&opts, OPT_CANCEL_ELSEWHERE) ? 1 : 0);
02569          if (continue_exec)
02570             *continue_exec = 1;
02571          res = 0;
02572          goto done;
02573       }
02574 
02575       if (ast_test_flag64(&opts, OPT_CALLEE_MACRO) && !ast_strlen_zero(opt_args[OPT_ARG_CALLEE_MACRO])) {
02576          struct ast_app *theapp;
02577          const char *macro_result;
02578 
02579          res = ast_autoservice_start(chan);
02580          if (res) {
02581             ast_log(LOG_ERROR, "Unable to start autoservice on calling channel\n");
02582             res = -1;
02583          }
02584 
02585          theapp = pbx_findapp("Macro");
02586 
02587          if (theapp && !res) { /* XXX why check res here ? */
02588             /* Set peer->exten and peer->context so that MACRO_EXTEN and MACRO_CONTEXT get set */
02589             ast_copy_string(peer->context, chan->context, sizeof(peer->context));
02590             ast_copy_string(peer->exten, chan->exten, sizeof(peer->exten));
02591 
02592             replace_macro_delimiter(opt_args[OPT_ARG_CALLEE_MACRO]);
02593             res = pbx_exec(peer, theapp, opt_args[OPT_ARG_CALLEE_MACRO]);
02594             ast_debug(1, "Macro exited with status %d\n", res);
02595             res = 0;
02596          } else {
02597             ast_log(LOG_ERROR, "Could not find application Macro\n");
02598             res = -1;
02599          }
02600 
02601          if (ast_autoservice_stop(chan) < 0) {
02602             res = -1;
02603          }
02604 
02605          ast_channel_lock(peer);
02606 
02607          if (!res && (macro_result = pbx_builtin_getvar_helper(peer, "MACRO_RESULT"))) {
02608             char *macro_transfer_dest;
02609 
02610             if (!strcasecmp(macro_result, "BUSY")) {
02611                ast_copy_string(pa.status, macro_result, sizeof(pa.status));
02612                ast_set_flag64(peerflags, OPT_GO_ON);
02613                res = -1;
02614             } else if (!strcasecmp(macro_result, "CONGESTION") || !strcasecmp(macro_result, "CHANUNAVAIL")) {
02615                ast_copy_string(pa.status, macro_result, sizeof(pa.status));
02616                ast_set_flag64(peerflags, OPT_GO_ON);
02617                res = -1;
02618             } else if (!strcasecmp(macro_result, "CONTINUE")) {
02619                /* hangup peer and keep chan alive assuming the macro has changed
02620                   the context / exten / priority or perhaps
02621                   the next priority in the current exten is desired.
02622                */
02623                ast_set_flag64(peerflags, OPT_GO_ON);
02624                res = -1;
02625             } else if (!strcasecmp(macro_result, "ABORT")) {
02626                /* Hangup both ends unless the caller has the g flag */
02627                res = -1;
02628             } else if (!strncasecmp(macro_result, "GOTO:", 5) && (macro_transfer_dest = ast_strdupa(macro_result + 5))) {
02629                res = -1;
02630                /* perform a transfer to a new extension */
02631                if (strchr(macro_transfer_dest, '^')) { /* context^exten^priority*/
02632                   replace_macro_delimiter(macro_transfer_dest);
02633                   if (!ast_parseable_goto(chan, macro_transfer_dest))
02634                      ast_set_flag64(peerflags, OPT_GO_ON);
02635                }
02636             }
02637          }
02638 
02639          ast_channel_unlock(peer);
02640       }
02641 
02642       if (ast_test_flag64(&opts, OPT_CALLEE_GOSUB) && !ast_strlen_zero(opt_args[OPT_ARG_CALLEE_GOSUB])) {
02643          struct ast_app *theapp;
02644          const char *gosub_result;
02645          char *gosub_args, *gosub_argstart;
02646          int res9 = -1;
02647 
02648          res9 = ast_autoservice_start(chan);
02649          if (res9) {
02650             ast_log(LOG_ERROR, "Unable to start autoservice on calling channel\n");
02651             res9 = -1;
02652          }
02653 
02654          theapp = pbx_findapp("Gosub");
02655 
02656          if (theapp && !res9) {
02657             replace_macro_delimiter(opt_args[OPT_ARG_CALLEE_GOSUB]);
02658 
02659             /* Set where we came from */
02660             ast_copy_string(peer->context, "app_dial_gosub_virtual_context", sizeof(peer->context));
02661             ast_copy_string(peer->exten, "s", sizeof(peer->exten));
02662             peer->priority = 0;
02663 
02664             gosub_argstart = strchr(opt_args[OPT_ARG_CALLEE_GOSUB], ',');
02665             if (gosub_argstart) {
02666                const char *what_is_s = "s";
02667                *gosub_argstart = 0;
02668                if (!ast_exists_extension(peer, opt_args[OPT_ARG_CALLEE_GOSUB], "s", 1, S_COR(peer->caller.id.number.valid, peer->caller.id.number.str, NULL)) &&
02669                    ast_exists_extension(peer, opt_args[OPT_ARG_CALLEE_GOSUB], "~~s~~", 1, S_COR(peer->caller.id.number.valid, peer->caller.id.number.str, NULL))) {
02670                   what_is_s = "~~s~~";
02671                }
02672                if (asprintf(&gosub_args, "%s,%s,1(%s)", opt_args[OPT_ARG_CALLEE_GOSUB], what_is_s, gosub_argstart + 1) < 0) {
02673                   ast_log(LOG_WARNING, "asprintf() failed: %s\n", strerror(errno));
02674                   gosub_args = NULL;
02675                }
02676                *gosub_argstart = ',';
02677             } else {
02678                const char *what_is_s = "s";
02679                if (!ast_exists_extension(peer, opt_args[OPT_ARG_CALLEE_GOSUB], "s", 1, S_COR(peer->caller.id.number.valid, peer->caller.id.number.str, NULL)) &&
02680                    ast_exists_extension(peer, opt_args[OPT_ARG_CALLEE_GOSUB], "~~s~~", 1, S_COR(peer->caller.id.number.valid, peer->caller.id.number.str, NULL))) {
02681                   what_is_s = "~~s~~";
02682                }
02683                if (asprintf(&gosub_args, "%s,%s,1", opt_args[OPT_ARG_CALLEE_GOSUB], what_is_s) < 0) {
02684                   ast_log(LOG_WARNING, "asprintf() failed: %s\n", strerror(errno));
02685                   gosub_args = NULL;
02686                }
02687             }
02688 
02689             if (gosub_args) {
02690                res9 = pbx_exec(peer, theapp, gosub_args);
02691                if (!res9) {
02692                   struct ast_pbx_args args;
02693                   /* A struct initializer fails to compile for this case ... */
02694                   memset(&args, 0, sizeof(args));
02695                   args.no_hangup_chan = 1;
02696                   ast_pbx_run_args(peer, &args);
02697                }
02698                ast_free(gosub_args);
02699                ast_debug(1, "Gosub exited with status %d\n", res9);
02700             } else {
02701                ast_log(LOG_ERROR, "Could not Allocate string for Gosub arguments -- Gosub Call Aborted!\n");
02702             }
02703 
02704          } else if (!res9) {
02705             ast_log(LOG_ERROR, "Could not find application Gosub\n");
02706             res9 = -1;
02707          }
02708 
02709          if (ast_autoservice_stop(chan) < 0) {
02710             ast_log(LOG_ERROR, "Could not stop autoservice on calling channel\n");
02711             res9 = -1;
02712          }
02713          
02714          ast_channel_lock(peer);
02715 
02716          if (!res9 && (gosub_result = pbx_builtin_getvar_helper(peer, "GOSUB_RESULT"))) {
02717             char *gosub_transfer_dest;
02718             const char *gosub_retval = pbx_builtin_getvar_helper(peer, "GOSUB_RETVAL");
02719 
02720             /* Inherit return value from the peer, so it can be used in the master */
02721             if (gosub_retval) {
02722                pbx_builtin_setvar_helper(chan, "GOSUB_RETVAL", gosub_retval);
02723             }
02724 
02725             if (!strcasecmp(gosub_result, "BUSY")) {
02726                ast_copy_string(pa.status, gosub_result, sizeof(pa.status));
02727                ast_set_flag64(peerflags, OPT_GO_ON);
02728                res = -1;
02729             } else if (!strcasecmp(gosub_result, "CONGESTION") || !strcasecmp(gosub_result, "CHANUNAVAIL")) {
02730                ast_copy_string(pa.status, gosub_result, sizeof(pa.status));
02731                ast_set_flag64(peerflags, OPT_GO_ON);
02732                res = -1;
02733             } else if (!strcasecmp(gosub_result, "CONTINUE")) {
02734                /* hangup peer and keep chan alive assuming the macro has changed
02735                   the context / exten / priority or perhaps
02736                   the next priority in the current exten is desired.
02737                */
02738                ast_set_flag64(peerflags, OPT_GO_ON);
02739                res = -1;
02740             } else if (!strcasecmp(gosub_result, "ABORT")) {
02741                /* Hangup both ends unless the caller has the g flag */
02742                res = -1;
02743             } else if (!strncasecmp(gosub_result, "GOTO:", 5) && (gosub_transfer_dest = ast_strdupa(gosub_result + 5))) {
02744                res = -1;
02745                /* perform a transfer to a new extension */
02746                if (strchr(gosub_transfer_dest, '^')) { /* context^exten^priority*/
02747                   replace_macro_delimiter(gosub_transfer_dest);
02748                   if (!ast_parseable_goto(chan, gosub_transfer_dest))
02749                      ast_set_flag64(peerflags, OPT_GO_ON);
02750                }
02751             }
02752          }
02753 
02754          ast_channel_unlock(peer);  
02755       }
02756 
02757       if (!res) {
02758          if (!ast_tvzero(calldurationlimit)) {
02759             struct timeval whentohangup = calldurationlimit;
02760             peer->whentohangup = ast_tvadd(ast_tvnow(), whentohangup);
02761          }
02762          if (!ast_strlen_zero(dtmfcalled)) {
02763             ast_verb(3, "Sending DTMF '%s' to the called party.\n", dtmfcalled);
02764             res = ast_dtmf_stream(peer, chan, dtmfcalled, 250, 0);
02765          }
02766          if (!ast_strlen_zero(dtmfcalling)) {
02767             ast_verb(3, "Sending DTMF '%s' to the calling party.\n", dtmfcalling);
02768             res = ast_dtmf_stream(chan, peer, dtmfcalling, 250, 0);
02769          }
02770       }
02771 
02772       if (res) { /* some error */
02773          res = -1;
02774       } else {
02775          if (ast_test_flag64(peerflags, OPT_CALLEE_TRANSFER))
02776             ast_set_flag(&(config.features_callee), AST_FEATURE_REDIRECT);
02777          if (ast_test_flag64(peerflags, OPT_CALLER_TRANSFER))
02778             ast_set_flag(&(config.features_caller), AST_FEATURE_REDIRECT);
02779          if (ast_test_flag64(peerflags, OPT_CALLEE_HANGUP))
02780             ast_set_flag(&(config.features_callee), AST_FEATURE_DISCONNECT);
02781          if (ast_test_flag64(peerflags, OPT_CALLER_HANGUP))
02782             ast_set_flag(&(config.features_caller), AST_FEATURE_DISCONNECT);
02783          if (ast_test_flag64(peerflags, OPT_CALLEE_MONITOR))
02784             ast_set_flag(&(config.features_callee), AST_FEATURE_AUTOMON);
02785          if (ast_test_flag64(peerflags, OPT_CALLER_MONITOR))
02786             ast_set_flag(&(config.features_caller), AST_FEATURE_AUTOMON);
02787          if (ast_test_flag64(peerflags, OPT_CALLEE_PARK))
02788             ast_set_flag(&(config.features_callee), AST_FEATURE_PARKCALL);
02789          if (ast_test_flag64(peerflags, OPT_CALLER_PARK))
02790             ast_set_flag(&(config.features_caller), AST_FEATURE_PARKCALL);
02791          if (ast_test_flag64(peerflags, OPT_CALLEE_MIXMONITOR))
02792             ast_set_flag(&(config.features_callee), AST_FEATURE_AUTOMIXMON);
02793          if (ast_test_flag64(peerflags, OPT_CALLER_MIXMONITOR))
02794             ast_set_flag(&(config.features_caller), AST_FEATURE_AUTOMIXMON);
02795          if (ast_test_flag64(peerflags, OPT_GO_ON))
02796             ast_set_flag(&(config.features_caller), AST_FEATURE_NO_H_EXTEN);
02797 
02798          config.end_bridge_callback = end_bridge_callback;
02799          config.end_bridge_callback_data = chan;
02800          config.end_bridge_callback_data_fixup = end_bridge_callback_data_fixup;
02801          
02802          if (moh) {
02803             moh = 0;
02804             ast_moh_stop(chan);
02805          } else if (sentringing) {
02806             sentringing = 0;
02807             ast_indicate(chan, -1);
02808          }
02809          /* Be sure no generators are left on it and reset the visible indication */
02810          ast_deactivate_generator(chan);
02811          chan->visible_indication = 0;
02812          /* Make sure channels are compatible */
02813          res = ast_channel_make_compatible(chan, peer);
02814          if (res < 0) {
02815             ast_log(LOG_WARNING, "Had to drop call because I couldn't make %s compatible with %s\n", ast_channel_name(chan), ast_channel_name(peer));
02816             ast_hangup(peer);
02817             res = -1;
02818             goto done;
02819          }
02820          if (opermode) {
02821             struct oprmode oprmode;
02822 
02823             oprmode.peer = peer;
02824             oprmode.mode = opermode;
02825 
02826             ast_channel_setoption(chan, AST_OPTION_OPRMODE, &oprmode, sizeof(oprmode), 0);
02827          }
02828          res = ast_bridge_call(chan, peer, &config);
02829       }
02830 
02831       strcpy(peer->context, chan->context);
02832 
02833       if (ast_test_flag64(&opts, OPT_PEER_H)
02834          && ast_exists_extension(peer, peer->context, "h", 1,
02835             S_COR(peer->caller.id.number.valid, peer->caller.id.number.str, NULL))) {
02836          int autoloopflag;
02837          int found;
02838          int res9;
02839          
02840          strcpy(peer->exten, "h");
02841          peer->priority = 1;
02842          autoloopflag = ast_test_flag(peer, AST_FLAG_IN_AUTOLOOP); /* save value to restore at the end */
02843          ast_set_flag(peer, AST_FLAG_IN_AUTOLOOP);
02844 
02845          while ((res9 = ast_spawn_extension(peer, peer->context, peer->exten,
02846             peer->priority,
02847             S_COR(peer->caller.id.number.valid, peer->caller.id.number.str, NULL),
02848             &found, 1)) == 0) {
02849             peer->priority++;
02850          }
02851 
02852          if (found && res9) {
02853             /* Something bad happened, or a hangup has been requested. */
02854             ast_debug(1, "Spawn extension (%s,%s,%d) exited non-zero on '%s'\n", peer->context, peer->exten, peer->priority, ast_channel_name(peer));
02855             ast_verb(2, "Spawn extension (%s, %s, %d) exited non-zero on '%s'\n", peer->context, peer->exten, peer->priority, ast_channel_name(peer));
02856          }
02857          ast_set2_flag(peer, autoloopflag, AST_FLAG_IN_AUTOLOOP);  /* set it back the way it was */
02858       }
02859       if (!ast_check_hangup(peer) && ast_test_flag64(&opts, OPT_CALLEE_GO_ON)) {
02860          if(!ast_strlen_zero(opt_args[OPT_ARG_CALLEE_GO_ON])) {
02861             replace_macro_delimiter(opt_args[OPT_ARG_CALLEE_GO_ON]);
02862             ast_parseable_goto(peer, opt_args[OPT_ARG_CALLEE_GO_ON]);
02863          } else { /* F() */
02864             int res;
02865             res = ast_goto_if_exists(peer, chan->context, chan->exten, (chan->priority) + 1); 
02866             if (res == AST_PBX_GOTO_FAILED) {
02867                ast_hangup(peer);
02868                goto out;
02869             }
02870          }
02871          ast_pbx_start(peer);
02872       } else {
02873          if (!ast_check_hangup(chan))
02874             chan->hangupcause = peer->hangupcause;
02875          ast_hangup(peer);
02876       }
02877    }
02878 out:
02879    if (moh) {
02880       moh = 0;
02881       ast_moh_stop(chan);
02882    } else if (sentringing) {
02883       sentringing = 0;
02884       ast_indicate(chan, -1);
02885    }
02886 
02887    if (delprivintro && ast_fileexists(pa.privintro, NULL, NULL) > 0) {
02888       ast_filedelete(pa.privintro, NULL);
02889       if (ast_fileexists(pa.privintro, NULL, NULL) > 0) {
02890          ast_log(LOG_NOTICE, "privacy: ast_filedelete didn't do its job on %s\n", pa.privintro);
02891       } else {
02892          ast_verb(3, "Successfully deleted %s intro file\n", pa.privintro);
02893       }
02894    }
02895 
02896    ast_channel_early_bridge(chan, NULL);
02897    hanguptree(outgoing, NULL, 0); /* In this case, there's no answer anywhere */
02898    pbx_builtin_setvar_helper(chan, "DIALSTATUS", pa.status);
02899    senddialendevent(chan, pa.status);
02900    ast_debug(1, "Exiting with DIALSTATUS=%s.\n", pa.status);
02901    
02902    if ((ast_test_flag64(peerflags, OPT_GO_ON)) && !ast_check_hangup(chan) && (res != AST_PBX_INCOMPLETE)) {
02903       if (!ast_tvzero(calldurationlimit))
02904          memset(&chan->whentohangup, 0, sizeof(chan->whentohangup));
02905       res = 0;
02906    }
02907 
02908 done:
02909    if (config.warning_sound) {
02910       ast_free((char *)config.warning_sound);
02911    }
02912    if (config.end_sound) {
02913       ast_free((char *)config.end_sound);
02914    }
02915    if (config.start_sound) {
02916       ast_free((char *)config.start_sound);
02917    }
02918    ast_ignore_cc(chan);
02919    return res;
02920 }
02921 
02922 static int dial_exec(struct ast_channel *chan, const char *data)
02923 {
02924    struct ast_flags64 peerflags;
02925 
02926    memset(&peerflags, 0, sizeof(peerflags));
02927 
02928    return dial_exec_full(chan, data, &peerflags, NULL);
02929 }
02930 
02931 static int retrydial_exec(struct ast_channel *chan, const char *data)
02932 {
02933    char *parse;
02934    const char *context = NULL;
02935    int sleepms = 0, loops = 0, res = -1;
02936    struct ast_flags64 peerflags = { 0, };
02937    AST_DECLARE_APP_ARGS(args,
02938       AST_APP_ARG(announce);
02939       AST_APP_ARG(sleep);
02940       AST_APP_ARG(retries);
02941       AST_APP_ARG(dialdata);
02942    );
02943 
02944    if (ast_strlen_zero(data)) {
02945       ast_log(LOG_WARNING, "RetryDial requires an argument!\n");
02946       return -1;
02947    }
02948 
02949    parse = ast_strdupa(data);
02950    AST_STANDARD_APP_ARGS(args, parse);
02951 
02952    if (!ast_strlen_zero(args.sleep) && (sleepms = atoi(args.sleep)))
02953       sleepms *= 1000;
02954 
02955    if (!ast_strlen_zero(args.retries)) {
02956       loops = atoi(args.retries);
02957    }
02958 
02959    if (!args.dialdata) {
02960       ast_log(LOG_ERROR, "%s requires a 4th argument (dialdata)\n", rapp);
02961       goto done;
02962    }
02963 
02964    if (sleepms < 1000)
02965       sleepms = 10000;
02966 
02967    if (!loops)
02968       loops = -1; /* run forever */
02969 
02970    ast_channel_lock(chan);
02971    context = pbx_builtin_getvar_helper(chan, "EXITCONTEXT");
02972    context = !ast_strlen_zero(context) ? ast_strdupa(context) : NULL;
02973    ast_channel_unlock(chan);
02974 
02975    res = 0;
02976    while (loops) {
02977       int continue_exec;
02978 
02979       chan->data = "Retrying";
02980       if (ast_test_flag(chan, AST_FLAG_MOH))
02981          ast_moh_stop(chan);
02982 
02983       res = dial_exec_full(chan, args.dialdata, &peerflags, &continue_exec);
02984       if (continue_exec)
02985          break;
02986 
02987       if (res == 0) {
02988          if (ast_test_flag64(&peerflags, OPT_DTMF_EXIT)) {
02989             if (!ast_strlen_zero(args.announce)) {
02990                if (ast_fileexists(args.announce, NULL, ast_channel_language(chan)) > 0) {
02991                   if (!(res = ast_streamfile(chan, args.announce, ast_channel_language(chan))))
02992                      ast_waitstream(chan, AST_DIGIT_ANY);
02993                } else
02994                   ast_log(LOG_WARNING, "Announce file \"%s\" specified in Retrydial does not exist\n", args.announce);
02995             }
02996             if (!res && sleepms) {
02997                if (!ast_test_flag(chan, AST_FLAG_MOH))
02998                   ast_moh_start(chan, NULL, NULL);
02999                res = ast_waitfordigit(chan, sleepms);
03000             }
03001          } else {
03002             if (!ast_strlen_zero(args.announce)) {
03003                if (ast_fileexists(args.announce, NULL, ast_channel_language(chan)) > 0) {
03004                   if (!(res = ast_streamfile(chan, args.announce, ast_channel_language(chan))))
03005                      res = ast_waitstream(chan, "");
03006                } else
03007                   ast_log(LOG_WARNING, "Announce file \"%s\" specified in Retrydial does not exist\n", args.announce);
03008             }
03009             if (sleepms) {
03010                if (!ast_test_flag(chan, AST_FLAG_MOH))
03011                   ast_moh_start(chan, NULL, NULL);
03012                if (!res)
03013                   res = ast_waitfordigit(chan, sleepms);
03014             }
03015          }
03016       }
03017 
03018       if (res < 0 || res == AST_PBX_INCOMPLETE) {
03019          break;
03020       } else if (res > 0) { /* Trying to send the call elsewhere (1 digit ext) */
03021          if (onedigit_goto(chan, context, (char) res, 1)) {
03022             res = 0;
03023             break;
03024          }
03025       }
03026       loops--;
03027    }
03028    if (loops == 0)
03029       res = 0;
03030    else if (res == 1)
03031       res = 0;
03032 
03033    if (ast_test_flag(chan, AST_FLAG_MOH))
03034       ast_moh_stop(chan);
03035  done:
03036    return res;
03037 }
03038 
03039 static int unload_module(void)
03040 {
03041    int res;
03042    struct ast_context *con;
03043 
03044    res = ast_unregister_application(app);
03045    res |= ast_unregister_application(rapp);
03046 
03047    if ((con = ast_context_find("app_dial_gosub_virtual_context"))) {
03048       ast_context_remove_extension2(con, "s", 1, NULL, 0);
03049       ast_context_destroy(con, "app_dial"); /* leave nothing behind */
03050    }
03051 
03052    return res;
03053 }
03054 
03055 static int load_module(void)
03056 {
03057    int res;
03058    struct ast_context *con;
03059 
03060    con = ast_context_find_or_create(NULL, NULL, "app_dial_gosub_virtual_context", "app_dial");
03061    if (!con)
03062       ast_log(LOG_ERROR, "Dial virtual context 'app_dial_gosub_virtual_context' does not exist and unable to create\n");
03063    else
03064       ast_add_extension2(con, 1, "s", 1, NULL, NULL, "NoOp", ast_strdup(""), ast_free_ptr, "app_dial");
03065 
03066    res = ast_register_application_xml(app, dial_exec);
03067    res |= ast_register_application_xml(rapp, retrydial_exec);
03068 
03069    return res;
03070 }
03071 
03072 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Dialing Application");

Generated on Sat Feb 11 06:33:01 2012 for Asterisk - The Open Source Telephony Project by  doxygen 1.5.6