Fri Aug 29 06:38:15 2008

Asterisk developer's documentation

---

manager.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
 *
 * \brief The Asterisk Management Interface - AMI
 *
 * Channel Management and more
 * 
 * \ref amiconf
 */

/*! \addtogroup Group_AMI AMI functions 
*/
/*! @{ 
 Doxygen group */

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/time.h>
#include <sys/types.h>
#include <netdb.h>
#include <sys/socket.h>
#include <netinet/in.h>
#include <netinet/tcp.h>
#include <arpa/inet.h>
#include <signal.h>
#include <errno.h>
#include <unistd.h>

#include "asterisk.h"

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

#include "asterisk/channel.h"
#include "asterisk/file.h"
#include "asterisk/manager.h"
#include "asterisk/config.h"
#include "asterisk/callerid.h"
#include "asterisk/lock.h"
#include "asterisk/logger.h"
#include "asterisk/options.h"
#include "asterisk/cli.h"
#include "asterisk/app.h"
#include "asterisk/pbx.h"
#include "asterisk/md5.h"
#include "asterisk/acl.h"
#include "asterisk/utils.h"

struct fast_originate_helper {
   char tech[AST_MAX_MANHEADER_LEN];
   char data[AST_MAX_MANHEADER_LEN];
   int timeout;
   char app[AST_MAX_APP];
   char appdata[AST_MAX_MANHEADER_LEN];
   char cid_name[AST_MAX_MANHEADER_LEN];
   char cid_num[AST_MAX_MANHEADER_LEN];
   char context[AST_MAX_CONTEXT];
   char exten[AST_MAX_EXTENSION];
   char idtext[AST_MAX_MANHEADER_LEN];
   char account[AST_MAX_ACCOUNT_CODE];
   int priority;
   struct ast_variable *vars;
};

static int enabled = 0;
static int portno = DEFAULT_MANAGER_PORT;
static int asock = -1;
static int displayconnects = 1;

static pthread_t t;
AST_MUTEX_DEFINE_STATIC(sessionlock);
static int block_sockets = 0;

static struct permalias {
   int num;
   char *label;
} perms[] = {
   { EVENT_FLAG_SYSTEM, "system" },
   { EVENT_FLAG_CALL, "call" },
   { EVENT_FLAG_LOG, "log" },
   { EVENT_FLAG_VERBOSE, "verbose" },
   { EVENT_FLAG_COMMAND, "command" },
   { EVENT_FLAG_AGENT, "agent" },
   { EVENT_FLAG_USER, "user" },
   { -1, "all" },
   { 0, "none" },
};

static struct mansession *sessions = NULL;
static struct manager_action *first_action = NULL;
AST_MUTEX_DEFINE_STATIC(actionlock);

/*! If you are calling ast_carefulwrite, it is assumed that you are calling
   it on a file descriptor that _DOES_ have NONBLOCK set.  This way,
   there is only one system call made to do a write, unless we actually
   have a need to wait.  This way, we get better performance. */
int ast_carefulwrite(int fd, char *s, int len, int timeoutms) 
{
   /* Try to write string, but wait no more than ms milliseconds
      before timing out */
   int res=0;
   struct pollfd fds[1];
   while(len) {
      res = write(fd, s, len);
      if ((res < 0) && (errno != EAGAIN)) {
         return -1;
      }
      if (res < 0) res = 0;
      len -= res;
      s += res;
      res = 0;
      if (len) {
         fds[0].fd = fd;
         fds[0].events = POLLOUT;
         /* Wait until writable again */
         res = poll(fds, 1, timeoutms);
         if (res < 1)
            return -1;
      }
   }
   return res;
}

/*! authority_to_str: Convert authority code to string with serveral options */
static char *authority_to_str(int authority, char *res, int reslen)
{
   int running_total = 0, i;
   memset(res, 0, reslen);
   for (i=0; i<sizeof(perms) / sizeof(perms[0]) - 1; i++) {
      if (authority & perms[i].num) {
         if (*res) {
            strncat(res, ",", (reslen > running_total) ? reslen - running_total : 0);
            running_total++;
         }
         strncat(res, perms[i].label, (reslen > running_total) ? reslen - running_total : 0);
         running_total += strlen(perms[i].label);
      }
   }
   if (ast_strlen_zero(res)) {
      ast_copy_string(res, "<none>", reslen);
   }
   return res;
}

