d1ec12082d15a5dc2d5ae29cd2a172e259e8dffe
[asterisk/asterisk.git] / apps / app_system.c
1 /*
2  * Asterisk -- A telephony toolkit for Linux.
3  *
4  * Execute arbitrary system commands
5  * 
6  * Copyright (C) 1999 - 2005, Digium, Inc.
7  *
8  * Mark Spencer <markster@digium.com>
9  *
10  * This program is free software, distributed under the terms of
11  * the GNU General Public License
12  */
13
14 #include <stdlib.h>
15 #include <unistd.h>
16 #include <string.h>
17 #include <stdlib.h>
18 #include <errno.h>
19
20 #include "asterisk.h"
21
22 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
23
24 #include "asterisk/lock.h"
25 #include "asterisk/file.h"
26 #include "asterisk/logger.h"
27 #include "asterisk/channel.h"
28 #include "asterisk/pbx.h"
29 #include "asterisk/module.h"
30 #include "asterisk/app.h"
31
32 static char *tdesc = "Generic System() application";
33
34 static char *app = "System";
35
36 static char *app2 = "TrySystem";
37
38 static char *synopsis = "Execute a system command";
39
40 static char *synopsis2 = "Try executing a system command";
41
42 static char *descrip =
43 "  System(command): Executes a command  by  using  system(). Returns -1 on\n"
44 "failure to execute the specified command. If  the command itself executes\n"
45 "but is in error, and if there exists a priority n + 101, where 'n' is the\n"
46 "priority of the current instance, then  the  channel  will  be  setup  to\n"
47 "continue at that priority level.  Otherwise, System returns 0.\n";
48
49 static char *descrip2 =
50 "  TrySystem(command): Executes a command  by  using  system(). Returns 0\n"
51 "on any situation. If  the command itself executes but is in error, and if\n"
52 "there exists a priority n + 101, where 'n' is the priority of the current\n"
53 "instance, then  the  channel  will  be  setup  to continue at that\n"
54 "priority level.  Otherwise, System returns 0.\n";
55
56 STANDARD_LOCAL_USER;
57
58 LOCAL_USER_DECL;
59
60 static int system_exec_helper(struct ast_channel *chan, void *data, int failmode)
61 {
62         int res=0;
63         struct localuser *u;
64         if (!data) {
65                 ast_log(LOG_WARNING, "System requires an argument(command)\n");
66                 return failmode;
67         }
68         LOCAL_USER_ADD(u);
69         /* Do our thing here */
70         res = ast_safe_system((char *)data);
71         if ((res < 0) && (errno != ECHILD)) {
72                 ast_log(LOG_WARNING, "Unable to execute '%s'\n", (char *)data);
73                 res = failmode;
74         } else if (res == 127) {
75                 ast_log(LOG_WARNING, "Unable to execute '%s'\n", (char *)data);
76                 res = failmode;
77         } else {
78                 if (res < 0)
79                         res = 0;
80                 if (res && ast_exists_extension(chan, chan->context, chan->exten, chan->priority + 101, chan->cid.cid_num)) 
81                         chan->priority+=100;
82                 res = 0;
83         }
84         LOCAL_USER_REMOVE(u);
85         return res;
86 }
87
88 static int system_exec(struct ast_channel *chan, void *data)
89 {
90         return system_exec_helper(chan, data, -1);
91 }
92
93 static int trysystem_exec(struct ast_channel *chan, void *data)
94 {
95         return system_exec_helper(chan, data, 0);
96 }
97
98 int unload_module(void)
99 {
100         STANDARD_HANGUP_LOCALUSERS;
101         ast_unregister_application(app2);
102         return ast_unregister_application(app);
103 }
104
105 int load_module(void)
106 {
107         ast_register_application(app2, trysystem_exec, synopsis2, descrip2);
108         return ast_register_application(app, system_exec, synopsis, descrip);
109 }
110
111 char *description(void)
112 {
113         return tdesc;
114 }
115
116 int usecount(void)
117 {
118         int res;
119         STANDARD_USECOUNT(res);
120         return res;
121 }
122
123 char *key()
124 {
125         return ASTERISK_GPL_KEY;
126 }