addition of dynamic parkinglots feature

[asterisk/asterisk.git] / main / features.c

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 1999 - 2008, Digium, Inc.
 *
 * Mark Spencer <markster@digium.com>
 *
 * See http://www.asterisk.org for more information about
 * the Asterisk project. Please do not directly contact
 * any of the maintainers of this project for assistance;
 * the project provides a web site, mailing lists and IRC
 * channels for your use.
 *
 * This program is free software, distributed under the terms of
 * the GNU General Public License Version 2. See the LICENSE file
 * at the top of the source tree.
 */

/*! \file
 *
 * \brief Routines implementing call features as call pickup, parking and transfer
 *
 * \author Mark Spencer <markster@digium.com> 
 */

#include "asterisk.h"

ASTERISK_FILE_VERSION(__FILE__, "$Revision$")

#include "asterisk/_private.h"

#include <pthread.h>
#include <sys/time.h>
#include <sys/signal.h>
#include <netinet/in.h>

#include "asterisk/lock.h"
#include "asterisk/file.h"
#include "asterisk/channel.h"
#include "asterisk/pbx.h"
#include "asterisk/causes.h"
#include "asterisk/module.h"
#include "asterisk/translate.h"
#include "asterisk/app.h"
#include "asterisk/say.h"
#include "asterisk/features.h"
#include "asterisk/musiconhold.h"
#include "asterisk/config.h"
#include "asterisk/cli.h"
#include "asterisk/manager.h"
#include "asterisk/utils.h"
#include "asterisk/adsi.h"
#include "asterisk/devicestate.h"
#include "asterisk/monitor.h"
#include "asterisk/audiohook.h"
#include "asterisk/global_datastores.h"
#include "asterisk/astobj2.h"
#include "asterisk/cel.h"

/*** DOCUMENTATION
        <application name="Bridge" language="en_US">
                <synopsis>
                        Bridge two channels.
                </synopsis>
                <syntax>
                        <parameter name="channel" required="true">
                                <para>The current channel is bridged to the specified <replaceable>channel</replaceable>.</para>
                        </parameter>
                        <parameter name="options">
                                <optionlist>
                                        <option name="p">
                                                <para>Play a courtesy tone to <replaceable>channel</replaceable>.</para>
                                        </option>
                                        <option name="h">
                                                <para>Allow the called party to hang up by sending the
                                                <replaceable>*</replaceable> DTMF digit.</para>
                                        </option>
                                        <option name="H">
                                                <para>Allow the calling party to hang up by pressing the
                                                <replaceable>*</replaceable> DTMF digit.</para>
                                        </option>
                                        <option name="k">
                                                <para>Allow the called party to enable parking of the call by sending
                                                the DTMF sequence defined for call parking in features.conf.</para>
                                        </option>
                                        <option name="K">
                                                <para>Allow the calling party to enable parking of the call by sending
                                                 the DTMF sequence defined for call parking in features.conf.</para>
                                        </option>
                                        <option name="L(x[:y][:z])">
                                                <para>Limit the call to <replaceable>x</replaceable> ms. Play a warning
                                                when <replaceable>y</replaceable> ms are left. Repeat the warning every
                                                <replaceable>z</replaceable> ms. The following special variables can be
                                                used with this option:</para>
                                                <variablelist>
                                                        <variable name="LIMIT_PLAYAUDIO_CALLER">
                                                                <para>Play sounds to the caller. yes|no (default yes)</para>
                                                        </variable>
                                                        <variable name="LIMIT_PLAYAUDIO_CALLEE">   
                                                                <para>Play sounds to the callee. yes|no</para>
                                                        </variable>
                                                        <variable name="LIMIT_TIMEOUT_FILE">
                                                                <para>File to play when time is up.</para>
                                                        </variable>
                                                        <variable name="LIMIT_CONNECT_FILE">
                                                                <para>File to play when call begins.</para>
                                                        </variable>
                                                        <variable name="LIMIT_WARNING_FILE">
                                                                <para>File to play as warning if <replaceable>y</replaceable> is
                                                                defined. The default is to say the time remaining.</para>
                                                        </variable>
                                                </variablelist>
                                        </option>
                                        <option name="S(x)">
                                                <para>Hang up the call after <replaceable>x</replaceable> seconds *after* the called party has answered the call.</para>
                                        </option>
                                        <option name="t">
                                                <para>Allow the called party to transfer the calling party by sending the
                                                DTMF sequence defined in features.conf.</para>
                                        </option>
                                        <option name="T">
                                                <para>Allow the calling party to transfer the called party by sending the
                                                DTMF sequence defined in features.conf.</para>
                                        </option>
                                        <option name="w">
                                                <para>Allow the called party to enable recording of the call by sending
                                                the DTMF sequence defined for one-touch recording in features.conf.</para>
                                        </option>
                                        <option name="W">
                                                <para>Allow the calling party to enable recording of the call by sending
                                                the DTMF sequence defined for one-touch recording in features.conf.</para>
                                        </option>
                                        <option name="x">
                                                <para>Cause the called party to be hung up after the bridge, instead of being
                                                restarted in the dialplan.</para>
                                        </option>
                                </optionlist>
                        </parameter>
                </syntax>
                <description>
                        <para>Allows the ability to bridge two channels via the dialplan.</para>
                        <para>This application sets the following channel variable upon completion:</para>
                        <variablelist>
                                <variable name="BRIDGERESULT">
                                        <para>The result of the bridge attempt as a text string.</para>
                                        <value name="SUCCESS" />
                                        <value name="FAILURE" />
                                        <value name="LOOP" />
                                        <value name="NONEXISTENT" />
                                        <value name="INCOMPATIBLE" />
                                </variable>
                        </variablelist>
                </description>
        </application>
        <application name="ParkedCall" language="en_US">
                <synopsis>
                        Answer a parked call.
                </synopsis>
                <syntax>
                        <parameter name="exten" required="true" />
                </syntax>
                <description>
                        <para>Used to connect to a parked call. This application is always
                        registered internally and does not need to be explicitly added
                        into the dialplan, although you should include the <literal>parkedcalls</literal>
                        context. If no extension is provided, then the first available
                        parked call will be acquired.</para>
                </description>
                <see-also>
                        <ref type="application">Park</ref>
                        <ref type="application">ParkAndAnnounce</ref>
                </see-also>
        </application>
        <application name="Park" language="en_US">
                <synopsis>
                        Park yourself.
                </synopsis>
                <syntax>
                        <parameter name="timeout">
                                <para>A custom parking timeout for this parked call.</para>
                        </parameter>
                        <parameter name="return_context">
                                <para>The context to return the call to after it times out.</para>
                        </parameter>
                        <parameter name="return_exten">
                                <para>The extension to return the call to after it times out.</para>
                        </parameter>
                        <parameter name="return_priority">
                                <para>The priority to return the call to after it times out.</para>
                        </parameter>
                        <parameter name="options">
                                <para>A list of options for this parked call.</para>
                                <optionlist>
                                        <option name="r">
                                                <para>Send ringing instead of MOH to the parked call.</para>
                                        </option>
                                        <option name="R">
                                                <para>Randomize the selection of a parking space.</para>
                                        </option>
                                        <option name="s">
                                                <para>Silence announcement of the parking space number.</para>
                                        </option>
                                </optionlist>
                        </parameter>
                </syntax>
                <description>
                        <para>Used to park yourself (typically in combination with a supervised
                        transfer to know the parking space). This application is always
                        registered internally and does not need to be explicitly added
                        into the dialplan, although you should include the <literal>parkedcalls</literal>
                        context (or the context specified in <filename>features.conf</filename>).</para>
                        <para>If you set the <variable>PARKINGEXTEN</variable> variable to an extension in your
                        parking context, Park() will park the call on that extension, unless
                        it already exists. In that case, execution will continue at next priority.</para>
                        <para>If you set the <variable>PARKINGLOT</variable> variable, Park() will park the call
                        in that parkinglot.</para>
                        <para>If you set the <variable>PARKINGDYNAMIC</variable> variable, this parkinglot from features.conf
                        will be used as template for the newly created dynamic lot.</para>
                        <para>If you set the <variable>PARKINGDYNCONTEXT</variable> variable the newly created dynamic
                        parking lot will use this context.</para>
                        <para>If you set the <variable>PARKINGDYNPOS</variable> variable the newly created dynamic parkinglot
                        will use those parking postitions.</para>
                </description>
                <see-also>
                        <ref type="application">ParkAndAnnounce</ref>
                        <ref type="application">ParkedCall</ref>
                </see-also>
        </application>
        <manager name="ParkedCalls" language="en_US">
                <synopsis>
                        List parked calls.
                </synopsis>
                <syntax>
                        <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
                </syntax>
                <description>
                        <para>List parked calls.</para>
                </description>
        </manager>
        <manager name="Park" language="en_US">
                <synopsis>
                        Park a channel.
                </synopsis>
                <syntax>
                        <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
                        <parameter name="Channel" required="true">
                                <para>Channel name to park.</para>
                        </parameter>
                        <parameter name="Channel2" required="true">
                                <para>Channel to announce park info to (and return to if timeout).</para>
                        </parameter>
                        <parameter name="Timeout">
                                <para>Number of milliseconds to wait before callback.</para>
                        </parameter>
                </syntax>
                <description>
                        <para>Park a channel.</para>
                </description>
        </manager>
        <manager name="Bridge" language="en_US">
                <synopsis>
                        Bridge two channels already in the PBX.
                </synopsis>
                <syntax>
                        <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
                        <parameter name="Channel1" required="true">
                                <para>Channel to Bridge to Channel2.</para>
                        </parameter>
                        <parameter name="Channel2" required="true">
                                <para>Channel to Bridge to Channel1.</para>
                        </parameter>
                        <parameter name="Tone">
                                <para>Play courtesy tone to Channel 2.</para>
                                <enumlist>
                                        <enum name="yes" />
                                        <enum name="no" />
                                </enumlist>
                        </parameter>
                </syntax>
                <description>
                        <para>Bridge together two channels already in the PBX.</para>
                </description>
        </manager>
 ***/

#define DEFAULT_PARK_TIME 45000
#define DEFAULT_TRANSFER_DIGIT_TIMEOUT 3000
#define DEFAULT_FEATURE_DIGIT_TIMEOUT 1000
#define DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER 15000
#define DEFAULT_PARKINGLOT "default"                    /*!< Default parking lot */
#define DEFAULT_ATXFER_DROP_CALL 0
#define DEFAULT_ATXFER_LOOP_DELAY 10000
#define DEFAULT_ATXFER_CALLBACK_RETRIES 2

#define AST_MAX_WATCHERS 256
#define MAX_DIAL_FEATURE_OPTIONS 30

struct feature_group_exten {
        AST_LIST_ENTRY(feature_group_exten) entry;
        AST_DECLARE_STRING_FIELDS(
                AST_STRING_FIELD(exten);
        );
        struct ast_call_feature *feature;
};

struct feature_group {
        AST_LIST_ENTRY(feature_group) entry;
        AST_DECLARE_STRING_FIELDS(
                AST_STRING_FIELD(gname);
        );
        AST_LIST_HEAD_NOLOCK(, feature_group_exten) features;
};

static AST_RWLIST_HEAD_STATIC(feature_groups, feature_group);

static char *parkedcall = "ParkedCall";

static char pickup_ext[AST_MAX_EXTENSION];                 /*!< Call pickup extension */

/*! \brief Description of one parked call, added to a list while active, then removed.
        The list belongs to a parkinglot 
*/
struct parkeduser {
        struct ast_channel *chan;                   /*!< Parking channel */
        struct timeval start;                       /*!< Time the parking started */
        int parkingnum;                             /*!< Parking lot */
        char parkingexten[AST_MAX_EXTENSION];       /*!< If set beforehand, parking extension used for this call */
        char context[AST_MAX_CONTEXT];              /*!< Where to go if our parking time expires */
        char exten[AST_MAX_EXTENSION];
        int priority;
        int parkingtime;                            /*!< Maximum length in parking lot before return */
        unsigned int notquiteyet:1;
        unsigned int options_specified:1;
        char peername[1024];
        unsigned char moh_trys;
        struct ast_parkinglot *parkinglot;
        AST_LIST_ENTRY(parkeduser) list;
};

/*! \brief Structure for parking lots which are put in a container. */
struct ast_parkinglot {
        char name[AST_MAX_CONTEXT];
        char parking_con[AST_MAX_EXTENSION];            /*!< Context for which parking is made accessible */
        char parking_con_dial[AST_MAX_EXTENSION];       /*!< Context for dialback for parking (KLUDGE) */
        int parking_start;                              /*!< First available extension for parking */
        int parking_stop;                               /*!< Last available extension for parking */
        int parking_offset;
        int parkfindnext;
        int parkingtime;                                /*!< Default parking time */
        char mohclass[MAX_MUSICCLASS];                  /*!< Music class used for parking */
        int parkaddhints;                               /*!< Add parking hints automatically */
        int parkedcalltransfers;                        /*!< Enable DTMF based transfers on bridge when picking up parked calls */
        int parkedcallreparking;                        /*!< Enable DTMF based parking on bridge when picking up parked calls */
        int parkedcallhangup;                           /*!< Enable DTMF based hangup on a bridge when pickup up parked calls */
        int parkedcallrecording;                        /*!< Enable DTMF based recording on a bridge when picking up parked calls */
        AST_LIST_HEAD(parkinglot_parklist, parkeduser) parkings; /*!< List of active parkings in this parkinglot */
};

/*! \brief The list of parking lots configured. Always at least one  - the default parking lot */
static struct ao2_container *parkinglots;
 
struct ast_parkinglot *default_parkinglot;
char parking_ext[AST_MAX_EXTENSION];            /*!< Extension you type to park the call */

static char courtesytone[256];                             /*!< Courtesy tone */
static int parkedplay = 0;                                 /*!< Who to play the courtesy tone to */
static int parkeddynamic = 0;                              /*!< Enable creation of parkinglots dynamically */
static char xfersound[256];                                /*!< Call transfer sound */
static char xferfailsound[256];                            /*!< Call transfer failure sound */
static char pickupsound[256];                              /*!< Pickup sound */
static char pickupfailsound[256];                          /*!< Pickup failure sound */

static int adsipark;

static int transferdigittimeout;
static int featuredigittimeout;
static int comebacktoorigin = 1;

static int atxfernoanswertimeout;
static unsigned int atxferdropcall;
static unsigned int atxferloopdelay;
static unsigned int atxfercallbackretries;

static char *registrar = "features";               /*!< Registrar for operations */

/* module and CLI command definitions */
static char *parkcall = PARK_APP_NAME;

static struct ast_app *monitor_app = NULL;
static int monitor_ok = 1;

static struct ast_app *mixmonitor_app = NULL;
static int mixmonitor_ok = 1;

static struct ast_app *stopmixmonitor_app = NULL;
static int stopmixmonitor_ok = 1;

static pthread_t parking_thread;
struct ast_dial_features {
        struct ast_flags features_caller;
        struct ast_flags features_callee;
        int is_caller;
};

