main/features.c

   1 /*
   2  * Asterisk -- An open source telephony toolkit.
   3  *
   4  * Copyright (C) 1999 - 2012, Digium, Inc.
   5  * Copyright (C) 2012, Russell Bryant
   6  *
   7  * Mark Spencer <markster@digium.com>
   8  *
   9  * See http://www.asterisk.org for more information about
  10  * the Asterisk project. Please do not directly contact
  11  * any of the maintainers of this project for assistance;
  12  * the project provides a web site, mailing lists and IRC
  13  * channels for your use.
  14  *
  15  * This program is free software, distributed under the terms of
  16  * the GNU General Public License Version 2. See the LICENSE file
  17  * at the top of the source tree.
  18  */
  19
  20 /*! \file
  21  *
  22  * \brief Routines implementing call features as call pickup, parking and transfer
  23  *
  24  * \author Mark Spencer <markster@digium.com>
  25  */
  26
  27 /*! \li \ref features.c uses the configuration file \ref features.conf
  28  * \addtogroup configuration_file Configuration Files
  29  */
  30
  31 /*!
  32  * \page features.conf features.conf
  33  * \verbinclude features.conf.sample
  34  */
  35
  36 /*** MODULEINFO
  37         <support_level>core</support_level>
  38  ***/
  39
  40 #include "asterisk.h"
  41
  42 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
  43
  44 #include "asterisk/_private.h"
  45
  46 #include <pthread.h>
  47 #include <signal.h>
  48 #include <sys/time.h>
  49 #include <sys/signal.h>
  50 #include <netinet/in.h>
  51
  52 #include "asterisk/lock.h"
  53 #include "asterisk/file.h"
  54 #include "asterisk/channel.h"
  55 #include "asterisk/pbx.h"
  56 #include "asterisk/causes.h"
  57 #include "asterisk/module.h"
  58 #include "asterisk/translate.h"
  59 #include "asterisk/app.h"
  60 #include "asterisk/say.h"
  61 #include "asterisk/features.h"
  62 #include "asterisk/musiconhold.h"
  63 #include "asterisk/config.h"
  64 #include "asterisk/cli.h"
  65 #include "asterisk/manager.h"
  66 #include "asterisk/utils.h"
  67 #include "asterisk/adsi.h"
  68 #include "asterisk/devicestate.h"
  69 #include "asterisk/monitor.h"
  70 #include "asterisk/audiohook.h"
  71 #include "asterisk/global_datastores.h"
  72 #include "asterisk/astobj2.h"
  73 #include "asterisk/test.h"
  74 #include "asterisk/bridge.h"
  75 #include "asterisk/bridge_features.h"
  76 #include "asterisk/bridge_basic.h"
  77 #include "asterisk/bridge_after.h"
  78 #include "asterisk/stasis.h"
  79 #include "asterisk/stasis_channels.h"
  80 #include "asterisk/features_config.h"
  81
  82 /*** DOCUMENTATION
  83         <application name="Bridge" language="en_US">
  84                 <synopsis>
  85                         Bridge two channels.
  86                 </synopsis>
  87                 <syntax>
  88                         <parameter name="channel" required="true">
  89                                 <para>The current channel is bridged to the specified <replaceable>channel</replaceable>.</para>
  90                         </parameter>
  91                         <parameter name="options">
  92                                 <optionlist>
  93                                         <option name="p">
  94                                                 <para>Play a courtesy tone to <replaceable>channel</replaceable>.</para>
  95                                         </option>
  96                                         <option name="F" argsep="^">
  97                                                 <argument name="context" required="false" />
  98                                                 <argument name="exten" required="false" />
  99                                                 <argument name="priority" required="true" />
 100                                                 <para>When the bridger hangs up, transfer the <emphasis>bridged</emphasis> party
 101                                                 to the specified destination and <emphasis>start</emphasis> execution at that location.</para>
 102                                                 <note>
 103                                                         <para>Any channel variables you want the called channel to inherit from the caller channel must be
 104                                                         prefixed with one or two underbars ('_').</para>
 105                                                 </note>
 106                                                 <note>
 107                                                         <para>This option will override the 'x' option</para>
 108                                                 </note>
 109                                         </option>
 110                                         <option name="F">
 111                                                 <para>When the bridger hangs up, transfer the <emphasis>bridged</emphasis> party
 112                                                 to the next priority of the current extension and <emphasis>start</emphasis> execution
 113                                                 at that location.</para>
 114                                                 <note>
 115                                                         <para>Any channel variables you want the called channel to inherit from the caller channel must be
 116                                                         prefixed with one or two underbars ('_').</para>
 117                                                 </note>
 118                                                 <note>
 119                                                         <para>Using this option from a Macro() or GoSub() might not make sense as there would be no return points.</para>
 120                                                 </note>
 121                                                 <note>
 122                                                         <para>This option will override the 'x' option</para>
 123                                                 </note>
 124                                         </option>
 125
 126                                         <option name="h">
 127                                                 <para>Allow the called party to hang up by sending the
 128                                                 <replaceable>*</replaceable> DTMF digit.</para>
 129                                         </option>
 130                                         <option name="H">
 131                                                 <para>Allow the calling party to hang up by pressing the
 132                                                 <replaceable>*</replaceable> DTMF digit.</para>
 133                                         </option>
 134                                         <option name="k">
 135                                                 <para>Allow the called party to enable parking of the call by sending
 136                                                 the DTMF sequence defined for call parking in <filename>features.conf</filename>.</para>
 137                                         </option>
 138                                         <option name="K">
 139                                                 <para>Allow the calling party to enable parking of the call by sending
 140                                                  the DTMF sequence defined for call parking in <filename>features.conf</filename>.</para>
 141                                         </option>
 142                                         <option name="L(x[:y][:z])">
 143                                                 <para>Limit the call to <replaceable>x</replaceable> ms. Play a warning
 144                                                 when <replaceable>y</replaceable> ms are left. Repeat the warning every
 145                                                 <replaceable>z</replaceable> ms. The following special variables can be
 146                                                 used with this option:</para>
 147                                                 <variablelist>
 148                                                         <variable name="LIMIT_PLAYAUDIO_CALLER">
 149                                                                 <para>Play sounds to the caller. yes|no (default yes)</para>
 150                                                         </variable>
 151                                                         <variable name="LIMIT_PLAYAUDIO_CALLEE">
 152                                                                 <para>Play sounds to the callee. yes|no</para>
 153                                                         </variable>
 154                                                         <variable name="LIMIT_TIMEOUT_FILE">
 155                                                                 <para>File to play when time is up.</para>
 156                                                         </variable>
 157                                                         <variable name="LIMIT_CONNECT_FILE">
 158                                                                 <para>File to play when call begins.</para>
 159                                                         </variable>
 160                                                         <variable name="LIMIT_WARNING_FILE">
 161                                                                 <para>File to play as warning if <replaceable>y</replaceable> is
 162                                                                 defined. The default is to say the time remaining.</para>
 163                                                         </variable>
 164                                                 </variablelist>
 165                                         </option>
 166                                         <option name="S(x)">
 167                                                 <para>Hang up the call after <replaceable>x</replaceable> seconds *after* the called party has answered the call.</para>
 168                                         </option>
 169                                         <option name="t">
 170                                                 <para>Allow the called party to transfer the calling party by sending the
 171                                                 DTMF sequence defined in <filename>features.conf</filename>.</para>
 172                                         </option>
 173                                         <option name="T">
 174                                                 <para>Allow the calling party to transfer the called party by sending the
 175                                                 DTMF sequence defined in <filename>features.conf</filename>.</para>
 176                                         </option>
 177                                         <option name="w">
 178                                                 <para>Allow the called party to enable recording of the call by sending
 179                                                 the DTMF sequence defined for one-touch recording in <filename>features.conf</filename>.</para>
 180                                         </option>
 181                                         <option name="W">
 182                                                 <para>Allow the calling party to enable recording of the call by sending
 183                                                 the DTMF sequence defined for one-touch recording in <filename>features.conf</filename>.</para>
 184                                         </option>
 185                                         <option name="x">
 186                                                 <para>Cause the called party to be hung up after the bridge, instead of being
 187                                                 restarted in the dialplan.</para>
 188                                         </option>
 189                                 </optionlist>
 190                         </parameter>
 191                 </syntax>
 192                 <description>
 193                         <para>Allows the ability to bridge two channels via the dialplan.</para>
 194                         <para>This application sets the following channel variable upon completion:</para>
 195                         <variablelist>
 196                                 <variable name="BRIDGERESULT">
 197                                         <para>The result of the bridge attempt as a text string.</para>
 198                                         <value name="SUCCESS" />
 199                                         <value name="FAILURE" />
 200                                         <value name="LOOP" />
 201                                         <value name="NONEXISTENT" />
 202                                         <value name="INCOMPATIBLE" />
 203                                 </variable>
 204                         </variablelist>
 205                 </description>
 206         </application>
 207         <manager name="Bridge" language="en_US">
 208                 <synopsis>
 209                         Bridge two channels already in the PBX.
 210                 </synopsis>
 211                 <syntax>
 212                         <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
 213                         <parameter name="Channel1" required="true">
 214                                 <para>Channel to Bridge to Channel2.</para>
 215                         </parameter>
 216                         <parameter name="Channel2" required="true">
 217                                 <para>Channel to Bridge to Channel1.</para>
 218                         </parameter>
 219                         <parameter name="Tone">
 220                                 <para>Play courtesy tone to Channel 2.</para>
 221                                 <enumlist>
 222                                         <enum name="no" />
 223                                         <enum name="Channel1" />
 224                                         <enum name="Channel2" />
 225                                         <enum name="Both" />
 226                                 </enumlist>
 227                         </parameter>
 228                 </syntax>
 229                 <description>
 230                         <para>Bridge together two channels already in the PBX.</para>
 231                 </description>
 232         </manager>
 233  ***/
 234
 235 typedef enum {
 236         FEATURE_INTERPRET_DETECT, /* Used by ast_feature_detect */
 237         FEATURE_INTERPRET_DO,     /* Used by feature_interpret */
 238         FEATURE_INTERPRET_CHECK,  /* Used by feature_check */
 239 } feature_interpret_op;
 240
 241 struct ast_dial_features {
 242         /*! Channel's feature flags. */
 243         struct ast_flags my_features;
 244         /*! Bridge peer's feature flags. */
 245         struct ast_flags peer_features;
 246 };
 247
 248 static void *dial_features_duplicate(void *data)
 249 {
 250         struct ast_dial_features *df = data, *df_copy;
 251
 252         if (!(df_copy = ast_calloc(1, sizeof(*df)))) {
 253                 return NULL;
 254         }
 255
 256         memcpy(df_copy, df, sizeof(*df));
 257
 258         return df_copy;
 259 }
 260
 261 static const struct ast_datastore_info dial_features_info = {
 262         .type = "dial-features",
 263         .destroy = ast_free_ptr,
 264         .duplicate = dial_features_duplicate,
 265 };
 266
 267 /*!
 268  * \internal
 269  * \brief Set the features datastore if it doesn't exist.
 270  *
 271  * \param chan Channel to add features datastore
 272  * \param my_features The channel's feature flags
 273  * \param peer_features The channel's bridge peer feature flags
 274  *
 275  * \retval TRUE if features datastore already existed.
 276  */
 277 static int add_features_datastore(struct ast_channel *chan, const struct ast_flags *my_features, const struct ast_flags *peer_features)
 278 {
 279         struct ast_datastore *datastore;
 280         struct ast_dial_features *dialfeatures;
 281
 282         ast_channel_lock(chan);
 283         datastore = ast_channel_datastore_find(chan, &dial_features_info, NULL);
 284         ast_channel_unlock(chan);
 285         if (datastore) {
 286                 /* Already exists. */
 287                 return 1;
 288         }
 289
 290         /* Create a new datastore with specified feature flags. */
 291         datastore = ast_datastore_alloc(&dial_features_info, NULL);
 292         if (!datastore) {
 293                 ast_log(LOG_WARNING, "Unable to create channel features datastore.\n");
 294                 return 0;
 295         }
 296         dialfeatures = ast_calloc(1, sizeof(*dialfeatures));
 297         if (!dialfeatures) {
 298                 ast_log(LOG_WARNING, "Unable to allocate memory for feature flags.\n");
 299                 ast_datastore_free(datastore);
 300                 return 0;
 301         }
 302         ast_copy_flags(&dialfeatures->my_features, my_features, AST_FLAGS_ALL);
 303         ast_copy_flags(&dialfeatures->peer_features, peer_features, AST_FLAGS_ALL);
 304         datastore->inheritance = DATASTORE_INHERIT_FOREVER;
 305         datastore->data = dialfeatures;
 306         ast_channel_lock(chan);
 307         ast_channel_datastore_add(chan, datastore);
 308         ast_channel_unlock(chan);
 309         return 0;
 310 }
 311
 312 struct ast_bridge_thread_obj
 313 {
 314         struct ast_bridge_config bconfig;
 315         struct ast_channel *chan;
 316         struct ast_channel *peer;
 317         struct ast_callid *callid;                             /*<! callid pointer (Only used to bind thread) */
 318         unsigned int return_to_pbx:1;
 319 };
 320
 321 static const struct ast_datastore_info channel_app_data_datastore = {
 322         .type = "Channel appdata datastore",
 323         .destroy = ast_free_ptr,
 324 };
 325
 326 static void set_config_flags(struct ast_channel *chan, struct ast_bridge_config *config)
 327 {
 328         ast_clear_flag(config, AST_FLAGS_ALL);
 329
 330         if (ast_test_flag(&config->features_caller, AST_FEATURE_DTMF_MASK)) {
 331                 ast_set_flag(config, AST_BRIDGE_DTMF_CHANNEL_0);
 332         }
 333         if (ast_test_flag(&config->features_callee, AST_FEATURE_DTMF_MASK)) {
 334                 ast_set_flag(config, AST_BRIDGE_DTMF_CHANNEL_1);
 335         }
 336
 337         if (!(ast_test_flag(config, AST_BRIDGE_DTMF_CHANNEL_0) && ast_test_flag(config, AST_BRIDGE_DTMF_CHANNEL_1))) {
 338                 RAII_VAR(struct ao2_container *, applicationmap, NULL, ao2_cleanup);
 339
 340                 ast_channel_lock(chan);
 341                 applicationmap = ast_get_chan_applicationmap(chan);
 342                 ast_channel_unlock(chan);
 343
 344                 if (!applicationmap) {
 345                         return;
 346                 }
 347
 348                 /* If an applicationmap exists for this channel at all, then the channel needs the DTMF flag set */
 349                 ast_set_flag(config, AST_BRIDGE_DTMF_CHANNEL_0);
 350         }
 351 }
 352
 353 void ast_channel_log(char *title, struct ast_channel *chan);
 354
 355 void ast_channel_log(char *title, struct ast_channel *chan) /* for debug, this is handy enough to justify keeping it in the source */
 356 {
 357         ast_log(LOG_NOTICE, "______ %s (%lx)______\n", title, (unsigned long) chan);
 358         ast_log(LOG_NOTICE, "CHAN: name: %s;  appl: %s; data: %s; contxt: %s;  exten: %s; pri: %d;\n",
 359                 ast_channel_name(chan), ast_channel_appl(chan), ast_channel_data(chan),
 360                 ast_channel_context(chan), ast_channel_exten(chan), ast_channel_priority(chan));
 361         ast_log(LOG_NOTICE, "CHAN: acctcode: %s;  dialcontext: %s; amaflags: %x; maccontxt: %s;  macexten: %s; macpri: %d;\n",
 362                 ast_channel_accountcode(chan), ast_channel_dialcontext(chan), ast_channel_amaflags(chan),
 363                 ast_channel_macrocontext(chan), ast_channel_macroexten(chan), ast_channel_macropriority(chan));
 364         ast_log(LOG_NOTICE, "CHAN: masq: %p;  masqr: %p; uniqueID: %s; linkedID:%s\n",
 365                 ast_channel_masq(chan), ast_channel_masqr(chan),
 366                 ast_channel_uniqueid(chan), ast_channel_linkedid(chan));
 367         if (ast_channel_masqr(chan)) {
 368                 ast_log(LOG_NOTICE, "CHAN: masquerading as: %s;  cdr: %p;\n",
 369                         ast_channel_name(ast_channel_masqr(chan)), ast_channel_cdr(ast_channel_masqr(chan)));
 370         }
 371
 372         ast_log(LOG_NOTICE, "===== done ====\n");
 373 }
 374
 375 static void set_bridge_features_on_config(struct ast_bridge_config *config, const char *features)
 376 {
 377         const char *feature;
 378
 379         if (ast_strlen_zero(features)) {
 380                 return;
 381         }
 382
 383         for (feature = features; *feature; feature++) {
 384                 struct ast_flags *party;
 385
 386                 if (isupper(*feature)) {
 387                         party = &config->features_caller;
 388                 } else {
 389                         party = &config->features_callee;
 390                 }
 391
 392                 switch (tolower(*feature)) {
 393                 case 't' :
 394                         ast_set_flag(party, AST_FEATURE_REDIRECT);
 395                         break;
 396                 case 'k' :
 397                         ast_set_flag(party, AST_FEATURE_PARKCALL);
 398                         break;
 399                 case 'h' :
 400                         ast_set_flag(party, AST_FEATURE_DISCONNECT);
 401                         break;
 402                 case 'w' :
 403                         ast_set_flag(party, AST_FEATURE_AUTOMON);
 404                         break;
 405                 case 'x' :
 406                         ast_set_flag(party, AST_FEATURE_AUTOMIXMON);
 407                         break;
 408                 default :
 409                         ast_log(LOG_WARNING, "Skipping unknown feature code '%c'\n", *feature);
 410                         break;
 411                 }
 412         }
 413 }
 414
 415 static void add_features_datastores(struct ast_channel *caller, struct ast_channel *callee, struct ast_bridge_config *config)
 416 {
 417         if (add_features_datastore(caller, &config->features_caller, &config->features_callee)) {
 418                 /*
 419                  * If we don't return here, then when we do a builtin_atxfer we
 420                  * will copy the disconnect flags over from the atxfer to the
 421                  * callee (Party C).
 422                  */
 423                 return;
 424         }
 425
 426         add_features_datastore(callee, &config->features_callee, &config->features_caller);
 427 }
 428
 429 static void clear_dialed_interfaces(struct ast_channel *chan)
 430 {
 431         struct ast_datastore *di_datastore;
 432
 433         ast_channel_lock(chan);
 434         if ((di_datastore = ast_channel_datastore_find(chan, &dialed_interface_info, NULL))) {
 435                 if (option_debug) {
 436                         ast_log(LOG_DEBUG, "Removing dialed interfaces datastore on %s since we're bridging\n", ast_channel_name(chan));
 437                 }
 438                 if (!ast_channel_datastore_remove(chan, di_datastore)) {
 439                         ast_datastore_free(di_datastore);
 440                 }
 441         }
 442         ast_channel_unlock(chan);
 443 }
 444
 445 static void bridge_config_set_limits_warning_values(struct ast_bridge_config *config, struct ast_bridge_features_limits *limits)
 446 {
 447         if (config->end_sound) {
 448                 ast_string_field_set(limits, duration_sound, config->end_sound);
 449         }
 450
 451         if (config->warning_sound) {
 452                 ast_string_field_set(limits, warning_sound, config->warning_sound);
 453         }
 454
 455         if (config->start_sound) {
 456                 ast_string_field_set(limits, connect_sound, config->start_sound);
 457         }
 458
 459         limits->frequency = config->warning_freq;
 460         limits->warning = config->play_warning;
 461 }
 462
 463 /*!
 464  * \internal brief Setup limit hook structures on calls that need limits
 465  *
 466  * \param config ast_bridge_config which provides the limit data
 467  * \param caller_limits pointer to an ast_bridge_features_limits struct which will store the caller side limits
 468  * \param callee_limits pointer to an ast_bridge_features_limits struct which will store the callee side limits
 469  */
 470 static void bridge_config_set_limits(struct ast_bridge_config *config, struct ast_bridge_features_limits *caller_limits, struct ast_bridge_features_limits *callee_limits)
 471 {
 472         if (ast_test_flag(&config->features_caller, AST_FEATURE_PLAY_WARNING)) {
 473                 bridge_config_set_limits_warning_values(config, caller_limits);
 474         }
 475
 476         if (ast_test_flag(&config->features_callee, AST_FEATURE_PLAY_WARNING)) {
 477                 bridge_config_set_limits_warning_values(config, callee_limits);
 478         }
 479
 480         caller_limits->duration = config->timelimit;
 481         callee_limits->duration = config->timelimit;
 482 }
 483
 484 /*!
 485  * \internal
 486  * \brief Check if Monitor needs to be started on a channel.
 487  * \since 12.0.0
 488  *
 489  * \param chan The bridge considers this channel the caller.
 490  * \param peer The bridge considers this channel the callee.
 491  *
 492  * \return Nothing
 493  */
 494 static void bridge_check_monitor(struct ast_channel *chan, struct ast_channel *peer)
 495 {
 496         const char *value;
 497         const char *monitor_args = NULL;
 498         struct ast_channel *monitor_chan = NULL;
 499
 500         ast_channel_lock(chan);
 501         value = pbx_builtin_getvar_helper(chan, "AUTO_MONITOR");
 502         if (!ast_strlen_zero(value)) {
 503                 monitor_args = ast_strdupa(value);
 504                 monitor_chan = chan;
 505         }
 506         ast_channel_unlock(chan);
 507         if (!monitor_chan) {
 508                 ast_channel_lock(peer);
 509                 value = pbx_builtin_getvar_helper(peer, "AUTO_MONITOR");
 510                 if (!ast_strlen_zero(value)) {
 511                         monitor_args = ast_strdupa(value);
 512                         monitor_chan = peer;
 513                 }
 514                 ast_channel_unlock(peer);
 515         }
 516         if (monitor_chan) {
 517                 struct ast_app *monitor_app;
 518
 519                 monitor_app = pbx_findapp("Monitor");
 520                 if (monitor_app) {
 521                         pbx_exec(monitor_chan, monitor_app, monitor_args);
 522                 }
 523         }
 524 }
 525
 526 /*!
 527  * \internal
 528  * \brief Send the peer channel on its way on bridge start failure.
 529  * \since 12.0.0
 530  *
 531  * \param chan Chan to put into autoservice.
 532  * \param peer Chan to send to after bridge goto or run hangup handlers and hangup.
 533  *
 534  * \return Nothing
 535  */
 536 static void bridge_failed_peer_goto(struct ast_channel *chan, struct ast_channel *peer)
 537 {
 538         if (ast_bridge_setup_after_goto(peer)
 539                 || ast_pbx_start(peer)) {
 540                 ast_autoservice_chan_hangup_peer(chan, peer);
 541         }
 542 }
 543
 544 static int pre_bridge_setup(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config,
 545                 struct ast_bridge_features *chan_features, struct ast_bridge_features *peer_features)
 546 {
 547         int res;
 548
 549         set_bridge_features_on_config(config, pbx_builtin_getvar_helper(chan, "BRIDGE_FEATURES"));
 550         add_features_datastores(chan, peer, config);
 551
 552         /*
 553          * This is an interesting case.  One example is if a ringing
 554          * channel gets redirected to an extension that picks up a
 555          * parked call.  This will make sure that the call taken out of
 556          * parking gets told that the channel it just got bridged to is
 557          * still ringing.
 558          */
 559         if (ast_channel_state(chan) == AST_STATE_RINGING
 560                 && ast_channel_visible_indication(peer) != AST_CONTROL_RINGING) {
 561                 ast_indicate(peer, AST_CONTROL_RINGING);
 562         }
 563
 564         bridge_check_monitor(chan, peer);
 565
 566         set_config_flags(chan, config);
 567
 568         /* Answer if need be */
 569         if (ast_channel_state(chan) != AST_STATE_UP) {
 570                 if (ast_raw_answer(chan)) {
 571                         return -1;
 572                 }
 573         }
 574
 575 #ifdef FOR_DEBUG
 576         /* show the two channels and cdrs involved in the bridge for debug & devel purposes */
 577         ast_channel_log("Pre-bridge CHAN Channel info", chan);
 578         ast_channel_log("Pre-bridge PEER Channel info", peer);
 579 #endif
 580
 581         /*
 582          * If we are bridging a call, stop worrying about forwarding
 583          * loops.  We presume that if a call is being bridged, that the
 584          * humans in charge know what they're doing.  If they don't,
 585          * well, what can we do about that?
 586          */
 587         clear_dialed_interfaces(chan);
 588         clear_dialed_interfaces(peer);
 589
 590         res = 0;
 591         ast_channel_lock(chan);
 592         res |= ast_bridge_features_ds_append(chan, &config->features_caller);
 593         ast_channel_unlock(chan);
 594         ast_channel_lock(peer);
 595         res |= ast_bridge_features_ds_append(peer, &config->features_callee);
 596         ast_channel_unlock(peer);
 597
 598         if (res) {
 599                 return -1;
 600         }
 601
 602         if (config->timelimit) {
 603                 struct ast_bridge_features_limits call_duration_limits_chan;
 604                 struct ast_bridge_features_limits call_duration_limits_peer;
 605                 int abandon_call = 0; /* TRUE if set limits fails so we can abandon the call. */
 606
 607                 if (ast_bridge_features_limits_construct(&call_duration_limits_chan)) {
 608                         ast_log(LOG_ERROR, "Could not construct caller duration limits. Bridge canceled.\n");
 609
 610                         return -1;
 611                 }
 612
 613                 if (ast_bridge_features_limits_construct(&call_duration_limits_peer)) {
 614                         ast_log(LOG_ERROR, "Could not construct callee duration limits. Bridge canceled.\n");
 615                         ast_bridge_features_limits_destroy(&call_duration_limits_chan);
 616
 617                         return -1;
 618                 }
 619
 620                 bridge_config_set_limits(config, &call_duration_limits_chan, &call_duration_limits_peer);
 621
 622                 if (ast_bridge_features_set_limits(chan_features, &call_duration_limits_chan, 0)) {
 623                         abandon_call = 1;
 624                 }
 625                 if (ast_bridge_features_set_limits(peer_features, &call_duration_limits_peer, 0)) {
 626                         abandon_call = 1;
 627                 }
 628
 629                 /* At this point we are done with the limits structs since they have been copied to the individual feature sets. */
 630                 ast_bridge_features_limits_destroy(&call_duration_limits_chan);
 631                 ast_bridge_features_limits_destroy(&call_duration_limits_peer);
 632
 633                 if (abandon_call) {
 634                         ast_log(LOG_ERROR, "Could not set duration limits on one or more sides of the call. Bridge canceled.\n");
 635                         return -1;
 636                 }
 637         }
 638
 639         return 0;
 640 }
 641
 642 /*!
 643  * \brief bridge the call and set CDR
 644  *
 645  * \param chan The bridge considers this channel the caller.
 646  * \param peer The bridge considers this channel the callee.
 647  * \param config Configuration for this bridge.
 648  *
 649  * Set start time, check for two channels,check if monitor on
 650  * check for feature activation, create new CDR
 651  * \retval res on success.
 652  * \retval -1 on failure to bridge.
 653  */
 654 int ast_bridge_call(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config)
 655 {
 656         int res;
 657         struct ast_bridge *bridge;
 658         struct ast_bridge_features chan_features;
 659         struct ast_bridge_features *peer_features;
 660
 661         /* Setup features. */
 662         res = ast_bridge_features_init(&chan_features);
 663         peer_features = ast_bridge_features_new();
 664         if (res || !peer_features) {
 665                 ast_bridge_features_destroy(peer_features);
 666                 ast_bridge_features_cleanup(&chan_features);
 667                 bridge_failed_peer_goto(chan, peer);
 668                 return -1;
 669         }
 670
 671         if (pre_bridge_setup(chan, peer, config, &chan_features, peer_features)) {
 672                 ast_bridge_features_destroy(peer_features);
 673                 ast_bridge_features_cleanup(&chan_features);
 674                 bridge_failed_peer_goto(chan, peer);
 675                 return -1;
 676         }
 677
 678         /* Create bridge */
 679         bridge = ast_bridge_basic_new();
 680         if (!bridge) {
 681                 ast_bridge_features_destroy(peer_features);
 682                 ast_bridge_features_cleanup(&chan_features);
 683                 bridge_failed_peer_goto(chan, peer);
 684                 return -1;
 685         }
 686
 687         /* Put peer into the bridge */
 688         if (ast_bridge_impart(bridge, peer, NULL, peer_features, 1)) {
 689                 ast_bridge_destroy(bridge);
 690                 ast_bridge_features_cleanup(&chan_features);
 691                 bridge_failed_peer_goto(chan, peer);
 692                 return -1;
 693         }
 694
 695         /* Join bridge */
 696         ast_bridge_join(bridge, chan, NULL, &chan_features, NULL, 1);
 697
 698         /*
 699          * If the bridge was broken for a hangup that isn't real, then
 700          * don't run the h extension, because the channel isn't really
 701          * hung up.  This should really only happen with
 702          * AST_SOFTHANGUP_ASYNCGOTO.
 703          */
 704         res = -1;
 705         ast_channel_lock(chan);
 706         if (ast_channel_softhangup_internal_flag(chan) & AST_SOFTHANGUP_ASYNCGOTO) {
 707                 res = 0;
 708         }
 709         ast_channel_unlock(chan);
 710
 711         ast_bridge_features_cleanup(&chan_features);
 712
 713         if (res && config->end_bridge_callback) {
 714                 config->end_bridge_callback(config->end_bridge_callback_data);
 715         }
 716
 717         return res;
 718 }
 719
 720 enum play_tone_action {
 721         PLAYTONE_NONE = 0,
 722         PLAYTONE_CHANNEL1 = (1 << 0),
 723         PLAYTONE_CHANNEL2 = (1 << 1),
 724         PLAYTONE_BOTH = PLAYTONE_CHANNEL1 | PLAYTONE_CHANNEL2,
 725 };
 726
 727 static enum play_tone_action parse_playtone(const char *playtone_val)
 728 {
 729         if (ast_strlen_zero(playtone_val) || ast_false(playtone_val)) {
 730                 return PLAYTONE_NONE;
 731         } if (!strcasecmp(playtone_val, "channel1")) {
 732                 return PLAYTONE_CHANNEL1;
 733         } else if (!strcasecmp(playtone_val, "channel2") || ast_true(playtone_val)) {
 734                 return PLAYTONE_CHANNEL2;
 735         } else if (!strcasecmp(playtone_val, "both")) {
 736                 return PLAYTONE_BOTH;
 737         } else {
 738                 /* Invalid input. Assume none */
 739                 return PLAYTONE_NONE;
 740         }
 741 }
 742
 743 /*!
 744  * \brief Bridge channels together
 745  * \param s
 746  * \param m
 747  *
 748  * Make sure valid channels were specified,
 749  * send errors if any of the channels could not be found/locked, answer channels if needed,
 750  * create the placeholder channels and grab the other channels
 751  * make the channels compatible, send error if we fail doing so
 752  * setup the bridge thread object and start the bridge.
 753  *
 754  * \retval 0
 755  */
 756 static int action_bridge(struct mansession *s, const struct message *m)
 757 {
 758         const char *channela = astman_get_header(m, "Channel1");
 759         const char *channelb = astman_get_header(m, "Channel2");
 760         enum play_tone_action playtone = parse_playtone(astman_get_header(m, "Tone"));
 761         RAII_VAR(struct ast_channel *, chana, NULL, ao2_cleanup);
 762         RAII_VAR(struct ast_channel *, chanb, NULL, ao2_cleanup);
 763         const char *chana_exten;
 764         const char *chana_context;
 765         int chana_priority;
 766         const char *chanb_exten;
 767         const char *chanb_context;
 768         int chanb_priority;
 769         struct ast_bridge *bridge;
 770         char buf[256];
 771         RAII_VAR(struct ast_features_xfer_config *, xfer_cfg_a, NULL, ao2_cleanup);
 772         RAII_VAR(struct ast_features_xfer_config *, xfer_cfg_b, NULL, ao2_cleanup);
 773
 774         /* make sure valid channels were specified */
 775         if (ast_strlen_zero(channela) || ast_strlen_zero(channelb)) {
 776                 astman_send_error(s, m, "Missing channel parameter in request");
 777                 return 0;
 778         }
 779
 780         ast_debug(1, "Performing Bridge action on %s and %s\n", channela, channelb);
 781
 782         /* Start with chana */
 783         chana = ast_channel_get_by_name_prefix(channela, strlen(channela));
 784         if (!chana) {
 785                 snprintf(buf, sizeof(buf), "Channel1 does not exist: %s", channela);
 786                 astman_send_error(s, m, buf);
 787                 return 0;
 788         }
 789         xfer_cfg_a = ast_get_chan_features_xfer_config(chana);
 790         ast_channel_lock(chana);
 791         chana_exten = ast_strdupa(ast_channel_exten(chana));
 792         chana_context = ast_strdupa(ast_channel_context(chana));
 793         chana_priority = ast_channel_priority(chana);
 794         if (!ast_test_flag(ast_channel_flags(chana), AST_FLAG_IN_AUTOLOOP)) {
 795                 chana_priority++;
 796         }
 797         ast_channel_unlock(chana);
 798
 799         chanb = ast_channel_get_by_name_prefix(channelb, strlen(channelb));
 800         if (!chanb) {
 801                 snprintf(buf, sizeof(buf), "Channel2 does not exist: %s", channelb);
 802                 astman_send_error(s, m, buf);
 803                 return 0;
 804         }
 805         xfer_cfg_b = ast_get_chan_features_xfer_config(chanb);
 806         ast_channel_lock(chanb);
 807         chanb_exten = ast_strdupa(ast_channel_exten(chanb));
 808         chanb_context = ast_strdupa(ast_channel_context(chanb));
 809         chanb_priority = ast_channel_priority(chanb);
 810         if (!ast_test_flag(ast_channel_flags(chanb), AST_FLAG_IN_AUTOLOOP)) {
 811                 chanb_priority++;
 812         }
 813         ast_channel_unlock(chanb);
 814
 815         bridge = ast_bridge_basic_new();
 816         if (!bridge) {
 817                 astman_send_error(s, m, "Unable to create bridge\n");
 818                 return 0;
 819         }
 820
 821         ast_bridge_set_after_go_on(chana, chana_context, chana_exten, chana_priority, NULL);
 822         if (ast_bridge_add_channel(bridge, chana, NULL, playtone & PLAYTONE_CHANNEL1, xfer_cfg_a ? xfer_cfg_a->xfersound : NULL)) {
 823                 snprintf(buf, sizeof(buf), "Unable to add Channel1 to bridge: %s", ast_channel_name(chana));
 824                 astman_send_error(s, m, buf);
 825                 ast_bridge_destroy(bridge);
 826                 return 0;
 827         }
 828
 829         ast_bridge_set_after_go_on(chanb, chanb_context, chanb_exten, chanb_priority, NULL);
 830         if (ast_bridge_add_channel(bridge, chanb, NULL, playtone & PLAYTONE_CHANNEL2, xfer_cfg_b ? xfer_cfg_b->xfersound : NULL)) {
 831                 snprintf(buf, sizeof(buf), "Unable to add Channel2 to bridge: %s", ast_channel_name(chanb));
 832                 astman_send_error(s, m, buf);
 833                 ast_bridge_destroy(bridge);
 834                 return 0;
 835         }
 836
 837         astman_send_ack(s, m, "Channels have been bridged");
 838
 839         return 0;
 840 }
 841
 842 static char *app_bridge = "Bridge";
 843
 844 enum {
 845         BRIDGE_OPT_PLAYTONE = (1 << 0),
 846         OPT_CALLEE_HANGUP =     (1 << 1),
 847         OPT_CALLER_HANGUP =     (1 << 2),
 848         OPT_DURATION_LIMIT = (1 << 3),
 849         OPT_DURATION_STOP =     (1 << 4),
 850         OPT_CALLEE_TRANSFER = (1 << 5),
 851         OPT_CALLER_TRANSFER = (1 << 6),
 852         OPT_CALLEE_MONITOR = (1 << 7),
 853         OPT_CALLER_MONITOR = (1 << 8),
 854         OPT_CALLEE_PARK = (1 << 9),
 855         OPT_CALLER_PARK = (1 << 10),
 856         OPT_CALLEE_KILL = (1 << 11),
 857         OPT_CALLEE_GO_ON = (1 << 12),
 858 };
 859
 860 enum {
 861         OPT_ARG_DURATION_LIMIT = 0,
 862         OPT_ARG_DURATION_STOP,
 863         OPT_ARG_CALLEE_GO_ON,
 864         /* note: this entry _MUST_ be the last one in the enum */
 865         OPT_ARG_ARRAY_SIZE,
 866 };
 867
 868 AST_APP_OPTIONS(bridge_exec_options, BEGIN_OPTIONS
 869         AST_APP_OPTION('p', BRIDGE_OPT_PLAYTONE),
 870         AST_APP_OPTION_ARG('F', OPT_CALLEE_GO_ON, OPT_ARG_CALLEE_GO_ON),
 871         AST_APP_OPTION('h', OPT_CALLEE_HANGUP),
 872         AST_APP_OPTION('H', OPT_CALLER_HANGUP),
 873         AST_APP_OPTION('k', OPT_CALLEE_PARK),
 874         AST_APP_OPTION('K', OPT_CALLER_PARK),
 875         AST_APP_OPTION_ARG('L', OPT_DURATION_LIMIT, OPT_ARG_DURATION_LIMIT),
 876         AST_APP_OPTION_ARG('S', OPT_DURATION_STOP, OPT_ARG_DURATION_STOP),
 877         AST_APP_OPTION('t', OPT_CALLEE_TRANSFER),
 878         AST_APP_OPTION('T', OPT_CALLER_TRANSFER),
 879         AST_APP_OPTION('w', OPT_CALLEE_MONITOR),
 880         AST_APP_OPTION('W', OPT_CALLER_MONITOR),
 881         AST_APP_OPTION('x', OPT_CALLEE_KILL),
 882 END_OPTIONS );
 883
 884 int ast_bridge_timelimit(struct ast_channel *chan, struct ast_bridge_config *config,
 885         char *parse, struct timeval *calldurationlimit)
 886 {
 887         char *stringp = ast_strdupa(parse);
 888         char *limit_str, *warning_str, *warnfreq_str;
 889         const char *var;
 890         int play_to_caller = 0, play_to_callee = 0;
 891         int delta;
 892
 893         limit_str = strsep(&stringp, ":");
 894         warning_str = strsep(&stringp, ":");
 895         warnfreq_str = strsep(&stringp, ":");
 896
 897         config->timelimit = atol(limit_str);
 898         if (warning_str)
 899                 config->play_warning = atol(warning_str);
 900         if (warnfreq_str)
 901                 config->warning_freq = atol(warnfreq_str);
 902
 903         if (!config->timelimit) {
 904                 ast_log(LOG_WARNING, "Bridge does not accept L(%s), hanging up.\n", limit_str);
 905                 config->timelimit = config->play_warning = config->warning_freq = 0;
 906                 config->warning_sound = NULL;
 907                 return -1; /* error */
 908         } else if ( (delta = config->play_warning - config->timelimit) > 0) {
 909                 int w = config->warning_freq;
 910
 911                 /*
 912                  * If the first warning is requested _after_ the entire call
 913                  * would end, and no warning frequency is requested, then turn
 914                  * off the warning. If a warning frequency is requested, reduce
 915                  * the 'first warning' time by that frequency until it falls
 916                  * within the call's total time limit.
 917                  *
 918                  * Graphically:
 919                  *                timelim->|    delta        |<-playwarning
 920                  *      0__________________|_________________|
 921                  *                       | w  |    |    |    |
 922                  *
 923                  * so the number of intervals to cut is 1+(delta-1)/w
 924                  */
 925                 if (w == 0) {
 926                         config->play_warning = 0;
 927                 } else {
 928                         config->play_warning -= w * ( 1 + (delta-1)/w );
 929                         if (config->play_warning < 1)
 930                                 config->play_warning = config->warning_freq = 0;
 931                 }
 932         }
 933
 934         ast_channel_lock(chan);
 935
 936         var = pbx_builtin_getvar_helper(chan, "LIMIT_PLAYAUDIO_CALLER");
 937         play_to_caller = var ? ast_true(var) : 1;
 938
 939         var = pbx_builtin_getvar_helper(chan, "LIMIT_PLAYAUDIO_CALLEE");
 940         play_to_callee = var ? ast_true(var) : 0;
 941
 942         if (!play_to_caller && !play_to_callee)
 943                 play_to_caller = 1;
 944
 945         var = pbx_builtin_getvar_helper(chan, "LIMIT_WARNING_FILE");
 946         config->warning_sound = !ast_strlen_zero(var) ? ast_strdup(var) : ast_strdup("timeleft");
 947
 948         /* The code looking at config wants a NULL, not just "", to decide
 949          * that the message should not be played, so we replace "" with NULL.
 950          * Note, pbx_builtin_getvar_helper _can_ return NULL if the variable is
 951          * not found.
 952          */
 953
 954         var = pbx_builtin_getvar_helper(chan, "LIMIT_TIMEOUT_FILE");
 955         config->end_sound = !ast_strlen_zero(var) ? ast_strdup(var) : NULL;
 956
 957         var = pbx_builtin_getvar_helper(chan, "LIMIT_CONNECT_FILE");
 958         config->start_sound = !ast_strlen_zero(var) ? ast_strdup(var) : NULL;
 959
 960         ast_channel_unlock(chan);
 961
 962         /* undo effect of S(x) in case they are both used */
 963         calldurationlimit->tv_sec = 0;
 964         calldurationlimit->tv_usec = 0;
 965
 966         /* more efficient to do it like S(x) does since no advanced opts */
 967         if (!config->play_warning && !config->start_sound && !config->end_sound && config->timelimit) {
 968                 calldurationlimit->tv_sec = config->timelimit / 1000;
 969                 calldurationlimit->tv_usec = (config->timelimit % 1000) * 1000;
 970                 ast_verb(3, "Setting call duration limit to %.3lf seconds.\n",
 971                         calldurationlimit->tv_sec + calldurationlimit->tv_usec / 1000000.0);
 972                 play_to_caller = 0;
 973                 play_to_callee = 0;
 974                 config->timelimit = 0;
 975                 config->play_warning = 0;
 976                 config->warning_freq = 0;
 977         } else {
 978                 ast_verb(4, "Limit Data for this call:\n");
 979                 ast_verb(4, "timelimit      = %ld ms (%.3lf s)\n", config->timelimit, config->timelimit / 1000.0);
 980                 ast_verb(4, "play_warning   = %ld ms (%.3lf s)\n", config->play_warning, config->play_warning / 1000.0);
 981                 ast_verb(4, "play_to_caller = %s\n", play_to_caller ? "yes" : "no");
 982                 ast_verb(4, "play_to_callee = %s\n", play_to_callee ? "yes" : "no");
 983                 ast_verb(4, "warning_freq   = %ld ms (%.3lf s)\n", config->warning_freq, config->warning_freq / 1000.0);
 984                 ast_verb(4, "start_sound    = %s\n", S_OR(config->start_sound, ""));
 985                 ast_verb(4, "warning_sound  = %s\n", config->warning_sound);
 986                 ast_verb(4, "end_sound      = %s\n", S_OR(config->end_sound, ""));
 987         }
 988         if (play_to_caller)
 989                 ast_set_flag(&(config->features_caller), AST_FEATURE_PLAY_WARNING);
 990         if (play_to_callee)
 991                 ast_set_flag(&(config->features_callee), AST_FEATURE_PLAY_WARNING);
 992         return 0;
 993 }
 994
 995
 996 /*!
 997  * \brief Bridge channels
 998  * \param chan
 999  * \param data channel to bridge with.
1000  *
1001  * Split data, check we aren't bridging with ourself, check valid channel,
1002  * answer call if not already, check compatible channels, setup bridge config
1003  * now bridge call, if transfered party hangs up return to PBX extension.
1004  */
1005 static int bridge_exec(struct ast_channel *chan, const char *data)
1006 {
1007         RAII_VAR(struct ast_channel *, current_dest_chan, NULL, ao2_cleanup);
1008         char *tmp_data  = NULL;
1009         struct ast_flags opts = { 0, };
1010         struct ast_bridge_config bconfig = { { 0, }, };
1011         char *opt_args[OPT_ARG_ARRAY_SIZE];
1012         struct timeval calldurationlimit = { 0, };
1013         const char *context;
1014         const char *extension;
1015         int priority;
1016         struct ast_bridge_features chan_features;
1017         struct ast_bridge_features *peer_features;
1018         struct ast_bridge *bridge;
1019         RAII_VAR(struct ast_features_xfer_config *, xfer_cfg, NULL, ao2_cleanup);
1020
1021         AST_DECLARE_APP_ARGS(args,
1022                 AST_APP_ARG(dest_chan);
1023                 AST_APP_ARG(options);
1024         );
1025
1026         if (ast_strlen_zero(data)) {
1027                 ast_log(LOG_WARNING, "Bridge require at least 1 argument specifying the other end of the bridge\n");
1028                 return -1;
1029         }
1030
1031         tmp_data = ast_strdupa(data);
1032         AST_STANDARD_APP_ARGS(args, tmp_data);
1033         if (!ast_strlen_zero(args.options))
1034                 ast_app_parse_options(bridge_exec_options, &opts, opt_args, args.options);
1035
1036         /* make sure we have a valid end point */
1037         if (!(current_dest_chan = ast_channel_get_by_name_prefix(args.dest_chan,
1038                         strlen(args.dest_chan)))) {
1039                 ast_log(LOG_WARNING, "Bridge failed because channel %s does not exist\n",
1040                         args.dest_chan);
1041                 return 0;
1042         }
1043
1044         /* avoid bridge with ourselves */
1045         if (chan == current_dest_chan) {
1046                 ast_log(LOG_WARNING, "Unable to bridge channel %s with itself\n", ast_channel_name(chan));
1047                 return 0;
1048         }
1049
1050         if (ast_test_flag(&opts, OPT_DURATION_LIMIT)
1051                 && !ast_strlen_zero(opt_args[OPT_ARG_DURATION_LIMIT])
1052                 && ast_bridge_timelimit(chan, &bconfig, opt_args[OPT_ARG_DURATION_LIMIT], &calldurationlimit)) {
1053                 pbx_builtin_setvar_helper(chan, "BRIDGERESULT", "FAILURE");
1054                 goto done;
1055         }
1056
1057         if (ast_test_flag(&opts, OPT_CALLEE_TRANSFER))
1058                 ast_set_flag(&(bconfig.features_callee), AST_FEATURE_REDIRECT);
1059         if (ast_test_flag(&opts, OPT_CALLER_TRANSFER))
1060                 ast_set_flag(&(bconfig.features_caller), AST_FEATURE_REDIRECT);
1061         if (ast_test_flag(&opts, OPT_CALLEE_HANGUP))
1062                 ast_set_flag(&(bconfig.features_callee), AST_FEATURE_DISCONNECT);
1063         if (ast_test_flag(&opts, OPT_CALLER_HANGUP))
1064                 ast_set_flag(&(bconfig.features_caller), AST_FEATURE_DISCONNECT);
1065         if (ast_test_flag(&opts, OPT_CALLEE_MONITOR))
1066                 ast_set_flag(&(bconfig.features_callee), AST_FEATURE_AUTOMON);
1067         if (ast_test_flag(&opts, OPT_CALLER_MONITOR))
1068                 ast_set_flag(&(bconfig.features_caller), AST_FEATURE_AUTOMON);
1069         if (ast_test_flag(&opts, OPT_CALLEE_PARK))
1070                 ast_set_flag(&(bconfig.features_callee), AST_FEATURE_PARKCALL);
1071         if (ast_test_flag(&opts, OPT_CALLER_PARK))
1072                 ast_set_flag(&(bconfig.features_caller), AST_FEATURE_PARKCALL);
1073
1074         /* Setup after bridge goto location. */
1075         if (ast_test_flag(&opts, OPT_CALLEE_GO_ON)) {
1076                 ast_channel_lock(chan);
1077                 context = ast_strdupa(ast_channel_context(chan));
1078                 extension = ast_strdupa(ast_channel_exten(chan));
1079                 priority = ast_channel_priority(chan);
1080                 ast_channel_unlock(chan);
1081                 ast_bridge_set_after_go_on(current_dest_chan, context, extension, priority,
1082                         opt_args[OPT_ARG_CALLEE_GO_ON]);
1083         } else if (!ast_test_flag(&opts, OPT_CALLEE_KILL)) {
1084                 ast_channel_lock(current_dest_chan);
1085                 context = ast_strdupa(ast_channel_context(current_dest_chan));
1086                 extension = ast_strdupa(ast_channel_exten(current_dest_chan));
1087                 priority = ast_channel_priority(current_dest_chan);
1088                 ast_channel_unlock(current_dest_chan);
1089                 ast_bridge_set_after_goto(current_dest_chan, context, extension, priority);
1090         }
1091
1092         if (ast_bridge_features_init(&chan_features)) {
1093                 ast_bridge_features_cleanup(&chan_features);
1094                 goto done;
1095         }
1096
1097         peer_features = ast_bridge_features_new();
1098         if (!peer_features) {
1099                 ast_bridge_features_cleanup(&chan_features);
1100                 goto done;
1101         }
1102
1103         if (pre_bridge_setup(chan, current_dest_chan, &bconfig, &chan_features, peer_features)) {
1104                 ast_bridge_features_destroy(peer_features);
1105                 ast_bridge_features_cleanup(&chan_features);
1106                 goto done;
1107         }
1108
1109         bridge = ast_bridge_basic_new();
1110         if (!bridge) {
1111                 ast_bridge_features_destroy(peer_features);
1112                 ast_bridge_features_cleanup(&chan_features);
1113                 goto done;
1114         }
1115
1116         xfer_cfg = ast_get_chan_features_xfer_config(current_dest_chan);
1117         if (ast_bridge_add_channel(bridge, current_dest_chan, peer_features,
1118                 ast_test_flag(&opts, BRIDGE_OPT_PLAYTONE), xfer_cfg ? xfer_cfg->xfersound : NULL)) {
1119                 ast_bridge_features_destroy(peer_features);
1120                 ast_bridge_features_cleanup(&chan_features);
1121                 ast_bridge_destroy(bridge);
1122                 goto done;
1123         }
1124
1125         ast_bridge_join(bridge, chan, NULL, &chan_features, NULL, 1);
1126
1127         ast_bridge_features_cleanup(&chan_features);
1128
1129         /* The bridge has ended, set BRIDGERESULT to SUCCESS. */
1130         pbx_builtin_setvar_helper(chan, "BRIDGERESULT", "SUCCESS");
1131 done:
1132         ast_free((char *) bconfig.warning_sound);
1133         ast_free((char *) bconfig.end_sound);
1134         ast_free((char *) bconfig.start_sound);
1135
1136         return 0;
1137 }
1138
1139 /*!
1140  * \internal
1141  * \brief Clean up resources on Asterisk shutdown
1142  */
1143 static void features_shutdown(void)
1144 {
1145         ast_features_config_shutdown();
1146
1147         ast_manager_unregister("Bridge");
1148
1149         ast_unregister_application(app_bridge);
1150
1151 }
1152
1153 int ast_features_init(void)
1154 {
1155         int res;
1156
1157         res = ast_features_config_init();
1158         if (res) {
1159                 return res;
1160         }
1161         res |= ast_register_application2(app_bridge, bridge_exec, NULL, NULL, NULL);
1162         res |= ast_manager_register_xml_core("Bridge", EVENT_FLAG_CALL, action_bridge);
1163
1164         if (res) {
1165                 features_shutdown();
1166         } else {
1167                 ast_register_atexit(features_shutdown);
1168         }
1169
1170         return res;
1171 }