chan_local.c

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 1999 - 2005, 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
 *
 * \author Mark Spencer <markster@digium.com>
 *
 * \brief Local Proxy Channel
 * 
 * \ingroup channel_drivers
 */

/*** MODULEINFO
   <support_level>core</support_level>
 ***/

#include "asterisk.h"

ASTERISK_FILE_VERSION(__FILE__, "$Revision: 353685 $")

#include <fcntl.h>
#include <sys/signal.h>

#include "asterisk/lock.h"
#include "asterisk/channel.h"
#include "asterisk/config.h"
#include "asterisk/module.h"
#include "asterisk/pbx.h"
#include "asterisk/sched.h"
#include "asterisk/io.h"
#include "asterisk/acl.h"
#include "asterisk/callerid.h"
#include "asterisk/file.h"
#include "asterisk/cli.h"
#include "asterisk/app.h"
#include "asterisk/musiconhold.h"
#include "asterisk/manager.h"
#include "asterisk/stringfields.h"
#include "asterisk/devicestate.h"
#include "asterisk/astobj2.h"

/*** DOCUMENTATION
   <manager name="LocalOptimizeAway" language="en_US">
      <synopsis>
         Optimize away a local channel when possible.
      </synopsis>
      <syntax>
         <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
         <parameter name="Channel" required="true">
            <para>The channel name to optimize away.</para>
         </parameter>
      </syntax>
      <description>
         <para>A local channel created with "/n" will not automatically optimize away.
         Calling this command on the local channel will clear that flag and allow
         it to optimize away if it's bridged or when it becomes bridged.</para>
      </description>
   </manager>
 ***/

static const char tdesc[] = "Local Proxy Channel Driver";

#define IS_OUTBOUND(a,b) (a == b->chan ? 1 : 0)

/* right now we are treating the locals astobj2 container as a
 * list.  If there is ever a reason to make this more efficient
 * increasing the bucket size would help. */
static const int BUCKET_SIZE = 1;

static struct ao2_container *locals;

static struct ast_jb_conf g_jb_conf = {
   .flags = 0,
   .max_size = -1,
   .resync_threshold = -1,
   .impl = "",
   .target_extra = -1,
};

static struct ast_channel *local_request(const char *type, struct ast_format_cap *cap, const struct ast_channel *requestor, const char *data, int *cause);
static int local_digit_begin(struct ast_channel *ast, char digit);
static int local_digit_end(struct ast_channel *ast, char digit, unsigned int duration);
static int local_call(struct ast_channel *ast, const char *dest, int timeout);
static int local_hangup(struct ast_channel *ast);
static int local_answer(struct ast_channel *ast);
static struct ast_frame *local_read(struct ast_channel *ast);
static int local_write(struct ast_channel *ast, struct ast_frame *f);
static int local_indicate(struct ast_channel *ast, int condition, const void *data, size_t datalen);
static int local_fixup(struct ast_channel *oldchan, struct ast_channel *newchan);
static int local_sendhtml(struct ast_channel *ast, int subclass, const char *data, int datalen);
static int local_sendtext(struct ast_channel *ast, const char *text);
static int local_devicestate(const char *data);
static struct ast_channel *local_bridgedchannel(struct ast_channel *chan, struct ast_channel *bridge);
static int local_queryoption(struct ast_channel *ast, int option, void *data, int *datalen);
static int local_setoption(struct ast_channel *chan, int option, void *data, int datalen);

/* PBX interface structure for channel registration */
static struct ast_channel_tech local_tech = {
   .type = "Local",
   .description = tdesc,
   .requester = local_request,
   .send_digit_begin = local_digit_begin,
   .send_digit_end = local_digit_end,
   .call = local_call,
   .hangup = local_hangup,
   .answer = local_answer,
   .read = local_read,
   .write = local_write,
   .write_video = local_write,
   .exception = local_read,
   .indicate = local_indicate,
   .fixup = local_fixup,
   .send_html = local_sendhtml,
   .send_text = local_sendtext,
   .devicestate = local_devicestate,
   .bridged_channel = local_bridgedchannel,
   .queryoption = local_queryoption,
   .setoption = local_setoption,
};

/*! \brief the local pvt structure for all channels

   The local channel pvt has two ast_chan objects - the "owner" and the "next channel", the outbound channel

   ast_chan owner -> local_pvt -> ast_chan chan -> yet-another-pvt-depending-on-channel-type

*/
struct local_pvt {
   unsigned int flags;             /*!< Private flags */
   char context[AST_MAX_CONTEXT];  /*!< Context to call */
   char exten[AST_MAX_EXTENSION];  /*!< Extension to call */
   struct ast_format_cap *reqcap;  /*!< Requested format capabilities */
   struct ast_jb_conf jb_conf;     /*!< jitterbuffer configuration for this local channel */
   struct ast_channel *owner;      /*!< Master Channel - Bridging happens here */
   struct ast_channel *chan;       /*!< Outbound channel - PBX is run here */
   struct ast_module_user *u_owner;/*!< reference to keep the module loaded while in use */
   struct ast_module_user *u_chan; /*!< reference to keep the module loaded while in use */
};

#define LOCAL_ALREADY_MASQED  (1 << 0) /*!< Already masqueraded */
#define LOCAL_LAUNCHED_PBX    (1 << 1) /*!< PBX was launched */
#define LOCAL_NO_OPTIMIZATION (1 << 2) /*!< Do not optimize using masquerading */
#define LOCAL_BRIDGE          (1 << 3) /*!< Report back the "true" channel as being bridged to */
#define LOCAL_MOH_PASSTHRU    (1 << 4) /*!< Pass through music on hold start/stop frames */

/* 
 * \brief Send a pvt in with no locks held and get all locks
 *
 * \note NO locks should be held prior to calling this function
 * \note The pvt must have a ref held before calling this function
 * \note if outchan or outowner is set != NULL after calling this function
 *       those channels are locked and reffed.
 * \note Batman.
 */