static void *dial_features_duplicate(void *data)
{
        struct ast_dial_features *df = data, *df_copy;
 
        if (!(df_copy = ast_calloc(1, sizeof(*df)))) {
                return NULL;
        }
 
        memcpy(df_copy, df, sizeof(*df));
 
        return df_copy;
}

static void dial_features_destroy(void *data)
{
        struct ast_dial_features *df = data;
        if (df) {
                ast_free(df);
        }
}

static const struct ast_datastore_info dial_features_info = {
        .type = "dial-features",
        .destroy = dial_features_destroy,
        .duplicate = dial_features_duplicate,
 };
 
/* Forward declarations */
static struct ast_parkinglot *parkinglot_addref(struct ast_parkinglot *parkinglot);
static void parkinglot_unref(struct ast_parkinglot *parkinglot);
static void parkinglot_destroy(void *obj);
int manage_parkinglot(struct ast_parkinglot *curlot, fd_set *rfds, fd_set *efds, fd_set *nrfds, fd_set *nefds, int *fs, int *max);
struct ast_parkinglot *find_parkinglot(const char *name);
static struct ast_parkinglot *create_parkinglot(const char *name);
static struct ast_parkinglot *copy_parkinglot(const char *name, const struct ast_parkinglot *parkinglot);

const char *ast_parking_ext(void)
{
        return parking_ext;
}

const char *ast_pickup_ext(void)
{
        return pickup_ext;
}

struct ast_bridge_thread_obj 
{
        struct ast_bridge_config bconfig;
        struct ast_channel *chan;
        struct ast_channel *peer;
        unsigned int return_to_pbx:1;
};

static int parkinglot_hash_cb(const void *obj, const int flags)
{
        const struct ast_parkinglot *parkinglot = obj;

        return ast_str_case_hash(parkinglot->name);
}

static int parkinglot_cmp_cb(void *obj, void *arg, int flags)
{
        struct ast_parkinglot *parkinglot = obj, *parkinglot2 = arg;

        return !strcasecmp(parkinglot->name, parkinglot2->name) ? CMP_MATCH | CMP_STOP : 0;
}

/*!
 * \brief store context, extension and priority 
 * \param chan, context, ext, pri
*/
static void set_c_e_p(struct ast_channel *chan, const char *context, const char *ext, int pri)
{
        ast_copy_string(chan->context, context, sizeof(chan->context));
        ast_copy_string(chan->exten, ext, sizeof(chan->exten));
        chan->priority = pri;
}

/*!
 * \brief Check goto on transfer
 * \param chan
 *
 * Check if channel has 'GOTO_ON_BLINDXFR' set, if not exit.
 * When found make sure the types are compatible. Check if channel is valid
 * if so start the new channel else hangup the call. 
*/
static void check_goto_on_transfer(struct ast_channel *chan) 
{
        struct ast_channel *xferchan;
        const char *val = pbx_builtin_getvar_helper(chan, "GOTO_ON_BLINDXFR");
        char *x, *goto_on_transfer;
        struct ast_frame *f;

        if (ast_strlen_zero(val))
                return;

        goto_on_transfer = ast_strdupa(val);

        if (!(xferchan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, "", "", "", chan->linkedid, 0, "%s", chan->name)))
                return;

        for (x = goto_on_transfer; x && *x; x++) {
                if (*x == '^')
                        *x = '|';
        }
        /* Make formats okay */
        xferchan->readformat = chan->readformat;
        xferchan->writeformat = chan->writeformat;
        ast_channel_masquerade(xferchan, chan);
        ast_parseable_goto(xferchan, goto_on_transfer);
        xferchan->_state = AST_STATE_UP;
        ast_clear_flag(xferchan, AST_FLAGS_ALL);        
        xferchan->_softhangup = 0;
        if ((f = ast_read(xferchan))) {
                ast_frfree(f);
                f = NULL;
                ast_pbx_start(xferchan);
        } else {
                ast_hangup(xferchan);
        }
}

static struct ast_channel *feature_request_and_dial(struct ast_channel *caller, struct ast_channel *transferee, const char *type, int format, void *data, int timeout, int *outstate, const char *cid_num, const char *cid_name, int igncallerstate, const char *language);

/*!
 * \brief bridge the call 
 * \param data thread bridge.
 *
 * Set Last Data for respective channels, reset cdr for channels
 * bridge call, check if we're going back to dialplan
 * if not hangup both legs of the call
*/
static void *bridge_call_thread(void *data)
{
        struct ast_bridge_thread_obj *tobj = data;
        int res;

        tobj->chan->appl = !tobj->return_to_pbx ? "Transferred Call" : "ManagerBridge";
        tobj->chan->data = tobj->peer->name;
        tobj->peer->appl = !tobj->return_to_pbx ? "Transferred Call" : "ManagerBridge";
        tobj->peer->data = tobj->chan->name;

        ast_bridge_call(tobj->peer, tobj->chan, &tobj->bconfig);

        if (tobj->return_to_pbx) {
                if (!ast_check_hangup(tobj->peer)) {
                        ast_log(LOG_VERBOSE, "putting peer %s into PBX again\n", tobj->peer->name);
                        res = ast_pbx_start(tobj->peer);
                        if (res != AST_PBX_SUCCESS)
                                ast_log(LOG_WARNING, "FAILED continuing PBX on peer %s\n", tobj->peer->name);
                } else
                        ast_hangup(tobj->peer);
                if (!ast_check_hangup(tobj->chan)) {
                        ast_log(LOG_VERBOSE, "putting chan %s into PBX again\n", tobj->chan->name);
                        res = ast_pbx_start(tobj->chan);
                        if (res != AST_PBX_SUCCESS)
                                ast_log(LOG_WARNING, "FAILED continuing PBX on chan %s\n", tobj->chan->name);
                } else
                        ast_hangup(tobj->chan);
        } else {
                ast_hangup(tobj->chan);
                ast_hangup(tobj->peer);
        }

        ast_free(tobj);

        return NULL;
}

/*!
 * \brief create thread for the parked call
 * \param data
 *
 * Create thread and attributes, call bridge_call_thread
*/
static void bridge_call_thread_launch(void *data) 
{
        pthread_t thread;
        pthread_attr_t attr;
        struct sched_param sched;

        pthread_attr_init(&attr);
        pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);
        ast_pthread_create(&thread, &attr, bridge_call_thread, data);
        pthread_attr_destroy(&attr);
        memset(&sched, 0, sizeof(sched));
        pthread_setschedparam(thread, SCHED_RR, &sched);
}

/*!
 * \brief Announce call parking by ADSI
 * \param chan .
 * \param parkingexten .
 * Create message to show for ADSI, display message.
 * \retval 0 on success.
 * \retval -1 on failure.
*/
static int adsi_announce_park(struct ast_channel *chan, char *parkingexten)
{
        int res;
        int justify[5] = {ADSI_JUST_CENT, ADSI_JUST_CENT, ADSI_JUST_CENT, ADSI_JUST_CENT};
        char tmp[256];
        char *message[5] = {NULL, NULL, NULL, NULL, NULL};

        snprintf(tmp, sizeof(tmp), "Parked on %s", parkingexten);
        message[0] = tmp;
        res = ast_adsi_load_session(chan, NULL, 0, 1);
        if (res == -1)
                return res;
        return ast_adsi_print(chan, message, justify, 1);
}

/*! \brief Find parking lot name from channel */
static const char *findparkinglotname(struct ast_channel *chan)
{
        const char *temp, *parkinglot = NULL;

        /* Check if the channel has a parking lot */
        if (!ast_strlen_zero(chan->parkinglot))
                parkinglot = chan->parkinglot;

        /* Channel variables override everything */

        if ((temp  = pbx_builtin_getvar_helper(chan, "PARKINGLOT")))
                return temp;

        return parkinglot;
}

/*! \brief Notify metermaids that we've changed an extension */
static void notify_metermaids(const char *exten, char *context, enum ast_device_state state)
{
        ast_debug(4, "Notification of state change to metermaids %s@%s\n to state '%s'", 
                exten, context, ast_devstate2str(state));

        ast_devstate_changed(state, "park:%s@%s", exten, context);
}

/*! \brief metermaids callback from devicestate.c */
static enum ast_device_state metermaidstate(const char *data)
{
        char *context;
        char *exten;

        context = ast_strdupa(data);

        exten = strsep(&context, "@");
        if (!context)
                return AST_DEVICE_INVALID;
        
        ast_debug(4, "Checking state of exten %s in context %s\n", exten, context);

        if (!ast_exists_extension(NULL, context, exten, 1, NULL))
                return AST_DEVICE_NOT_INUSE;

        return AST_DEVICE_INUSE;
}

/*! Options to pass to park_call_full */
enum ast_park_call_options {
        /*! Provide ringing to the parked caller instead of music on hold */
        AST_PARK_OPT_RINGING =   (1 << 0),
        /*! Randomly choose a parking spot for the caller instead of choosing
         *  the first one that is available. */
        AST_PARK_OPT_RANDOMIZE = (1 << 1),
        /*! Do not announce the parking number */
        AST_PARK_OPT_SILENCE = (1 << 2),
};

struct ast_park_call_args {
        /*! How long to wait in the parking lot before the call gets sent back
         *  to the specified return extension (or a best guess at where it came
         *  from if not explicitly specified). */
        int timeout;
        /*! An output parameter to store the parking space where the parked caller
         *  was placed. */
        int *extout;
        const char *orig_chan_name;
        const char *return_con;
        const char *return_ext;
        int return_pri;
        uint32_t flags;
        /*! Parked user that has already obtained a parking space */
        struct parkeduser *pu;
};

static struct parkeduser *park_space_reserve(struct ast_channel *chan, struct ast_channel *peer, struct ast_park_call_args *args)
{
        struct parkeduser *pu;
        int i, parking_space = -1, parking_range;
        const char *parkinglotname = NULL;
        const char *parkingexten;
        struct ast_parkinglot *parkinglot = NULL;

        if (peer)
                parkinglotname = findparkinglotname(peer);

        if (parkinglotname) {
                ast_debug(1, "Found chanvar Parkinglot: %s\n", parkinglotname);
                parkinglot = find_parkinglot(parkinglotname);

        }

        /* Dynamically create parkinglot */
        if (!parkinglot && parkeddynamic && !ast_strlen_zero(parkinglotname)) {
                const char *dyn_context, *dyn_range;
                const char *parkinglotname_copy = NULL;
                struct ast_parkinglot *parkinglot_copy = NULL;
                int dyn_start, dyn_end;

                ast_channel_lock(chan);
                parkinglotname_copy = ast_strdupa(S_OR(pbx_builtin_getvar_helper(chan, "PARKINGDYNAMIC"), ""));
                dyn_context = ast_strdupa(S_OR(pbx_builtin_getvar_helper(chan, "PARKINGDYNCONTEXT"), ""));
                dyn_range = ast_strdupa(S_OR(pbx_builtin_getvar_helper(chan, "PARKINGDYNPOS"), ""));
                ast_channel_unlock(chan);

                if (!ast_strlen_zero(parkinglotname_copy)) {
                        parkinglot_copy = find_parkinglot(parkinglotname_copy);
                }
                if (!parkinglot_copy) {
                        parkinglot_copy = parkinglot_addref(default_parkinglot);
                        ast_debug(1, "Using default parking lot for copy\n");
                }
                if (!(parkinglot = copy_parkinglot(parkinglotname, parkinglot_copy))) {
                        ast_log(LOG_ERROR, "Could not build dynamic parking lot!\n");
                } else {
                        if (!ast_strlen_zero(dyn_context)) {
                                ast_copy_string(parkinglot->parking_con, dyn_context, sizeof(parkinglot->parking_con));
                        }
                        if (!ast_strlen_zero(dyn_range)) {
                                if (sscanf(dyn_range, "%30d-%30d", &dyn_start, &dyn_end) != 2) {
                                        ast_log(LOG_WARNING, "Format for parking positions is a-b, where a and b are numbers\n");
                                } else {
                                        parkinglot->parking_start = dyn_start;
                                        parkinglot->parking_stop = dyn_end;
                                }
                        }
                        ao2_link(parkinglots, parkinglot);
                }

                if (parkinglot_copy) {
                        /* unref our tempory copy */
                        parkinglot_unref(parkinglot_copy);
                        parkinglot_copy = NULL;
                }
        }

        if (!parkinglot) {
                parkinglot = parkinglot_addref(default_parkinglot);
        }

        if (option_debug)
                ast_log(LOG_DEBUG, "Parkinglot: %s\n", parkinglot->name);

        /* Allocate memory for parking data */
        if (!(pu = ast_calloc(1, sizeof(*pu)))) {
                parkinglot_unref(parkinglot);
                return NULL;
        }

        /* Lock parking list */
        AST_LIST_LOCK(&parkinglot->parkings);
        /* Check for channel variable PARKINGEXTEN */
        ast_channel_lock(chan);
        parkingexten = ast_strdupa(S_OR(pbx_builtin_getvar_helper(chan, "PARKINGEXTEN"), ""));
        ast_channel_unlock(chan);
        if (!ast_strlen_zero(parkingexten)) {
                /*!\note The API forces us to specify a numeric parking slot, even
                 * though the architecture would tend to support non-numeric extensions
                 * (as are possible with SIP, for example).  Hence, we enforce that
                 * limitation here.  If extout was not numeric, we could permit
                 * arbitrary non-numeric extensions.
                 */
        if (sscanf(parkingexten, "%30d", &parking_space) != 1 || parking_space < 0) {
                        AST_LIST_UNLOCK(&parkinglot->parkings);
                        parkinglot_unref(parkinglot);
            free(pu);
            ast_log(LOG_WARNING, "PARKINGEXTEN does not indicate a valid parking slot: '%s'.\n", parkingexten);
            return NULL;
        }
        snprintf(pu->parkingexten, sizeof(pu->parkingexten), "%d", parking_space);

                if (ast_exists_extension(NULL, parkinglot->parking_con, pu->parkingexten, 1, NULL)) {
                        ast_log(LOG_WARNING, "Requested parking extension already exists: %s@%s\n", parkingexten, parkinglot->parking_con);
                        AST_LIST_UNLOCK(&parkinglot->parkings);
                        parkinglot_unref(parkinglot);
                        ast_free(pu);
                        return NULL;
                }
        } else {
                int start;
                struct parkeduser *cur = NULL;

                /* Select parking space within range */
                parking_range = parkinglot->parking_stop - parkinglot->parking_start + 1;

                if (ast_test_flag(args, AST_PARK_OPT_RANDOMIZE)) {
                        start = ast_random() % (parkinglot->parking_stop - parkinglot->parking_start + 1);
                } else {
                        start = parkinglot->parking_start;
                }

                for (i = start; 1; i++) {
                        if (i == parkinglot->parking_stop + 1) {
                                i = parkinglot->parking_start - 1;
                                break;
                        }

                        AST_LIST_TRAVERSE(&parkinglot->parkings, cur, list) {
                                if (cur->parkingnum == i) {
                                        break;
                                }
                        }
                        if (!cur) {
                                parking_space = i;
                                break;
                        }
                }

                if (i == start - 1 && cur) {
                        ast_log(LOG_WARNING, "No more parking spaces\n");
                        ast_free(pu);
                        AST_LIST_UNLOCK(&parkinglot->parkings);
                        parkinglot_unref(parkinglot);
                        return NULL;
                }
                /* Set pointer for next parking */
                if (parkinglot->parkfindnext) 
                        parkinglot->parking_offset = parking_space - parkinglot->parking_start + 1;
                snprintf(pu->parkingexten, sizeof(pu->parkingexten), "%d", parking_space);
        }

