Ignore voicemail messages that are just silence.
[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 dspsilence = 0;
703         int rfmt = 0;
704         struct ast_silence_generator *silgen = NULL;
705         char prependfile[80];
706
707         if (silencethreshold < 0) {
708                 silencethreshold = global_silence_threshold;
709         }
710
711         if (maxsilence < 0) {
712                 maxsilence = global_maxsilence;
713         }
714
715         /* barf if no pointer passed to store duration in */
716         if (!duration) {
717                 ast_log(LOG_WARNING, "Error play_and_record called without duration pointer\n");
718                 return -1;
719         }
720
721         ast_debug(1, "play_and_record: %s, %s, '%s'\n", playfile ? playfile : "<None>", recordfile, fmt);
722         snprintf(comment, sizeof(comment), "Playing %s, Recording to: %s on %s\n", playfile ? playfile : "<None>", recordfile, chan->name);
723
724         if (playfile || beep) {
725                 if (!beep) {
726                         d = ast_play_and_wait(chan, playfile);
727                 }
728                 if (d > -1) {
729                         d = ast_stream_and_wait(chan, "beep", "");
730                 }
731                 if (d < 0) {
732                         return -1;
733                 }
734         }
735
736         if (prepend) {
737                 ast_copy_string(prependfile, recordfile, sizeof(prependfile));
738                 strncat(prependfile, "-prepend", sizeof(prependfile) - strlen(prependfile) - 1);
739         }
740
741         fmts = ast_strdupa(fmt);
742
743         stringp = fmts;
744         strsep(&stringp, "|");
745         ast_debug(1, "Recording Formats: sfmts=%s\n", fmts);
746         sfmt[0] = ast_strdupa(fmts);
747
748         while ((fmt = strsep(&stringp, "|"))) {
749                 if (fmtcnt > MAX_OTHER_FORMATS - 1) {
750                         ast_log(LOG_WARNING, "Please increase MAX_OTHER_FORMATS in app.c\n");
751                         break;
752                 }
753                 sfmt[fmtcnt++] = ast_strdupa(fmt);
754         }
755
756         end = start = time(NULL);  /* pre-initialize end to be same as start in case we never get into loop */
757         for (x = 0; x < fmtcnt; x++) {
758                 others[x] = ast_writefile(prepend ? prependfile : recordfile, sfmt[x], comment, O_TRUNC, 0, AST_FILE_MODE);
759                 ast_verb(3, "x=%d, open writing:  %s format: %s, %p\n", x, prepend ? prependfile : recordfile, sfmt[x], others[x]);
760
761                 if (!others[x]) {
762                         break;
763                 }
764         }
765
766         if (path) {
767                 ast_unlock_path(path);
768         }
769
770         if (maxsilence > 0) {
771                 sildet = ast_dsp_new(); /* Create the silence detector */
772                 if (!sildet) {
773                         ast_log(LOG_WARNING, "Unable to create silence detector :(\n");
774                         return -1;
775                 }
776                 ast_dsp_set_threshold(sildet, silencethreshold);
777                 rfmt = chan->readformat;
778                 res = ast_set_read_format(chan, AST_FORMAT_SLINEAR);
779                 if (res < 0) {
780                         ast_log(LOG_WARNING, "Unable to set to linear mode, giving up\n");
781                         ast_dsp_free(sildet);
782                         return -1;
783                 }
784         }
785
786         if (!prepend) {
787                 /* Request a video update */
788                 ast_indicate(chan, AST_CONTROL_VIDUPDATE);
789
790                 if (ast_opt_transmit_silence) {
791                         silgen = ast_channel_start_silence_generator(chan);
792                 }
793         }
794
795         if (x == fmtcnt) {
796                 /* Loop forever, writing the packets we read to the writer(s), until
797                    we read a digit or get a hangup */
798                 struct ast_frame *f;
799                 for (;;) {
800                         if (!(res = ast_waitfor(chan, 2000))) {
801                                 ast_debug(1, "One waitfor failed, trying another\n");
802                                 /* Try one more time in case of masq */
803                                 if (!(res = ast_waitfor(chan, 2000))) {
804                                         ast_log(LOG_WARNING, "No audio available on %s??\n", chan->name);
805                                         res = -1;
806                                 }
807                         }
808
809                         if (res < 0) {
810                                 f = NULL;
811                                 break;
812                         }
813                         if (!(f = ast_read(chan))) {
814                                 break;
815                         }
816                         if (f->frametype == AST_FRAME_VOICE) {
817                                 /* write each format */
818                                 for (x = 0; x < fmtcnt; x++) {
819                                         if (prepend && !others[x]) {
820                                                 break;
821                                         }
822                                         res = ast_writestream(others[x], f);
823                                 }
824
825                                 /* Silence Detection */
826                                 if (maxsilence > 0) {
827                                         dspsilence = 0;
828                                         ast_dsp_silence(sildet, f, &dspsilence);
829                                         totalsilence += dspsilence;
830
831                                         if (dspsilence > maxsilence) {
832                                                 /* Ended happily with silence */
833                                                 ast_verb(3, "Recording automatically stopped after a silence of %d seconds\n", dspsilence/1000);
834                                                 res = 'S';
835                                                 outmsg = 2;
836                                                 break;
837                                         }
838                                 }
839                                 /* Exit on any error */
840                                 if (res) {
841                                         ast_log(LOG_WARNING, "Error writing frame\n");
842                                         break;
843                                 }
844                         } else if (f->frametype == AST_FRAME_VIDEO) {
845                                 /* Write only once */
846                                 ast_writestream(others[0], f);
847                         } else if (f->frametype == AST_FRAME_DTMF) {
848                                 if (prepend) {
849                                 /* stop recording with any digit */
850                                         ast_verb(3, "User ended message by pressing %c\n", f->subclass);
851                                         res = 't';
852                                         outmsg = 2;
853                                         break;
854                                 }
855                                 if (strchr(acceptdtmf, f->subclass)) {
856                                         ast_verb(3, "User ended message by pressing %c\n", f->subclass);
857                                         res = f->subclass;
858                                         outmsg = 2;
859                                         break;
860                                 }
861                                 if (strchr(canceldtmf, f->subclass)) {
862                                         ast_verb(3, "User cancelled message by pressing %c\n", f->subclass);
863                                         res = f->subclass;
864                                         outmsg = 0;
865                                         break;
866                                 }
867                         }
868                         if (maxtime) {
869                                 end = time(NULL);
870                                 if (maxtime < (end - start)) {
871                                         ast_verb(3, "Took too long, cutting it short...\n");
872                                         res = 't';
873                                         outmsg = 2;
874                                         break;
875                                 }
876                         }
877                         ast_frfree(f);
878                 }
879                 if (!f) {
880                         ast_verb(3, "User hung up\n");
881                         res = -1;
882                         outmsg = 1;
883                 } else {
884                         ast_frfree(f);
885                 }
886         } else {
887                 ast_log(LOG_WARNING, "Error creating writestream '%s', format '%s'\n", recordfile, sfmt[x]);
888         }
889
890         if (!prepend) {
891                 if (silgen) {
892                         ast_channel_stop_silence_generator(chan, silgen);
893                 }
894         }
895
896         /*!\note
897          * Instead of asking how much time passed (end - start), calculate the number
898          * of seconds of audio which actually went into the file.  This fixes a
899          * problem where audio is stopped up on the network and never gets to us.
900          *
901          * Note that we still want to use the number of seconds passed for the max
902          * message, otherwise we could get a situation where this stream is never
903          * closed (which would create a resource leak).
904          */
905         *duration = others[0] ? ast_tellstream(others[0]) / 8000 : 0;
906
907         if (!prepend) {
908                 /* Reduce duration by a total silence amount */
909                 if (totalsilence > 0)
910                         *duration -= (totalsilence - 200) / 1000;
911                 if (*duration < 0) {
912                         *duration = 0;
913                 }
914                 for (x = 0; x < fmtcnt; x++) {
915                         if (!others[x]) {
916                                 break;
917                         }
918                         /*!\note
919                          * If we ended with silence, trim all but the first 200ms of silence
920                          * off the recording.  However, if we ended with '#', we don't want
921                          * to trim ANY part of the recording.
922                          */
923                         if (res > 0 && dspsilence) {
924                                 /* rewind only the trailing silence */
925                                 ast_stream_rewind(others[x], dspsilence - 200);
926                         }
927                         ast_truncstream(others[x]);
928                         ast_closestream(others[x]);
929                 }
930         }
931
932         if (prepend && outmsg) {
933                 struct ast_filestream *realfiles[MAX_OTHER_FORMATS];
934                 struct ast_frame *fr;
935
936                 for (x = 0; x < fmtcnt; x++) {
937                         snprintf(comment, sizeof(comment), "Opening the real file %s.%s\n", recordfile, sfmt[x]);
938                         realfiles[x] = ast_readfile(recordfile, sfmt[x], comment, O_RDONLY, 0, 0);
939                         if (!others[x] || !realfiles[x]) {
940                                 break;
941                         }
942                         /*!\note Same logic as above. */
943                         if (dspsilence) {
944                                 ast_stream_rewind(others[x], dspsilence - 200);
945                         }
946                         ast_truncstream(others[x]);
947                         /* add the original file too */
948                         while ((fr = ast_readframe(realfiles[x]))) {
949                                 ast_writestream(others[x], fr);
950                                 ast_frfree(fr);
951                         }
952                         ast_closestream(others[x]);
953                         ast_closestream(realfiles[x]);
954                         ast_filerename(prependfile, recordfile, sfmt[x]);
955                         ast_verb(4, "Recording Format: sfmts=%s, prependfile %s, recordfile %s\n", sfmt[x], prependfile, recordfile);
956                         ast_filedelete(prependfile, sfmt[x]);
957                 }
958         }
959         if (rfmt && ast_set_read_format(chan, rfmt)) {
960                 ast_log(LOG_WARNING, "Unable to restore format %s to channel '%s'\n", ast_getformatname(rfmt), chan->name);
961         }
962         if (outmsg == 2) {
963                 ast_stream_and_wait(chan, "auth-thankyou", "");
964         }
965         if (sildet) {
966                 ast_dsp_free(sildet);
967         }
968         return res;
969 }
970
971 static const char default_acceptdtmf[] = "#";
972 static const char default_canceldtmf[] = "";
973
974 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)
975 {
976         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));
977 }
978
979 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)
980 {
981         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, 0, silencethreshold, maxsilence, path, 0, default_acceptdtmf, default_canceldtmf);
982 }
983
984 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)
985 {
986         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, beep, silencethreshold, maxsilence, NULL, 1, default_acceptdtmf, default_canceldtmf);
987 }
988
989 /* Channel group core functions */
990
991 int ast_app_group_split_group(const char *data, char *group, int group_max, char *category, int category_max)
992 {
993         int res = 0;
994         char tmp[256];
995         char *grp = NULL, *cat = NULL;
996
997         if (!ast_strlen_zero(data)) {
998                 ast_copy_string(tmp, data, sizeof(tmp));
999                 grp = tmp;
1000                 if ((cat = strchr(tmp, '@'))) {
1001                         *cat++ = '\0';
1002                 }
1003         }
1004
1005         if (!ast_strlen_zero(grp)) {
1006                 ast_copy_string(group, grp, group_max);
1007         } else {
1008                 *group = '\0';
1009         }
1010
1011         if (!ast_strlen_zero(cat)) {
1012                 ast_copy_string(category, cat, category_max);
1013         }
1014
1015         return res;
1016 }
1017
1018 int ast_app_group_set_channel(struct ast_channel *chan, const char *data)
1019 {
1020         int res = 0;
1021         char group[80] = "", category[80] = "";
1022         struct ast_group_info *gi = NULL;
1023         size_t len = 0;
1024
1025         if (ast_app_group_split_group(data, group, sizeof(group), category, sizeof(category))) {
1026                 return -1;
1027         }
1028
1029         /* Calculate memory we will need if this is new */
1030         len = sizeof(*gi) + strlen(group) + 1;
1031         if (!ast_strlen_zero(category)) {
1032                 len += strlen(category) + 1;
1033         }
1034
1035         AST_RWLIST_WRLOCK(&groups);
1036         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&groups, gi, group_list) {
1037                 if ((gi->chan == chan) && ((ast_strlen_zero(category) && ast_strlen_zero(gi->category)) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
1038                         AST_RWLIST_REMOVE_CURRENT(group_list);
1039                         free(gi);
1040                         break;
1041                 }
1042         }
1043         AST_RWLIST_TRAVERSE_SAFE_END;
1044
1045         if (ast_strlen_zero(group)) {
1046                 /* Enable unsetting the group */
1047         } else if ((gi = calloc(1, len))) {
1048                 gi->chan = chan;
1049                 gi->group = (char *) gi + sizeof(*gi);
1050                 strcpy(gi->group, group);
1051                 if (!ast_strlen_zero(category)) {
1052                         gi->category = (char *) gi + sizeof(*gi) + strlen(group) + 1;
1053                         strcpy(gi->category, category);
1054                 }
1055                 AST_RWLIST_INSERT_TAIL(&groups, gi, group_list);
1056         } else {
1057                 res = -1;
1058         }
1059
1060         AST_RWLIST_UNLOCK(&groups);
1061
1062         return res;
1063 }
1064
1065 int ast_app_group_get_count(const char *group, const char *category)
1066 {
1067         struct ast_group_info *gi = NULL;
1068         int count = 0;
1069
1070         if (ast_strlen_zero(group)) {
1071                 return 0;
1072         }
1073
1074         AST_RWLIST_RDLOCK(&groups);
1075         AST_RWLIST_TRAVERSE(&groups, gi, group_list) {
1076                 if (!strcasecmp(gi->group, group) && (ast_strlen_zero(category) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
1077                         count++;
1078                 }
1079         }
1080         AST_RWLIST_UNLOCK(&groups);
1081
1082         return count;
1083 }
1084
1085 int ast_app_group_match_get_count(const char *groupmatch, const char *category)
1086 {
1087         struct ast_group_info *gi = NULL;
1088         regex_t regexbuf;
1089         int count = 0;
1090
1091         if (ast_strlen_zero(groupmatch)) {
1092                 return 0;
1093         }
1094
1095         /* if regex compilation fails, return zero matches */
1096         if (regcomp(&regexbuf, groupmatch, REG_EXTENDED | REG_NOSUB)) {
1097                 return 0;
1098         }
1099
1100         AST_RWLIST_RDLOCK(&groups);
1101         AST_RWLIST_TRAVERSE(&groups, gi, group_list) {
1102                 if (!regexec(&regexbuf, gi->group, 0, NULL, 0) && (ast_strlen_zero(category) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
1103                         count++;
1104                 }
1105         }
1106         AST_RWLIST_UNLOCK(&groups);
1107
1108         regfree(&regexbuf);
1109
1110         return count;
1111 }
1112
1113 int ast_app_group_update(struct ast_channel *old, struct ast_channel *new)
1114 {
1115         struct ast_group_info *gi = NULL;
1116
1117         AST_RWLIST_WRLOCK(&groups);
1118         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&groups, gi, group_list) {
1119                 if (gi->chan == old) {
1120                         gi->chan = new;
1121                 } else if (gi->chan == new) {
1122                         AST_RWLIST_REMOVE_CURRENT(group_list);
1123                         ast_free(gi);
1124                 }
1125         }
1126         AST_RWLIST_TRAVERSE_SAFE_END;
1127         AST_RWLIST_UNLOCK(&groups);
1128
1129         return 0;
1130 }
1131
1132 int ast_app_group_discard(struct ast_channel *chan)
1133 {
1134         struct ast_group_info *gi = NULL;
1135
1136         AST_RWLIST_WRLOCK(&groups);
1137         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&groups, gi, group_list) {
1138                 if (gi->chan == chan) {
1139                         AST_RWLIST_REMOVE_CURRENT(group_list);
1140                         ast_free(gi);
1141                 }
1142         }
1143         AST_RWLIST_TRAVERSE_SAFE_END;
1144         AST_RWLIST_UNLOCK(&groups);
1145
1146         return 0;
1147 }
1148
1149 int ast_app_group_list_wrlock(void)
1150 {
1151         return AST_RWLIST_WRLOCK(&groups);
1152 }
1153
1154 int ast_app_group_list_rdlock(void)
1155 {
1156         return AST_RWLIST_RDLOCK(&groups);
1157 }
1158
1159 struct ast_group_info *ast_app_group_list_head(void)
1160 {
1161         return AST_RWLIST_FIRST(&groups);
1162 }
1163
1164 int ast_app_group_list_unlock(void)
1165 {
1166         return AST_RWLIST_UNLOCK(&groups);
1167 }
1168
1169 unsigned int ast_app_separate_args(char *buf, char delim, char **array, int arraylen)
1170 {
1171         int argc;
1172         char *scan, *wasdelim = NULL;
1173         int paren = 0, quote = 0;
1174
1175         if (!buf || !array || !arraylen) {
1176                 return 0;
1177         }
1178
1179         memset(array, 0, arraylen * sizeof(*array));
1180
1181         scan = buf;
1182
1183         for (argc = 0; *scan && (argc < arraylen - 1); argc++) {
1184                 array[argc] = scan;
1185                 for (; *scan; scan++) {
1186                         if (*scan == '(') {
1187                                 paren++;
1188                         } else if (*scan == ')') {
1189                                 if (paren) {
1190                                         paren--;
1191                                 }
1192                         } else if (*scan == '"' && delim != '"') {
1193                                 quote = quote ? 0 : 1;
1194                                 /* Remove quote character from argument */
1195                                 memmove(scan, scan + 1, strlen(scan));
1196                                 scan--;
1197                         } else if (*scan == '\\') {
1198                                 /* Literal character, don't parse */
1199                                 memmove(scan, scan + 1, strlen(scan));
1200                         } else if ((*scan == delim) && !paren && !quote) {
1201                                 wasdelim = scan;
1202                                 *scan++ = '\0';
1203                                 break;
1204                         }
1205                 }
1206         }
1207
1208         /* If the last character in the original string was the delimiter, then
1209          * there is one additional argument. */
1210         if (*scan || (scan > buf && (scan - 1) == wasdelim)) {
1211                 array[argc++] = scan;
1212         }
1213
1214         return argc;
1215 }
1216
1217 static enum AST_LOCK_RESULT ast_lock_path_lockfile(const char *path)
1218 {
1219         char *s;
1220         char *fs;
1221         int res;
1222         int fd;
1223         int lp = strlen(path);
1224         time_t start;
1225
1226         s = alloca(lp + 10);
1227         fs = alloca(lp + 20);
1228
1229         snprintf(fs, strlen(path) + 19, "%s/.lock-%08lx", path, ast_random());
1230         fd = open(fs, O_WRONLY | O_CREAT | O_EXCL, AST_FILE_MODE);
1231         if (fd < 0) {
1232                 ast_log(LOG_ERROR, "Unable to create lock file '%s': %s\n", path, strerror(errno));
1233                 return AST_LOCK_PATH_NOT_FOUND;
1234         }
1235         close(fd);
1236
1237         snprintf(s, strlen(path) + 9, "%s/.lock", path);
1238         start = time(NULL);
1239         while (((res = link(fs, s)) < 0) && (errno == EEXIST) && (time(NULL) - start < 5)) {
1240                 sched_yield();
1241         }
1242
1243         unlink(fs);
1244
1245         if (res) {
1246                 ast_log(LOG_WARNING, "Failed to lock path '%s': %s\n", path, strerror(errno));
1247                 return AST_LOCK_TIMEOUT;
1248         } else {
1249                 ast_debug(1, "Locked path '%s'\n", path);
1250                 return AST_LOCK_SUCCESS;
1251         }
1252 }
1253
1254 static int ast_unlock_path_lockfile(const char *path)
1255 {
1256         char *s;
1257         int res;
1258
1259         s = alloca(strlen(path) + 10);
1260
1261         snprintf(s, strlen(path) + 9, "%s/%s", path, ".lock");
1262
1263         if ((res = unlink(s))) {
1264                 ast_log(LOG_ERROR, "Could not unlock path '%s': %s\n", path, strerror(errno));
1265         } else {
1266                 ast_debug(1, "Unlocked path '%s'\n", path);
1267         }
1268
1269         return res;
1270 }
1271
1272 struct path_lock {
1273         AST_LIST_ENTRY(path_lock) le;
1274         int fd;
1275         char *path;
1276 };
1277
1278 static AST_LIST_HEAD_STATIC(path_lock_list, path_lock);
1279
1280 static void path_lock_destroy(struct path_lock *obj)
1281 {
1282         if (obj->fd >= 0) {
1283                 close(obj->fd);
1284         }
1285         if (obj->path) {
1286                 free(obj->path);
1287         }
1288         free(obj);
1289 }
1290
1291 static enum AST_LOCK_RESULT ast_lock_path_flock(const char *path)
1292 {
1293         char *fs;
1294         int res;
1295         int fd;
1296         time_t start;
1297         struct path_lock *pl;
1298         struct stat st, ost;
1299
1300         fs = alloca(strlen(path) + 20);
1301
1302         snprintf(fs, strlen(path) + 19, "%s/lock", path);
1303         if (lstat(fs, &st) == 0) {
1304                 if ((st.st_mode & S_IFMT) == S_IFLNK) {
1305                         ast_log(LOG_WARNING, "Unable to create lock file "
1306                                         "'%s': it's already a symbolic link\n",
1307                                         fs);
1308                         return AST_LOCK_FAILURE;
1309                 }
1310                 if (st.st_nlink > 1) {
1311                         ast_log(LOG_WARNING, "Unable to create lock file "
1312                                         "'%s': %u hard links exist\n",
1313                                         fs, (unsigned int) st.st_nlink);
1314                         return AST_LOCK_FAILURE;
1315                 }
1316         }
1317         if ((fd = open(fs, O_WRONLY | O_CREAT, 0600)) < 0) {
1318                 ast_log(LOG_WARNING, "Unable to create lock file '%s': %s\n",
1319                                 fs, strerror(errno));
1320                 return AST_LOCK_PATH_NOT_FOUND;
1321         }
1322         if (!(pl = ast_calloc(1, sizeof(*pl)))) {
1323                 /* We don't unlink the lock file here, on the possibility that
1324                  * someone else created it - better to leave a little mess
1325                  * than create a big one by destroying someone else's lock
1326                  * and causing something to be corrupted.
1327                  */
1328                 close(fd);
1329                 return AST_LOCK_FAILURE;
1330         }
1331         pl->fd = fd;
1332         pl->path = strdup(path);
1333
1334         time(&start);
1335         while (
1336                 #ifdef SOLARIS
1337                 ((res = fcntl(pl->fd, F_SETLK, fcntl(pl->fd, F_GETFL) | O_NONBLOCK)) < 0) &&
1338                 #else
1339                 ((res = flock(pl->fd, LOCK_EX | LOCK_NB)) < 0) &&
1340                 #endif
1341                         (errno == EWOULDBLOCK) &&
1342                         (time(NULL) - start < 5))
1343                 usleep(1000);
1344         if (res) {
1345                 ast_log(LOG_WARNING, "Failed to lock path '%s': %s\n",
1346                                 path, strerror(errno));
1347                 /* No unlinking of lock done, since we tried and failed to
1348                  * flock() it.
1349                  */
1350                 path_lock_destroy(pl);
1351                 return AST_LOCK_TIMEOUT;
1352         }
1353
1354         /* Check for the race where the file is recreated or deleted out from
1355          * underneath us.
1356          */
1357         if (lstat(fs, &st) != 0 && fstat(pl->fd, &ost) != 0 &&
1358                         st.st_dev != ost.st_dev &&
1359                         st.st_ino != ost.st_ino) {
1360                 ast_log(LOG_WARNING, "Unable to create lock file '%s': "
1361                                 "file changed underneath us\n", fs);
1362                 path_lock_destroy(pl);
1363                 return AST_LOCK_FAILURE;
1364         }
1365
1366         /* Success: file created, flocked, and is the one we started with */
1367         AST_LIST_LOCK(&path_lock_list);
1368         AST_LIST_INSERT_TAIL(&path_lock_list, pl, le);
1369         AST_LIST_UNLOCK(&path_lock_list);
1370
1371         ast_debug(1, "Locked path '%s'\n", path);
1372
1373         return AST_LOCK_SUCCESS;
1374 }
1375
1376 static int ast_unlock_path_flock(const char *path)
1377 {
1378         char *s;
1379         struct path_lock *p;
1380
1381         s = alloca(strlen(path) + 20);
1382
1383         AST_LIST_LOCK(&path_lock_list);
1384         AST_LIST_TRAVERSE_SAFE_BEGIN(&path_lock_list, p, le) {
1385                 if (!strcmp(p->path, path)) {
1386                         AST_LIST_REMOVE_CURRENT(le);
1387                         break;
1388                 }
1389         }
1390         AST_LIST_TRAVERSE_SAFE_END;
1391         AST_LIST_UNLOCK(&path_lock_list);
1392
1393         if (p) {
1394                 snprintf(s, strlen(path) + 19, "%s/lock", path);
1395                 unlink(s);
1396                 path_lock_destroy(p);
1397                 ast_log(LOG_DEBUG, "Unlocked path '%s'\n", path);
1398         } else {
1399                 ast_log(LOG_DEBUG, "Failed to unlock path '%s': "
1400                                 "lock not found\n", path);
1401         }
1402
1403         return 0;
1404 }
1405
1406 void ast_set_lock_type(enum AST_LOCK_TYPE type)
1407 {
1408         ast_lock_type = type;
1409 }
1410
1411 enum AST_LOCK_RESULT ast_lock_path(const char *path)
1412 {
1413         enum AST_LOCK_RESULT r = AST_LOCK_FAILURE;
1414
1415         switch (ast_lock_type) {
1416         case AST_LOCK_TYPE_LOCKFILE:
1417                 r = ast_lock_path_lockfile(path);
1418                 break;
1419         case AST_LOCK_TYPE_FLOCK:
1420                 r = ast_lock_path_flock(path);
1421                 break;
1422         }
1423
1424         return r;
1425 }
1426
1427 int ast_unlock_path(const char *path)
1428 {
1429         int r = 0;
1430
1431         switch (ast_lock_type) {
1432         case AST_LOCK_TYPE_LOCKFILE:
1433                 r = ast_unlock_path_lockfile(path);
1434                 break;
1435         case AST_LOCK_TYPE_FLOCK:
1436                 r = ast_unlock_path_flock(path);
1437                 break;
1438         }
1439
1440         return r;
1441 }
1442
1443 int ast_record_review(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, const char *path) 
1444 {
1445         int silencethreshold;
1446         int maxsilence = 0;
1447         int res = 0;
1448         int cmd = 0;
1449         int max_attempts = 3;
1450         int attempts = 0;
1451         int recorded = 0;
1452         int message_exists = 0;
1453         /* Note that urgent and private are for flagging messages as such in the future */
1454
1455         /* barf if no pointer passed to store duration in */
1456         if (!duration) {
1457                 ast_log(LOG_WARNING, "Error ast_record_review called without duration pointer\n");
1458                 return -1;
1459         }
1460
1461         cmd = '3';       /* Want to start by recording */
1462
1463         silencethreshold = ast_dsp_get_threshold_from_settings(THRESHOLD_SILENCE);
1464
1465         while ((cmd >= 0) && (cmd != 't')) {
1466                 switch (cmd) {
1467                 case '1':
1468                         if (!message_exists) {
1469                                 /* In this case, 1 is to record a message */
1470                                 cmd = '3';
1471                                 break;
1472                         } else {
1473                                 ast_stream_and_wait(chan, "vm-msgsaved", "");
1474                                 cmd = 't';
1475                                 return res;
1476                         }
1477                 case '2':
1478                         /* Review */
1479                         ast_verb(3, "Reviewing the recording\n");
1480                         cmd = ast_stream_and_wait(chan, recordfile, AST_DIGIT_ANY);
1481                         break;
1482                 case '3':
1483                         message_exists = 0;
1484                         /* Record */
1485                         ast_verb(3, "R%secording\n", recorded == 1 ? "e-r" : "");
1486                         recorded = 1;
1487                         if ((cmd = ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, silencethreshold, maxsilence, path)) == -1) {
1488                                 /* User has hung up, no options to give */
1489                                 return cmd;
1490                         }
1491                         if (cmd == '0') {
1492                                 break;
1493                         } else if (cmd == '*') {
1494                                 break;
1495                         } else {
1496                                 /* If all is well, a message exists */
1497                                 message_exists = 1;
1498                                 cmd = 0;
1499                         }
1500                         break;
1501                 case '4':
1502                 case '5':
1503                 case '6':
1504                 case '7':
1505                 case '8':
1506                 case '9':
1507                 case '*':
1508                 case '#':
1509                         cmd = ast_play_and_wait(chan, "vm-sorry");
1510                         break;
1511                 default:
1512                         if (message_exists) {
1513                                 cmd = ast_play_and_wait(chan, "vm-review");
1514                         } else {
1515                                 if (!(cmd = ast_play_and_wait(chan, "vm-torerecord"))) {
1516                                         cmd = ast_waitfordigit(chan, 600);
1517                                 }
1518                         }
1519
1520                         if (!cmd) {
1521                                 cmd = ast_waitfordigit(chan, 6000);
1522                         }
1523                         if (!cmd) {
1524                                 attempts++;
1525                         }
1526                         if (attempts > max_attempts) {
1527                                 cmd = 't';
1528                         }
1529                 }
1530         }
1531         if (cmd == 't') {
1532                 cmd = 0;
1533         }
1534         return cmd;
1535 }
1536
1537 #define RES_UPONE (1 << 16)
1538 #define RES_EXIT  (1 << 17)
1539 #define RES_REPEAT (1 << 18)
1540 #define RES_RESTART ((1 << 19) | RES_REPEAT)
1541
1542 static int ast_ivr_menu_run_internal(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata);
1543
1544 static int ivr_dispatch(struct ast_channel *chan, struct ast_ivr_option *option, char *exten, void *cbdata)
1545 {
1546         int res;
1547         int (*ivr_func)(struct ast_channel *, void *);
1548         char *c;
1549         char *n;
1550
1551         switch (option->action) {
1552         case AST_ACTION_UPONE:
1553                 return RES_UPONE;
1554         case AST_ACTION_EXIT:
1555                 return RES_EXIT | (((unsigned long)(option->adata)) & 0xffff);
1556         case AST_ACTION_REPEAT:
1557                 return RES_REPEAT | (((unsigned long)(option->adata)) & 0xffff);
1558         case AST_ACTION_RESTART:
1559                 return RES_RESTART ;
1560         case AST_ACTION_NOOP:
1561                 return 0;
1562         case AST_ACTION_BACKGROUND:
1563                 res = ast_stream_and_wait(chan, (char *)option->adata, AST_DIGIT_ANY);
1564                 if (res < 0) {
1565                         ast_log(LOG_NOTICE, "Unable to find file '%s'!\n", (char *)option->adata);
1566                         res = 0;
1567                 }
1568                 return res;
1569         case AST_ACTION_PLAYBACK:
1570                 res = ast_stream_and_wait(chan, (char *)option->adata, "");
1571                 if (res < 0) {
1572                         ast_log(LOG_NOTICE, "Unable to find file '%s'!\n", (char *)option->adata);
1573                         res = 0;
1574                 }
1575                 return res;
1576         case AST_ACTION_MENU:
1577                 if ((res = ast_ivr_menu_run_internal(chan, (struct ast_ivr_menu *)option->adata, cbdata)) == -2) {
1578                         /* Do not pass entry errors back up, treat as though it was an "UPONE" */
1579                         res = 0;
1580                 }
1581                 return res;
1582         case AST_ACTION_WAITOPTION:
1583                 if (!(res = ast_waitfordigit(chan, chan->pbx ? chan->pbx->rtimeoutms : 10000))) {
1584                         return 't';
1585                 }
1586                 return res;
1587         case AST_ACTION_CALLBACK:
1588                 ivr_func = option->adata;
1589                 res = ivr_func(chan, cbdata);
1590                 return res;
1591         case AST_ACTION_TRANSFER:
1592                 res = ast_parseable_goto(chan, option->adata);
1593                 return 0;
1594         case AST_ACTION_PLAYLIST:
1595         case AST_ACTION_BACKLIST:
1596                 res = 0;
1597                 c = ast_strdupa(option->adata);
1598                 while ((n = strsep(&c, ";"))) {
1599                         if ((res = ast_stream_and_wait(chan, n,
1600                                         (option->action == AST_ACTION_BACKLIST) ? AST_DIGIT_ANY : ""))) {
1601                                 break;
1602                         }
1603                 }
1604                 ast_stopstream(chan);
1605                 return res;
1606         default:
1607                 ast_log(LOG_NOTICE, "Unknown dispatch function %d, ignoring!\n", option->action);
1608                 return 0;
1609         }
1610         return -1;
1611 }
1612
1613 static int option_exists(struct ast_ivr_menu *menu, char *option)
1614 {
1615         int x;
1616         for (x = 0; menu->options[x].option; x++) {
1617                 if (!strcasecmp(menu->options[x].option, option)) {
1618                         return x;
1619                 }
1620         }
1621         return -1;
1622 }
1623
1624 static int option_matchmore(struct ast_ivr_menu *menu, char *option)
1625 {
1626         int x;
1627         for (x = 0; menu->options[x].option; x++) {
1628                 if ((!strncasecmp(menu->options[x].option, option, strlen(option))) &&
1629                                 (menu->options[x].option[strlen(option)])) {
1630                         return x;
1631                 }
1632         }
1633         return -1;
1634 }
1635
1636 static int read_newoption(struct ast_channel *chan, struct ast_ivr_menu *menu, char *exten, int maxexten)
1637 {
1638         int res = 0;
1639         int ms;
1640         while (option_matchmore(menu, exten)) {
1641                 ms = chan->pbx ? chan->pbx->dtimeoutms : 5000;
1642                 if (strlen(exten) >= maxexten - 1) {
1643                         break;
1644                 }
1645                 if ((res = ast_waitfordigit(chan, ms)) < 1) {
1646                         break;
1647                 }
1648                 exten[strlen(exten) + 1] = '\0';
1649                 exten[strlen(exten)] = res;
1650         }
1651         return res > 0 ? 0 : res;
1652 }
1653
1654 static int ast_ivr_menu_run_internal(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata)
1655 {
1656         /* Execute an IVR menu structure */
1657         int res = 0;
1658         int pos = 0;
1659         int retries = 0;
1660         char exten[AST_MAX_EXTENSION] = "s";
1661         if (option_exists(menu, "s") < 0) {
1662                 strcpy(exten, "g");
1663                 if (option_exists(menu, "g") < 0) {
1664                         ast_log(LOG_WARNING, "No 's' nor 'g' extension in menu '%s'!\n", menu->title);
1665                         return -1;
1666                 }
1667         }
1668         while (!res) {
1669                 while (menu->options[pos].option) {
1670                         if (!strcasecmp(menu->options[pos].option, exten)) {
1671                                 res = ivr_dispatch(chan, menu->options + pos, exten, cbdata);
1672                                 ast_debug(1, "IVR Dispatch of '%s' (pos %d) yields %d\n", exten, pos, res);
1673                                 if (res < 0) {
1674                                         break;
1675                                 } else if (res & RES_UPONE) {
1676                                         return 0;
1677                                 } else if (res & RES_EXIT) {
1678                                         return res;
1679                                 } else if (res & RES_REPEAT) {
1680                                         int maxretries = res & 0xffff;
1681                                         if ((res & RES_RESTART) == RES_RESTART) {
1682                                                 retries = 0;
1683                                         } else {
1684                                                 retries++;
1685                                         }
1686                                         if (!maxretries) {
1687                                                 maxretries = 3;
1688                                         }
1689                                         if ((maxretries > 0) && (retries >= maxretries)) {
1690                                                 ast_debug(1, "Max retries %d exceeded\n", maxretries);
1691                                                 return -2;
1692                                         } else {
1693                                                 if (option_exists(menu, "g") > -1) {
1694                                                         strcpy(exten, "g");
1695                                                 } else if (option_exists(menu, "s") > -1) {
1696                                                         strcpy(exten, "s");
1697                                                 }
1698                                         }
1699                                         pos = 0;
1700                                         continue;
1701                                 } else if (res && strchr(AST_DIGIT_ANY, res)) {
1702                                         ast_debug(1, "Got start of extension, %c\n", res);
1703                                         exten[1] = '\0';
1704                                         exten[0] = res;
1705                                         if ((res = read_newoption(chan, menu, exten, sizeof(exten)))) {
1706                                                 break;
1707                                         }
1708                                         if (option_exists(menu, exten) < 0) {
1709                                                 if (option_exists(menu, "i")) {
1710                                                         ast_debug(1, "Invalid extension entered, going to 'i'!\n");
1711                                                         strcpy(exten, "i");
1712                                                         pos = 0;
1713                                                         continue;
1714                                                 } else {
1715                                                         ast_debug(1, "Aborting on invalid entry, with no 'i' option!\n");
1716                                                         res = -2;
1717                                                         break;
1718                                                 }
1719                                         } else {
1720                                                 ast_debug(1, "New existing extension: %s\n", exten);
1721                                                 pos = 0;
1722                                                 continue;
1723                                         }
1724                                 }
1725                         }
1726                         pos++;
1727                 }
1728                 ast_debug(1, "Stopping option '%s', res is %d\n", exten, res);
1729                 pos = 0;
1730                 if (!strcasecmp(exten, "s")) {
1731                         strcpy(exten, "g");
1732                 } else {
1733                         break;
1734                 }
1735         }
1736         return res;
1737 }
1738
1739 int ast_ivr_menu_run(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata)
1740 {
1741         int res = ast_ivr_menu_run_internal(chan, menu, cbdata);
1742         /* Hide internal coding */
1743         return res > 0 ? 0 : res;
1744 }
1745
1746 char *ast_read_textfile(const char *filename)
1747 {
1748         int fd, count = 0, res;
1749         char *output = NULL;
1750         struct stat filesize;
1751
1752         if (stat(filename, &filesize) == -1) {
1753                 ast_log(LOG_WARNING, "Error can't stat %s\n", filename);
1754                 return NULL;
1755         }
1756
1757         count = filesize.st_size + 1;
1758
1759         if ((fd = open(filename, O_RDONLY)) < 0) {
1760                 ast_log(LOG_WARNING, "Cannot open file '%s' for reading: %s\n", filename, strerror(errno));
1761                 return NULL;
1762         }
1763
1764         if ((output = ast_malloc(count))) {
1765                 res = read(fd, output, count - 1);
1766                 if (res == count - 1) {
1767                         output[res] = '\0';
1768                 } else {
1769                         ast_log(LOG_WARNING, "Short read of %s (%d of %d): %s\n", filename, res, count - 1, strerror(errno));
1770                         ast_free(output);
1771                         output = NULL;
1772                 }
1773         }
1774
1775         close(fd);
1776
1777         return output;
1778 }
1779
1780 int ast_app_parse_options(const struct ast_app_option *options, struct ast_flags *flags, char **args, char *optstr)
1781 {
1782         char *s, *arg;
1783         int curarg, res = 0;
1784         unsigned int argloc;
1785
1786         ast_clear_flag(flags, AST_FLAGS_ALL);
1787
1788         if (!optstr) {
1789                 return 0;
1790         }
1791
1792         s = optstr;
1793         while (*s) {
1794                 curarg = *s++ & 0x7f;   /* the array (in app.h) has 128 entries */
1795                 argloc = options[curarg].arg_index;
1796                 if (*s == '(') {
1797                         /* Has argument */
1798                         arg = ++s;
1799                         if ((s = strchr(s, ')'))) {
1800                                 if (argloc) {
1801                                         args[argloc - 1] = arg;
1802                                 }
1803                                 *s++ = '\0';
1804                         } else {
1805                                 ast_log(LOG_WARNING, "Missing closing parenthesis for argument '%c' in string '%s'\n", curarg, arg);
1806                                 res = -1;
1807                                 break;
1808                         }
1809                 } else if (argloc) {
1810                         args[argloc - 1] = "";
1811                 }
1812                 ast_set_flag(flags, options[curarg].flag);
1813         }
1814
1815         return res;
1816 }
1817
1818 /* the following function will probably only be used in app_dial, until app_dial is reorganized to
1819    better handle the large number of options it provides. After it is, you need to get rid of this variant 
1820    -- unless, of course, someone else digs up some use for large flag fields. */
1821
1822 int ast_app_parse_options64(const struct ast_app_option *options, struct ast_flags64 *flags, char **args, char *optstr)
1823 {
1824         char *s, *arg;
1825         int curarg, res = 0;
1826         unsigned int argloc;
1827
1828         flags->flags = 0;
1829
1830         if (!optstr) {
1831                 return 0;
1832         }
1833
1834         s = optstr;
1835         while (*s) {
1836                 curarg = *s++ & 0x7f;   /* the array (in app.h) has 128 entries */
1837                 ast_set_flag64(flags, options[curarg].flag);
1838                 argloc = options[curarg].arg_index;
1839                 if (*s == '(') {
1840                         /* Has argument */
1841                         arg = ++s;
1842                         if ((s = strchr(s, ')'))) {
1843                                 if (argloc) {
1844                                         args[argloc - 1] = arg;
1845                                 }
1846                                 *s++ = '\0';
1847                         } else {
1848                                 ast_log(LOG_WARNING, "Missing closing parenthesis for argument '%c' in string '%s'\n", curarg, arg);
1849                                 res = -1;
1850                                 break;
1851                         }
1852                 } else if (argloc) {
1853                         args[argloc - 1] = NULL;
1854                 }
1855         }
1856
1857         return res;
1858 }
1859
1860 void ast_app_options2str64(const struct ast_app_option *options, struct ast_flags64 *flags, char *buf, size_t len)
1861 {
1862         unsigned int i, found = 0;
1863         for (i = 32; i < 128 && found < len; i++) {
1864                 if (ast_test_flag64(flags, options[i].flag)) {
1865                         buf[found++] = i;
1866                 }
1867         }
1868         buf[found] = '\0';
1869 }
1870
1871 int ast_get_encoded_char(const char *stream, char *result, size_t *consumed)
1872 {
1873         int i;
1874         *consumed = 1;
1875         *result = 0;
1876         if (ast_strlen_zero(stream)) {
1877                 *consumed = 0;
1878                 return -1;
1879         }
1880
1881         if (*stream == '\\') {
1882                 *consumed = 2;
1883                 switch (*(stream + 1)) {
1884                 case 'n':
1885                         *result = '\n';
1886                         break;
1887                 case 'r':
1888                         *result = '\r';
1889                         break;
1890                 case 't':
1891                         *result = '\t';
1892                         break;
1893                 case 'x':
1894                         /* Hexadecimal */
1895                         if (strchr("0123456789ABCDEFabcdef", *(stream + 2)) && *(stream + 2) != '\0') {
1896                                 *consumed = 3;
1897                                 if (*(stream + 2) <= '9') {
1898                                         *result = *(stream + 2) - '0';
1899                                 } else if (*(stream + 2) <= 'F') {
1900                                         *result = *(stream + 2) - 'A' + 10;
1901                                 } else {
1902                                         *result = *(stream + 2) - 'a' + 10;
1903                                 }
1904                         } else {
1905                                 ast_log(LOG_ERROR, "Illegal character '%c' in hexadecimal string\n", *(stream + 2));
1906                                 return -1;
1907                         }
1908
1909                         if (strchr("0123456789ABCDEFabcdef", *(stream + 3)) && *(stream + 3) != '\0') {
1910                                 *consumed = 4;
1911                                 *result <<= 4;
1912                                 if (*(stream + 3) <= '9') {
1913                                         *result += *(stream + 3) - '0';
1914                                 } else if (*(stream + 3) <= 'F') {
1915                                         *result += *(stream + 3) - 'A' + 10;
1916                                 } else {
1917                                         *result += *(stream + 3) - 'a' + 10;
1918                                 }
1919                         }
1920                         break;
1921                 case '0':
1922                         /* Octal */
1923                         *consumed = 2;
1924                         for (i = 2; ; i++) {
1925                                 if (strchr("01234567", *(stream + i)) && *(stream + i) != '\0') {
1926                                         (*consumed)++;
1927                                         ast_debug(5, "result was %d, ", *result);
1928                                         *result <<= 3;
1929                                         *result += *(stream + i) - '0';
1930                                         ast_debug(5, "is now %d\n", *result);
1931                                 } else {
1932                                         break;
1933                                 }
1934                         }
1935                         break;
1936                 default:
1937                         *result = *(stream + 1);
1938                 }
1939         } else {
1940                 *result = *stream;
1941                 *consumed = 1;
1942         }
1943         return 0;
1944 }
1945
1946 char *ast_get_encoded_str(const char *stream, char *result, size_t result_size)
1947 {
1948         char *cur = result;
1949         size_t consumed;
1950
1951         while (cur < result + result_size - 1 && !ast_get_encoded_char(stream, cur, &consumed)) {
1952                 cur++;
1953                 stream += consumed;
1954         }
1955         *cur = '\0';
1956         return result;
1957 }
1958
1959 int ast_str_get_encoded_str(struct ast_str **str, int maxlen, const char *stream)
1960 {
1961         char next, *buf;
1962         size_t offset = 0;
1963         size_t consumed;
1964
1965         if (strchr(stream, '\\')) {
1966                 while (!ast_get_encoded_char(stream, &next, &consumed)) {
1967                         if (offset + 2 > ast_str_size(*str) && maxlen > -1) {
1968                                 ast_str_make_space(str, maxlen > 0 ? maxlen : (ast_str_size(*str) + 48) * 2 - 48);
1969                         }
1970                         if (offset + 2 > ast_str_size(*str)) {
1971                                 break;
1972                         }
1973                         buf = ast_str_buffer(*str);
1974                         buf[offset++] = next;
1975                         stream += consumed;
1976                 }
1977                 buf = ast_str_buffer(*str);
1978                 buf[offset++] = '\0';
1979                 ast_str_update(*str);
1980         } else {
1981                 ast_str_set(str, maxlen, "%s", stream);
1982         }
1983         return 0;
1984 }
1985
1986 void ast_close_fds_above_n(int n)
1987 {
1988 #ifdef HAVE_CLOSEFROM
1989         closefrom(n + 1);
1990 #else
1991         int x, null;
1992         struct rlimit rl;
1993         getrlimit(RLIMIT_NOFILE, &rl);
1994         null = open("/dev/null", O_RDONLY);
1995         for (x = n + 1; x < rl.rlim_max; x++) {
1996                 if (x != null) {
1997                         /* Side effect of dup2 is that it closes any existing fd without error.
1998                          * This prevents valgrind and other debugging tools from sending up
1999                          * false error reports. */
2000                         while (dup2(null, x) < 0 && errno == EINTR);
2001                         close(x);
2002                 }
2003         }
2004         close(null);
2005 #endif
2006 }
2007
2008 int ast_safe_fork(int stop_reaper)
2009 {
2010         sigset_t signal_set, old_set;
2011         int pid;
2012
2013         /* Don't let the default signal handler for children reap our status */
2014         if (stop_reaper) {
2015                 ast_replace_sigchld();
2016         }
2017
2018         sigfillset(&signal_set);
2019         pthread_sigmask(SIG_BLOCK, &signal_set, &old_set);
2020
2021         pid = fork();
2022
2023         if (pid != 0) {
2024                 /* Fork failed or parent */
2025                 pthread_sigmask(SIG_SETMASK, &old_set, NULL);
2026                 return pid;
2027         } else {
2028                 /* Child */
2029 #ifdef HAVE_CAP
2030                 cap_t cap = cap_from_text("cap_net_admin-eip");
2031
2032                 if (cap_set_proc(cap)) {
2033                         ast_log(LOG_WARNING, "Unable to remove capabilities.\n");
2034                 }
2035                 cap_free(cap);
2036 #endif
2037
2038                 /* Before we unblock our signals, return our trapped signals back to the defaults */
2039                 signal(SIGHUP, SIG_DFL);
2040                 signal(SIGCHLD, SIG_DFL);
2041                 signal(SIGINT, SIG_DFL);
2042                 signal(SIGURG, SIG_DFL);
2043                 signal(SIGTERM, SIG_DFL);
2044                 signal(SIGPIPE, SIG_DFL);
2045                 signal(SIGXFSZ, SIG_DFL);
2046
2047                 /* unblock important signal handlers */
2048                 if (pthread_sigmask(SIG_UNBLOCK, &signal_set, NULL)) {
2049                         ast_log(LOG_WARNING, "unable to unblock signals: %s\n", strerror(errno));
2050                         _exit(1);
2051                 }
2052
2053                 return pid;
2054         }
2055 }
2056
2057 void ast_safe_fork_cleanup(void)
2058 {
2059         ast_unreplace_sigchld();
2060 }
2061