Add "read" application
[asterisk/asterisk.git] / apps / app_read.c
1 /*
2  * Asterisk -- A telephony toolkit for Linux.
3  *
4  * Trivial application to read a variable
5  * 
6  * Copyright (C) 2003, Digium
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 <asterisk/lock.h>
15 #include <asterisk/file.h>
16 #include <asterisk/logger.h>
17 #include <asterisk/channel.h>
18 #include <asterisk/pbx.h>
19 #include <asterisk/app.h>
20 #include <asterisk/module.h>
21 #include <asterisk/translate.h>
22 #include <string.h>
23 #include <stdlib.h>
24 #include <pthread.h>
25
26 static char *tdesc = "Read Variable Application";
27
28 static char *app = "Read";
29
30 static char *synopsis = "Read a variable";
31
32 static char *descrip = 
33 "  Read(variable[|filename]):  Reads a '#' terminated string of digits from\n"
34 "the user, optionally playing a given filename first.  Returns -1 on hangup or\n"
35 "error and 0 otherwise.\n";
36
37 STANDARD_LOCAL_USER;
38
39 LOCAL_USER_DECL;
40
41 static int read_exec(struct ast_channel *chan, void *data)
42 {
43         int res = 0;
44         struct localuser *u;
45         char tmp[256];
46         char tmp2[128]="";
47         char *filename;
48         char *stringp;
49         if (!data || !strlen((char *)data)) {
50                 ast_log(LOG_WARNING, "Read requires an argument (variable)\n");
51                 return -1;
52         }
53         strncpy(tmp, (char *)data, sizeof(tmp)-1);
54         stringp=tmp;
55         strsep(&stringp, "|");
56         filename = strsep(&stringp, "|");
57         LOCAL_USER_ADD(u);
58         if (chan->_state != AST_STATE_UP) {
59                 /* Answer if the line isn't up. */
60                 res = ast_answer(chan);
61         }
62         if (!res) {
63                 ast_stopstream(chan);
64                 res = ast_app_getdata(chan, filename, tmp2, sizeof(tmp2) - 1, 0);
65                 ast_verbose("You entered '%s'\n", tmp2);
66         }
67         LOCAL_USER_REMOVE(u);
68         return res;
69 }
70
71 int unload_module(void)
72 {
73         STANDARD_HANGUP_LOCALUSERS;
74         return ast_unregister_application(app);
75 }
76
77 int load_module(void)
78 {
79         return ast_register_application(app, read_exec, synopsis, descrip);
80 }
81
82 char *description(void)
83 {
84         return tdesc;
85 }
86
87 int usecount(void)
88 {
89         int res;
90         STANDARD_USECOUNT(res);
91         return res;
92 }
93
94 char *key()
95 {
96         return ASTERISK_GPL_KEY;
97 }