static void awesome_locking(struct local_pvt *p, struct ast_channel **outchan, struct ast_channel **outowner)
{
   struct ast_channel *chan = NULL;
   struct ast_channel *owner = NULL;

   for (;;) {
      ao2_lock(p);
      if (p->chan) {
         chan = p->chan;
         ast_channel_ref(chan);
      }
      if (p->owner) {
         owner = p->owner;
         ast_channel_ref(owner);
      }
      ao2_unlock(p);

      /* if we don't have both channels, then this is very easy */
      if (!owner || !chan) {
         if (owner) {
            ast_channel_lock(owner);
         } else if(chan) {
            ast_channel_lock(chan);
         }
         ao2_lock(p);
      } else {
         /* lock both channels first, then get the pvt lock */
         ast_channel_lock(chan);
         while (ast_channel_trylock(owner)) {
            CHANNEL_DEADLOCK_AVOIDANCE(chan);
         }
         ao2_lock(p);
      }

      /* Now that we have all the locks, validate that nothing changed */
      if (p->owner != owner || p->chan != chan) {
         if (owner) {
            ast_channel_unlock(owner);
            owner = ast_channel_unref(owner);
         }
         if (chan) {
            ast_channel_unlock(chan);
            chan = ast_channel_unref(chan);
         }
         ao2_unlock(p);
         continue;
      }

      break;
   }
   *outowner = p->owner;
   *outchan = p->chan;
}

/* Called with ast locked */
static int local_setoption(struct ast_channel *ast, int option, void * data, int datalen)
{
   int res = 0;
   struct local_pvt *p = NULL;
   struct ast_channel *otherchan = NULL;
   ast_chan_write_info_t *write_info;

   if (option != AST_OPTION_CHANNEL_WRITE) {
      return -1;
   }

   write_info = data;

   if (write_info->version != AST_CHAN_WRITE_INFO_T_VERSION) {
      ast_log(LOG_ERROR, "The chan_write_info_t type has changed, and this channel hasn't been updated!\n");
      return -1;
   }

   /* get the tech pvt */
   if (!(p = ast->tech_pvt)) {
      return -1;
   }
   ao2_ref(p, 1);
   ast_channel_unlock(ast); /* Held when called, unlock before locking another channel */

   /* get the channel we are supposed to write to */
   ao2_lock(p);
   otherchan = (write_info->chan == p->owner) ? p->chan : p->owner;
   if (!otherchan || otherchan == write_info->chan) {
      res = -1;
      otherchan = NULL;
      ao2_unlock(p);
      goto setoption_cleanup;
   }
   ast_channel_ref(otherchan);

   /* clear the pvt lock before grabbing the channel */
   ao2_unlock(p);

   ast_channel_lock(otherchan);
   res = write_info->write_fn(otherchan, write_info->function, write_info->data, write_info->value);
   ast_channel_unlock(otherchan);

setoption_cleanup:
   if (p) {
      ao2_ref(p, -1);
   }
   if (otherchan) {
      ast_channel_unref(otherchan);
   }
   ast_channel_lock(ast); /* Lock back before we leave */
   return res;
}

/*! \brief Adds devicestate to local channels */
static int local_devicestate(const char *data)
{
   char *exten = ast_strdupa(data);
   char *context = NULL, *opts = NULL;
   int res;
   struct local_pvt *lp;
   struct ao2_iterator it;

   if (!(context = strchr(exten, '@'))) {
      ast_log(LOG_WARNING, "Someone used Local/%s somewhere without a @context. This is bad.\n", exten);
      return AST_DEVICE_INVALID;
   }

   *context++ = '\0';

   /* Strip options if they exist */
   if ((opts = strchr(context, '/')))
      *opts = '\0';

   ast_debug(3, "Checking if extension %s@%s exists (devicestate)\n", exten, context);

   res = ast_exists_extension(NULL, context, exten, 1, NULL);
   if (!res)
      return AST_DEVICE_INVALID;

   res = AST_DEVICE_NOT_INUSE;

   it = ao2_iterator_init(locals, 0);
   while ((lp = ao2_iterator_next(&it))) {
      if (!strcmp(exten, lp->exten) && !strcmp(context, lp->context) && lp->owner) {
         res = AST_DEVICE_INUSE;
         ao2_ref(lp, -1);
         break;
      }
      ao2_ref(lp, -1);
   }
   ao2_iterator_destroy(&it);

   return res;
}

/*! \brief Return the bridged channel of a Local channel */
static struct ast_channel *local_bridgedchannel(struct ast_channel *chan, struct ast_channel *bridge)
{
   struct local_pvt *p = bridge->tech_pvt;
   struct ast_channel *bridged = bridge;

   if (!p) {
      ast_debug(1, "Asked for bridged channel on '%s'/'%s', returning <none>\n",
         ast_channel_name(chan), ast_channel_name(bridge));
      return NULL;
   }

   ao2_lock(p);

   if (ast_test_flag(p, LOCAL_BRIDGE)) {
      /* Find the opposite channel */
      bridged = (bridge == p->owner ? p->chan : p->owner);

      /* Now see if the opposite channel is bridged to anything */
      if (!bridged) {
         bridged = bridge;
      } else if (bridged->_bridge) {
         bridged = bridged->_bridge;
      }
   }

   ao2_unlock(p);

   return bridged;
}

