This commit introduces the first phase of an effort to manage documentation of the interfaces in Asterisk in an XML format. Currently, a new format is available for applications and dialplan functions. A good number of conversions to the new format are also included. For more information, see the following message to asterisk-dev: http://lists.digium.com/pipermail/asterisk-dev/2008-October/034968.html git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@153365 65c4cc65-6c06-0410-ace0-fbb531ad65f3
115 lines
3 KiB
C
115 lines
3 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 2006, Sergey Basmanov
|
|
*
|
|
* 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 ChannelRedirect application
|
|
*
|
|
* \author Sergey Basmanov <sergey_basmanov@mail.ru>
|
|
*
|
|
* \ingroup applications
|
|
*/
|
|
|
|
#include "asterisk.h"
|
|
|
|
ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
|
|
|
|
#include "asterisk/file.h"
|
|
#include "asterisk/channel.h"
|
|
#include "asterisk/pbx.h"
|
|
#include "asterisk/module.h"
|
|
#include "asterisk/lock.h"
|
|
#include "asterisk/app.h"
|
|
#include "asterisk/features.h"
|
|
|
|
/*** DOCUMENTATION
|
|
<application name="ChannelRedirect" language="en_US">
|
|
<synopsis>
|
|
Redirects given channel to a dialplan target
|
|
</synopsis>
|
|
<syntax>
|
|
<parameter name="channel" required="true" />
|
|
<parameter name="context" required="false" />
|
|
<parameter name="extension" required="false" />
|
|
<parameter name="priority" required="true" />
|
|
</syntax>
|
|
<description>
|
|
<para>Sends the specified channel to the specified extension priority</para>
|
|
|
|
<para>This application sets the following channel variables upon completion</para>
|
|
<variablelist>
|
|
<variable name="CHANNELREDIRECT_STATUS">
|
|
<value name="NOCHANNEL" />
|
|
<value name="SUCCESS" />
|
|
<para>Are set to the result of the redirection</para>
|
|
</variable>
|
|
</variablelist>
|
|
</description>
|
|
</application>
|
|
***/
|
|
static char *app = "ChannelRedirect";
|
|
|
|
static int asyncgoto_exec(struct ast_channel *chan, void *data)
|
|
{
|
|
int res = -1;
|
|
char *info;
|
|
struct ast_channel *chan2 = NULL;
|
|
|
|
AST_DECLARE_APP_ARGS(args,
|
|
AST_APP_ARG(channel);
|
|
AST_APP_ARG(label);
|
|
);
|
|
|
|
if (ast_strlen_zero(data)) {
|
|
ast_log(LOG_WARNING, "%s requires an argument (channel,[[context,]exten,]priority)\n", app);
|
|
return -1;
|
|
}
|
|
|
|
info = ast_strdupa(data);
|
|
AST_STANDARD_APP_ARGS(args, info);
|
|
|
|
if (ast_strlen_zero(args.channel) || ast_strlen_zero(args.label)) {
|
|
ast_log(LOG_WARNING, "%s requires an argument (channel,[[context,]exten,]priority)\n", app);
|
|
return -1;
|
|
}
|
|
|
|
chan2 = ast_get_channel_by_name_locked(args.channel);
|
|
if (!chan2) {
|
|
ast_log(LOG_WARNING, "No such channel: %s\n", args.channel);
|
|
pbx_builtin_setvar_helper(chan, "CHANNELREDIRECT_STATUS", "NOCHANNEL");
|
|
return 0;
|
|
}
|
|
|
|
res = ast_async_parseable_goto(chan2, args.label);
|
|
pbx_builtin_setvar_helper(chan, "CHANNELREDIRECT_STATUS", "SUCCESS");
|
|
ast_channel_unlock(chan2);
|
|
|
|
return res;
|
|
}
|
|
|
|
static int unload_module(void)
|
|
{
|
|
return ast_unregister_application(app);
|
|
}
|
|
|
|
static int load_module(void)
|
|
{
|
|
return ast_register_application_xml(app, asyncgoto_exec) ?
|
|
AST_MODULE_LOAD_DECLINE : AST_MODULE_LOAD_SUCCESS;
|
|
}
|
|
|
|
AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Redirects a given channel to a dialplan target");
|