Allow a Skinny device to monitor a dialplan hint (w00t!).
[asterisk/asterisk.git] / apps / app_page.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (c) 2004 - 2006 Digium, Inc.  All rights reserved.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * This code is released under the GNU General Public License
9  * version 2.0.  See LICENSE for more information.
10  *
11  * See http://www.asterisk.org for more information about
12  * the Asterisk project. Please do not directly contact
13  * any of the maintainers of this project for assistance;
14  * the project provides a web site, mailing lists and IRC
15  * channels for your use.
16  *
17  */
18
19 /*! \file
20  *
21  * \brief page() - Paging application
22  *
23  * \author Mark Spencer <markster@digium.com>
24  *
25  * \ingroup applications
26  */
27
28 /*** MODULEINFO
29         <depend>zaptel</depend>
30  ***/
31
32 #include "asterisk.h"
33
34 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
35
36 #include <stdio.h>
37 #include <stdlib.h>
38 #include <unistd.h>
39 #include <string.h>
40 #include <errno.h>
41
42 #include "asterisk/options.h"
43 #include "asterisk/logger.h"
44 #include "asterisk/channel.h"
45 #include "asterisk/pbx.h"
46 #include "asterisk/module.h"
47 #include "asterisk/file.h"
48 #include "asterisk/app.h"
49 #include "asterisk/chanvars.h"
50 #include "asterisk/utils.h"
51 #include "asterisk/devicestate.h"
52 #include "asterisk/dial.h"
53
54 static const char *app_page= "Page";
55
56 static const char *page_synopsis = "Pages phones";
57
58 static const char *page_descrip =
59 "Page(Technology/Resource&Technology2/Resource2[|options])\n"
60 "  Places outbound calls to the given technology / resource and dumps\n"
61 "them into a conference bridge as muted participants.  The original\n"
62 "caller is dumped into the conference as a speaker and the room is\n"
63 "destroyed when the original caller leaves.  Valid options are:\n"
64 "        d - full duplex audio\n"
65 "        q - quiet, do not play beep to caller\n"
66 "        r - record the page into a file (see 'r' for app_meetme)\n"
67 "        s - only dial channel if devicestate says it is not in use\n";
68
69 enum {
70         PAGE_DUPLEX = (1 << 0),
71         PAGE_QUIET = (1 << 1),
72         PAGE_RECORD = (1 << 2),
73         PAGE_SKIP = (1 << 3),
74 } page_opt_flags;
75
76 AST_APP_OPTIONS(page_opts, {
77         AST_APP_OPTION('d', PAGE_DUPLEX),
78         AST_APP_OPTION('q', PAGE_QUIET),
79         AST_APP_OPTION('r', PAGE_RECORD),
80         AST_APP_OPTION('s', PAGE_SKIP),
81 });
82
83 #define MAX_DIALS 128
84
85 static int page_exec(struct ast_channel *chan, void *data)
86 {
87         struct ast_module_user *u;
88         char *options, *tech, *resource, *tmp;
89         char meetmeopts[88], originator[AST_CHANNEL_NAME];
90         struct ast_flags flags = { 0 };
91         unsigned int confid = ast_random();
92         struct ast_app *app;
93         int res = 0, pos = 0, i = 0;
94         struct ast_dial *dials[MAX_DIALS];
95
96         if (ast_strlen_zero(data)) {
97                 ast_log(LOG_WARNING, "This application requires at least one argument (destination(s) to page)\n");
98                 return -1;
99         }
100
101         u = ast_module_user_add(chan);
102
103         if (!(app = pbx_findapp("MeetMe"))) {
104                 ast_log(LOG_WARNING, "There is no MeetMe application available!\n");
105                 ast_module_user_remove(u);
106                 return -1;
107         };
108
109         options = ast_strdupa(data);
110
111         ast_copy_string(originator, chan->name, sizeof(originator));
112         if ((tmp = strchr(originator, '-')))
113                 *tmp = '\0';
114
115         tmp = strsep(&options, "|");
116         if (options)
117                 ast_app_parse_options(page_opts, &flags, NULL, options);
118
119         snprintf(meetmeopts, sizeof(meetmeopts), "MeetMe|%ud|%s%sqxdw(5)", confid, (ast_test_flag(&flags, PAGE_DUPLEX) ? "" : "m"),
120                 (ast_test_flag(&flags, PAGE_RECORD) ? "r" : "") );
121
122         /* Go through parsing/calling each device */
123         while ((tech = strsep(&tmp, "&"))) {
124                 int state = 0;
125                 struct ast_dial *dial = NULL;
126
127                 /* don't call the originating device */
128                 if (!strcasecmp(tech, originator))
129                         continue;
130
131                 /* If no resource is available, continue on */
132                 if (!(resource = strchr(tech, '/'))) {
133                         ast_log(LOG_WARNING, "Incomplete destination '%s' supplied.\n", tech);
134                         continue;
135                 }
136
137                 /* Ensure device is not in use if skip option is enabled */
138                 if (ast_test_flag(&flags, PAGE_SKIP) && (state = ast_device_state(tech)) != AST_DEVICE_NOT_INUSE) {
139                         ast_log(LOG_WARNING, "Destination '%s' has device state '%s'.\n", tech, devstate2str(state));
140                         continue;
141                 }
142
143                 *resource++ = '\0';
144
145                 /* Create a dialing structure */
146                 if (!(dial = ast_dial_create())) {
147                         ast_log(LOG_WARNING, "Failed to create dialing structure.\n");
148                         continue;
149                 }
150
151                 /* Append technology and resource */
152                 ast_dial_append(dial, tech, resource);
153
154                 /* Set ANSWER_EXEC as global option */
155                 ast_dial_option_global_enable(dial, AST_DIAL_OPTION_ANSWER_EXEC, meetmeopts);
156
157                 /* Run this dial in async mode */
158                 ast_dial_run(dial, chan, 1);
159
160                 /* Put in our dialing array */
161                 dials[pos++] = dial;
162         }
163
164         if (!ast_test_flag(&flags, PAGE_QUIET)) {
165                 res = ast_streamfile(chan, "beep", chan->language);
166                 if (!res)
167                         res = ast_waitstream(chan, "");
168         }
169
170         if (!res) {
171                 snprintf(meetmeopts, sizeof(meetmeopts), "%ud|A%s%sqxd", confid, (ast_test_flag(&flags, PAGE_DUPLEX) ? "" : "t"), 
172                         (ast_test_flag(&flags, PAGE_RECORD) ? "r" : "") );
173                 pbx_exec(chan, app, meetmeopts);
174         }
175
176         /* Go through each dial attempt cancelling, joining, and destroying */
177         for (i = 0; i < pos; i++) {
178                 struct ast_dial *dial = dials[i];
179
180                 /* If the dial is already answered, then they will/should get kicked out by Meetme */
181                 if (ast_dial_state(dial) != AST_DIAL_RESULT_ANSWERED)
182                         ast_dial_join(dial);
183
184                 /* Hangup all channels */
185                 ast_dial_hangup(dial);
186
187                 /* Destroy dialing structure */
188                 ast_dial_destroy(dial);
189         }
190
191         ast_module_user_remove(u);
192
193         return -1;
194 }
195
196 static int unload_module(void)
197 {
198         int res;
199
200         res =  ast_unregister_application(app_page);
201
202         ast_module_user_hangup_all();
203
204         return res;
205 }
206
207 static int load_module(void)
208 {
209         return ast_register_application(app_page, page_exec, page_synopsis, page_descrip);
210 }
211
212 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Page Multiple Phones");
213