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