Add sendtext application
[asterisk/asterisk.git] / apps / app_sendtext.c
1 /*
2  * Asterisk -- A telephony toolkit for Linux.
3  *
4  * App to transmit a text message
5  * 
6  * Copyright (C) 1999, Mark Spencer
7  *
8  * Mark Spencer <markster@linux-support.net>
9  *
10  * This program is free software, distributed under the terms of
11  * the GNU General Public License
12  */
13  
14 #include <asterisk/lock.h>
15 #include <asterisk/file.h>
16 #include <asterisk/logger.h>
17 #include <asterisk/channel.h>
18 #include <asterisk/channel_pvt.h>
19 #include <asterisk/pbx.h>
20 #include <asterisk/module.h>
21 #include <asterisk/translate.h>
22 #include <asterisk/image.h>
23 #include <string.h>
24 #include <stdlib.h>
25 #include <pthread.h>
26
27 static char *tdesc = "Send Text Applications";
28
29 static char *app = "SendText";
30
31 static char *synopsis = "Send a Text Message";
32
33 static char *descrip = 
34 "  SendText(text): Sends text to client.  If the client\n"
35 "does not support text transport, and  there  exists  a  step  with\n"
36 "priority  n + 101,  then  execution  will  continue  at that step.\n"
37 "Otherwise, execution will continue at  the  next  priority  level.\n"
38 "SendText only returns 0  if  the  text  was  sent  correctly  or  if\n"
39 "the channel  does  not  support text transport,  and -1 otherwise.\n";
40
41 STANDARD_LOCAL_USER;
42
43 LOCAL_USER_DECL;
44
45 static int sendtext_exec(struct ast_channel *chan, void *data)
46 {
47         int res = 0;
48         struct localuser *u;
49         if (!data || !strlen((char *)data)) {
50                 ast_log(LOG_WARNING, "SendText requires an argument (text)\n");
51                 return -1;
52         }
53         LOCAL_USER_ADD(u);
54         ast_mutex_lock(&chan->lock);
55         if (!chan->pvt->send_text) {
56                 ast_mutex_unlock(&chan->lock);
57                 /* Does not support transport */
58                 if (ast_exists_extension(chan, chan->context, chan->exten, chan->priority + 101, chan->callerid))
59                         chan->priority += 100;
60                 LOCAL_USER_REMOVE(u);
61                 return 0;
62         }
63         ast_mutex_unlock(&chan->lock);
64         res = ast_sendtext(chan, (char *)data);
65         LOCAL_USER_REMOVE(u);
66         return res;
67 }
68
69 int unload_module(void)
70 {
71         STANDARD_HANGUP_LOCALUSERS;
72         return ast_unregister_application(app);
73 }
74
75 int load_module(void)
76 {
77         return ast_register_application(app, sendtext_exec, synopsis, descrip);
78 }
79
80 char *description(void)
81 {
82         return tdesc;
83 }
84
85 int usecount(void)
86 {
87         int res;
88         STANDARD_USECOUNT(res);
89         return res;
90 }
91
92 char *key()
93 {
94         return ASTERISK_GPL_KEY;
95 }