00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026 #include "asterisk.h"
00027
00028 ASTERISK_FILE_VERSION(__FILE__, "$Revision: 227944 $")
00029
00030 #include <stdio.h>
00031 #include <stdlib.h>
00032 #include <errno.h>
00033 #include <string.h>
00034 #include <sys/types.h>
00035 #include <sys/stat.h>
00036 #include <libgen.h>
00037
00038 #include "asterisk/lock.h"
00039 #include "asterisk/channel.h"
00040 #include "asterisk/logger.h"
00041 #include "asterisk/file.h"
00042 #include "asterisk/pbx.h"
00043 #include "asterisk/module.h"
00044 #include "asterisk/manager.h"
00045 #include "asterisk/cli.h"
00046 #include "asterisk/monitor.h"
00047 #include "asterisk/app.h"
00048 #include "asterisk/utils.h"
00049 #include "asterisk/config.h"
00050 #include "asterisk/options.h"
00051
00052 AST_MUTEX_DEFINE_STATIC(monitorlock);
00053
00054 #define LOCK_IF_NEEDED(lock, needed) do { \
00055 if (needed) \
00056 ast_channel_lock(lock); \
00057 } while(0)
00058
00059 #define UNLOCK_IF_NEEDED(lock, needed) do { \
00060 if (needed) \
00061 ast_channel_unlock(lock); \
00062 } while (0)
00063
00064 static unsigned long seq = 0;
00065
00066 static char *monitor_synopsis = "Monitor a channel";
00067
00068 static char *monitor_descrip = "Monitor([file_format[:urlbase]|[fname_base]|[options]]):\n"
00069 "Used to start monitoring a channel. The channel's input and output\n"
00070 "voice packets are logged to files until the channel hangs up or\n"
00071 "monitoring is stopped by the StopMonitor application.\n"
00072 " file_format optional, if not set, defaults to \"wav\"\n"
00073 " fname_base if set, changes the filename used to the one specified.\n"
00074 " options:\n"
00075 " m - when the recording ends mix the two leg files into one and\n"
00076 " delete the two leg files. If the variable MONITOR_EXEC is set, the\n"
00077 " application referenced in it will be executed instead of\n"
00078 #ifdef HAVE_SOXMIX
00079 " soxmix and the raw leg files will NOT be deleted automatically.\n"
00080 " soxmix or MONITOR_EXEC is handed 3 arguments, the two leg files\n"
00081 #else
00082 " sox and the raw leg files will NOT be deleted automatically.\n"
00083 " sox or MONITOR_EXEC is handed 3 arguments, the two leg files\n"
00084 #endif
00085 " and a target mixed file name which is the same as the leg file names\n"
00086 " only without the in/out designator.\n"
00087 " If MONITOR_EXEC_ARGS is set, the contents will be passed on as\n"
00088 " additional arguements to MONITOR_EXEC\n"
00089 " Both MONITOR_EXEC and the Mix flag can be set from the\n"
00090 " administrator interface\n"
00091 "\n"
00092 " b - Don't begin recording unless a call is bridged to another channel\n"
00093 "\nReturns -1 if monitor files can't be opened or if the channel is already\n"
00094 "monitored, otherwise 0.\n"
00095 ;
00096
00097 static char *stopmonitor_synopsis = "Stop monitoring a channel";
00098
00099 static char *stopmonitor_descrip = "StopMonitor\n"
00100 "Stops monitoring a channel. Has no effect if the channel is not monitored\n";
00101
00102 static char *changemonitor_synopsis = "Change monitoring filename of a channel";
00103
00104 static char *changemonitor_descrip = "ChangeMonitor(filename_base)\n"
00105 "Changes monitoring filename of a channel. Has no effect if the channel is not monitored\n"
00106 "The argument is the new filename base to use for monitoring this channel.\n";
00107
00108 static char *pausemonitor_synopsis = "Pause monitoring of a channel";
00109
00110 static char *pausemonitor_descrip = "PauseMonitor\n"
00111 "Pauses monitoring of a channel until it is re-enabled by a call to UnpauseMonitor.\n";
00112
00113 static char *unpausemonitor_synopsis = "Unpause monitoring of a channel";
00114
00115 static char *unpausemonitor_descrip = "UnpauseMonitor\n"
00116 "Unpauses monitoring of a channel on which monitoring had\n"
00117 "previously been paused with PauseMonitor.\n";
00118
00119 static int ast_monitor_set_state(struct ast_channel *chan, int state)
00120 {
00121 LOCK_IF_NEEDED(chan, 1);
00122 if (!chan->monitor) {
00123 UNLOCK_IF_NEEDED(chan, 1);
00124 return -1;
00125 }
00126 chan->monitor->state = state;
00127 UNLOCK_IF_NEEDED(chan, 1);
00128 return 0;
00129 }
00130
00131
00132 int ast_monitor_start( struct ast_channel *chan, const char *format_spec,
00133 const char *fname_base, int need_lock)
00134 {
00135 int res = 0;
00136 char tmp[256];
00137
00138 LOCK_IF_NEEDED(chan, need_lock);
00139
00140 if (!(chan->monitor)) {
00141 struct ast_channel_monitor *monitor;
00142 char *channel_name, *p;
00143
00144
00145 if (mkdir(ast_config_AST_MONITOR_DIR, 0770) < 0) {
00146 if (errno != EEXIST) {
00147 ast_log(LOG_WARNING, "Unable to create audio monitor directory: %s\n",
00148 strerror(errno));
00149 }
00150 }
00151
00152 if (!(monitor = ast_calloc(1, sizeof(*monitor)))) {
00153 UNLOCK_IF_NEEDED(chan, need_lock);
00154 return -1;
00155 }
00156
00157
00158 if (!ast_strlen_zero(fname_base)) {
00159 int directory = strchr(fname_base, '/') ? 1 : 0;
00160 const char *absolute = *fname_base == '/' ? "" : "/";
00161
00162 if (directory) {
00163 char *name = strdup(fname_base);
00164 snprintf(tmp, sizeof(tmp), "mkdir -p \"%s\"",dirname(name));
00165 free(name);
00166 ast_safe_system(tmp);
00167 }
00168 snprintf(monitor->read_filename, FILENAME_MAX, "%s%s%s-in",
00169 directory ? "" : ast_config_AST_MONITOR_DIR, absolute, fname_base);
00170 snprintf(monitor->write_filename, FILENAME_MAX, "%s%s%s-out",
00171 directory ? "" : ast_config_AST_MONITOR_DIR, absolute, fname_base);
00172 snprintf(monitor->filename_base, FILENAME_MAX, "%s/%s",
00173 ast_config_AST_MONITOR_DIR, fname_base);
00174 } else {
00175 ast_mutex_lock(&monitorlock);
00176 snprintf(monitor->read_filename, FILENAME_MAX, "%s/audio-in-%ld",
00177 ast_config_AST_MONITOR_DIR, seq);
00178 snprintf(monitor->write_filename, FILENAME_MAX, "%s/audio-out-%ld",
00179 ast_config_AST_MONITOR_DIR, seq);
00180 seq++;
00181 ast_mutex_unlock(&monitorlock);
00182
00183 channel_name = ast_strdupa(chan->name);
00184 while ((p = strchr(channel_name, '/'))) {
00185 *p = '-';
00186 }
00187 snprintf(monitor->filename_base, FILENAME_MAX, "%s/%d-%s",
00188 ast_config_AST_MONITOR_DIR, (int)time(NULL), channel_name);
00189 monitor->filename_changed = 1;
00190 }
00191
00192 monitor->stop = ast_monitor_stop;
00193
00194
00195 if (!ast_strlen_zero(format_spec)) {
00196 monitor->format = strdup(format_spec);
00197 } else {
00198 monitor->format = strdup("wav");
00199 }
00200
00201
00202 if (ast_fileexists(monitor->read_filename, NULL, NULL) > 0) {
00203 ast_filedelete(monitor->read_filename, NULL);
00204 }
00205 if (!(monitor->read_stream = ast_writefile(monitor->read_filename,
00206 monitor->format, NULL,
00207 O_CREAT|O_TRUNC|O_WRONLY, 0, 0644))) {
00208 ast_log(LOG_WARNING, "Could not create file %s\n",
00209 monitor->read_filename);
00210 free(monitor);
00211 UNLOCK_IF_NEEDED(chan, need_lock);
00212 return -1;
00213 }
00214 if (ast_fileexists(monitor->write_filename, NULL, NULL) > 0) {
00215 ast_filedelete(monitor->write_filename, NULL);
00216 }
00217 if (!(monitor->write_stream = ast_writefile(monitor->write_filename,
00218 monitor->format, NULL,
00219 O_CREAT|O_TRUNC|O_WRONLY, 0, 0644))) {
00220 ast_log(LOG_WARNING, "Could not create file %s\n",
00221 monitor->write_filename);
00222 ast_closestream(monitor->read_stream);
00223 free(monitor);
00224 UNLOCK_IF_NEEDED(chan, need_lock);
00225 return -1;
00226 }
00227 chan->monitor = monitor;
00228 ast_monitor_set_state(chan, AST_MONITOR_RUNNING);
00229
00230 pbx_builtin_setvar_helper(chan, "__MONITORED","true");
00231 } else {
00232 ast_log(LOG_DEBUG,"Cannot start monitoring %s, already monitored\n",
00233 chan->name);
00234 res = -1;
00235 }
00236
00237 UNLOCK_IF_NEEDED(chan, need_lock);
00238
00239 return res;
00240 }
00241
00242
00243
00244
00245
00246
00247 static const char *get_soxmix_format(const char *format)
00248 {
00249 const char *res = format;
00250
00251 if (!strcasecmp(format,"ulaw"))
00252 res = "ul";
00253 if (!strcasecmp(format,"alaw"))
00254 res = "al";
00255
00256 return res;
00257 }
00258
00259
00260 int ast_monitor_stop(struct ast_channel *chan, int need_lock)
00261 {
00262 int delfiles = 0;
00263
00264 LOCK_IF_NEEDED(chan, need_lock);
00265
00266 if (chan->monitor) {
00267 char filename[ FILENAME_MAX ];
00268
00269 if (chan->monitor->read_stream) {
00270 ast_closestream(chan->monitor->read_stream);
00271 }
00272 if (chan->monitor->write_stream) {
00273 ast_closestream(chan->monitor->write_stream);
00274 }
00275
00276 if (chan->monitor->filename_changed && !ast_strlen_zero(chan->monitor->filename_base)) {
00277 if (ast_fileexists(chan->monitor->read_filename,NULL,NULL) > 0) {
00278 snprintf(filename, FILENAME_MAX, "%s-in", chan->monitor->filename_base);
00279 if (ast_fileexists(filename, NULL, NULL) > 0) {
00280 ast_filedelete(filename, NULL);
00281 }
00282 ast_filerename(chan->monitor->read_filename, filename, chan->monitor->format);
00283 } else {
00284 ast_log(LOG_WARNING, "File %s not found\n", chan->monitor->read_filename);
00285 }
00286
00287 if (ast_fileexists(chan->monitor->write_filename,NULL,NULL) > 0) {
00288 snprintf(filename, FILENAME_MAX, "%s-out", chan->monitor->filename_base);
00289 if (ast_fileexists(filename, NULL, NULL) > 0) {
00290 ast_filedelete(filename, NULL);
00291 }
00292 ast_filerename(chan->monitor->write_filename, filename, chan->monitor->format);
00293 } else {
00294 ast_log(LOG_WARNING, "File %s not found\n", chan->monitor->write_filename);
00295 }
00296 }
00297
00298 if (chan->monitor->joinfiles && !ast_strlen_zero(chan->monitor->filename_base)) {
00299 char tmp[1024];
00300 char tmp2[1024];
00301 const char *format = !strcasecmp(chan->monitor->format,"wav49") ? "WAV" : chan->monitor->format;
00302 char *name = chan->monitor->filename_base;
00303 int directory = strchr(name, '/') ? 1 : 0;
00304 char *dir = directory ? "" : ast_config_AST_MONITOR_DIR;
00305 const char *execute, *execute_args;
00306 const char *absolute = *name == '/' ? "" : "/";
00307
00308
00309 execute = pbx_builtin_getvar_helper(chan, "MONITOR_EXEC");
00310 if (ast_strlen_zero(execute)) {
00311 #ifdef HAVE_SOXMIX
00312 execute = "nice -n 19 soxmix";
00313 #else
00314 execute = "nice -n 19 sox -m";
00315 #endif
00316 format = get_soxmix_format(format);
00317 delfiles = 1;
00318 }
00319 execute_args = pbx_builtin_getvar_helper(chan, "MONITOR_EXEC_ARGS");
00320 if (ast_strlen_zero(execute_args)) {
00321 execute_args = "";
00322 }
00323
00324 snprintf(tmp, sizeof(tmp), "%s \"%s%s%s-in.%s\" \"%s%s%s-out.%s\" \"%s%s%s.%s\" %s &", execute, dir, absolute, name, format, dir, absolute, name, format, dir, absolute, name, format,execute_args);
00325 if (delfiles) {
00326 snprintf(tmp2,sizeof(tmp2), "( %s& rm -f \"%s%s%s-\"* ) &",tmp, dir, absolute, name);
00327 ast_copy_string(tmp, tmp2, sizeof(tmp));
00328 }
00329 ast_log(LOG_DEBUG,"monitor executing %s\n",tmp);
00330 if (ast_safe_system(tmp) == -1)
00331 ast_log(LOG_WARNING, "Execute of %s failed.\n",tmp);
00332 }
00333
00334 free(chan->monitor->format);
00335 free(chan->monitor);
00336 chan->monitor = NULL;
00337 }
00338
00339 UNLOCK_IF_NEEDED(chan, need_lock);
00340
00341 return 0;
00342 }
00343
00344
00345
00346 int ast_monitor_pause(struct ast_channel *chan)
00347 {
00348 return ast_monitor_set_state(chan, AST_MONITOR_PAUSED);
00349 }
00350
00351
00352 int ast_monitor_unpause(struct ast_channel *chan)
00353 {
00354 return ast_monitor_set_state(chan, AST_MONITOR_RUNNING);
00355 }
00356
00357 static int pause_monitor_exec(struct ast_channel *chan, void *data)
00358 {
00359 return ast_monitor_pause(chan);
00360 }
00361
00362 static int unpause_monitor_exec(struct ast_channel *chan, void *data)
00363 {
00364 return ast_monitor_unpause(chan);
00365 }
00366
00367
00368 int ast_monitor_change_fname(struct ast_channel *chan, const char *fname_base, int need_lock)
00369 {
00370 char tmp[256];
00371 if (ast_strlen_zero(fname_base)) {
00372 ast_log(LOG_WARNING, "Cannot change monitor filename of channel %s to null\n", chan->name);
00373 return -1;
00374 }
00375
00376 LOCK_IF_NEEDED(chan, need_lock);
00377
00378 if (chan->monitor) {
00379 int directory = strchr(fname_base, '/') ? 1 : 0;
00380 const char *absolute = *fname_base == '/' ? "" : "/";
00381 char tmpstring[sizeof(chan->monitor->filename_base)] = "";
00382 int i, fd[2] = { -1, -1 }, doexit = 0;
00383
00384
00385 snprintf(tmpstring, sizeof(tmpstring), "%s%s%s", directory ? "" : ast_config_AST_MONITOR_DIR, absolute, fname_base);
00386
00387
00388
00389
00390
00391
00392
00393
00394
00395
00396
00397
00398 if (option_debug > 2) {
00399 ast_log(LOG_DEBUG, "comparing tmpstring %s to filename_base %s\n", tmpstring, chan->monitor->filename_base);
00400 }
00401 if ((fd[0] = open(tmpstring, O_CREAT | O_WRONLY, 0644)) < 0 ||
00402 (fd[1] = open(chan->monitor->filename_base, O_CREAT | O_EXCL | O_WRONLY, 0644)) < 0) {
00403 if (fd[0] < 0) {
00404 ast_log(LOG_ERROR, "Unable to compare filenames: %s\n", strerror(errno));
00405 } else {
00406 if (option_debug > 2) {
00407 ast_log(LOG_DEBUG, "No need to rename monitor filename to itself\n");
00408 }
00409 }
00410 doexit = 1;
00411 }
00412
00413
00414 for (i = 0; i < 2; i++) {
00415 if (fd[i] >= 0) {
00416 while (close(fd[i]) < 0 && errno == EINTR);
00417 }
00418 }
00419 unlink(tmpstring);
00420 unlink(chan->monitor->filename_base);
00421
00422 if (doexit) {
00423 UNLOCK_IF_NEEDED(chan, need_lock);
00424 return 0;
00425 }
00426
00427
00428 if (directory) {
00429 char *name = strdup(fname_base);
00430 snprintf(tmp, sizeof(tmp), "mkdir -p %s",dirname(name));
00431 free(name);
00432 ast_safe_system(tmp);
00433 }
00434
00435 ast_copy_string(chan->monitor->filename_base, tmpstring, sizeof(chan->monitor->filename_base));
00436 chan->monitor->filename_changed = 1;
00437 } else {
00438 ast_log(LOG_WARNING, "Cannot change monitor filename of channel %s to %s, monitoring not started\n", chan->name, fname_base);
00439 }
00440
00441 UNLOCK_IF_NEEDED(chan, need_lock);
00442
00443 return 0;
00444 }
00445
00446 static int start_monitor_exec(struct ast_channel *chan, void *data)
00447 {
00448 char *arg = NULL;
00449 char *format = NULL;
00450 char *fname_base = NULL;
00451 char *options = NULL;
00452 char *delay = NULL;
00453 char *urlprefix = NULL;
00454 char tmp[256];
00455 int joinfiles = 0;
00456 int waitforbridge = 0;
00457 int res = 0;
00458
00459
00460 if (!ast_strlen_zero((char*)data)) {
00461 arg = ast_strdupa((char*)data);
00462 format = arg;
00463 fname_base = strchr(arg, '|');
00464 if (fname_base) {
00465 *fname_base = 0;
00466 fname_base++;
00467 if ((options = strchr(fname_base, '|'))) {
00468 *options = 0;
00469 options++;
00470 if (strchr(options, 'm'))
00471 joinfiles = 1;
00472 if (strchr(options, 'b'))
00473 waitforbridge = 1;
00474 }
00475 }
00476 arg = strchr(format,':');
00477 if (arg) {
00478 *arg++ = 0;
00479 urlprefix = arg;
00480 }
00481 }
00482 if (urlprefix) {
00483 snprintf(tmp,sizeof(tmp) - 1,"%s/%s.%s",urlprefix,fname_base,
00484 ((strcmp(format,"gsm")) ? "wav" : "gsm"));
00485 if (!chan->cdr && !(chan->cdr = ast_cdr_alloc()))
00486 return -1;
00487 ast_cdr_setuserfield(chan, tmp);
00488 }
00489 if (waitforbridge) {
00490
00491
00492
00493
00494 delay = ast_strdupa(data);
00495 options = strrchr(delay, '|');
00496 if (options) {
00497 arg = strchr(options, 'b');
00498 if (arg) {
00499 *arg = 'X';
00500 pbx_builtin_setvar_helper(chan,"AUTO_MONITOR",delay);
00501 }
00502 }
00503 return 0;
00504 }
00505
00506 res = ast_monitor_start(chan, format, fname_base, 1);
00507 if (res < 0)
00508 res = ast_monitor_change_fname(chan, fname_base, 1);
00509 ast_monitor_setjoinfiles(chan, joinfiles);
00510
00511 return res;
00512 }
00513
00514 static int stop_monitor_exec(struct ast_channel *chan, void *data)
00515 {
00516 return ast_monitor_stop(chan, 1);
00517 }
00518
00519 static int change_monitor_exec(struct ast_channel *chan, void *data)
00520 {
00521 return ast_monitor_change_fname(chan, (const char*)data, 1);
00522 }
00523
00524 static char start_monitor_action_help[] =
00525 "Description: The 'Monitor' action may be used to record the audio on a\n"
00526 " specified channel. The following parameters may be used to control\n"
00527 " this:\n"
00528 " Channel - Required. Used to specify the channel to record.\n"
00529 " File - Optional. Is the name of the file created in the\n"
00530 " monitor spool directory. Defaults to the same name\n"
00531 " as the channel (with slashes replaced with dashes).\n"
00532 " Format - Optional. Is the audio recording format. Defaults\n"
00533 " to \"wav\".\n"
00534 " Mix - Optional. Boolean parameter as to whether to mix\n"
00535 " the input and output channels together after the\n"
00536 " recording is finished.\n";
00537
00538 static int start_monitor_action(struct mansession *s, const struct message *m)
00539 {
00540 struct ast_channel *c = NULL;
00541 const char *name = astman_get_header(m, "Channel");
00542 const char *fname = astman_get_header(m, "File");
00543 const char *format = astman_get_header(m, "Format");
00544 const char *mix = astman_get_header(m, "Mix");
00545 char *d;
00546
00547 if (ast_strlen_zero(name)) {
00548 astman_send_error(s, m, "No channel specified");
00549 return 0;
00550 }
00551 c = ast_get_channel_by_name_locked(name);
00552 if (!c) {
00553 astman_send_error(s, m, "No such channel");
00554 return 0;
00555 }
00556
00557 if (ast_strlen_zero(fname)) {
00558
00559 fname = ast_strdupa(c->name);
00560
00561 if ((d = strchr(fname, '/')))
00562 *d = '-';
00563 }
00564
00565 if (ast_monitor_start(c, format, fname, 1)) {
00566 if (ast_monitor_change_fname(c, fname, 1)) {
00567 astman_send_error(s, m, "Could not start monitoring channel");
00568 ast_channel_unlock(c);
00569 return 0;
00570 }
00571 }
00572
00573 if (ast_true(mix)) {
00574 ast_monitor_setjoinfiles(c, 1);
00575 }
00576
00577 ast_channel_unlock(c);
00578 astman_send_ack(s, m, "Started monitoring channel");
00579 return 0;
00580 }
00581
00582 static char stop_monitor_action_help[] =
00583 "Description: The 'StopMonitor' action may be used to end a previously\n"
00584 " started 'Monitor' action. The only parameter is 'Channel', the name\n"
00585 " of the channel monitored.\n";
00586
00587 static int stop_monitor_action(struct mansession *s, const struct message *m)
00588 {
00589 struct ast_channel *c = NULL;
00590 const char *name = astman_get_header(m, "Channel");
00591 int res;
00592 if (ast_strlen_zero(name)) {
00593 astman_send_error(s, m, "No channel specified");
00594 return 0;
00595 }
00596 c = ast_get_channel_by_name_locked(name);
00597 if (!c) {
00598 astman_send_error(s, m, "No such channel");
00599 return 0;
00600 }
00601 res = ast_monitor_stop(c, 1);
00602 ast_channel_unlock(c);
00603 if (res) {
00604 astman_send_error(s, m, "Could not stop monitoring channel");
00605 return 0;
00606 }
00607 astman_send_ack(s, m, "Stopped monitoring channel");
00608 return 0;
00609 }
00610
00611 static char change_monitor_action_help[] =
00612 "Description: The 'ChangeMonitor' action may be used to change the file\n"
00613 " started by a previous 'Monitor' action. The following parameters may\n"
00614 " be used to control this:\n"
00615 " Channel - Required. Used to specify the channel to record.\n"
00616 " File - Required. Is the new name of the file created in the\n"
00617 " monitor spool directory.\n";
00618
00619 static int change_monitor_action(struct mansession *s, const struct message *m)
00620 {
00621 struct ast_channel *c = NULL;
00622 const char *name = astman_get_header(m, "Channel");
00623 const char *fname = astman_get_header(m, "File");
00624 if (ast_strlen_zero(name)) {
00625 astman_send_error(s, m, "No channel specified");
00626 return 0;
00627 }
00628 if (ast_strlen_zero(fname)) {
00629 astman_send_error(s, m, "No filename specified");
00630 return 0;
00631 }
00632 c = ast_get_channel_by_name_locked(name);
00633 if (!c) {
00634 astman_send_error(s, m, "No such channel");
00635 return 0;
00636 }
00637 if (ast_monitor_change_fname(c, fname, 1)) {
00638 astman_send_error(s, m, "Could not change monitored filename of channel");
00639 ast_channel_unlock(c);
00640 return 0;
00641 }
00642 ast_channel_unlock(c);
00643 astman_send_ack(s, m, "Changed monitor filename");
00644 return 0;
00645 }
00646
00647 void ast_monitor_setjoinfiles(struct ast_channel *chan, int turnon)
00648 {
00649 if (chan->monitor)
00650 chan->monitor->joinfiles = turnon;
00651 }
00652
00653 #define IS_NULL_STRING(string) ((!(string)) || (ast_strlen_zero((string))))
00654
00655 enum MONITOR_PAUSING_ACTION
00656 {
00657 MONITOR_ACTION_PAUSE,
00658 MONITOR_ACTION_UNPAUSE
00659 };
00660
00661 static int do_pause_or_unpause(struct mansession *s, const struct message *m, int action)
00662 {
00663 struct ast_channel *c = NULL;
00664 const char *name = astman_get_header(m, "Channel");
00665
00666 if (IS_NULL_STRING(name)) {
00667 astman_send_error(s, m, "No channel specified");
00668 return -1;
00669 }
00670
00671 c = ast_get_channel_by_name_locked(name);
00672 if (!c) {
00673 astman_send_error(s, m, "No such channel");
00674 return -1;
00675 }
00676
00677 if (action == MONITOR_ACTION_PAUSE)
00678 ast_monitor_pause(c);
00679 else
00680 ast_monitor_unpause(c);
00681
00682 ast_channel_unlock(c);
00683 astman_send_ack(s, m, (action == MONITOR_ACTION_PAUSE ? "Paused monitoring of the channel" : "Unpaused monitoring of the channel"));
00684 return 0;
00685 }
00686
00687 static char pause_monitor_action_help[] =
00688 "Description: The 'PauseMonitor' action may be used to temporarily stop the\n"
00689 " recording of a channel. The following parameters may\n"
00690 " be used to control this:\n"
00691 " Channel - Required. Used to specify the channel to record.\n";
00692
00693 static int pause_monitor_action(struct mansession *s, const struct message *m)
00694 {
00695 return do_pause_or_unpause(s, m, MONITOR_ACTION_PAUSE);
00696 }
00697
00698 static char unpause_monitor_action_help[] =
00699 "Description: The 'UnpauseMonitor' action may be used to re-enable recording\n"
00700 " of a channel after calling PauseMonitor. The following parameters may\n"
00701 " be used to control this:\n"
00702 " Channel - Required. Used to specify the channel to record.\n";
00703
00704 static int unpause_monitor_action(struct mansession *s, const struct message *m)
00705 {
00706 return do_pause_or_unpause(s, m, MONITOR_ACTION_UNPAUSE);
00707 }
00708
00709
00710 static int load_module(void)
00711 {
00712 ast_register_application("Monitor", start_monitor_exec, monitor_synopsis, monitor_descrip);
00713 ast_register_application("StopMonitor", stop_monitor_exec, stopmonitor_synopsis, stopmonitor_descrip);
00714 ast_register_application("ChangeMonitor", change_monitor_exec, changemonitor_synopsis, changemonitor_descrip);
00715 ast_register_application("PauseMonitor", pause_monitor_exec, pausemonitor_synopsis, pausemonitor_descrip);
00716 ast_register_application("UnpauseMonitor", unpause_monitor_exec, unpausemonitor_synopsis, unpausemonitor_descrip);
00717 ast_manager_register2("Monitor", EVENT_FLAG_CALL, start_monitor_action, monitor_synopsis, start_monitor_action_help);
00718 ast_manager_register2("StopMonitor", EVENT_FLAG_CALL, stop_monitor_action, stopmonitor_synopsis, stop_monitor_action_help);
00719 ast_manager_register2("ChangeMonitor", EVENT_FLAG_CALL, change_monitor_action, changemonitor_synopsis, change_monitor_action_help);
00720 ast_manager_register2("PauseMonitor", EVENT_FLAG_CALL, pause_monitor_action, pausemonitor_synopsis, pause_monitor_action_help);
00721 ast_manager_register2("UnpauseMonitor", EVENT_FLAG_CALL, unpause_monitor_action, unpausemonitor_synopsis, unpause_monitor_action_help);
00722
00723 return 0;
00724 }
00725
00726 static int unload_module(void)
00727 {
00728 ast_unregister_application("Monitor");
00729 ast_unregister_application("StopMonitor");
00730 ast_unregister_application("ChangeMonitor");
00731 ast_unregister_application("PauseMonitor");
00732 ast_unregister_application("UnpauseMonitor");
00733 ast_manager_unregister("Monitor");
00734 ast_manager_unregister("StopMonitor");
00735 ast_manager_unregister("ChangeMonitor");
00736 ast_manager_unregister("PauseMonitor");
00737 ast_manager_unregister("UnpauseMonitor");
00738
00739 return 0;
00740 }
00741
00742
00743 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_GLOBAL_SYMBOLS, "Call Monitoring Resource",
00744 .load = load_module,
00745 .unload = unload_module,
00746 );