Add userevent application (bug #1300)
[asterisk/asterisk.git] / apps / app_userevent.c
1 /*
2  * Asterisk -- A telephony toolkit for Linux.
3  *
4  * UserEvent application -- send manager event
5  * 
6  *
7  * This program is free software, distributed under the terms of
8  * the GNU General Public License
9  */
10
11 #include <asterisk/lock.h>
12 #include <asterisk/file.h>
13 #include <asterisk/logger.h>
14 #include <asterisk/channel.h>
15 #include <asterisk/pbx.h>
16 #include <asterisk/module.h>
17 #include <asterisk/manager.h>
18 #include <stdlib.h>
19 #include <unistd.h>
20 #include <string.h>
21 #include <stdlib.h>
22 #include <pthread.h>
23
24 static char *tdesc = "Custom User Event Application";
25
26 static char *app = "UserEvent";
27
28 static char *synopsis = "Send an arbitrary event to the manager interface";
29
30 static char *descrip = 
31 "  UserEvent(eventname[|body]): Sends an arbitrary event to the\n"
32 "manager interface, with an optional body representing additional\n"
33 "arguments.  The format of the event will be:\n"
34 "    Event: UserEvent<specified event name>\n"
35 "    Channel: <channel name>\n"
36 "    Uniqueid: <call uniqueid>\n"
37 "    [body]\n"
38 "If the body is not specified, only Event, Channel, and Uniqueid fields\n"
39 "will be present.  Returns 0.";
40
41 STANDARD_LOCAL_USER;
42
43 LOCAL_USER_DECL;
44
45 static int userevent_exec(struct ast_channel *chan, void *data)
46 {
47         struct localuser *u;
48         char info[512];
49     char eventname[512];
50         char *eventbody;
51
52         if (!data || !strlen(data)) {
53                 ast_log(LOG_WARNING, "UserEvent requires an argument (eventname|optional event body)\n");
54                 return -1;
55         }
56
57         strncpy(info, (char *)data, strlen((char *)data) + AST_MAX_EXTENSION-1);
58         eventbody = strchr(eventname, '|');
59         if (eventbody) {
60                 *eventbody = '\0';
61                 eventbody++;
62         }
63         snprintf(eventname, sizeof(eventname), "UserEvent%s", info);
64         LOCAL_USER_ADD(u);
65
66         if(eventbody) {
67             ast_log(LOG_DEBUG, "Sending user event: %s, %s\n", eventname, eventbody);
68             manager_event(EVENT_FLAG_CALL, eventname, 
69                         "Channel: %s\r\nUniqueid: %s\r\n%s\r\n",
70                         chan->name, chan->uniqueid, eventbody);
71         } else {
72             ast_log(LOG_DEBUG, "Sending user event: %s\n", eventname);
73             manager_event(EVENT_FLAG_CALL, eventname, 
74                         "Channel: %s\r\nUniqueid: %s\r\n", chan->name, chan->uniqueid);
75         }
76
77         LOCAL_USER_REMOVE(u);
78         return 0;
79 }
80
81 int unload_module(void)
82 {
83         STANDARD_HANGUP_LOCALUSERS;
84         return ast_unregister_application(app);
85 }
86
87 int load_module(void)
88 {
89         return ast_register_application(app, userevent_exec, synopsis, descrip);
90 }
91
92 char *description(void)
93 {
94         return tdesc;
95 }
96
97 int usecount(void)
98 {
99         int res;
100         STANDARD_USECOUNT(res);
101         return res;
102 }
103
104 char *key()
105 {
106         return ASTERISK_GPL_KEY;
107 }