/* Called with ast locked */
static int local_queryoption(struct ast_channel *ast, int option, void *data, int *datalen)
{
   struct local_pvt *p;
   struct ast_channel *bridged = NULL;
   struct ast_channel *tmp = NULL;
   int res = 0;

   if (option != AST_OPTION_T38_STATE) {
      /* AST_OPTION_T38_STATE is the only supported option at this time */
      return -1;
   }

   /* for some reason the channel is not locked in channel.c when this function is called */
   if (!(p = ast->tech_pvt)) {
      return -1;
   }

   ao2_lock(p);
   if (!(tmp = IS_OUTBOUND(ast, p) ? p->owner : p->chan)) {
      ao2_unlock(p);
      return -1;
   }
   ast_channel_ref(tmp);
   ao2_unlock(p);
   ast_channel_unlock(ast); /* Held when called, unlock before locking another channel */

   ast_channel_lock(tmp);
   if (!(bridged = ast_bridged_channel(tmp))) {
      res = -1;
      ast_channel_unlock(tmp);
      goto query_cleanup;
   }
   ast_channel_ref(bridged);
   ast_channel_unlock(tmp);

query_cleanup:
   if (bridged) {
      res = ast_channel_queryoption(bridged, option, data, datalen, 0);
      bridged = ast_channel_unref(bridged);
   }
   if (tmp) {
      tmp = ast_channel_unref(tmp);
   }
   ast_channel_lock(ast); /* Lock back before we leave */

   return res;
}

/*! \brief queue a frame on a to either the p->owner or p->chan
 *
 * \note the local_pvt MUST have it's ref count bumped before entering this function and
 * decremented after this function is called.  This is a side effect of the deadlock
 * avoidance that is necessary to lock 2 channels and a tech_pvt.  Without a ref counted
 * local_pvt, it is impossible to guarantee it will not be destroyed by another thread
 * during deadlock avoidance.
 */
static int local_queue_frame(struct local_pvt *p, int isoutbound, struct ast_frame *f,
   struct ast_channel *us, int us_locked)
{
   struct ast_channel *other = NULL;

   /* Recalculate outbound channel */
   other = isoutbound ? p->owner : p->chan;

   if (!other) {
      return 0;
   }

   /* do not queue frame if generator is on both local channels */
   if (us && us->generator && other->generator) {
      return 0;
   }

   /* grab a ref on the channel before unlocking the pvt,
    * other can not go away from us now regardless of locking */
   ast_channel_ref(other);
   if (us && us_locked) {
      ast_channel_unlock(us);
   }
   ao2_unlock(p);

   if (f->frametype == AST_FRAME_CONTROL && f->subclass.integer == AST_CONTROL_RINGING) {
      ast_setstate(other, AST_STATE_RINGING);
   }
   ast_queue_frame(other, f);

   other = ast_channel_unref(other);
   if (us && us_locked) {
      ast_channel_lock(us);
   }
   ao2_lock(p);

   return 0;
}

static int local_answer(struct ast_channel *ast)
{
   struct local_pvt *p = ast->tech_pvt;
   int isoutbound;
   int res = -1;

   if (!p) {
      return -1;
   }

   ao2_lock(p);
   ao2_ref(p, 1);
   isoutbound = IS_OUTBOUND(ast, p);
   if (isoutbound) {
      /* Pass along answer since somebody answered us */
      struct ast_frame answer = { AST_FRAME_CONTROL, { AST_CONTROL_ANSWER } };
      res = local_queue_frame(p, isoutbound, &answer, ast, 1);
   } else {
      ast_log(LOG_WARNING, "Huh?  Local is being asked to answer?\n");
   }
   ao2_unlock(p);
   ao2_ref(p, -1);
   return res;
}

/*!
 * \internal
 * \note This function assumes that we're only called from the "outbound" local channel side
 *
 * \note it is assummed p is locked and reffed before entering this function
 */
static void check_bridge(struct local_pvt *p)
{
   struct ast_channel_monitor *tmp;
   struct ast_channel *chan = NULL;
   struct ast_channel *bridged_chan = NULL;

   /* Do a few conditional checks early on just to see if this optimization is possible */
   if (ast_test_flag(p, LOCAL_NO_OPTIMIZATION)) {
      return;
   }
   if (ast_test_flag(p, LOCAL_ALREADY_MASQED) || !p->chan || !p->owner) {
      return;
   }

   /* Safely get the channel bridged to p->chan */
   chan = ast_channel_ref(p->chan);

   ao2_unlock(p); /* don't call bridged channel with the pvt locked */
   bridged_chan = ast_bridged_channel(chan);
   ao2_lock(p);

   chan = ast_channel_unref(chan);

   /* since we had to unlock p to get the bridged chan, validate our
    * data once again and verify the bridged channel is what we expect
    * it to be in order to perform this optimization */
   if (ast_test_flag(p, LOCAL_ALREADY_MASQED) || !p->owner || !p->chan || (p->chan->_bridge != bridged_chan)) {
      return;
   }

   /* only do the masquerade if we are being called on the outbound channel,
      if it has been bridged to another channel and if there are no pending
      frames on the owner channel (because they would be transferred to the
      outbound channel during the masquerade)
   */
   if (p->chan->_bridge /* Not ast_bridged_channel!  Only go one step! */ && AST_LIST_EMPTY(&p->owner->readq)) {
      /* Masquerade bridged channel into owner */
      /* Lock everything we need, one by one, and give up if
         we can't get everything.  Remember, we'll get another
         chance in just a little bit */
      if (!ast_channel_trylock(p->chan->_bridge)) {
         if (!ast_check_hangup(p->chan->_bridge)) {
            if (!ast_channel_trylock(p->owner)) {
               if (!ast_check_hangup(p->owner)) {
                  if (p->owner->monitor && !p->chan->_bridge->monitor) {
                     /* If a local channel is being monitored, we don't want a masquerade
                      * to cause the monitor to go away. Since the masquerade swaps the monitors,
                      * pre-swapping the monitors before the masquerade will ensure that the monitor
                      * ends up where it is expected.
                      */
                     tmp = p->owner->monitor;
                     p->owner->monitor = p->chan->_bridge->monitor;
                     p->chan->_bridge->monitor = tmp;
                  }
                  if (p->chan->audiohooks) {
                     struct ast_audiohook_list *audiohooks_swapper;
                     audiohooks_swapper = p->chan->audiohooks;
                     p->chan->audiohooks = p->owner->audiohooks;
                     p->owner->audiohooks = audiohooks_swapper;
                  }

                  /* If any Caller ID was set, preserve it after masquerade like above. We must check
                   * to see if Caller ID was set because otherwise we'll mistakingly copy info not
                   * set from the dialplan and will overwrite the real channel Caller ID. The reason
                   * for this whole preswapping action is because the Caller ID is set on the channel
                   * thread (which is the to be masqueraded away local channel) before both local
                   * channels are optimized away.
                   */
                  if (p->owner->caller.id.name.valid || p->owner->caller.id.number.valid
                     || p->owner->caller.id.subaddress.valid || p->owner->caller.ani.name.valid
                     || p->owner->caller.ani.number.valid || p->owner->caller.ani.subaddress.valid) {
                     struct ast_party_caller tmp;
                     tmp = p->owner->caller;
                     p->owner->caller = p->chan->_bridge->caller;
                     p->chan->_bridge->caller = tmp;
                  }
                  if (p->owner->redirecting.from.name.valid || p->owner->redirecting.from.number.valid
                     || p->owner->redirecting.from.subaddress.valid || p->owner->redirecting.to.name.valid
                     || p->owner->redirecting.to.number.valid || p->owner->redirecting.to.subaddress.valid) {
                     struct ast_party_redirecting tmp;
                     tmp = p->owner->redirecting;
                     p->owner->redirecting = p->chan->_bridge->redirecting;
                     p->chan->_bridge->redirecting = tmp;
                  }
                  if (p->owner->dialed.number.str || p->owner->dialed.subaddress.valid) {
                     struct ast_party_dialed tmp;
                     tmp = p->owner->dialed;
                     p->owner->dialed = p->chan->_bridge->dialed;
                     p->chan->_bridge->dialed = tmp;
                  }


                  ast_app_group_update(p->chan, p->owner);
                  ast_channel_masquerade(p->owner, p->chan->_bridge);
                  ast_set_flag(p, LOCAL_ALREADY_MASQED);
               }
               ast_channel_unlock(p->owner);
            }
         }
         ast_channel_unlock(p->chan->_bridge);
      }
   }
}