        pu->notquiteyet = 1;
        pu->parkingnum = parking_space;
        pu->parkinglot = parkinglot_addref(parkinglot);
        AST_LIST_INSERT_TAIL(&parkinglot->parkings, pu, list);
        parkinglot_unref(parkinglot);

        return pu;
}

/* Park a call */
static int park_call_full(struct ast_channel *chan, struct ast_channel *peer, struct ast_park_call_args *args)
{
        struct ast_context *con;
        int parkingnum_copy;
        struct parkeduser *pu = args->pu;
        const char *event_from;

        if (pu == NULL)
                pu = park_space_reserve(chan, peer, args);
        if (pu == NULL)
                return 1; /* Continue execution if possible */

        snprintf(pu->parkingexten, sizeof(pu->parkingexten), "%d", pu->parkingnum);
        
        chan->appl = "Parked Call";
        chan->data = NULL; 

        pu->chan = chan;
        
        /* Put the parked channel on hold if we have two different channels */
        if (chan != peer) {
                if (ast_test_flag(args, AST_PARK_OPT_RINGING)) {
                        ast_indicate(pu->chan, AST_CONTROL_RINGING);
                } else {
                        ast_indicate_data(pu->chan, AST_CONTROL_HOLD, 
                                S_OR(pu->parkinglot->mohclass, NULL),
                                !ast_strlen_zero(pu->parkinglot->mohclass) ? strlen(pu->parkinglot->mohclass) + 1 : 0);
                }
        }
        
        pu->start = ast_tvnow();
        pu->parkingtime = (args->timeout > 0) ? args->timeout : pu->parkinglot->parkingtime;
        parkingnum_copy = pu->parkingnum;
        if (args->extout)
                *(args->extout) = pu->parkingnum;

        if (peer) { 
                /* This is so ugly that it hurts, but implementing get_base_channel() on local channels
                        could have ugly side effects.  We could have transferer<->local,1<->local,2<->parking
                        and we need the callback name to be that of transferer.  Since local,1/2 have the same
                        name we can be tricky and just grab the bridged channel from the other side of the local
                */
                if (!strcasecmp(peer->tech->type, "Local")) {
                        struct ast_channel *tmpchan, *base_peer;
                        char other_side[AST_CHANNEL_NAME];
                        char *c;
                        ast_copy_string(other_side, S_OR(args->orig_chan_name, peer->name), sizeof(other_side));
                        if ((c = strrchr(other_side, ';'))) {
                                *++c = '1';
                        }
                        if ((tmpchan = ast_channel_get_by_name(other_side))) {
                                ast_channel_lock(tmpchan);
                                if ((base_peer = ast_bridged_channel(tmpchan))) {
                                        ast_copy_string(pu->peername, base_peer->name, sizeof(pu->peername));
                                }
                                ast_channel_unlock(tmpchan);
                                tmpchan = ast_channel_unref(tmpchan);
                        }
                } else {
                        ast_copy_string(pu->peername, S_OR(args->orig_chan_name, peer->name), sizeof(pu->peername));
                }
        }

        /* Remember what had been dialed, so that if the parking
           expires, we try to come back to the same place */

        pu->options_specified = (!ast_strlen_zero(args->return_con) || !ast_strlen_zero(args->return_ext) || args->return_pri);

        /* If extension has options specified, they override all other possibilities
        such as the returntoorigin flag and transferred context. Information on
        extension options is lost here, so we set a flag */

        ast_copy_string(pu->context, 
                S_OR(args->return_con, S_OR(chan->macrocontext, chan->context)), 
                sizeof(pu->context));
        ast_copy_string(pu->exten, 
                S_OR(args->return_ext, S_OR(chan->macroexten, chan->exten)), 
                sizeof(pu->exten));
        pu->priority = args->return_pri ? args->return_pri : 
                (chan->macropriority ? chan->macropriority : chan->priority);

        /* If parking a channel directly, don't quiet yet get parking running on it.
         * All parking lot entries are put into the parking lot with notquiteyet on. */
        if (peer != chan) 
                pu->notquiteyet = 0;

        /* Wake up the (presumably select()ing) thread */
        pthread_kill(parking_thread, SIGURG);
        ast_verb(2, "Parked %s on %d (lot %s). Will timeout back to extension [%s] %s, %d in %d seconds\n", pu->chan->name, pu->parkingnum, pu->parkinglot->name, pu->context, pu->exten, pu->priority, (pu->parkingtime/1000));

        ast_cel_report_event(pu->chan, AST_CEL_PARK_START, NULL, pu->parkinglot->name, peer);

        if (peer) {
                event_from = peer->name;
        } else {
                event_from = pbx_builtin_getvar_helper(chan, "BLINDTRANSFER");
        }

        ast_manager_event(pu->chan, EVENT_FLAG_CALL, "ParkedCall",
                "Exten: %s\r\n"
                "Channel: %s\r\n"
                "Parkinglot: %s\r\n"
                "From: %s\r\n"
                "Timeout: %ld\r\n"
                "CallerIDNum: %s\r\n"
                "CallerIDName: %s\r\n"
                "Uniqueid: %s\r\n",
                pu->parkingexten, pu->chan->name, pu->parkinglot->name, event_from ? event_from : "",
                (long)pu->start.tv_sec + (long)(pu->parkingtime/1000) - (long)time(NULL),
                S_OR(pu->chan->cid.cid_num, "<unknown>"),
                S_OR(pu->chan->cid.cid_name, "<unknown>"),
                pu->chan->uniqueid
                );

        if (peer && adsipark && ast_adsi_available(peer)) {
                adsi_announce_park(peer, pu->parkingexten);     /* Only supports parking numbers */
                ast_adsi_unload_session(peer);
        }

        con = ast_context_find_or_create(NULL, NULL, pu->parkinglot->parking_con, registrar);
        if (!con)       /* Still no context? Bad */
                ast_log(LOG_ERROR, "Parking context '%s' does not exist and unable to create\n", pu->parkinglot->parking_con);
        if (con) {
                if (!ast_add_extension2(con, 1, pu->parkingexten, 1, NULL, NULL, parkedcall, ast_strdup(pu->parkingexten), ast_free_ptr, registrar))
                        notify_metermaids(pu->parkingexten, pu->parkinglot->parking_con, AST_DEVICE_INUSE);
        }

        AST_LIST_UNLOCK(&pu->parkinglot->parkings);

        /* Only say number if it's a number and the channel hasn't been masqueraded away */
        if (peer && !ast_test_flag(args, AST_PARK_OPT_SILENCE) && (ast_strlen_zero(args->orig_chan_name) || !strcasecmp(peer->name, args->orig_chan_name))) {
                /* If a channel is masqueraded into peer while playing back the parking slot number do not continue playing it back. This is the case if an attended transfer occurs. */
                ast_set_flag(peer, AST_FLAG_MASQ_NOSTREAM);
                /* Tell the peer channel the number of the parking space */
                ast_say_digits(peer, pu->parkingnum, "", peer->language);
                ast_clear_flag(peer, AST_FLAG_MASQ_NOSTREAM);
        }
        if (peer == chan) { /* pu->notquiteyet = 1 */
                /* Wake up parking thread if we're really done */
                ast_indicate_data(pu->chan, AST_CONTROL_HOLD, 
                        S_OR(pu->parkinglot->mohclass, NULL),
                        !ast_strlen_zero(pu->parkinglot->mohclass) ? strlen(pu->parkinglot->mohclass) + 1 : 0);
                pu->notquiteyet = 0;
                pthread_kill(parking_thread, SIGURG);
        }
        return 0;
}

/*! \brief Park a call */
int ast_park_call(struct ast_channel *chan, struct ast_channel *peer, int timeout, int *extout)
{
        struct ast_park_call_args args = {
                .timeout = timeout,
                .extout = extout,
        };

        return park_call_full(chan, peer, &args);
}

static int masq_park_call(struct ast_channel *rchan, struct ast_channel *peer, int timeout, int *extout, int play_announcement, struct ast_park_call_args *args)
{
        struct ast_channel *chan;
        struct ast_frame *f;
        int park_status;
        struct ast_park_call_args park_args = {0,};

        if (!args) {
                args = &park_args;
                args->timeout = timeout;
                args->extout = extout;
        }

        if ((args->pu = park_space_reserve(rchan, peer, args)) == NULL) {
                if (peer)
                        ast_stream_and_wait(peer, "beeperr", "");
                return AST_FEATURE_RETURN_PARKFAILED;
        }

        /* Make a new, fake channel that we'll use to masquerade in the real one */
        if (!(chan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, rchan->accountcode, rchan->exten, rchan->context, rchan->linkedid, rchan->amaflags, "Parked/%s",rchan->name))) {
                ast_log(LOG_WARNING, "Unable to create parked channel\n");
                return -1;
        }

        /* Make formats okay */
        chan->readformat = rchan->readformat;
        chan->writeformat = rchan->writeformat;
        ast_channel_masquerade(chan, rchan);

        /* Setup the extensions and such */
        set_c_e_p(chan, rchan->context, rchan->exten, rchan->priority);

        /* Setup the macro extension and such */
        ast_copy_string(chan->macrocontext,rchan->macrocontext,sizeof(chan->macrocontext));
        ast_copy_string(chan->macroexten,rchan->macroexten,sizeof(chan->macroexten));
        chan->macropriority = rchan->macropriority;

        /* Make the masq execute */
        if ((f = ast_read(chan)))
                ast_frfree(f);

        if (peer == rchan) {
                peer = chan;
        }

        if (peer && (!play_announcement && args == &park_args)) {
                args->orig_chan_name = ast_strdupa(peer->name);
        }

        park_status = park_call_full(chan, peer, args);
        if (park_status == 1) {
        /* would be nice to play "invalid parking extension" */
                ast_hangup(chan);
                return -1;
        }

        return 0;
}

/* Park call via masquraded channel */
int ast_masq_park_call(struct ast_channel *rchan, struct ast_channel *peer, int timeout, int *extout)
{
        return masq_park_call(rchan, peer, timeout, extout, 0, NULL);
}

static int masq_park_call_announce_args(struct ast_channel *rchan, struct ast_channel *peer, struct ast_park_call_args *args)
{
        return masq_park_call(rchan, peer, 0, NULL, 1, args);
}

static int masq_park_call_announce(struct ast_channel *rchan, struct ast_channel *peer, int timeout, int *extout)
{
        return masq_park_call(rchan, peer, timeout, extout, 1, NULL);
}

/*! 
 * \brief set caller and callee according to the direction 
 * \param caller, callee, peer, chan, sense
 *
 * Detect who triggered feature and set callee/caller variables accordingly
*/
static void set_peers(struct ast_channel **caller, struct ast_channel **callee,
        struct ast_channel *peer, struct ast_channel *chan, int sense)
{
        if (sense == FEATURE_SENSE_PEER) {
                *caller = peer;
                *callee = chan;
        } else {
                *callee = peer;
                *caller = chan;
        }
}