static char *complete_show_mancmd(char *line, char *word, int pos, int state)
{
   struct manager_action *cur = first_action;
   int which = 0;

   ast_mutex_lock(&actionlock);
   while (cur) { /* Walk the list of actions */
      if (!strncasecmp(word, cur->action, strlen(word))) {
         if (++which > state) {
            char *ret = strdup(cur->action);
            ast_mutex_unlock(&actionlock);
            return ret;
         }
      }
      cur = cur->next;
   }
   ast_mutex_unlock(&actionlock);
   return NULL;
}

static int handle_showmancmd(int fd, int argc, char *argv[])
{
   struct manager_action *cur = first_action;
   char authority[80];
   int num;

   if (argc != 4)
      return RESULT_SHOWUSAGE;
   ast_mutex_lock(&actionlock);
   while (cur) { /* Walk the list of actions */
      for (num = 3; num < argc; num++) {
         if (!strcasecmp(cur->action, argv[num])) {
            ast_cli(fd, "Action: %s\nSynopsis: %s\nPrivilege: %s\n%s\n", cur->action, cur->synopsis, authority_to_str(cur->authority, authority, sizeof(authority) -1), cur->description ? cur->description : "");
         }
      }
      cur = cur->next;
   }

   ast_mutex_unlock(&actionlock);
   return RESULT_SUCCESS;
}

/*! \brief  handle_showmancmds: CLI command */
/* Should change to "manager show commands" */
static int handle_showmancmds(int fd, int argc, char *argv[])
{
   struct manager_action *cur = first_action;
   char authority[80];
   char *format = "  %-15.15s  %-15.15s  %-55.55s\n";

   ast_mutex_lock(&actionlock);
   ast_cli(fd, format, "Action", "Privilege", "Synopsis");
   ast_cli(fd, format, "------", "---------", "--------");
   while (cur) { /* Walk the list of actions */
      ast_cli(fd, format, cur->action, authority_to_str(cur->authority, authority, sizeof(authority) -1), cur->synopsis);
      cur = cur->next;
   }

   ast_mutex_unlock(&actionlock);
   return RESULT_SUCCESS;
}

/*! \brief  handle_showmanconn: CLI command show manager connected */
/* Should change to "manager show connected" */
static int handle_showmanconn(int fd, int argc, char *argv[])
{
   struct mansession *s;
   char iabuf[INET_ADDRSTRLEN];
   char *format = "  %-15.15s  %-15.15s\n";
   ast_mutex_lock(&sessionlock);
   s = sessions;
   ast_cli(fd, format, "Username", "IP Address");
   while (s) {
      ast_cli(fd, format,s->username, ast_inet_ntoa(iabuf, sizeof(iabuf), s->sin.sin_addr));
      s = s->next;
   }

   ast_mutex_unlock(&sessionlock);
   return RESULT_SUCCESS;
}

static char showmancmd_help[] = 
"Usage: show manager command <actionname>\n"
"  Shows the detailed description for a specific Asterisk manager interface command.\n";

static char showmancmds_help[] = 
"Usage: show manager commands\n"
"  Prints a listing of all the available Asterisk manager interface commands.\n";

static char showmanconn_help[] = 
"Usage: show manager connected\n"
"  Prints a listing of the users that are currently connected to the\n"
"Asterisk manager interface.\n";

static struct ast_cli_entry show_mancmd_cli =
   { { "show", "manager", "command", NULL },
   handle_showmancmd, "Show a manager interface command", showmancmd_help, complete_show_mancmd };

static struct ast_cli_entry show_mancmds_cli =
   { { "show", "manager", "commands", NULL },
   handle_showmancmds, "List manager interface commands", showmancmds_help };

static struct ast_cli_entry show_manconn_cli =
   { { "show", "manager", "connected", NULL },
   handle_showmanconn, "Show connected manager interface users", showmanconn_help };

static void free_session(struct mansession *s)
{
   struct eventqent *eqe;
   if (s->fd > -1)
      close(s->fd);
   ast_mutex_destroy(&s->__lock);
   while(s->eventq) {
      eqe = s->eventq;
      s->eventq = s->eventq->next;
      free(eqe);
   }
   free(s);
}