static struct ast_frame  *local_read(struct ast_channel *ast)
{
   return &ast_null_frame;
}

static int local_write(struct ast_channel *ast, struct ast_frame *f)
{
   struct local_pvt *p = ast->tech_pvt;
   int res = -1;
   int isoutbound;

   if (!p) {
      return -1;
   }

   /* Just queue for delivery to the other side */
   ao2_ref(p, 1); /* ref for local_queue_frame */
   ao2_lock(p);
   isoutbound = IS_OUTBOUND(ast, p);

   if (isoutbound && f && (f->frametype == AST_FRAME_VOICE || f->frametype == AST_FRAME_VIDEO)) {
      check_bridge(p);
   }

   if (!ast_test_flag(p, LOCAL_ALREADY_MASQED)) {
      res = local_queue_frame(p, isoutbound, f, ast, 1);
   } else {
      ast_debug(1, "Not posting to queue since already masked on '%s'\n", ast_channel_name(ast));
      res = 0;
   }
   ao2_unlock(p);
   ao2_ref(p, -1);

   return res;
}

static int local_fixup(struct ast_channel *oldchan, struct ast_channel *newchan)
{
   struct local_pvt *p = newchan->tech_pvt;

   if (!p) {
      return -1;
   }

   ao2_lock(p);

   if ((p->owner != oldchan) && (p->chan != oldchan)) {
      ast_log(LOG_WARNING, "Old channel wasn't %p but was %p/%p\n", oldchan, p->owner, p->chan);
      ao2_unlock(p);
      return -1;
   }
   if (p->owner == oldchan) {
      p->owner = newchan;
   } else {
      p->chan = newchan;
   }

   /* Do not let a masquerade cause a Local channel to be bridged to itself! */
   if (!ast_check_hangup(newchan) && ((p->owner && p->owner->_bridge == p->chan) || (p->chan && p->chan->_bridge == p->owner))) {
      ast_log(LOG_WARNING, "You can not bridge a Local channel to itself!\n");
      ao2_unlock(p);
      ast_queue_hangup(newchan);
      return -1;
   }

   ao2_unlock(p);
   return 0;
}

static int local_indicate(struct ast_channel *ast, int condition, const void *data, size_t datalen)
{
   struct local_pvt *p = ast->tech_pvt;
   int res = 0;
   struct ast_frame f = { AST_FRAME_CONTROL, };
   int isoutbound;

   if (!p) {
      return -1;
   }

   ao2_ref(p, 1); /* ref for local_queue_frame */

   /* If this is an MOH hold or unhold, do it on the Local channel versus real channel */
   if (!ast_test_flag(p, LOCAL_MOH_PASSTHRU) && condition == AST_CONTROL_HOLD) {
      ast_moh_start(ast, data, NULL);
   } else if (!ast_test_flag(p, LOCAL_MOH_PASSTHRU) && condition == AST_CONTROL_UNHOLD) {
      ast_moh_stop(ast);
   } else if (condition == AST_CONTROL_CONNECTED_LINE || condition == AST_CONTROL_REDIRECTING) {
      struct ast_channel *this_channel;
      struct ast_channel *the_other_channel;
      /* A connected line update frame may only contain a partial amount of data, such
       * as just a source, or just a ton, and not the full amount of information. However,
       * the collected information is all stored in the outgoing channel's connectedline
       * structure, so when receiving a connected line update on an outgoing local channel,
       * we need to transmit the collected connected line information instead of whatever
       * happens to be in this control frame. The same applies for redirecting information, which
       * is why it is handled here as well.*/
      ao2_lock(p);
      isoutbound = IS_OUTBOUND(ast, p);
      if (isoutbound) {
         this_channel = p->chan;
         the_other_channel = p->owner;
      } else {
         this_channel = p->owner;
         the_other_channel = p->chan;
      }
      if (the_other_channel) {
         unsigned char frame_data[1024];
         if (condition == AST_CONTROL_CONNECTED_LINE) {
            if (isoutbound) {
               ast_connected_line_copy_to_caller(&the_other_channel->caller, &this_channel->connected);
            }
            f.datalen = ast_connected_line_build_data(frame_data, sizeof(frame_data), &this_channel->connected, NULL);
         } else {
            f.datalen = ast_redirecting_build_data(frame_data, sizeof(frame_data), &this_channel->redirecting, NULL);
         }
         f.subclass.integer = condition;
         f.data.ptr = frame_data;
         res = local_queue_frame(p, isoutbound, &f, ast, 1);
      }
      ao2_unlock(p);
   } else {
      /* Queue up a frame representing the indication as a control frame */
      ao2_lock(p);
      isoutbound = IS_OUTBOUND(ast, p);
      f.subclass.integer = condition;
      f.data.ptr = (void*)data;
      f.datalen = datalen;
      res = local_queue_frame(p, isoutbound, &f, ast, 1);
      ao2_unlock(p);
   }

   ao2_ref(p, -1);
   return res;
}

