91441f64e3a265c0223f40b9d73b99a9b4bbb829
[asterisk/asterisk.git] / main / app.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2005, Digium, Inc.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file
20  *
21  * \brief Convenient Application Routines
22  *
23  * \author Mark Spencer <markster@digium.com> 
24  */
25
26 #include "asterisk.h"
27
28 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
29
30 #include <stdio.h>
31 #include <stdlib.h>
32 #include <string.h>
33 #include <sys/time.h>
34 #include <signal.h>
35 #include <errno.h>
36 #include <unistd.h>
37 #include <dirent.h>
38 #include <sys/types.h>
39 #include <sys/stat.h>
40 #include <regex.h>
41
42 #include "asterisk/channel.h"
43 #include "asterisk/pbx.h"
44 #include "asterisk/file.h"
45 #include "asterisk/app.h"
46 #include "asterisk/dsp.h"
47 #include "asterisk/logger.h"
48 #include "asterisk/options.h"
49 #include "asterisk/utils.h"
50 #include "asterisk/lock.h"
51 #include "asterisk/indications.h"
52 #include "asterisk/linkedlists.h"
53
54 #define MAX_OTHER_FORMATS 10
55
56 static AST_LIST_HEAD_STATIC(groups, ast_group_info);
57
58 /* !
59 This function presents a dialtone and reads an extension into 'collect' 
60 which must be a pointer to a **pre-initialized** array of char having a 
61 size of 'size' suitable for writing to.  It will collect no more than the smaller 
62 of 'maxlen' or 'size' minus the original strlen() of collect digits.
63 \return 0 if extension does not exist, 1 if extension exists
64 */
65 int ast_app_dtget(struct ast_channel *chan, const char *context, char *collect, size_t size, int maxlen, int timeout) 
66 {
67         struct ind_tone_zone_sound *ts;
68         int res=0, x=0;
69
70         if (maxlen > size)
71                 maxlen = size;
72         
73         if (!timeout && chan->pbx)
74                 timeout = chan->pbx->dtimeout;
75         else if (!timeout)
76                 timeout = 5;
77         
78         ts = ast_get_indication_tone(chan->zone,"dial");
79         if (ts && ts->data[0])
80                 res = ast_playtones_start(chan, 0, ts->data, 0);
81         else 
82                 ast_log(LOG_NOTICE,"Huh....? no dial for indications?\n");
83         
84         for (x = strlen(collect); x < maxlen; ) {
85                 res = ast_waitfordigit(chan, timeout);
86                 if (!ast_ignore_pattern(context, collect))
87                         ast_playtones_stop(chan);
88                 if (res < 1)
89                         break;
90                 if (res == '#')
91                         break;
92                 collect[x++] = res;
93                 if (!ast_matchmore_extension(chan, context, collect, 1, chan->cid.cid_num))
94                         break;
95         }
96         if (res >= 0)
97                 res = ast_exists_extension(chan, context, collect, 1, chan->cid.cid_num) ? 1 : 0;
98         return res;
99 }
100
101 /*! \param c The channel to read from
102  *  \param prompt The file to stream to the channel
103  *  \param s The string to read in to.  Must be at least the size of your length
104  *  \param maxlen How many digits to read (maximum)
105  *  \param timeout set timeout to 0 for "standard" timeouts. Set timeout to -1 for 
106  *      "ludicrous time" (essentially never times out) */
107 int ast_app_getdata(struct ast_channel *c, const char *prompt, char *s, int maxlen, int timeout)
108 {
109         int res = 0, to, fto;
110         char *front, *filename;
111
112         /* XXX Merge with full version? XXX */
113         
114         if (maxlen)
115                 s[0] = '\0';
116
117         if (!prompt)
118                 prompt="";
119
120         filename = ast_strdupa(prompt);
121         while ((front = strsep(&filename, "&"))) {
122                 if (!ast_strlen_zero(front)) {
123                         res = ast_streamfile(c, front, c->language);
124                         if (res)
125                                 continue;
126                 }
127                 if (ast_strlen_zero(filename)) {
128                         /* set timeouts for the last prompt */
129                         fto = c->pbx ? c->pbx->rtimeout * 1000 : 6000;
130                         to = c->pbx ? c->pbx->dtimeout * 1000 : 2000;
131
132                         if (timeout > 0) 
133                                 fto = to = timeout;
134                         if (timeout < 0) 
135                                 fto = to = 1000000000;
136                 } else {
137                         /* there is more than one prompt, so
138                            get rid of the long timeout between 
139                            prompts, and make it 50ms */
140                         fto = 50;
141                         to = c->pbx ? c->pbx->dtimeout * 1000 : 2000;
142                 }
143                 res = ast_readstring(c, s, maxlen, to, fto, "#");
144                 if (!ast_strlen_zero(s))
145                         return res;
146         }
147         
148         return res;
149 }
150
151
152 int ast_app_getdata_full(struct ast_channel *c, char *prompt, char *s, int maxlen, int timeout, int audiofd, int ctrlfd)
153 {
154         int res, to, fto;
155         if (prompt) {
156                 res = ast_streamfile(c, prompt, c->language);
157                 if (res < 0)
158                         return res;
159         }
160         fto = 6000;
161         to = 2000;
162         if (timeout > 0) 
163                 fto = to = timeout;
164         if (timeout < 0) 
165                 fto = to = 1000000000;
166         res = ast_readstring_full(c, s, maxlen, to, fto, "#", audiofd, ctrlfd);
167         return res;
168 }
169
170 static int (*ast_has_voicemail_func)(const char *mailbox, const char *folder) = NULL;
171 static int (*ast_inboxcount_func)(const char *mailbox, int *newmsgs, int *oldmsgs) = NULL;
172 static int (*ast_messagecount_func)(const char *context, const char *mailbox, const char *folder) = NULL;
173
174 void ast_install_vm_functions(int (*has_voicemail_func)(const char *mailbox, const char *folder),
175                               int (*inboxcount_func)(const char *mailbox, int *newmsgs, int *oldmsgs),
176                               int (*messagecount_func)(const char *context, const char *mailbox, const char *folder))
177 {
178         ast_has_voicemail_func = has_voicemail_func;
179         ast_inboxcount_func = inboxcount_func;
180         ast_messagecount_func = messagecount_func;
181 }
182
183 void ast_uninstall_vm_functions(void)
184 {
185         ast_has_voicemail_func = NULL;
186         ast_inboxcount_func = NULL;
187         ast_messagecount_func = NULL;
188 }
189
190 int ast_app_has_voicemail(const char *mailbox, const char *folder)
191 {
192         static int warned = 0;
193         if (ast_has_voicemail_func)
194                 return ast_has_voicemail_func(mailbox, folder);
195
196         if ((option_verbose > 2) && !warned) {
197                 ast_verbose(VERBOSE_PREFIX_3 "Message check requested for mailbox %s/folder %s but voicemail not loaded.\n", mailbox, folder ? folder : "INBOX");
198                 warned++;
199         }
200         return 0;
201 }
202
203
204 int ast_app_inboxcount(const char *mailbox, int *newmsgs, int *oldmsgs)
205 {
206         static int warned = 0;
207         if (newmsgs)
208                 *newmsgs = 0;
209         if (oldmsgs)
210                 *oldmsgs = 0;
211         if (ast_inboxcount_func)
212                 return ast_inboxcount_func(mailbox, newmsgs, oldmsgs);
213
214         if (!warned && (option_verbose > 2)) {
215                 warned++;
216                 ast_verbose(VERBOSE_PREFIX_3 "Message count requested for mailbox %s but voicemail not loaded.\n", mailbox);
217         }
218
219         return 0;
220 }
221
222 int ast_app_messagecount(const char *context, const char *mailbox, const char *folder)
223 {
224         static int warned = 0;
225         if (ast_messagecount_func)
226                 return ast_messagecount_func(context, mailbox, folder);
227
228         if (!warned && (option_verbose > 2)) {
229                 warned++;
230                 ast_verbose(VERBOSE_PREFIX_3 "Message count requested for mailbox %s@%s/%s but voicemail not loaded.\n", mailbox, context, folder);
231         }
232
233         return 0;
234 }
235
236 int ast_dtmf_stream(struct ast_channel *chan, struct ast_channel *peer, const char *digits, int between) 
237 {
238         const char *ptr;
239         int res = 0;
240
241         if (!between)
242                 between = 100;
243
244         if (peer)
245                 res = ast_autoservice_start(peer);
246
247         if (!res)
248                 res = ast_waitfor(chan, 100);
249
250         /* ast_waitfor will return the number of remaining ms on success */
251         if (res < 0)
252                 return res;
253
254         for (ptr = digits; *ptr; ptr++) {
255                 if (*ptr == 'w') {
256                         /* 'w' -- wait half a second */
257                         if ((res = ast_safe_sleep(chan, 500)))
258                                 break;
259                 } else if (strchr("0123456789*#abcdfABCDF", *ptr)) {
260                         /* Character represents valid DTMF */
261                         if (*ptr == 'f' || *ptr == 'F') {
262                                 /* ignore return values if not supported by channel */
263                                 ast_indicate(chan, AST_CONTROL_FLASH);
264                         } else
265                                 ast_senddigit(chan, *ptr);
266                         /* pause between digits */
267                         if ((res = ast_safe_sleep(chan, between)))
268                                 break;
269                 } else
270                         ast_log(LOG_WARNING, "Illegal DTMF character '%c' in string. (0-9*#aAbBcCdD allowed)\n",*ptr);
271         }
272
273         if (peer) {
274                 /* Stop autoservice on the peer channel, but don't overwrite any error condition 
275                    that has occurred previously while acting on the primary channel */
276                 if (ast_autoservice_stop(peer) && !res)
277                         res = -1;
278         }
279
280         return res;
281 }
282
283 struct linear_state {
284         int fd;
285         int autoclose;
286         int allowoverride;
287         int origwfmt;
288 };
289
290 static void linear_release(struct ast_channel *chan, void *params)
291 {
292         struct linear_state *ls = params;
293         if (ls->origwfmt && ast_set_write_format(chan, ls->origwfmt)) {
294                 ast_log(LOG_WARNING, "Unable to restore channel '%s' to format '%d'\n", chan->name, ls->origwfmt);
295         }
296         if (ls->autoclose)
297                 close(ls->fd);
298         free(params);
299 }
300
301 static int linear_generator(struct ast_channel *chan, void *data, int len, int samples)
302 {
303         struct ast_frame f;
304         short buf[2048 + AST_FRIENDLY_OFFSET / 2];
305         struct linear_state *ls = data;
306         int res;
307         len = samples * 2;
308         if (len > sizeof(buf) - AST_FRIENDLY_OFFSET) {
309                 ast_log(LOG_WARNING, "Can't generate %d bytes of data!\n" ,len);
310                 len = sizeof(buf) - AST_FRIENDLY_OFFSET;
311         }
312         memset(&f, 0, sizeof(f));
313         res = read(ls->fd, buf + AST_FRIENDLY_OFFSET/2, len);
314         if (res > 0) {
315                 f.frametype = AST_FRAME_VOICE;
316                 f.subclass = AST_FORMAT_SLINEAR;
317                 f.data = buf + AST_FRIENDLY_OFFSET/2;
318                 f.datalen = res;
319                 f.samples = res / 2;
320                 f.offset = AST_FRIENDLY_OFFSET;
321                 ast_write(chan, &f);
322                 if (res == len)
323                         return 0;
324         }
325         return -1;
326 }
327
328 static void *linear_alloc(struct ast_channel *chan, void *params)
329 {
330         struct linear_state *ls;
331         /* In this case, params is already malloc'd */
332         if (params) {
333                 ls = params;
334                 if (ls->allowoverride)
335                         ast_set_flag(chan, AST_FLAG_WRITE_INT);
336                 else
337                         ast_clear_flag(chan, AST_FLAG_WRITE_INT);
338                 ls->origwfmt = chan->writeformat;
339                 if (ast_set_write_format(chan, AST_FORMAT_SLINEAR)) {
340                         ast_log(LOG_WARNING, "Unable to set '%s' to linear format (write)\n", chan->name);
341                         free(ls);
342                         ls = params = NULL;
343                 }
344         }
345         return params;
346 }
347
348 static struct ast_generator linearstream = 
349 {
350         alloc: linear_alloc,
351         release: linear_release,
352         generate: linear_generator,
353 };
354
355 int ast_linear_stream(struct ast_channel *chan, const char *filename, int fd, int allowoverride)
356 {
357         struct linear_state *lin;
358         char tmpf[256];
359         int res = -1;
360         int autoclose = 0;
361         if (fd < 0) {
362                 if (ast_strlen_zero(filename))
363                         return -1;
364                 autoclose = 1;
365                 if (filename[0] == '/') 
366                         ast_copy_string(tmpf, filename, sizeof(tmpf));
367                 else
368                         snprintf(tmpf, sizeof(tmpf), "%s/%s/%s", ast_config_AST_DATA_DIR, "sounds", filename);
369                 fd = open(tmpf, O_RDONLY);
370                 if (fd < 0){
371                         ast_log(LOG_WARNING, "Unable to open file '%s': %s\n", tmpf, strerror(errno));
372                         return -1;
373                 }
374         }
375         if ((lin = ast_calloc(1, sizeof(*lin)))) {
376                 lin->fd = fd;
377                 lin->allowoverride = allowoverride;
378                 lin->autoclose = autoclose;
379                 res = ast_activate_generator(chan, &linearstream, lin);
380         }
381         return res;
382 }
383
384 int ast_control_streamfile(struct ast_channel *chan, const char *file,
385                            const char *fwd, const char *rev,
386                            const char *stop, const char *pause,
387                            const char *restart, int skipms) 
388 {
389         char *breaks = NULL;
390         char *end = NULL;
391         int blen = 2;
392         int res;
393         long pause_restart_point = 0;
394
395         if (stop)
396                 blen += strlen(stop);
397         if (pause)
398                 blen += strlen(pause);
399         if (restart)
400                 blen += strlen(restart);
401
402         if (blen > 2) {
403                 breaks = alloca(blen + 1);
404                 breaks[0] = '\0';
405                 if (stop)
406                         strcat(breaks, stop);
407                 if (pause)
408                         strcat(breaks, pause);
409                 if (restart)
410                         strcat(breaks, restart);
411         }
412         if (chan->_state != AST_STATE_UP)
413                 res = ast_answer(chan);
414
415         if (file) {
416                 if ((end = strchr(file,':'))) {
417                         if (!strcasecmp(end, ":end")) {
418                                 *end = '\0';
419                                 end++;
420                         }
421                 }
422         }
423
424         for (;;) {
425                 ast_stopstream(chan);
426                 res = ast_streamfile(chan, file, chan->language);
427                 if (!res) {
428                         if (pause_restart_point) {
429                                 ast_seekstream(chan->stream, pause_restart_point, SEEK_SET);
430                                 pause_restart_point = 0;
431                         }
432                         else if (end) {
433                                 ast_seekstream(chan->stream, 0, SEEK_END);
434                                 end = NULL;
435                         };
436                         res = ast_waitstream_fr(chan, breaks, fwd, rev, skipms);
437                 }
438
439                 if (res < 1)
440                         break;
441
442                 /* We go at next loop if we got the restart char */
443                 if (restart && strchr(restart, res)) {
444                         if (option_debug)
445                                 ast_log(LOG_DEBUG, "we'll restart the stream here at next loop\n");
446                         pause_restart_point = 0;
447                         continue;
448                 }
449
450                 if (pause && strchr(pause, res)) {
451                         pause_restart_point = ast_tellstream(chan->stream);
452                         for (;;) {
453                                 ast_stopstream(chan);
454                                 res = ast_waitfordigit(chan, 1000);
455                                 if (!res)
456                                         continue;
457                                 else if (res == -1 || strchr(pause, res) || (stop && strchr(stop, res)))
458                                         break;
459                         }
460                         if (res == *pause) {
461                                 res = 0;
462                                 continue;
463                         }
464                 }
465
466                 if (res == -1)
467                         break;
468
469                 /* if we get one of our stop chars, return it to the calling function */
470                 if (stop && strchr(stop, res))
471                         break;
472         }
473
474         ast_stopstream(chan);
475
476         return res;
477 }
478
479 int ast_play_and_wait(struct ast_channel *chan, const char *fn)
480 {
481         int d;
482         d = ast_streamfile(chan, fn, chan->language);
483         if (d)
484                 return d;
485         d = ast_waitstream(chan, AST_DIGIT_ANY);
486         ast_stopstream(chan);
487         return d;
488 }
489
490 static int global_silence_threshold = 128;
491 static int global_maxsilence = 0;
492
493 /*! Optionally play a sound file or a beep, then record audio and video from the channel.
494  * @param chan Channel to playback to/record from.
495  * @param playfile Filename of sound to play before recording begins.
496  * @param recordfile Filename to record to.
497  * @param maxtime Maximum length of recording (in milliseconds).
498  * @param fmt Format(s) to record message in. Multiple formats may be specified by separating them with a '|'.
499  * @param duration Where to store actual length of the recorded message (in milliseconds).
500  * @param beep Whether to play a beep before starting to record.
501  * @param silencethreshold 
502  * @param maxsilence Length of silence that will end a recording (in milliseconds).
503  * @param path Optional filesystem path to unlock.
504  * @param prepend If true, prepend the recorded audio to an existing file.
505  * @param acceptdtmf DTMF digits that will end the recording.
506  * @param canceldtmf DTMF digits that will cancel the recording.
507  */
508
509 static int __ast_play_and_record(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int beep, int silencethreshold, int maxsilence, const char *path, int prepend, const char *acceptdtmf, const char *canceldtmf)
510 {
511         int d = 0;
512         char *fmts;
513         char comment[256];
514         int x, fmtcnt = 1, res = -1, outmsg = 0;
515         struct ast_filestream *others[MAX_OTHER_FORMATS];
516         char *sfmt[MAX_OTHER_FORMATS];
517         char *stringp = NULL;
518         time_t start, end;
519         struct ast_dsp *sildet = NULL;   /* silence detector dsp */
520         int totalsilence = 0;
521         int rfmt = 0;
522         struct ast_silence_generator *silgen = NULL;
523         char prependfile[80];
524
525         if (silencethreshold < 0)
526                 silencethreshold = global_silence_threshold;
527
528         if (maxsilence < 0)
529                 maxsilence = global_maxsilence;
530
531         /* barf if no pointer passed to store duration in */
532         if (duration == NULL) {
533                 ast_log(LOG_WARNING, "Error play_and_record called without duration pointer\n");
534                 return -1;
535         }
536
537         if (option_debug)
538                 ast_log(LOG_DEBUG,"play_and_record: %s, %s, '%s'\n", playfile ? playfile : "<None>", recordfile, fmt);
539         snprintf(comment, sizeof(comment), "Playing %s, Recording to: %s on %s\n", playfile ? playfile : "<None>", recordfile, chan->name);
540
541         if (playfile || beep) {
542                 if (!beep)
543                         d = ast_play_and_wait(chan, playfile);
544                 if (d > -1)
545                         d = ast_stream_and_wait(chan, "beep", "");
546                 if (d < 0)
547                         return -1;
548         }
549
550         if (prepend) {
551                 ast_copy_string(prependfile, recordfile, sizeof(prependfile));  
552                 strncat(prependfile, "-prepend", sizeof(prependfile) - strlen(prependfile) - 1);
553         }
554
555         fmts = ast_strdupa(fmt);
556
557         stringp = fmts;
558         strsep(&stringp, "|");
559         if (option_debug)
560                 ast_log(LOG_DEBUG, "Recording Formats: sfmts=%s\n", fmts);
561         sfmt[0] = ast_strdupa(fmts);
562
563         while ((fmt = strsep(&stringp, "|"))) {
564                 if (fmtcnt > MAX_OTHER_FORMATS - 1) {
565                         ast_log(LOG_WARNING, "Please increase MAX_OTHER_FORMATS in app.c\n");
566                         break;
567                 }
568                 sfmt[fmtcnt++] = ast_strdupa(fmt);
569         }
570
571         end = start = time(NULL);  /* pre-initialize end to be same as start in case we never get into loop */
572         for (x = 0; x < fmtcnt; x++) {
573                 others[x] = ast_writefile(prepend ? prependfile : recordfile, sfmt[x], comment, O_TRUNC, 0, AST_FILE_MODE);
574                 if (option_verbose > 2)
575                         ast_verbose(VERBOSE_PREFIX_3 "x=%d, open writing:  %s format: %s, %p\n", x, prepend ? prependfile : recordfile, sfmt[x], others[x]);
576
577                 if (!others[x])
578                         break;
579         }
580
581         if (path)
582                 ast_unlock_path(path);
583
584         if (maxsilence > 0) {
585                 sildet = ast_dsp_new(); /* Create the silence detector */
586                 if (!sildet) {
587                         ast_log(LOG_WARNING, "Unable to create silence detector :(\n");
588                         return -1;
589                 }
590                 ast_dsp_set_threshold(sildet, silencethreshold);
591                 rfmt = chan->readformat;
592                 res = ast_set_read_format(chan, AST_FORMAT_SLINEAR);
593                 if (res < 0) {
594                         ast_log(LOG_WARNING, "Unable to set to linear mode, giving up\n");
595                         ast_dsp_free(sildet);
596                         return -1;
597                 }
598         }
599
600         if (!prepend) {
601                 /* Request a video update */
602                 ast_indicate(chan, AST_CONTROL_VIDUPDATE);
603
604                 if (ast_opt_transmit_silence)
605                         silgen = ast_channel_start_silence_generator(chan);
606         }
607
608         if (x == fmtcnt) {
609                 /* Loop forever, writing the packets we read to the writer(s), until
610                    we read a digit or get a hangup */
611                 struct ast_frame *f;
612                 for (;;) {
613                         res = ast_waitfor(chan, 2000);
614                         if (!res) {
615                                 if (option_debug)
616                                         ast_log(LOG_DEBUG, "One waitfor failed, trying another\n");
617                                 /* Try one more time in case of masq */
618                                 res = ast_waitfor(chan, 2000);
619                                 if (!res) {
620                                         ast_log(LOG_WARNING, "No audio available on %s??\n", chan->name);
621                                         res = -1;
622                                 }
623                         }
624
625                         if (res < 0) {
626                                 f = NULL;
627                                 break;
628                         }
629                         f = ast_read(chan);
630                         if (!f)
631                                 break;
632                         if (f->frametype == AST_FRAME_VOICE) {
633                                 /* write each format */
634                                 for (x = 0; x < fmtcnt; x++) {
635                                         if (prepend && !others[x])
636                                                 break;
637                                         res = ast_writestream(others[x], f);
638                                 }
639
640                                 /* Silence Detection */
641                                 if (maxsilence > 0) {
642                                         int dspsilence = 0;
643                                         ast_dsp_silence(sildet, f, &dspsilence);
644                                         if (dspsilence)
645                                                 totalsilence = dspsilence;
646                                         else
647                                                 totalsilence = 0;
648
649                                         if (totalsilence > maxsilence) {
650                                                 /* Ended happily with silence */
651                                                 if (option_verbose > 2)
652                                                         ast_verbose( VERBOSE_PREFIX_3 "Recording automatically stopped after a silence of %d seconds\n", totalsilence/1000);
653                                                 res = 'S';
654                                                 outmsg = 2;
655                                                 break;
656                                         }
657                                 }
658                                 /* Exit on any error */
659                                 if (res) {
660                                         ast_log(LOG_WARNING, "Error writing frame\n");
661                                         break;
662                                 }
663                         } else if (f->frametype == AST_FRAME_VIDEO) {
664                                 /* Write only once */
665                                 ast_writestream(others[0], f);
666                         } else if (f->frametype == AST_FRAME_DTMF) {
667                                 if (prepend) {
668                                 /* stop recording with any digit */
669                                         if (option_verbose > 2) 
670                                                 ast_verbose(VERBOSE_PREFIX_3 "User ended message by pressing %c\n", f->subclass);
671                                         res = 't';
672                                         outmsg = 2;
673                                         break;
674                                 }
675                                 if (strchr(acceptdtmf, f->subclass)) {
676                                         if (option_verbose > 2)
677                                                 ast_verbose(VERBOSE_PREFIX_3 "User ended message by pressing %c\n", f->subclass);
678                                         res = f->subclass;
679                                         outmsg = 2;
680                                         break;
681                                 }
682                                 if (strchr(canceldtmf, f->subclass)) {
683                                         if (option_verbose > 2)
684                                                 ast_verbose(VERBOSE_PREFIX_3 "User cancelled message by pressing %c\n", f->subclass);
685                                         res = f->subclass;
686                                         outmsg = 0;
687                                         break;
688                                 }
689                         }
690                         if (maxtime) {
691                                 end = time(NULL);
692                                 if (maxtime < (end - start)) {
693                                         if (option_verbose > 2)
694                                                 ast_verbose(VERBOSE_PREFIX_3 "Took too long, cutting it short...\n");
695                                         res = 't';
696                                         outmsg = 2;
697                                         break;
698                                 }
699                         }
700                         ast_frfree(f);
701                 }
702                 if (!f) {
703                         if (option_verbose > 2)
704                                 ast_verbose(VERBOSE_PREFIX_3 "User hung up\n");
705                         res = -1;
706                         outmsg = 1;
707                 } else {
708                         ast_frfree(f);
709                 }
710                 if (end == start)
711                         end = time(NULL);
712         } else {
713                 ast_log(LOG_WARNING, "Error creating writestream '%s', format '%s'\n", recordfile, sfmt[x]);
714         }
715
716         if (!prepend) {
717                 if (silgen)
718                         ast_channel_stop_silence_generator(chan, silgen);
719         }
720         *duration = end - start;
721
722         if (!prepend) {
723                 for (x = 0; x < fmtcnt; x++) {
724                         if (!others[x])
725                                 break;
726                         if (res > 0)
727                                 ast_stream_rewind(others[x], totalsilence ? totalsilence - 200 : 200);
728                         ast_truncstream(others[x]);
729                         ast_closestream(others[x]);
730                 }
731         }
732
733         if (prepend && outmsg) {
734                 struct ast_filestream *realfiles[MAX_OTHER_FORMATS];
735                 struct ast_frame *fr;
736
737                 for (x = 0; x < fmtcnt; x++) {
738                         snprintf(comment, sizeof(comment), "Opening the real file %s.%s\n", recordfile, sfmt[x]);
739                         realfiles[x] = ast_readfile(recordfile, sfmt[x], comment, O_RDONLY, 0, 0);
740                         if (!others[x] || !realfiles[x])
741                                 break;
742                         ast_stream_rewind(others[x], totalsilence ? totalsilence - 200 : 200);
743                         ast_truncstream(others[x]);
744                         /* add the original file too */
745                         while ((fr = ast_readframe(realfiles[x]))) {
746                                 ast_writestream(others[x], fr);
747                                 ast_frfree(fr);
748                         }
749                         ast_closestream(others[x]);
750                         ast_closestream(realfiles[x]);
751                         ast_filerename(prependfile, recordfile, sfmt[x]);
752                         if (option_verbose > 3)
753                                 ast_verbose(VERBOSE_PREFIX_4 "Recording Format: sfmts=%s, prependfile %s, recordfile %s\n", sfmt[x], prependfile, recordfile);
754                         ast_filedelete(prependfile, sfmt[x]);
755                 }
756         }
757         if (rfmt && ast_set_read_format(chan, rfmt)) {
758                 ast_log(LOG_WARNING, "Unable to restore format %s to channel '%s'\n", ast_getformatname(rfmt), chan->name);
759         }
760         if (outmsg == 2) {
761                 ast_stream_and_wait(chan, "auth-thankyou", "");
762         }
763         if (sildet)
764                 ast_dsp_free(sildet);
765         return res;
766 }
767
768 static char default_acceptdtmf[] = "#";
769 static char default_canceldtmf[] = "";
770
771 int ast_play_and_record_full(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int silencethreshold, int maxsilence, const char *path, const char *acceptdtmf, const char *canceldtmf)
772 {
773         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, 0, silencethreshold, maxsilence, path, 0, S_OR(acceptdtmf, default_acceptdtmf), S_OR(canceldtmf, default_canceldtmf));
774 }
775
776 int ast_play_and_record(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int silencethreshold, int maxsilence, const char *path)
777 {
778         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, 0, silencethreshold, maxsilence, path, 0, default_acceptdtmf, default_canceldtmf);
779 }
780
781 int ast_play_and_prepend(struct ast_channel *chan, char *playfile, char *recordfile, int maxtime, char *fmt, int *duration, int beep, int silencethreshold, int maxsilence)
782 {
783         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, beep, silencethreshold, maxsilence, NULL, 1, default_acceptdtmf, default_canceldtmf);
784 }
785
786 /* Channel group core functions */
787
788 int ast_app_group_split_group(const char *data, char *group, int group_max, char *category, int category_max)
789 {
790         int res=0;
791         char tmp[256];
792         char *grp=NULL, *cat=NULL;
793
794         if (!ast_strlen_zero(data)) {
795                 ast_copy_string(tmp, data, sizeof(tmp));
796                 grp = tmp;
797                 cat = strchr(tmp, '@');
798                 if (cat) {
799                         *cat = '\0';
800                         cat++;
801                 }
802         }
803
804         if (!ast_strlen_zero(grp))
805                 ast_copy_string(group, grp, group_max);
806         else
807                 res = -1;
808
809         if (!ast_strlen_zero(cat))
810                 ast_copy_string(category, cat, category_max);
811
812         return res;
813 }
814
815 int ast_app_group_set_channel(struct ast_channel *chan, const char *data)
816 {
817         int res = 0;
818         char group[80] = "", category[80] = "";
819         struct ast_group_info *gi = NULL;
820         size_t len = 0;
821         
822         if (ast_app_group_split_group(data, group, sizeof(group), category, sizeof(category)))
823                 return -1;
824         
825         /* Calculate memory we will need if this is new */
826         len = sizeof(*gi) + strlen(group) + 1;
827         if (!ast_strlen_zero(category))
828                 len += strlen(category) + 1;
829         
830         AST_LIST_LOCK(&groups);
831         AST_LIST_TRAVERSE(&groups, gi, list) {
832                 if (gi->chan == chan && !strcasecmp(gi->group, group) && (ast_strlen_zero(category) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category))))
833                         break;
834         }
835         
836         if (!gi && (gi = calloc(1, len))) {
837                 gi->chan = chan;
838                 gi->group = (char *) gi + sizeof(*gi);
839                 strcpy(gi->group, group);
840                 if (!ast_strlen_zero(category)) {
841                         gi->category = (char *) gi + sizeof(*gi) + strlen(group) + 1;
842                         strcpy(gi->category, category);
843                 }
844                 AST_LIST_INSERT_TAIL(&groups, gi, list);
845         } else {
846                 res = -1;
847         }
848         
849         AST_LIST_UNLOCK(&groups);
850         
851         return res;
852 }
853
854 int ast_app_group_get_count(const char *group, const char *category)
855 {
856         struct ast_group_info *gi = NULL;
857         int count = 0;
858
859         if (ast_strlen_zero(group))
860                 return 0;
861         
862         AST_LIST_LOCK(&groups);
863         AST_LIST_TRAVERSE(&groups, gi, list) {
864                 if (!strcasecmp(gi->group, group) && (ast_strlen_zero(category) || !strcasecmp(gi->category, category)))
865                         count++;
866         }
867         AST_LIST_UNLOCK(&groups);
868
869         return count;
870 }
871
872 int ast_app_group_match_get_count(const char *groupmatch, const char *category)
873 {
874         struct ast_group_info *gi = NULL;
875         regex_t regexbuf;
876         int count = 0;
877
878         if (ast_strlen_zero(groupmatch))
879                 return 0;
880
881         /* if regex compilation fails, return zero matches */
882         if (regcomp(&regexbuf, groupmatch, REG_EXTENDED | REG_NOSUB))
883                 return 0;
884
885         AST_LIST_LOCK(&groups);
886         AST_LIST_TRAVERSE(&groups, gi, list) {
887                 if (!regexec(&regexbuf, gi->group, 0, NULL, 0) && (ast_strlen_zero(category) || !strcasecmp(gi->category, category)))
888                         count++;
889         }
890         AST_LIST_UNLOCK(&groups);
891
892         regfree(&regexbuf);
893
894         return count;
895 }
896
897 int ast_app_group_discard(struct ast_channel *chan)
898 {
899         struct ast_group_info *gi = NULL;
900         
901         AST_LIST_LOCK(&groups);
902         AST_LIST_TRAVERSE_SAFE_BEGIN(&groups, gi, list) {
903                 if (gi->chan == chan) {
904                         AST_LIST_REMOVE_CURRENT(&groups, list);
905                         free(gi);
906                 }
907         }
908         AST_LIST_TRAVERSE_SAFE_END
909         AST_LIST_UNLOCK(&groups);
910         
911         return 0;
912 }
913
914 int ast_app_group_list_lock(void)
915 {
916         return AST_LIST_LOCK(&groups);
917 }
918
919 struct ast_group_info *ast_app_group_list_head(void)
920 {
921         return AST_LIST_FIRST(&groups);
922 }
923
924 int ast_app_group_list_unlock(void)
925 {
926         return AST_LIST_UNLOCK(&groups);
927 }
928
929 unsigned int ast_app_separate_args(char *buf, char delim, char **array, int arraylen)
930 {
931         int argc;
932         char *scan;
933         int paren = 0, quote = 0;
934
935         if (!buf || !array || !arraylen)
936                 return 0;
937
938         memset(array, 0, arraylen * sizeof(*array));
939
940         scan = buf;
941
942         for (argc = 0; *scan && (argc < arraylen - 1); argc++) {
943                 array[argc] = scan;
944                 for (; *scan; scan++) {
945                         if (*scan == '(')
946                                 paren++;
947                         else if (*scan == ')') {
948                                 if (paren)
949                                         paren--;
950                         } else if (*scan == '"' && delim != '"') {
951                                 quote = quote ? 0 : 1;
952                                 /* Remove quote character from argument */
953                                 memmove(scan, scan + 1, strlen(scan));
954                                 scan--;
955                         } else if (*scan == '\\') {
956                                 /* Literal character, don't parse */
957                                 memmove(scan, scan + 1, strlen(scan));
958                         } else if ((*scan == delim) && !paren && !quote) {
959                                 *scan++ = '\0';
960                                 break;
961                         }
962                 }
963         }
964
965         if (*scan)
966                 array[argc++] = scan;
967
968         return argc;
969 }
970
971 enum AST_LOCK_RESULT ast_lock_path(const char *path)
972 {
973         char *s;
974         char *fs;
975         int res;
976         int fd;
977         int lp = strlen(path);
978         time_t start;
979
980         if (!(s = alloca(lp + 10)) || !(fs = alloca(lp + 20))) {
981                 ast_log(LOG_WARNING, "Out of memory!\n");
982                 return AST_LOCK_FAILURE;
983         }
984
985         snprintf(fs, strlen(path) + 19, "%s/.lock-%08lx", path, ast_random());
986         fd = open(fs, O_WRONLY | O_CREAT | O_EXCL, AST_FILE_MODE);
987         if (fd < 0) {
988                 ast_log(LOG_ERROR, "Unable to create lock file '%s': %s\n", path, strerror(errno));
989                 return AST_LOCK_PATH_NOT_FOUND;
990         }
991         close(fd);
992
993         snprintf(s, strlen(path) + 9, "%s/.lock", path);
994         start = time(NULL);
995         while (((res = link(fs, s)) < 0) && (errno == EEXIST) && (time(NULL) - start < 5))
996                 usleep(1);
997
998         unlink(fs);
999
1000         if (res) {
1001                 ast_log(LOG_WARNING, "Failed to lock path '%s': %s\n", path, strerror(errno));
1002                 return AST_LOCK_TIMEOUT;
1003         } else {
1004                 if (option_debug)
1005                         ast_log(LOG_DEBUG, "Locked path '%s'\n", path);
1006                 return AST_LOCK_SUCCESS;
1007         }
1008 }
1009
1010 int ast_unlock_path(const char *path)
1011 {
1012         char *s;
1013         int res;
1014
1015         if (!(s = alloca(strlen(path) + 10))) {
1016                 ast_log(LOG_WARNING, "Out of memory!\n");
1017                 return -1;
1018         }
1019
1020         snprintf(s, strlen(path) + 9, "%s/%s", path, ".lock");
1021
1022         if ((res = unlink(s)))
1023                 ast_log(LOG_ERROR, "Could not unlock path '%s': %s\n", path, strerror(errno));
1024         else {
1025                 if (option_debug)
1026                         ast_log(LOG_DEBUG, "Unlocked path '%s'\n", path);
1027         }
1028
1029         return res;
1030 }
1031
1032 int ast_record_review(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, const char *path) 
1033 {
1034         int silencethreshold = 128; 
1035         int maxsilence=0;
1036         int res = 0;
1037         int cmd = 0;
1038         int max_attempts = 3;
1039         int attempts = 0;
1040         int recorded = 0;
1041         int message_exists = 0;
1042         /* Note that urgent and private are for flagging messages as such in the future */
1043
1044         /* barf if no pointer passed to store duration in */
1045         if (duration == NULL) {
1046                 ast_log(LOG_WARNING, "Error ast_record_review called without duration pointer\n");
1047                 return -1;
1048         }
1049
1050         cmd = '3';       /* Want to start by recording */
1051
1052         while ((cmd >= 0) && (cmd != 't')) {
1053                 switch (cmd) {
1054                 case '1':
1055                         if (!message_exists) {
1056                                 /* In this case, 1 is to record a message */
1057                                 cmd = '3';
1058                                 break;
1059                         } else {
1060                                 ast_stream_and_wait(chan, "vm-msgsaved", "");
1061                                 cmd = 't';
1062                                 return res;
1063                         }
1064                 case '2':
1065                         /* Review */
1066                         ast_verbose(VERBOSE_PREFIX_3 "Reviewing the recording\n");
1067                         cmd = ast_stream_and_wait(chan, recordfile, AST_DIGIT_ANY);
1068                         break;
1069                 case '3':
1070                         message_exists = 0;
1071                         /* Record */
1072                         if (recorded == 1)
1073                                 ast_verbose(VERBOSE_PREFIX_3 "Re-recording\n");
1074                         else    
1075                                 ast_verbose(VERBOSE_PREFIX_3 "Recording\n");
1076                         recorded = 1;
1077                         cmd = ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, silencethreshold, maxsilence, path);
1078                         if (cmd == -1) {
1079                         /* User has hung up, no options to give */
1080                                 return cmd;
1081                         }
1082                         if (cmd == '0') {
1083                                 break;
1084                         } else if (cmd == '*') {
1085                                 break;
1086                         } 
1087                         else {
1088                                 /* If all is well, a message exists */
1089                                 message_exists = 1;
1090                                 cmd = 0;
1091                         }
1092                         break;
1093                 case '4':
1094                 case '5':
1095                 case '6':
1096                 case '7':
1097                 case '8':
1098                 case '9':
1099                 case '*':
1100                 case '#':
1101                         cmd = ast_play_and_wait(chan, "vm-sorry");
1102                         break;
1103                 default:
1104                         if (message_exists) {
1105                                 cmd = ast_play_and_wait(chan, "vm-review");
1106                         }
1107                         else {
1108                                 cmd = ast_play_and_wait(chan, "vm-torerecord");
1109                                 if (!cmd)
1110                                         cmd = ast_waitfordigit(chan, 600);
1111                         }
1112                         
1113                         if (!cmd)
1114                                 cmd = ast_waitfordigit(chan, 6000);
1115                         if (!cmd) {
1116                                 attempts++;
1117                         }
1118                         if (attempts > max_attempts) {
1119                                 cmd = 't';
1120                         }
1121                 }
1122         }
1123         if (cmd == 't')
1124                 cmd = 0;
1125         return cmd;
1126 }
1127
1128 #define RES_UPONE (1 << 16)
1129 #define RES_EXIT  (1 << 17)
1130 #define RES_REPEAT (1 << 18)
1131 #define RES_RESTART ((1 << 19) | RES_REPEAT)
1132
1133 static int ast_ivr_menu_run_internal(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata);
1134
1135 static int ivr_dispatch(struct ast_channel *chan, struct ast_ivr_option *option, char *exten, void *cbdata)
1136 {
1137         int res;
1138         int (*ivr_func)(struct ast_channel *, void *);
1139         char *c;
1140         char *n;
1141         
1142         switch (option->action) {
1143         case AST_ACTION_UPONE:
1144                 return RES_UPONE;
1145         case AST_ACTION_EXIT:
1146                 return RES_EXIT | (((unsigned long)(option->adata)) & 0xffff);
1147         case AST_ACTION_REPEAT:
1148                 return RES_REPEAT | (((unsigned long)(option->adata)) & 0xffff);
1149         case AST_ACTION_RESTART:
1150                 return RES_RESTART ;
1151         case AST_ACTION_NOOP:
1152                 return 0;
1153         case AST_ACTION_BACKGROUND:
1154                 res = ast_stream_and_wait(chan, (char *)option->adata, AST_DIGIT_ANY);
1155                 if (res < 0) {
1156                         ast_log(LOG_NOTICE, "Unable to find file '%s'!\n", (char *)option->adata);
1157                         res = 0;
1158                 }
1159                 return res;
1160         case AST_ACTION_PLAYBACK:
1161                 res = ast_stream_and_wait(chan, (char *)option->adata, "");
1162                 if (res < 0) {
1163                         ast_log(LOG_NOTICE, "Unable to find file '%s'!\n", (char *)option->adata);
1164                         res = 0;
1165                 }
1166                 return res;
1167         case AST_ACTION_MENU:
1168                 res = ast_ivr_menu_run_internal(chan, (struct ast_ivr_menu *)option->adata, cbdata);
1169                 /* Do not pass entry errors back up, treaat ast though ti was an "UPONE" */
1170                 if (res == -2)
1171                         res = 0;
1172                 return res;
1173         case AST_ACTION_WAITOPTION:
1174                 res = ast_waitfordigit(chan, 1000 * (chan->pbx ? chan->pbx->rtimeout : 10));
1175                 if (!res)
1176                         return 't';
1177                 return res;
1178         case AST_ACTION_CALLBACK:
1179                 ivr_func = option->adata;
1180                 res = ivr_func(chan, cbdata);
1181                 return res;
1182         case AST_ACTION_TRANSFER:
1183                 res = ast_parseable_goto(chan, option->adata);
1184                 return 0;
1185         case AST_ACTION_PLAYLIST:
1186         case AST_ACTION_BACKLIST:
1187                 res = 0;
1188                 c = ast_strdupa(option->adata);
1189                 while ((n = strsep(&c, ";"))) {
1190                         if ((res = ast_stream_and_wait(chan, n,
1191                                         (option->action == AST_ACTION_BACKLIST) ? AST_DIGIT_ANY : "")))
1192                                 break;
1193                 }
1194                 ast_stopstream(chan);
1195                 return res;
1196         default:
1197                 ast_log(LOG_NOTICE, "Unknown dispatch function %d, ignoring!\n", option->action);
1198                 return 0;
1199         };
1200         return -1;
1201 }
1202
1203 static int option_exists(struct ast_ivr_menu *menu, char *option)
1204 {
1205         int x;
1206         for (x = 0; menu->options[x].option; x++)
1207                 if (!strcasecmp(menu->options[x].option, option))
1208                         return x;
1209         return -1;
1210 }
1211
1212 static int option_matchmore(struct ast_ivr_menu *menu, char *option)
1213 {
1214         int x;
1215         for (x = 0; menu->options[x].option; x++)
1216                 if ((!strncasecmp(menu->options[x].option, option, strlen(option))) && 
1217                                 (menu->options[x].option[strlen(option)]))
1218                         return x;
1219         return -1;
1220 }
1221
1222 static int read_newoption(struct ast_channel *chan, struct ast_ivr_menu *menu, char *exten, int maxexten)
1223 {
1224         int res=0;
1225         int ms;
1226         while (option_matchmore(menu, exten)) {
1227                 ms = chan->pbx ? chan->pbx->dtimeout : 5000;
1228                 if (strlen(exten) >= maxexten - 1) 
1229                         break;
1230                 res = ast_waitfordigit(chan, ms);
1231                 if (res < 1)
1232                         break;
1233                 exten[strlen(exten) + 1] = '\0';
1234                 exten[strlen(exten)] = res;
1235         }
1236         return res > 0 ? 0 : res;
1237 }
1238
1239 static int ast_ivr_menu_run_internal(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata)
1240 {
1241         /* Execute an IVR menu structure */
1242         int res=0;
1243         int pos = 0;
1244         int retries = 0;
1245         char exten[AST_MAX_EXTENSION] = "s";
1246         if (option_exists(menu, "s") < 0) {
1247                 strcpy(exten, "g");
1248                 if (option_exists(menu, "g") < 0) {
1249                         ast_log(LOG_WARNING, "No 's' nor 'g' extension in menu '%s'!\n", menu->title);
1250                         return -1;
1251                 }
1252         }
1253         while (!res) {
1254                 while (menu->options[pos].option) {
1255                         if (!strcasecmp(menu->options[pos].option, exten)) {
1256                                 res = ivr_dispatch(chan, menu->options + pos, exten, cbdata);
1257                                 if (option_debug)
1258                                         ast_log(LOG_DEBUG, "IVR Dispatch of '%s' (pos %d) yields %d\n", exten, pos, res);
1259                                 if (res < 0)
1260                                         break;
1261                                 else if (res & RES_UPONE)
1262                                         return 0;
1263                                 else if (res & RES_EXIT)
1264                                         return res;
1265                                 else if (res & RES_REPEAT) {
1266                                         int maxretries = res & 0xffff;
1267                                         if ((res & RES_RESTART) == RES_RESTART) {
1268                                                 retries = 0;
1269                                         } else
1270                                                 retries++;
1271                                         if (!maxretries)
1272                                                 maxretries = 3;
1273                                         if ((maxretries > 0) && (retries >= maxretries)) {
1274                                                 if (option_debug)
1275                                                         ast_log(LOG_DEBUG, "Max retries %d exceeded\n", maxretries);
1276                                                 return -2;
1277                                         } else {
1278                                                 if (option_exists(menu, "g") > -1) 
1279                                                         strcpy(exten, "g");
1280                                                 else if (option_exists(menu, "s") > -1)
1281                                                         strcpy(exten, "s");
1282                                         }
1283                                         pos = 0;
1284                                         continue;
1285                                 } else if (res && strchr(AST_DIGIT_ANY, res)) {
1286                                         if (option_debug)
1287                                                 ast_log(LOG_DEBUG, "Got start of extension, %c\n", res);
1288                                         exten[1] = '\0';
1289                                         exten[0] = res;
1290                                         if ((res = read_newoption(chan, menu, exten, sizeof(exten))))
1291                                                 break;
1292                                         if (option_exists(menu, exten) < 0) {
1293                                                 if (option_exists(menu, "i")) {
1294                                                         if (option_debug)
1295                                                                 ast_log(LOG_DEBUG, "Invalid extension entered, going to 'i'!\n");
1296                                                         strcpy(exten, "i");
1297                                                         pos = 0;
1298                                                         continue;
1299                                                 } else {
1300                                                         if (option_debug)
1301                                                                 ast_log(LOG_DEBUG, "Aborting on invalid entry, with no 'i' option!\n");
1302                                                         res = -2;
1303                                                         break;
1304                                                 }
1305                                         } else {
1306                                                 if (option_debug)
1307                                                         ast_log(LOG_DEBUG, "New existing extension: %s\n", exten);
1308                                                 pos = 0;
1309                                                 continue;
1310                                         }
1311                                 }
1312                         }
1313                         pos++;
1314                 }
1315                 if (option_debug)
1316                         ast_log(LOG_DEBUG, "Stopping option '%s', res is %d\n", exten, res);
1317                 pos = 0;
1318                 if (!strcasecmp(exten, "s"))
1319                         strcpy(exten, "g");
1320                 else
1321                         break;
1322         }
1323         return res;
1324 }
1325
1326 int ast_ivr_menu_run(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata)
1327 {
1328         int res = ast_ivr_menu_run_internal(chan, menu, cbdata);
1329         /* Hide internal coding */
1330         return res > 0 ? 0 : res;
1331 }
1332         
1333 char *ast_read_textfile(const char *filename)
1334 {
1335         int fd;
1336         char *output = NULL;
1337         struct stat filesize;
1338         int count = 0;
1339         int res;
1340         if (stat(filename, &filesize) == -1) {
1341                 ast_log(LOG_WARNING, "Error can't stat %s\n", filename);
1342                 return NULL;
1343         }
1344         count = filesize.st_size + 1;
1345         fd = open(filename, O_RDONLY);
1346         if (fd < 0) {
1347                 ast_log(LOG_WARNING, "Cannot open file '%s' for reading: %s\n", filename, strerror(errno));
1348                 return NULL;
1349         }
1350         if ((output = ast_malloc(count))) {
1351                 res = read(fd, output, count - 1);
1352                 if (res == count - 1) {
1353                         output[res] = '\0';
1354                 } else {
1355                         ast_log(LOG_WARNING, "Short read of %s (%d of %d): %s\n", filename, res, count - 1, strerror(errno));
1356                         free(output);
1357                         output = NULL;
1358                 }
1359         }
1360         close(fd);
1361         return output;
1362 }
1363
1364 int ast_app_parse_options(const struct ast_app_option *options, struct ast_flags *flags, char **args, char *optstr)
1365 {
1366         char *s;
1367         int curarg;
1368         unsigned int argloc;
1369         char *arg;
1370         int res = 0;
1371
1372         ast_clear_flag(flags, AST_FLAGS_ALL);
1373
1374         if (!optstr)
1375                 return 0;
1376
1377         s = optstr;
1378         while (*s) {
1379                 curarg = *s++ & 0x7f;   /* the array (in app.h) has 128 entries */
1380                 ast_set_flag(flags, options[curarg].flag);
1381                 argloc = options[curarg].arg_index;
1382                 if (*s == '(') {
1383                         /* Has argument */
1384                         arg = ++s;
1385                         if ((s = strchr(s, ')'))) {
1386                                 if (argloc)
1387                                         args[argloc - 1] = arg;
1388                                 *s++ = '\0';
1389                         } else {
1390                                 ast_log(LOG_WARNING, "Missing closing parenthesis for argument '%c' in string '%s'\n", curarg, arg);
1391                                 res = -1;
1392                                 break;
1393                         }
1394                 } else if (argloc) {
1395                         args[argloc - 1] = NULL;
1396                 }
1397         }
1398
1399         return res;
1400 }
1401