static void destroy_session(struct mansession *s)
{
   struct mansession *cur, *prev = NULL;
   ast_mutex_lock(&sessionlock);
   cur = sessions;
   while(cur) {
      if (cur == s)
         break;
      prev = cur;
      cur = cur->next;
   }
   if (cur) {
      if (prev)
         prev->next = cur->next;
      else
         sessions = cur->next;
      free_session(s);
   } else
      ast_log(LOG_WARNING, "Trying to delete nonexistent session %p?\n", s);
   ast_mutex_unlock(&sessionlock);
   
}

char *astman_get_header(struct message *m, char *var)
{
   char cmp[80];
   int x;
   snprintf(cmp, sizeof(cmp), "%s: ", var);
   for (x=0;x<m->hdrcount;x++)
      if (!strncasecmp(cmp, m->headers[x], strlen(cmp)))
         return m->headers[x] + strlen(cmp);
   return "";
}

struct ast_variable *astman_get_variables(struct message *m)
{
   int varlen, x, y;
   struct ast_variable *head = NULL, *cur;
   char *var, *val;
   unsigned int var_count;
        char *vars[32];
   
   varlen = strlen("Variable: ");   

   for (x = 0; x < m->hdrcount; x++) {
      if (strncasecmp("Variable: ", m->headers[x], varlen))
         continue;

      if (!(var = ast_strdupa(m->headers[x] + varlen)))
         return head;

      if ((var_count = ast_app_separate_args(var, '|', vars, sizeof(vars) / sizeof(vars[0])))) {
         for (y = 0; y < var_count; y++) {
            if (!vars[y])
               continue;
            var = val = ast_strdupa(vars[y]);
            strsep(&val, "=");
            if (!val || ast_strlen_zero(var))
               continue;
            cur = ast_variable_new(var, val);
            if (head) {
               cur->next = head;
               head = cur;
            } else
               head = cur;
         }
      }
   }

   return head;
}

/*! NOTE:
   Callers of astman_send_error(), astman_send_response() or astman_send_ack() must EITHER
   hold the session lock _or_ be running in an action callback (in which case s->busy will
   be non-zero). In either of these cases, there is no need to lock-protect the session's
   fd, since no other output will be sent (events will be queued), and no input will
   be read until either the current action finishes or get_input() obtains the session
   lock.
 */
void astman_send_error(struct mansession *s, struct message *m, char *error)
{
   char *id = astman_get_header(m,"ActionID");

   ast_cli(s->fd, "Response: Error\r\n");
   if (!ast_strlen_zero(id))
      ast_cli(s->fd, "ActionID: %s\r\n",id);
   ast_cli(s->fd, "Message: %s\r\n\r\n", error);
}

void astman_send_response(struct mansession *s, struct message *m, char *resp, char *msg)
{
   char *id = astman_get_header(m,"ActionID");

   ast_cli(s->fd, "Response: %s\r\n", resp);
   if (!ast_strlen_zero(id))
      ast_cli(s->fd, "ActionID: %s\r\n",id);
   if (msg)
      ast_cli(s->fd, "Message: %s\r\n\r\n", msg);
   else
      ast_cli(s->fd, "\r\n");
}

void astman_send_ack(struct mansession *s, struct message *m, char *msg)
{
   astman_send_response(s, m, "Success", msg);
}

/*! Tells you if smallstr exists inside bigstr
   which is delim by delim and uses no buf or stringsep
   ast_instring("this|that|more","this",',') == 1;

   feel free to move this to app.c -anthm */
static int ast_instring(char *bigstr, char *smallstr, char delim) 
{
   char *val = bigstr, *next;

   do {
      if ((next = strchr(val, delim))) {
         if (!strncmp(val, smallstr, (next - val)))
            return 1;
         else
            continue;
      } else
         return !strcmp(smallstr, val);

   } while (*(val = (next + 1)));

   return 0;
}

static int get_perm(char *instr)
{
   int x = 0, ret = 0;

   if (!instr)
      return 0;

   for (x=0; x<sizeof(perms) / sizeof(perms[0]); x++)
      if (ast_instring(instr, perms[x].label, ','))
         ret |= perms[x].num;
   
   return ret;
}

