1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
|
/*
* 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
<depend>res_stasis</depend>
<support_level>core</support_level>
***/
#include "asterisk.h"
#include "asterisk/app.h"
#include "asterisk/module.h"
#include "asterisk/pbx.h"
#include "asterisk/stasis.h"
#include "asterisk/stasis_app_impl.h"
/*** 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">
<para>Optional comma-delimited arguments for the
application invocation.</para>
</parameter>
</syntax>
<description>
<para>Invoke a Stasis application.</para>
<para>This application will set the following channel variable upon
completion:</para>
<variablelist>
<variable name="STASISSTATUS">
<para>This indicates the status of the execution of the
Stasis application.</para>
<value name="SUCCESS">
The channel has exited Stasis without any failures in
Stasis.
</value>
<value name="FAILED">
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.
</value>
</variable>
</variablelist>
</description>
</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 */
static int app_exec(struct ast_channel *chan, const char *data)
{
char *parse = NULL;
int ret = -1;
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);
pbx_builtin_setvar_helper(chan, "STASISSTATUS", "");
/* 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");
} else {
ret = stasis_app_exec(chan,
args.app_name,
args.argc - 1,
args.app_argv);
}
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");
} else {
pbx_builtin_setvar_helper(chan, "STASISSTATUS", "SUCCESS");
}
return ret;
}
static int load_module(void)
{
return ast_register_application_xml(stasis, app_exec);
}
static int unload_module(void)
{
return ast_unregister_application(stasis);
}
AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_DEFAULT, "Stasis dialplan application",
.support_level = AST_MODULE_SUPPORT_CORE,
.load = load_module,
.unload = unload_module,
.requires = "res_stasis",
);
|
