2003-05-14 05:33:06 +00:00
|
|
|
/*
|
2005-09-14 20:46:50 +00:00
|
|
|
* Asterisk -- An open source telephony toolkit.
|
2003-05-14 05:33:06 +00:00
|
|
|
*
|
2005-01-21 07:06:25 +00:00
|
|
|
* Copyright (C) 1999 - 2005, Digium, Inc.
|
2003-05-14 05:33:06 +00:00
|
|
|
*
|
2004-10-02 00:58:31 +00:00
|
|
|
* Mark Spencer <markster@digium.com>
|
2003-05-14 05:33:06 +00:00
|
|
|
*
|
2005-09-14 20:46:50 +00:00
|
|
|
* 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.
|
|
|
|
*
|
2003-05-14 05:33:06 +00:00
|
|
|
* This program is free software, distributed under the terms of
|
2005-09-14 20:46:50 +00:00
|
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
|
|
* at the top of the source tree.
|
|
|
|
*/
|
|
|
|
|
2005-10-24 20:12:06 +00:00
|
|
|
/*! \file
|
2005-09-14 20:46:50 +00:00
|
|
|
*
|
2005-10-24 20:12:06 +00:00
|
|
|
* \brief Transfer a caller
|
2005-12-30 21:18:06 +00:00
|
|
|
*
|
|
|
|
* \author Mark Spencer <markster@digium.com>
|
2005-09-14 20:46:50 +00:00
|
|
|
*
|
2005-11-06 15:09:47 +00:00
|
|
|
* Requires transfer support from channel driver
|
|
|
|
*
|
|
|
|
* \ingroup applications
|
2003-05-14 05:33:06 +00:00
|
|
|
*/
|
|
|
|
|
2005-06-06 22:39:32 +00:00
|
|
|
#include <stdlib.h>
|
2005-11-08 04:48:00 +00:00
|
|
|
#include <stdio.h>
|
2005-06-06 22:39:32 +00:00
|
|
|
#include <string.h>
|
2005-11-08 04:48:00 +00:00
|
|
|
#include <unistd.h>
|
2005-06-06 22:39:32 +00:00
|
|
|
|
|
|
|
#include "asterisk.h"
|
|
|
|
|
|
|
|
ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
|
|
|
|
|
2005-04-21 06:02:45 +00:00
|
|
|
#include "asterisk/lock.h"
|
|
|
|
#include "asterisk/file.h"
|
|
|
|
#include "asterisk/logger.h"
|
|
|
|
#include "asterisk/channel.h"
|
|
|
|
#include "asterisk/pbx.h"
|
|
|
|
#include "asterisk/module.h"
|
2005-08-22 20:53:38 +00:00
|
|
|
#include "asterisk/options.h"
|
2005-11-07 22:48:29 +00:00
|
|
|
#include "asterisk/app.h"
|
2003-05-14 05:33:06 +00:00
|
|
|
|
2005-10-19 18:19:02 +00:00
|
|
|
LOCAL_USER_DECL;
|
|
|
|
|
2005-08-22 20:53:38 +00:00
|
|
|
static const char *app = "Transfer";
|
2003-05-14 05:33:06 +00:00
|
|
|
|
2005-08-22 20:53:38 +00:00
|
|
|
static const char *synopsis = "Transfer caller to remote extension";
|
2003-05-14 05:33:06 +00:00
|
|
|
|
2005-08-22 20:53:38 +00:00
|
|
|
static const char *descrip =
|
2005-11-07 22:48:29 +00:00
|
|
|
" Transfer([Tech/]dest[|options]): Requests the remote caller be transferred\n"
|
|
|
|
"to a given destination. If TECH (SIP, IAX2, LOCAL etc) is used, only\n"
|
2005-03-20 03:43:37 +00:00
|
|
|
"an incoming call with the same channel technology will be transfered.\n"
|
|
|
|
"Note that for SIP, if you transfer before call is setup, a 302 redirect\n"
|
|
|
|
"SIP message will be returned to the caller.\n"
|
2005-08-22 20:53:38 +00:00
|
|
|
"\nThe result of the application will be reported in the TRANSFERSTATUS\n"
|
|
|
|
"channel variable:\n"
|
2005-11-07 22:48:29 +00:00
|
|
|
" SUCCESS Transfer succeeded\n"
|
2005-08-22 20:53:38 +00:00
|
|
|
" FAILURE Transfer failed\n"
|
|
|
|
" UNSUPPORTED Transfer unsupported by channel driver\n"
|
2005-11-07 22:48:29 +00:00
|
|
|
"The option string many contain the following character:\n"
|
|
|
|
"'j' -- jump to n+101 priority if the channel transfer attempt\n"
|
|
|
|
" fails\n";
|
2003-05-14 05:33:06 +00:00
|
|
|
|
|
|
|
static int transfer_exec(struct ast_channel *chan, void *data)
|
|
|
|
{
|
2005-08-22 20:53:38 +00:00
|
|
|
int res;
|
2005-02-19 17:34:06 +00:00
|
|
|
int len;
|
2003-05-14 05:33:06 +00:00
|
|
|
struct localuser *u;
|
2005-02-19 17:34:06 +00:00
|
|
|
char *slash;
|
2005-08-22 20:53:38 +00:00
|
|
|
char *tech = NULL;
|
2005-11-07 22:48:29 +00:00
|
|
|
char *dest = NULL;
|
2005-08-22 20:53:38 +00:00
|
|
|
char *status;
|
2005-11-07 22:48:29 +00:00
|
|
|
char *parse;
|
|
|
|
int priority_jump = 0;
|
|
|
|
AST_DECLARE_APP_ARGS(args,
|
|
|
|
AST_APP_ARG(dest);
|
|
|
|
AST_APP_ARG(options);
|
|
|
|
);
|
2005-08-22 20:53:38 +00:00
|
|
|
|
2005-11-07 22:48:29 +00:00
|
|
|
LOCAL_USER_ADD(u);
|
|
|
|
|
2006-01-21 17:50:04 +00:00
|
|
|
if (ast_strlen_zero((char *)data)) {
|
2005-11-07 22:48:29 +00:00
|
|
|
ast_log(LOG_WARNING, "Transfer requires an argument ([Tech/]destination[|options])\n");
|
|
|
|
LOCAL_USER_REMOVE(u);
|
2005-08-22 20:53:38 +00:00
|
|
|
pbx_builtin_setvar_helper(chan, "TRANSFERSTATUS", "FAILURE");
|
|
|
|
return 0;
|
2006-01-21 17:50:04 +00:00
|
|
|
} else {
|
2006-01-21 20:57:06 +00:00
|
|
|
if (!(parse = ast_strdupa(data))) {
|
2006-01-21 17:50:04 +00:00
|
|
|
LOCAL_USER_REMOVE(u);
|
|
|
|
return -1;
|
|
|
|
}
|
2003-05-14 05:33:06 +00:00
|
|
|
}
|
2005-08-22 20:53:38 +00:00
|
|
|
|
2005-11-07 22:48:29 +00:00
|
|
|
AST_STANDARD_APP_ARGS(args, parse);
|
|
|
|
|
|
|
|
if (args.options) {
|
|
|
|
if (strchr(args.options, 'j'))
|
|
|
|
priority_jump = 1;
|
|
|
|
}
|
|
|
|
|
|
|
|
dest = args.dest;
|
2005-10-19 18:19:02 +00:00
|
|
|
|
2005-08-22 20:53:38 +00:00
|
|
|
if ((slash = strchr(dest, '/')) && (len = (slash - dest))) {
|
|
|
|
tech = dest;
|
2005-05-08 16:35:54 +00:00
|
|
|
dest = slash + 1;
|
2005-02-19 17:34:06 +00:00
|
|
|
/* Allow execution only if the Tech/destination agrees with the type of the channel */
|
2006-02-01 23:05:28 +00:00
|
|
|
if (strncasecmp(chan->tech->type, tech, len)) {
|
2005-08-22 20:53:38 +00:00
|
|
|
pbx_builtin_setvar_helper(chan, "TRANSFERSTATUS", "FAILURE");
|
2005-10-19 18:19:02 +00:00
|
|
|
LOCAL_USER_REMOVE(u);
|
2005-02-19 17:34:06 +00:00
|
|
|
return 0;
|
2005-08-22 20:53:38 +00:00
|
|
|
}
|
2005-02-19 17:34:06 +00:00
|
|
|
}
|
2005-05-08 16:35:54 +00:00
|
|
|
|
2005-08-22 20:53:38 +00:00
|
|
|
/* Check if the channel supports transfer before we try it */
|
|
|
|
if (!chan->tech->transfer) {
|
|
|
|
pbx_builtin_setvar_helper(chan, "TRANSFERSTATUS", "UNSUPPORTED");
|
2005-10-19 18:19:02 +00:00
|
|
|
LOCAL_USER_REMOVE(u);
|
2005-08-22 20:53:38 +00:00
|
|
|
return 0;
|
2003-05-14 05:33:06 +00:00
|
|
|
}
|
2005-08-22 20:53:38 +00:00
|
|
|
|
|
|
|
res = ast_transfer(chan, dest);
|
|
|
|
|
2005-09-07 21:39:53 +00:00
|
|
|
if (res < 0) {
|
2005-08-22 20:53:38 +00:00
|
|
|
status = "FAILURE";
|
2005-12-04 20:40:46 +00:00
|
|
|
if (priority_jump || ast_opt_priority_jumping)
|
2005-08-22 20:53:38 +00:00
|
|
|
ast_goto_if_exists(chan, chan->context, chan->exten, chan->priority + 101);
|
2005-09-07 21:39:53 +00:00
|
|
|
res = 0;
|
2005-08-22 20:53:38 +00:00
|
|
|
} else {
|
|
|
|
status = "SUCCESS";
|
2003-05-14 05:33:06 +00:00
|
|
|
res = 0;
|
2005-08-22 20:53:38 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
pbx_builtin_setvar_helper(chan, "TRANSFERSTATUS", status);
|
|
|
|
|
2003-05-14 05:33:06 +00:00
|
|
|
LOCAL_USER_REMOVE(u);
|
2005-08-22 20:53:38 +00:00
|
|
|
|
2003-05-14 05:33:06 +00:00
|
|
|
return res;
|
|
|
|
}
|
|
|
|
|
2006-04-14 14:08:19 +00:00
|
|
|
static int unload_module(void *mod)
|
2003-05-14 05:33:06 +00:00
|
|
|
{
|
2005-10-18 22:52:21 +00:00
|
|
|
int res;
|
|
|
|
|
|
|
|
res = ast_unregister_application(app);
|
|
|
|
|
2003-05-14 05:33:06 +00:00
|
|
|
STANDARD_HANGUP_LOCALUSERS;
|
2005-08-22 20:53:38 +00:00
|
|
|
|
2005-10-18 22:52:21 +00:00
|
|
|
return res;
|
2003-05-14 05:33:06 +00:00
|
|
|
}
|
|
|
|
|
2006-04-14 14:08:19 +00:00
|
|
|
static int load_module(void *mod)
|
2003-05-14 05:33:06 +00:00
|
|
|
{
|
|
|
|
return ast_register_application(app, transfer_exec, synopsis, descrip);
|
|
|
|
}
|
|
|
|
|
2006-04-14 14:08:19 +00:00
|
|
|
static const char *description(void)
|
2003-05-14 05:33:06 +00:00
|
|
|
{
|
2006-04-14 14:08:19 +00:00
|
|
|
return "Transfer";
|
2003-05-14 05:33:06 +00:00
|
|
|
}
|
|
|
|
|
2006-04-14 14:08:19 +00:00
|
|
|
static const char *key(void)
|
2003-05-14 05:33:06 +00:00
|
|
|
{
|
|
|
|
return ASTERISK_GPL_KEY;
|
|
|
|
}
|
2006-04-14 14:08:19 +00:00
|
|
|
|
|
|
|
STD_MOD1;
|