static int ast_is_number(char *string) 
{
   int ret = 1, x = 0;

   if (!string)
      return 0;

   for (x=0; x < strlen(string); x++) {
      if (!(string[x] >= 48 && string[x] <= 57)) {
         ret = 0;
         break;
      }
   }
   
   return ret ? atoi(string) : 0;
}

static int ast_strings_to_mask(char *string) 
{
   int x, ret = -1;
   
   x = ast_is_number(string);

   if (x) {
      ret = x;
   } else if (ast_strlen_zero(string)) {
      ret = -1;
   } else if (ast_false(string)) {
      ret = 0;
   } else if (ast_true(string)) {
      ret = 0;
      for (x=0; x<sizeof(perms) / sizeof(perms[0]); x++)
         ret |= perms[x].num;    
   } else {
      ret = 0;
      for (x=0; x<sizeof(perms) / sizeof(perms[0]); x++) {
         if (ast_instring(string, perms[x].label, ',')) 
            ret |= perms[x].num;    
      }
   }

   return ret;
}

/*! 
   Rather than braindead on,off this now can also accept a specific int mask value 
   or a ',' delim list of mask strings (the same as manager.conf) -anthm
*/

static int set_eventmask(struct mansession *s, char *eventmask)
{
   int maskint = ast_strings_to_mask(eventmask);

   ast_mutex_lock(&s->__lock);
   if (maskint >= 0) 
      s->send_events = maskint;
   ast_mutex_unlock(&s->__lock);
   
   return maskint;
}

static int authenticate(struct mansession *s, struct message *m)
{
   struct ast_config *cfg;
   char iabuf[INET_ADDRSTRLEN];
   char *cat;
   char *user = astman_get_header(m, "Username");
   char *pass = astman_get_header(m, "Secret");
   char *authtype = astman_get_header(m, "AuthType");
   char *key = astman_get_header(m, "Key");
   char *events = astman_get_header(m, "Events");
   
   cfg = ast_config_load("manager.conf");
   if (!cfg)
      return -1;
   cat = ast_category_browse(cfg, NULL);
   while(cat) {
      if (strcasecmp(cat, "general")) {
         /* This is a user */
         if (!strcasecmp(cat, user)) {
            struct ast_variable *v;
            struct ast_ha *ha = NULL;
            char *password = NULL;
            v = ast_variable_browse(cfg, cat);
            while (v) {
               if (!strcasecmp(v->name, "secret")) {
                  password = v->value;
               } else if (!strcasecmp(v->name, "permit") ||
                     !strcasecmp(v->name, "deny")) {
                  ha = ast_append_ha(v->name, v->value, ha);
               } else if (!strcasecmp(v->name, "writetimeout")) {
                  int val = atoi(v->value);

                  if (val < 100)
                     ast_log(LOG_WARNING, "Invalid writetimeout value '%s' at line %d\n", v->value, v->lineno);
                  else
                     s->writetimeout = val;
               }
                     
               v = v->next;
            }
            if (ha && !ast_apply_ha(ha, &(s->sin))) {
               ast_log(LOG_NOTICE, "%s failed to pass IP ACL as '%s'\n", ast_inet_ntoa(iabuf, sizeof(iabuf), s->sin.sin_addr), user);
               ast_free_ha(ha);
               ast_config_destroy(cfg);
               return -1;
            } else if (ha)
               ast_free_ha(ha);
            if (!strcasecmp(authtype, "MD5")) {
               if (!ast_strlen_zero(key) && 
                   !ast_strlen_zero(s->challenge) && !ast_strlen_zero(password)) {
                  int x;
                  int len=0;
                  char md5key[256] = "";
                  struct MD5Context md5;
                  unsigned char digest[16];
                  MD5Init(&md5);
                  MD5Update(&md5, (unsigned char *) s->challenge, strlen(s->challenge));
                  MD5Update(&md5, (unsigned char *) password, strlen(password));
                  MD5Final(digest, &md5);
                  for (x=0;x<16;x++)
                     len += sprintf(md5key + len, "%2.2x", digest[x]);
                  if (!strcmp(md5key, key))
                     break;
                  else {
                     ast_config_destroy(cfg);
                     return -1;
                  }
               }
            } else if (password && !strcasecmp(password, pass)) {
               break;
            } else {
               ast_log(LOG_NOTICE, "%s failed to authenticate as '%s'\n", ast_inet_ntoa(iabuf, sizeof(iabuf), s->sin.sin_addr), user);
               ast_config_destroy(cfg);
               return -1;
            }  
         }
      }
      cat = ast_category_browse(cfg, cat);
   }
   if (cat) {
      ast_copy_string(s->username, cat, sizeof(s->username));
      s->readperm = get_perm(ast_variable_retrieve(cfg, cat, "read"));
      s->writeperm = get_perm(ast_variable_retrieve(cfg, cat, "write"));
      ast_config_destroy(cfg);
      if (events)
         set_eventmask(s, events);
      return 0;
   }
   ast_log(LOG_NOTICE, "%s tried to authenticate with nonexistent user '%s'\n", ast_inet_ntoa(iabuf, sizeof(iabuf), s->sin.sin_addr), user);
   ast_config_destroy(cfg);
   return -1;
}

