b2a45dc936a2bc61393a28b5e942c824f8fb216b
[asterisk/asterisk.git] / apps / app_exec.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (c) 2004 - 2005, Tilghman Lesher.  All rights reserved.
5  *
6  * Tilghman Lesher <app_exec__v001@the-tilghman.com>
7  *
8  * This code is released by the author with no restrictions on usage.
9  *
10  * See http://www.asterisk.org for more information about
11  * the Asterisk project. Please do not directly contact
12  * any of the maintainers of this project for assistance;
13  * the project provides a web site, mailing lists and IRC
14  * channels for your use.
15  *
16  */
17
18 /*! \file
19  *
20  * \brief Exec application
21  *
22  * \author Tilghman Lesher <app_exec__v001@the-tilghman.com>
23  *
24  * \ingroup applications
25  */
26
27 #include <stdio.h>
28 #include <stdlib.h>
29 #include <unistd.h>
30 #include <string.h>
31
32 #include "asterisk.h"
33
34 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
35
36 #include "asterisk/file.h"
37 #include "asterisk/logger.h"
38 #include "asterisk/options.h"
39 #include "asterisk/channel.h"
40 #include "asterisk/pbx.h"
41 #include "asterisk/module.h"
42
43 /* Maximum length of any variable */
44 #define MAXRESULT       1024
45
46 static char *tdesc = "Executes applications";
47
48 static char *app_exec = "Exec";
49
50 static char *exec_synopsis = "Executes internal application";
51
52 static char *exec_descrip =
53 "Usage: Exec(appname(arguments))\n"
54 "  Allows an arbitrary application to be invoked even when not\n"
55 "hardcoded into the dialplan. To invoke external applications\n"
56 "see the application System. Returns whatever value the\n"
57 "app returns or a non-zero value if the app cannot be found.\n";
58
59 STANDARD_LOCAL_USER;
60
61 LOCAL_USER_DECL;
62
63 static int exec_exec(struct ast_channel *chan, void *data)
64 {
65         int res=0;
66         struct localuser *u;
67         char *s, *appname, *endargs, args[MAXRESULT];
68         struct ast_app *app;
69
70         LOCAL_USER_ADD(u);
71
72         memset(args, 0, MAXRESULT);
73
74         /* Check and parse arguments */
75         if (data) {
76                 s = ast_strdupa(data);
77                 appname = strsep(&s, "(");
78                 if (s) {
79                         endargs = strrchr(s, ')');
80                         if (endargs)
81                                 *endargs = '\0';
82                         pbx_substitute_variables_helper(chan, s, args, MAXRESULT - 1);
83                 }
84                 if (appname) {
85                         app = pbx_findapp(appname);
86                         if (app) {
87                                 res = pbx_exec(chan, app, args, 1);
88                         } else {
89                                 ast_log(LOG_WARNING, "Could not find application (%s)\n", appname);
90                                 res = -1;
91                         }
92                 }
93         }
94
95         LOCAL_USER_REMOVE(u);
96         return res;
97 }
98
99 int unload_module(void)
100 {
101         int res;
102
103         res = ast_unregister_application(app_exec);
104
105         STANDARD_HANGUP_LOCALUSERS;
106
107         return res;
108 }
109
110 int load_module(void)
111 {
112         return ast_register_application(app_exec, exec_exec, exec_synopsis, exec_descrip);
113 }
114
115 char *description(void)
116 {
117         return tdesc;
118 }
119
120 int usecount(void)
121 {
122         int res;
123         STANDARD_USECOUNT(res);
124         return res;
125 }
126
127 char *key()
128 {
129         return ASTERISK_GPL_KEY;
130 }