50a8a270e5287aad147f3146f1c89e83349512d6
[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
25 #include <stdio.h>
26 #include <stdlib.h>
27 #include <unistd.h>
28 #include <string.h>
29
30 #include "asterisk.h"
31
32 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
33
34 #include "asterisk/file.h"
35 #include "asterisk/logger.h"
36 #include "asterisk/options.h"
37 #include "asterisk/channel.h"
38 #include "asterisk/pbx.h"
39 #include "asterisk/module.h"
40
41 /* Maximum length of any variable */
42 #define MAXRESULT       1024
43
44 static char *tdesc = "Executes applications";
45
46 static char *app_exec = "Exec";
47
48 static char *exec_synopsis = "Executes internal application";
49
50 static char *exec_descrip =
51 "Usage: Exec(appname(arguments))\n"
52 "  Allows an arbitrary application to be invoked even when not\n"
53 "hardcoded into the dialplan. To invoke external applications\n"
54 "see the application System. Returns whatever value the\n"
55 "app returns or a non-zero value if the app cannot be found.\n";
56
57 STANDARD_LOCAL_USER;
58
59 LOCAL_USER_DECL;
60
61 static int exec_exec(struct ast_channel *chan, void *data)
62 {
63         int res=0;
64         struct localuser *u;
65         char *s, *appname, *endargs, args[MAXRESULT];
66         struct ast_app *app;
67
68         LOCAL_USER_ADD(u);
69
70         memset(args, 0, MAXRESULT);
71
72         /* Check and parse arguments */
73         if (data) {
74                 s = ast_strdupa((char *)data);
75                 if (s) {
76                         appname = strsep(&s, "(");
77                         if (s) {
78                                 endargs = strrchr(s, ')');
79                                 if (endargs)
80                                         *endargs = '\0';
81                                 pbx_substitute_variables_helper(chan, s, args, MAXRESULT - 1);
82                         }
83                         if (appname) {
84                                 app = pbx_findapp(appname);
85                                 if (app) {
86                                         res = pbx_exec(chan, app, args, 1);
87                                 } else {
88                                         ast_log(LOG_WARNING, "Could not find application (%s)\n", appname);
89                                         res = -1;
90                                 }
91                         }
92                 } else {
93                         ast_log(LOG_ERROR, "Out of memory\n");
94                         res = -1;
95                 }
96         }
97
98         LOCAL_USER_REMOVE(u);
99         return res;
100 }
101
102 int unload_module(void)
103 {
104         int res;
105
106         res = ast_unregister_application(app_exec);
107
108         STANDARD_HANGUP_LOCALUSERS;
109
110         return res;
111 }
112
113 int load_module(void)
114 {
115         return ast_register_application(app_exec, exec_exec, exec_synopsis, exec_descrip);
116 }
117
118 char *description(void)
119 {
120         return tdesc;
121 }
122
123 int usecount(void)
124 {
125         int res;
126         STANDARD_USECOUNT(res);
127         return res;
128 }
129
130 char *key()
131 {
132         return ASTERISK_GPL_KEY;
133 }