/*! \brief PING: Manager PING */
static char mandescr_ping[] = 
"Description: A 'Ping' action will ellicit a 'Pong' response.  Used to keep the "
"  manager connection open.\n"
"Variables: NONE\n";

static int action_ping(struct mansession *s, struct message *m)
{
   astman_send_response(s, m, "Pong", NULL);
   return 0;
}

static char mandescr_listcommands[] = 
"Description: Returns the action name and synopsis for every\n"
"  action that is available to the user\n"
"Variables: NONE\n";

static int action_listcommands(struct mansession *s, struct message *m)
{
   struct manager_action *cur = first_action;
   char idText[256] = "";
   char temp[BUFSIZ];
   char *id = astman_get_header(m,"ActionID");

   if (!ast_strlen_zero(id))
      snprintf(idText,256,"ActionID: %s\r\n",id);
   ast_cli(s->fd, "Response: Success\r\n%s", idText);
   ast_mutex_lock(&actionlock);
   while (cur) { /* Walk the list of actions */
      if ((s->writeperm & cur->authority) == cur->authority)
         ast_cli(s->fd, "%s: %s (Priv: %s)\r\n", cur->action, cur->synopsis, authority_to_str(cur->authority, temp, sizeof(temp)) );
      cur = cur->next;
   }
   ast_mutex_unlock(&actionlock);
   ast_cli(s->fd, "\r\n");

   return 0;
}

static char mandescr_events[] = 
"Description: Enable/Disable sending of events to this manager\n"
"  client.\n"
"Variables:\n"
"  EventMask: 'on' if all events should be sent,\n"
"     'off' if no events should be sent,\n"
"     'system,call,log' to select which flags events should have to be sent.\n";

static int action_events(struct mansession *s, struct message *m)
{
   char *mask = astman_get_header(m, "EventMask");
   int res;

   res = set_eventmask(s, mask);
   if (res > 0)
      astman_send_response(s, m, "Events On", NULL);
   else if (res == 0)
      astman_send_response(s, m, "Events Off", NULL);

   return 0;
}

static char mandescr_logoff[] = 
"Description: Logoff this manager session\n"
"Variables: NONE\n";

static int action_logoff(struct mansession *s, struct message *m)
{
   astman_send_response(s, m, "Goodbye", "Thanks for all the fish.");
   return -1;
}

static char mandescr_hangup[] = 
"Description: Hangup a channel\n"
"Variables: \n"
"  Channel: The channel name to be hungup\n";

static int action_hangup(struct mansession *s, struct message *m)
{
   struct ast_channel *c = NULL;
   char *name = astman_get_header(m, "Channel");
   if (ast_strlen_zero(name)) {
      astman_send_error(s, m, "No channel specified");
      return 0;
   }
   c = ast_get_channel_by_name_locked(name);
   if (!c) {
      astman_send_error(s, m, "No such channel");
      return 0;
   }
   ast_softhangup(c, AST_SOFTHANGUP_EXPLICIT);
   ast_mutex_unlock(&c->lock);
   astman_send_ack(s, m, "Channel Hungup");
   return 0;
}