static int local_digit_begin(struct ast_channel *ast, char digit)
{
   struct local_pvt *p = ast->tech_pvt;
   int res = -1;
   struct ast_frame f = { AST_FRAME_DTMF_BEGIN, };
   int isoutbound;

   if (!p) {
      return -1;
   }

   ao2_ref(p, 1); /* ref for local_queue_frame */
   ao2_lock(p);
   isoutbound = IS_OUTBOUND(ast, p);
   f.subclass.integer = digit;
   res = local_queue_frame(p, isoutbound, &f, ast, 0);
   ao2_unlock(p);
   ao2_ref(p, -1);

   return res;
}

static int local_digit_end(struct ast_channel *ast, char digit, unsigned int duration)
{
   struct local_pvt *p = ast->tech_pvt;
   int res = -1;
   struct ast_frame f = { AST_FRAME_DTMF_END, };
   int isoutbound;

   if (!p) {
      return -1;
   }

   ao2_ref(p, 1); /* ref for local_queue_frame */
   ao2_lock(p);
   isoutbound = IS_OUTBOUND(ast, p);
   f.subclass.integer = digit;
   f.len = duration;
   res = local_queue_frame(p, isoutbound, &f, ast, 0);
   ao2_unlock(p);
   ao2_ref(p, -1);

   return res;
}

static int local_sendtext(struct ast_channel *ast, const char *text)
{
   struct local_pvt *p = ast->tech_pvt;
   int res = -1;
   struct ast_frame f = { AST_FRAME_TEXT, };
   int isoutbound;

   if (!p) {
      return -1;
   }

   ao2_lock(p);
   ao2_ref(p, 1); /* ref for local_queue_frame */
   isoutbound = IS_OUTBOUND(ast, p);
   f.data.ptr = (char *) text;
   f.datalen = strlen(text) + 1;
   res = local_queue_frame(p, isoutbound, &f, ast, 0);
   ao2_unlock(p);
   ao2_ref(p, -1);
   return res;
}

static int local_sendhtml(struct ast_channel *ast, int subclass, const char *data, int datalen)
{
   struct local_pvt *p = ast->tech_pvt;
   int res = -1;
   struct ast_frame f = { AST_FRAME_HTML, };
   int isoutbound;

   if (!p) {
      return -1;
   }

   ao2_lock(p);
   ao2_ref(p, 1); /* ref for local_queue_frame */
   isoutbound = IS_OUTBOUND(ast, p);
   f.subclass.integer = subclass;
   f.data.ptr = (char *)data;
   f.datalen = datalen;
   res = local_queue_frame(p, isoutbound, &f, ast, 0);
   ao2_unlock(p);
   ao2_ref(p, -1);

   return res;
}

/*! \brief Initiate new call, part of PBX interface
 *         dest is the dial string */
