diff options
Diffstat (limited to 'apps/app_forkcdr.c')
-rw-r--r-- | apps/app_forkcdr.c | 222 |
1 files changed, 39 insertions, 183 deletions
diff --git a/apps/app_forkcdr.c b/apps/app_forkcdr.c index 354792fb9..6231d381f 100644 --- a/apps/app_forkcdr.c +++ b/apps/app_forkcdr.c @@ -44,98 +44,46 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$") /*** DOCUMENTATION <application name="ForkCDR" language="en_US"> <synopsis> - Forks the Call Data Record. + Forks the current Call Data Record for this channel. </synopsis> <syntax> <parameter name="options"> <optionlist> <option name="a"> - <para>Update the answer time on the NEW CDR just after it's been inited. - The new CDR may have been answered already. The reset that forkcdr does - will erase the answer time. This will bring it back, but the answer time - will be a copy of the fork/start time. It will only do this if the initial - cdr was indeed already answered.</para> - </option> - <option name="A"> - <para>Lock the original CDR against the answer time being updated. This - will allow the disposition on the original CDR to remain the same.</para> - </option> - <option name="d"> - <para>Copy the disposition forward from the old cdr, after the init.</para> - </option> - <option name="D"> - <para>Clear the <literal>dstchannel</literal> on the new CDR after - reset.</para> + <para>If the channel is answered, set the answer time on + the forked CDR to the current time. If this option is + not used, the answer time on the forked CDR will be the + answer time on the original CDR. If the channel is not + answered, this option has no effect.</para> + <para>Note that this option is implicitly assumed if the + <literal>r</literal> option is used.</para> </option> <option name="e"> - <para>End the original CDR. Do this after all the necessary data is copied - from the original CDR to the new forked CDR.</para> + <para>End (finalize) the original CDR.</para> </option> <option name="r"> - <para>Do <emphasis>NOT</emphasis> reset the new cdr.</para> - </option> - <option name="s(name=val)"> - <para>Set the CDR var <replaceable>name</replaceable> in the original CDR, - with value <replaceable>val</replaceable>.</para> - </option> - <option name="T"> - <para>Mark the original CDR with a DONT_TOUCH flag. setvar, answer, and end - cdr funcs will obey this flag; normally they don't honor the LOCKED flag - set on the original CDR record.</para> - <note><para>Using this flag may cause CDR's not to have their end times - updated! It is suggested that if you specify this flag, you might wish - to use the <literal>e</literal> flag as well!.</para></note> + <para>Reset the start and answer times on the forked CDR. + This will set the start and answer times (if the channel + is answered) to be set to the current time.</para> + <para>Note that this option implicitly assumes the + <literal>a</literal> option.</para> </option> <option name="v"> - <para>When the new CDR is forked, it gets a copy of the vars attached to - the current CDR. The vars attached to the original CDR are removed unless - this option is specified.</para> + <para>Do not copy CDR variables and attributes from the + original CDR to the forked CDR.</para> + <warning><para>This option has changed. Previously, the + variables were removed from the original CDR. This no + longer occurs - this option now controls whether or not + a forked CDR inherits the variables from the original + CDR.</para></warning> </option> </optionlist> </parameter> </syntax> <description> - <para> Causes the Call Data Record to fork an additional cdr record starting from the time - of the fork call. This new cdr record will be linked to end of the list of cdr records attached - to the channel. The original CDR has a LOCKED flag set, which forces most cdr operations to skip - it, except for the functions that set the answer and end times, which ignore the LOCKED flag. This - allows all the cdr records in the channel to be 'ended' together when the channel is closed.</para> - <para>The CDR() func (when setting CDR values) normally ignores the LOCKED flag also, but has options - to vary its behavior. The 'T' option (described below), can override this behavior, but beware - the risks.</para> - <para>First, this app finds the last cdr record in the list, and makes a copy of it. This new copy - will be the newly forked cdr record. Next, this new record is linked to the end of the cdr record list. - Next, The new cdr record is RESET (unless you use an option to prevent this)</para> - <para>This means that:</para> - <para> 1. All flags are unset on the cdr record</para> - <para> 2. the start, end, and answer times are all set to zero.</para> - <para> 3. the billsec and duration fields are set to zero.</para> - <para> 4. the start time is set to the current time.</para> - <para> 5. the disposition is set to NULL.</para> - <para>Next, unless you specified the <literal>v</literal> option, all variables will be removed from - the original cdr record. Thus, the <literal>v</literal> option allows any CDR variables to be replicated - to all new forked cdr records. Without the <literal>v</literal> option, the variables on the original - are effectively moved to the new forked cdr record.</para> - <para>Next, if the <literal>s</literal> option is set, the provided variable and value are set on the - original cdr record.</para> - <para>Next, if the <literal>a</literal> option is given, and the original cdr record has an answer time - set, then the new forked cdr record will have its answer time set to its start time. If the old answer - time were carried forward, the answer time would be earlier than the start time, giving strange - duration and billsec times.</para> - <para>If the <literal>d</literal> option was specified, the disposition is copied from - the original cdr record to the new forked cdr. If the <literal>D</literal> option was specified, - the destination channel field in the new forked CDR is erased. If the <literal>e</literal> option - was specified, the 'end' time for the original cdr record is set to the current time. Future hang-up or - ending events will not override this time stamp. If the <literal>A</literal> option is specified, - the original cdr record will have it ANS_LOCKED flag set, which prevent future answer events from updating - the original cdr record's disposition. Normally, an <literal>ANSWERED</literal> event would mark all cdr - records in the chain as <literal>ANSWERED</literal>. If the <literal>T</literal> option is specified, - the original cdr record will have its <literal>DONT_TOUCH</literal> flag set, which will force the - cdr_answer, cdr_end, and cdr_setvar functions to leave that cdr record alone.</para> - <para>And, last but not least, the original cdr record has its LOCKED flag set. Almost all internal - CDR functions (except for the funcs that set the end, and answer times, and set a variable) will honor - this flag and leave a LOCKED cdr record alone. This means that the newly created forked cdr record - will be affected by events transpiring within Asterisk, with the previously noted exceptions.</para> + <para>Causes the Call Data Record engine to fork a new CDR starting + from the time the application is executed. The forked CDR will be + linked to the end of the CDRs associated with the channel.</para> </description> <see-also> <ref type="function">CDR</ref> @@ -147,126 +95,34 @@ ASTERISK_FILE_VERSION(__FILE__, "$Revision$") static char *app = "ForkCDR"; -enum { - OPT_SETANS = (1 << 0), - OPT_SETDISP = (1 << 1), - OPT_RESETDEST = (1 << 2), - OPT_ENDCDR = (1 << 3), - OPT_NORESET = (1 << 4), - OPT_KEEPVARS = (1 << 5), - OPT_VARSET = (1 << 6), - OPT_ANSLOCK = (1 << 7), - OPT_DONTOUCH = (1 << 8), -}; - -enum { - OPT_ARG_VARSET = 0, - /* note: this entry _MUST_ be the last one in the enum */ - OPT_ARG_ARRAY_SIZE, -}; - AST_APP_OPTIONS(forkcdr_exec_options, { - AST_APP_OPTION('a', OPT_SETANS), - AST_APP_OPTION('A', OPT_ANSLOCK), - AST_APP_OPTION('d', OPT_SETDISP), - AST_APP_OPTION('D', OPT_RESETDEST), - AST_APP_OPTION('e', OPT_ENDCDR), - AST_APP_OPTION('R', OPT_NORESET), - AST_APP_OPTION_ARG('s', OPT_VARSET, OPT_ARG_VARSET), - AST_APP_OPTION('T', OPT_DONTOUCH), - AST_APP_OPTION('v', OPT_KEEPVARS), + AST_APP_OPTION('a', AST_CDR_FLAG_SET_ANSWER), + AST_APP_OPTION('e', AST_CDR_FLAG_FINALIZE), + AST_APP_OPTION('r', AST_CDR_FLAG_RESET), + AST_APP_OPTION('v', AST_CDR_FLAG_KEEP_VARS), }); -static void ast_cdr_fork(struct ast_channel *chan, struct ast_flags optflags, char *set) -{ - struct ast_cdr *cdr; - struct ast_cdr *newcdr; - struct ast_flags flags = { AST_CDR_FLAG_KEEP_VARS }; - - cdr = ast_channel_cdr(chan); - - while (cdr->next) - cdr = cdr->next; - - if (!(newcdr = ast_cdr_dup_unique(cdr))) - return; - - /* - * End the original CDR if requested BEFORE appending the new CDR - * otherwise we incorrectly end the new CDR also. - */ - if (ast_test_flag(&optflags, OPT_ENDCDR)) { - ast_cdr_end(cdr); - } - - ast_cdr_append(cdr, newcdr); - - if (!ast_test_flag(&optflags, OPT_NORESET)) - ast_cdr_reset(newcdr, &flags); - - if (!ast_test_flag(cdr, AST_CDR_FLAG_KEEP_VARS)) - ast_cdr_free_vars(cdr, 0); - - if (!ast_strlen_zero(set)) { - char *varname = ast_strdupa(set), *varval; - varval = strchr(varname,'='); - if (varval) { - *varval = 0; - varval++; - ast_cdr_setvar(cdr, varname, varval, 0); - } - } - - if (ast_test_flag(&optflags, OPT_SETANS) && !ast_tvzero(cdr->answer)) - newcdr->answer = newcdr->start; - - if (ast_test_flag(&optflags, OPT_SETDISP)) - newcdr->disposition = cdr->disposition; - - if (ast_test_flag(&optflags, OPT_RESETDEST)) - newcdr->dstchannel[0] = 0; - - if (ast_test_flag(&optflags, OPT_ANSLOCK)) - ast_set_flag(cdr, AST_CDR_FLAG_ANSLOCKED); - - if (ast_test_flag(&optflags, OPT_DONTOUCH)) - ast_set_flag(cdr, AST_CDR_FLAG_DONT_TOUCH); - - ast_set_flag(cdr, AST_CDR_FLAG_CHILD | AST_CDR_FLAG_LOCKED); -} - static int forkcdr_exec(struct ast_channel *chan, const char *data) { - int res = 0; - char *argcopy = NULL; - struct ast_flags flags = {0}; - char *opts[OPT_ARG_ARRAY_SIZE]; - AST_DECLARE_APP_ARGS(arglist, + char *parse; + struct ast_flags flags = { 0, }; + AST_DECLARE_APP_ARGS(args, AST_APP_ARG(options); ); - if (!ast_channel_cdr(chan)) { - ast_log(LOG_WARNING, "Channel does not have a CDR\n"); - return 0; - } - - argcopy = ast_strdupa(data); + parse = ast_strdupa(data); - AST_STANDARD_APP_ARGS(arglist, argcopy); + AST_STANDARD_APP_ARGS(args, parse); - opts[OPT_ARG_VARSET] = 0; - - if (!ast_strlen_zero(arglist.options)) - ast_app_parse_options(forkcdr_exec_options, &flags, opts, arglist.options); + if (!ast_strlen_zero(args.options)) { + ast_app_parse_options(forkcdr_exec_options, &flags, NULL, args.options); + } - if (!ast_strlen_zero(data)) { - int keepvars = ast_test_flag(&flags, OPT_KEEPVARS) ? 1 : 0; - ast_set2_flag(ast_channel_cdr(chan), keepvars, AST_CDR_FLAG_KEEP_VARS); + if (ast_cdr_fork(ast_channel_name(chan), &flags)) { + ast_log(AST_LOG_WARNING, "Failed to fork CDR for channel %s\n", ast_channel_name(chan)); } - - ast_cdr_fork(chan, flags, opts[OPT_ARG_VARSET]); - return res; + return 0; } static int unload_module(void) |