2 * Asterisk -- An open source telephony toolkit.
4 * Copyright (C) 1999 - 2010, Digium, Inc.
6 * Mark Spencer <markster@digium.com>
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.
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.
21 * \brief Full-featured outgoing call spool support
27 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
34 #include <sys/inotify.h>
35 #elif defined(HAVE_KQUEUE)
36 #include <sys/types.h>
38 #include <sys/event.h>
42 #include "asterisk/paths.h" /* use ast_config_AST_SPOOL_DIR */
43 #include "asterisk/lock.h"
44 #include "asterisk/file.h"
45 #include "asterisk/logger.h"
46 #include "asterisk/channel.h"
47 #include "asterisk/callerid.h"
48 #include "asterisk/pbx.h"
49 #include "asterisk/module.h"
50 #include "asterisk/utils.h"
51 #include "asterisk/options.h"
54 * pbx_spool is similar in spirit to qcall, but with substantially enhanced functionality...
55 * The spool file contains a header
59 /*! Always delete the call file after a call succeeds or the
60 * maximum number of retries is exceeded, even if the
61 * modification time of the call file is in the future.
63 SPOOL_FLAG_ALWAYS_DELETE = (1 << 0),
64 /* Don't unlink the call file after processing, move in qdonedir */
65 SPOOL_FLAG_ARCHIVE = (1 << 1),
68 static char qdir[255];
69 static char qdonedir[255];
72 int retries; /*!< Current number of retries */
73 int maxretries; /*!< Maximum number of retries permitted */
74 int retrytime; /*!< How long to wait between retries (in seconds) */
75 int waittime; /*!< How long to wait for an answer */
76 long callingpid; /*!< PID which is currently calling */
77 format_t format; /*!< Formats (codecs) for this call */
78 AST_DECLARE_STRING_FIELDS (
79 AST_STRING_FIELD(fn); /*!< File name of call file */
80 AST_STRING_FIELD(tech); /*!< Which channel technology to use for outgoing call */
81 AST_STRING_FIELD(dest); /*!< Which device/line to use for outgoing call */
82 AST_STRING_FIELD(app); /*!< If application: Application name */
83 AST_STRING_FIELD(data); /*!< If application: Application data */
84 AST_STRING_FIELD(exten); /*!< If extension/context/priority: Extension in dialplan */
85 AST_STRING_FIELD(context); /*!< If extension/context/priority: Dialplan context */
86 AST_STRING_FIELD(cid_num); /*!< CallerID Information: Number/extension */
87 AST_STRING_FIELD(cid_name); /*!< CallerID Information: Name */
88 AST_STRING_FIELD(account); /*!< account code */
90 int priority; /*!< If extension/context/priority: Dialplan priority */
91 struct ast_variable *vars; /*!< Variables and Functions */
92 int maxlen; /*!< Maximum length of call */
93 struct ast_flags options; /*!< options */
96 #if defined(HAVE_INOTIFY) || defined(HAVE_KQUEUE)
97 static void queue_file(const char *filename, time_t when);
100 static int init_outgoing(struct outgoing *o)
105 o->format = AST_FORMAT_SLINEAR;
106 ast_set_flag(&o->options, SPOOL_FLAG_ALWAYS_DELETE);
107 if (ast_string_field_init(o, 128)) {
113 static void free_outgoing(struct outgoing *o)
116 ast_variables_destroy(o->vars);
118 ast_string_field_free_memory(o);
122 static int apply_outgoing(struct outgoing *o, const char *fn, FILE *f)
127 struct ast_variable *var, *last = o->vars;
129 while (last && last->next) {
133 while(fgets(buf, sizeof(buf), f)) {
137 while ((c = strchr(c, '#'))) {
138 if ((c == buf) || (*(c-1) == ' ') || (*(c-1) == '\t'))
145 while ((c = strchr(c, ';'))) {
146 if ((c > buf) && (c[-1] == '\\')) {
147 memmove(c - 1, c, strlen(c) + 1);
155 /* Trim trailing white space */
156 while(!ast_strlen_zero(buf) && buf[strlen(buf) - 1] < 33)
157 buf[strlen(buf) - 1] = '\0';
158 if (!ast_strlen_zero(buf)) {
159 c = strchr(buf, ':');
163 while ((*c) && (*c < 33))
166 printf("'%s' is '%s' at line %d\n", buf, c, lineno);
168 if (!strcasecmp(buf, "channel")) {
169 if ((c2 = strchr(c, '/'))) {
172 ast_string_field_set(o, tech, c);
173 ast_string_field_set(o, dest, c2);
175 ast_log(LOG_NOTICE, "Channel should be in form Tech/Dest at line %d of %s\n", lineno, fn);
177 } else if (!strcasecmp(buf, "callerid")) {
178 char cid_name[80] = {0}, cid_num[80] = {0};
179 ast_callerid_split(c, cid_name, sizeof(cid_name), cid_num, sizeof(cid_num));
180 ast_string_field_set(o, cid_num, cid_num);
181 ast_string_field_set(o, cid_name, cid_name);
182 } else if (!strcasecmp(buf, "application")) {
183 ast_string_field_set(o, app, c);
184 } else if (!strcasecmp(buf, "data")) {
185 ast_string_field_set(o, data, c);
186 } else if (!strcasecmp(buf, "maxretries")) {
187 if (sscanf(c, "%30d", &o->maxretries) != 1) {
188 ast_log(LOG_WARNING, "Invalid max retries at line %d of %s\n", lineno, fn);
191 } else if (!strcasecmp(buf, "codecs")) {
192 ast_parse_allow_disallow(NULL, &o->format, c, 1);
193 } else if (!strcasecmp(buf, "context")) {
194 ast_string_field_set(o, context, c);
195 } else if (!strcasecmp(buf, "extension")) {
196 ast_string_field_set(o, exten, c);
197 } else if (!strcasecmp(buf, "priority")) {
198 if ((sscanf(c, "%30d", &o->priority) != 1) || (o->priority < 1)) {
199 ast_log(LOG_WARNING, "Invalid priority at line %d of %s\n", lineno, fn);
202 } else if (!strcasecmp(buf, "retrytime")) {
203 if ((sscanf(c, "%30d", &o->retrytime) != 1) || (o->retrytime < 1)) {
204 ast_log(LOG_WARNING, "Invalid retrytime at line %d of %s\n", lineno, fn);
207 } else if (!strcasecmp(buf, "waittime")) {
208 if ((sscanf(c, "%30d", &o->waittime) != 1) || (o->waittime < 1)) {
209 ast_log(LOG_WARNING, "Invalid waittime at line %d of %s\n", lineno, fn);
212 } else if (!strcasecmp(buf, "retry")) {
214 } else if (!strcasecmp(buf, "startretry")) {
215 if (sscanf(c, "%30ld", &o->callingpid) != 1) {
216 ast_log(LOG_WARNING, "Unable to retrieve calling PID!\n");
219 } else if (!strcasecmp(buf, "endretry") || !strcasecmp(buf, "abortretry")) {
222 } else if (!strcasecmp(buf, "delayedretry")) {
223 } else if (!strcasecmp(buf, "setvar") || !strcasecmp(buf, "set")) {
227 var = ast_variable_new(c, c2, fn);
229 /* Always insert at the end, because some people want to treat the spool file as a script */
238 ast_log(LOG_WARNING, "Malformed \"%s\" argument. Should be \"%s: variable=value\"\n", buf, buf);
239 } else if (!strcasecmp(buf, "account")) {
240 ast_string_field_set(o, account, c);
241 } else if (!strcasecmp(buf, "alwaysdelete")) {
242 ast_set2_flag(&o->options, ast_true(c), SPOOL_FLAG_ALWAYS_DELETE);
243 } else if (!strcasecmp(buf, "archive")) {
244 ast_set2_flag(&o->options, ast_true(c), SPOOL_FLAG_ARCHIVE);
246 ast_log(LOG_WARNING, "Unknown keyword '%s' at line %d of %s\n", buf, lineno, fn);
249 ast_log(LOG_NOTICE, "Syntax error at line %d of %s\n", lineno, fn);
252 ast_string_field_set(o, fn, fn);
253 if (ast_strlen_zero(o->tech) || ast_strlen_zero(o->dest) || (ast_strlen_zero(o->app) && ast_strlen_zero(o->exten))) {
254 ast_log(LOG_WARNING, "At least one of app or extension must be specified, along with tech and dest in file %s\n", fn);
260 static void safe_append(struct outgoing *o, time_t now, char *s)
263 struct utimbuf tbuf = { .actime = now, .modtime = now + o->retrytime };
265 ast_debug(1, "Outgoing %s/%s: %s\n", o->tech, o->dest, s);
267 if ((f = fopen(o->fn, "a"))) {
268 fprintf(f, "\n%s: %ld %d (%ld)\n", s, (long)ast_mainpid, o->retries, (long) now);
272 /* Update the file time */
273 if (utime(o->fn, &tbuf)) {
274 ast_log(LOG_WARNING, "Unable to set utime on %s: %s\n", o->fn, strerror(errno));
279 * \brief Remove a call file from the outgoing queue optionally moving it in the archive dir
281 * \param o the pointer to outgoing struct
282 * \param status the exit status of the call. Can be "Completed", "Failed" or "Expired"
284 static int remove_from_queue(struct outgoing *o, const char *status)
290 if (!ast_test_flag(&o->options, SPOOL_FLAG_ALWAYS_DELETE)) {
291 struct stat current_file_status;
293 if (!stat(o->fn, ¤t_file_status)) {
294 if (time(NULL) < current_file_status.st_mtime) {
300 if (!ast_test_flag(&o->options, SPOOL_FLAG_ARCHIVE)) {
305 if (ast_mkdir(qdonedir, 0777)) {
306 ast_log(LOG_WARNING, "Unable to create queue directory %s -- outgoing spool archiving disabled\n", qdonedir);
311 if (!(bname = strrchr(o->fn, '/'))) {
317 snprintf(newfn, sizeof(newfn), "%s/%s", qdonedir, bname);
318 /* a existing call file the archive dir is overwritten */
320 if (rename(o->fn, newfn) != 0) {
325 /* Only append to the file AFTER we move it out of the watched directory,
326 * otherwise the fclose() causes another event for inotify(7) */
327 if ((f = fopen(newfn, "a"))) {
328 fprintf(f, "Status: %s\n", status);
335 static void *attempt_thread(void *data)
337 struct outgoing *o = data;
339 if (!ast_strlen_zero(o->app)) {
340 ast_verb(3, "Attempting call on %s/%s for application %s(%s) (Retry %d)\n", o->tech, o->dest, o->app, o->data, o->retries);
341 res = ast_pbx_outgoing_app(o->tech, o->format, (void *) o->dest, o->waittime * 1000, o->app, o->data, &reason, 2 /* wait to finish */, o->cid_num, o->cid_name, o->vars, o->account, NULL);
344 ast_verb(3, "Attempting call on %s/%s for %s@%s:%d (Retry %d)\n", o->tech, o->dest, o->exten, o->context,o->priority, o->retries);
345 res = ast_pbx_outgoing_exten(o->tech, o->format, (void *) o->dest, o->waittime * 1000, o->context, o->exten, o->priority, &reason, 2 /* wait to finish */, o->cid_num, o->cid_name, o->vars, o->account, NULL);
349 ast_log(LOG_NOTICE, "Call failed to go through, reason (%d) %s\n", reason, ast_channel_reason2str(reason));
350 if (o->retries >= o->maxretries + 1) {
351 /* Max retries exceeded */
352 ast_log(LOG_NOTICE, "Queued call to %s/%s expired without completion after %d attempt%s\n", o->tech, o->dest, o->retries - 1, ((o->retries - 1) != 1) ? "s" : "");
353 remove_from_queue(o, "Expired");
355 /* Notate that the call is still active */
356 safe_append(o, time(NULL), "EndRetry");
357 #if defined(HAVE_INOTIFY) || defined(HAVE_KQUEUE)
358 queue_file(o->fn, time(NULL) + o->retrytime);
362 ast_log(LOG_NOTICE, "Call completed to %s/%s\n", o->tech, o->dest);
363 remove_from_queue(o, "Completed");
369 static void launch_service(struct outgoing *o)
374 if ((ret = ast_pthread_create_detached(&t, NULL, attempt_thread, o))) {
375 ast_log(LOG_WARNING, "Unable to create thread :( (returned error: %d)\n", ret);
380 /* Called from scan_thread or queue_file */
381 static int scan_service(const char *fn, time_t now)
383 struct outgoing *o = NULL;
387 if (!(o = ast_calloc(1, sizeof(*o)))) {
388 ast_log(LOG_WARNING, "Out of memory ;(\n");
392 if (init_outgoing(o)) {
393 /* No need to call free_outgoing here since we know the failure
394 * was to allocate string fields and no variables have been allocated
401 /* Attempt to open the file */
402 if (!(f = fopen(fn, "r"))) {
403 remove_from_queue(o, "Failed");
405 #if !defined(HAVE_INOTIFY) && !defined(HAVE_KQUEUE)
406 ast_log(LOG_WARNING, "Unable to open %s: %s, deleting\n", fn, strerror(errno));
411 /* Read in and verify the contents */
412 if (apply_outgoing(o, fn, f)) {
413 remove_from_queue(o, "Failed");
415 ast_log(LOG_WARNING, "Invalid file contents in %s, deleting\n", fn);
421 printf("Filename: %s, Retries: %d, max: %d\n", fn, o->retries, o->maxretries);
424 if (o->retries <= o->maxretries) {
426 if (o->callingpid && (o->callingpid == ast_mainpid)) {
427 safe_append(o, time(NULL), "DelayedRetry");
428 ast_log(LOG_DEBUG, "Delaying retry since we're currently running '%s'\n", o->fn);
431 /* Increment retries */
433 /* If someone else was calling, they're presumably gone now
434 so abort their retry and continue as we were... */
436 safe_append(o, time(NULL), "AbortRetry");
438 safe_append(o, now, "StartRetry");
443 ast_log(LOG_NOTICE, "Queued call to %s/%s expired without completion after %d attempt%s\n", o->tech, o->dest, o->retries - 1, ((o->retries - 1) != 1) ? "s" : "");
444 remove_from_queue(o, "Expired");
451 #if defined(HAVE_INOTIFY) || defined(HAVE_KQUEUE)
453 AST_LIST_ENTRY(direntry) list;
458 static AST_LIST_HEAD_STATIC(dirlist, direntry);
460 #if defined(HAVE_INOTIFY)
461 /* Only one thread is accessing this list, so no lock is necessary */
462 static AST_LIST_HEAD_NOLOCK_STATIC(createlist, direntry);
465 static void queue_file(const char *filename, time_t when)
468 struct direntry *cur, *new;
470 time_t now = time(NULL);
472 if (filename[0] != '/') {
473 char *fn = alloca(strlen(qdir) + strlen(filename) + 2);
474 sprintf(fn, "%s/%s", qdir, filename); /* SAFE */
479 if (stat(filename, &st)) {
480 ast_log(LOG_WARNING, "Unable to stat %s: %s\n", filename, strerror(errno));
484 if (!S_ISREG(st.st_mode)) {
491 /* Need to check the existing list in order to avoid duplicates. */
492 AST_LIST_LOCK(&dirlist);
493 AST_LIST_TRAVERSE(&dirlist, cur, list) {
494 if (cur->mtime == when && !strcmp(filename, cur->name)) {
495 AST_LIST_UNLOCK(&dirlist);
500 if ((res = when) > now || (res = scan_service(filename, now)) > 0) {
501 if (!(new = ast_calloc(1, sizeof(*new) + strlen(filename) + 1))) {
502 AST_LIST_UNLOCK(&dirlist);
506 strcpy(new->name, filename);
507 /* List is ordered by mtime */
508 if (AST_LIST_EMPTY(&dirlist)) {
509 AST_LIST_INSERT_HEAD(&dirlist, new, list);
512 AST_LIST_TRAVERSE_SAFE_BEGIN(&dirlist, cur, list) {
513 if (cur->mtime > new->mtime) {
514 AST_LIST_INSERT_BEFORE_CURRENT(new, list);
519 AST_LIST_TRAVERSE_SAFE_END
521 AST_LIST_INSERT_TAIL(&dirlist, new, list);
525 AST_LIST_UNLOCK(&dirlist);
529 static void queue_file_create(const char *filename)
531 struct direntry *cur;
533 AST_LIST_TRAVERSE(&createlist, cur, list) {
534 if (!strcmp(cur->name, filename)) {
539 if (!(cur = ast_calloc(1, sizeof(*cur) + strlen(filename) + 1))) {
542 strcpy(cur->name, filename);
543 AST_LIST_INSERT_TAIL(&createlist, cur, list);
546 static void queue_file_write(const char *filename)
548 struct direntry *cur;
549 /* Only queue entries where an IN_CREATE preceded the IN_CLOSE_WRITE */
550 AST_LIST_TRAVERSE_SAFE_BEGIN(&createlist, cur, list) {
551 if (!strcmp(cur->name, filename)) {
552 AST_LIST_REMOVE_CURRENT(list);
554 queue_file(filename, 0);
558 AST_LIST_TRAVERSE_SAFE_END
562 static void *scan_thread(void *unused)
567 struct timespec ts = { .tv_sec = 1 };
570 int inotify_fd = inotify_init();
571 struct inotify_event *iev;
572 char buf[8192] __attribute__((aligned (sizeof(int))));
573 struct pollfd pfd = { .fd = inotify_fd, .events = POLLIN };
575 struct timespec nowait = { 0, 1 };
576 int inotify_fd = kqueue();
579 struct direntry *cur;
581 while (!ast_fully_booted) {
582 nanosleep(&ts, NULL);
585 if (inotify_fd < 0) {
586 ast_log(LOG_ERROR, "Unable to initialize "
597 inotify_add_watch(inotify_fd, qdir, IN_CREATE | IN_CLOSE_WRITE | IN_MOVED_TO);
600 /* First, run through the directory and clear existing entries */
601 if (!(dir = opendir(qdir))) {
602 ast_log(LOG_ERROR, "Unable to open directory %s: %s\n", qdir, strerror(errno));
607 EV_SET(&kev, dirfd(dir), EVFILT_VNODE, EV_ADD | EV_ENABLE | EV_CLEAR, NOTE_WRITE, 0, NULL);
608 if (kevent(inotify_fd, &kev, 1, NULL, 0, &nowait) < 0 && errno != 0) {
609 ast_log(LOG_ERROR, "Unable to watch directory %s: %s\n", qdir, strerror(errno));
613 while ((de = readdir(dir))) {
614 queue_file(de->d_name, 0);
618 /* Directory needs to remain open for kqueue(2) */
622 /* Wait for either a) next timestamp to occur, or b) a change to happen */
624 time_t next = AST_LIST_EMPTY(&dirlist) ? INT_MAX : AST_LIST_FIRST(&dirlist)->mtime;
630 /* Convert from seconds to milliseconds, unless there's nothing
631 * in the queue already, in which case, we wait forever. */
632 int waittime = next == INT_MAX ? -1 : (next - now) * 1000;
633 /* When a file arrives, add it to the queue, in mtime order. */
634 if ((res = poll(&pfd, 1, waittime)) > 0 && (stage = 1) &&
635 (res = read(inotify_fd, &buf, sizeof(buf))) >= sizeof(*iev)) {
637 /* File(s) added to directory, add them to my list */
638 for (iev = (void *) buf; res >= sizeof(*iev); iev = (struct inotify_event *) (((char *) iev) + len)) {
639 if (iev->mask & IN_CREATE) {
640 queue_file_create(iev->name);
641 } else if (iev->mask & IN_CLOSE_WRITE) {
642 queue_file_write(iev->name);
643 } else if (iev->mask & IN_MOVED_TO) {
644 queue_file(iev->name, 0);
646 ast_log(LOG_ERROR, "Unexpected event %d for file '%s'\n", (int) iev->mask, iev->name);
649 len = sizeof(*iev) + iev->len;
652 } else if (res < 0 && errno != EINTR && errno != EAGAIN) {
653 ast_debug(1, "Got an error back from %s(2): %s\n", stage ? "read" : "poll", strerror(errno));
656 struct timespec ts2 = { next - now, 0 };
657 if (kevent(inotify_fd, NULL, 0, &kev, 1, &ts2) <= 0) {
658 /* Interrupt or timeout, restart calculations */
661 /* Directory changed, rescan */
663 while ((de = readdir(dir))) {
664 queue_file(de->d_name, 0);
671 /* Empty the list of all entries ready to be processed */
672 AST_LIST_LOCK(&dirlist);
673 while (!AST_LIST_EMPTY(&dirlist) && AST_LIST_FIRST(&dirlist)->mtime <= now) {
674 cur = AST_LIST_REMOVE_HEAD(&dirlist, list);
675 queue_file(cur->name, cur->mtime);
678 AST_LIST_UNLOCK(&dirlist);
684 static void *scan_thread(void *unused)
691 time_t last = 0, next = 0, now;
692 struct timespec ts = { .tv_sec = 1 };
694 while (!ast_fully_booted) {
695 nanosleep(&ts, NULL);
700 nanosleep(&ts, NULL);
703 if (stat(qdir, &st)) {
704 ast_log(LOG_WARNING, "Unable to stat %s\n", qdir);
708 /* Make sure it is time for us to execute our check */
709 if ((st.st_mtime == last) && (next && (next > now)))
713 printf("atime: %ld, mtime: %ld, ctime: %ld\n", st.st_atime, st.st_mtime, st.st_ctime);
714 printf("Ooh, something changed / timeout\n");
719 if (!(dir = opendir(qdir))) {
720 ast_log(LOG_WARNING, "Unable to open directory %s: %s\n", qdir, strerror(errno));
724 while ((de = readdir(dir))) {
725 snprintf(fn, sizeof(fn), "%s/%s", qdir, de->d_name);
727 ast_log(LOG_WARNING, "Unable to stat %s: %s\n", fn, strerror(errno));
730 if (!S_ISREG(st.st_mode))
732 if (st.st_mtime <= now) {
733 res = scan_service(fn, now);
735 /* Update next service time */
736 if (!next || (res < next)) {
740 ast_log(LOG_WARNING, "Failed to scan service '%s'\n", fn);
742 /* Expired entry: must recheck on the next go-around */
746 /* Update "next" update if necessary */
747 if (!next || (st.st_mtime < next))
757 static int unload_module(void)
762 static int load_module(void)
766 snprintf(qdir, sizeof(qdir), "%s/%s", ast_config_AST_SPOOL_DIR, "outgoing");
767 if (ast_mkdir(qdir, 0777)) {
768 ast_log(LOG_WARNING, "Unable to create queue directory %s -- outgoing spool disabled\n", qdir);
769 return AST_MODULE_LOAD_DECLINE;
771 snprintf(qdonedir, sizeof(qdir), "%s/%s", ast_config_AST_SPOOL_DIR, "outgoing_done");
773 if ((ret = ast_pthread_create_detached_background(&thread, NULL, scan_thread, NULL))) {
774 ast_log(LOG_WARNING, "Unable to create thread :( (returned error: %d)\n", ret);
775 return AST_MODULE_LOAD_FAILURE;
778 return AST_MODULE_LOAD_SUCCESS;
781 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Outgoing Spool Support");