static int local_call(struct ast_channel *ast, const char *dest, int timeout)
{
   struct local_pvt *p = ast->tech_pvt;
   int pvt_locked = 0;

   struct ast_channel *owner = NULL;
   struct ast_channel *chan = NULL;
   int res;
   struct ast_var_t *varptr = NULL, *new;
   size_t len, namelen;
   char *reduced_dest = ast_strdupa(dest);
   char *slash;
   const char *exten;
   const char *context;

   if (!p) {
      return -1;
   }

   /* since we are letting go of channel locks that were locked coming into
    * this function, then we need to give the tech pvt a ref */
   ao2_ref(p, 1);
   ast_channel_unlock(ast);

   awesome_locking(p, &chan, &owner);
   pvt_locked = 1;

   if (owner != ast) {
      res = -1;
      goto return_cleanup;
   }

   if (!owner || !chan) {
      res = -1;
      goto return_cleanup;
   }

   /*
    * Note that cid_num and cid_name aren't passed in the ast_channel_alloc
    * call, so it's done here instead.
    *
    * All these failure points just return -1. The individual strings will
    * be cleared when we destroy the channel.
    */
   ast_party_redirecting_copy(&chan->redirecting, &owner->redirecting);

   ast_party_dialed_copy(&chan->dialed, &owner->dialed);

   ast_connected_line_copy_to_caller(&chan->caller, &owner->connected);
   ast_connected_line_copy_from_caller(&chan->connected, &owner->caller);

   ast_channel_language_set(chan, ast_channel_language(owner));
   ast_channel_accountcode_set(chan, ast_channel_accountcode(owner));
   ast_channel_musicclass_set(chan, ast_channel_musicclass(owner));
   ast_cdr_update(chan);

   ast_channel_cc_params_init(chan, ast_channel_get_cc_config_params(owner));

   /* Make sure we inherit the ANSWERED_ELSEWHERE flag if it's set on the queue/dial call request in the dialplan */
   if (ast_test_flag(ast, AST_FLAG_ANSWERED_ELSEWHERE)) {
      ast_set_flag(chan, AST_FLAG_ANSWERED_ELSEWHERE);
   }

   /* copy the channel variables from the incoming channel to the outgoing channel */
   /* Note that due to certain assumptions, they MUST be in the same order */
   AST_LIST_TRAVERSE(&owner->varshead, varptr, entries) {
      namelen = strlen(varptr->name);
      len = sizeof(struct ast_var_t) + namelen + strlen(varptr->value) + 2;
      if ((new = ast_calloc(1, len))) {
         memcpy(new, varptr, len);
         new->value = &(new->name[0]) + namelen + 1;
         AST_LIST_INSERT_TAIL(&chan->varshead, new, entries);
      }
   }
   ast_channel_datastore_inherit(owner, chan);
   /* If the local channel has /n or /b on the end of it,
    * we need to lop that off for our argument to setting
    * up the CC_INTERFACES variable
    */
   if ((slash = strrchr(reduced_dest, '/'))) {
      *slash = '\0';
   }
   ast_set_cc_interfaces_chanvar(chan, reduced_dest);

   exten = ast_strdupa(chan->exten);
   context = ast_strdupa(chan->context);

   ao2_unlock(p);
   pvt_locked = 0;

   ast_channel_unlock(chan);

   if (!ast_exists_extension(chan, context, exten, 1,
      S_COR(owner->caller.id.number.valid, owner->caller.id.number.str, NULL))) {
      ast_log(LOG_NOTICE, "No such extension/context %s@%s while calling Local channel\n", exten, context);
      res = -1;
      chan = ast_channel_unref(chan); /* we already unlocked it, so clear it hear so the cleanup label won't touch it. */
      goto return_cleanup;
   }

   manager_event(EVENT_FLAG_CALL, "LocalBridge",
            "Channel1: %s\r\n"
            "Channel2: %s\r\n"
            "Uniqueid1: %s\r\n"
            "Uniqueid2: %s\r\n"
            "Context: %s\r\n"
            "Exten: %s\r\n"
            "LocalOptimization: %s\r\n",
         ast_channel_name(p->owner), ast_channel_name(p->chan), ast_channel_uniqueid(p->owner), ast_channel_uniqueid(p->chan),
         p->context, p->exten,
         ast_test_flag(p, LOCAL_NO_OPTIMIZATION) ? "Yes" : "No");


   /* Start switch on sub channel */
   if (!(res = ast_pbx_start(chan))) {
      ao2_lock(p);
      ast_set_flag(p, LOCAL_LAUNCHED_PBX);
      ao2_unlock(p);
   }
   chan = ast_channel_unref(chan); /* chan is already unlocked, clear it here so the cleanup lable won't touch it. */

return_cleanup:
   if (p) {
      if (pvt_locked) {
         ao2_unlock(p);
      }
      ao2_ref(p, -1);
   }
   if (chan) {
      ast_channel_unlock(chan);
      chan = ast_channel_unref(chan);
   }

   /* owner is supposed to be == to ast,  if it
    * is, don't unlock it because ast must exit locked */
   if (owner) {
      if (owner != ast) {
         ast_channel_unlock(owner);
         ast_channel_lock(ast);
      }
      owner = ast_channel_unref(owner);
   } else {
      /* we have to exit with ast locked */
      ast_channel_lock(ast);
   }

   return res;
}

/*! \brief Hangup a call through the local proxy channel */
static int local_hangup(struct ast_channel *ast)
{
   struct local_pvt *p = ast->tech_pvt;
   int isoutbound;
   int hangup_chan = 0;
   int res = 0;
   struct ast_frame f = { AST_FRAME_CONTROL, { AST_CONTROL_HANGUP }, .data.uint32 = ast->hangupcause };
   struct ast_channel *owner = NULL;
   struct ast_channel *chan = NULL;

   if (!p) {
      return -1;
   }

   /* give the pvt a ref since we are unlocking the channel. */
   ao2_ref(p, 1);

   /* the pvt isn't going anywhere, we gave it a ref */
   ast_channel_unlock(ast);

   /* lock everything */
   awesome_locking(p, &chan, &owner);

   if (ast != chan && ast != owner) {
      res = -1;
      goto local_hangup_cleanup;
   }

   isoutbound = IS_OUTBOUND(ast, p); /* just comparing pointer of ast */

   if (p->chan && ast_test_flag(ast, AST_FLAG_ANSWERED_ELSEWHERE)) {
      ast_set_flag(p->chan, AST_FLAG_ANSWERED_ELSEWHERE);
      ast_debug(2, "This local call has the ANSWERED_ELSEWHERE flag set.\n");
   }

   if (isoutbound) {
      const char *status = pbx_builtin_getvar_helper(p->chan, "DIALSTATUS");
      if ((status) && (p->owner)) {
         p->owner->hangupcause = p->chan->hangupcause;
         pbx_builtin_setvar_helper(p->owner, "CHANLOCALSTATUS", status);
      }

      ast_clear_flag(p, LOCAL_LAUNCHED_PBX);
      ast_module_user_remove(p->u_chan);
      p->chan = NULL;
   } else {
      ast_module_user_remove(p->u_owner);
      if (p->chan) {
         ast_queue_hangup(p->chan);
      }
      p->owner = NULL;
   }

   ast->tech_pvt = NULL; /* this is one of our locked channels, doesn't matter which */

   if (!p->owner && !p->chan) {
      ao2_unlock(p);
      /* Remove from list */
      ao2_unlink(locals, p);
      ao2_ref(p, -1);
      p = NULL;
      res = 0;
      goto local_hangup_cleanup;
   }
   if (p->chan && !ast_test_flag(p, LOCAL_LAUNCHED_PBX)) {
      /* Need to actually hangup since there is no PBX */
      hangup_chan = 1;
   } else {
      local_queue_frame(p, isoutbound, &f, NULL, 0);
   }

local_hangup_cleanup:
   if (p) {
      ao2_unlock(p);
      ao2_ref(p, -1);
   }
   if (chan) {
      ast_channel_unlock(chan);
      if (hangup_chan) {
         ast_hangup(chan);
      }
      chan = ast_channel_unref(chan);
   }
   if (owner) {
      ast_channel_unlock(owner);
      owner = ast_channel_unref(owner);
   }

   /* leave with the same stupid channel locked that came in */
   ast_channel_lock(ast);
   return res;
}

