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