eacefabd06ca52040c23107d38b4fbbbdcf8aa1a
[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 #ifdef HAVE_SYS_STAT_H
31 #include <sys/stat.h>
32 #endif
33 #include <regex.h>
34 #include <sys/file.h> /* added this to allow to compile, sorry! */
35 #include <signal.h>
36 #include <sys/time.h>       /* for getrlimit(2) */
37 #include <sys/resource.h>   /* for getrlimit(2) */
38 #include <stdlib.h>         /* for closefrom(3) */
39 #ifdef HAVE_CAP
40 #include <sys/capability.h>
41 #endif /* HAVE_CAP */
42
43 #include "asterisk/paths.h"     /* use ast_config_AST_DATA_DIR */
44 #include "asterisk/channel.h"
45 #include "asterisk/pbx.h"
46 #include "asterisk/file.h"
47 #include "asterisk/app.h"
48 #include "asterisk/dsp.h"
49 #include "asterisk/utils.h"
50 #include "asterisk/lock.h"
51 #include "asterisk/indications.h"
52 #include "asterisk/linkedlists.h"
53 #include "asterisk/threadstorage.h"
54
55 AST_THREADSTORAGE_PUBLIC(ast_str_thread_global_buf);
56
57
58 #define MAX_OTHER_FORMATS 10
59
60 static AST_RWLIST_HEAD_STATIC(groups, ast_group_info);
61
62 /*!
63  * \brief This function presents a dialtone and reads an extension into 'collect'
64  * which must be a pointer to a **pre-initialized** array of char having a
65  * size of 'size' suitable for writing to.  It will collect no more than the smaller
66  * of 'maxlen' or 'size' minus the original strlen() of collect digits.
67  * \param chan struct.
68  * \param context
69  * \param collect
70  * \param size
71  * \param maxlen
72  * \param timeout timeout in seconds
73  *
74  * \return 0 if extension does not exist, 1 if extension exists
75 */
76 int ast_app_dtget(struct ast_channel *chan, const char *context, char *collect, size_t size, int maxlen, int timeout)
77 {
78         struct ast_tone_zone_sound *ts;
79         int res = 0, x = 0;
80
81         if (maxlen > size) {
82                 maxlen = size;
83         }
84
85         if (!timeout && chan->pbx) {
86                 timeout = chan->pbx->dtimeoutms / 1000.0;
87         } else if (!timeout) {
88                 timeout = 5;
89         }
90
91         if ((ts = ast_get_indication_tone(chan->zone, "dial"))) {
92                 res = ast_playtones_start(chan, 0, ts->data, 0);
93                 ts = ast_tone_zone_sound_unref(ts);
94         } else {
95                 ast_log(LOG_NOTICE, "Huh....? no dial for indications?\n");
96         }
97
98         for (x = strlen(collect); x < maxlen; ) {
99                 res = ast_waitfordigit(chan, timeout);
100                 if (!ast_ignore_pattern(context, collect)) {
101                         ast_playtones_stop(chan);
102                 }
103                 if (res < 1) {
104                         break;
105                 }
106                 if (res == '#') {
107                         break;
108                 }
109                 collect[x++] = res;
110                 if (!ast_matchmore_extension(chan, context, collect, 1, chan->cid.cid_num)) {
111                         break;
112                 }
113         }
114
115         if (res >= 0) {
116                 res = ast_exists_extension(chan, context, collect, 1, chan->cid.cid_num) ? 1 : 0;
117         }
118
119         return res;
120 }
121
122 /*!
123  * \brief ast_app_getdata
124  * \param c The channel to read from
125  * \param prompt The file to stream to the channel
126  * \param s The string to read in to.  Must be at least the size of your length
127  * \param maxlen How many digits to read (maximum)
128  * \param timeout set timeout to 0 for "standard" timeouts. Set timeout to -1 for 
129  *      "ludicrous time" (essentially never times out) */
130 enum ast_getdata_result ast_app_getdata(struct ast_channel *c, const char *prompt, char *s, int maxlen, int timeout)
131 {
132         int res = 0, to, fto;
133         char *front, *filename;
134
135         /* XXX Merge with full version? XXX */
136
137         if (maxlen)
138                 s[0] = '\0';
139
140         if (!prompt)
141                 prompt = "";
142
143         filename = ast_strdupa(prompt);
144         while ((front = strsep(&filename, "&"))) {
145                 if (!ast_strlen_zero(front)) {
146                         res = ast_streamfile(c, front, c->language);
147                         if (res)
148                                 continue;
149                 }
150                 if (ast_strlen_zero(filename)) {
151                         /* set timeouts for the last prompt */
152                         fto = c->pbx ? c->pbx->rtimeoutms : 6000;
153                         to = c->pbx ? c->pbx->dtimeoutms : 2000;
154
155                         if (timeout > 0) {
156                                 fto = to = timeout;
157                         }
158                         if (timeout < 0) {
159                                 fto = to = 1000000000;
160                         }
161                 } else {
162                         /* there is more than one prompt, so
163                          * get rid of the long timeout between
164                          * prompts, and make it 50ms */
165                         fto = 50;
166                         to = c->pbx ? c->pbx->dtimeoutms : 2000;
167                 }
168                 res = ast_readstring(c, s, maxlen, to, fto, "#");
169                 if (res == AST_GETDATA_EMPTY_END_TERMINATED) {
170                         return res;
171                 }
172                 if (!ast_strlen_zero(s)) {
173                         return res;
174                 }
175         }
176
177         return res;
178 }
179
180 /* The lock type used by ast_lock_path() / ast_unlock_path() */
181 static enum AST_LOCK_TYPE ast_lock_type = AST_LOCK_TYPE_LOCKFILE;
182
183 int ast_app_getdata_full(struct ast_channel *c, const char *prompt, char *s, int maxlen, int timeout, int audiofd, int ctrlfd)
184 {
185         int res, to = 2000, fto = 6000;
186
187         if (!ast_strlen_zero(prompt)) {
188                 res = ast_streamfile(c, prompt, c->language);
189                 if (res < 0) {
190                         return res;
191                 }
192         }
193
194         if (timeout > 0) {
195                 fto = to = timeout;
196         }
197         if (timeout < 0) {
198                 fto = to = 1000000000;
199         }
200
201         res = ast_readstring_full(c, s, maxlen, to, fto, "#", audiofd, ctrlfd);
202
203         return res;
204 }
205
206 int ast_app_run_macro(struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const char * const macro_name, const char * const macro_args)
207 {
208         struct ast_app *macro_app;
209         int res;
210         char buf[1024];
211
212         macro_app = pbx_findapp("Macro");
213         if (!macro_app) {
214                 ast_log(LOG_WARNING, "Cannot run macro '%s' because the 'Macro' application in not available\n", macro_name);
215                 return -1;
216         }
217         snprintf(buf, sizeof(buf), "%s%s%s", macro_name, ast_strlen_zero(macro_args) ? "" : ",", S_OR(macro_args, ""));
218         if (autoservice_chan) {
219                 ast_autoservice_start(autoservice_chan);
220         }
221         res = pbx_exec(macro_chan, macro_app, buf);
222         if (autoservice_chan) {
223                 ast_autoservice_stop(autoservice_chan);
224         }
225         return res;
226 }
227
228 static int (*ast_has_voicemail_func)(const char *mailbox, const char *folder) = NULL;
229 static int (*ast_inboxcount_func)(const char *mailbox, int *newmsgs, int *oldmsgs) = NULL;
230 static int (*ast_inboxcount2_func)(const char *mailbox, int *urgentmsgs, int *newmsgs, int *oldmsgs) = NULL;
231 static int (*ast_sayname_func)(struct ast_channel *chan, const char *mailbox, const char *context) = NULL;
232 static int (*ast_messagecount_func)(const char *context, const char *mailbox, const char *folder) = NULL;
233
234 void ast_install_vm_functions(int (*has_voicemail_func)(const char *mailbox, const char *folder),
235                               int (*inboxcount_func)(const char *mailbox, int *newmsgs, int *oldmsgs),
236                               int (*inboxcount2_func)(const char *mailbox, int *urgentmsgs, int *newmsgs, int *oldmsgs),
237                               int (*messagecount_func)(const char *context, const char *mailbox, const char *folder),
238                               int (*sayname_func)(struct ast_channel *chan, const char *mailbox, const char *context))
239 {
240         ast_has_voicemail_func = has_voicemail_func;
241         ast_inboxcount_func = inboxcount_func;
242         ast_inboxcount2_func = inboxcount2_func;
243         ast_messagecount_func = messagecount_func;
244         ast_sayname_func = sayname_func;
245 }
246
247 void ast_uninstall_vm_functions(void)
248 {
249         ast_has_voicemail_func = NULL;
250         ast_inboxcount_func = NULL;
251         ast_inboxcount2_func = NULL;
252         ast_messagecount_func = NULL;
253         ast_sayname_func = NULL;
254 }
255
256 int ast_app_has_voicemail(const char *mailbox, const char *folder)
257 {
258         static int warned = 0;
259         if (ast_has_voicemail_func) {
260                 return ast_has_voicemail_func(mailbox, folder);
261         }
262
263         if (warned++ % 10 == 0) {
264                 ast_verb(3, "Message check requested for mailbox %s/folder %s but voicemail not loaded.\n", mailbox, folder ? folder : "INBOX");
265         }
266         return 0;
267 }
268
269
270 int ast_app_inboxcount(const char *mailbox, int *newmsgs, int *oldmsgs)
271 {
272         static int warned = 0;
273         if (newmsgs) {
274                 *newmsgs = 0;
275         }
276         if (oldmsgs) {
277                 *oldmsgs = 0;
278         }
279         if (ast_inboxcount_func) {
280                 return ast_inboxcount_func(mailbox, newmsgs, oldmsgs);
281         }
282
283         if (warned++ % 10 == 0) {
284                 ast_verb(3, "Message count requested for mailbox %s but voicemail not loaded.\n", mailbox);
285         }
286
287         return 0;
288 }
289
290 int ast_app_inboxcount2(const char *mailbox, int *urgentmsgs, int *newmsgs, int *oldmsgs)
291 {
292         static int warned = 0;
293         if (newmsgs) {
294                 *newmsgs = 0;
295         }
296         if (oldmsgs) {
297                 *oldmsgs = 0;
298         }
299         if (urgentmsgs) {
300                 *urgentmsgs = 0;
301         }
302         if (ast_inboxcount_func) {
303                 return ast_inboxcount2_func(mailbox, urgentmsgs, newmsgs, oldmsgs);
304         }
305
306         if (warned++ % 10 == 0) {
307                 ast_verb(3, "Message count requested for mailbox %s but voicemail not loaded.\n", mailbox);
308         }
309
310         return 0;
311 }
312
313 int ast_app_sayname(struct ast_channel *chan, const char *mailbox, const char *context)
314 {
315         if (ast_sayname_func) {
316                 return ast_sayname_func(chan, mailbox, context);
317         }
318         return -1;
319 }
320
321 int ast_app_messagecount(const char *context, const char *mailbox, const char *folder)
322 {
323         static int warned = 0;
324         if (ast_messagecount_func) {
325                 return ast_messagecount_func(context, mailbox, folder);
326         }
327
328         if (!warned) {
329                 warned++;
330                 ast_verb(3, "Message count requested for mailbox %s@%s/%s but voicemail not loaded.\n", mailbox, context, folder);
331         }
332
333         return 0;
334 }
335
336 int ast_dtmf_stream(struct ast_channel *chan, struct ast_channel *peer, const char *digits, int between, unsigned int duration) 
337 {
338         const char *ptr;
339         int res = 0;
340         struct ast_silence_generator *silgen = NULL;
341
342         if (!between) {
343                 between = 100;
344         }
345
346         if (peer) {
347                 res = ast_autoservice_start(peer);
348         }
349
350         if (!res) {
351                 res = ast_waitfor(chan, 100);
352         }
353
354         /* ast_waitfor will return the number of remaining ms on success */
355         if (res < 0) {
356                 if (peer) {
357                         ast_autoservice_stop(peer);
358                 }
359                 return res;
360         }
361
362         if (ast_opt_transmit_silence) {
363                 silgen = ast_channel_start_silence_generator(chan);
364         }
365
366         for (ptr = digits; *ptr; ptr++) {
367                 if (*ptr == 'w') {
368                         /* 'w' -- wait half a second */
369                         if ((res = ast_safe_sleep(chan, 500))) {
370                                 break;
371                         }
372                 } else if (strchr("0123456789*#abcdfABCDF", *ptr)) {
373                         /* Character represents valid DTMF */
374                         if (*ptr == 'f' || *ptr == 'F') {
375                                 /* ignore return values if not supported by channel */
376                                 ast_indicate(chan, AST_CONTROL_FLASH);
377                         } else {
378                                 ast_senddigit(chan, *ptr, duration);
379                         }
380                         /* pause between digits */
381                         if ((res = ast_safe_sleep(chan, between))) {
382                                 break;
383                         }
384                 } else {
385                         ast_log(LOG_WARNING, "Illegal DTMF character '%c' in string. (0-9*#aAbBcCdD allowed)\n", *ptr);
386                 }
387         }
388
389         if (peer) {
390                 /* Stop autoservice on the peer channel, but don't overwrite any error condition
391                    that has occurred previously while acting on the primary channel */
392                 if (ast_autoservice_stop(peer) && !res) {
393                         res = -1;
394                 }
395         }
396
397         if (silgen) {
398                 ast_channel_stop_silence_generator(chan, silgen);
399         }
400
401         return res;
402 }
403
404 struct linear_state {
405         int fd;
406         int autoclose;
407         int allowoverride;
408         int origwfmt;
409 };
410
411 static void linear_release(struct ast_channel *chan, void *params)
412 {
413         struct linear_state *ls = params;
414
415         if (ls->origwfmt && ast_set_write_format(chan, ls->origwfmt)) {
416                 ast_log(LOG_WARNING, "Unable to restore channel '%s' to format '%d'\n", chan->name, ls->origwfmt);
417         }
418
419         if (ls->autoclose) {
420                 close(ls->fd);
421         }
422
423         ast_free(params);
424 }
425
426 static int linear_generator(struct ast_channel *chan, void *data, int len, int samples)
427 {
428         short buf[2048 + AST_FRIENDLY_OFFSET / 2];
429         struct linear_state *ls = data;
430         struct ast_frame f = {
431                 .frametype = AST_FRAME_VOICE,
432                 .subclass = AST_FORMAT_SLINEAR,
433                 .data.ptr = buf + AST_FRIENDLY_OFFSET / 2,
434                 .offset = AST_FRIENDLY_OFFSET,
435         };
436         int res;
437
438         len = samples * 2;
439         if (len > sizeof(buf) - AST_FRIENDLY_OFFSET) {
440                 ast_log(LOG_WARNING, "Can't generate %d bytes of data!\n" , len);
441                 len = sizeof(buf) - AST_FRIENDLY_OFFSET;
442         }
443         res = read(ls->fd, buf + AST_FRIENDLY_OFFSET/2, len);
444         if (res > 0) {
445                 f.datalen = res;
446                 f.samples = res / 2;
447                 ast_write(chan, &f);
448                 if (res == len) {
449                         return 0;
450                 }
451         }
452         return -1;
453 }
454
455 static void *linear_alloc(struct ast_channel *chan, void *params)
456 {
457         struct linear_state *ls = params;
458
459         if (!params) {
460                 return NULL;
461         }
462
463         /* In this case, params is already malloc'd */
464         if (ls->allowoverride) {
465                 ast_set_flag(chan, AST_FLAG_WRITE_INT);
466         } else {
467                 ast_clear_flag(chan, AST_FLAG_WRITE_INT);
468         }
469
470         ls->origwfmt = chan->writeformat;
471
472         if (ast_set_write_format(chan, AST_FORMAT_SLINEAR)) {
473                 ast_log(LOG_WARNING, "Unable to set '%s' to linear format (write)\n", chan->name);
474                 ast_free(ls);
475                 ls = params = NULL;
476         }
477
478         return params;
479 }
480
481 static struct ast_generator linearstream =
482 {
483         alloc: linear_alloc,
484         release: linear_release,
485         generate: linear_generator,
486 };
487
488 int ast_linear_stream(struct ast_channel *chan, const char *filename, int fd, int allowoverride)
489 {
490         struct linear_state *lin;
491         char tmpf[256];
492         int res = -1;
493         int autoclose = 0;
494         if (fd < 0) {
495                 if (ast_strlen_zero(filename)) {
496                         return -1;
497                 }
498                 autoclose = 1;
499                 if (filename[0] == '/') {
500                         ast_copy_string(tmpf, filename, sizeof(tmpf));
501                 } else {
502                         snprintf(tmpf, sizeof(tmpf), "%s/%s/%s", ast_config_AST_DATA_DIR, "sounds", filename);
503                 }
504                 if ((fd = open(tmpf, O_RDONLY)) < 0) {
505                         ast_log(LOG_WARNING, "Unable to open file '%s': %s\n", tmpf, strerror(errno));
506                         return -1;
507                 }
508         }
509         if ((lin = ast_calloc(1, sizeof(*lin)))) {
510                 lin->fd = fd;
511                 lin->allowoverride = allowoverride;
512                 lin->autoclose = autoclose;
513                 res = ast_activate_generator(chan, &linearstream, lin);
514         }
515         return res;
516 }
517
518 int ast_control_streamfile(struct ast_channel *chan, const char *file,
519                            const char *fwd, const char *rev,
520                            const char *stop, const char *suspend,
521                            const char *restart, int skipms, long *offsetms)
522 {
523         char *breaks = NULL;
524         char *end = NULL;
525         int blen = 2;
526         int res;
527         long pause_restart_point = 0;
528         long offset = 0;
529
530         if (offsetms) {
531                 offset = *offsetms * 8; /* XXX Assumes 8kHz */
532         }
533
534         if (stop) {
535                 blen += strlen(stop);
536         }
537         if (suspend) {
538                 blen += strlen(suspend);
539         }
540         if (restart) {
541                 blen += strlen(restart);
542         }
543
544         if (blen > 2) {
545                 breaks = alloca(blen + 1);
546                 breaks[0] = '\0';
547                 if (stop) {
548                         strcat(breaks, stop);
549                 }
550                 if (suspend) {
551                         strcat(breaks, suspend);
552                 }
553                 if (restart) {
554                         strcat(breaks, restart);
555                 }
556         }
557         if (chan->_state != AST_STATE_UP) {
558                 res = ast_answer(chan);
559         }
560
561         if (file) {
562                 if ((end = strchr(file, ':'))) {
563                         if (!strcasecmp(end, ":end")) {
564                                 *end = '\0';
565                                 end++;
566                         }
567                 }
568         }
569
570         for (;;) {
571                 ast_stopstream(chan);
572                 res = ast_streamfile(chan, file, chan->language);
573                 if (!res) {
574                         if (pause_restart_point) {
575                                 ast_seekstream(chan->stream, pause_restart_point, SEEK_SET);
576                                 pause_restart_point = 0;
577                         }
578                         else if (end || offset < 0) {
579                                 if (offset == -8) {
580                                         offset = 0;
581                                 }
582                                 ast_verb(3, "ControlPlayback seek to offset %ld from end\n", offset);
583
584                                 ast_seekstream(chan->stream, offset, SEEK_END);
585                                 end = NULL;
586                                 offset = 0;
587                         } else if (offset) {
588                                 ast_verb(3, "ControlPlayback seek to offset %ld\n", offset);
589                                 ast_seekstream(chan->stream, offset, SEEK_SET);
590                                 offset = 0;
591                         }
592                         res = ast_waitstream_fr(chan, breaks, fwd, rev, skipms);
593                 }
594
595                 if (res < 1) {
596                         break;
597                 }
598
599                 /* We go at next loop if we got the restart char */
600                 if (restart && strchr(restart, res)) {
601                         ast_debug(1, "we'll restart the stream here at next loop\n");
602                         pause_restart_point = 0;
603                         continue;
604                 }
605
606                 if (suspend && strchr(suspend, res)) {
607                         pause_restart_point = ast_tellstream(chan->stream);
608                         for (;;) {
609                                 ast_stopstream(chan);
610                                 if (!(res = ast_waitfordigit(chan, 1000))) {
611                                         continue;
612                                 } else if (res == -1 || strchr(suspend, res) || (stop && strchr(stop, res))) {
613                                         break;
614                                 }
615                         }
616                         if (res == *suspend) {
617                                 res = 0;
618                                 continue;
619                         }
620                 }
621
622                 if (res == -1) {
623                         break;
624                 }
625
626                 /* if we get one of our stop chars, return it to the calling function */
627                 if (stop && strchr(stop, res)) {
628                         break;
629                 }
630         }
631
632         if (pause_restart_point) {
633                 offset = pause_restart_point;
634         } else {
635                 if (chan->stream) {
636                         offset = ast_tellstream(chan->stream);
637                 } else {
638                         offset = -8;  /* indicate end of file */
639                 }
640         }
641
642         if (offsetms) {
643                 *offsetms = offset / 8; /* samples --> ms ... XXX Assumes 8 kHz */
644         }
645
646         /* If we are returning a digit cast it as char */
647         if (res > 0 || chan->stream) {
648                 res = (char)res;
649         }
650
651         ast_stopstream(chan);
652
653         return res;
654 }
655
656 int ast_play_and_wait(struct ast_channel *chan, const char *fn)
657 {
658         int d = 0;
659
660         if ((d = ast_streamfile(chan, fn, chan->language))) {
661                 return d;
662         }
663
664         d = ast_waitstream(chan, AST_DIGIT_ANY);
665
666         ast_stopstream(chan);
667
668         return d;
669 }
670
671 static int global_silence_threshold = 128;
672 static int global_maxsilence = 0;
673
674 /*! Optionally play a sound file or a beep, then record audio and video from the channel.
675  * \param chan Channel to playback to/record from.
676  * \param playfile Filename of sound to play before recording begins.
677  * \param recordfile Filename to record to.
678  * \param maxtime Maximum length of recording (in milliseconds).
679  * \param fmt Format(s) to record message in. Multiple formats may be specified by separating them with a '|'.
680  * \param duration Where to store actual length of the recorded message (in milliseconds).
681  * \param beep Whether to play a beep before starting to record.
682  * \param silencethreshold
683  * \param maxsilence Length of silence that will end a recording (in milliseconds).
684  * \param path Optional filesystem path to unlock.
685  * \param prepend If true, prepend the recorded audio to an existing file.
686  * \param acceptdtmf DTMF digits that will end the recording.
687  * \param canceldtmf DTMF digits that will cancel the recording.
688  */
689
690 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)
691 {
692         int d = 0;
693         char *fmts;
694         char comment[256];
695         int x, fmtcnt = 1, res = -1, outmsg = 0;
696         struct ast_filestream *others[MAX_OTHER_FORMATS];
697         char *sfmt[MAX_OTHER_FORMATS];
698         char *stringp = NULL;
699         time_t start, end;
700         struct ast_dsp *sildet = NULL;   /* silence detector dsp */
701         int totalsilence = 0;
702         int rfmt = 0;
703         struct ast_silence_generator *silgen = NULL;
704         char prependfile[80];
705
706         if (silencethreshold < 0) {
707                 silencethreshold = global_silence_threshold;
708         }
709
710         if (maxsilence < 0) {
711                 maxsilence = global_maxsilence;
712         }
713
714         /* barf if no pointer passed to store duration in */
715         if (!duration) {
716                 ast_log(LOG_WARNING, "Error play_and_record called without duration pointer\n");
717                 return -1;
718         }
719
720         ast_debug(1, "play_and_record: %s, %s, '%s'\n", playfile ? playfile : "<None>", recordfile, fmt);
721         snprintf(comment, sizeof(comment), "Playing %s, Recording to: %s on %s\n", playfile ? playfile : "<None>", recordfile, chan->name);
722
723         if (playfile || beep) {
724                 if (!beep) {
725                         d = ast_play_and_wait(chan, playfile);
726                 }
727                 if (d > -1) {
728                         d = ast_stream_and_wait(chan, "beep", "");
729                 }
730                 if (d < 0) {
731                         return -1;
732                 }
733         }
734
735         if (prepend) {
736                 ast_copy_string(prependfile, recordfile, sizeof(prependfile));
737                 strncat(prependfile, "-prepend", sizeof(prependfile) - strlen(prependfile) - 1);
738         }
739
740         fmts = ast_strdupa(fmt);
741
742         stringp = fmts;
743         strsep(&stringp, "|");
744         ast_debug(1, "Recording Formats: sfmts=%s\n", fmts);
745         sfmt[0] = ast_strdupa(fmts);
746
747         while ((fmt = strsep(&stringp, "|"))) {
748                 if (fmtcnt > MAX_OTHER_FORMATS - 1) {
749                         ast_log(LOG_WARNING, "Please increase MAX_OTHER_FORMATS in app.c\n");
750                         break;
751                 }
752                 sfmt[fmtcnt++] = ast_strdupa(fmt);
753         }
754
755         end = start = time(NULL);  /* pre-initialize end to be same as start in case we never get into loop */
756         for (x = 0; x < fmtcnt; x++) {
757                 others[x] = ast_writefile(prepend ? prependfile : recordfile, sfmt[x], comment, O_TRUNC, 0, AST_FILE_MODE);
758                 ast_verb(3, "x=%d, open writing:  %s format: %s, %p\n", x, prepend ? prependfile : recordfile, sfmt[x], others[x]);
759
760                 if (!others[x]) {
761                         break;
762                 }
763         }
764
765         if (path) {
766                 ast_unlock_path(path);
767         }
768
769         if (maxsilence > 0) {
770                 sildet = ast_dsp_new(); /* Create the silence detector */
771                 if (!sildet) {
772                         ast_log(LOG_WARNING, "Unable to create silence detector :(\n");
773                         return -1;
774                 }
775                 ast_dsp_set_threshold(sildet, silencethreshold);
776                 rfmt = chan->readformat;
777                 res = ast_set_read_format(chan, AST_FORMAT_SLINEAR);
778                 if (res < 0) {
779                         ast_log(LOG_WARNING, "Unable to set to linear mode, giving up\n");
780                         ast_dsp_free(sildet);
781                         return -1;
782                 }
783         }
784
785         if (!prepend) {
786                 /* Request a video update */
787                 ast_indicate(chan, AST_CONTROL_VIDUPDATE);
788
789                 if (ast_opt_transmit_silence) {
790                         silgen = ast_channel_start_silence_generator(chan);
791                 }
792         }
793
794         if (x == fmtcnt) {
795                 /* Loop forever, writing the packets we read to the writer(s), until
796                    we read a digit or get a hangup */
797                 struct ast_frame *f;
798                 for (;;) {
799                         if (!(res = ast_waitfor(chan, 2000))) {
800                                 ast_debug(1, "One waitfor failed, trying another\n");
801                                 /* Try one more time in case of masq */
802                                 if (!(res = ast_waitfor(chan, 2000))) {
803                                         ast_log(LOG_WARNING, "No audio available on %s??\n", chan->name);
804                                         res = -1;
805                                 }
806                         }
807
808                         if (res < 0) {
809                                 f = NULL;
810                                 break;
811                         }
812                         if (!(f = ast_read(chan))) {
813                                 break;
814                         }
815                         if (f->frametype == AST_FRAME_VOICE) {
816                                 /* write each format */
817                                 for (x = 0; x < fmtcnt; x++) {
818                                         if (prepend && !others[x]) {
819                                                 break;
820                                         }
821                                         res = ast_writestream(others[x], f);
822                                 }
823
824                                 /* Silence Detection */
825                                 if (maxsilence > 0) {
826                                         int dspsilence = 0;
827                                         ast_dsp_silence(sildet, f, &dspsilence);
828                                         if (dspsilence) {
829                                                 totalsilence = dspsilence;
830                                         } else {
831                                                 totalsilence = 0;
832                                         }
833
834                                         if (totalsilence > maxsilence) {
835                                                 /* Ended happily with silence */
836                                                 ast_verb(3, "Recording automatically stopped after a silence of %d seconds\n", totalsilence/1000);
837                                                 res = 'S';
838                                                 outmsg = 2;
839                                                 break;
840                                         }
841                                 }
842                                 /* Exit on any error */
843                                 if (res) {
844                                         ast_log(LOG_WARNING, "Error writing frame\n");
845                                         break;
846                                 }
847                         } else if (f->frametype == AST_FRAME_VIDEO) {
848                                 /* Write only once */
849                                 ast_writestream(others[0], f);
850                         } else if (f->frametype == AST_FRAME_DTMF) {
851                                 if (prepend) {
852                                 /* stop recording with any digit */
853                                         ast_verb(3, "User ended message by pressing %c\n", f->subclass);
854                                         res = 't';
855                                         outmsg = 2;
856                                         break;
857                                 }
858                                 if (strchr(acceptdtmf, f->subclass)) {
859                                         ast_verb(3, "User ended message by pressing %c\n", f->subclass);
860                                         res = f->subclass;
861                                         outmsg = 2;
862                                         break;
863                                 }
864                                 if (strchr(canceldtmf, f->subclass)) {
865                                         ast_verb(3, "User cancelled message by pressing %c\n", f->subclass);
866                                         res = f->subclass;
867                                         outmsg = 0;
868                                         break;
869                                 }
870                         }
871                         if (maxtime) {
872                                 end = time(NULL);
873                                 if (maxtime < (end - start)) {
874                                         ast_verb(3, "Took too long, cutting it short...\n");
875                                         res = 't';
876                                         outmsg = 2;
877                                         break;
878                                 }
879                         }
880                         ast_frfree(f);
881                 }
882                 if (!f) {
883                         ast_verb(3, "User hung up\n");
884                         res = -1;
885                         outmsg = 1;
886                 } else {
887                         ast_frfree(f);
888                 }
889         } else {
890                 ast_log(LOG_WARNING, "Error creating writestream '%s', format '%s'\n", recordfile, sfmt[x]);
891         }
892
893         if (!prepend) {
894                 if (silgen) {
895                         ast_channel_stop_silence_generator(chan, silgen);
896                 }
897         }
898
899         /*!\note
900          * Instead of asking how much time passed (end - start), calculate the number
901          * of seconds of audio which actually went into the file.  This fixes a
902          * problem where audio is stopped up on the network and never gets to us.
903          *
904          * Note that we still want to use the number of seconds passed for the max
905          * message, otherwise we could get a situation where this stream is never
906          * closed (which would create a resource leak).
907          */
908         *duration = others[0] ? ast_tellstream(others[0]) / 8000 : 0;
909
910         if (!prepend) {
911                 for (x = 0; x < fmtcnt; x++) {
912                         if (!others[x]) {
913                                 break;
914                         }
915                         /*!\note
916                          * If we ended with silence, trim all but the first 200ms of silence
917                          * off the recording.  However, if we ended with '#', we don't want
918                          * to trim ANY part of the recording.
919                          */
920                         if (res > 0 && totalsilence) {
921                                 ast_stream_rewind(others[x], totalsilence - 200);
922                                 /* Reduce duration by a corresponding amount */
923                                 if (x == 0 && *duration) {
924                                         *duration -= (totalsilence - 200) / 1000;
925                                         if (*duration < 0) {
926                                                 *duration = 0;
927                                         }
928                                 }
929                         }
930                         ast_truncstream(others[x]);
931                         ast_closestream(others[x]);
932                 }
933         }
934
935         if (prepend && outmsg) {
936                 struct ast_filestream *realfiles[MAX_OTHER_FORMATS];
937                 struct ast_frame *fr;
938
939                 for (x = 0; x < fmtcnt; x++) {
940                         snprintf(comment, sizeof(comment), "Opening the real file %s.%s\n", recordfile, sfmt[x]);
941                         realfiles[x] = ast_readfile(recordfile, sfmt[x], comment, O_RDONLY, 0, 0);
942                         if (!others[x] || !realfiles[x]) {
943                                 break;
944                         }
945                         /*!\note Same logic as above. */
946                         if (totalsilence) {
947                                 ast_stream_rewind(others[x], totalsilence - 200);
948                         }
949                         ast_truncstream(others[x]);
950                         /* add the original file too */
951                         while ((fr = ast_readframe(realfiles[x]))) {
952                                 ast_writestream(others[x], fr);
953                                 ast_frfree(fr);
954                         }
955                         ast_closestream(others[x]);
956                         ast_closestream(realfiles[x]);
957                         ast_filerename(prependfile, recordfile, sfmt[x]);
958                         ast_verb(4, "Recording Format: sfmts=%s, prependfile %s, recordfile %s\n", sfmt[x], prependfile, recordfile);
959                         ast_filedelete(prependfile, sfmt[x]);
960                 }
961         }
962         if (rfmt && ast_set_read_format(chan, rfmt)) {
963                 ast_log(LOG_WARNING, "Unable to restore format %s to channel '%s'\n", ast_getformatname(rfmt), chan->name);
964         }
965         if (outmsg == 2) {
966                 ast_stream_and_wait(chan, "auth-thankyou", "");
967         }
968         if (sildet) {
969                 ast_dsp_free(sildet);
970         }
971         return res;
972 }
973
974 static const char default_acceptdtmf[] = "#";
975 static const char default_canceldtmf[] = "";
976
977 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)
978 {
979         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));
980 }
981
982 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)
983 {
984         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, 0, silencethreshold, maxsilence, path, 0, default_acceptdtmf, default_canceldtmf);
985 }
986
987 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)
988 {
989         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, beep, silencethreshold, maxsilence, NULL, 1, default_acceptdtmf, default_canceldtmf);
990 }
991
992 /* Channel group core functions */
993
994 int ast_app_group_split_group(const char *data, char *group, int group_max, char *category, int category_max)
995 {
996         int res = 0;
997         char tmp[256];
998         char *grp = NULL, *cat = NULL;
999
1000         if (!ast_strlen_zero(data)) {
1001                 ast_copy_string(tmp, data, sizeof(tmp));
1002                 grp = tmp;
1003                 if ((cat = strchr(tmp, '@'))) {
1004                         *cat++ = '\0';
1005                 }
1006         }
1007
1008         if (!ast_strlen_zero(grp)) {
1009                 ast_copy_string(group, grp, group_max);
1010         } else {
1011                 *group = '\0';
1012         }
1013
1014         if (!ast_strlen_zero(cat)) {
1015                 ast_copy_string(category, cat, category_max);
1016         }
1017
1018         return res;
1019 }
1020
1021 int ast_app_group_set_channel(struct ast_channel *chan, const char *data)
1022 {
1023         int res = 0;
1024         char group[80] = "", category[80] = "";
1025         struct ast_group_info *gi = NULL;
1026         size_t len = 0;
1027
1028         if (ast_app_group_split_group(data, group, sizeof(group), category, sizeof(category))) {
1029                 return -1;
1030         }
1031
1032         /* Calculate memory we will need if this is new */
1033         len = sizeof(*gi) + strlen(group) + 1;
1034         if (!ast_strlen_zero(category)) {
1035                 len += strlen(category) + 1;
1036         }
1037
1038         AST_RWLIST_WRLOCK(&groups);
1039         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&groups, gi, group_list) {
1040                 if ((gi->chan == chan) && ((ast_strlen_zero(category) && ast_strlen_zero(gi->category)) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
1041                         AST_RWLIST_REMOVE_CURRENT(group_list);
1042                         free(gi);
1043                         break;
1044                 }
1045         }
1046         AST_RWLIST_TRAVERSE_SAFE_END;
1047
1048         if (ast_strlen_zero(group)) {
1049                 /* Enable unsetting the group */
1050         } else if ((gi = calloc(1, len))) {
1051                 gi->chan = chan;
1052                 gi->group = (char *) gi + sizeof(*gi);
1053                 strcpy(gi->group, group);
1054                 if (!ast_strlen_zero(category)) {
1055                         gi->category = (char *) gi + sizeof(*gi) + strlen(group) + 1;
1056                         strcpy(gi->category, category);
1057                 }
1058                 AST_RWLIST_INSERT_TAIL(&groups, gi, group_list);
1059         } else {
1060                 res = -1;
1061         }
1062
1063         AST_RWLIST_UNLOCK(&groups);
1064
1065         return res;
1066 }
1067
1068 int ast_app_group_get_count(const char *group, const char *category)
1069 {
1070         struct ast_group_info *gi = NULL;
1071         int count = 0;
1072
1073         if (ast_strlen_zero(group)) {
1074                 return 0;
1075         }
1076
1077         AST_RWLIST_RDLOCK(&groups);
1078         AST_RWLIST_TRAVERSE(&groups, gi, group_list) {
1079                 if (!strcasecmp(gi->group, group) && (ast_strlen_zero(category) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
1080                         count++;
1081                 }
1082         }
1083         AST_RWLIST_UNLOCK(&groups);
1084
1085         return count;
1086 }
1087
1088 int ast_app_group_match_get_count(const char *groupmatch, const char *category)
1089 {
1090         struct ast_group_info *gi = NULL;
1091         regex_t regexbuf;
1092         int count = 0;
1093
1094         if (ast_strlen_zero(groupmatch)) {
1095                 return 0;
1096         }
1097
1098         /* if regex compilation fails, return zero matches */
1099         if (regcomp(&regexbuf, groupmatch, REG_EXTENDED | REG_NOSUB)) {
1100                 return 0;
1101         }
1102
1103         AST_RWLIST_RDLOCK(&groups);
1104         AST_RWLIST_TRAVERSE(&groups, gi, group_list) {
1105                 if (!regexec(&regexbuf, gi->group, 0, NULL, 0) && (ast_strlen_zero(category) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
1106                         count++;
1107                 }
1108         }
1109         AST_RWLIST_UNLOCK(&groups);
1110
1111         regfree(&regexbuf);
1112
1113         return count;
1114 }
1115
1116 int ast_app_group_update(struct ast_channel *old, struct ast_channel *new)
1117 {
1118         struct ast_group_info *gi = NULL;
1119
1120         AST_RWLIST_WRLOCK(&groups);
1121         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&groups, gi, group_list) {
1122                 if (gi->chan == old) {
1123                         gi->chan = new;
1124                 } else if (gi->chan == new) {
1125                         AST_RWLIST_REMOVE_CURRENT(group_list);
1126                         ast_free(gi);
1127                 }
1128         }
1129         AST_RWLIST_TRAVERSE_SAFE_END;
1130         AST_RWLIST_UNLOCK(&groups);
1131
1132         return 0;
1133 }
1134
1135 int ast_app_group_discard(struct ast_channel *chan)
1136 {
1137         struct ast_group_info *gi = NULL;
1138
1139         AST_RWLIST_WRLOCK(&groups);
1140         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&groups, gi, group_list) {
1141                 if (gi->chan == chan) {
1142                         AST_RWLIST_REMOVE_CURRENT(group_list);
1143                         ast_free(gi);
1144                 }
1145         }
1146         AST_RWLIST_TRAVERSE_SAFE_END;
1147         AST_RWLIST_UNLOCK(&groups);
1148
1149         return 0;
1150 }
1151
1152 int ast_app_group_list_wrlock(void)
1153 {
1154         return AST_RWLIST_WRLOCK(&groups);
1155 }
1156
1157 int ast_app_group_list_rdlock(void)
1158 {
1159         return AST_RWLIST_RDLOCK(&groups);
1160 }
1161
1162 struct ast_group_info *ast_app_group_list_head(void)
1163 {
1164         return AST_RWLIST_FIRST(&groups);
1165 }
1166
1167 int ast_app_group_list_unlock(void)
1168 {
1169         return AST_RWLIST_UNLOCK(&groups);
1170 }
1171
1172 unsigned int ast_app_separate_args(char *buf, char delim, char **array, int arraylen)
1173 {
1174         int argc;
1175         char *scan, *wasdelim = NULL;
1176         int paren = 0, quote = 0;
1177
1178         if (!buf || !array || !arraylen) {
1179                 return 0;
1180         }
1181
1182         memset(array, 0, arraylen * sizeof(*array));
1183
1184         scan = buf;
1185
1186         for (argc = 0; *scan && (argc < arraylen - 1); argc++) {
1187                 array[argc] = scan;
1188                 for (; *scan; scan++) {
1189                         if (*scan == '(') {
1190                                 paren++;
1191                         } else if (*scan == ')') {
1192                                 if (paren) {
1193                                         paren--;
1194                                 }
1195                         } else if (*scan == '"' && delim != '"') {
1196                                 quote = quote ? 0 : 1;
1197                                 /* Remove quote character from argument */
1198                                 memmove(scan, scan + 1, strlen(scan));
1199                                 scan--;
1200                         } else if (*scan == '\\') {
1201                                 /* Literal character, don't parse */
1202                                 memmove(scan, scan + 1, strlen(scan));
1203                         } else if ((*scan == delim) && !paren && !quote) {
1204                                 wasdelim = scan;
1205                                 *scan++ = '\0';
1206                                 break;
1207                         }
1208                 }
1209         }
1210
1211         /* If the last character in the original string was the delimiter, then
1212          * there is one additional argument. */
1213         if (*scan || (scan > buf && (scan - 1) == wasdelim)) {
1214                 array[argc++] = scan;
1215         }
1216
1217         return argc;
1218 }
1219
1220 static enum AST_LOCK_RESULT ast_lock_path_lockfile(const char *path)
1221 {
1222         char *s;
1223         char *fs;
1224         int res;
1225         int fd;
1226         int lp = strlen(path);
1227         time_t start;
1228
1229         s = alloca(lp + 10);
1230         fs = alloca(lp + 20);
1231
1232         snprintf(fs, strlen(path) + 19, "%s/.lock-%08lx", path, ast_random());
1233         fd = open(fs, O_WRONLY | O_CREAT | O_EXCL, AST_FILE_MODE);
1234         if (fd < 0) {
1235                 ast_log(LOG_ERROR, "Unable to create lock file '%s': %s\n", path, strerror(errno));
1236                 return AST_LOCK_PATH_NOT_FOUND;
1237         }
1238         close(fd);
1239
1240         snprintf(s, strlen(path) + 9, "%s/.lock", path);
1241         start = time(NULL);
1242         while (((res = link(fs, s)) < 0) && (errno == EEXIST) && (time(NULL) - start < 5)) {
1243                 sched_yield();
1244         }
1245
1246         unlink(fs);
1247
1248         if (res) {
1249                 ast_log(LOG_WARNING, "Failed to lock path '%s': %s\n", path, strerror(errno));
1250                 return AST_LOCK_TIMEOUT;
1251         } else {
1252                 ast_debug(1, "Locked path '%s'\n", path);
1253                 return AST_LOCK_SUCCESS;
1254         }
1255 }
1256
1257 static int ast_unlock_path_lockfile(const char *path)
1258 {
1259         char *s;
1260         int res;
1261
1262         s = alloca(strlen(path) + 10);
1263
1264         snprintf(s, strlen(path) + 9, "%s/%s", path, ".lock");
1265
1266         if ((res = unlink(s))) {
1267                 ast_log(LOG_ERROR, "Could not unlock path '%s': %s\n", path, strerror(errno));
1268         } else {
1269                 ast_debug(1, "Unlocked path '%s'\n", path);
1270         }
1271
1272         return res;
1273 }
1274
1275 struct path_lock {
1276         AST_LIST_ENTRY(path_lock) le;
1277         int fd;
1278         char *path;
1279 };
1280
1281 static AST_LIST_HEAD_STATIC(path_lock_list, path_lock);
1282
1283 static void path_lock_destroy(struct path_lock *obj)
1284 {
1285         if (obj->fd >= 0) {
1286                 close(obj->fd);
1287         }
1288         if (obj->path) {
1289                 free(obj->path);
1290         }
1291         free(obj);
1292 }
1293
1294 static enum AST_LOCK_RESULT ast_lock_path_flock(const char *path)
1295 {
1296         char *fs;
1297         int res;
1298         int fd;
1299         time_t start;
1300         struct path_lock *pl;
1301         struct stat st, ost;
1302
1303         fs = alloca(strlen(path) + 20);
1304
1305         snprintf(fs, strlen(path) + 19, "%s/lock", path);
1306         if (lstat(fs, &st) == 0) {
1307                 if ((st.st_mode & S_IFMT) == S_IFLNK) {
1308                         ast_log(LOG_WARNING, "Unable to create lock file "
1309                                         "'%s': it's already a symbolic link\n",
1310                                         fs);
1311                         return AST_LOCK_FAILURE;
1312                 }
1313                 if (st.st_nlink > 1) {
1314                         ast_log(LOG_WARNING, "Unable to create lock file "
1315                                         "'%s': %u hard links exist\n",
1316                                         fs, (unsigned int) st.st_nlink);
1317                         return AST_LOCK_FAILURE;
1318                 }
1319         }
1320         if ((fd = open(fs, O_WRONLY | O_CREAT, 0600)) < 0) {
1321                 ast_log(LOG_WARNING, "Unable to create lock file '%s': %s\n",
1322                                 fs, strerror(errno));
1323                 return AST_LOCK_PATH_NOT_FOUND;
1324         }
1325         if (!(pl = ast_calloc(1, sizeof(*pl)))) {
1326                 /* We don't unlink the lock file here, on the possibility that
1327                  * someone else created it - better to leave a little mess
1328                  * than create a big one by destroying someone else's lock
1329                  * and causing something to be corrupted.
1330                  */
1331                 close(fd);
1332                 return AST_LOCK_FAILURE;
1333         }
1334         pl->fd = fd;
1335         pl->path = strdup(path);
1336
1337         time(&start);
1338         while (
1339                 #ifdef SOLARIS
1340                 ((res = fcntl(pl->fd, F_SETLK, fcntl(pl->fd, F_GETFL) | O_NONBLOCK)) < 0) &&
1341                 #else
1342                 ((res = flock(pl->fd, LOCK_EX | LOCK_NB)) < 0) &&
1343                 #endif
1344                         (errno == EWOULDBLOCK) &&
1345                         (time(NULL) - start < 5))
1346                 usleep(1000);
1347         if (res) {
1348                 ast_log(LOG_WARNING, "Failed to lock path '%s': %s\n",
1349                                 path, strerror(errno));
1350                 /* No unlinking of lock done, since we tried and failed to
1351                  * flock() it.
1352                  */
1353                 path_lock_destroy(pl);
1354                 return AST_LOCK_TIMEOUT;
1355         }
1356
1357         /* Check for the race where the file is recreated or deleted out from
1358          * underneath us.
1359          */
1360         if (lstat(fs, &st) != 0 && fstat(pl->fd, &ost) != 0 &&
1361                         st.st_dev != ost.st_dev &&
1362                         st.st_ino != ost.st_ino) {
1363                 ast_log(LOG_WARNING, "Unable to create lock file '%s': "
1364                                 "file changed underneath us\n", fs);
1365                 path_lock_destroy(pl);
1366                 return AST_LOCK_FAILURE;
1367         }
1368
1369         /* Success: file created, flocked, and is the one we started with */
1370         AST_LIST_LOCK(&path_lock_list);
1371         AST_LIST_INSERT_TAIL(&path_lock_list, pl, le);
1372         AST_LIST_UNLOCK(&path_lock_list);
1373
1374         ast_debug(1, "Locked path '%s'\n", path);
1375
1376         return AST_LOCK_SUCCESS;
1377 }
1378
1379 static int ast_unlock_path_flock(const char *path)
1380 {
1381         char *s;
1382         struct path_lock *p;
1383
1384         s = alloca(strlen(path) + 20);
1385
1386         AST_LIST_LOCK(&path_lock_list);
1387         AST_LIST_TRAVERSE_SAFE_BEGIN(&path_lock_list, p, le) {
1388                 if (!strcmp(p->path, path)) {
1389                         AST_LIST_REMOVE_CURRENT(le);
1390                         break;
1391                 }
1392         }
1393         AST_LIST_TRAVERSE_SAFE_END;
1394         AST_LIST_UNLOCK(&path_lock_list);
1395
1396         if (p) {
1397                 snprintf(s, strlen(path) + 19, "%s/lock", path);
1398                 unlink(s);
1399                 path_lock_destroy(p);
1400                 ast_log(LOG_DEBUG, "Unlocked path '%s'\n", path);
1401         } else {
1402                 ast_log(LOG_DEBUG, "Failed to unlock path '%s': "
1403                                 "lock not found\n", path);
1404         }
1405
1406         return 0;
1407 }
1408
1409 void ast_set_lock_type(enum AST_LOCK_TYPE type)
1410 {
1411         ast_lock_type = type;
1412 }
1413
1414 enum AST_LOCK_RESULT ast_lock_path(const char *path)
1415 {
1416         enum AST_LOCK_RESULT r = AST_LOCK_FAILURE;
1417
1418         switch (ast_lock_type) {
1419         case AST_LOCK_TYPE_LOCKFILE:
1420                 r = ast_lock_path_lockfile(path);
1421                 break;
1422         case AST_LOCK_TYPE_FLOCK:
1423                 r = ast_lock_path_flock(path);
1424                 break;
1425         }
1426
1427         return r;
1428 }
1429
1430 int ast_unlock_path(const char *path)
1431 {
1432         int r = 0;
1433
1434         switch (ast_lock_type) {
1435         case AST_LOCK_TYPE_LOCKFILE:
1436                 r = ast_unlock_path_lockfile(path);
1437                 break;
1438         case AST_LOCK_TYPE_FLOCK:
1439                 r = ast_unlock_path_flock(path);
1440                 break;
1441         }
1442
1443         return r;
1444 }
1445
1446 int ast_record_review(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, const char *path) 
1447 {
1448         int silencethreshold;
1449         int maxsilence = 0;
1450         int res = 0;
1451         int cmd = 0;
1452         int max_attempts = 3;
1453         int attempts = 0;
1454         int recorded = 0;
1455         int message_exists = 0;
1456         /* Note that urgent and private are for flagging messages as such in the future */
1457
1458         /* barf if no pointer passed to store duration in */
1459         if (!duration) {
1460                 ast_log(LOG_WARNING, "Error ast_record_review called without duration pointer\n");
1461                 return -1;
1462         }
1463
1464         cmd = '3';       /* Want to start by recording */
1465
1466         silencethreshold = ast_dsp_get_threshold_from_settings(THRESHOLD_SILENCE);
1467
1468         while ((cmd >= 0) && (cmd != 't')) {
1469                 switch (cmd) {
1470                 case '1':
1471                         if (!message_exists) {
1472                                 /* In this case, 1 is to record a message */
1473                                 cmd = '3';
1474                                 break;
1475                         } else {
1476                                 ast_stream_and_wait(chan, "vm-msgsaved", "");
1477                                 cmd = 't';
1478                                 return res;
1479                         }
1480                 case '2':
1481                         /* Review */
1482                         ast_verb(3, "Reviewing the recording\n");
1483                         cmd = ast_stream_and_wait(chan, recordfile, AST_DIGIT_ANY);
1484                         break;
1485                 case '3':
1486                         message_exists = 0;
1487                         /* Record */
1488                         ast_verb(3, "R%secording\n", recorded == 1 ? "e-r" : "");
1489                         recorded = 1;
1490                         if ((cmd = ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, silencethreshold, maxsilence, path)) == -1) {
1491                                 /* User has hung up, no options to give */
1492                                 return cmd;
1493                         }
1494                         if (cmd == '0') {
1495                                 break;
1496                         } else if (cmd == '*') {
1497                                 break;
1498                         } else {
1499                                 /* If all is well, a message exists */
1500                                 message_exists = 1;
1501                                 cmd = 0;
1502                         }
1503                         break;
1504                 case '4':
1505                 case '5':
1506                 case '6':
1507                 case '7':
1508                 case '8':
1509                 case '9':
1510                 case '*':
1511                 case '#':
1512                         cmd = ast_play_and_wait(chan, "vm-sorry");
1513                         break;
1514                 default:
1515                         if (message_exists) {
1516                                 cmd = ast_play_and_wait(chan, "vm-review");
1517                         } else {
1518                                 if (!(cmd = ast_play_and_wait(chan, "vm-torerecord"))) {
1519                                         cmd = ast_waitfordigit(chan, 600);
1520                                 }
1521                         }
1522
1523                         if (!cmd) {
1524                                 cmd = ast_waitfordigit(chan, 6000);
1525                         }
1526                         if (!cmd) {
1527                                 attempts++;
1528                         }
1529                         if (attempts > max_attempts) {
1530                                 cmd = 't';
1531                         }
1532                 }
1533         }
1534         if (cmd == 't') {
1535                 cmd = 0;
1536         }
1537         return cmd;
1538 }
1539
1540 #define RES_UPONE (1 << 16)
1541 #define RES_EXIT  (1 << 17)
1542 #define RES_REPEAT (1 << 18)
1543 #define RES_RESTART ((1 << 19) | RES_REPEAT)
1544
1545 static int ast_ivr_menu_run_internal(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata);
1546
1547 static int ivr_dispatch(struct ast_channel *chan, struct ast_ivr_option *option, char *exten, void *cbdata)
1548 {
1549         int res;
1550         int (*ivr_func)(struct ast_channel *, void *);
1551         char *c;
1552         char *n;
1553
1554         switch (option->action) {
1555         case AST_ACTION_UPONE:
1556                 return RES_UPONE;
1557         case AST_ACTION_EXIT:
1558                 return RES_EXIT | (((unsigned long)(option->adata)) & 0xffff);
1559         case AST_ACTION_REPEAT:
1560                 return RES_REPEAT | (((unsigned long)(option->adata)) & 0xffff);
1561         case AST_ACTION_RESTART:
1562                 return RES_RESTART ;
1563         case AST_ACTION_NOOP:
1564                 return 0;
1565         case AST_ACTION_BACKGROUND:
1566                 res = ast_stream_and_wait(chan, (char *)option->adata, AST_DIGIT_ANY);
1567                 if (res < 0) {
1568                         ast_log(LOG_NOTICE, "Unable to find file '%s'!\n", (char *)option->adata);
1569                         res = 0;
1570                 }
1571                 return res;
1572         case AST_ACTION_PLAYBACK:
1573                 res = ast_stream_and_wait(chan, (char *)option->adata, "");
1574                 if (res < 0) {
1575                         ast_log(LOG_NOTICE, "Unable to find file '%s'!\n", (char *)option->adata);
1576                         res = 0;
1577                 }
1578                 return res;
1579         case AST_ACTION_MENU:
1580                 if ((res = ast_ivr_menu_run_internal(chan, (struct ast_ivr_menu *)option->adata, cbdata)) == -2) {
1581                         /* Do not pass entry errors back up, treat as though it was an "UPONE" */
1582                         res = 0;
1583                 }
1584                 return res;
1585         case AST_ACTION_WAITOPTION:
1586                 if (!(res = ast_waitfordigit(chan, chan->pbx ? chan->pbx->rtimeoutms : 10000))) {
1587                         return 't';
1588                 }
1589                 return res;
1590         case AST_ACTION_CALLBACK:
1591                 ivr_func = option->adata;
1592                 res = ivr_func(chan, cbdata);
1593                 return res;
1594         case AST_ACTION_TRANSFER:
1595                 res = ast_parseable_goto(chan, option->adata);
1596                 return 0;
1597         case AST_ACTION_PLAYLIST:
1598         case AST_ACTION_BACKLIST:
1599                 res = 0;
1600                 c = ast_strdupa(option->adata);
1601                 while ((n = strsep(&c, ";"))) {
1602                         if ((res = ast_stream_and_wait(chan, n,
1603                                         (option->action == AST_ACTION_BACKLIST) ? AST_DIGIT_ANY : ""))) {
1604                                 break;
1605                         }
1606                 }
1607                 ast_stopstream(chan);
1608                 return res;
1609         default:
1610                 ast_log(LOG_NOTICE, "Unknown dispatch function %d, ignoring!\n", option->action);
1611                 return 0;
1612         }
1613         return -1;
1614 }
1615
1616 static int option_exists(struct ast_ivr_menu *menu, char *option)
1617 {
1618         int x;
1619         for (x = 0; menu->options[x].option; x++) {
1620                 if (!strcasecmp(menu->options[x].option, option)) {
1621                         return x;
1622                 }
1623         }
1624         return -1;
1625 }
1626
1627 static int option_matchmore(struct ast_ivr_menu *menu, char *option)
1628 {
1629         int x;
1630         for (x = 0; menu->options[x].option; x++) {
1631                 if ((!strncasecmp(menu->options[x].option, option, strlen(option))) &&
1632                                 (menu->options[x].option[strlen(option)])) {
1633                         return x;
1634                 }
1635         }
1636         return -1;
1637 }
1638
1639 static int read_newoption(struct ast_channel *chan, struct ast_ivr_menu *menu, char *exten, int maxexten)
1640 {
1641         int res = 0;
1642         int ms;
1643         while (option_matchmore(menu, exten)) {
1644                 ms = chan->pbx ? chan->pbx->dtimeoutms : 5000;
1645                 if (strlen(exten) >= maxexten - 1) {
1646                         break;
1647                 }
1648                 if ((res = ast_waitfordigit(chan, ms)) < 1) {
1649                         break;
1650                 }
1651                 exten[strlen(exten) + 1] = '\0';
1652                 exten[strlen(exten)] = res;
1653         }
1654         return res > 0 ? 0 : res;
1655 }
1656
1657 static int ast_ivr_menu_run_internal(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata)
1658 {
1659         /* Execute an IVR menu structure */
1660         int res = 0;
1661         int pos = 0;
1662         int retries = 0;
1663         char exten[AST_MAX_EXTENSION] = "s";
1664         if (option_exists(menu, "s") < 0) {
1665                 strcpy(exten, "g");
1666                 if (option_exists(menu, "g") < 0) {
1667                         ast_log(LOG_WARNING, "No 's' nor 'g' extension in menu '%s'!\n", menu->title);
1668                         return -1;
1669                 }
1670         }
1671         while (!res) {
1672                 while (menu->options[pos].option) {
1673                         if (!strcasecmp(menu->options[pos].option, exten)) {
1674                                 res = ivr_dispatch(chan, menu->options + pos, exten, cbdata);
1675                                 ast_debug(1, "IVR Dispatch of '%s' (pos %d) yields %d\n", exten, pos, res);
1676                                 if (res < 0) {
1677                                         break;
1678                                 } else if (res & RES_UPONE) {
1679                                         return 0;
1680                                 } else if (res & RES_EXIT) {
1681                                         return res;
1682                                 } else if (res & RES_REPEAT) {
1683                                         int maxretries = res & 0xffff;
1684                                         if ((res & RES_RESTART) == RES_RESTART) {
1685                                                 retries = 0;
1686                                         } else {
1687                                                 retries++;
1688                                         }
1689                                         if (!maxretries) {
1690                                                 maxretries = 3;
1691                                         }
1692                                         if ((maxretries > 0) && (retries >= maxretries)) {
1693                                                 ast_debug(1, "Max retries %d exceeded\n", maxretries);
1694                                                 return -2;
1695                                         } else {
1696                                                 if (option_exists(menu, "g") > -1) {
1697                                                         strcpy(exten, "g");
1698                                                 } else if (option_exists(menu, "s") > -1) {
1699                                                         strcpy(exten, "s");
1700                                                 }
1701                                         }
1702                                         pos = 0;
1703                                         continue;
1704                                 } else if (res && strchr(AST_DIGIT_ANY, res)) {
1705                                         ast_debug(1, "Got start of extension, %c\n", res);
1706                                         exten[1] = '\0';
1707                                         exten[0] = res;
1708                                         if ((res = read_newoption(chan, menu, exten, sizeof(exten)))) {
1709                                                 break;
1710                                         }
1711                                         if (option_exists(menu, exten) < 0) {
1712                                                 if (option_exists(menu, "i")) {
1713                                                         ast_debug(1, "Invalid extension entered, going to 'i'!\n");
1714                                                         strcpy(exten, "i");
1715                                                         pos = 0;
1716                                                         continue;
1717                                                 } else {
1718                                                         ast_debug(1, "Aborting on invalid entry, with no 'i' option!\n");
1719                                                         res = -2;
1720                                                         break;
1721                                                 }
1722                                         } else {
1723                                                 ast_debug(1, "New existing extension: %s\n", exten);
1724                                                 pos = 0;
1725                                                 continue;
1726                                         }
1727                                 }
1728                         }
1729                         pos++;
1730                 }
1731                 ast_debug(1, "Stopping option '%s', res is %d\n", exten, res);
1732                 pos = 0;
1733                 if (!strcasecmp(exten, "s")) {
1734                         strcpy(exten, "g");
1735                 } else {
1736                         break;
1737                 }
1738         }
1739         return res;
1740 }
1741
1742 int ast_ivr_menu_run(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata)
1743 {
1744         int res = ast_ivr_menu_run_internal(chan, menu, cbdata);
1745         /* Hide internal coding */
1746         return res > 0 ? 0 : res;
1747 }
1748
1749 char *ast_read_textfile(const char *filename)
1750 {
1751         int fd, count = 0, res;
1752         char *output = NULL;
1753         struct stat filesize;
1754
1755         if (stat(filename, &filesize) == -1) {
1756                 ast_log(LOG_WARNING, "Error can't stat %s\n", filename);
1757                 return NULL;
1758         }
1759
1760         count = filesize.st_size + 1;
1761
1762         if ((fd = open(filename, O_RDONLY)) < 0) {
1763                 ast_log(LOG_WARNING, "Cannot open file '%s' for reading: %s\n", filename, strerror(errno));
1764                 return NULL;
1765         }
1766
1767         if ((output = ast_malloc(count))) {
1768                 res = read(fd, output, count - 1);
1769                 if (res == count - 1) {
1770                         output[res] = '\0';
1771                 } else {
1772                         ast_log(LOG_WARNING, "Short read of %s (%d of %d): %s\n", filename, res, count - 1, strerror(errno));
1773                         ast_free(output);
1774                         output = NULL;
1775                 }
1776         }
1777
1778         close(fd);
1779
1780         return output;
1781 }
1782
1783 int ast_app_parse_options(const struct ast_app_option *options, struct ast_flags *flags, char **args, char *optstr)
1784 {
1785         char *s, *arg;
1786         int curarg, res = 0;
1787         unsigned int argloc;
1788
1789         ast_clear_flag(flags, AST_FLAGS_ALL);
1790
1791         if (!optstr) {
1792                 return 0;
1793         }
1794
1795         s = optstr;
1796         while (*s) {
1797                 curarg = *s++ & 0x7f;   /* the array (in app.h) has 128 entries */
1798                 argloc = options[curarg].arg_index;
1799                 if (*s == '(') {
1800                         /* Has argument */
1801                         arg = ++s;
1802                         if ((s = strchr(s, ')'))) {
1803                                 if (argloc) {
1804                                         args[argloc - 1] = arg;
1805                                 }
1806                                 *s++ = '\0';
1807                         } else {
1808                                 ast_log(LOG_WARNING, "Missing closing parenthesis for argument '%c' in string '%s'\n", curarg, arg);
1809                                 res = -1;
1810                                 break;
1811                         }
1812                 } else if (argloc) {
1813                         args[argloc - 1] = "";
1814                 }
1815                 ast_set_flag(flags, options[curarg].flag);
1816         }
1817
1818         return res;
1819 }
1820
1821 /* the following function will probably only be used in app_dial, until app_dial is reorganized to
1822    better handle the large number of options it provides. After it is, you need to get rid of this variant 
1823    -- unless, of course, someone else digs up some use for large flag fields. */
1824
1825 int ast_app_parse_options64(const struct ast_app_option *options, struct ast_flags64 *flags, char **args, char *optstr)
1826 {
1827         char *s, *arg;
1828         int curarg, res = 0;
1829         unsigned int argloc;
1830
1831         flags->flags = 0;
1832
1833         if (!optstr) {
1834                 return 0;
1835         }
1836
1837         s = optstr;
1838         while (*s) {
1839                 curarg = *s++ & 0x7f;   /* the array (in app.h) has 128 entries */
1840                 ast_set_flag64(flags, options[curarg].flag);
1841                 argloc = options[curarg].arg_index;
1842                 if (*s == '(') {
1843                         /* Has argument */
1844                         arg = ++s;
1845                         if ((s = strchr(s, ')'))) {
1846                                 if (argloc) {
1847                                         args[argloc - 1] = arg;
1848                                 }
1849                                 *s++ = '\0';
1850                         } else {
1851                                 ast_log(LOG_WARNING, "Missing closing parenthesis for argument '%c' in string '%s'\n", curarg, arg);
1852                                 res = -1;
1853                                 break;
1854                         }
1855                 } else if (argloc) {
1856                         args[argloc - 1] = NULL;
1857                 }
1858         }
1859
1860         return res;
1861 }
1862
1863 void ast_app_options2str64(const struct ast_app_option *options, struct ast_flags64 *flags, char *buf, size_t len)
1864 {
1865         unsigned int i, found = 0;
1866         for (i = 32; i < 128 && found < len; i++) {
1867                 if (ast_test_flag64(flags, options[i].flag)) {
1868                         buf[found++] = i;
1869                 }
1870         }
1871         buf[found] = '\0';
1872 }
1873
1874 int ast_get_encoded_char(const char *stream, char *result, size_t *consumed)
1875 {
1876         int i;
1877         *consumed = 1;
1878         *result = 0;
1879         if (ast_strlen_zero(stream)) {
1880                 *consumed = 0;
1881                 return -1;
1882         }
1883
1884         if (*stream == '\\') {
1885                 *consumed = 2;
1886                 switch (*(stream + 1)) {
1887                 case 'n':
1888                         *result = '\n';
1889                         break;
1890                 case 'r':
1891                         *result = '\r';
1892                         break;
1893                 case 't':
1894                         *result = '\t';
1895                         break;
1896                 case 'x':
1897                         /* Hexadecimal */
1898                         if (strchr("0123456789ABCDEFabcdef", *(stream + 2)) && *(stream + 2) != '\0') {
1899                                 *consumed = 3;
1900                                 if (*(stream + 2) <= '9') {
1901                                         *result = *(stream + 2) - '0';
1902                                 } else if (*(stream + 2) <= 'F') {
1903                                         *result = *(stream + 2) - 'A' + 10;
1904                                 } else {
1905                                         *result = *(stream + 2) - 'a' + 10;
1906                                 }
1907                         } else {
1908                                 ast_log(LOG_ERROR, "Illegal character '%c' in hexadecimal string\n", *(stream + 2));
1909                                 return -1;
1910                         }
1911
1912                         if (strchr("0123456789ABCDEFabcdef", *(stream + 3)) && *(stream + 3) != '\0') {
1913                                 *consumed = 4;
1914                                 *result <<= 4;
1915                                 if (*(stream + 3) <= '9') {
1916                                         *result += *(stream + 3) - '0';
1917                                 } else if (*(stream + 3) <= 'F') {
1918                                         *result += *(stream + 3) - 'A' + 10;
1919                                 } else {
1920                                         *result += *(stream + 3) - 'a' + 10;
1921                                 }
1922                         }
1923                         break;
1924                 case '0':
1925                         /* Octal */
1926                         *consumed = 2;
1927                         for (i = 2; ; i++) {
1928                                 if (strchr("01234567", *(stream + i)) && *(stream + i) != '\0') {
1929                                         (*consumed)++;
1930                                         ast_debug(5, "result was %d, ", *result);
1931                                         *result <<= 3;
1932                                         *result += *(stream + i) - '0';
1933                                         ast_debug(5, "is now %d\n", *result);
1934                                 } else {
1935                                         break;
1936                                 }
1937                         }
1938                         break;
1939                 default:
1940                         *result = *(stream + 1);
1941                 }
1942         } else {
1943                 *result = *stream;
1944                 *consumed = 1;
1945         }
1946         return 0;
1947 }
1948
1949 char *ast_get_encoded_str(const char *stream, char *result, size_t result_size)
1950 {
1951         char *cur = result;
1952         size_t consumed;
1953
1954         while (cur < result + result_size - 1 && !ast_get_encoded_char(stream, cur, &consumed)) {
1955                 cur++;
1956                 stream += consumed;
1957         }
1958         *cur = '\0';
1959         return result;
1960 }
1961
1962 int ast_str_get_encoded_str(struct ast_str **str, int maxlen, const char *stream)
1963 {
1964         char next, *buf;
1965         size_t offset = 0;
1966         size_t consumed;
1967
1968         if (strchr(stream, '\\')) {
1969                 while (!ast_get_encoded_char(stream, &next, &consumed)) {
1970                         if (offset + 2 > ast_str_size(*str) && maxlen > -1) {
1971                                 ast_str_make_space(str, maxlen > 0 ? maxlen : (ast_str_size(*str) + 48) * 2 - 48);
1972                         }
1973                         if (offset + 2 > ast_str_size(*str)) {
1974                                 break;
1975                         }
1976                         buf = ast_str_buffer(*str);
1977                         buf[offset++] = next;
1978                         stream += consumed;
1979                 }
1980                 buf = ast_str_buffer(*str);
1981                 buf[offset++] = '\0';
1982                 ast_str_update(*str);
1983         } else {
1984                 ast_str_set(str, maxlen, "%s", stream);
1985         }
1986         return 0;
1987 }
1988
1989 void ast_close_fds_above_n(int n)
1990 {
1991 #ifdef HAVE_CLOSEFROM
1992         closefrom(n + 1);
1993 #else
1994         int x, null;
1995         struct rlimit rl;
1996         getrlimit(RLIMIT_NOFILE, &rl);
1997         null = open("/dev/null", O_RDONLY);
1998         for (x = n + 1; x < rl.rlim_max; x++) {
1999                 if (x != null) {
2000                         /* Side effect of dup2 is that it closes any existing fd without error.
2001                          * This prevents valgrind and other debugging tools from sending up
2002                          * false error reports. */
2003                         while (dup2(null, x) < 0 && errno == EINTR);
2004                         close(x);
2005                 }
2006         }
2007         close(null);
2008 #endif
2009 }
2010
2011 int ast_safe_fork(int stop_reaper)
2012 {
2013         sigset_t signal_set, old_set;
2014         int pid;
2015
2016         /* Don't let the default signal handler for children reap our status */
2017         if (stop_reaper) {
2018                 ast_replace_sigchld();
2019         }
2020
2021         sigfillset(&signal_set);
2022         pthread_sigmask(SIG_BLOCK, &signal_set, &old_set);
2023
2024         pid = fork();
2025
2026         if (pid != 0) {
2027                 /* Fork failed or parent */
2028                 pthread_sigmask(SIG_SETMASK, &old_set, NULL);
2029                 return pid;
2030         } else {
2031                 /* Child */
2032 #ifdef HAVE_CAP
2033                 cap_t cap = cap_from_text("cap_net_admin-eip");
2034
2035                 if (cap_set_proc(cap)) {
2036                         ast_log(LOG_WARNING, "Unable to remove capabilities.\n");
2037                 }
2038                 cap_free(cap);
2039 #endif
2040
2041                 /* Before we unblock our signals, return our trapped signals back to the defaults */
2042                 signal(SIGHUP, SIG_DFL);
2043                 signal(SIGCHLD, SIG_DFL);
2044                 signal(SIGINT, SIG_DFL);
2045                 signal(SIGURG, SIG_DFL);
2046                 signal(SIGTERM, SIG_DFL);
2047                 signal(SIGPIPE, SIG_DFL);
2048                 signal(SIGXFSZ, SIG_DFL);
2049
2050                 /* unblock important signal handlers */
2051                 if (pthread_sigmask(SIG_UNBLOCK, &signal_set, NULL)) {
2052                         ast_log(LOG_WARNING, "unable to unblock signals: %s\n", strerror(errno));
2053                         _exit(1);
2054                 }
2055
2056                 return pid;
2057         }
2058 }
2059
2060 void ast_safe_fork_cleanup(void)
2061 {
2062         ast_unreplace_sigchld();
2063 }
2064