2013-04-08 13:27:45 +00:00
|
|
|
/*
|
|
|
|
* Asterisk -- An open source telephony toolkit.
|
|
|
|
*
|
|
|
|
* Copyright (C) 2012 - 2013, Digium, Inc.
|
|
|
|
*
|
|
|
|
* David M. Lee, II <dlee@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 Stasis dialplan application.
|
|
|
|
*
|
|
|
|
* \author David M. Lee, II <dlee@digium.com>
|
|
|
|
*/
|
|
|
|
|
|
|
|
/*** MODULEINFO
|
2013-04-15 16:43:47 +00:00
|
|
|
<depend>res_stasis</depend>
|
2013-04-08 13:27:45 +00:00
|
|
|
<support_level>core</support_level>
|
|
|
|
***/
|
|
|
|
|
|
|
|
#include "asterisk.h"
|
|
|
|
|
|
|
|
#include "asterisk/app.h"
|
|
|
|
#include "asterisk/module.h"
|
2015-04-01 13:35:10 +00:00
|
|
|
#include "asterisk/pbx.h"
|
2013-04-08 13:27:45 +00:00
|
|
|
#include "asterisk/stasis.h"
|
2013-05-14 21:45:08 +00:00
|
|
|
#include "asterisk/stasis_app_impl.h"
|
2013-04-08 13:27:45 +00:00
|
|
|
|
|
|
|
/*** DOCUMENTATION
|
|
|
|
<application name="Stasis" language="en_US">
|
|
|
|
<synopsis>Invoke an external Stasis application.</synopsis>
|
|
|
|
<syntax>
|
|
|
|
<parameter name="app_name" required="true">
|
|
|
|
<para>Name of the application to invoke.</para>
|
|
|
|
</parameter>
|
|
|
|
<parameter name="args">
|
2013-04-09 18:22:08 +00:00
|
|
|
<para>Optional comma-delimited arguments for the
|
|
|
|
application invocation.</para>
|
2013-04-08 13:27:45 +00:00
|
|
|
</parameter>
|
|
|
|
</syntax>
|
|
|
|
<description>
|
2015-04-01 16:30:25 +00:00
|
|
|
<para>Invoke a Stasis application.</para>
|
|
|
|
<para>This application will set the following channel variable upon
|
|
|
|
completion:</para>
|
2015-03-31 22:49:45 +00:00
|
|
|
<variablelist>
|
|
|
|
<variable name="STASISSTATUS">
|
|
|
|
<para>This indicates the status of the execution of the
|
|
|
|
Stasis application.</para>
|
|
|
|
<value name="SUCCESS">
|
2015-04-01 16:30:25 +00:00
|
|
|
The channel has exited Stasis without any failures in
|
|
|
|
Stasis.
|
2015-03-31 22:49:45 +00:00
|
|
|
</value>
|
|
|
|
<value name="FAILED">
|
2015-04-01 16:30:25 +00:00
|
|
|
A failure occurred when executing the Stasis
|
|
|
|
The app registry is not instantiated; The app
|
|
|
|
application. Some (not all) possible reasons for this:
|
|
|
|
requested is not registered; The app requested is not
|
|
|
|
active; Stasis couldn't send a start message.
|
2015-03-31 22:49:45 +00:00
|
|
|
</value>
|
|
|
|
</variable>
|
|
|
|
</variablelist>
|
2015-04-01 16:30:25 +00:00
|
|
|
</description>
|
2013-04-08 13:27:45 +00:00
|
|
|
</application>
|
|
|
|
***/
|
|
|
|
|
|
|
|
/*! \brief Maximum number of arguments for the Stasis dialplan application */
|
|
|
|
#define MAX_ARGS 128
|
|
|
|
|
|
|
|
/*! \brief Dialplan application name */
|
|
|
|
static const char *stasis = "Stasis";
|
|
|
|
|
|
|
|
/*! /brief Stasis dialplan application callback */
|
2013-04-15 16:43:47 +00:00
|
|
|
static int app_exec(struct ast_channel *chan, const char *data)
|
2013-04-08 13:27:45 +00:00
|
|
|
{
|
|
|
|
char *parse = NULL;
|
2015-03-31 22:49:45 +00:00
|
|
|
int ret = -1;
|
2013-04-08 13:27:45 +00:00
|
|
|
|
|
|
|
AST_DECLARE_APP_ARGS(args,
|
|
|
|
AST_APP_ARG(app_name);
|
|
|
|
AST_APP_ARG(app_argv)[MAX_ARGS];
|
|
|
|
);
|
|
|
|
|
|
|
|
ast_assert(chan != NULL);
|
|
|
|
ast_assert(data != NULL);
|
|
|
|
|
2015-03-31 22:49:45 +00:00
|
|
|
pbx_builtin_setvar_helper(chan, "STASISSTATUS", "");
|
|
|
|
|
2013-04-08 13:27:45 +00:00
|
|
|
/* parse the arguments */
|
|
|
|
parse = ast_strdupa(data);
|
|
|
|
AST_STANDARD_APP_ARGS(args, parse);
|
|
|
|
|
|
|
|
if (args.argc < 1) {
|
|
|
|
ast_log(LOG_WARNING, "Stasis app_name argument missing\n");
|
2015-03-31 22:49:45 +00:00
|
|
|
} else {
|
|
|
|
ret = stasis_app_exec(chan,
|
|
|
|
args.app_name,
|
|
|
|
args.argc - 1,
|
|
|
|
args.app_argv);
|
|
|
|
}
|
|
|
|
|
2016-03-15 18:31:19 +00:00
|
|
|
if (ret) {
|
|
|
|
/* set ret to 0 so pbx_core doesnt hangup the channel */
|
|
|
|
if (!ast_check_hangup(chan)) {
|
|
|
|
ret = 0;
|
|
|
|
} else {
|
|
|
|
ret = -1;
|
|
|
|
}
|
|
|
|
pbx_builtin_setvar_helper(chan, "STASISSTATUS", "FAILED");
|
2015-03-31 22:49:45 +00:00
|
|
|
} else {
|
2016-03-15 18:31:19 +00:00
|
|
|
pbx_builtin_setvar_helper(chan, "STASISSTATUS", "SUCCESS");
|
2013-04-08 13:27:45 +00:00
|
|
|
}
|
|
|
|
|
2015-03-31 22:49:45 +00:00
|
|
|
return ret;
|
2013-04-08 13:27:45 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
static int load_module(void)
|
|
|
|
{
|
|
|
|
int r = 0;
|
|
|
|
|
2013-05-10 17:12:57 +00:00
|
|
|
stasis_app_ref();
|
2013-04-15 16:43:47 +00:00
|
|
|
r |= ast_register_application_xml(stasis, app_exec);
|
2013-04-08 13:27:45 +00:00
|
|
|
return r;
|
|
|
|
}
|
|
|
|
|
|
|
|
static int unload_module(void)
|
|
|
|
{
|
|
|
|
int r = 0;
|
|
|
|
r |= ast_unregister_application(stasis);
|
2013-05-10 17:12:57 +00:00
|
|
|
stasis_app_unref();
|
2013-04-08 13:27:45 +00:00
|
|
|
return r;
|
|
|
|
}
|
|
|
|
|
2013-06-24 21:40:52 +00:00
|
|
|
AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_DEFAULT, "Stasis dialplan application",
|
2014-07-25 16:47:17 +00:00
|
|
|
.support_level = AST_MODULE_SUPPORT_CORE,
|
2013-05-10 17:12:57 +00:00
|
|
|
.load = load_module,
|
|
|
|
.unload = unload_module,
|
|
|
|
.nonoptreq = "res_stasis",
|
2015-05-06 00:49:04 +00:00
|
|
|
);
|