static void local_destroy(void *obj)
{
   struct local_pvt *pvt = obj;
   pvt->reqcap = ast_format_cap_destroy(pvt->reqcap);
}

/*! \brief Create a call structure */
static struct local_pvt *local_alloc(const char *data, struct ast_format_cap *cap)
{
   struct local_pvt *tmp = NULL;
   char *c = NULL, *opts = NULL;

   if (!(tmp = ao2_alloc(sizeof(*tmp), local_destroy))) {
      return NULL;
   }
   if (!(tmp->reqcap = ast_format_cap_dup(cap))) {
      ao2_ref(tmp, -1);
      return NULL;
   }

   /* Initialize private structure information */
   ast_copy_string(tmp->exten, data, sizeof(tmp->exten));

   memcpy(&tmp->jb_conf, &g_jb_conf, sizeof(tmp->jb_conf));

   /* Look for options */
   if ((opts = strchr(tmp->exten, '/'))) {
      *opts++ = '\0';
      if (strchr(opts, 'n'))
         ast_set_flag(tmp, LOCAL_NO_OPTIMIZATION);
      if (strchr(opts, 'j')) {
         if (ast_test_flag(tmp, LOCAL_NO_OPTIMIZATION))
            ast_set_flag(&tmp->jb_conf, AST_JB_ENABLED);
         else {
            ast_log(LOG_ERROR, "You must use the 'n' option for chan_local "
               "to use the 'j' option to enable the jitterbuffer\n");
         }
      }
      if (strchr(opts, 'b')) {
         ast_set_flag(tmp, LOCAL_BRIDGE);
      }
      if (strchr(opts, 'm')) {
         ast_set_flag(tmp, LOCAL_MOH_PASSTHRU);
      }
   }

   /* Look for a context */
   if ((c = strchr(tmp->exten, '@')))
      *c++ = '\0';

   ast_copy_string(tmp->context, c ? c : "default", sizeof(tmp->context));
#if 0
   /* We can't do this check here, because we don't know the CallerID yet, and
    * the CallerID could potentially affect what step is actually taken (or
    * even if that step exists). */
   if (!ast_exists_extension(NULL, tmp->context, tmp->exten, 1, NULL)) {
      ast_log(LOG_NOTICE, "No such extension/context %s@%s creating local channel\n", tmp->exten, tmp->context);
      tmp = local_pvt_destroy(tmp);
   } else {
#endif
      /* Add to list */
      ao2_link(locals, tmp);
#if 0
   }
#endif
   return tmp; /* this is returned with a ref */
}

/*! \brief Start new local channel */
static struct ast_channel *local_new(struct local_pvt *p, int state, const char *linkedid)
{
   struct ast_channel *tmp = NULL, *tmp2 = NULL;
   int randnum = ast_random() & 0xffff;
   struct ast_format fmt;
   const char *t;
   int ama;

   /* Allocate two new Asterisk channels */
   /* safe accountcode */
   if (p->owner && ast_channel_accountcode(p->owner))
      t = ast_channel_accountcode(p->owner);
   else
      t = "";

   if (p->owner)
      ama = p->owner->amaflags;
   else
      ama = 0;
   if (!(tmp = ast_channel_alloc(1, state, 0, 0, t, p->exten, p->context, linkedid, ama, "Local/%s@%s-%04x;1", p->exten, p->context, randnum))
      || !(tmp2 = ast_channel_alloc(1, AST_STATE_RING, 0, 0, t, p->exten, p->context, linkedid, ama, "Local/%s@%s-%04x;2", p->exten, p->context, randnum))) {
      if (tmp) {
         tmp = ast_channel_release(tmp);
      }
      ast_log(LOG_WARNING, "Unable to allocate channel structure(s)\n");
      return NULL;
   }

   tmp2->tech = tmp->tech = &local_tech;

   ast_format_cap_copy(tmp->nativeformats, p->reqcap);
   ast_format_cap_copy(tmp2->nativeformats, p->reqcap);

   /* Determine our read/write format and set it on each channel */
   ast_best_codec(p->reqcap, &fmt);
   ast_format_copy(&tmp->writeformat, &fmt);
   ast_format_copy(&tmp2->writeformat, &fmt);
   ast_format_copy(&tmp->rawwriteformat, &fmt);
   ast_format_copy(&tmp2->rawwriteformat, &fmt);
   ast_format_copy(&tmp->readformat, &fmt);
   ast_format_copy(&tmp2->readformat, &fmt);
   ast_format_copy(&tmp->rawreadformat, &fmt);
   ast_format_copy(&tmp2->rawreadformat, &fmt);

   tmp->tech_pvt = p;
   tmp2->tech_pvt = p;

   p->owner = tmp;
   p->chan = tmp2;
   p->u_owner = ast_module_user_add(p->owner);
   p->u_chan = ast_module_user_add(p->chan);

   ast_copy_string(tmp->context, p->context, sizeof(tmp->context));
   ast_copy_string(tmp2->context, p->context, sizeof(tmp2->context));
   ast_copy_string(tmp2->exten, p->exten, sizeof(tmp->exten));
   tmp->priority = 1;
   tmp2->priority = 1;

