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