diff options
Diffstat (limited to 'funcs/func_audiohookinherit.c')
| -rw-r--r-- | funcs/func_audiohookinherit.c | 282 |
1 files changed, 0 insertions, 282 deletions
diff --git a/funcs/func_audiohookinherit.c b/funcs/func_audiohookinherit.c deleted file mode 100644 index 6936864e3..000000000 --- a/funcs/func_audiohookinherit.c +++ /dev/null @@ -1,282 +0,0 @@ -/* - * Asterisk -- An open source telephony toolkit. - * - * Copyright (C) 2008, Digium, Inc. - * - * Mark Michelson <mmichelson@digium.com> - * - * See http://www.asterisk.org for more information about - * the Asterisk project. Please do not directly contact - * any of the maintainers of this project for assistance; - * the project provides a web site, mailing lists and IRC - * channels for your use. - * - * This program is free software, distributed under the terms of - * the GNU General Public License Version 2. See the LICENSE file - * at the top of the source tree. - * - * Please follow coding guidelines - * http://svn.digium.com/view/asterisk/trunk/doc/CODING-GUIDELINES - */ - -/*! \file - * - * \brief Audiohook inheritance function - * - * \author \verbatim Mark Michelson <mmichelson@digium.com> \endverbatim - * - * \ingroup functions - */ - -#include "asterisk.h" -#include "asterisk/channel.h" -#include "asterisk/audiohook.h" -#include "asterisk/pbx.h" -#include "asterisk/module.h" -#include "asterisk/options.h" - -struct inheritable_audiohook { - AST_LIST_ENTRY(inheritable_audiohook) list; - char source[1]; -}; - -struct audiohook_inheritance_datastore { - AST_LIST_HEAD (, inheritable_audiohook) allowed_list; -}; - -static void audiohook_inheritance_fixup(void *data, struct ast_channel *old_chan, struct ast_channel *new_chan); -static void audiohook_inheritance_destroy (void *data); -static const struct ast_datastore_info audiohook_inheritance_info = { - .type = "audiohook inheritance", - .destroy = audiohook_inheritance_destroy, - .chan_fixup = audiohook_inheritance_fixup, -}; - -/*! \brief Move audiohooks as defined by previous calls to the AUDIOHOOK_INHERIT function - * - * Move allowed audiohooks from the old channel to the new channel. - * - * \param data The ast_datastore containing audiohook inheritance information that will be moved - * \param old_chan The "clone" channel from a masquerade. We are moving the audiohook in question off of this channel - * \param new_chan The "original" channel from a masquerade. We are moving the audiohook in question to this channel - * \return Void - */ -static void audiohook_inheritance_fixup(void *data, struct ast_channel *old_chan, struct ast_channel *new_chan) -{ - struct inheritable_audiohook *audiohook = NULL; - struct audiohook_inheritance_datastore *datastore = data; - - if (option_debug > 1) { - ast_log(LOG_DEBUG, "inheritance fixup occurring for channels %s(%p) and %s(%p)", old_chan->name, old_chan, new_chan->name, new_chan); - } - - AST_LIST_TRAVERSE(&datastore->allowed_list, audiohook, list) { - ast_audiohook_move_by_source(old_chan, new_chan, audiohook->source); - if (option_debug > 2) { - ast_log(LOG_DEBUG, "Moved audiohook %s from %s(%p) to %s(%p)\n", - audiohook->source, old_chan->name, old_chan, new_chan->name, new_chan); - } - } - return; -} - -/*! \brief Destroy dynamically allocated data on an audiohook_inheritance_datastore - * - * \param data Pointer to the audiohook_inheritance_datastore in question. - * \return Void - */ -static void audiohook_inheritance_destroy(void *data) -{ - struct audiohook_inheritance_datastore *audiohook_inheritance_datastore = data; - struct inheritable_audiohook *inheritable_audiohook = NULL; - - while ((inheritable_audiohook = AST_LIST_REMOVE_HEAD(&audiohook_inheritance_datastore->allowed_list, list))) { - ast_free(inheritable_audiohook); - } -} - -/*! \brief create an audiohook_inheritance_datastore and attach it to a channel - * - * \param chan The channel to which we wish to attach the new datastore - * \return Returns the newly created audiohook_inheritance_datastore or NULL on error - */ -static struct audiohook_inheritance_datastore *setup_inheritance_datastore(struct ast_channel *chan) -{ - struct ast_datastore *datastore = NULL; - struct audiohook_inheritance_datastore *audiohook_inheritance_datastore = NULL; - - if (!(datastore = ast_channel_datastore_alloc(&audiohook_inheritance_info, NULL))) { - return NULL; - } - - if (!(audiohook_inheritance_datastore = ast_calloc(1, sizeof(*audiohook_inheritance_datastore)))) { - ast_channel_datastore_free(datastore); - return NULL; - } - - datastore->data = audiohook_inheritance_datastore; - ast_channel_lock(chan); - ast_channel_datastore_add(chan, datastore); - ast_channel_unlock(chan); - return audiohook_inheritance_datastore; -} - -/*! \brief Create a new inheritable_audiohook structure and add it to an audiohook_inheritance_datastore - * - * \param audiohook_inheritance_datastore The audiohook_inheritance_datastore we want to add the new inheritable_audiohook to - * \param source The audiohook source for the newly created inheritable_audiohook - * \retval 0 Success - * \retval non-zero Failure - */ -static int setup_inheritable_audiohook(struct audiohook_inheritance_datastore *audiohook_inheritance_datastore, const char *source) -{ - struct inheritable_audiohook *inheritable_audiohook = NULL; - - inheritable_audiohook = ast_calloc(1, sizeof(*inheritable_audiohook) + strlen(source)); - - if (!inheritable_audiohook) { - return -1; - } - - strcpy(inheritable_audiohook->source, source); - AST_LIST_INSERT_TAIL(&audiohook_inheritance_datastore->allowed_list, inheritable_audiohook, list); - if (option_debug > 2) { - ast_log(LOG_DEBUG, "Set audiohook %s to be inheritable\n", source); - } - return 0; -} - -/*! \brief Set the permissibility of inheritance for a particular audiohook source on a channel - * - * For details regarding what happens in the function, see the inline comments - * - * \param chan The channel we are operating on - * \param function The name of the dialplan function (AUDIOHOOK_INHERIT) - * \param data The audiohook source for which we are setting inheritance permissions - * \param value The value indicating the permission for audiohook inheritance - */ -static int func_inheritance_write(struct ast_channel *chan, char *function, char *data, const char *value) -{ - int allow; - struct ast_datastore *datastore = NULL; - struct audiohook_inheritance_datastore *inheritance_datastore = NULL; - struct inheritable_audiohook *inheritable_audiohook; - - /* Step 1: Get data from function call */ - if (ast_strlen_zero(data)) { - ast_log(LOG_WARNING, "No argument provided to INHERITANCE function.\n"); - return -1; - } - - if (ast_strlen_zero(value)) { - ast_log(LOG_WARNING, "No value provided to INHERITANCE function.\n"); - return -1; - } - - allow = ast_true(value); - - /* Step 2: retrieve or set up datastore */ - ast_channel_lock(chan); - if (!(datastore = ast_channel_datastore_find(chan, &audiohook_inheritance_info, NULL))) { - ast_channel_unlock(chan); - /* In the case where we cannot find the datastore, we can take a few shortcuts */ - if (!allow) { - if (option_debug) { - ast_log(LOG_DEBUG, "Audiohook %s is already set to not be inheritable on channel %s\n", data, chan->name); - } - return 0; - } else if (!(inheritance_datastore = setup_inheritance_datastore(chan))) { - ast_log(LOG_WARNING, "Unable to set up audiohook inheritance datastore on channel %s\n", chan->name); - return -1; - } else { - return setup_inheritable_audiohook(inheritance_datastore, data); - } - } else { - inheritance_datastore = datastore->data; - } - ast_channel_unlock(chan); - - /* Step 3: Traverse the list to see if we're trying something redundant */ - - AST_LIST_TRAVERSE_SAFE_BEGIN(&inheritance_datastore->allowed_list, inheritable_audiohook, list) { - if (!strcasecmp(inheritable_audiohook->source, data)) { - if (allow) { - if (option_debug > 1) { - ast_log(LOG_DEBUG, "Audiohook source %s is already set up to be inherited from channel %s\n", data, chan->name); - } - return 0; - } else { - if (option_debug > 1) { - ast_log(LOG_DEBUG, "Removing inheritability of audiohook %s from channel %s\n", data, chan->name); - } - AST_LIST_REMOVE_CURRENT(&inheritance_datastore->allowed_list, list); - ast_free(inheritable_audiohook); - return 0; - } - } - } - AST_LIST_TRAVERSE_SAFE_END; - - /* Step 4: There is no step 4 */ - - /* Step 5: This means we are addressing an audiohook source which we have not encountered yet for the channel. Create a new inheritable - * audiohook structure if we're allowing inheritance, or just return if not - */ - - if (allow) { - return setup_inheritable_audiohook(inheritance_datastore, data); - } else { - if (option_debug) { - ast_log(LOG_DEBUG, "Audiohook %s is already set to not be inheritable on channel %s\n", data, chan->name); - } - return 0; - } -} - -static struct ast_custom_function inheritance_function = { - .name = "AUDIOHOOK_INHERIT", - .synopsis = "Set whether an audiohook may be inherited to another channel", - .syntax = "AUDIOHOOK_INHERIT(source)", - .desc = - "By enabling audiohook inheritance on the channel, you are giving\n" - "permission for an audiohook to be inherited by a descendent channel.\n" - "Inheritance may be be disabled at any point as well.\n" - "\n" - " Example scenario:\n" - " exten => 2000,1,MixMonitor(blah.wav)\n" - " exten => 2000,n,Set(AUDIOHOOK_INHERIT(MixMonitor)=yes)\n" - " exten => 2000,n,Dial(SIP/2000)\n" - "\n" - " exten => 4000,1,Dial(SIP/4000)\n" - "\n" - " exten => 5000,1,MixMonitor(blah2.wav)\n" - " exten => 5000,n,Dial(SIP/5000)\n" - "\n" - " In this basic dialplan scenario, let's consider the following sample calls\n" - " Call 1: Caller dials 2000. The person who answers then executes an attended\n" - " transfer to 4000.\n" - " Result: Since extension 2000 set MixMonitor to be inheritable, after the\n" - " transfer to 400 has completed, the call will continue to be recorded\n" - " to blah.wav\n" - "\n" - " Call 2: Caller dials 5000. The person who answers then executes an attended\n" - " transfer to 4000.\n" - " Result: Since extension 5000 did not set MixMonitor to be inheritable, the\n" - " recording will stop once the call has been transferred to 4000.\n", - .write = func_inheritance_write, -}; - -static int unload_module(void) -{ - return ast_custom_function_unregister(&inheritance_function); -} - -static int load_module(void) -{ - if (ast_custom_function_register(&inheritance_function)) { - return AST_MODULE_LOAD_DECLINE; - } else { - return AST_MODULE_LOAD_SUCCESS; - } -} -AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Audiohook inheritance function"); |