static char mandescr_setvar[] = 
"Description: Set a global or local channel variable.\n"
"Variables: (Names marked with * are required)\n"
"  Channel: Channel to set variable for\n"
"  *Variable: Variable name\n"
"  *Value: Value\n";

static int action_setvar(struct mansession *s, struct message *m)
{
        struct ast_channel *c = NULL;
        char *name = astman_get_header(m, "Channel");
        char *varname = astman_get_header(m, "Variable");
        char *varval = astman_get_header(m, "Value");
   
   if (ast_strlen_zero(varname)) {
      astman_send_error(s, m, "No variable specified");
      return 0;
   }
   
   if (!ast_strlen_zero(name)) {
      c = ast_get_channel_by_name_locked(name);
      if (!c) {
         astman_send_error(s, m, "No such channel");
         return 0;
      }
   }
   
   pbx_builtin_setvar_helper(c, varname, varval ? varval : "");
     
   if (c)
      ast_mutex_unlock(&c->lock);

   astman_send_ack(s, m, "Variable Set"); 

   return 0;
}

static char mandescr_getvar[] = 
"Description: Get the value of a global or local channel variable.\n"
"Variables: (Names marked with * are required)\n"
"  Channel: Channel to read variable from\n"
"  *Variable: Variable name\n"
"  ActionID: Optional Action id for message matching.\n";

static int action_getvar(struct mansession *s, struct message *m)
{
        struct ast_channel *c = NULL;
        char *name = astman_get_header(m, "Channel");
        char *varname = astman_get_header(m, "Variable");
   char *id = astman_get_header(m,"ActionID");
   char *varval;
   char *varval2=NULL;

   if (!strlen(varname)) {
      astman_send_error(s, m, "No variable specified");
      return 0;
   }

   if (strlen(name)) {
      c = ast_get_channel_by_name_locked(name);
      if (!c) {
         astman_send_error(s, m, "No such channel");
         return 0;
      }
   }
   
   varval=pbx_builtin_getvar_helper(c,varname);
   if (varval)
      varval2 = ast_strdupa(varval);
   if (!varval2)
      varval2 = "";
   if (c)
      ast_mutex_unlock(&c->lock);
   ast_cli(s->fd, "Response: Success\r\n"
      "Variable: %s\r\nValue: %s\r\n" ,varname,varval2);
   if (!ast_strlen_zero(id))
      ast_cli(s->fd, "ActionID: %s\r\n",id);
   ast_cli(s->fd, "\r\n");

   return 0;
}


/*! \brief  action_status: Manager "status" command to show channels */
/* Needs documentation... */
static int action_status(struct mansession *s, struct message *m)
{
   char *id = astman_get_header(m,"ActionID");
      char *name = astman_get_header(m,"Channel");
   char idText[256] = "";
   struct ast_channel *c;
   char bridge[256];
   struct timeval now = ast_tvnow();
   long elapsed_seconds=0;
   int all = ast_strlen_zero(name); /* set if we want all channels */

        if (!ast_strlen_zero(id))
                snprintf(idText,256,"ActionID: %s\r\n",id);
   if (all)
      c = ast_channel_walk_locked(NULL);
   else {
      c = ast_get_channel_by_name_locked(name);
      if (!c) {
         astman_send_error(s, m, "No such channel");
         return 0;
      }
   }
   astman_send_ack(s, m, "Channel status will follow");
   /* if we look by name, we break after the first iteration */
   while(c) {
      if (c->_bridge)
         snprintf(bridge, sizeof(bridge), "Link: %s\r\n", c->_bridge->name);
      else
         bridge[0] = '\0';
      if (c->pbx) {
         if (c->cdr) {
            elapsed_seconds = now.tv_sec - c->cdr->start.tv_sec;
         }
         ast_cli(s->fd,
         "Event: Status\r\n"
         "Privilege: Call\r\n"
         "Channel: %s\r\n"
         "CallerID: %s\r\n"
         "CallerIDName: %s\r\n"
         "Account: %s\r\n"
         "State: %s\r\n"
         "Context: %s\r\n"
         "Extension: %s\r\n"
         "Priority: %d\r\n"
         "Seconds: %ld\r\n"
         "%s"
         "Uniqueid: %s\r\n"
         "%s"
         "\r\n",
         c->name, 
         c->cid.cid_num ? c->cid.cid_num : "<unknown>", 
         c->cid.cid_name ? c->cid.cid_name : "<unknown>", 
         c->accountcode,
         ast_state2str(c->_state), c->context,
         c->exten, c->priority, (long)elapsed_seconds, bridge, c->uniqueid, idText);
      } else {
         ast_cli(s->fd,
         "Event: Status\r\n"
         "Privilege: Call\r\n"
         "Channel: %s\r\n"
         "CallerID: %s\r\n"
         "CallerIDName: %s\r\n"
         "Account: %s\r\n"
         "State: %s\r\n"
         "%s"
         "Uniqueid: %s\r\n"
         "%s"
         "\r\n",
         c->name, 
         c->cid.cid_num ? c->cid.cid_num : "<unknown>", 
         c->cid.cid_name ? c->cid.cid_name : "<unknown>", 
         c->accountcode,
         ast_state2str(c->_state), bridge, c->uniqueid, idText);
      }
      ast_mutex_unlock(&c->lock);
      if (!all)
         break;
      c = ast_channel_walk_locked(c);
   }
   ast_cli(s->fd,
   "Event: StatusComplete\r\n"
   "%s"
   "\r\n",idText);
   return 0;
}