/*! 
 * \brief support routing for one touch call parking
 * \param chan channel parking call
 * \param peer channel to be parked
 * \param config unsed
 * \param code unused
 * \param sense feature options
 *
 * \param data
 * Setup channel, set return exten,priority to 's,1'
 * answer chan, sleep chan, park call
*/
static int builtin_parkcall(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
{
        struct ast_channel *parker;
        struct ast_channel *parkee;
        int res = 0;

        set_peers(&parker, &parkee, peer, chan, sense);
        /* we used to set chan's exten and priority to "s" and 1
           here, but this generates (in some cases) an invalid
           extension, and if "s" exists, could errantly
           cause execution of extensions you don't expect. It
           makes more sense to let nature take its course
           when chan finishes, and let the pbx do its thing
           and hang up when the park is over.
        */
        if (chan->_state != AST_STATE_UP)
                res = ast_answer(chan);
        if (!res)
                res = ast_safe_sleep(chan, 1000);

        if (!res) { /* one direction used to call park_call.... */
                res = masq_park_call_announce(parkee, parker, 0, NULL);
                /* PBX should hangup zombie channel if a masquerade actually occurred (res=0) */
        }

        return res;
}

/*! \brief Play message to both caller and callee in bridged call, plays synchronously, autoservicing the
        other channel during the message, so please don't use this for very long messages
 */
static int play_message_in_bridged_call(struct ast_channel *caller_chan, struct ast_channel *callee_chan, const char *audiofile)
{
        /* First play for caller, put other channel on auto service */
        if (ast_autoservice_start(callee_chan))
                return -1;
        if (ast_stream_and_wait(caller_chan, audiofile, "")) {
                ast_log(LOG_WARNING, "Failed to play automon message!\n");
                ast_autoservice_stop(callee_chan);
                return -1;
        }
        if (ast_autoservice_stop(callee_chan))
                return -1;
        /* Then play for callee, put other channel on auto service */
        if (ast_autoservice_start(caller_chan))
                return -1;
        if (ast_stream_and_wait(callee_chan, audiofile, "")) {
                ast_log(LOG_WARNING, "Failed to play automon message !\n");
                ast_autoservice_stop(caller_chan);
                return -1;
        }
        if (ast_autoservice_stop(caller_chan))
                return -1;
        return(0);
}

/*!
 * \brief Monitor a channel by DTMF
 * \param chan channel requesting monitor
 * \param peer channel to be monitored
 * \param config
 * \param code
 * \param sense feature options
 *
 * \param data
 * Check monitor app enabled, setup channels, both caller/callee chans not null
 * get TOUCH_MONITOR variable for filename if exists, exec monitor app.
 * \retval AST_FEATURE_RETURN_SUCCESS on success.
 * \retval -1 on error.
*/
static int builtin_automonitor(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
{
        char *caller_chan_id = NULL, *callee_chan_id = NULL, *args = NULL, *touch_filename = NULL;
        int x = 0;
        size_t len;
        struct ast_channel *caller_chan, *callee_chan;
        const char *automon_message_start = NULL;
        const char *automon_message_stop = NULL;

        if (!monitor_ok) {
                ast_log(LOG_ERROR,"Cannot record the call. The monitor application is disabled.\n");
                return -1;
        }

        if (!monitor_app && !(monitor_app = pbx_findapp("Monitor"))) {
                monitor_ok = 0;
                ast_log(LOG_ERROR,"Cannot record the call. The monitor application is disabled.\n");
                return -1;
        }

        set_peers(&caller_chan, &callee_chan, peer, chan, sense);
        if (caller_chan) {      /* Find extra messages */
                automon_message_start = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR_MESSAGE_START");
                automon_message_stop = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR_MESSAGE_STOP");
        }

        if (!ast_strlen_zero(courtesytone)) {   /* Play courtesy tone if configured */
                if(play_message_in_bridged_call(caller_chan, callee_chan, courtesytone) == -1) {
                        return -1;
                }
        }
        
        if (callee_chan->monitor) {
                ast_verb(4, "User hit '%s' to stop recording call.\n", code);
                if (!ast_strlen_zero(automon_message_stop)) {
                        play_message_in_bridged_call(caller_chan, callee_chan, automon_message_stop);
                }
                callee_chan->monitor->stop(callee_chan, 1);
                return AST_FEATURE_RETURN_SUCCESS;
        }

        if (caller_chan && callee_chan) {
                const char *touch_format = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR_FORMAT");
                const char *touch_monitor = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR");
                const char *touch_monitor_prefix = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR_PREFIX");

                if (!touch_format)
                        touch_format = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MONITOR_FORMAT");

                if (!touch_monitor)
                        touch_monitor = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MONITOR");
        
                if (!touch_monitor_prefix)
                        touch_monitor_prefix = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MONITOR_PREFIX");
        
                if (touch_monitor) {
                        len = strlen(touch_monitor) + 50;
                        args = alloca(len);
                        touch_filename = alloca(len);
                        snprintf(touch_filename, len, "%s-%ld-%s", S_OR(touch_monitor_prefix, "auto"), (long)time(NULL), touch_monitor);
                        snprintf(args, len, "%s,%s,m", S_OR(touch_format, "wav"), touch_filename);
                } else {
                        caller_chan_id = ast_strdupa(S_OR(caller_chan->cid.cid_num, caller_chan->name));
                        callee_chan_id = ast_strdupa(S_OR(callee_chan->cid.cid_num, callee_chan->name));
                        len = strlen(caller_chan_id) + strlen(callee_chan_id) + 50;
                        args = alloca(len);
                        touch_filename = alloca(len);
                        snprintf(touch_filename, len, "%s-%ld-%s-%s", S_OR(touch_monitor_prefix, "auto"), (long)time(NULL), caller_chan_id, callee_chan_id);
                        snprintf(args, len, "%s,%s,m", S_OR(touch_format, "wav"), touch_filename);
                }

                for(x = 0; x < strlen(args); x++) {
                        if (args[x] == '/')
                                args[x] = '-';
                }
                
                ast_verb(4, "User hit '%s' to record call. filename: %s\n", code, args);

                pbx_exec(callee_chan, monitor_app, args);
                pbx_builtin_setvar_helper(callee_chan, "TOUCH_MONITOR_OUTPUT", touch_filename);
                pbx_builtin_setvar_helper(caller_chan, "TOUCH_MONITOR_OUTPUT", touch_filename);

                if (!ast_strlen_zero(automon_message_start)) {  /* Play start message for both channels */
                        play_message_in_bridged_call(caller_chan, callee_chan, automon_message_start);
                }
        
                return AST_FEATURE_RETURN_SUCCESS;
        }
        
        ast_log(LOG_NOTICE,"Cannot record the call. One or both channels have gone away.\n");   
        return -1;
}

static int builtin_automixmonitor(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
{
        char *caller_chan_id = NULL, *callee_chan_id = NULL, *args = NULL, *touch_filename = NULL;
        int x = 0;
        size_t len;
        struct ast_channel *caller_chan, *callee_chan;
        const char *mixmonitor_spy_type = "MixMonitor";
        int count = 0;

        if (!mixmonitor_ok) {
                ast_log(LOG_ERROR,"Cannot record the call. The mixmonitor application is disabled.\n");
                return -1;
        }

        if (!(mixmonitor_app = pbx_findapp("MixMonitor"))) {
                mixmonitor_ok = 0;
                ast_log(LOG_ERROR,"Cannot record the call. The mixmonitor application is disabled.\n");
                return -1;
        }

        set_peers(&caller_chan, &callee_chan, peer, chan, sense);

        if (!ast_strlen_zero(courtesytone)) {
                if (ast_autoservice_start(callee_chan))
                        return -1;
                if (ast_stream_and_wait(caller_chan, courtesytone, "")) {
                        ast_log(LOG_WARNING, "Failed to play courtesy tone!\n");
                        ast_autoservice_stop(callee_chan);
                        return -1;
                }
                if (ast_autoservice_stop(callee_chan))
                        return -1;
        }

        ast_channel_lock(callee_chan);
        count = ast_channel_audiohook_count_by_source(callee_chan, mixmonitor_spy_type, AST_AUDIOHOOK_TYPE_SPY);
        ast_channel_unlock(callee_chan);

        /* This means a mixmonitor is attached to the channel, running or not is unknown. */
        if (count > 0) {
                
                ast_verb(3, "User hit '%s' to stop recording call.\n", code);

                /* Make sure they are running */
                ast_channel_lock(callee_chan);
                count = ast_channel_audiohook_count_by_source_running(callee_chan, mixmonitor_spy_type, AST_AUDIOHOOK_TYPE_SPY);
                ast_channel_unlock(callee_chan);
                if (count > 0) {
                        if (!stopmixmonitor_ok) {
                                ast_log(LOG_ERROR,"Cannot stop recording the call. The stopmixmonitor application is disabled.\n");
                                return -1;
                        }
                        if (!(stopmixmonitor_app = pbx_findapp("StopMixMonitor"))) {
                                stopmixmonitor_ok = 0;
                                ast_log(LOG_ERROR,"Cannot stop recording the call. The stopmixmonitor application is disabled.\n");
                                return -1;
                        } else {
                                pbx_exec(callee_chan, stopmixmonitor_app, "");
                                return AST_FEATURE_RETURN_SUCCESS;
                        }
                }
                
                ast_log(LOG_WARNING,"Stopped MixMonitors are attached to the channel.\n");      
        }                       

        if (caller_chan && callee_chan) {
                const char *touch_format = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MIXMONITOR_FORMAT");
                const char *touch_monitor = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MIXMONITOR");

                if (!touch_format)
                        touch_format = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MIXMONITOR_FORMAT");

                if (!touch_monitor)
                        touch_monitor = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MIXMONITOR");

                if (touch_monitor) {
                        len = strlen(touch_monitor) + 50;
                        args = alloca(len);
                        touch_filename = alloca(len);
                        snprintf(touch_filename, len, "auto-%ld-%s", (long)time(NULL), touch_monitor);
                        snprintf(args, len, "%s.%s,b", touch_filename, (touch_format) ? touch_format : "wav");
                } else {
                        caller_chan_id = ast_strdupa(S_OR(caller_chan->cid.cid_num, caller_chan->name));
                        callee_chan_id = ast_strdupa(S_OR(callee_chan->cid.cid_num, callee_chan->name));
                        len = strlen(caller_chan_id) + strlen(callee_chan_id) + 50;
                        args = alloca(len);
                        touch_filename = alloca(len);
                        snprintf(touch_filename, len, "auto-%ld-%s-%s", (long)time(NULL), caller_chan_id, callee_chan_id);
                        snprintf(args, len, "%s.%s,b", touch_filename, S_OR(touch_format, "wav"));
                }

                for( x = 0; x < strlen(args); x++) {
                        if (args[x] == '/')
                                args[x] = '-';
                }

                ast_verb(3, "User hit '%s' to record call. filename: %s\n", code, touch_filename);

                pbx_exec(callee_chan, mixmonitor_app, args);
                pbx_builtin_setvar_helper(callee_chan, "TOUCH_MIXMONITOR_OUTPUT", touch_filename);
                pbx_builtin_setvar_helper(caller_chan, "TOUCH_MIXMONITOR_OUTPUT", touch_filename);
                return AST_FEATURE_RETURN_SUCCESS;
        
        }

        ast_log(LOG_NOTICE,"Cannot record the call. One or both channels have gone away.\n");
        return -1;

}

static int builtin_disconnect(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
{
        ast_verb(4, "User hit '%s' to disconnect call.\n", code);
        return AST_FEATURE_RETURN_HANGUP;
}

static int finishup(struct ast_channel *chan)
{
        ast_indicate(chan, AST_CONTROL_UNHOLD);

        return ast_autoservice_stop(chan);
}

/*!
 * \brief Find the context for the transfer
 * \param transferer
 * \param transferee
 * 
 * Grab the TRANSFER_CONTEXT, if fails try grabbing macrocontext.
 * \return a context string
*/
static const char *real_ctx(struct ast_channel *transferer, struct ast_channel *transferee)
{
        const char *s = pbx_builtin_getvar_helper(transferer, "TRANSFER_CONTEXT");
        if (ast_strlen_zero(s)) {
                s = pbx_builtin_getvar_helper(transferee, "TRANSFER_CONTEXT");
        }
        if (ast_strlen_zero(s)) { /* Use the non-macro context to transfer the call XXX ? */
                s = transferer->macrocontext;
        }
        if (ast_strlen_zero(s)) {
                s = transferer->context;
        }
        return s;  
}

/*!
 * \brief Blind transfer user to another extension
 * \param chan channel to be transfered
 * \param peer channel initiated blind transfer
 * \param config
 * \param code
 * \param data
 * \param sense  feature options
 * 
 * Place chan on hold, check if transferred to parkinglot extension,
 * otherwise check extension exists and transfer caller.
 * \retval AST_FEATURE_RETURN_SUCCESS.
 * \retval -1 on failure.
*/
static int builtin_blindtransfer(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
{
        struct ast_channel *transferer;
        struct ast_channel *transferee;
        const char *transferer_real_context;
        char xferto[256];
        int res, parkstatus = 0;

        set_peers(&transferer, &transferee, peer, chan, sense);
        transferer_real_context = real_ctx(transferer, transferee);
        /* Start autoservice on chan while we talk to the originator */
        ast_autoservice_start(transferee);
        ast_indicate(transferee, AST_CONTROL_HOLD);

        memset(xferto, 0, sizeof(xferto));

        /* Transfer */
        res = ast_stream_and_wait(transferer, "pbx-transfer", AST_DIGIT_ANY);
        if (res < 0) {
                finishup(transferee);
                return -1; /* error ? */
        }
        if (res > 0)    /* If they've typed a digit already, handle it */
                xferto[0] = (char) res;

        ast_stopstream(transferer);
        res = ast_app_dtget(transferer, transferer_real_context, xferto, sizeof(xferto), 100, transferdigittimeout);
        if (res < 0) {  /* hangup, would be 0 for invalid and 1 for valid */
                finishup(transferee);
                return res;
        }
        if (!strcmp(xferto, ast_parking_ext())) {
                res = finishup(transferee);
                if (res)
                        res = -1;
                else if (!(parkstatus = masq_park_call_announce(transferee, transferer, 0, NULL))) {    /* success */
                        /* We return non-zero, but tell the PBX not to hang the channel when
                           the thread dies -- We have to be careful now though.  We are responsible for 
                           hanging up the channel, else it will never be hung up! */

                        return 0;
                } else {
                        ast_log(LOG_WARNING, "Unable to park call %s, parkstatus = %d\n", transferee->name, parkstatus);
                }
                /*! \todo XXX Maybe we should have another message here instead of invalid extension XXX */
        } else if (ast_exists_extension(transferee, transferer_real_context, xferto, 1, transferer->cid.cid_num)) {
                ast_cel_report_event(transferer, AST_CEL_BLINDTRANSFER, NULL, xferto, transferee);
                pbx_builtin_setvar_helper(transferer, "BLINDTRANSFER", transferee->name);
                pbx_builtin_setvar_helper(transferee, "BLINDTRANSFER", transferer->name);
                res=finishup(transferee);
                if (!transferer->cdr) { /* this code should never get called (in a perfect world) */
                        transferer->cdr=ast_cdr_alloc();
                        if (transferer->cdr) {
                                ast_cdr_init(transferer->cdr, transferer); /* initialize our channel's cdr */
                                ast_cdr_start(transferer->cdr);
                        }
                }
                if (transferer->cdr) {
                        struct ast_cdr *swap = transferer->cdr;
                        ast_log(LOG_DEBUG,"transferer=%s; transferee=%s; lastapp=%s; lastdata=%s; chan=%s; dstchan=%s\n",
                                        transferer->name, transferee->name, transferer->cdr->lastapp, transferer->cdr->lastdata, 
                                        transferer->cdr->channel, transferer->cdr->dstchannel);
                        ast_log(LOG_DEBUG,"TRANSFEREE; lastapp=%s; lastdata=%s, chan=%s; dstchan=%s\n",
                                        transferee->cdr->lastapp, transferee->cdr->lastdata, transferee->cdr->channel, transferee->cdr->dstchannel);
                        ast_log(LOG_DEBUG,"transferer_real_context=%s; xferto=%s\n", transferer_real_context, xferto);
                        /* swap cdrs-- it will save us some time & work */
                        transferer->cdr = transferee->cdr;
                        transferee->cdr = swap;
                }
                if (!transferee->pbx) {
                        /* Doh!  Use our handy async_goto functions */
                        ast_verb(3, "Transferring %s to '%s' (context %s) priority 1\n"
                                                                ,transferee->name, xferto, transferer_real_context);
                        if (ast_async_goto(transferee, transferer_real_context, xferto, 1))
                                ast_log(LOG_WARNING, "Async goto failed :-(\n");
                } else {
                        /* Set the channel's new extension, since it exists, using transferer context */
                        ast_set_flag(transferee, AST_FLAG_BRIDGE_HANGUP_DONT); /* don't let the after-bridge code run the h-exten */
                        ast_log(LOG_DEBUG,"ABOUT TO AST_ASYNC_GOTO, have a pbx... set HANGUP_DONT on chan=%s\n", transferee->name);
                        if (ast_channel_connected_line_macro(transferee, transferer, &transferer->connected, 1, 0)) {
                                ast_channel_update_connected_line(transferee, &transferer->connected);
                        }
                        set_c_e_p(transferee, transferer_real_context, xferto, 0);
                }
                check_goto_on_transfer(transferer);
                return res;
        } else {
                ast_verb(3, "Unable to find extension '%s' in context '%s'\n", xferto, transferer_real_context);
        }
        if (parkstatus != AST_FEATURE_RETURN_PARKFAILED && ast_stream_and_wait(transferer, xferfailsound, AST_DIGIT_ANY) < 0) {
                finishup(transferee);
                return -1;
        }
        ast_stopstream(transferer);
        res = finishup(transferee);
        if (res) {
                ast_verb(2, "Hungup during autoservice stop on '%s'\n", transferee->name);
                return res;
        }
        return AST_FEATURE_RETURN_SUCCESS;
}

/*!
 * \brief make channels compatible
 * \param c
 * \param newchan
 * \retval 0 on success.
 * \retval -1 on failure.
*/
static int check_compat(struct ast_channel *c, struct ast_channel *newchan)
{
        if (ast_channel_make_compatible(c, newchan) < 0) {
                ast_log(LOG_WARNING, "Had to drop call because I couldn't make %s compatible with %s\n",
                        c->name, newchan->name);
                ast_hangup(newchan);
                return -1;
        }
        return 0;
}

/*!
 * \brief Attended transfer
 * \param chan transfered user
 * \param peer person transfering call
 * \param config
 * \param code
 * \param sense feature options
 * 
 * \param data
 * Get extension to transfer to, if you cannot generate channel (or find extension) 
 * return to host channel. After called channel answered wait for hangup of transferer,
 * bridge call between transfer peer (taking them off hold) to attended transfer channel.
 *
 * \return -1 on failure
*/
static int builtin_atxfer(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
{
        struct ast_channel *transferer;
        struct ast_channel *transferee;
        const char *transferer_real_context;
        char xferto[256] = "";
        int res;
        int outstate=0;
        struct ast_channel *newchan;
        struct ast_channel *xferchan;
        struct ast_bridge_thread_obj *tobj;
        struct ast_bridge_config bconfig;
        struct ast_frame *f;
        int l;
        struct ast_party_connected_line connected_line;
        struct ast_datastore *features_datastore;
        struct ast_dial_features *dialfeatures = NULL;

        ast_debug(1, "Executing Attended Transfer %s, %s (sense=%d) \n", chan->name, peer->name, sense);
        set_peers(&transferer, &transferee, peer, chan, sense);
        transferer_real_context = real_ctx(transferer, transferee);
        /* Start autoservice on chan while we talk to the originator */
        ast_autoservice_start(transferee);
        ast_indicate(transferee, AST_CONTROL_HOLD);
        
        /* Transfer */
        res = ast_stream_and_wait(transferer, "pbx-transfer", AST_DIGIT_ANY);
        if (res < 0) {
                finishup(transferee);
                return res;
        }
        if (res > 0) /* If they've typed a digit already, handle it */
                xferto[0] = (char) res;

        /* this is specific of atxfer */
        res = ast_app_dtget(transferer, transferer_real_context, xferto, sizeof(xferto), 100, transferdigittimeout);
        if (res < 0) {  /* hangup, would be 0 for invalid and 1 for valid */
                finishup(transferee);
                return res;
        }
        if (res == 0) {
                ast_log(LOG_WARNING, "Did not read data.\n");
                finishup(transferee);
                if (ast_stream_and_wait(transferer, "beeperr", ""))
                        return -1;
                return AST_FEATURE_RETURN_SUCCESS;
        }

        /* valid extension, res == 1 */
        if (!ast_exists_extension(transferer, transferer_real_context, xferto, 1, transferer->cid.cid_num)) {
                ast_log(LOG_WARNING, "Extension %s does not exist in context %s\n",xferto,transferer_real_context);
                finishup(transferee);
                if (ast_stream_and_wait(transferer, "beeperr", ""))
                        return -1;
                return AST_FEATURE_RETURN_SUCCESS;
        }

        /* If we are attended transfering to parking, just use builtin_parkcall instead of trying to track all of
         * the different variables for handling this properly with a builtin_atxfer */
        if (!strcmp(xferto, ast_parking_ext())) {
                finishup(transferee);
                return builtin_parkcall(chan, peer, config, code, sense, data);
        }

        l = strlen(xferto);
        snprintf(xferto + l, sizeof(xferto) - l, "@%s/n", transferer_real_context);     /* append context */

        /* If we are performing an attended transfer and we have two channels involved then
           copy sound file information to play upon attended transfer completion */
        if (transferee) {
                const char *chan1_attended_sound = pbx_builtin_getvar_helper(transferer, "ATTENDED_TRANSFER_COMPLETE_SOUND");
                const char *chan2_attended_sound = pbx_builtin_getvar_helper(transferee, "ATTENDED_TRANSFER_COMPLETE_SOUND");

                if (!ast_strlen_zero(chan1_attended_sound)) {
                        pbx_builtin_setvar_helper(transferer, "BRIDGE_PLAY_SOUND", chan1_attended_sound);
                }
                if (!ast_strlen_zero(chan2_attended_sound)) {
                        pbx_builtin_setvar_helper(transferee, "BRIDGE_PLAY_SOUND", chan2_attended_sound);
                }
        }

        newchan = feature_request_and_dial(transferer, transferee, "Local", ast_best_codec(transferer->nativeformats),
                xferto, atxfernoanswertimeout, &outstate, transferer->cid.cid_num, transferer->cid.cid_name, 1, transferer->language);

        ast_party_connected_line_init(&connected_line);
        if (!ast_check_hangup(transferer)) {
                /* Transferer is up - old behaviour */
                ast_indicate(transferer, -1);
                if (!newchan) {
                        finishup(transferee);
                        /* any reason besides user requested cancel and busy triggers the failed sound */
                        if (outstate != AST_CONTROL_UNHOLD && outstate != AST_CONTROL_BUSY &&
                                ast_stream_and_wait(transferer, xferfailsound, ""))
                                return -1;
                        if (ast_stream_and_wait(transferer, xfersound, ""))
                                ast_log(LOG_WARNING, "Failed to play transfer sound!\n");
                        return AST_FEATURE_RETURN_SUCCESS;
                }

                if (check_compat(transferer, newchan)) {
                        /* we do mean transferee here, NOT transferer */
                        finishup(transferee);
                        return -1;
                }
                memset(&bconfig,0,sizeof(struct ast_bridge_config));
                ast_set_flag(&(bconfig.features_caller), AST_FEATURE_DISCONNECT);
                ast_set_flag(&(bconfig.features_callee), AST_FEATURE_DISCONNECT);
                /* We need to get the transferer's connected line information copied
                 * at this point because he is likely to hang up during the bridge with
                 * newchan. This info will be used down below before bridging the 
                 * transferee and newchan
                 *
                 * As a result, we need to be sure to free this data before returning
                 * or overwriting it.
                 */
                ast_channel_lock(transferer);
                ast_party_connected_line_copy(&connected_line, &transferer->connected);
                ast_channel_unlock(transferer);
                res = ast_bridge_call(transferer, newchan, &bconfig);
                if (ast_check_hangup(newchan) || !ast_check_hangup(transferer)) {
                        ast_hangup(newchan);
                        if (ast_stream_and_wait(transferer, xfersound, ""))
                                ast_log(LOG_WARNING, "Failed to play transfer sound!\n");
                        finishup(transferee);
                        transferer->_softhangup = 0;
                        ast_party_connected_line_free(&connected_line);
                        return AST_FEATURE_RETURN_SUCCESS;
                }

                ast_cel_report_event(transferee, AST_CEL_ATTENDEDTRANSFER, NULL, NULL, newchan);

                if (check_compat(transferee, newchan)) {
                        finishup(transferee);
                        ast_party_connected_line_free(&connected_line);
                        return -1;
                }
                ast_indicate(transferee, AST_CONTROL_UNHOLD);

                if ((ast_autoservice_stop(transferee) < 0)
                 || (ast_waitfordigit(transferee, 100) < 0)
                 || (ast_waitfordigit(newchan, 100) < 0)
                 || ast_check_hangup(transferee)
                 || ast_check_hangup(newchan)) {
                        ast_hangup(newchan);
                        ast_party_connected_line_free(&connected_line);
                        return -1;
                }
                xferchan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, "", "", "", transferee->linkedid, 0, "Transfered/%s", transferee->name);
                if (!xferchan) {
                        ast_hangup(newchan);
                        ast_party_connected_line_free(&connected_line);
                        return -1;
                }
                /* Make formats okay */
                xferchan->visible_indication = transferer->visible_indication;
                xferchan->readformat = transferee->readformat;
                xferchan->writeformat = transferee->writeformat;
                ast_channel_masquerade(xferchan, transferee);
                ast_explicit_goto(xferchan, transferee->context, transferee->exten, transferee->priority);
                xferchan->_state = AST_STATE_UP;
                ast_clear_flag(xferchan, AST_FLAGS_ALL);
                xferchan->_softhangup = 0;
                if ((f = ast_read(xferchan)))
                        ast_frfree(f);
                newchan->_state = AST_STATE_UP;
                ast_clear_flag(newchan, AST_FLAGS_ALL);
                newchan->_softhangup = 0;
                if (!(tobj = ast_calloc(1, sizeof(*tobj)))) {
                        ast_hangup(xferchan);
                        ast_hangup(newchan);
                        ast_party_connected_line_free(&connected_line);
                        return -1;
                }

                ast_channel_lock(newchan);
                if ((features_datastore = ast_channel_datastore_find(newchan, &dial_features_info, NULL))) {
                                dialfeatures = features_datastore->data;
                }
                ast_channel_unlock(newchan);

                if (dialfeatures) {
                        /* newchan should always be the callee and shows up as callee in dialfeatures, but for some reason
                           I don't currently understand, the abilities of newchan seem to be stored on the caller side */
                        ast_copy_flags(&(config->features_callee), &(dialfeatures->features_caller), AST_FLAGS_ALL);
                        dialfeatures = NULL;
                }

                ast_channel_lock(xferchan);
                if ((features_datastore = ast_channel_datastore_find(xferchan, &dial_features_info, NULL))) {
                        dialfeatures = features_datastore->data;
                }
                ast_channel_unlock(xferchan);
         
                if (dialfeatures) {
                        ast_copy_flags(&(config->features_caller), &(dialfeatures->features_caller), AST_FLAGS_ALL);
                }
         
                tobj->chan = newchan;
                tobj->peer = xferchan;
                tobj->bconfig = *config;

                if (tobj->bconfig.end_bridge_callback_data_fixup) {
                        tobj->bconfig.end_bridge_callback_data_fixup(&tobj->bconfig, tobj->peer, tobj->chan);
                }

                /* Due to a limitation regarding when callerID is set on a Local channel,
                 * we use the transferer's connected line information here.
                 */

                /* xferchan is transferee, and newchan is the transfer target
                 * So...in a transfer, who is the caller and who is the callee?
                 *
                 * When the call is originally made, it is clear who is caller and callee.
                 * When a transfer occurs, it is my humble opinion that the transferee becomes
                 * the caller, and the transfer target is the callee.
                 *
                 * The problem is that these macros were set with the intention of the original
                 * caller and callee taking those roles. A transfer can totally mess things up,
                 * to be technical. What sucks even more is that you can't effectively change
                 * the macros in the dialplan during the call from the transferer to the transfer
                 * target because the transferee is stuck with whatever role he originally had.
                 *
                 * I think the answer here is just to make sure that it is well documented that
                 * during a transfer, the transferee is the "caller" and the transfer target
                 * is the "callee."
                 *
                 * This means that if party A calls party B, and party A transfers party B to
                 * party C, then B has switched roles for the call. Now party B will have the
                 * caller macro called on his channel instead of the callee macro.
                 *
                 * Luckily, the method by which the bridge is launched here ensures that the 
                 * transferee is the "chan" on the bridge and the transfer target is the "peer,"
                 * so my idea for the roles post-transfer does not require extensive code changes.
                 */
                connected_line.source = AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER;
                if (ast_channel_connected_line_macro(newchan, xferchan, &connected_line, 1, 0)) {
                        ast_channel_update_connected_line(xferchan, &connected_line);
                }
                ast_channel_lock(xferchan);
                ast_connected_line_copy_from_caller(&connected_line, &xferchan->cid);
                ast_channel_unlock(xferchan);
                connected_line.source = AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER;
                if (ast_channel_connected_line_macro(xferchan, newchan, &connected_line, 0, 0)) {
                        ast_channel_update_connected_line(newchan, &connected_line);
                }
                ast_party_connected_line_free(&connected_line);

                if (ast_stream_and_wait(newchan, xfersound, ""))
                        ast_log(LOG_WARNING, "Failed to play transfer sound!\n");
                bridge_call_thread_launch(tobj);
                return -1;      /* XXX meaning the channel is bridged ? */
        } else if (!ast_check_hangup(transferee)) {
                /* act as blind transfer */
                if (ast_autoservice_stop(transferee) < 0) {
                        ast_hangup(newchan);
                        return -1;
                }

                if (!newchan) {
                        unsigned int tries = 0;
                        char *transferer_tech, *transferer_name = ast_strdupa(transferer->name);

                        transferer_tech = strsep(&transferer_name, "/");
                        transferer_name = strsep(&transferer_name, "-");

                        if (ast_strlen_zero(transferer_name) || ast_strlen_zero(transferer_tech)) {
                                ast_log(LOG_WARNING, "Transferer has invalid channel name: '%s'\n", transferer->name);
                                if (ast_stream_and_wait(transferee, "beeperr", ""))
                                        return -1;
                                return AST_FEATURE_RETURN_SUCCESS;
                        }

                        ast_log(LOG_NOTICE, "We're trying to call %s/%s\n", transferer_tech, transferer_name);
                        newchan = feature_request_and_dial(transferee, NULL, transferer_tech, ast_best_codec(transferee->nativeformats),
                                transferer_name, atxfernoanswertimeout, &outstate, transferee->cid.cid_num, transferee->cid.cid_name, 0, transferer->language);
                        while (!newchan && !atxferdropcall && tries < atxfercallbackretries) {
                                /* Trying to transfer again */
                                ast_autoservice_start(transferee);
                                ast_indicate(transferee, AST_CONTROL_HOLD);

                                newchan = feature_request_and_dial(transferer, transferee, "Local", ast_best_codec(transferer->nativeformats),
                                        xferto, atxfernoanswertimeout, &outstate, transferer->cid.cid_num, transferer->cid.cid_name, 1, transferer->language);
                                if (ast_autoservice_stop(transferee) < 0) {
                                        if (newchan)
                                                ast_hangup(newchan);
                                        return -1;
                                }
                                if (!newchan) {
                                        /* Transfer failed, sleeping */
                                        ast_debug(1, "Sleeping for %d ms before callback.\n", atxferloopdelay);
                                        ast_safe_sleep(transferee, atxferloopdelay);
                                        ast_debug(1, "Trying to callback...\n");
                                        newchan = feature_request_and_dial(transferee, NULL, transferer_tech, ast_best_codec(transferee->nativeformats),
                                                transferer_name, atxfernoanswertimeout, &outstate, transferee->cid.cid_num, transferee->cid.cid_name, 0, transferer->language);
                                }
                                tries++;
                        }
                }
                if (!newchan)
                        return -1;

                ast_cel_report_event(transferee, AST_CEL_ATTENDEDTRANSFER, NULL, NULL, newchan);

                /* newchan is up, we should prepare transferee and bridge them */
                if (check_compat(transferee, newchan)) {
                        finishup(transferee);
                        return -1;
                }
                ast_indicate(transferee, AST_CONTROL_UNHOLD);

                if ((ast_waitfordigit(transferee, 100) < 0)
                   || (ast_waitfordigit(newchan, 100) < 0)
                   || ast_check_hangup(transferee)
                   || ast_check_hangup(newchan)) {
                        ast_hangup(newchan);
                        return -1;
                }

                xferchan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, "", "", "", transferee->linkedid, 0, "Transfered/%s", transferee->name);
                if (!xferchan) {
                        ast_hangup(newchan);
                        return -1;
                }
                /* Make formats okay */
                xferchan->visible_indication = transferer->visible_indication;
                xferchan->readformat = transferee->readformat;
                xferchan->writeformat = transferee->writeformat;
                ast_channel_masquerade(xferchan, transferee);
                ast_explicit_goto(xferchan, transferee->context, transferee->exten, transferee->priority);
                xferchan->_state = AST_STATE_UP;
                ast_clear_flag(xferchan, AST_FLAGS_ALL);
                xferchan->_softhangup = 0;
                if ((f = ast_read(xferchan)))
                        ast_frfree(f);
                newchan->_state = AST_STATE_UP;
                ast_clear_flag(newchan, AST_FLAGS_ALL);
                newchan->_softhangup = 0;
                if (!(tobj = ast_calloc(1, sizeof(*tobj)))) {
                        ast_hangup(xferchan);
                        ast_hangup(newchan);
                        return -1;
                }
                tobj->chan = newchan;
                tobj->peer = xferchan;
                tobj->bconfig = *config;
                
                if (tobj->bconfig.end_bridge_callback_data_fixup) {
                        tobj->bconfig.end_bridge_callback_data_fixup(&tobj->bconfig, tobj->peer, tobj->chan);
                }

                ast_channel_lock(newchan);
                ast_connected_line_copy_from_caller(&connected_line, &newchan->cid);
                ast_channel_unlock(newchan);
                connected_line.source = AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER;
                if (ast_channel_connected_line_macro(newchan, xferchan, &connected_line, 1, 0)) {
                        ast_channel_update_connected_line(xferchan, &connected_line);
                }
                ast_channel_lock(xferchan);
                ast_connected_line_copy_from_caller(&connected_line, &xferchan->cid);
                ast_channel_unlock(xferchan);
                connected_line.source = AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER;
                if (ast_channel_connected_line_macro(xferchan, newchan, &connected_line, 0, 0)) {
                        ast_channel_update_connected_line(newchan, &connected_line);
                }

                ast_party_connected_line_free(&connected_line);
                
                if (ast_stream_and_wait(newchan, xfersound, ""))
                        ast_log(LOG_WARNING, "Failed to play transfer sound!\n");
                bridge_call_thread_launch(tobj);
                return -1;      /* XXX meaning the channel is bridged ? */
        } else {
                /* Transferee hung up */
                finishup(transferee);
                return -1;
        }
}

/* add atxfer and automon as undefined so you can only use em if you configure them */
#define FEATURES_COUNT ARRAY_LEN(builtin_features)

AST_RWLOCK_DEFINE_STATIC(features_lock);

static struct ast_call_feature builtin_features[] = {
        { AST_FEATURE_REDIRECT, "Blind Transfer", "blindxfer", "#", "#", builtin_blindtransfer, AST_FEATURE_FLAG_NEEDSDTMF, "" },
        { AST_FEATURE_REDIRECT, "Attended Transfer", "atxfer", "", "", builtin_atxfer, AST_FEATURE_FLAG_NEEDSDTMF, "" },
        { AST_FEATURE_AUTOMON, "One Touch Monitor", "automon", "", "", builtin_automonitor, AST_FEATURE_FLAG_NEEDSDTMF, "" },
        { AST_FEATURE_DISCONNECT, "Disconnect Call", "disconnect", "*", "*", builtin_disconnect, AST_FEATURE_FLAG_NEEDSDTMF, "" },
        { AST_FEATURE_PARKCALL, "Park Call", "parkcall", "", "", builtin_parkcall, AST_FEATURE_FLAG_NEEDSDTMF, "" },
        { AST_FEATURE_AUTOMIXMON, "One Touch MixMonitor", "automixmon", "", "", builtin_automixmonitor, AST_FEATURE_FLAG_NEEDSDTMF, "" },
};


static AST_RWLIST_HEAD_STATIC(feature_list, ast_call_feature);

/*! \brief register new feature into feature_list*/
void ast_register_feature(struct ast_call_feature *feature)
{
        if (!feature) {
                ast_log(LOG_NOTICE,"You didn't pass a feature!\n");
                return;
        }
  
        AST_RWLIST_WRLOCK(&feature_list);
        AST_RWLIST_INSERT_HEAD(&feature_list,feature,feature_entry);
        AST_RWLIST_UNLOCK(&feature_list);

        ast_verb(2, "Registered Feature '%s'\n",feature->sname);
}

/*! 
 * \brief Add new feature group
 * \param fgname feature group name.
 *
 * Add new feature group to the feature group list insert at head of list.
 * \note This function MUST be called while feature_groups is locked.
*/
static struct feature_group* register_group(const char *fgname)
{
        struct feature_group *fg;

        if (!fgname) {
                ast_log(LOG_NOTICE, "You didn't pass a new group name!\n");
                return NULL;
        }

        if (!(fg = ast_calloc_with_stringfields(1, struct feature_group, 128)))
                return NULL;

        ast_string_field_set(fg, gname, fgname);

        AST_LIST_INSERT_HEAD(&feature_groups, fg, entry);

        ast_verb(2, "Registered group '%s'\n", fg->gname);

        return fg;
}

/*! 
 * \brief Add feature to group
 * \param fg feature group
 * \param exten
 * \param feature feature to add.
 *
 * Check fg and feature specified, add feature to list
 * \note This function MUST be called while feature_groups is locked. 
*/
static void register_group_feature(struct feature_group *fg, const char *exten, struct ast_call_feature *feature) 
{
        struct feature_group_exten *fge;

        if (!fg) {
                ast_log(LOG_NOTICE, "You didn't pass a group!\n");
                return;
        }

        if (!feature) {
                ast_log(LOG_NOTICE, "You didn't pass a feature!\n");
                return;
        }

        if (!(fge = ast_calloc_with_stringfields(1, struct feature_group_exten, 128)))
                return;

        ast_string_field_set(fge, exten, S_OR(exten, feature->exten));

        fge->feature = feature;

        AST_LIST_INSERT_HEAD(&fg->features, fge, entry);                

        ast_verb(2, "Registered feature '%s' for group '%s' at exten '%s'\n",
                                        feature->sname, fg->gname, exten);
}

void ast_unregister_feature(struct ast_call_feature *feature)
{
        if (!feature) {
                return;
        }

        AST_RWLIST_WRLOCK(&feature_list);
        AST_RWLIST_REMOVE(&feature_list, feature, feature_entry);
        AST_RWLIST_UNLOCK(&feature_list);

        ast_free(feature);
}

/*! \brief Remove all features in the list */
static void ast_unregister_features(void)
{
        struct ast_call_feature *feature;

        AST_RWLIST_WRLOCK(&feature_list);
        while ((feature = AST_RWLIST_REMOVE_HEAD(&feature_list, feature_entry))) {
                ast_free(feature);
        }
        AST_RWLIST_UNLOCK(&feature_list);
}

/*! \brief find a call feature by name */
static struct ast_call_feature *find_dynamic_feature(const char *name)
{
        struct ast_call_feature *tmp;

        AST_RWLIST_TRAVERSE(&feature_list, tmp, feature_entry) {
                if (!strcasecmp(tmp->sname, name)) {
                        break;
                }
        }

        return tmp;
}

/*! \brief Remove all feature groups in the list */
static void ast_unregister_groups(void)
{
        struct feature_group *fg;
        struct feature_group_exten *fge;

        AST_RWLIST_WRLOCK(&feature_groups);
        while ((fg = AST_LIST_REMOVE_HEAD(&feature_groups, entry))) {
                while ((fge = AST_LIST_REMOVE_HEAD(&fg->features, entry))) {
                        ast_string_field_free_memory(fge);
                        ast_free(fge);
                }

                ast_string_field_free_memory(fg);
                ast_free(fg);
        }
        AST_RWLIST_UNLOCK(&feature_groups);
}

/*! 
 * \brief Find a group by name 
 * \param name feature name
 * \retval feature group on success.
 * \retval NULL on failure.
*/
static struct feature_group *find_group(const char *name) {
        struct feature_group *fg = NULL;

        AST_LIST_TRAVERSE(&feature_groups, fg, entry) {
                if (!strcasecmp(fg->gname, name))
                        break;
        }

        return fg;
}

void ast_rdlock_call_features(void)
{
        ast_rwlock_rdlock(&features_lock);
}

void ast_unlock_call_features(void)
{
        ast_rwlock_unlock(&features_lock);
}

struct ast_call_feature *ast_find_call_feature(const char *name)
{
        int x;
        for (x = 0; x < FEATURES_COUNT; x++) {
                if (!strcasecmp(name, builtin_features[x].sname))
                        return &builtin_features[x];
        }
        return NULL;
}

/*!
 * \brief exec an app by feature 
 * \param chan,peer,config,code,sense,data
 *
 * Find a feature, determine which channel activated
 * \retval AST_FEATURE_RETURN_NO_HANGUP_PEER
 * \retval -1 error.
 * \retval -2 when an application cannot be found.
*/
static int feature_exec_app(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
{
        struct ast_app *app;
        struct ast_call_feature *feature = data;
        struct ast_channel *work, *idle;
        int res;

        if (!feature) { /* shouldn't ever happen! */
                ast_log(LOG_NOTICE, "Found feature before, but at execing we've lost it??\n");
                return -1; 
        }

        if (sense == FEATURE_SENSE_CHAN) {
                if (!ast_test_flag(feature, AST_FEATURE_FLAG_BYCALLER))
                        return AST_FEATURE_RETURN_KEEPTRYING;
                if (ast_test_flag(feature, AST_FEATURE_FLAG_ONSELF)) {
                        work = chan;
                        idle = peer;
                } else {
                        work = peer;
                        idle = chan;
                }
        } else {
                if (!ast_test_flag(feature, AST_FEATURE_FLAG_BYCALLEE))
                        return AST_FEATURE_RETURN_KEEPTRYING;
                if (ast_test_flag(feature, AST_FEATURE_FLAG_ONSELF)) {
                        work = peer;
                        idle = chan;
                } else {
                        work = chan;
                        idle = peer;
                }
        }

        if (!(app = pbx_findapp(feature->app))) {
                ast_log(LOG_WARNING, "Could not find application (%s)\n", feature->app);
                return -2;
        }

        ast_autoservice_start(idle);
        
        if(work && idle) {
                pbx_builtin_setvar_helper(work, "DYNAMIC_PEERNAME", idle->name);
                pbx_builtin_setvar_helper(idle, "DYNAMIC_PEERNAME", work->name);
                pbx_builtin_setvar_helper(work, "DYNAMIC_FEATURENAME", feature->sname);
                pbx_builtin_setvar_helper(idle, "DYNAMIC_FEATURENAME", feature->sname);
        }

        if (!ast_strlen_zero(feature->moh_class))
                ast_moh_start(idle, feature->moh_class, NULL);

        res = pbx_exec(work, app, feature->app_args);

        if (!ast_strlen_zero(feature->moh_class))
                ast_moh_stop(idle);

        ast_autoservice_stop(idle);

        if (res) {
                return AST_FEATURE_RETURN_SUCCESSBREAK;
        }
        return AST_FEATURE_RETURN_SUCCESS;      /*! \todo XXX should probably return res */
}

static void unmap_features(void)
{
        int x;

        ast_rwlock_wrlock(&features_lock);
        for (x = 0; x < FEATURES_COUNT; x++)
                strcpy(builtin_features[x].exten, builtin_features[x].default_exten);
        ast_rwlock_unlock(&features_lock);
}

static int remap_feature(const char *name, const char *value)
{
        int x, res = -1;

        ast_rwlock_wrlock(&features_lock);
        for (x = 0; x < FEATURES_COUNT; x++) {
                if (strcasecmp(builtin_features[x].sname, name))
                        continue;

                ast_copy_string(builtin_features[x].exten, value, sizeof(builtin_features[x].exten));
                res = 0;
                break;
        }
        ast_rwlock_unlock(&features_lock);

        return res;
}

/*!
 * \brief Helper function for feature_interpret and ast_feature_detect
 * \param chan,peer,config,code,sense,dynamic_features char buf,feature flags,operation,feature
 *
 * Lock features list, browse for code, unlock list
 * If a feature is found and the operation variable is set, that feature's
 * operation is executed.  The first feature found is copied to the feature parameter.
 * \retval res on success.
 * \retval -1 on failure.
*/
static int feature_interpret_helper(struct ast_channel *chan, struct ast_channel *peer,
        struct ast_bridge_config *config, const char *code, int sense, char *dynamic_features_buf,
        struct ast_flags *features, int operation, struct ast_call_feature *feature)
{
        int x;
        struct feature_group *fg = NULL;
        struct feature_group_exten *fge;
        struct ast_call_feature *tmpfeature;
        char *tmp, *tok;
        int res = AST_FEATURE_RETURN_PASSDIGITS;
        int feature_detected = 0;

        if (!(peer && chan && config) && operation) {
                return -1; /* can not run feature operation */
        }

        ast_rwlock_rdlock(&features_lock);
        for (x = 0; x < FEATURES_COUNT; x++) {
                if ((ast_test_flag(features, builtin_features[x].feature_mask)) &&
                    !ast_strlen_zero(builtin_features[x].exten)) {
                        /* Feature is up for consideration */
                        if (!strcmp(builtin_features[x].exten, code)) {
                                ast_debug(3, "Feature detected: fname=%s sname=%s exten=%s\n", builtin_features[x].fname, builtin_features[x].sname, builtin_features[x].exten);
                                if (operation) {
                                        res = builtin_features[x].operation(chan, peer, config, code, sense, NULL);
                                }
                                memcpy(feature, &builtin_features[x], sizeof(feature));
                                feature_detected = 1;
                                break;
                        } else if (!strncmp(builtin_features[x].exten, code, strlen(code))) {
                                if (res == AST_FEATURE_RETURN_PASSDIGITS)
                                        res = AST_FEATURE_RETURN_STOREDIGITS;
                        }
                }
        }
        ast_rwlock_unlock(&features_lock);

        if (ast_strlen_zero(dynamic_features_buf) || feature_detected) {
                return res;
        }

        tmp = dynamic_features_buf;

        while ((tok = strsep(&tmp, "#"))) {
                AST_RWLIST_RDLOCK(&feature_groups);

                fg = find_group(tok);

                if (fg) {
                        AST_LIST_TRAVERSE(&fg->features, fge, entry) {
                                if (strcasecmp(fge->exten, code))
                                        continue;
                                if (operation) {
                                        res = fge->feature->operation(chan, peer, config, code, sense, fge->feature);
                                }
                                memcpy(feature, fge->feature, sizeof(feature));
                                if (res != AST_FEATURE_RETURN_KEEPTRYING) {
                                        AST_RWLIST_UNLOCK(&feature_groups);
                                        break;
                                }
                                res = AST_FEATURE_RETURN_PASSDIGITS;
                        }
                        if (fge)
                                break;
                }

                AST_RWLIST_UNLOCK(&feature_groups);

                AST_RWLIST_RDLOCK(&feature_list);

                if (!(tmpfeature = find_dynamic_feature(tok))) {
                        AST_RWLIST_UNLOCK(&feature_list);
                        continue;
                }

                /* Feature is up for consideration */
                if (!strcmp(tmpfeature->exten, code)) {
                        ast_verb(3, " Feature Found: %s exten: %s\n",tmpfeature->sname, tok);
                        if (operation) {
                                res = tmpfeature->operation(chan, peer, config, code, sense, tmpfeature);
                        }
                        memcpy(feature, tmpfeature, sizeof(feature));
                        if (res != AST_FEATURE_RETURN_KEEPTRYING) {
                                AST_RWLIST_UNLOCK(&feature_list);
                                break;
                        }
                        res = AST_FEATURE_RETURN_PASSDIGITS;
                } else if (!strncmp(tmpfeature->exten, code, strlen(code)))
                        res = AST_FEATURE_RETURN_STOREDIGITS;

                AST_RWLIST_UNLOCK(&feature_list);
        }

        return res;
}

/*!
 * \brief Check the dynamic features
 * \param chan,peer,config,code,sense
 *
 * \retval res on success.
 * \retval -1 on failure.
*/

static int feature_interpret(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense) {

        char dynamic_features_buf[128];
        const char *peer_dynamic_features, *chan_dynamic_features;
        struct ast_flags features;
        struct ast_call_feature feature;
        if (sense == FEATURE_SENSE_CHAN) {
                ast_copy_flags(&features, &(config->features_caller), AST_FLAGS_ALL);
        }
        else {
                ast_copy_flags(&features, &(config->features_callee), AST_FLAGS_ALL);
        }

        ast_channel_lock(peer);
        peer_dynamic_features = ast_strdupa(S_OR(pbx_builtin_getvar_helper(peer, "DYNAMIC_FEATURES"),""));
        ast_channel_unlock(peer);

        ast_channel_lock(chan);
        chan_dynamic_features = ast_strdupa(S_OR(pbx_builtin_getvar_helper(chan, "DYNAMIC_FEATURES"),""));
        ast_channel_unlock(chan);

        snprintf(dynamic_features_buf, sizeof(dynamic_features_buf), "%s%s%s", S_OR(chan_dynamic_features, ""), chan_dynamic_features && peer_dynamic_features ? "#" : "", S_OR(peer_dynamic_features,""));

        ast_debug(3, "Feature interpret: chan=%s, peer=%s, code=%s, sense=%d, features=%d, dynamic=%s\n", chan->name, peer->name, code, sense, features.flags, dynamic_features_buf);

        return feature_interpret_helper(chan, peer, config, code, sense, dynamic_features_buf, &features, 1, &feature);
}


int ast_feature_detect(struct ast_channel *chan, struct ast_flags *features, const char *code, struct ast_call_feature *feature) {

        return feature_interpret_helper(chan, NULL, NULL, code, 0, NULL, features, 0, feature);
}

static void set_config_flags(struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config)
{
        int x;

        ast_clear_flag(config, AST_FLAGS_ALL);

        ast_rwlock_rdlock(&features_lock);
        for (x = 0; x < FEATURES_COUNT; x++) {
                if (!ast_test_flag(builtin_features + x, AST_FEATURE_FLAG_NEEDSDTMF))
                        continue;

                if (ast_test_flag(&(config->features_caller), builtin_features[x].feature_mask))
                        ast_set_flag(config, AST_BRIDGE_DTMF_CHANNEL_0);

                if (ast_test_flag(&(config->features_callee), builtin_features[x].feature_mask))
                        ast_set_flag(config, AST_BRIDGE_DTMF_CHANNEL_1);
        }
        ast_rwlock_unlock(&features_lock);

        if (chan && peer && !(ast_test_flag(config, AST_BRIDGE_DTMF_CHANNEL_0) && ast_test_flag(config, AST_BRIDGE_DTMF_CHANNEL_1))) {
                const char *dynamic_features = pbx_builtin_getvar_helper(chan, "DYNAMIC_FEATURES");

                if (dynamic_features) {
                        char *tmp = ast_strdupa(dynamic_features);
                        char *tok;
                        struct ast_call_feature *feature;

                        /* while we have a feature */
                        while ((tok = strsep(&tmp, "#"))) {
                                AST_RWLIST_RDLOCK(&feature_list);
                                if ((feature = find_dynamic_feature(tok)) && ast_test_flag(feature, AST_FEATURE_FLAG_NEEDSDTMF)) {
                                        if (ast_test_flag(feature, AST_FEATURE_FLAG_BYCALLER))
                                                ast_set_flag(config, AST_BRIDGE_DTMF_CHANNEL_0);
                                        if (ast_test_flag(feature, AST_FEATURE_FLAG_BYCALLEE))
                                                ast_set_flag(config, AST_BRIDGE_DTMF_CHANNEL_1);
                                }
                                AST_RWLIST_UNLOCK(&feature_list);
                        }
                }
        }
}

/*! 
 * \brief Get feature and dial
 * \param caller,transferee,type,format,data,timeout,outstate,cid_num,cid_name,igncallerstate
 *
 * Request channel, set channel variables, initiate call,check if they want to disconnect
 * go into loop, check if timeout has elapsed, check if person to be transfered hung up,
 * check for answer break loop, set cdr return channel.
 *
 * \todo XXX Check - this is very similar to the code in channel.c 
 * \return always a channel
*/
static struct ast_channel *feature_request_and_dial(struct ast_channel *caller, struct ast_channel *transferee, const char *type, int format, void *data, int timeout, int *outstate, const char *cid_num, const char *cid_name, int igncallerstate, const char *language)
{
        int state = 0;
        int cause = 0;
        int to;
        struct ast_channel *chan;
        struct ast_channel *monitor_chans[2];
        struct ast_channel *active_channel;
        int res = 0, ready = 0;
        struct timeval started;
        int x, len = 0;
        char *disconnect_code = NULL, *dialed_code = NULL;

        if (!(chan = ast_request(type, format, caller, data, &cause))) {
                ast_log(LOG_NOTICE, "Unable to request channel %s/%s\n", type, (char *)data);
                switch(cause) {
                case AST_CAUSE_BUSY:
                        state = AST_CONTROL_BUSY;
                        break;
                case AST_CAUSE_CONGESTION:
                        state = AST_CONTROL_CONGESTION;
                        break;
                }
                goto done;
        }

        ast_set_callerid(chan, cid_num, cid_name, cid_num);
        ast_string_field_set(chan, language, language);
        ast_channel_inherit_variables(caller, chan);    
        pbx_builtin_setvar_helper(chan, "TRANSFERERNAME", caller->name);
                
        ast_channel_lock(chan);
        ast_connected_line_copy_from_caller(&chan->connected, &caller->cid);
        ast_channel_unlock(chan);
        
        if (ast_call(chan, data, timeout)) {
                ast_log(LOG_NOTICE, "Unable to call channel %s/%s\n", type, (char *)data);
                goto done;
        }
        
        ast_indicate(caller, AST_CONTROL_RINGING);
        /* support dialing of the featuremap disconnect code while performing an attended tranfer */
        ast_rwlock_rdlock(&features_lock);
        for (x = 0; x < FEATURES_COUNT; x++) {
                if (strcasecmp(builtin_features[x].sname, "disconnect"))
                        continue;

                disconnect_code = builtin_features[x].exten;
                len = strlen(disconnect_code) + 1;
                dialed_code = alloca(len);
                memset(dialed_code, 0, len);
                break;
        }
        ast_rwlock_unlock(&features_lock);
        x = 0;
        started = ast_tvnow();
        to = timeout;

        ast_poll_channel_add(caller, chan);

        while (!((transferee && ast_check_hangup(transferee)) && (!igncallerstate && ast_check_hangup(caller))) && timeout && (chan->_state != AST_STATE_UP)) {
                struct ast_frame *f = NULL;

                monitor_chans[0] = caller;
                monitor_chans[1] = chan;
                active_channel = ast_waitfor_n(monitor_chans, 2, &to);

                /* see if the timeout has been violated */
                if(ast_tvdiff_ms(ast_tvnow(), started) > timeout) {
                        state = AST_CONTROL_UNHOLD;
                        ast_log(LOG_NOTICE, "We exceeded our AT-timeout\n");
                        break; /*doh! timeout*/
                }

                if (!active_channel)
                        continue;

                if (chan && (chan == active_channel)){
                        if (!ast_strlen_zero(chan->call_forward)) {
                                if (!(chan = ast_call_forward(caller, chan, &to, format, NULL, outstate))) {
                                        return NULL;
                                }
                                continue;
                        }
                        f = ast_read(chan);
                        if (f == NULL) { /*doh! where'd he go?*/
                                state = AST_CONTROL_HANGUP;
                                res = 0;
                                break;
                        }
                        
                        if (f->frametype == AST_FRAME_CONTROL || f->frametype == AST_FRAME_DTMF || f->frametype == AST_FRAME_TEXT) {
                                if (f->subclass.integer == AST_CONTROL_RINGING) {
                                        state = f->subclass.integer;
                                        ast_verb(3, "%s is ringing\n", chan->name);
                                        ast_indicate(caller, AST_CONTROL_RINGING);
                                } else if ((f->subclass.integer == AST_CONTROL_BUSY) || (f->subclass.integer == AST_CONTROL_CONGESTION)) {
                                        state = f->subclass.integer;
                                        ast_verb(3, "%s is busy\n", chan->name);
                                        ast_indicate(caller, AST_CONTROL_BUSY);
                                        ast_frfree(f);
                                        f = NULL;
                                        break;
                                } else if (f->subclass.integer == AST_CONTROL_ANSWER) {
                                        /* This is what we are hoping for */
                                        state = f->subclass.integer;
                                        ast_frfree(f);
                                        f = NULL;
                                        ready=1;
                                        break;
                                } else if (f->subclass.integer == AST_CONTROL_CONNECTED_LINE) {
                                        if (ast_channel_connected_line_macro(chan, caller, f, 1, 1)) {
                                                ast_indicate_data(caller, AST_CONTROL_CONNECTED_LINE, f->data.ptr, f->datalen);
                                        }
                                } else if (f->subclass.integer != -1 && f->subclass.integer != AST_CONTROL_PROGRESS) {
                                        ast_log(LOG_NOTICE, "Don't know what to do about control frame: %d\n", f->subclass.integer);
                                }
                                /* else who cares */
                        } else if (f->frametype == AST_FRAME_VOICE || f->frametype == AST_FRAME_VIDEO) {
                                ast_write(caller, f);
                        }

                } else if (caller && (active_channel == caller)) {
                        f = ast_read(caller);
                        if (f == NULL) { /*doh! where'd he go?*/
                                if (!igncallerstate) {
                                        if (ast_check_hangup(caller) && !ast_check_hangup(chan)) {
                                                /* make this a blind transfer */
                                                ready = 1;
                                                break;
                                        }
                                        state = AST_CONTROL_HANGUP;
                                        res = 0;
                                        break;
                                }
                        } else {
                        
                                if (f->frametype == AST_FRAME_DTMF) {
                                        dialed_code[x++] = f->subclass.integer;
                                        dialed_code[x] = '\0';
                                        if (strlen(dialed_code) == len) {
                                                x = 0;
                                        } else if (x && strncmp(dialed_code, disconnect_code, x)) {
                                                x = 0;
                                                dialed_code[x] = '\0';
                                        }
                                        if (*dialed_code && !strcmp(dialed_code, disconnect_code)) {
                                                /* Caller Canceled the call */
                                                state = AST_CONTROL_UNHOLD;
                                                ast_frfree(f);
                                                f = NULL;
                                                break;
                                        }
                                } else if (f->frametype == AST_FRAME_VOICE || f->frametype == AST_FRAME_VIDEO) {
                                        ast_write(chan, f);
                                }
                        }
                }
                if (f)
                        ast_frfree(f);
        } /* end while */

        ast_poll_channel_del(caller, chan);
                
done:
        ast_indicate(caller, -1);
        if (chan && ready) {
                if (chan->_state == AST_STATE_UP) 
                        state = AST_CONTROL_ANSWER;
                res = 0;
        } else if (chan) {
                res = -1;
                ast_hangup(chan);
                chan = NULL;
        } else {
                res = -1;
        }
        
        if (outstate)
                *outstate = state;

        return chan;
}

void ast_channel_log(char *title, struct ast_channel *chan);

void ast_channel_log(char *title, struct ast_channel *chan) /* for debug, this is handy enough to justify keeping it in the source */
{
       ast_log(LOG_NOTICE, "______ %s (%lx)______\n", title, (unsigned long)chan);
       ast_log(LOG_NOTICE, "CHAN: name: %s;  appl: %s; data: %s; contxt: %s;  exten: %s; pri: %d;\n",
                       chan->name, chan->appl, chan->data, chan->context, chan->exten, chan->priority);
       ast_log(LOG_NOTICE, "CHAN: acctcode: %s;  dialcontext: %s; amaflags: %x; maccontxt: %s;  macexten: %s; macpri: %d;\n",
                       chan->accountcode, chan->dialcontext, chan->amaflags, chan->macrocontext, chan->macroexten, chan->macropriority);
       ast_log(LOG_NOTICE, "CHAN: masq: %p;  masqr: %p; _bridge: %p; uniqueID: %s; linkedID:%s\n",
                       chan->masq, chan->masqr,
                       chan->_bridge, chan->uniqueid, chan->linkedid);
       if (chan->masqr)
               ast_log(LOG_NOTICE, "CHAN: masquerading as: %s;  cdr: %p;\n",
                               chan->masqr->name, chan->masqr->cdr);
       if (chan->_bridge)
               ast_log(LOG_NOTICE, "CHAN: Bridged to %s\n", chan->_bridge->name);

        ast_log(LOG_NOTICE, "===== done ====\n");
}

/*!
 * \brief return the first unlocked cdr in a possible chain
*/
static struct ast_cdr *pick_unlocked_cdr(struct ast_cdr *cdr)
{
        struct ast_cdr *cdr_orig = cdr;
        while (cdr) {
                if (!ast_test_flag(cdr,AST_CDR_FLAG_LOCKED))
                        return cdr;
                cdr = cdr->next;
        }
        return cdr_orig; /* everybody LOCKED or some other weirdness, like a NULL */
}

static void set_bridge_features_on_config(struct ast_bridge_config *config, const char *features)
{
        const char *feature;

        if (ast_strlen_zero(features)) {
                return;
        }

        for (feature = features; *feature; feature++) {
                switch (*feature) {
                case 'T' :
                case 't' :
                        ast_set_flag(&(config->features_caller), AST_FEATURE_REDIRECT);
                        break;
                case 'K' :
                case 'k' :
                        ast_set_flag(&(config->features_caller), AST_FEATURE_PARKCALL);
                        break;
                case 'H' :
                case 'h' :
                        ast_set_flag(&(config->features_caller), AST_FEATURE_DISCONNECT);
                        break;
                case 'W' :
                case 'w' :
                        ast_set_flag(&(config->features_caller), AST_FEATURE_AUTOMON);
                        break;
                default :
                        ast_log(LOG_WARNING, "Skipping unknown feature code '%c'\n", *feature);
                }
        }
}

static void add_features_datastores(struct ast_channel *caller, struct ast_channel *callee, struct ast_bridge_config *config)
{
        struct ast_datastore *ds_callee_features = NULL, *ds_caller_features = NULL;
        struct ast_dial_features *callee_features = NULL, *caller_features = NULL;

        ast_channel_lock(caller);
        ds_caller_features = ast_channel_datastore_find(caller, &dial_features_info, NULL);
        ast_channel_unlock(caller);
        if (!ds_caller_features) {
                if (!(ds_caller_features = ast_datastore_alloc(&dial_features_info, NULL))) {
                        ast_log(LOG_WARNING, "Unable to create channel datastore for caller features. Aborting!\n");
                        return;
                }
                if (!(caller_features = ast_calloc(1, sizeof(*caller_features)))) {
                        ast_log(LOG_WARNING, "Unable to allocate memory for callee feature flags. Aborting!\n");
                        ast_datastore_free(ds_caller_features);
                        return;
                }
                ds_caller_features->inheritance = DATASTORE_INHERIT_FOREVER;
                caller_features->is_caller = 1;
                ast_copy_flags(&(caller_features->features_callee), &(config->features_callee), AST_FLAGS_ALL);
                ast_copy_flags(&(caller_features->features_caller), &(config->features_caller), AST_FLAGS_ALL);
                ds_caller_features->data = caller_features;
                ast_channel_lock(caller);
                ast_channel_datastore_add(caller, ds_caller_features);
                ast_channel_unlock(caller);
        } else {
                /* If we don't return here, then when we do a builtin_atxfer we will copy the disconnect
                 * flags over from the atxfer to the caller */
                return;
        }

        ast_channel_lock(callee);
        ds_callee_features = ast_channel_datastore_find(callee, &dial_features_info, NULL);
        ast_channel_unlock(callee);
        if (!ds_callee_features) {
                if (!(ds_callee_features = ast_datastore_alloc(&dial_features_info, NULL))) {
                        ast_log(LOG_WARNING, "Unable to create channel datastore for callee features. Aborting!\n");
                        return;
                }
                if (!(callee_features = ast_calloc(1, sizeof(*callee_features)))) {
                        ast_log(LOG_WARNING, "Unable to allocate memory for callee feature flags. Aborting!\n");
                        ast_datastore_free(ds_callee_features);
                        return;
                }
                ds_callee_features->inheritance = DATASTORE_INHERIT_FOREVER;
                callee_features->is_caller = 0;
                ast_copy_flags(&(callee_features->features_callee), &(config->features_caller), AST_FLAGS_ALL);
                ast_copy_flags(&(callee_features->features_caller), &(config->features_callee), AST_FLAGS_ALL);
                ds_callee_features->data = callee_features;
                ast_channel_lock(callee);
                ast_channel_datastore_add(callee, ds_callee_features);
                ast_channel_unlock(callee);
        }

        return;
}

/*!
 * \brief bridge the call and set CDR
 * \param chan,peer,config
 * 
 * Set start time, check for two channels,check if monitor on
 * check for feature activation, create new CDR
 * \retval res on success.
 * \retval -1 on failure to bridge.
*/
int ast_bridge_call(struct ast_channel *chan,struct ast_channel *peer,struct ast_bridge_config *config)
{
        /* Copy voice back and forth between the two channels.  Give the peer
           the ability to transfer calls with '#<extension' syntax. */
        struct ast_frame *f;
        struct ast_channel *who;
        char chan_featurecode[FEATURE_MAX_LEN + 1]="";
        char peer_featurecode[FEATURE_MAX_LEN + 1]="";
        char orig_channame[AST_MAX_EXTENSION];
        char orig_peername[AST_MAX_EXTENSION];
        int res;
        int diff;
        int hasfeatures=0;
        int hadfeatures=0;
        int autoloopflag;
        struct ast_option_header *aoh;
        struct ast_cdr *bridge_cdr = NULL;
        struct ast_cdr *orig_peer_cdr = NULL;
        struct ast_cdr *chan_cdr = pick_unlocked_cdr(chan->cdr); /* the proper chan cdr, if there are forked cdrs */
        struct ast_cdr *peer_cdr = pick_unlocked_cdr(peer->cdr); /* the proper chan cdr, if there are forked cdrs */
        struct ast_cdr *new_chan_cdr = NULL; /* the proper chan cdr, if there are forked cdrs */
        struct ast_cdr *new_peer_cdr = NULL; /* the proper chan cdr, if there are forked cdrs */

        if (chan && peer) {
                pbx_builtin_setvar_helper(chan, "BRIDGEPEER", peer->name);
                pbx_builtin_setvar_helper(peer, "BRIDGEPEER", chan->name);
        } else if (chan) {
                pbx_builtin_setvar_helper(chan, "BLINDTRANSFER", NULL);
        }

        set_bridge_features_on_config(config, pbx_builtin_getvar_helper(chan, "BRIDGE_FEATURES"));
        add_features_datastores(chan, peer, config);

        /* This is an interesting case.  One example is if a ringing channel gets redirected to
         * an extension that picks up a parked call.  This will make sure that the call taken
         * out of parking gets told that the channel it just got bridged to is still ringing. */
        if (chan->_state == AST_STATE_RINGING && peer->visible_indication != AST_CONTROL_RINGING) {
                ast_indicate(peer, AST_CONTROL_RINGING);
        }

        if (monitor_ok) {
                const char *monitor_exec;
                struct ast_channel *src = NULL;
                if (!monitor_app) {
                        if (!(monitor_app = pbx_findapp("Monitor")))
                                monitor_ok=0;
                }
                if ((monitor_exec = pbx_builtin_getvar_helper(chan, "AUTO_MONITOR"))) 
                        src = chan;
                else if ((monitor_exec = pbx_builtin_getvar_helper(peer, "AUTO_MONITOR")))
                        src = peer;
                if (monitor_app && src) {
                        char *tmp = ast_strdupa(monitor_exec);
                        pbx_exec(src, monitor_app, tmp);
                }
        }

        set_config_flags(chan, peer, config);

        /* Answer if need be */
        if (chan->_state != AST_STATE_UP) {
                if (ast_raw_answer(chan, 1)) {
                        return -1;
                }
        }

#ifdef FOR_DEBUG
        /* show the two channels and cdrs involved in the bridge for debug & devel purposes */
        ast_channel_log("Pre-bridge CHAN Channel info", chan);
        ast_channel_log("Pre-bridge PEER Channel info", peer);
#endif
        /* two channels are being marked as linked here */
        ast_channel_set_linkgroup(chan,peer);

        /* copy the userfield from the B-leg to A-leg if applicable */
        if (chan->cdr && peer->cdr && !ast_strlen_zero(peer->cdr->userfield)) {
                char tmp[256];
                if (!ast_strlen_zero(chan->cdr->userfield)) {
                        snprintf(tmp, sizeof(tmp), "%s;%s", chan->cdr->userfield, peer->cdr->userfield);
                        ast_cdr_appenduserfield(chan, tmp);
                } else
                        ast_cdr_setuserfield(chan, peer->cdr->userfield);
                /* free the peer's cdr without ast_cdr_free complaining */
                ast_free(peer->cdr);
                peer->cdr = NULL;
        }
        ast_copy_string(orig_channame,chan->name,sizeof(orig_channame));
        ast_copy_string(orig_peername,peer->name,sizeof(orig_peername));
        orig_peer_cdr = peer_cdr;
        
        if (!chan_cdr || (chan_cdr && !ast_test_flag(chan_cdr, AST_CDR_FLAG_POST_DISABLED))) {
                
                if (chan_cdr) {
                        ast_set_flag(chan_cdr, AST_CDR_FLAG_MAIN);
                        ast_cdr_update(chan);
                        bridge_cdr = ast_cdr_dup_unique_swap(chan_cdr);
                        ast_copy_string(bridge_cdr->lastapp, S_OR(chan->appl, ""), sizeof(bridge_cdr->lastapp));
                        ast_copy_string(bridge_cdr->lastdata, S_OR(chan->data, ""), sizeof(bridge_cdr->lastdata));
                        if (peer_cdr && !ast_strlen_zero(peer_cdr->userfield)) {
                                ast_copy_string(bridge_cdr->userfield, peer_cdr->userfield, sizeof(bridge_cdr->userfield));
                        }

                } else {
                        /* better yet, in a xfer situation, find out why the chan cdr got zapped (pun unintentional) */
                        bridge_cdr = ast_cdr_alloc(); /* this should be really, really rare/impossible? */
                        ast_copy_string(bridge_cdr->channel, chan->name, sizeof(bridge_cdr->channel));
                        ast_copy_string(bridge_cdr->dstchannel, peer->name, sizeof(bridge_cdr->dstchannel));
                        ast_copy_string(bridge_cdr->uniqueid, chan->uniqueid, sizeof(bridge_cdr->uniqueid));
                        ast_copy_string(bridge_cdr->lastapp, S_OR(chan->appl, ""), sizeof(bridge_cdr->lastapp));
                        ast_copy_string(bridge_cdr->lastdata, S_OR(chan->data, ""), sizeof(bridge_cdr->lastdata));
                        ast_cdr_setcid(bridge_cdr, chan);
                        bridge_cdr->disposition = (chan->_state == AST_STATE_UP) ?  AST_CDR_ANSWERED : AST_CDR_NULL;
                        bridge_cdr->amaflags = chan->amaflags ? chan->amaflags :  ast_default_amaflags;
                        ast_copy_string(bridge_cdr->accountcode, chan->accountcode, sizeof(bridge_cdr->accountcode));
                        /* Destination information */
                        ast_copy_string(bridge_cdr->dst, chan->exten, sizeof(bridge_cdr->dst));
                        ast_copy_string(bridge_cdr->dcontext, chan->context, sizeof(bridge_cdr->dcontext));
                        if (peer_cdr) {
                                bridge_cdr->start = peer_cdr->start;
                                ast_copy_string(bridge_cdr->userfield, peer_cdr->userfield, sizeof(bridge_cdr->userfield));
                        } else {
                                ast_cdr_start(bridge_cdr);
                        }
                }
                ast_debug(4,"bridge answer set, chan answer set\n");
                /* peer_cdr->answer will be set when a macro runs on the peer;
                   in that case, the bridge answer will be delayed while the
                   macro plays on the peer channel. The peer answered the call
                   before the macro started playing. To the phone system,
                   this is billable time for the call, even tho the caller
                   hears nothing but ringing while the macro does its thing. */

                /* Another case where the peer cdr's time will be set, is when
                   A self-parks by pickup up phone and dialing 700, then B
                   picks up A by dialing its parking slot; there may be more 
                   practical paths that get the same result, tho... in which
                   case you get the previous answer time from the Park... which
                   is before the bridge's start time, so I added in the 
                   tvcmp check to the if below */

                if (peer_cdr && !ast_tvzero(peer_cdr->answer) && ast_tvcmp(peer_cdr->answer, bridge_cdr->start) >= 0) {
                        bridge_cdr->answer = peer_cdr->answer;
                        bridge_cdr->disposition = peer_cdr->disposition;
                        if (chan_cdr) {
                                chan_cdr->answer = peer_cdr->answer;
                                chan_cdr->disposition = peer_cdr->disposition;
                        }
                } else {
                        ast_cdr_answer(bridge_cdr);
                        if (chan_cdr) {
                                ast_cdr_answer(chan_cdr); /* for the sake of cli status checks */
                        }
                }
                if (ast_test_flag(chan,AST_FLAG_BRIDGE_HANGUP_DONT) && (chan_cdr || peer_cdr)) {
                        if (chan_cdr) {
                                ast_set_flag(chan_cdr, AST_CDR_FLAG_BRIDGED);
                        }
                        if (peer_cdr) {
                                ast_set_flag(peer_cdr, AST_CDR_FLAG_BRIDGED);
                        }
                }
        }
        ast_cel_report_event(chan, AST_CEL_BRIDGE_START, NULL, NULL, NULL);
        for (;;) {
                struct ast_channel *other;      /* used later */
        
                res = ast_channel_bridge(chan, peer, config, &f, &who);
                
                /* When frame is not set, we are probably involved in a situation
                   where we've timed out.
                   When frame is set, we'll come this code twice; once for DTMF_BEGIN
                   and also for DTMF_END. If we flow into the following 'if' for both, then 
                   our wait times are cut in half, as both will subtract from the
                   feature_timer. Not good!
                */
                if (config->feature_timer && (!f || f->frametype == AST_FRAME_DTMF_END)) {
                        /* Update feature timer for next pass */
                        diff = ast_tvdiff_ms(ast_tvnow(), config->feature_start_time);
                        if (res == AST_BRIDGE_RETRY) {
                                /* The feature fully timed out but has not been updated. Skip
                                 * the potential round error from the diff calculation and
                                 * explicitly set to expired. */
                                config->feature_timer = -1;
                        } else {
                                config->feature_timer -= diff;
                        }

                        if (hasfeatures) {
                                if (config->feature_timer <= 0) {
                                        /* Not *really* out of time, just out of time for
                                           digits to come in for features. */
                                        ast_debug(1, "Timed out for feature!\n");
                                        if (!ast_strlen_zero(peer_featurecode)) {
                                                ast_dtmf_stream(chan, peer, peer_featurecode, 0, 0);
                                                memset(peer_featurecode, 0, sizeof(peer_featurecode));
                                        }
                                        if (!ast_strlen_zero(chan_featurecode)) {
                                                ast_dtmf_stream(peer, chan, chan_featurecode, 0, 0);
                                                memset(chan_featurecode, 0, sizeof(chan_featurecode));
                                        }
                                        if (f)
                                                ast_frfree(f);
                                        hasfeatures = !ast_strlen_zero(chan_featurecode) || !ast_strlen_zero(peer_featurecode);
                                        if (!hasfeatures) {
                                                /* No more digits expected - reset the timer */
                                                config->feature_timer = 0;
                                        }
                                        hadfeatures = hasfeatures;
                                        /* Continue as we were */
                                        continue;
                                } else if (!f) {
                                        /* The bridge returned without a frame and there is a feature in progress.
                                         * However, we don't think the feature has quite yet timed out, so just
                                         * go back into the bridge. */
                                        continue;
                                }
                        } else {
                                if (config->feature_timer <=0) {
                                        /* We ran out of time */
                                        config->feature_timer = 0;
                                        who = chan;
                                        if (f)
                                                ast_frfree(f);
                                        f = NULL;
                                        res = 0;
                                }
                        }
                }
                if (res < 0) {
                        if (!ast_test_flag(chan, AST_FLAG_ZOMBIE) && !ast_test_flag(peer, AST_FLAG_ZOMBIE) && !ast_check_