   ast_jb_configure(tmp, &p->jb_conf);

   return tmp;
}

/*! \brief Part of PBX interface */
static struct ast_channel *local_request(const char *type, struct ast_format_cap *cap, const struct ast_channel *requestor, const char *data, int *cause)
{
   struct local_pvt *p = NULL;
   struct ast_channel *chan = NULL;

   /* Allocate a new private structure and then Asterisk channel */
   if ((p = local_alloc(data, cap))) {
      if (!(chan = local_new(p, AST_STATE_DOWN, requestor ? ast_channel_linkedid(requestor) : NULL))) {
         ao2_unlink(locals, p);
      }
      if (chan && ast_channel_cc_params_init(chan, requestor ? ast_channel_get_cc_config_params((struct ast_channel *)requestor) : NULL)) {
         chan = ast_channel_release(chan);
         ao2_unlink(locals, p);
      }
      ao2_ref(p, -1); /* kill the ref from the alloc */
   }

   return chan;
}

/*! \brief CLI command "local show channels" */
static char *locals_show(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
{
   struct local_pvt *p = NULL;
   struct ao2_iterator it;

   switch (cmd) {
   case CLI_INIT:
      e->command = "local show channels";
      e->usage =
         "Usage: local show channels\n"
         "       Provides summary information on active local proxy channels.\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc != 3) {
      return CLI_SHOWUSAGE;
   }

   if (ao2_container_count(locals) == 0) {
      ast_cli(a->fd, "No local channels in use\n");
      return RESULT_SUCCESS;
   }

   it = ao2_iterator_init(locals, 0);
   while ((p = ao2_iterator_next(&it))) {
      ao2_lock(p);
      ast_cli(a->fd, "%s -- %s@%s\n", p->owner ? ast_channel_name(p->owner) : "<unowned>", p->exten, p->context);
      ao2_unlock(p);
      ao2_ref(p, -1);
   }
   ao2_iterator_destroy(&it);

   return CLI_SUCCESS;
}

static struct ast_cli_entry cli_local[] = {
   AST_CLI_DEFINE(locals_show, "List status of local channels"),
};

static int manager_optimize_away(struct mansession *s, const struct message *m)
{
   const char *channel;
   struct local_pvt *p, *tmp = NULL;
   struct ast_channel *c;
   int found = 0;
   struct ao2_iterator it;

   channel = astman_get_header(m, "Channel");

   if (ast_strlen_zero(channel)) {
      astman_send_error(s, m, "'Channel' not specified.");
      return 0;
   }

   c = ast_channel_get_by_name(channel);
   if (!c) {
      astman_send_error(s, m, "Channel does not exist.");
      return 0;
   }

   p = c->tech_pvt;
   ast_channel_unref(c);
   c = NULL;

   it = ao2_iterator_init(locals, 0);
   while ((tmp = ao2_iterator_next(&it))) {
      if (tmp == p) {
         ao2_lock(tmp);
         found = 1;
         ast_clear_flag(tmp, LOCAL_NO_OPTIMIZATION);
         ao2_unlock(tmp);
         ao2_ref(tmp, -1);
         break;
      }
      ao2_ref(tmp, -1);
   }
   ao2_iterator_destroy(&it);

   if (found) {
      astman_send_ack(s, m, "Queued channel to be optimized away");
   } else {
      astman_send_error(s, m, "Unable to find channel");
   }

   return 0;
}


static int locals_cmp_cb(void *obj, void *arg, int flags)
{
   return (obj == arg) ? CMP_MATCH : 0;
}

/*! \brief Load module into PBX, register channel */
static int load_module(void)
{
   if (!(local_tech.capabilities = ast_format_cap_alloc())) {
      return AST_MODULE_LOAD_FAILURE;
   }
   ast_format_cap_add_all(local_tech.capabilities);

   if (!(locals = ao2_container_alloc(BUCKET_SIZE, NULL, locals_cmp_cb))) {
      ast_format_cap_destroy(local_tech.capabilities);
      return AST_MODULE_LOAD_FAILURE;
   }

   /* Make sure we can register our channel type */
   if (ast_channel_register(&local_tech)) {
      ast_log(LOG_ERROR, "Unable to register channel class 'Local'\n");
      ao2_ref(locals, -1);
      ast_format_cap_destroy(local_tech.capabilities);
      return AST_MODULE_LOAD_FAILURE;
   }
   ast_cli_register_multiple(cli_local, sizeof(cli_local) / sizeof(struct ast_cli_entry));
   ast_manager_register_xml("LocalOptimizeAway", EVENT_FLAG_SYSTEM|EVENT_FLAG_CALL, manager_optimize_away);

   return AST_MODULE_LOAD_SUCCESS;
}

/*! \brief Unload the local proxy channel from Asterisk */
static int unload_module(void)
{
   struct local_pvt *p = NULL;
   struct ao2_iterator it;

   /* First, take us out of the channel loop */
   ast_cli_unregister_multiple(cli_local, sizeof(cli_local) / sizeof(struct ast_cli_entry));
   ast_manager_unregister("LocalOptimizeAway");
   ast_channel_unregister(&local_tech);

   it = ao2_iterator_init(locals, 0);
   while ((p = ao2_iterator_next(&it))) {
      if (p->owner) {
         ast_softhangup(p->owner, AST_SOFTHANGUP_APPUNLOAD);
      }
      ao2_ref(p, -1);
   }
   ao2_iterator_destroy(&it);
   ao2_ref(locals, -1);

   ast_format_cap_destroy(local_tech.capabilities);
   return 0;
}

AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Local Proxy Channel (Note: used internally by other modules)",
      .load = load_module,
      .unload = unload_module,
      .load_pri = AST_MODPRI_CHANNEL_DRIVER,
   );