static char mandescr_redirect[] = 
"Description: Redirect (transfer) a call.\n"
"Variables: (Names marked with * are required)\n"
"  *Channel: Channel to redirect\n"
"  ExtraChannel: Second call leg to transfer (optional)\n"
"  *Exten: Extension to transfer to\n"
"  *Context: Context to transfer to\n"
"  *Priority: Priority to transfer to\n"
"  ActionID: Optional Action id for message matching.\n";

/*! \brief  action_redirect: The redirect manager command */
static int action_redirect(struct mansession *s, struct message *m)
{
   char *name = astman_get_header(m, "Channel");
   char *name2 = astman_get_header(m, "ExtraChannel");
   char *exten = astman_get_header(m, "Exten");
   char *context = astman_get_header(m, "Context");
   char *priority = astman_get_header(m, "Priority");
   struct ast_channel *chan, *chan2 = NULL;
   int pi = 0;
   int res;

   if (ast_strlen_zero(name)) {
      astman_send_error(s, m, "Channel not specified");
      return 0;
   }
   if (!ast_strlen_zero(priority) && (sscanf(priority, "%d", &pi) != 1)) {
      astman_send_error(s, m, "Invalid priority\n");
      return 0;
   }
   chan = ast_get_channel_by_name_locked(name);
   if (!chan) {
      char buf[BUFSIZ];
      snprintf(buf, sizeof(buf), "Channel does not exist: %s", name);
      astman_send_error(s, m, buf);
      return 0;
   }
   if (ast_check_hangup(chan)) {
      astman_send_error(s, m, "Redirect failed, channel hung up.\n");
      ast_mutex_unlock(&chan->lock);
      return 0;
   }
   if (!ast_strlen_zero(name2))
      chan2 = ast_get_channel_by_name_locked(name2);
   if (chan2 && ast_check_hangup(chan2)) {
      astman_send_error(s, m, "Redirect failed, extra channel hung up.\n");
      ast_mutex_unlock(&chan->lock);
      ast_mutex_unlock(&chan2->lock);
      return 0;
   }
   res = ast_async_goto(chan, context, exten, pi);
   if (!res) {
      if (!ast_strlen_zero(name2)) {
         if (chan2)
            res = ast_async_goto(chan2, context, exten, pi);
         else
            res = -1;
         if (!res)
            astman_send_ack(s, m, "Dual Redirect successful");
         else
            astman_send_error(s, m, "Secondary redirect failed");
      } else
         astman_send_ack(s, m, "Redirect successful");
   } else
      astman_send_error(s, m, "Redirect failed");
   if (chan)
      ast_mutex_unlock(&chan->lock);
   if (chan2)
      ast_mutex_unlock(&chan2->lock);
   return 0;
}

static char mandescr_command[] = 
"Description: Run a CLI command.\n"
"Variables: (Names marked with * are required)\n"
"  *Command: Asterisk CLI command to run\n"
"  ActionID: Optional Action id for message matching.\n";

/*! \brief  action_command: Manager command "comma