89f5f77c1711678577d369ad31629664c3608e3d
[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 /** \example
27  * \par This is an example of how to develop an app.
28  * Application Skeleton is an example of creating an application for Asterisk.
29  * \verbinclude app_skel.c
30  */
31
32 /*** MODULEINFO
33         <support_level>core</support_level>
34  ***/
35
36 #include "asterisk.h"
37
38 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
39
40 #ifdef HAVE_SYS_STAT_H
41 #include <sys/stat.h>
42 #endif
43 #include <regex.h>          /* for regcomp(3) */
44 #include <sys/file.h>       /* for flock(2) */
45 #include <signal.h>         /* for pthread_sigmask(3) */
46 #include <stdlib.h>         /* for closefrom(3) */
47 #include <sys/types.h>
48 #include <sys/wait.h>       /* for waitpid(2) */
49 #ifndef HAVE_CLOSEFROM
50 #include <dirent.h>         /* for opendir(3)   */
51 #endif
52 #ifdef HAVE_CAP
53 #include <sys/capability.h>
54 #endif /* HAVE_CAP */
55
56 #include "asterisk/paths.h"     /* use ast_config_AST_DATA_DIR */
57 #include "asterisk/channel.h"
58 #include "asterisk/pbx.h"
59 #include "asterisk/file.h"
60 #include "asterisk/app.h"
61 #include "asterisk/dsp.h"
62 #include "asterisk/utils.h"
63 #include "asterisk/lock.h"
64 #include "asterisk/indications.h"
65 #include "asterisk/linkedlists.h"
66 #include "asterisk/threadstorage.h"
67 #include "asterisk/test.h"
68 #include "asterisk/module.h"
69 #include "asterisk/astobj2.h"
70 #include "asterisk/stasis.h"
71 #include "asterisk/stasis_channels.h"
72 #include "asterisk/json.h"
73 #include "asterisk/format_cache.h"
74
75 #define MWI_TOPIC_BUCKETS 57
76
77 AST_THREADSTORAGE_PUBLIC(ast_str_thread_global_buf);
78
79 static pthread_t shaun_of_the_dead_thread = AST_PTHREADT_NULL;
80
81 struct zombie {
82         pid_t pid;
83         AST_LIST_ENTRY(zombie) list;
84 };
85
86 static AST_LIST_HEAD_STATIC(zombies, zombie);
87
88 /*
89  * @{ \brief Define \ref stasis topic objects
90  */
91 static struct stasis_topic *mwi_topic_all;
92 static struct stasis_cache *mwi_state_cache;
93 static struct stasis_caching_topic *mwi_topic_cached;
94 static struct stasis_topic_pool *mwi_topic_pool;
95
96 static struct stasis_topic *queue_topic_all;
97 static struct stasis_topic_pool *queue_topic_pool;
98 /* @} */
99
100 /*! \brief Convert a MWI \ref stasis_message to a \ref ast_event */
101 static struct ast_event *mwi_to_event(struct stasis_message *message)
102 {
103         struct ast_event *event;
104         struct ast_mwi_state *mwi_state;
105         char *mailbox;
106         char *context;
107
108         if (!message) {
109                 return NULL;
110         }
111
112         mwi_state = stasis_message_data(message);
113
114         /* Strip off @context */
115         context = mailbox = ast_strdupa(mwi_state->uniqueid);
116         strsep(&context, "@");
117         if (ast_strlen_zero(context)) {
118                 context = "default";
119         }
120
121         event = ast_event_new(AST_EVENT_MWI,
122                                 AST_EVENT_IE_MAILBOX, AST_EVENT_IE_PLTYPE_STR, mailbox,
123                                 AST_EVENT_IE_CONTEXT, AST_EVENT_IE_PLTYPE_STR, context,
124                                 AST_EVENT_IE_NEWMSGS, AST_EVENT_IE_PLTYPE_UINT, mwi_state->new_msgs,
125                                 AST_EVENT_IE_OLDMSGS, AST_EVENT_IE_PLTYPE_UINT, mwi_state->old_msgs,
126                                 AST_EVENT_IE_EID, AST_EVENT_IE_PLTYPE_RAW, &mwi_state->eid, sizeof(mwi_state->eid),
127                                 AST_EVENT_IE_END);
128
129         return event;
130 }
131
132 /*
133  * @{ \brief Define \ref stasis message types for MWI
134  */
135 STASIS_MESSAGE_TYPE_DEFN(ast_mwi_state_type,
136         .to_event = mwi_to_event, );
137 STASIS_MESSAGE_TYPE_DEFN(ast_mwi_vm_app_type);
138 /* @} */
139
140
141
142 static void *shaun_of_the_dead(void *data)
143 {
144         struct zombie *cur;
145         int status;
146         for (;;) {
147                 if (!AST_LIST_EMPTY(&zombies)) {
148                         /* Don't allow cancellation while we have a lock. */
149                         pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, NULL);
150                         AST_LIST_LOCK(&zombies);
151                         AST_LIST_TRAVERSE_SAFE_BEGIN(&zombies, cur, list) {
152                                 if (waitpid(cur->pid, &status, WNOHANG) != 0) {
153                                         AST_LIST_REMOVE_CURRENT(list);
154                                         ast_free(cur);
155                                 }
156                         }
157                         AST_LIST_TRAVERSE_SAFE_END
158                         AST_LIST_UNLOCK(&zombies);
159                         pthread_setcancelstate(PTHREAD_CANCEL_ENABLE, NULL);
160                 }
161                 pthread_testcancel();
162                 /* Wait for 60 seconds, without engaging in a busy loop. */
163                 ast_poll(NULL, 0, AST_LIST_FIRST(&zombies) ? 5000 : 60000);
164         }
165         return NULL;
166 }
167
168
169 #define AST_MAX_FORMATS 10
170
171 static AST_RWLIST_HEAD_STATIC(groups, ast_group_info);
172
173 /*!
174  * \brief This function presents a dialtone and reads an extension into 'collect'
175  * which must be a pointer to a **pre-initialized** array of char having a
176  * size of 'size' suitable for writing to.  It will collect no more than the smaller
177  * of 'maxlen' or 'size' minus the original strlen() of collect digits.
178  * \param chan struct.
179  * \param context
180  * \param collect
181  * \param size
182  * \param maxlen
183  * \param timeout timeout in milliseconds
184  *
185  * \return 0 if extension does not exist, 1 if extension exists
186 */
187 int ast_app_dtget(struct ast_channel *chan, const char *context, char *collect, size_t size, int maxlen, int timeout)
188 {
189         struct ast_tone_zone_sound *ts;
190         int res = 0, x = 0;
191
192         if (maxlen > size) {
193                 maxlen = size;
194         }
195
196         if (!timeout) {
197                 if (ast_channel_pbx(chan) && ast_channel_pbx(chan)->dtimeoutms) {
198                         timeout = ast_channel_pbx(chan)->dtimeoutms;
199                 } else {
200                         timeout = 5000;
201                 }
202         }
203
204         if ((ts = ast_get_indication_tone(ast_channel_zone(chan), "dial"))) {
205                 res = ast_playtones_start(chan, 0, ts->data, 0);
206                 ts = ast_tone_zone_sound_unref(ts);
207         } else {
208                 ast_log(LOG_NOTICE, "Huh....? no dial for indications?\n");
209         }
210
211         for (x = strlen(collect); x < maxlen; ) {
212                 res = ast_waitfordigit(chan, timeout);
213                 if (!ast_ignore_pattern(context, collect)) {
214                         ast_playtones_stop(chan);
215                 }
216                 if (res < 1) {
217                         break;
218                 }
219                 if (res == '#') {
220                         break;
221                 }
222                 collect[x++] = res;
223                 if (!ast_matchmore_extension(chan, context, collect, 1,
224                         S_COR(ast_channel_caller(chan)->id.number.valid, ast_channel_caller(chan)->id.number.str, NULL))) {
225                         break;
226                 }
227         }
228
229         if (res >= 0) {
230                 res = ast_exists_extension(chan, context, collect, 1,
231                         S_COR(ast_channel_caller(chan)->id.number.valid, ast_channel_caller(chan)->id.number.str, NULL)) ? 1 : 0;
232         }
233
234         return res;
235 }
236
237 /*!
238  * \brief ast_app_getdata
239  * \param c The channel to read from
240  * \param prompt The file to stream to the channel
241  * \param s The string to read in to.  Must be at least the size of your length
242  * \param maxlen How many digits to read (maximum)
243  * \param timeout set timeout to 0 for "standard" timeouts. Set timeout to -1 for
244  *      "ludicrous time" (essentially never times out) */
245 enum ast_getdata_result ast_app_getdata(struct ast_channel *c, const char *prompt, char *s, int maxlen, int timeout)
246 {
247         int res = 0, to, fto;
248         char *front, *filename;
249
250         /* XXX Merge with full version? XXX */
251
252         if (maxlen)
253                 s[0] = '\0';
254
255         if (!prompt)
256                 prompt = "";
257
258         filename = ast_strdupa(prompt);
259         while ((front = strsep(&filename, "&"))) {
260                 if (!ast_strlen_zero(front)) {
261                         res = ast_streamfile(c, front, ast_channel_language(c));
262                         if (res)
263                                 continue;
264                 }
265                 if (ast_strlen_zero(filename)) {
266                         /* set timeouts for the last prompt */
267                         fto = ast_channel_pbx(c) ? ast_channel_pbx(c)->rtimeoutms : 6000;
268                         to = ast_channel_pbx(c) ? ast_channel_pbx(c)->dtimeoutms : 2000;
269
270                         if (timeout > 0) {
271                                 fto = to = timeout;
272                         }
273                         if (timeout < 0) {
274                                 fto = to = 1000000000;
275                         }
276                 } else {
277                         /* there is more than one prompt, so
278                          * get rid of the long timeout between
279                          * prompts, and make it 50ms */
280                         fto = 50;
281                         to = ast_channel_pbx(c) ? ast_channel_pbx(c)->dtimeoutms : 2000;
282                 }
283                 res = ast_readstring(c, s, maxlen, to, fto, "#");
284                 if (res == AST_GETDATA_EMPTY_END_TERMINATED) {
285                         return res;
286                 }
287                 if (!ast_strlen_zero(s)) {
288                         return res;
289                 }
290         }
291
292         return res;
293 }
294
295 /* The lock type used by ast_lock_path() / ast_unlock_path() */
296 static enum AST_LOCK_TYPE ast_lock_type = AST_LOCK_TYPE_LOCKFILE;
297
298 int ast_app_getdata_full(struct ast_channel *c, const char *prompt, char *s, int maxlen, int timeout, int audiofd, int ctrlfd)
299 {
300         int res, to = 2000, fto = 6000;
301
302         if (!ast_strlen_zero(prompt)) {
303                 res = ast_streamfile(c, prompt, ast_channel_language(c));
304                 if (res < 0) {
305                         return res;
306                 }
307         }
308
309         if (timeout > 0) {
310                 fto = to = timeout;
311         }
312         if (timeout < 0) {
313                 fto = to = 1000000000;
314         }
315
316         res = ast_readstring_full(c, s, maxlen, to, fto, "#", audiofd, ctrlfd);
317
318         return res;
319 }
320
321 int ast_app_exec_macro(struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const char *macro_args)
322 {
323         struct ast_app *macro_app;
324         int res;
325
326         macro_app = pbx_findapp("Macro");
327         if (!macro_app) {
328                 ast_log(LOG_WARNING,
329                         "Cannot run 'Macro(%s)'.  The application is not available.\n", macro_args);
330                 return -1;
331         }
332         if (autoservice_chan) {
333                 ast_autoservice_start(autoservice_chan);
334         }
335
336         ast_debug(4, "%s Original location: %s,%s,%d\n", ast_channel_name(macro_chan),
337                 ast_channel_context(macro_chan), ast_channel_exten(macro_chan),
338                 ast_channel_priority(macro_chan));
339
340         res = pbx_exec(macro_chan, macro_app, macro_args);
341         ast_debug(4, "Macro exited with status %d\n", res);
342
343         /*
344          * Assume anything negative from Macro is an error.
345          * Anything else is success.
346          */
347         if (res < 0) {
348                 res = -1;
349         } else {
350                 res = 0;
351         }
352
353         ast_debug(4, "%s Ending location: %s,%s,%d\n", ast_channel_name(macro_chan),
354                 ast_channel_context(macro_chan), ast_channel_exten(macro_chan),
355                 ast_channel_priority(macro_chan));
356
357         if (autoservice_chan) {
358                 ast_autoservice_stop(autoservice_chan);
359         }
360         return res;
361 }
362
363 int ast_app_run_macro(struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const char *macro_name, const char *macro_args)
364 {
365         int res;
366         char *args_str;
367         size_t args_len;
368
369         if (ast_strlen_zero(macro_args)) {
370                 return ast_app_exec_macro(autoservice_chan, macro_chan, macro_name);
371         }
372
373         /* Create the Macro application argument string. */
374         args_len = strlen(macro_name) + strlen(macro_args) + 2;
375         args_str = ast_malloc(args_len);
376         if (!args_str) {
377                 return -1;
378         }
379         snprintf(args_str, args_len, "%s,%s", macro_name, macro_args);
380
381         res = ast_app_exec_macro(autoservice_chan, macro_chan, args_str);
382         ast_free(args_str);
383         return res;
384 }
385
386 static const struct ast_app_stack_funcs *app_stack_callbacks;
387
388 void ast_install_stack_functions(const struct ast_app_stack_funcs *funcs)
389 {
390         app_stack_callbacks = funcs;
391 }
392
393 const char *ast_app_expand_sub_args(struct ast_channel *chan, const char *args)
394 {
395         const struct ast_app_stack_funcs *funcs;
396         const char *new_args;
397
398         funcs = app_stack_callbacks;
399         if (!funcs || !funcs->expand_sub_args) {
400                 ast_log(LOG_WARNING,
401                         "Cannot expand 'Gosub(%s)' arguments.  The app_stack module is not available.\n",
402                         args);
403                 return NULL;
404         }
405         ast_module_ref(funcs->module);
406
407         new_args = funcs->expand_sub_args(chan, args);
408         ast_module_unref(funcs->module);
409         return new_args;
410 }
411
412 int ast_app_exec_sub(struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const char *sub_args, int ignore_hangup)
413 {
414         const struct ast_app_stack_funcs *funcs;
415         int res;
416
417         funcs = app_stack_callbacks;
418         if (!funcs || !funcs->run_sub) {
419                 ast_log(LOG_WARNING,
420                         "Cannot run 'Gosub(%s)'.  The app_stack module is not available.\n",
421                         sub_args);
422                 return -1;
423         }
424         ast_module_ref(funcs->module);
425
426         if (autoservice_chan) {
427                 ast_autoservice_start(autoservice_chan);
428         }
429
430         res = funcs->run_sub(sub_chan, sub_args, ignore_hangup);
431         ast_module_unref(funcs->module);
432
433         if (autoservice_chan) {
434                 ast_autoservice_stop(autoservice_chan);
435         }
436         return res;
437 }
438
439 int ast_app_run_sub(struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const char *sub_location, const char *sub_args, int ignore_hangup)
440 {
441         int res;
442         char *args_str;
443         size_t args_len;
444
445         if (ast_strlen_zero(sub_args)) {
446                 return ast_app_exec_sub(autoservice_chan, sub_chan, sub_location, ignore_hangup);
447         }
448
449         /* Create the Gosub application argument string. */
450         args_len = strlen(sub_location) + strlen(sub_args) + 3;
451         args_str = ast_malloc(args_len);
452         if (!args_str) {
453                 return -1;
454         }
455         snprintf(args_str, args_len, "%s(%s)", sub_location, sub_args);
456
457         res = ast_app_exec_sub(autoservice_chan, sub_chan, args_str, ignore_hangup);
458         ast_free(args_str);
459         return res;
460 }
461
462 /*! \brief The container for the voicemail provider */
463 static AO2_GLOBAL_OBJ_STATIC(vm_provider);
464
465 /*! Voicemail not registered warning */
466 static int vm_warnings;
467
468 int ast_vm_is_registered(void)
469 {
470         struct ast_vm_functions *table;
471         int is_registered;
472
473         table = ao2_global_obj_ref(vm_provider);
474         is_registered = table ? 1 : 0;
475         ao2_cleanup(table);
476         return is_registered;
477 }
478
479 int __ast_vm_register(const struct ast_vm_functions *vm_table, struct ast_module *module)
480 {
481         RAII_VAR(struct ast_vm_functions *, table, NULL, ao2_cleanup);
482
483         if (!vm_table->module_name) {
484                 ast_log(LOG_ERROR, "Voicemail provider missing required information.\n");
485                 return -1;
486         }
487         if (vm_table->module_version != VM_MODULE_VERSION) {
488                 ast_log(LOG_ERROR, "Voicemail provider '%s' has incorrect version\n",
489                         vm_table->module_name);
490                 return -1;
491         }
492
493         table = ao2_global_obj_ref(vm_provider);
494         if (table) {
495                 ast_log(LOG_WARNING, "Voicemail provider already registered by %s.\n",
496                         table->module_name);
497                 return -1;
498         }
499
500         table = ao2_alloc_options(sizeof(*table), NULL, AO2_ALLOC_OPT_LOCK_NOLOCK);
501         if (!table) {
502                 return -1;
503         }
504         *table = *vm_table;
505         table->module = module;
506
507         ao2_global_obj_replace_unref(vm_provider, table);
508         return 0;
509 }
510
511 void ast_vm_unregister(const char *module_name)
512 {
513         struct ast_vm_functions *table;
514
515         table = ao2_global_obj_ref(vm_provider);
516         if (table && !strcmp(table->module_name, module_name)) {
517                 ao2_global_obj_release(vm_provider);
518         }
519         ao2_cleanup(table);
520 }
521
522 /*! \brief The container for the voicemail greeter provider */
523 static AO2_GLOBAL_OBJ_STATIC(vm_greeter_provider);
524
525 /*! Voicemail greeter not registered warning */
526 static int vm_greeter_warnings;
527
528 int ast_vm_greeter_is_registered(void)
529 {
530         struct ast_vm_greeter_functions *table;
531         int is_registered;
532
533         table = ao2_global_obj_ref(vm_greeter_provider);
534         is_registered = table ? 1 : 0;
535         ao2_cleanup(table);
536         return is_registered;
537 }
538
539 int __ast_vm_greeter_register(const struct ast_vm_greeter_functions *vm_table, struct ast_module *module)
540 {
541         RAII_VAR(struct ast_vm_greeter_functions *, table, NULL, ao2_cleanup);
542
543         if (!vm_table->module_name) {
544                 ast_log(LOG_ERROR, "Voicemail greeter provider missing required information.\n");
545                 return -1;
546         }
547         if (vm_table->module_version != VM_GREETER_MODULE_VERSION) {
548                 ast_log(LOG_ERROR, "Voicemail greeter provider '%s' has incorrect version\n",
549                         vm_table->module_name);
550                 return -1;
551         }
552
553         table = ao2_global_obj_ref(vm_greeter_provider);
554         if (table) {
555                 ast_log(LOG_WARNING, "Voicemail greeter provider already registered by %s.\n",
556                         table->module_name);
557                 return -1;
558         }
559
560         table = ao2_alloc_options(sizeof(*table), NULL, AO2_ALLOC_OPT_LOCK_NOLOCK);
561         if (!table) {
562                 return -1;
563         }
564         *table = *vm_table;
565         table->module = module;
566
567         ao2_global_obj_replace_unref(vm_greeter_provider, table);
568         return 0;
569 }
570
571 void ast_vm_greeter_unregister(const char *module_name)
572 {
573         struct ast_vm_greeter_functions *table;
574
575         table = ao2_global_obj_ref(vm_greeter_provider);
576         if (table && !strcmp(table->module_name, module_name)) {
577                 ao2_global_obj_release(vm_greeter_provider);
578         }
579         ao2_cleanup(table);
580 }
581
582 #ifdef TEST_FRAMEWORK
583 static ast_vm_test_create_user_fn *ast_vm_test_create_user_func = NULL;
584 static ast_vm_test_destroy_user_fn *ast_vm_test_destroy_user_func = NULL;
585
586 void ast_install_vm_test_functions(ast_vm_test_create_user_fn *vm_test_create_user_func,
587         ast_vm_test_destroy_user_fn *vm_test_destroy_user_func)
588 {
589         ast_vm_test_create_user_func = vm_test_create_user_func;
590         ast_vm_test_destroy_user_func = vm_test_destroy_user_func;
591 }
592
593 void ast_uninstall_vm_test_functions(void)
594 {
595         ast_vm_test_create_user_func = NULL;
596         ast_vm_test_destroy_user_func = NULL;
597 }
598 #endif
599
600 static void vm_warn_no_provider(void)
601 {
602         if (vm_warnings++ % 10 == 0) {
603                 ast_verb(3, "No voicemail provider registered.\n");
604         }
605 }
606
607 #define VM_API_CALL(res, api_call, api_parms)                                                           \
608         do {                                                                                                                                    \
609                 struct ast_vm_functions *table;                                                                         \
610                 table = ao2_global_obj_ref(vm_provider);                                                        \
611                 if (!table) {                                                                                                           \
612                         vm_warn_no_provider();                                                                                  \
613                 } else if (table->api_call) {                                                                           \
614                         ast_module_ref(table->module);                                                                  \
615                         (res) = table->api_call api_parms;                                                              \
616                         ast_module_unref(table->module);                                                                \
617                 }                                                                                                                                       \
618                 ao2_cleanup(table);                                                                                                     \
619         } while (0)
620
621 static void vm_greeter_warn_no_provider(void)
622 {
623         if (vm_greeter_warnings++ % 10 == 0) {
624                 ast_verb(3, "No voicemail greeter provider registered.\n");
625         }
626 }
627
628 #define VM_GREETER_API_CALL(res, api_call, api_parms)                                           \
629         do {                                                                                                                                    \
630                 struct ast_vm_greeter_functions *table;                                                         \
631                 table = ao2_global_obj_ref(vm_greeter_provider);                                        \
632                 if (!table) {                                                                                                           \
633                         vm_greeter_warn_no_provider();                                                                  \
634                 } else if (table->api_call) {                                                                           \
635                         ast_module_ref(table->module);                                                                  \
636                         (res) = table->api_call api_parms;                                                              \
637                         ast_module_unref(table->module);                                                                \
638                 }                                                                                                                                       \
639                 ao2_cleanup(table);                                                                                                     \
640         } while (0)
641
642 int ast_app_has_voicemail(const char *mailboxes, const char *folder)
643 {
644         int res = 0;
645
646         VM_API_CALL(res, has_voicemail, (mailboxes, folder));
647         return res;
648 }
649
650 /*!
651  * \internal
652  * \brief Function used as a callback for ast_copy_recording_to_vm when a real one isn't installed.
653  * \param vm_rec_data Stores crucial information about the voicemail that will basically just be used
654  * to figure out what the name of the recipient was supposed to be
655  */
656 int ast_app_copy_recording_to_vm(struct ast_vm_recording_data *vm_rec_data)
657 {
658         int res = -1;
659
660         VM_API_CALL(res, copy_recording_to_vm, (vm_rec_data));
661         return res;
662 }
663
664 int ast_app_inboxcount(const char *mailboxes, int *newmsgs, int *oldmsgs)
665 {
666         int res = 0;
667
668         if (newmsgs) {
669                 *newmsgs = 0;
670         }
671         if (oldmsgs) {
672                 *oldmsgs = 0;
673         }
674
675         VM_API_CALL(res, inboxcount, (mailboxes, newmsgs, oldmsgs));
676         return res;
677 }
678
679 int ast_app_inboxcount2(const char *mailboxes, int *urgentmsgs, int *newmsgs, int *oldmsgs)
680 {
681         int res = 0;
682
683         if (newmsgs) {
684                 *newmsgs = 0;
685         }
686         if (oldmsgs) {
687                 *oldmsgs = 0;
688         }
689         if (urgentmsgs) {
690                 *urgentmsgs = 0;
691         }
692
693         VM_API_CALL(res, inboxcount2, (mailboxes, urgentmsgs, newmsgs, oldmsgs));
694         return res;
695 }
696
697 int ast_app_sayname(struct ast_channel *chan, const char *mailbox_id)
698 {
699         int res = -1;
700
701         VM_GREETER_API_CALL(res, sayname, (chan, mailbox_id));
702         return res;
703 }
704
705 int ast_app_messagecount(const char *mailbox_id, const char *folder)
706 {
707         int res = 0;
708
709         VM_API_CALL(res, messagecount, (mailbox_id, folder));
710         return res;
711 }
712
713 const char *ast_vm_index_to_foldername(int id)
714 {
715         const char *res = NULL;
716
717         VM_API_CALL(res, index_to_foldername, (id));
718         return res;
719 }
720
721 struct ast_vm_mailbox_snapshot *ast_vm_mailbox_snapshot_create(const char *mailbox,
722         const char *context,
723         const char *folder,
724         int descending,
725         enum ast_vm_snapshot_sort_val sort_val,
726         int combine_INBOX_and_OLD)
727 {
728         struct ast_vm_mailbox_snapshot *res = NULL;
729
730         VM_API_CALL(res, mailbox_snapshot_create, (mailbox, context, folder, descending,
731                 sort_val, combine_INBOX_and_OLD));
732         return res;
733 }
734
735 struct ast_vm_mailbox_snapshot *ast_vm_mailbox_snapshot_destroy(struct ast_vm_mailbox_snapshot *mailbox_snapshot)
736 {
737         struct ast_vm_mailbox_snapshot *res = NULL;
738
739         VM_API_CALL(res, mailbox_snapshot_destroy, (mailbox_snapshot));
740         return res;
741 }
742
743 int ast_vm_msg_move(const char *mailbox,
744         const char *context,
745         size_t num_msgs,
746         const char *oldfolder,
747         const char *old_msg_ids[],
748         const char *newfolder)
749 {
750         int res = 0;
751
752         VM_API_CALL(res, msg_move, (mailbox, context, num_msgs, oldfolder, old_msg_ids,
753                 newfolder));
754         return res;
755 }
756
757 int ast_vm_msg_remove(const char *mailbox,
758         const char *context,
759         size_t num_msgs,
760         const char *folder,
761         const char *msgs[])
762 {
763         int res = 0;
764
765         VM_API_CALL(res, msg_remove, (mailbox, context, num_msgs, folder, msgs));
766         return res;
767 }
768
769 int ast_vm_msg_forward(const char *from_mailbox,
770         const char *from_context,
771         const char *from_folder,
772         const char *to_mailbox,
773         const char *to_context,
774         const char *to_folder,
775         size_t num_msgs,
776         const char *msg_ids[],
777         int delete_old)
778 {
779         int res = 0;
780
781         VM_API_CALL(res, msg_forward, (from_mailbox, from_context, from_folder, to_mailbox,
782                 to_context, to_folder, num_msgs, msg_ids, delete_old));
783         return res;
784 }
785
786 int ast_vm_msg_play(struct ast_channel *chan,
787         const char *mailbox,
788         const char *context,
789         const char *folder,
790         const char *msg_num,
791         ast_vm_msg_play_cb *cb)
792 {
793         int res = 0;
794
795         VM_API_CALL(res, msg_play, (chan, mailbox, context, folder, msg_num, cb));
796         return res;
797 }
798
799 #ifdef TEST_FRAMEWORK
800 int ast_vm_test_create_user(const char *context, const char *mailbox)
801 {
802         if (ast_vm_test_create_user_func) {
803                 return ast_vm_test_create_user_func(context, mailbox);
804         }
805         return 0;
806 }
807
808 int ast_vm_test_destroy_user(const char *context, const char *mailbox)
809 {
810         if (ast_vm_test_destroy_user_func) {
811                 return ast_vm_test_destroy_user_func(context, mailbox);
812         }
813         return 0;
814 }
815 #endif
816
817 int ast_dtmf_stream(struct ast_channel *chan, struct ast_channel *peer, const char *digits, int between, unsigned int duration)
818 {
819         const char *ptr;
820         int res;
821         struct ast_silence_generator *silgen = NULL;
822
823         if (!between) {
824                 between = 100;
825         }
826
827         if (peer && ast_autoservice_start(peer)) {
828                 return -1;
829         }
830
831         /* Need a quiet time before sending digits. */
832         if (ast_opt_transmit_silence) {
833                 silgen = ast_channel_start_silence_generator(chan);
834         }
835         res = ast_safe_sleep(chan, 100);
836         if (res) {
837                 goto dtmf_stream_cleanup;
838         }
839
840         for (ptr = digits; *ptr; ptr++) {
841                 if (*ptr == 'w') {
842                         /* 'w' -- wait half a second */
843                         if ((res = ast_safe_sleep(chan, 500))) {
844                                 break;
845                         }
846                 } else if (*ptr == 'W') {
847                         /* 'W' -- wait a second */
848                         if ((res = ast_safe_sleep(chan, 1000))) {
849                                 break;
850                         }
851                 } else if (strchr("0123456789*#abcdfABCDF", *ptr)) {
852                         if (*ptr == 'f' || *ptr == 'F') {
853                                 /* ignore return values if not supported by channel */
854                                 ast_indicate(chan, AST_CONTROL_FLASH);
855                         } else {
856                                 /* Character represents valid DTMF */
857                                 ast_senddigit(chan, *ptr, duration);
858                         }
859                         /* pause between digits */
860                         if ((res = ast_safe_sleep(chan, between))) {
861                                 break;
862                         }
863                 } else {
864                         ast_log(LOG_WARNING, "Illegal DTMF character '%c' in string. (0-9*#aAbBcCdD allowed)\n", *ptr);
865                 }
866         }
867
868 dtmf_stream_cleanup:
869         if (silgen) {
870                 ast_channel_stop_silence_generator(chan, silgen);
871         }
872         if (peer && ast_autoservice_stop(peer)) {
873                 res = -1;
874         }
875
876         return res;
877 }
878
879 struct linear_state {
880         int fd;
881         int autoclose;
882         int allowoverride;
883         struct ast_format *origwfmt;
884 };
885
886 static void linear_release(struct ast_channel *chan, void *params)
887 {
888         struct linear_state *ls = params;
889
890         if (ls->origwfmt && ast_set_write_format(chan, ls->origwfmt)) {
891                 ast_log(LOG_WARNING, "Unable to restore channel '%s' to format '%s'\n",
892                         ast_channel_name(chan), ast_format_get_name(ls->origwfmt));
893         }
894         ao2_cleanup(ls->origwfmt);
895
896         if (ls->autoclose) {
897                 close(ls->fd);
898         }
899
900         ast_free(params);
901 }
902
903 static int linear_generator(struct ast_channel *chan, void *data, int len, int samples)
904 {
905         short buf[2048 + AST_FRIENDLY_OFFSET / 2];
906         struct linear_state *ls = data;
907         struct ast_frame f = {
908                 .frametype = AST_FRAME_VOICE,
909                 .data.ptr = buf + AST_FRIENDLY_OFFSET / 2,
910                 .offset = AST_FRIENDLY_OFFSET,
911         };
912         int res;
913
914         f.subclass.format = ast_format_slin;
915
916         len = samples * 2;
917         if (len > sizeof(buf) - AST_FRIENDLY_OFFSET) {
918                 ast_log(LOG_WARNING, "Can't generate %d bytes of data!\n" , len);
919                 len = sizeof(buf) - AST_FRIENDLY_OFFSET;
920         }
921         res = read(ls->fd, buf + AST_FRIENDLY_OFFSET/2, len);
922         if (res > 0) {
923                 f.datalen = res;
924                 f.samples = res / 2;
925                 ast_write(chan, &f);
926                 if (res == len) {
927                         return 0;
928                 }
929         }
930         return -1;
931 }
932
933 static void *linear_alloc(struct ast_channel *chan, void *params)
934 {
935         struct linear_state *ls = params;
936
937         if (!params) {
938                 return NULL;
939         }
940
941         /* In this case, params is already malloc'd */
942         if (ls->allowoverride) {
943                 ast_set_flag(ast_channel_flags(chan), AST_FLAG_WRITE_INT);
944         } else {
945                 ast_clear_flag(ast_channel_flags(chan), AST_FLAG_WRITE_INT);
946         }
947
948         ls->origwfmt = ao2_bump(ast_channel_writeformat(chan));
949
950         if (ast_set_write_format(chan, ast_format_slin)) {
951                 ast_log(LOG_WARNING, "Unable to set '%s' to linear format (write)\n", ast_channel_name(chan));
952                 ao2_cleanup(ls->origwfmt);
953                 ast_free(ls);
954                 ls = params = NULL;
955         }
956
957         return params;
958 }
959
960 static struct ast_generator linearstream =
961 {
962         .alloc = linear_alloc,
963         .release = linear_release,
964         .generate = linear_generator,
965 };
966
967 int ast_linear_stream(struct ast_channel *chan, const char *filename, int fd, int allowoverride)
968 {
969         struct linear_state *lin;
970         char tmpf[256];
971         int res = -1;
972         int autoclose = 0;
973         if (fd < 0) {
974                 if (ast_strlen_zero(filename)) {
975                         return -1;
976                 }
977                 autoclose = 1;
978                 if (filename[0] == '/') {
979                         ast_copy_string(tmpf, filename, sizeof(tmpf));
980                 } else {
981                         snprintf(tmpf, sizeof(tmpf), "%s/%s/%s", ast_config_AST_DATA_DIR, "sounds", filename);
982                 }
983                 if ((fd = open(tmpf, O_RDONLY)) < 0) {
984                         ast_log(LOG_WARNING, "Unable to open file '%s': %s\n", tmpf, strerror(errno));
985                         return -1;
986                 }
987         }
988         if ((lin = ast_calloc(1, sizeof(*lin)))) {
989                 lin->fd = fd;
990                 lin->allowoverride = allowoverride;
991                 lin->autoclose = autoclose;
992                 res = ast_activate_generator(chan, &linearstream, lin);
993         }
994         return res;
995 }
996
997 static int control_streamfile(struct ast_channel *chan,
998         const char *file,
999         const char *fwd,
1000         const char *rev,
1001         const char *stop,
1002         const char *suspend,
1003         const char *restart,
1004         int skipms,
1005         long *offsetms,
1006         const char *lang,
1007         ast_waitstream_fr_cb cb)
1008 {
1009         char *breaks = NULL;
1010         char *end = NULL;
1011         int blen = 2;
1012         int res;
1013         long pause_restart_point = 0;
1014         long offset = 0;
1015
1016         if (!file) {
1017                 return -1;
1018         }
1019         if (offsetms) {
1020                 offset = *offsetms * 8; /* XXX Assumes 8kHz */
1021         }
1022         if (lang == NULL) {
1023                 lang = ast_channel_language(chan);
1024         }
1025
1026         if (stop) {
1027                 blen += strlen(stop);
1028         }
1029         if (suspend) {
1030                 blen += strlen(suspend);
1031         }
1032         if (restart) {
1033                 blen += strlen(restart);
1034         }
1035
1036         if (blen > 2) {
1037                 breaks = ast_alloca(blen + 1);
1038                 breaks[0] = '\0';
1039                 if (stop) {
1040                         strcat(breaks, stop);
1041                 }
1042                 if (suspend) {
1043                         strcat(breaks, suspend);
1044                 }
1045                 if (restart) {
1046                         strcat(breaks, restart);
1047                 }
1048         }
1049         if (ast_channel_state(chan) != AST_STATE_UP) {
1050                 res = ast_answer(chan);
1051         }
1052
1053         if ((end = strchr(file, ':'))) {
1054                 if (!strcasecmp(end, ":end")) {
1055                         *end = '\0';
1056                         end++;
1057                 }
1058         }
1059
1060         for (;;) {
1061                 ast_stopstream(chan);
1062                 res = ast_streamfile(chan, file, lang);
1063                 if (!res) {
1064                         if (pause_restart_point) {
1065                                 ast_seekstream(ast_channel_stream(chan), pause_restart_point, SEEK_SET);
1066                                 pause_restart_point = 0;
1067                         }
1068                         else if (end || offset < 0) {
1069                                 if (offset == -8) {
1070                                         offset = 0;
1071                                 }
1072                                 ast_verb(3, "ControlPlayback seek to offset %ld from end\n", offset);
1073
1074                                 ast_seekstream(ast_channel_stream(chan), offset, SEEK_END);
1075                                 end = NULL;
1076                                 offset = 0;
1077                         } else if (offset) {
1078                                 ast_verb(3, "ControlPlayback seek to offset %ld\n", offset);
1079                                 ast_seekstream(ast_channel_stream(chan), offset, SEEK_SET);
1080                                 offset = 0;
1081                         }
1082                         if (cb) {
1083                                 res = ast_waitstream_fr_w_cb(chan, breaks, fwd, rev, skipms, cb);
1084                         } else {
1085                                 res = ast_waitstream_fr(chan, breaks, fwd, rev, skipms);
1086                         }
1087                 }
1088
1089                 if (res < 1) {
1090                         break;
1091                 }
1092
1093                 /* We go at next loop if we got the restart char */
1094                 if ((restart && strchr(restart, res)) || res == AST_CONTROL_STREAM_RESTART) {
1095                         ast_debug(1, "we'll restart the stream here at next loop\n");
1096                         pause_restart_point = 0;
1097                         ast_test_suite_event_notify("PLAYBACK","Channel: %s\r\n"
1098                                 "Control: %s\r\n",
1099                                 ast_channel_name(chan),
1100                                 "Restart");
1101                         continue;
1102                 }
1103
1104                 if ((suspend && strchr(suspend, res)) || res == AST_CONTROL_STREAM_SUSPEND) {
1105                         pause_restart_point = ast_tellstream(ast_channel_stream(chan));
1106                         ast_test_suite_event_notify("PLAYBACK","Channel: %s\r\n"
1107                                 "Control: %s\r\n",
1108                                 ast_channel_name(chan),
1109                                 "Pause");
1110                         for (;;) {
1111                                 ast_stopstream(chan);
1112                                 if (!(res = ast_waitfordigit(chan, 1000))) {
1113                                         continue;
1114                                 } else if (res == -1 || (suspend && strchr(suspend, res)) || (stop && strchr(stop, res))
1115                                                 || res == AST_CONTROL_STREAM_SUSPEND || res == AST_CONTROL_STREAM_STOP) {
1116                                         break;
1117                                 }
1118                         }
1119                         if ((suspend && (res == *suspend)) || res == AST_CONTROL_STREAM_SUSPEND) {
1120                                 res = 0;
1121                                 ast_test_suite_event_notify("PLAYBACK","Channel: %s\r\n"
1122                                         "Control: %s\r\n",
1123                                         ast_channel_name(chan),
1124                                         "Unpause");
1125                                 continue;
1126                         }
1127                 }
1128
1129                 if (res == -1) {
1130                         break;
1131                 }
1132
1133                 /* if we get one of our stop chars, return it to the calling function */
1134                 if ((stop && strchr(stop, res)) || res == AST_CONTROL_STREAM_STOP) {
1135                         ast_test_suite_event_notify("PLAYBACK","Channel: %s\r\n"
1136                                 "Control: %s\r\n",
1137                                 ast_channel_name(chan),
1138                                 "Stop");
1139                         break;
1140                 }
1141         }
1142
1143         if (pause_restart_point) {
1144                 offset = pause_restart_point;
1145         } else {
1146                 if (ast_channel_stream(chan)) {
1147                         offset = ast_tellstream(ast_channel_stream(chan));
1148                 } else {
1149                         offset = -8;  /* indicate end of file */
1150                 }
1151         }
1152
1153         if (offsetms) {
1154                 *offsetms = offset / 8; /* samples --> ms ... XXX Assumes 8 kHz */
1155         }
1156
1157         ast_stopstream(chan);
1158
1159         return res;
1160 }
1161
1162 int ast_control_streamfile_w_cb(struct ast_channel *chan,
1163         const char *file,
1164         const char *fwd,
1165         const char *rev,
1166         const char *stop,
1167         const char *suspend,
1168         const char *restart,
1169         int skipms,
1170         long *offsetms,
1171         ast_waitstream_fr_cb cb)
1172 {
1173         return control_streamfile(chan, file, fwd, rev, stop, suspend, restart, skipms, offsetms, NULL, cb);
1174 }
1175
1176 int ast_control_streamfile(struct ast_channel *chan, const char *file,
1177                            const char *fwd, const char *rev,
1178                            const char *stop, const char *suspend,
1179                            const char *restart, int skipms, long *offsetms)
1180 {
1181         return control_streamfile(chan, file, fwd, rev, stop, suspend, restart, skipms, offsetms, NULL, NULL);
1182 }
1183
1184 int ast_control_streamfile_lang(struct ast_channel *chan, const char *file,
1185         const char *fwd, const char *rev, const char *stop, const char *suspend,
1186         const char *restart, int skipms, const char *lang, long *offsetms)
1187 {
1188         return control_streamfile(chan, file, fwd, rev, stop, suspend, restart, skipms, offsetms, lang, NULL);
1189 }
1190
1191 enum control_tone_frame_response_result {
1192         CONTROL_TONE_RESPONSE_FAILED = -1,
1193         CONTROL_TONE_RESPONSE_NORMAL = 0,
1194         CONTROL_TONE_RESPONSE_FINISHED = 1,
1195 };
1196
1197 static enum control_tone_frame_response_result control_tone_frame_response(struct ast_channel *chan, struct ast_frame *fr, struct ast_tone_zone_sound *ts, const char *tone, int *paused)
1198 {
1199         switch (fr->subclass.integer) {
1200         case AST_CONTROL_STREAM_STOP:
1201                 ast_playtones_stop(chan);
1202                 return CONTROL_TONE_RESPONSE_FINISHED;
1203         case AST_CONTROL_STREAM_SUSPEND:
1204                 if (*paused) {
1205                         *paused = 0;
1206                         if (ast_playtones_start(chan, 0, ts ? ts->data : tone, 0)) {
1207                                 return CONTROL_TONE_RESPONSE_FAILED;
1208                         }
1209                 } else {
1210                         *paused = 1;
1211                         ast_playtones_stop(chan);
1212                 }
1213                 return CONTROL_TONE_RESPONSE_NORMAL;
1214         case AST_CONTROL_STREAM_RESTART:
1215                 ast_playtones_stop(chan);
1216                 if (ast_playtones_start(chan, 0, ts ? ts->data : tone, 0)) {
1217                         return CONTROL_TONE_RESPONSE_FAILED;
1218                 }
1219                 return CONTROL_TONE_RESPONSE_NORMAL;
1220         case AST_CONTROL_STREAM_REVERSE:
1221                 ast_log(LOG_NOTICE, "Media control operation 'reverse' not supported for media type 'tone'\n");
1222                 return CONTROL_TONE_RESPONSE_NORMAL;
1223         case AST_CONTROL_STREAM_FORWARD:
1224                 ast_log(LOG_NOTICE, "Media control operation 'forward' not supported for media type 'tone'\n");
1225                 return CONTROL_TONE_RESPONSE_NORMAL;
1226         case AST_CONTROL_HANGUP:
1227         case AST_CONTROL_BUSY:
1228         case AST_CONTROL_CONGESTION:
1229                 return CONTROL_TONE_RESPONSE_FINISHED;
1230         }
1231
1232         return CONTROL_TONE_RESPONSE_NORMAL;
1233 }
1234
1235 static int parse_tone_uri(char *tone_parser,
1236         const char **tone_indication,
1237         const char **tone_zone)
1238 {
1239         *tone_indication = strsep(&tone_parser, ";");
1240
1241         if (ast_strlen_zero(tone_parser)) {
1242                 /* Only the indication is included */
1243                 return 0;
1244         }
1245
1246         if (!(strncmp(tone_parser, "tonezone=", 9))) {
1247                 *tone_zone = tone_parser + 9;
1248         } else {
1249                 ast_log(LOG_ERROR, "Unexpected Tone URI component: %s\n", tone_parser);
1250                 return -1;
1251         }
1252
1253         return 0;
1254 }
1255
1256 int ast_control_tone(struct ast_channel *chan, const char *tone)
1257 {
1258         struct ast_tone_zone *zone = NULL;
1259         struct ast_tone_zone_sound *ts;
1260         int paused = 0;
1261         int res = 0;
1262
1263         const char *tone_indication = NULL;
1264         const char *tone_zone = NULL;
1265         char *tone_uri_parser;
1266
1267         if (ast_strlen_zero(tone)) {
1268                 return -1;
1269         }
1270
1271         tone_uri_parser = ast_strdupa(tone);
1272
1273         if (parse_tone_uri(tone_uri_parser, &tone_indication, &tone_zone)) {
1274                 return -1;
1275         }
1276
1277         if (tone_zone) {
1278                 zone = ast_get_indication_zone(tone_zone);
1279         }
1280
1281         ts = ast_get_indication_tone(zone ? zone : ast_channel_zone(chan), tone_indication);
1282
1283         if (ast_playtones_start(chan, 0, ts ? ts->data : tone_indication, 0)) {
1284                 return -1;
1285         }
1286
1287         for (;;) {
1288                 struct ast_frame *fr;
1289
1290                 if (ast_waitfor(chan, -1) < 0) {
1291                         res = -1;
1292                         break;
1293                 }
1294
1295                 fr = ast_read_noaudio(chan);
1296
1297                 if (!fr) {
1298                         res = -1;
1299                         break;
1300                 }
1301
1302                 if (fr->frametype != AST_FRAME_CONTROL) {
1303                         continue;
1304                 }
1305
1306                 res = control_tone_frame_response(chan, fr, ts, tone_indication, &paused);
1307                 if (res == CONTROL_TONE_RESPONSE_FINISHED) {
1308                         res = 0;
1309                         break;
1310                 } else if (res == CONTROL_TONE_RESPONSE_FAILED) {
1311                         res = -1;
1312                         break;
1313                 }
1314         }
1315
1316         if (ts) {
1317                 ast_tone_zone_sound_unref(ts);
1318         }
1319
1320         if (zone) {
1321                 ast_tone_zone_unref(zone);
1322         }
1323
1324         return res;
1325 }
1326
1327 int ast_play_and_wait(struct ast_channel *chan, const char *fn)
1328 {
1329         int d = 0;
1330
1331         if ((d = ast_streamfile(chan, fn, ast_channel_language(chan)))) {
1332                 return d;
1333         }
1334
1335         d = ast_waitstream(chan, AST_DIGIT_ANY);
1336
1337         ast_stopstream(chan);
1338
1339         return d;
1340 }
1341
1342 /*!
1343  * \brief Construct a silence frame of the same duration as \a orig.
1344  *
1345  * The \a orig frame must be \ref AST_FORMAT_SLINEAR.
1346  *
1347  * \param orig Frame as basis for silence to generate.
1348  * \return New frame of silence; free with ast_frfree().
1349  * \return \c NULL on error.
1350  */
1351 static struct ast_frame *make_silence(const struct ast_frame *orig)
1352 {
1353         struct ast_frame *silence;
1354         size_t size;
1355         size_t datalen;
1356         size_t samples = 0;
1357         struct ast_frame *next;
1358
1359         if (!orig) {
1360                 return NULL;
1361         }
1362
1363         if (ast_format_cmp(orig->subclass.format, ast_format_slin) == AST_FORMAT_CMP_NOT_EQUAL) {
1364                 ast_log(LOG_WARNING, "Attempting to silence non-slin frame\n");
1365                 return NULL;
1366         }
1367
1368         for (next = AST_LIST_NEXT(orig, frame_list);
1369                  orig;
1370                  orig = next, next = orig ? AST_LIST_NEXT(orig, frame_list) : NULL) {
1371                 samples += orig->samples;
1372         }
1373
1374         ast_verb(4, "Silencing %zu samples\n", samples);
1375
1376
1377         datalen = sizeof(short) * samples;
1378         size = sizeof(*silence) + datalen;
1379         silence = ast_calloc(1, size);
1380         if (!silence) {
1381                 return NULL;
1382         }
1383
1384         silence->mallocd = AST_MALLOCD_HDR;
1385         silence->frametype = AST_FRAME_VOICE;
1386         silence->data.ptr = (void *)(silence + 1);
1387         silence->samples = samples;
1388         silence->datalen = datalen;
1389
1390         silence->subclass.format = ast_format_slin;
1391
1392         return silence;
1393 }
1394
1395 /*!
1396  * \brief Sets a channel's read format to \ref AST_FORMAT_SLINEAR, recording
1397  * its original format.
1398  *
1399  * \param chan Channel to modify.
1400  * \param[out] orig_format Output variable to store channel's original read
1401  *                         format.
1402  * \return 0 on success.
1403  * \return -1 on error.
1404  */
1405 static int set_read_to_slin(struct ast_channel *chan, struct ast_format **orig_format)
1406 {
1407         if (!chan || !orig_format) {
1408                 return -1;
1409         }
1410         *orig_format = ao2_bump(ast_channel_readformat(chan));
1411         return ast_set_read_format(chan, ast_format_slin);
1412 }
1413
1414 static int global_silence_threshold = 128;
1415 static int global_maxsilence = 0;
1416
1417 /*! Optionally play a sound file or a beep, then record audio and video from the channel.
1418  * \param chan Channel to playback to/record from.
1419  * \param playfile Filename of sound to play before recording begins.
1420  * \param recordfile Filename to record to.
1421  * \param maxtime Maximum length of recording (in seconds).
1422  * \param fmt Format(s) to record message in. Multiple formats may be specified by separating them with a '|'.
1423  * \param duration Where to store actual length of the recorded message (in milliseconds).
1424  * \param sound_duration Where to store the length of the recorded message (in milliseconds), minus any silence
1425  * \param beep Whether to play a beep before starting to record.
1426  * \param silencethreshold
1427  * \param maxsilence Length of silence that will end a recording (in milliseconds).
1428  * \param path Optional filesystem path to unlock.
1429  * \param prepend If true, prepend the recorded audio to an existing file and follow prepend mode recording rules
1430  * \param acceptdtmf DTMF digits that will end the recording.
1431  * \param canceldtmf DTMF digits that will cancel the recording.
1432  * \param skip_confirmation_sound If true, don't play auth-thankyou at end. Nice for custom recording prompts in apps.
1433  *
1434  * \retval -1 failure or hangup
1435  * \retval 'S' Recording ended from silence timeout
1436  * \retval 't' Recording ended from the message exceeding the maximum duration, or via DTMF in prepend mode
1437  * \retval dtmfchar Recording ended via the return value's DTMF character for either cancel or accept.
1438  */
1439 static int __ast_play_and_record(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int *sound_duration, int beep, int silencethreshold, int maxsilence, const char *path, int prepend, const char *acceptdtmf, const char *canceldtmf, int skip_confirmation_sound, enum ast_record_if_exists if_exists)
1440 {
1441         int d = 0;
1442         char *fmts;
1443         char comment[256];
1444         int x, fmtcnt = 1, res = -1, outmsg = 0;
1445         struct ast_filestream *others[AST_MAX_FORMATS];
1446         char *sfmt[AST_MAX_FORMATS];
1447         char *stringp = NULL;
1448         time_t start, end;
1449         struct ast_dsp *sildet = NULL;   /* silence detector dsp */
1450         int totalsilence = 0;
1451         int dspsilence = 0;
1452         int olddspsilence = 0;
1453         struct ast_format *rfmt = NULL;
1454         struct ast_silence_generator *silgen = NULL;
1455         char prependfile[PATH_MAX];
1456         int ioflags;    /* IO flags for writing output file */
1457
1458         ioflags = O_CREAT|O_WRONLY;
1459
1460         switch (if_exists) {
1461         case AST_RECORD_IF_EXISTS_FAIL:
1462                 ioflags |= O_EXCL;
1463                 break;
1464         case AST_RECORD_IF_EXISTS_OVERWRITE:
1465                 ioflags |= O_TRUNC;
1466                 break;
1467         case AST_RECORD_IF_EXISTS_APPEND:
1468                 ioflags |= O_APPEND;
1469                 break;
1470         }
1471
1472         if (silencethreshold < 0) {
1473                 silencethreshold = global_silence_threshold;
1474         }
1475
1476         if (maxsilence < 0) {
1477                 maxsilence = global_maxsilence;
1478         }
1479
1480         /* barf if no pointer passed to store duration in */
1481         if (!duration) {
1482                 ast_log(LOG_WARNING, "Error play_and_record called without duration pointer\n");
1483                 return -1;
1484         }
1485
1486         ast_debug(1, "play_and_record: %s, %s, '%s'\n", playfile ? playfile : "<None>", recordfile, fmt);
1487         snprintf(comment, sizeof(comment), "Playing %s, Recording to: %s on %s\n", playfile ? playfile : "<None>", recordfile, ast_channel_name(chan));
1488
1489         if (playfile || beep) {
1490                 if (!beep) {
1491                         d = ast_play_and_wait(chan, playfile);
1492                 }
1493                 if (d > -1) {
1494                         d = ast_stream_and_wait(chan, "beep", "");
1495                 }
1496                 if (d < 0) {
1497                         return -1;
1498                 }
1499         }
1500
1501         if (prepend) {
1502                 ast_copy_string(prependfile, recordfile, sizeof(prependfile));
1503                 strncat(prependfile, "-prepend", sizeof(prependfile) - strlen(prependfile) - 1);
1504         }
1505
1506         fmts = ast_strdupa(fmt);
1507
1508         stringp = fmts;
1509         strsep(&stringp, "|");
1510         ast_debug(1, "Recording Formats: sfmts=%s\n", fmts);
1511         sfmt[0] = ast_strdupa(fmts);
1512
1513         while ((fmt = strsep(&stringp, "|"))) {
1514                 if (fmtcnt > AST_MAX_FORMATS - 1) {
1515                         ast_log(LOG_WARNING, "Please increase AST_MAX_FORMATS in file.h\n");
1516                         break;
1517                 }
1518                 sfmt[fmtcnt++] = ast_strdupa(fmt);
1519         }
1520
1521         end = start = time(NULL);  /* pre-initialize end to be same as start in case we never get into loop */
1522         for (x = 0; x < fmtcnt; x++) {
1523                 others[x] = ast_writefile(prepend ? prependfile : recordfile, sfmt[x], comment, ioflags, 0, AST_FILE_MODE);
1524                 ast_verb(3, "x=%d, open writing:  %s format: %s, %p\n", x, prepend ? prependfile : recordfile, sfmt[x], others[x]);
1525
1526                 if (!others[x]) {
1527                         break;
1528                 }
1529         }
1530
1531         if (path) {
1532                 ast_unlock_path(path);
1533         }
1534
1535         if (maxsilence > 0) {
1536                 sildet = ast_dsp_new(); /* Create the silence detector */
1537                 if (!sildet) {
1538                         ast_log(LOG_WARNING, "Unable to create silence detector :(\n");
1539                         return -1;
1540                 }
1541                 ast_dsp_set_threshold(sildet, silencethreshold);
1542                 res = set_read_to_slin(chan, &rfmt);
1543                 if (res < 0) {
1544                         ast_log(LOG_WARNING, "Unable to set to linear mode, giving up\n");
1545                         ast_dsp_free(sildet);
1546                         ao2_cleanup(rfmt);
1547                         return -1;
1548                 }
1549         }
1550
1551         if (!prepend) {
1552                 /* Request a video update */
1553                 ast_indicate(chan, AST_CONTROL_VIDUPDATE);
1554
1555                 if (ast_opt_transmit_silence) {
1556                         silgen = ast_channel_start_silence_generator(chan);
1557                 }
1558         }
1559
1560         if (x == fmtcnt) {
1561                 /* Loop, writing the packets we read to the writer(s), until
1562                  * we have reason to stop. */
1563                 struct ast_frame *f;
1564                 int paused = 0;
1565                 int muted = 0;
1566                 time_t pause_start = 0;
1567                 int paused_secs = 0;
1568                 int pausedsilence = 0;
1569
1570                 for (;;) {
1571                         if (!(res = ast_waitfor(chan, 2000))) {
1572                                 ast_debug(1, "One waitfor failed, trying another\n");
1573                                 /* Try one more time in case of masq */
1574                                 if (!(res = ast_waitfor(chan, 2000))) {
1575                                         ast_log(LOG_WARNING, "No audio available on %s??\n", ast_channel_name(chan));
1576                                         res = -1;
1577                                 }
1578                         }
1579
1580                         if (res < 0) {
1581                                 f = NULL;
1582                                 break;
1583                         }
1584                         if (!(f = ast_read(chan))) {
1585                                 break;
1586                         }
1587                         if (f->frametype == AST_FRAME_VOICE) {
1588                                 /* write each format */
1589                                 if (paused) {
1590                                         /* It's all good */
1591                                         res = 0;
1592                                 } else {
1593                                         RAII_VAR(struct ast_frame *, silence, NULL, ast_frame_dtor);
1594                                         struct ast_frame *orig = f;
1595
1596                                         if (muted) {
1597                                                 silence = make_silence(orig);
1598                                                 if (!silence) {
1599                                                         ast_log(LOG_WARNING,
1600                                                                 "Error creating silence\n");
1601                                                         break;
1602                                                 }
1603                                                 f = silence;
1604                                         }
1605                                         for (x = 0; x < fmtcnt; x++) {
1606                                                 if (prepend && !others[x]) {
1607                                                         break;
1608                                                 }
1609                                                 res = ast_writestream(others[x], f);
1610                                         }
1611                                         f = orig;
1612                                 }
1613
1614                                 /* Silence Detection */
1615                                 if (maxsilence > 0) {
1616                                         dspsilence = 0;
1617                                         ast_dsp_silence(sildet, f, &dspsilence);
1618                                         if (olddspsilence > dspsilence) {
1619                                                 totalsilence += olddspsilence;
1620                                         }
1621                                         olddspsilence = dspsilence;
1622
1623                                         if (paused) {
1624                                                 /* record how much silence there was while we are paused */
1625                                                 pausedsilence = dspsilence;
1626                                         } else if (dspsilence > pausedsilence) {
1627                                                 /* ignore the paused silence */
1628                                                 dspsilence -= pausedsilence;
1629                                         } else {
1630                                                 /* dspsilence has reset, reset pausedsilence */
1631                                                 pausedsilence = 0;
1632                                         }
1633
1634                                         if (dspsilence > maxsilence) {
1635                                                 /* Ended happily with silence */
1636                                                 ast_verb(3, "Recording automatically stopped after a silence of %d seconds\n", dspsilence/1000);
1637                                                 res = 'S';
1638                                                 outmsg = 2;
1639                                                 break;
1640                                         }
1641                                 }
1642                                 /* Exit on any error */
1643                                 if (res) {
1644                                         ast_log(LOG_WARNING, "Error writing frame\n");
1645                                         break;
1646                                 }
1647                         } else if (f->frametype == AST_FRAME_VIDEO) {
1648                                 /* Write only once */
1649                                 ast_writestream(others[0], f);
1650                         } else if (f->frametype == AST_FRAME_DTMF) {
1651                                 if (prepend) {
1652                                 /* stop recording with any digit */
1653                                         ast_verb(3, "User ended message by pressing %c\n", f->subclass.integer);
1654                                         res = 't';
1655                                         outmsg = 2;
1656                                         break;
1657                                 }
1658                                 if (strchr(acceptdtmf, f->subclass.integer)) {
1659                                         ast_verb(3, "User ended message by pressing %c\n", f->subclass.integer);
1660                                         res = f->subclass.integer;
1661                                         outmsg = 2;
1662                                         break;
1663                                 }
1664                                 if (strchr(canceldtmf, f->subclass.integer)) {
1665                                         ast_verb(3, "User canceled message by pressing %c\n", f->subclass.integer);
1666                                         res = f->subclass.integer;
1667                                         outmsg = 0;
1668                                         break;
1669                                 }
1670                         } else if (f->frametype == AST_FRAME_CONTROL) {
1671                                 if (f->subclass.integer == AST_CONTROL_RECORD_CANCEL) {
1672                                         ast_verb(3, "Message canceled by control\n");
1673                                         outmsg = 0; /* cancels the recording */
1674                                         res = 0;
1675                                         break;
1676                                 } else if (f->subclass.integer == AST_CONTROL_RECORD_STOP) {
1677                                         ast_verb(3, "Message ended by control\n");
1678                                         res = 0;
1679                                         break;
1680                                 } else if (f->subclass.integer == AST_CONTROL_RECORD_SUSPEND) {
1681                                         paused = !paused;
1682                                         ast_verb(3, "Message %spaused by control\n",
1683                                                 paused ? "" : "un");
1684                                         if (paused) {
1685                                                 pause_start = time(NULL);
1686                                         } else {
1687                                                 paused_secs += time(NULL) - pause_start;
1688                                         }
1689                                 } else if (f->subclass.integer == AST_CONTROL_RECORD_MUTE) {
1690                                         muted = !muted;
1691                                         ast_verb(3, "Message %smuted by control\n",
1692                                                 muted ? "" : "un");
1693                                         /* We can only silence slin frames, so
1694                                          * set the mode, if we haven't already
1695                                          * for sildet
1696                                          */
1697                                         if (muted && !rfmt) {
1698                                                 ast_verb(3, "Setting read format to linear mode\n");
1699                                                 res = set_read_to_slin(chan, &rfmt);
1700                                                 if (res < 0) {
1701                                                         ast_log(LOG_WARNING, "Unable to set to linear mode, giving up\n");
1702                                                         break;
1703                                                 }
1704                                         }
1705                                 }
1706                         }
1707                         if (maxtime && !paused) {
1708                                 end = time(NULL);
1709                                 if (maxtime < (end - start - paused_secs)) {
1710                                         ast_verb(3, "Took too long, cutting it short...\n");
1711                                         res = 't';
1712                                         outmsg = 2;
1713                                         break;
1714                                 }
1715                         }
1716                         ast_frfree(f);
1717                 }
1718                 if (!f) {
1719                         ast_verb(3, "User hung up\n");
1720                         res = -1;
1721                         outmsg = 1;
1722                 } else {
1723                         ast_frfree(f);
1724                 }
1725         } else {
1726                 ast_log(LOG_WARNING, "Error creating writestream '%s', format '%s'\n", recordfile, sfmt[x]);
1727         }
1728
1729         if (!prepend) {
1730                 if (silgen) {
1731                         ast_channel_stop_silence_generator(chan, silgen);
1732                 }
1733         }
1734
1735         /*!\note
1736          * Instead of asking how much time passed (end - start), calculate the number
1737          * of seconds of audio which actually went into the file.  This fixes a
1738          * problem where audio is stopped up on the network and never gets to us.
1739          *
1740          * Note that we still want to use the number of seconds passed for the max
1741          * message, otherwise we could get a situation where this stream is never
1742          * closed (which would create a resource leak).
1743          */
1744         *duration = others[0] ? ast_tellstream(others[0]) / 8000 : 0;
1745         if (sound_duration) {
1746                 *sound_duration = *duration;
1747         }
1748
1749         if (!prepend) {
1750                 /* Reduce duration by a total silence amount */
1751                 if (olddspsilence <= dspsilence) {
1752                         totalsilence += dspsilence;
1753                 }
1754
1755                 if (sound_duration) {
1756                         if (totalsilence > 0) {
1757                                 *sound_duration -= (totalsilence - 200) / 1000;
1758                         }
1759                         if (*sound_duration < 0) {
1760                                 *sound_duration = 0;
1761                         }
1762                 }
1763
1764                 if (dspsilence > 0) {
1765                         *duration -= (dspsilence - 200) / 1000;
1766                 }
1767
1768                 if (*duration < 0) {
1769                         *duration = 0;
1770                 }
1771
1772                 for (x = 0; x < fmtcnt; x++) {
1773                         if (!others[x]) {
1774                                 break;
1775                         }
1776                         /*!\note
1777                          * If we ended with silence, trim all but the first 200ms of silence
1778                          * off the recording.  However, if we ended with '#', we don't want
1779                          * to trim ANY part of the recording.
1780                          */
1781                         if (res > 0 && dspsilence) {
1782                                 /* rewind only the trailing silence */
1783                                 ast_stream_rewind(others[x], dspsilence - 200);
1784                         }
1785                         ast_truncstream(others[x]);
1786                         ast_closestream(others[x]);
1787                 }
1788         }
1789
1790         if (prepend && outmsg) {
1791                 struct ast_filestream *realfiles[AST_MAX_FORMATS];
1792                 struct ast_frame *fr;
1793
1794                 for (x = 0; x < fmtcnt; x++) {
1795                         snprintf(comment, sizeof(comment), "Opening the real file %s.%s\n", recordfile, sfmt[x]);
1796                         realfiles[x] = ast_readfile(recordfile, sfmt[x], comment, O_RDONLY, 0, 0);
1797                         if (!others[x] || !realfiles[x]) {
1798                                 break;
1799                         }
1800                         /*!\note Same logic as above. */
1801                         if (dspsilence) {
1802                                 ast_stream_rewind(others[x], dspsilence - 200);
1803                         }
1804                         ast_truncstream(others[x]);
1805                         /* add the original file too */
1806                         while ((fr = ast_readframe(realfiles[x]))) {
1807                                 ast_writestream(others[x], fr);
1808                                 ast_frfree(fr);
1809                         }
1810                         ast_closestream(others[x]);
1811                         ast_closestream(realfiles[x]);
1812                         ast_filerename(prependfile, recordfile, sfmt[x]);
1813                         ast_verb(4, "Recording Format: sfmts=%s, prependfile %s, recordfile %s\n", sfmt[x], prependfile, recordfile);
1814                         ast_filedelete(prependfile, sfmt[x]);
1815                 }
1816         }
1817         if (rfmt && ast_set_read_format(chan, rfmt)) {
1818                 ast_log(LOG_WARNING, "Unable to restore format %s to channel '%s'\n", ast_format_get_name(rfmt), ast_channel_name(chan));
1819         }
1820         ao2_cleanup(rfmt);
1821         if ((outmsg == 2) && (!skip_confirmation_sound)) {
1822                 ast_stream_and_wait(chan, "auth-thankyou", "");
1823         }
1824         if (sildet) {
1825                 ast_dsp_free(sildet);
1826         }
1827         return res;
1828 }
1829
1830 static const char default_acceptdtmf[] = "#";
1831 static const char default_canceldtmf[] = "";
1832
1833 int ast_play_and_record_full(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int *sound_duration, int beep, int silencethreshold, int maxsilence, const char *path, const char *acceptdtmf, const char *canceldtmf, int skip_confirmation_sound, enum ast_record_if_exists if_exists)
1834 {
1835         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, sound_duration, beep, silencethreshold, maxsilence, path, 0, S_OR(acceptdtmf, default_acceptdtmf), S_OR(canceldtmf, default_canceldtmf), skip_confirmation_sound, if_exists);
1836 }
1837
1838 int ast_play_and_record(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, int *sound_duration, int silencethreshold, int maxsilence, const char *path)
1839 {
1840         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, sound_duration, 0, silencethreshold, maxsilence, path, 0, default_acceptdtmf, default_canceldtmf, 0, AST_RECORD_IF_EXISTS_OVERWRITE);
1841 }
1842
1843 int ast_play_and_prepend(struct ast_channel *chan, char *playfile, char *recordfile, int maxtime, char *fmt, int *duration, int *sound_duration, int beep, int silencethreshold, int maxsilence)
1844 {
1845         return __ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, sound_duration, beep, silencethreshold, maxsilence, NULL, 1, default_acceptdtmf, default_canceldtmf, 1, AST_RECORD_IF_EXISTS_OVERWRITE);
1846 }
1847
1848 /* Channel group core functions */
1849
1850 int ast_app_group_split_group(const char *data, char *group, int group_max, char *category, int category_max)
1851 {
1852         int res = 0;
1853         char tmp[256];
1854         char *grp = NULL, *cat = NULL;
1855
1856         if (!ast_strlen_zero(data)) {
1857                 ast_copy_string(tmp, data, sizeof(tmp));
1858                 grp = tmp;
1859                 if ((cat = strchr(tmp, '@'))) {
1860                         *cat++ = '\0';
1861                 }
1862         }
1863
1864         if (!ast_strlen_zero(grp)) {
1865                 ast_copy_string(group, grp, group_max);
1866         } else {
1867                 *group = '\0';
1868         }
1869
1870         if (!ast_strlen_zero(cat)) {
1871                 ast_copy_string(category, cat, category_max);
1872         }
1873
1874         return res;
1875 }
1876
1877 int ast_app_group_set_channel(struct ast_channel *chan, const char *data)
1878 {
1879         int res = 0;
1880         char group[80] = "", category[80] = "";
1881         struct ast_group_info *gi = NULL;
1882         size_t len = 0;
1883
1884         if (ast_app_group_split_group(data, group, sizeof(group), category, sizeof(category))) {
1885                 return -1;
1886         }
1887
1888         /* Calculate memory we will need if this is new */
1889         len = sizeof(*gi) + strlen(group) + 1;
1890         if (!ast_strlen_zero(category)) {
1891                 len += strlen(category) + 1;
1892         }
1893
1894         AST_RWLIST_WRLOCK(&groups);
1895         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&groups, gi, group_list) {
1896                 if ((gi->chan == chan) && ((ast_strlen_zero(category) && ast_strlen_zero(gi->category)) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
1897                         AST_RWLIST_REMOVE_CURRENT(group_list);
1898                         free(gi);
1899                         break;
1900                 }
1901         }
1902         AST_RWLIST_TRAVERSE_SAFE_END;
1903
1904         if (ast_strlen_zero(group)) {
1905                 /* Enable unsetting the group */
1906         } else if ((gi = calloc(1, len))) {
1907                 gi->chan = chan;
1908                 gi->group = (char *) gi + sizeof(*gi);
1909                 strcpy(gi->group, group);
1910                 if (!ast_strlen_zero(category)) {
1911                         gi->category = (char *) gi + sizeof(*gi) + strlen(group) + 1;
1912                         strcpy(gi->category, category);
1913                 }
1914                 AST_RWLIST_INSERT_TAIL(&groups, gi, group_list);
1915         } else {
1916                 res = -1;
1917         }
1918
1919         AST_RWLIST_UNLOCK(&groups);
1920
1921         return res;
1922 }
1923
1924 int ast_app_group_get_count(const char *group, const char *category)
1925 {
1926         struct ast_group_info *gi = NULL;
1927         int count = 0;
1928
1929         if (ast_strlen_zero(group)) {
1930                 return 0;
1931         }
1932
1933         AST_RWLIST_RDLOCK(&groups);
1934         AST_RWLIST_TRAVERSE(&groups, gi, group_list) {
1935                 if (!strcasecmp(gi->group, group) && (ast_strlen_zero(category) || (!ast_strlen_zero(gi->category) && !strcasecmp(gi->category, category)))) {
1936                         count++;
1937                 }
1938         }
1939         AST_RWLIST_UNLOCK(&groups);
1940
1941         return count;
1942 }
1943
1944 int ast_app_group_match_get_count(const char *groupmatch, const char *category)
1945 {
1946         struct ast_group_info *gi = NULL;
1947         regex_t regexbuf_group;
1948         regex_t regexbuf_category;
1949         int count = 0;
1950
1951         if (ast_strlen_zero(groupmatch)) {
1952                 ast_log(LOG_NOTICE, "groupmatch empty\n");
1953                 return 0;
1954         }
1955
1956         /* if regex compilation fails, return zero matches */
1957         if (regcomp(&regexbuf_group, groupmatch, REG_EXTENDED | REG_NOSUB)) {
1958                 ast_log(LOG_ERROR, "Regex compile failed on: %s\n", groupmatch);
1959                 return 0;
1960         }
1961
1962         if (!ast_strlen_zero(category) && regcomp(&regexbuf_category, category, REG_EXTENDED | REG_NOSUB)) {
1963                 ast_log(LOG_ERROR, "Regex compile failed on: %s\n", category);
1964                 regfree(&regexbuf_group);
1965                 return 0;
1966         }
1967
1968         AST_RWLIST_RDLOCK(&groups);
1969         AST_RWLIST_TRAVERSE(&groups, gi, group_list) {
1970                 if (!regexec(&regexbuf_group, gi->group, 0, NULL, 0) && (ast_strlen_zero(category) || (!ast_strlen_zero(gi->category) && !regexec(&regexbuf_category, gi->category, 0, NULL, 0)))) {
1971                         count++;
1972                 }
1973         }
1974         AST_RWLIST_UNLOCK(&groups);
1975
1976         regfree(&regexbuf_group);
1977         if (!ast_strlen_zero(category)) {
1978                 regfree(&regexbuf_category);
1979         }
1980
1981         return count;
1982 }
1983
1984 int ast_app_group_update(struct ast_channel *old, struct ast_channel *new)
1985 {
1986         struct ast_group_info *gi = NULL;
1987
1988         AST_RWLIST_WRLOCK(&groups);
1989         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&groups, gi, group_list) {
1990                 if (gi->chan == old) {
1991                         gi->chan = new;
1992                 } else if (gi->chan == new) {
1993                         AST_RWLIST_REMOVE_CURRENT(group_list);
1994                         ast_free(gi);
1995                 }
1996         }
1997         AST_RWLIST_TRAVERSE_SAFE_END;
1998         AST_RWLIST_UNLOCK(&groups);
1999
2000         return 0;
2001 }
2002
2003 int ast_app_group_discard(struct ast_channel *chan)
2004 {
2005         struct ast_group_info *gi = NULL;
2006
2007         AST_RWLIST_WRLOCK(&groups);
2008         AST_RWLIST_TRAVERSE_SAFE_BEGIN(&groups, gi, group_list) {
2009                 if (gi->chan == chan) {
2010                         AST_RWLIST_REMOVE_CURRENT(group_list);
2011                         ast_free(gi);
2012                 }
2013         }
2014         AST_RWLIST_TRAVERSE_SAFE_END;
2015         AST_RWLIST_UNLOCK(&groups);
2016
2017         return 0;
2018 }
2019
2020 int ast_app_group_list_wrlock(void)
2021 {
2022         return AST_RWLIST_WRLOCK(&groups);
2023 }
2024
2025 int ast_app_group_list_rdlock(void)
2026 {
2027         return AST_RWLIST_RDLOCK(&groups);
2028 }
2029
2030 struct ast_group_info *ast_app_group_list_head(void)
2031 {
2032         return AST_RWLIST_FIRST(&groups);
2033 }
2034
2035 int ast_app_group_list_unlock(void)
2036 {
2037         return AST_RWLIST_UNLOCK(&groups);
2038 }
2039
2040 #undef ast_app_separate_args
2041 unsigned int ast_app_separate_args(char *buf, char delim, char **array, int arraylen);
2042
2043 unsigned int __ast_app_separate_args(char *buf, char delim, int remove_chars, char **array, int arraylen)
2044 {
2045         int argc;
2046         char *scan, *wasdelim = NULL;
2047         int paren = 0, quote = 0, bracket = 0;
2048
2049         if (!array || !arraylen) {
2050                 return 0;
2051         }
2052
2053         memset(array, 0, arraylen * sizeof(*array));
2054
2055         if (!buf) {
2056                 return 0;
2057         }
2058
2059         scan = buf;
2060
2061         for (argc = 0; *scan && (argc < arraylen - 1); argc++) {
2062                 array[argc] = scan;
2063                 for (; *scan; scan++) {
2064                         if (*scan == '(') {
2065                                 paren++;
2066                         } else if (*scan == ')') {
2067                                 if (paren) {
2068                                         paren--;
2069                                 }
2070                         } else if (*scan == '[') {
2071                                 bracket++;
2072                         } else if (*scan == ']') {
2073                                 if (bracket) {
2074                                         bracket--;
2075                                 }
2076                         } else if (*scan == '"' && delim != '"') {
2077                                 quote = quote ? 0 : 1;
2078                                 if (remove_chars) {
2079                                         /* Remove quote character from argument */
2080                                         memmove(scan, scan + 1, strlen(scan));
2081                                         scan--;
2082                                 }
2083                         } else if (*scan == '\\') {
2084                                 if (remove_chars) {
2085                                         /* Literal character, don't parse */
2086                                         memmove(scan, scan + 1, strlen(scan));
2087                                 } else {
2088                                         scan++;
2089                                 }
2090                         } else if ((*scan == delim) && !paren && !quote && !bracket) {
2091                                 wasdelim = scan;
2092                                 *scan++ = '\0';
2093                                 break;
2094                         }
2095                 }
2096         }
2097
2098         /* If the last character in the original string was the delimiter, then
2099          * there is one additional argument. */
2100         if (*scan || (scan > buf && (scan - 1) == wasdelim)) {
2101                 array[argc++] = scan;
2102         }
2103
2104         return argc;
2105 }
2106
2107 /* ABI compatible function */
2108 unsigned int ast_app_separate_args(char *buf, char delim, char **array, int arraylen)
2109 {
2110         return __ast_app_separate_args(buf, delim, 1, array, arraylen);
2111 }
2112
2113 static enum AST_LOCK_RESULT ast_lock_path_lockfile(const char *path)
2114 {
2115         char *s;
2116         char *fs;
2117         int res;
2118         int fd;
2119         int lp = strlen(path);
2120         time_t start;
2121
2122         s = ast_alloca(lp + 10);
2123         fs = ast_alloca(lp + 20);
2124
2125         snprintf(fs, strlen(path) + 19, "%s/.lock-%08lx", path, (unsigned long)ast_random());
2126         fd = open(fs, O_WRONLY | O_CREAT | O_EXCL, AST_FILE_MODE);
2127         if (fd < 0) {
2128                 ast_log(LOG_ERROR, "Unable to create lock file '%s': %s\n", path, strerror(errno));
2129                 return AST_LOCK_PATH_NOT_FOUND;
2130         }
2131         close(fd);
2132
2133         snprintf(s, strlen(path) + 9, "%s/.lock", path);
2134         start = time(NULL);
2135         while (((res = link(fs, s)) < 0) && (errno == EEXIST) && (time(NULL) - start < 5)) {
2136                 sched_yield();
2137         }
2138
2139         unlink(fs);
2140
2141         if (res) {
2142                 ast_log(LOG_WARNING, "Failed to lock path '%s': %s\n", path, strerror(errno));
2143                 return AST_LOCK_TIMEOUT;
2144         } else {
2145                 ast_debug(1, "Locked path '%s'\n", path);
2146                 return AST_LOCK_SUCCESS;
2147         }
2148 }
2149
2150 static int ast_unlock_path_lockfile(const char *path)
2151 {
2152         char *s;
2153         int res;
2154
2155         s = ast_alloca(strlen(path) + 10);
2156
2157         snprintf(s, strlen(path) + 9, "%s/%s", path, ".lock");
2158
2159         if ((res = unlink(s))) {
2160                 ast_log(LOG_ERROR, "Could not unlock path '%s': %s\n", path, strerror(errno));
2161         } else {
2162                 ast_debug(1, "Unlocked path '%s'\n", path);
2163         }
2164
2165         return res;
2166 }
2167
2168 struct path_lock {
2169         AST_LIST_ENTRY(path_lock) le;
2170         int fd;
2171         char *path;
2172 };
2173
2174 static AST_LIST_HEAD_STATIC(path_lock_list, path_lock);
2175
2176 static void path_lock_destroy(struct path_lock *obj)
2177 {
2178         if (obj->fd >= 0) {
2179                 close(obj->fd);
2180         }
2181         if (obj->path) {
2182                 free(obj->path);
2183         }
2184         free(obj);
2185 }
2186
2187 static enum AST_LOCK_RESULT ast_lock_path_flock(const char *path)
2188 {
2189         char *fs;
2190         int res;
2191         int fd;
2192         time_t start;
2193         struct path_lock *pl;
2194         struct stat st, ost;
2195
2196         fs = ast_alloca(strlen(path) + 20);
2197
2198         snprintf(fs, strlen(path) + 19, "%s/lock", path);
2199         if (lstat(fs, &st) == 0) {
2200                 if ((st.st_mode & S_IFMT) == S_IFLNK) {
2201                         ast_log(LOG_WARNING, "Unable to create lock file "
2202                                         "'%s': it's already a symbolic link\n",
2203                                         fs);
2204                         return AST_LOCK_FAILURE;
2205                 }
2206                 if (st.st_nlink > 1) {
2207                         ast_log(LOG_WARNING, "Unable to create lock file "
2208                                         "'%s': %u hard links exist\n",
2209                                         fs, (unsigned int) st.st_nlink);
2210                         return AST_LOCK_FAILURE;
2211                 }
2212         }
2213         if ((fd = open(fs, O_WRONLY | O_CREAT, 0600)) < 0) {
2214                 ast_log(LOG_WARNING, "Unable to create lock file '%s': %s\n",
2215                                 fs, strerror(errno));
2216                 return AST_LOCK_PATH_NOT_FOUND;
2217         }
2218         if (!(pl = ast_calloc(1, sizeof(*pl)))) {
2219                 /* We don't unlink the lock file here, on the possibility that
2220                  * someone else created it - better to leave a little mess
2221                  * than create a big one by destroying someone else's lock
2222                  * and causing something to be corrupted.
2223                  */
2224                 close(fd);
2225                 return AST_LOCK_FAILURE;
2226         }
2227         pl->fd = fd;
2228         pl->path = strdup(path);
2229
2230         time(&start);
2231         while (
2232                 #ifdef SOLARIS
2233                 ((res = fcntl(pl->fd, F_SETLK, fcntl(pl->fd, F_GETFL) | O_NONBLOCK)) < 0) &&
2234                 #else
2235                 ((res = flock(pl->fd, LOCK_EX | LOCK_NB)) < 0) &&
2236                 #endif
2237                         (errno == EWOULDBLOCK) &&
2238                         (time(NULL) - start < 5))
2239                 usleep(1000);
2240         if (res) {
2241                 ast_log(LOG_WARNING, "Failed to lock path '%s': %s\n",
2242                                 path, strerror(errno));
2243                 /* No unlinking of lock done, since we tried and failed to
2244                  * flock() it.
2245                  */
2246                 path_lock_destroy(pl);
2247                 return AST_LOCK_TIMEOUT;
2248         }
2249
2250         /* Check for the race where the file is recreated or deleted out from
2251          * underneath us.
2252          */
2253         if (lstat(fs, &st) != 0 && fstat(pl->fd, &ost) != 0 &&
2254                         st.st_dev != ost.st_dev &&
2255                         st.st_ino != ost.st_ino) {
2256                 ast_log(LOG_WARNING, "Unable to create lock file '%s': "
2257                                 "file changed underneath us\n", fs);
2258                 path_lock_destroy(pl);
2259                 return AST_LOCK_FAILURE;
2260         }
2261
2262         /* Success: file created, flocked, and is the one we started with */
2263         AST_LIST_LOCK(&path_lock_list);
2264         AST_LIST_INSERT_TAIL(&path_lock_list, pl, le);
2265         AST_LIST_UNLOCK(&path_lock_list);
2266
2267         ast_debug(1, "Locked path '%s'\n", path);
2268
2269         return AST_LOCK_SUCCESS;
2270 }
2271
2272 static int ast_unlock_path_flock(const char *path)
2273 {
2274         char *s;
2275         struct path_lock *p;
2276
2277         s = ast_alloca(strlen(path) + 20);
2278
2279         AST_LIST_LOCK(&path_lock_list);
2280         AST_LIST_TRAVERSE_SAFE_BEGIN(&path_lock_list, p, le) {
2281                 if (!strcmp(p->path, path)) {
2282                         AST_LIST_REMOVE_CURRENT(le);
2283                         break;
2284                 }
2285         }
2286         AST_LIST_TRAVERSE_SAFE_END;
2287         AST_LIST_UNLOCK(&path_lock_list);
2288
2289         if (p) {
2290                 snprintf(s, strlen(path) + 19, "%s/lock", path);
2291                 unlink(s);
2292                 path_lock_destroy(p);
2293                 ast_debug(1, "Unlocked path '%s'\n", path);
2294         } else {
2295                 ast_debug(1, "Failed to unlock path '%s': "
2296                                 "lock not found\n", path);
2297         }
2298
2299         return 0;
2300 }
2301
2302 void ast_set_lock_type(enum AST_LOCK_TYPE type)
2303 {
2304         ast_lock_type = type;
2305 }
2306
2307 enum AST_LOCK_RESULT ast_lock_path(const char *path)
2308 {
2309         enum AST_LOCK_RESULT r = AST_LOCK_FAILURE;
2310
2311         switch (ast_lock_type) {
2312         case AST_LOCK_TYPE_LOCKFILE:
2313                 r = ast_lock_path_lockfile(path);
2314                 break;
2315         case AST_LOCK_TYPE_FLOCK:
2316                 r = ast_lock_path_flock(path);
2317                 break;
2318         }
2319
2320         return r;
2321 }
2322
2323 int ast_unlock_path(const char *path)
2324 {
2325         int r = 0;
2326
2327         switch (ast_lock_type) {
2328         case AST_LOCK_TYPE_LOCKFILE:
2329                 r = ast_unlock_path_lockfile(path);
2330                 break;
2331         case AST_LOCK_TYPE_FLOCK:
2332                 r = ast_unlock_path_flock(path);
2333                 break;
2334         }
2335
2336         return r;
2337 }
2338
2339 int ast_record_review(struct ast_channel *chan, const char *playfile, const char *recordfile, int maxtime, const char *fmt, int *duration, const char *path)
2340 {
2341         int silencethreshold;
2342         int maxsilence = 0;
2343         int res = 0;
2344         int cmd = 0;
2345         int max_attempts = 3;
2346         int attempts = 0;
2347         int recorded = 0;
2348         int message_exists = 0;
2349         /* Note that urgent and private are for flagging messages as such in the future */
2350
2351         /* barf if no pointer passed to store duration in */
2352         if (!duration) {
2353                 ast_log(LOG_WARNING, "Error ast_record_review called without duration pointer\n");
2354                 return -1;
2355         }
2356
2357         cmd = '3';       /* Want to start by recording */
2358
2359         silencethreshold = ast_dsp_get_threshold_from_settings(THRESHOLD_SILENCE);
2360
2361         while ((cmd >= 0) && (cmd != 't')) {
2362                 switch (cmd) {
2363                 case '1':
2364                         if (!message_exists) {
2365                                 /* In this case, 1 is to record a message */
2366                                 cmd = '3';
2367                                 break;
2368                         } else {
2369                                 ast_stream_and_wait(chan, "vm-msgsaved", "");
2370                                 cmd = 't';
2371                                 return res;
2372                         }
2373                 case '2':
2374                         /* Review */
2375                         ast_verb(3, "Reviewing the recording\n");
2376                         cmd = ast_stream_and_wait(chan, recordfile, AST_DIGIT_ANY);
2377                         break;
2378                 case '3':
2379                         message_exists = 0;
2380                         /* Record */
2381                         ast_verb(3, "R%secording\n", recorded == 1 ? "e-r" : "");
2382                         recorded = 1;
2383                         if ((cmd = ast_play_and_record(chan, playfile, recordfile, maxtime, fmt, duration, NULL, silencethreshold, maxsilence, path)) == -1) {
2384                                 /* User has hung up, no options to give */
2385                                 return cmd;
2386                         }
2387                         if (cmd == '0') {
2388                                 break;
2389                         } else if (cmd == '*') {
2390                                 break;
2391                         } else {
2392                                 /* If all is well, a message exists */
2393                                 message_exists = 1;
2394                                 cmd = 0;
2395                         }
2396                         break;
2397                 case '4':
2398                 case '5':
2399                 case '6':
2400                 case '7':
2401                 case '8':
2402                 case '9':
2403                 case '*':
2404                 case '#':
2405                         cmd = ast_play_and_wait(chan, "vm-sorry");
2406                         break;
2407                 default:
2408                         if (message_exists) {
2409                                 cmd = ast_play_and_wait(chan, "vm-review");
2410                         } else {
2411                                 if (!(cmd = ast_play_and_wait(chan, "vm-torerecord"))) {
2412                                         cmd = ast_waitfordigit(chan, 600);
2413                                 }
2414                         }
2415
2416                         if (!cmd) {
2417                                 cmd = ast_waitfordigit(chan, 6000);
2418                         }
2419                         if (!cmd) {
2420                                 attempts++;
2421                         }
2422                         if (attempts > max_attempts) {
2423                                 cmd = 't';
2424                         }
2425                 }
2426         }
2427         if (cmd == 't') {
2428                 cmd = 0;
2429         }
2430         return cmd;
2431 }
2432
2433 #define RES_UPONE (1 << 16)
2434 #define RES_EXIT  (1 << 17)
2435 #define RES_REPEAT (1 << 18)
2436 #define RES_RESTART ((1 << 19) | RES_REPEAT)
2437
2438 static int ast_ivr_menu_run_internal(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata);
2439
2440 static int ivr_dispatch(struct ast_channel *chan, struct ast_ivr_option *option, char *exten, void *cbdata)
2441 {
2442         int res;
2443         int (*ivr_func)(struct ast_channel *, void *);
2444         char *c;
2445         char *n;
2446
2447         switch (option->action) {
2448         case AST_ACTION_UPONE:
2449                 return RES_UPONE;
2450         case AST_ACTION_EXIT:
2451                 return RES_EXIT | (((unsigned long)(option->adata)) & 0xffff);
2452         case AST_ACTION_REPEAT:
2453                 return RES_REPEAT | (((unsigned long)(option->adata)) & 0xffff);
2454         case AST_ACTION_RESTART:
2455                 return RES_RESTART ;
2456         case AST_ACTION_NOOP:
2457                 return 0;
2458         case AST_ACTION_BACKGROUND:
2459                 res = ast_stream_and_wait(chan, (char *)option->adata, AST_DIGIT_ANY);
2460                 if (res < 0) {
2461                         ast_log(LOG_NOTICE, "Unable to find file '%s'!\n", (char *)option->adata);
2462                         res = 0;
2463                 }
2464                 return res;
2465         case AST_ACTION_PLAYBACK:
2466                 res = ast_stream_and_wait(chan, (char *)option->adata, "");
2467                 if (res < 0) {
2468                         ast_log(LOG_NOTICE, "Unable to find file '%s'!\n", (char *)option->adata);
2469                         res = 0;
2470                 }
2471                 return res;
2472         case AST_ACTION_MENU:
2473                 if ((res = ast_ivr_menu_run_internal(chan, (struct ast_ivr_menu *)option->adata, cbdata)) == -2) {
2474                         /* Do not pass entry errors back up, treat as though it was an "UPONE" */
2475                         res = 0;
2476                 }
2477                 return res;
2478         case AST_ACTION_WAITOPTION:
2479                 if (!(res = ast_waitfordigit(chan, ast_channel_pbx(chan) ? ast_channel_pbx(chan)->rtimeoutms : 10000))) {
2480                         return 't';
2481                 }
2482                 return res;
2483         case AST_ACTION_CALLBACK:
2484                 ivr_func = option->adata;
2485                 res = ivr_func(chan, cbdata);
2486                 return res;
2487         case AST_ACTION_TRANSFER:
2488                 res = ast_parseable_goto(chan, option->adata);
2489                 return 0;
2490         case AST_ACTION_PLAYLIST:
2491         case AST_ACTION_BACKLIST:
2492                 res = 0;
2493                 c = ast_strdupa(option->adata);
2494                 while ((n = strsep(&c, ";"))) {
2495                         if ((res = ast_stream_and_wait(chan, n,
2496                                         (option->action == AST_ACTION_BACKLIST) ? AST_DIGIT_ANY : ""))) {
2497                                 break;
2498                         }
2499                 }
2500                 ast_stopstream(chan);
2501                 return res;
2502         default:
2503                 ast_log(LOG_NOTICE, "Unknown dispatch function %u, ignoring!\n", option->action);
2504                 return 0;
2505         }
2506         return -1;
2507 }
2508
2509 static int option_exists(struct ast_ivr_menu *menu, char *option)
2510 {
2511         int x;
2512         for (x = 0; menu->options[x].option; x++) {
2513                 if (!strcasecmp(menu->options[x].option, option)) {
2514                         return x;
2515                 }
2516         }
2517         return -1;
2518 }
2519
2520 static int option_matchmore(struct ast_ivr_menu *menu, char *option)
2521 {
2522         int x;
2523         for (x = 0; menu->options[x].option; x++) {
2524                 if ((!strncasecmp(menu->options[x].option, option, strlen(option))) &&
2525                                 (menu->options[x].option[strlen(option)])) {
2526                         return x;
2527                 }
2528         }
2529         return -1;
2530 }
2531
2532 static int read_newoption(struct ast_channel *chan, struct ast_ivr_menu *menu, char *exten, int maxexten)
2533 {
2534         int res = 0;
2535         int ms;
2536         while (option_matchmore(menu, exten)) {
2537                 ms = ast_channel_pbx(chan) ? ast_channel_pbx(chan)->dtimeoutms : 5000;
2538                 if (strlen(exten) >= maxexten - 1) {
2539                         break;
2540                 }
2541                 if ((res = ast_waitfordigit(chan, ms)) < 1) {
2542                         break;
2543                 }
2544                 exten[strlen(exten) + 1] = '\0';
2545                 exten[strlen(exten)] = res;
2546         }
2547         return res > 0 ? 0 : res;
2548 }
2549
2550 static int ast_ivr_menu_run_internal(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata)
2551 {
2552         /* Execute an IVR menu structure */
2553         int res = 0;
2554         int pos = 0;
2555         int retries = 0;
2556         char exten[AST_MAX_EXTENSION] = "s";
2557         if (option_exists(menu, "s") < 0) {
2558                 strcpy(exten, "g");
2559                 if (option_exists(menu, "g") < 0) {
2560                         ast_log(LOG_WARNING, "No 's' nor 'g' extension in menu '%s'!\n", menu->title);
2561                         return -1;
2562                 }
2563         }
2564         while (!res) {
2565                 while (menu->options[pos].option) {
2566                         if (!strcasecmp(menu->options[pos].option, exten)) {
2567                                 res = ivr_dispatch(chan, menu->options + pos, exten, cbdata);
2568                                 ast_debug(1, "IVR Dispatch of '%s' (pos %d) yields %d\n", exten, pos, res);
2569                                 if (res < 0) {
2570                                         break;
2571                                 } else if (res & RES_UPONE) {
2572                                         return 0;
2573                                 } else if (res & RES_EXIT) {
2574                                         return res;
2575                                 } else if (res & RES_REPEAT) {
2576                                         int maxretries = res & 0xffff;
2577                                         if ((res & RES_RESTART) == RES_RESTART) {
2578                                                 retries = 0;
2579                                         } else {
2580                                                 retries++;
2581                                         }
2582                                         if (!maxretries) {
2583                                                 maxretries = 3;
2584                                         }
2585                                         if ((maxretries > 0) && (retries >= maxretries)) {
2586                                                 ast_debug(1, "Max retries %d exceeded\n", maxretries);
2587                                                 return -2;
2588                                         } else {
2589                                                 if (option_exists(menu, "g") > -1) {
2590                                                         strcpy(exten, "g");
2591                                                 } else if (option_exists(menu, "s") > -1) {
2592                                                         strcpy(exten, "s");
2593                                                 }
2594                                         }
2595                                         pos = 0;
2596                                         continue;
2597                                 } else if (res && strchr(AST_DIGIT_ANY, res)) {
2598                                         ast_debug(1, "Got start of extension, %c\n", res);
2599                                         exten[1] = '\0';
2600                                         exten[0] = res;
2601                                         if ((res = read_newoption(chan, menu, exten, sizeof(exten)))) {
2602                                                 break;
2603                                         }
2604                                         if (option_exists(menu, exten) < 0) {
2605                                                 if (option_exists(menu, "i")) {
2606                                                         ast_debug(1, "Invalid extension entered, going to 'i'!\n");
2607                                                         strcpy(exten, "i");
2608                                                         pos = 0;
2609                                                         continue;
2610                                                 } else {
2611                                                         ast_debug(1, "Aborting on invalid entry, with no 'i' option!\n");
2612                                                         res = -2;
2613                                                         break;
2614                                                 }
2615                                         } else {
2616                                                 ast_debug(1, "New existing extension: %s\n", exten);
2617                                                 pos = 0;
2618                                                 continue;
2619                                         }
2620                                 }
2621                         }
2622                         pos++;
2623                 }
2624                 ast_debug(1, "Stopping option '%s', res is %d\n", exten, res);
2625                 pos = 0;
2626                 if (!strcasecmp(exten, "s")) {
2627                         strcpy(exten, "g");
2628                 } else {
2629                         break;
2630                 }
2631         }
2632         return res;
2633 }
2634
2635 int ast_ivr_menu_run(struct ast_channel *chan, struct ast_ivr_menu *menu, void *cbdata)
2636 {
2637         int res = ast_ivr_menu_run_internal(chan, menu, cbdata);
2638         /* Hide internal coding */
2639         return res > 0 ? 0 : res;
2640 }
2641
2642 char *ast_read_textfile(const char *filename)
2643 {
2644         int fd, count = 0, res;
2645         char *output = NULL;
2646         struct stat filesize;
2647
2648         if (stat(filename, &filesize) == -1) {
2649                 ast_log(LOG_WARNING, "Error can't stat %s\n", filename);
2650                 return NULL;
2651         }
2652
2653         count = filesize.st_size + 1;
2654
2655         if ((fd = open(filename, O_RDONLY)) < 0) {
2656                 ast_log(LOG_WARNING, "Cannot open file '%s' for reading: %s\n", filename, strerror(errno));
2657                 return NULL;
2658         }
2659
2660         if ((output = ast_malloc(count))) {
2661                 res = read(fd, output, count - 1);
2662                 if (res == count - 1) {
2663                         output[res] = '\0';
2664                 } else {
2665                         ast_log(LOG_WARNING, "Short read of %s (%d of %d): %s\n", filename, res, count - 1, strerror(errno));
2666                         ast_free(output);
2667                         output = NULL;
2668                 }
2669         }
2670
2671         close(fd);
2672
2673         return output;
2674 }
2675
2676 static int parse_options(const struct ast_app_option *options, void *_flags, char **args, char *optstr, int flaglen)
2677 {
2678         char *s, *arg;
2679         int curarg, res = 0;
2680         unsigned int argloc;
2681         struct ast_flags *flags = _flags;
2682         struct ast_flags64 *flags64 = _flags;
2683
2684         if (flaglen == 32) {
2685                 ast_clear_flag(flags, AST_FLAGS_ALL);
2686         } else {
2687                 flags64->flags = 0;
2688         }
2689
2690         if (!optstr) {
2691                 return 0;
2692         }
2693
2694         s = optstr;
2695         while (*s) {
2696                 curarg = *s++ & 0x7f;   /* the array (in app.h) has 128 entries */
2697                 argloc = options[curarg].arg_index;
2698                 if (*s == '(') {
2699                         int paren = 1, quote = 0;
2700                         int parsequotes = (s[1] == '"') ? 1 : 0;
2701
2702                         /* Has argument */
2703                         arg = ++s;
2704                         for (; *s; s++) {
2705                                 if (*s == '(' && !quote) {
2706                                         paren++;
2707                                 } else if (*s == ')' && !quote) {
2708                                         /* Count parentheses, unless they're within quotes (or backslashed, below) */
2709                                         paren--;
2710                                 } else if (*s == '"' && parsequotes) {
2711                                         /* Leave embedded quotes alone, unless they are the first character */
2712                                         quote = quote ? 0 : 1;
2713                                         ast_copy_string(s, s + 1, INT_MAX);
2714                                         s--;
2715                                 } else if (*s == '\\') {
2716                                         if (!quote) {
2717                                                 /* If a backslash is found outside of quotes, remove it */
2718                                                 ast_copy_string(s, s + 1, INT_MAX);
2719                                         } else if (quote && s[1] == '"') {
2720                                                 /* Backslash for a quote character within quotes, remove the backslash */
2721                                                 ast_copy_string(s, s + 1, INT_MAX);
2722                                         } else {
2723                                                 /* Backslash within quotes, keep both characters */
2724                                                 s++;
2725                                         }
2726                                 }
2727
2728                                 if (paren == 0) {
2729                                         break;
2730                                 }
2731                         }
2732                         /* This will find the closing paren we found above, or none, if the string ended before we found one. */
2733                         if ((s = strchr(s, ')'))) {
2734                                 if (argloc) {
2735                                         args[argloc - 1] = arg;
2736                                 }
2737                                 *s++ = '\0';
2738                         } else {
2739                                 ast_log(LOG_WARNING, "Missing closing parenthesis for argument '%c' in string '%s'\n", curarg, arg);
2740                                 res = -1;
2741                                 break;
2742                         }
2743                 } else if (argloc) {
2744                         args[argloc - 1] = "";
2745                 }
2746                 if (flaglen == 32) {
2747                         ast_set_flag(flags, options[curarg].flag);
2748                 } else {
2749                         ast_set_flag64(flags64, options[curarg].flag);
2750                 }
2751         }
2752
2753         return res;
2754 }
2755
2756 int ast_app_parse_options(const struct ast_app_option *options, struct ast_flags *flags, char **args, char *optstr)
2757 {
2758         return parse_options(options, flags, args, optstr, 32);
2759 }
2760
2761 int ast_app_parse_options64(const struct ast_app_option *options, struct ast_flags64 *flags, char **args, char *optstr)
2762 {
2763         return parse_options(options, flags, args, optstr, 64);
2764 }
2765
2766 void ast_app_options2str64(const struct ast_app_option *options, struct ast_flags64 *flags, char *buf, size_t len)
2767 {
2768         unsigned int i, found = 0;
2769         for (i = 32; i < 128 && found < len; i++) {
2770                 if (ast_test_flag64(flags, options[i].flag)) {
2771                         buf[found++] = i;
2772                 }
2773         }
2774         buf[found] = '\0';
2775 }
2776
2777 int ast_get_encoded_char(const char *stream, char *result, size_t *consumed)
2778 {
2779         int i;
2780         *consumed = 1;
2781         *result = 0;
2782         if (ast_strlen_zero(stream)) {
2783                 *consumed = 0;
2784                 return -1;
2785         }
2786
2787         if (*stream == '\\') {
2788                 *consumed = 2;
2789                 switch (*(stream + 1)) {
2790                 case 'n':
2791                         *result = '\n';
2792                         break;
2793                 case 'r':
2794                         *result = '\r';
2795                         break;
2796                 case 't':
2797                         *result = '\t';
2798                         break;
2799                 case 'x':
2800                         /* Hexadecimal */
2801                         if (strchr("0123456789ABCDEFabcdef", *(stream + 2)) && *(stream + 2) != '\0') {
2802                                 *consumed = 3;
2803                                 if (*(stream + 2) <= '9') {
2804                                         *result = *(stream + 2) - '0';
2805                                 } else if (*(stream + 2) <= 'F') {
2806                                         *result = *(stream + 2) - 'A' + 10;
2807                                 } else {
2808                                         *result = *(stream + 2) - 'a' + 10;
2809                                 }
2810                         } else {
2811                                 ast_log(LOG_ERROR, "Illegal character '%c' in hexadecimal string\n", *(stream + 2));
2812                                 return -1;
2813                         }
2814
2815                         if (strchr("0123456789ABCDEFabcdef", *(stream + 3)) && *(stream + 3) != '\0') {
2816                                 *consumed = 4;
2817                                 *result <<= 4;
2818                                 if (*(stream + 3) <= '9') {
2819                                         *result += *(stream + 3) - '0';
2820                                 } else if (*(stream + 3) <= 'F') {
2821                                         *result += *(stream + 3) - 'A' + 10;
2822                                 } else {
2823                                         *result += *(stream + 3) - 'a' + 10;
2824                                 }
2825                         }
2826                         break;
2827                 case '0':
2828                         /* Octal */
2829                         *consumed = 2;
2830                         for (i = 2; ; i++) {
2831                                 if (strchr("01234567", *(stream + i)) && *(stream + i) != '\0') {
2832                                         (*consumed)++;
2833                                         ast_debug(5, "result was %d, ", *result);
2834                                         *result <<= 3;
2835                                         *result += *(stream + i) - '0';
2836                                         ast_debug(5, "is now %d\n", *result);
2837                                 } else {
2838                                         break;
2839                                 }
2840                         }
2841                         break;
2842                 default:
2843                         *result = *(stream + 1);
2844                 }
2845         } else {
2846                 *result = *stream;
2847                 *consumed = 1;
2848         }
2849         return 0;
2850 }
2851
2852 char *ast_get_encoded_str(const char *stream, char *result, size_t result_size)
2853 {
2854         char *cur = result;
2855         size_t consumed;
2856
2857         while (cur < result + result_size - 1 && !ast_get_encoded_char(stream, cur, &consumed)) {
2858                 cur++;
2859                 stream += consumed;
2860         }
2861         *cur = '\0';
2862         return result;
2863 }
2864
2865 int ast_str_get_encoded_str(struct ast_str **str, int maxlen, const char *stream)
2866 {
2867         char next, *buf;
2868         size_t offset = 0;
2869         size_t consumed;
2870
2871         if (strchr(stream, '\\')) {
2872                 while (!ast_get_encoded_char(stream, &next, &consumed)) {
2873                         if (offset + 2 > ast_str_size(*str) && maxlen > -1) {
2874                                 ast_str_make_space(str, maxlen > 0 ? maxlen : (ast_str_size(*str) + 48) * 2 - 48);
2875                         }
2876                         if (offset + 2 > ast_str_size(*str)) {
2877                                 break;
2878                         }
2879                         buf = ast_str_buffer(*str);
2880                         buf[offset++] = next;
2881                         stream += consumed;
2882                 }
2883                 buf = ast_str_buffer(*str);
2884                 buf[offset++] = '\0';
2885                 ast_str_update(*str);
2886         } else {
2887                 ast_str_set(str, maxlen, "%s", stream);
2888         }
2889         return 0;
2890 }
2891
2892 void ast_close_fds_above_n(int n)
2893 {
2894         closefrom(n + 1);
2895 }
2896
2897 int ast_safe_fork(int stop_reaper)
2898 {
2899         sigset_t signal_set, old_set;
2900         int pid;
2901
2902         /* Don't let the default signal handler for children reap our status */
2903         if (stop_reaper) {
2904                 ast_replace_sigchld();
2905         }
2906
2907         sigfillset(&signal_set);
2908         pthread_sigmask(SIG_BLOCK, &signal_set, &old_set);
2909
2910         pid = fork();
2911
2912         if (pid != 0) {
2913                 /* Fork failed or parent */
2914                 pthread_sigmask(SIG_SETMASK, &old_set, NULL);
2915                 if (!stop_reaper && pid > 0) {
2916                         struct zombie *cur = ast_calloc(1, sizeof(*cur));
2917                         if (cur) {
2918                                 cur->pid = pid;
2919                                 AST_LIST_LOCK(&zombies);
2920                                 AST_LIST_INSERT_TAIL(&zombies, cur, list);
2921                                 AST_LIST_UNLOCK(&zombies);
2922                                 if (shaun_of_the_dead_thread == AST_PTHREADT_NULL) {
2923                                         if (ast_pthread_create_background(&shaun_of_the_dead_thread, NULL, shaun_of_the_dead, NULL)) {
2924                                                 ast_log(LOG_ERROR, "Shaun of the Dead wants to kill zombies, but can't?!!\n");
2925                                                 shaun_of_the_dead_thread = AST_PTHREADT_NULL;
2926                                         }
2927                                 }
2928                         }
2929                 }
2930                 return pid;
2931         } else {
2932                 /* Child */
2933 #ifdef HAVE_CAP
2934                 cap_t cap = cap_from_text("cap_net_admin-eip");
2935
2936                 if (cap_set_proc(cap)) {
2937                         ast_log(LOG_WARNING, "Unable to remove capabilities.\n");
2938                 }
2939                 cap_free(cap);
2940 #endif
2941
2942                 /* Before we unblock our signals, return our trapped signals back to the defaults */
2943                 signal(SIGHUP, SIG_DFL);
2944                 signal(SIGCHLD, SIG_DFL);
2945                 signal(SIGINT, SIG_DFL);
2946                 signal(SIGURG, SIG_DFL);
2947                 signal(SIGTERM, SIG_DFL);
2948                 signal(SIGPIPE, SIG_DFL);
2949                 signal(SIGXFSZ, SIG_DFL);
2950
2951                 /* unblock important signal handlers */
2952                 if (pthread_sigmask(SIG_UNBLOCK, &signal_set, NULL)) {
2953                         ast_log(LOG_WARNING, "unable to unblock signals: %s\n", strerror(errno));
2954                         _exit(1);
2955                 }
2956
2957                 return pid;
2958         }
2959 }
2960
2961 void ast_safe_fork_cleanup(void)
2962 {
2963         ast_unreplace_sigchld();
2964 }
2965
2966 int ast_app_parse_timelen(const char *timestr, int *result, enum ast_timelen unit)
2967 {
2968         int res;
2969         char u[10];
2970 #ifdef HAVE_LONG_DOUBLE_WIDER
2971         long double amount;
2972         #define FMT "%30Lf%9s"
2973 #else
2974         double amount;
2975         #define FMT "%30lf%9s"
2976 #endif
2977         if (!timestr) {
2978                 return -1;
2979         }
2980
2981         res = sscanf(timestr, FMT, &amount, u);
2982
2983         if (res == 0 || res == EOF) {
2984 #undef FMT
2985                 return -1;
2986         } else if (res == 2) {
2987                 switch (u[0]) {
2988                 case 'h':
2989                 case 'H':
2990                         unit = TIMELEN_HOURS;
2991                         break;
2992                 case 's':
2993                 case 'S':
2994                         unit = TIMELEN_SECONDS;
2995                         break;
2996                 case 'm':
2997                 case 'M':
2998                         if (toupper(u[1]) == 'S') {
2999                                 unit = TIMELEN_MILLISECONDS;
3000                         } else if (u[1] == '\0') {
3001                                 unit = TIMELEN_MINUTES;
3002                         }
3003                         break;
3004                 }
3005         }
3006
3007         switch (unit) {
3008         case TIMELEN_HOURS:
3009                 amount *= 60;
3010                 /* fall-through */
3011         case TIMELEN_MINUTES:
3012                 amount *= 60;
3013                 /* fall-through */
3014         case TIMELEN_SECONDS:
3015                 amount *= 1000;
3016                 /* fall-through */
3017         case TIMELEN_MILLISECONDS:
3018                 ;
3019         }
3020         *result = amount > INT_MAX ? INT_MAX : (int) amount;
3021         return 0;
3022 }
3023
3024
3025
3026 static void mwi_state_dtor(void *obj)
3027 {
3028         struct ast_mwi_state *mwi_state = obj;
3029         ast_string_field_free_memory(mwi_state);
3030         ao2_cleanup(mwi_state->snapshot);
3031         mwi_state->snapshot = NULL;
3032 }
3033
3034 struct stasis_topic *ast_mwi_topic_all(void)
3035 {
3036         return mwi_topic_all;
3037 }
3038
3039 struct stasis_cache *ast_mwi_state_cache(void)
3040 {
3041         return mwi_state_cache;
3042 }
3043
3044 struct stasis_topic *ast_mwi_topic_cached(void)
3045 {
3046         return stasis_caching_get_topic(mwi_topic_cached);
3047 }
3048
3049 struct stasis_topic *ast_mwi_topic(const char *uniqueid)
3050 {
3051         return stasis_topic_pool_get_topic(mwi_topic_pool, uniqueid);
3052 }
3053
3054 struct ast_mwi_state *ast_mwi_create(const char *mailbox, const char *context)
3055 {
3056         RAII_VAR(struct ast_mwi_state *, mwi_state, NULL, ao2_cleanup);
3057
3058         ast_assert(!ast_strlen_zero(mailbox));
3059
3060         mwi_state = ao2_alloc(sizeof(*mwi_state), mwi_state_dtor);
3061         if (!mwi_state) {
3062                 return NULL;
3063         }
3064
3065         if (ast_string_field_init(mwi_state, 256)) {
3066                 return NULL;
3067         }
3068         if (!ast_strlen_zero(context)) {
3069                 ast_string_field_build(mwi_state, uniqueid, "%s@%s", mailbox, context);
3070         } else {
3071                 ast_string_field_set(mwi_state, uniqueid, mailbox);
3072         }
3073
3074         ao2_ref(mwi_state, +1);
3075         return mwi_state;
3076 }
3077
3078 /*!
3079  * \internal
3080  * \brief Create a MWI state snapshot message.
3081  * \since 12.2.0
3082  *
3083  * \param[in] mailbox The mailbox identifier string.
3084  * \param[in] context The context this mailbox resides in (NULL or "" if only using mailbox)
3085  * \param[in] new_msgs The number of new messages in this mailbox
3086  * \param[in] old_msgs The number of old messages in this mailbox
3087  * \param[in] channel_id A unique identifier for a channel associated with this
3088  * change in mailbox state
3089  * \param[in] eid The EID of the server that originally published the message
3090  *
3091  * \retval message on success.  Use ao2_cleanup() when done with it.
3092  * \retval NULL on error.
3093  */
3094 static struct stasis_message *mwi_state_create_message(
3095         const char *mailbox,
3096         const char *context,
3097         int new_msgs,
3098         int old_msgs,
3099         const char *channel_id,
3100         struct ast_eid *eid)
3101 {
3102         struct ast_mwi_state *mwi_state;
3103         struct stasis_message *message;
3104
3105         if (!ast_mwi_state_type()) {
3106                 return NULL;
3107         }
3108
3109         mwi_state = ast_mwi_create(mailbox, context);
3110         if (!mwi_state) {
3111                 return NULL;
3112         }
3113
3114         mwi_state->new_msgs = new_msgs;
3115         mwi_state->old_msgs = old_msgs;
3116
3117         if (!ast_strlen_zero(channel_id)) {
3118                 struct stasis_message *chan_message;
3119
3120                 chan_message = stasis_cache_get(ast_channel_cache(), ast_channel_snapshot_type(),
3121                         channel_id);
3122                 if (chan_message) {
3123                         mwi_state->snapshot = stasis_message_data(chan_message);
3124                         ao2_ref(mwi_state->snapshot, +1);
3125                 }
3126                 ao2_cleanup(chan_message);
3127         }
3128
3129         if (eid) {
3130                 mwi_state->eid = *eid;
3131         } else {
3132                 mwi_state->eid = ast_eid_default;
3133         }
3134
3135         /*
3136          * XXX As far as stasis is concerned, all MWI events are local.
3137          *
3138          * We may in the future want to make MWI aggregate local/remote
3139          * message counts similar to how device state aggregates state.
3140          */
3141         message = stasis_message_create_full(ast_mwi_state_type(), mwi_state, &ast_eid_default);
3142         ao2_cleanup(mwi_state);
3143         return message;
3144 }
3145
3146 int ast_publish_mwi_state_full(
3147         const char *mailbox,
3148         const char *context,
3149         int new_msgs,
3150         int old_msgs,
3151         const char *channel_id,
3152         struct ast_eid *eid)
3153 {
3154         struct ast_mwi_state *mwi_state;
3155         RAII_VAR(struct stasis_message *, message, NULL, ao2_cleanup);
3156         struct stasis_topic *mailbox_specific_topic;
3157
3158         message = mwi_state_create_message(mailbox, context, new_msgs, old_msgs, channel_id, eid);
3159         if (!message) {
3160                 return -1;
3161         }
3162
3163         mwi_state = stasis_message_data(message);
3164         mailbox_specific_topic = ast_mwi_topic(mwi_state->uniqueid);
3165         if (!mailbox_specific_topic) {
3166                 return -1;
3167         }
3168
3169         stasis_publish(mailbox_specific_topic, message);
3170
3171         return 0;
3172 }
3173
3174 int ast_delete_mwi_state_full(const char *mailbox, const char *context, struct ast_eid *eid)
3175 {
3176         RAII_VAR(struct stasis_message *, msg, NULL, ao2_cleanup);
3177         struct stasis_message *cached_msg;
3178         struct stasis_message *clear_msg;
3179         struct ast_mwi_state *mwi_state;
3180         struct stasis_topic *mailbox_specific_topic;
3181
3182         msg = mwi_state_create_message(mailbox, context, 0, 0, NULL, eid);
3183         if (!msg) {
3184                 return -1;
3185         }
3186
3187         mwi_state = stasis_message_data(msg);
3188
3189         /*
3190          * XXX As far as stasis is concerned, all MWI events are local.
3191          *
3192          * For now, it is assumed that there is only one entity
3193          * maintaining the state of a particular mailbox.
3194          *
3195          * If we ever have multiple MWI event entities maintaining
3196          * the same mailbox that wish to delete their cached entry
3197          * we will need to do something about the race condition
3198          * potential between checking the cache and removing the
3199          * cache entry.
3200          */
3201         cached_msg = stasis_cache_get_by_eid(ast_mwi_state_cache(),
3202                 ast_mwi_state_type(), mwi_state->uniqueid, &ast_eid_default);
3203         if (!cached_msg) {
3204                 /* Nothing to clear */
3205                 return -1;
3206         }
3207         ao2_cleanup(cached_msg);
3208
3209         mailbox_specific_topic = ast_mwi_topic(mwi_state->uniqueid);
3210         if (!mailbox_specific_topic) {
3211                 return -1;
3212         }
3213
3214         clear_msg = stasis_cache_clear_create(msg);
3215         if (clear_msg) {
3216                 stasis_publish(mailbox_specific_topic, clear_msg);
3217         }
3218         ao2_cleanup(clear_msg);
3219         return 0;
3220 }
3221
3222 static const char *mwi_state_get_id(struct stasis_message *message)
3223 {
3224         if (ast_mwi_state_type() == stasis_message_type(message)) {
3225                 struct ast_mwi_state *mwi_state = stasis_message_data(message);
3226                 return mwi_state->uniqueid;
3227         } else if (stasis_subscription_change_type() == stasis_message_type(message)) {
3228                 struct stasis_subscription_change *change = stasis_message_data(message);
3229                 return change->uniqueid;
3230         }
3231
3232         return NULL;
3233 }
3234
3235 static void mwi_blob_dtor(void *obj)
3236 {
3237         struct ast_mwi_blob *mwi_blob = obj;
3238
3239         ao2_cleanup(mwi_blob->mwi_state);
3240         ast_json_unref(mwi_blob->blob);
3241 }
3242
3243 struct stasis_message *ast_mwi_blob_create(struct ast_mwi_state *mwi_state,
3244                                                struct stasis_message_type *message_type,
3245                                                struct ast_json *blob)
3246 {
3247         RAII_VAR(struct ast_mwi_blob *, obj, NULL, ao2_cleanup);
3248         RAII_VAR(struct stasis_message *, msg, NULL, ao2_cleanup);
3249
3250         ast_assert(blob != NULL);
3251
3252         if (!message_type) {
3253                 return NULL;
3254         }
3255
3256         obj = ao2_alloc(sizeof(*obj), mwi_blob_dtor);
3257         if (!obj) {
3258                 return NULL;
3259         }
3260
3261         obj->mwi_state = mwi_state;
3262         ao2_ref(obj->mwi_state, +1);
3263         obj->blob = ast_json_ref(blob);
3264
3265         /* This is not a normal MWI event.  Only used by the MinivmNotify app. */
3266         msg = stasis_message_create(message_type, obj);
3267         if (!msg) {
3268                 return NULL;
3269         }
3270
3271         ao2_ref(msg, +1);
3272         return msg;
3273 }
3274
3275 struct stasis_topic *ast_queue_topic_all(void)
3276 {
3277         return queue_topic_all;
3278 }
3279
3280 struct stasis_topic *ast_queue_topic(const char *queuename)
3281 {
3282         return stasis_topic_pool_get_topic(queue_topic_pool, queuename);
3283 }
3284
3285 static void app_cleanup(void)
3286 {
3287         ao2_cleanup(queue_topic_pool);
3288         queue_topic_pool = NULL;
3289         ao2_cleanup(queue_topic_all);
3290         queue_topic_all = NULL;
3291         ao2_cleanup(mwi_topic_pool);
3292         mwi_topic_pool = NULL;
3293         ao2_cleanup(mwi_topic_all);
3294         mwi_topic_all = NULL;
3295         ao2_cleanup(mwi_state_cache);
3296         mwi_state_cache = NULL;
3297         mwi_topic_cached = stasis_caching_unsubscribe_and_join(mwi_topic_cached);
3298         STASIS_MESSAGE_TYPE_CLEANUP(ast_mwi_state_type);
3299         STASIS_MESSAGE_TYPE_CLEANUP(ast_mwi_vm_app_type);
3300 }
3301
3302 int app_init(void)
3303 {
3304         ast_register_cleanup(app_cleanup);
3305
3306         if (STASIS_MESSAGE_TYPE_INIT(ast_mwi_state_type) != 0) {
3307                 return -1;
3308         }
3309         if (STASIS_MESSAGE_TYPE_INIT(ast_mwi_vm_app_type) != 0) {
3310                 return -1;
3311         }
3312         mwi_topic_all = stasis_topic_create("stasis_mwi_topic");
3313         if (!mwi_topic_all) {
3314                 return -1;
3315         }
3316         mwi_state_cache = stasis_cache_create(mwi_state_get_id);
3317         if (!mwi_state_cache) {
3318                 return -1;
3319         }
3320         mwi_topic_cached = stasis_caching_topic_create(mwi_topic_all, mwi_state_cache);
3321         if (!mwi_topic_cached) {
3322                 return -1;
3323         }
3324         mwi_topic_pool = stasis_topic_pool_create(mwi_topic_all);
3325         if (!mwi_topic_pool) {
3326                 return -1;
3327         }
3328         queue_topic_all = stasis_topic_create("stasis_queue_topic");
3329         if (!queue_topic_all) {
3330                 return -1;
3331         }
3332         queue_topic_pool = stasis_topic_pool_create(queue_topic_all);
3333         if (!queue_topic_pool) {
3334                 return -1;
3335         }
3336         return 0;
3337 }
3338