/* * Asterisk -- An open source telephony toolkit. * * Copyright (C) 2013, Digium, Inc. * * David M. Lee, II * * 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. */ /*! \file * * \brief Stasis application support. * * \author David M. Lee, II */ #include "asterisk.h" ASTERISK_FILE_VERSION(__FILE__, "$Revision$") #include "app.h" #include "asterisk/stasis_app.h" #include "asterisk/stasis_channels.h" /*! * \brief Number of buckets for the channels container for app instances. Remember * to keep it a prime number! */ #define APP_CHANNELS_BUCKETS 7 /*! * \brief Number of buckets for the bridges container for app instances. Remember * to keep it a prime number! */ #define APP_BRIDGES_BUCKETS 7 struct app { /*! Callback function for this application. */ stasis_app_cb handler; /*! Opaque data to hand to callback function. */ void *data; /*! List of channel identifiers this app instance is interested in */ struct ao2_container *channels; /*! List of bridge identifiers this app instance owns */ struct ao2_container *bridges; /*! Name of the Stasis application */ char name[]; }; static void app_dtor(void *obj) { struct app *app = obj; ao2_cleanup(app->data); app->data = NULL; ao2_cleanup(app->channels); app->channels = NULL; ao2_cleanup(app->bridges); app->bridges = NULL; } struct app *app_create(const char *name, stasis_app_cb handler, void *data) { RAII_VAR(struct app *, app, NULL, ao2_cleanup); size_t size; ast_assert(name != NULL); ast_assert(handler != NULL); ast_verb(1, "Creating Stasis app '%s'\n", name); size = sizeof(*app) + strlen(name) + 1; app = ao2_alloc_options(size, app_dtor, AO2_ALLOC_OPT_LOCK_MUTEX); if (!app) { return NULL; } strncpy(app->name, name, size - sizeof(*app)); app->handler = handler; ao2_ref(data, +1); app->data = data; app->channels = ast_str_container_alloc(APP_CHANNELS_BUCKETS); if (!app->channels) { return NULL; } app->bridges = ast_str_container_alloc(APP_BRIDGES_BUCKETS); if (!app->bridges) { return NULL; } ao2_ref(app, +1); return app; } int app_add_channel(struct app *app, const struct ast_channel *chan) { SCOPED_AO2LOCK(lock, app); const char *uniqueid; ast_assert(app != NULL); ast_assert(chan != NULL); /* Don't accept new channels in an inactive application */ if (!app->handler) { return -1; } uniqueid = ast_channel_uniqueid(chan); return ast_str_container_add(app->channels, uniqueid) ? -1 : 0; } void app_remove_channel(struct app* app, const struct ast_channel *chan) { SCOPED_AO2LOCK(lock, app); ast_assert(app != NULL); ast_assert(chan != NULL); ao2_find(app->channels, ast_channel_uniqueid(chan), OBJ_KEY | OBJ_NODATA | OBJ_UNLINK); } int app_add_bridge(struct app *app, const char *uniqueid) { SCOPED_AO2LOCK(lock, app); ast_assert(app != NULL); ast_assert(uniqueid != NULL); /* Don't accept new bridges in an inactive application */ if (!app->handler) { return -1; } return ast_str_container_add(app->bridges, uniqueid) ? -1 : 0; } void app_remove_bridge(struct app* app, const char *uniqueid) { SCOPED_AO2LOCK(lock, app); ast_assert(app != NULL); ast_assert(uniqueid != NULL); ao2_find(app->bridges, uniqueid, OBJ_KEY | OBJ_NODATA | OBJ_UNLINK | OBJ_MULTIPLE); } /*! * \brief Send a message to the given application. * \param app App to send the message to. * \param message Message to send. */ void app_send(struct app *app, struct ast_json *message) { stasis_app_cb handler; RAII_VAR(void *, data, NULL, ao2_cleanup); /* Copy off mutable state with lock held */ { SCOPED_AO2LOCK(lock, app); handler = app->handler; if (app->data) { ao2_ref(app->data, +1); data = app->data; } /* Name is immutable; no need to copy */ } if (!handler) { ast_verb(3, "Inactive Stasis app '%s' missed message\n", app->name); return; } handler(data, app->name, message); } void app_deactivate(struct app *app) { SCOPED_AO2LOCK(lock, app); ast_verb(1, "Deactivating Stasis app '%s'\n", app->name); app->handler = NULL; ao2_cleanup(app->data); app->data = NULL; } int app_is_active(struct app *app) { SCOPED_AO2LOCK(lock, app); return app->handler != NULL; } int app_is_finished(struct app *app) { SCOPED_AO2LOCK(lock, app); return app->handler == NULL && ao2_container_count(app->channels) == 0; } void app_update(struct app *app, stasis_app_cb handler, void *data) { SCOPED_AO2LOCK(lock, app); if (app->handler) { RAII_VAR(struct ast_json *, msg, NULL, ast_json_unref); ast_verb(1, "Replacing Stasis app '%s'\n", app->name); msg = ast_json_pack("{s: s, s: s}", "type", "ApplicationReplaced", "application", app->name); if (msg) { app_send(app, msg); } } else { ast_verb(1, "Activating Stasis app '%s'\n", app->name); } app->handler = handler; ao2_cleanup(app->data); if (data) { ao2_ref(data, +1); } app->data = data; } const char *app_name(const struct app *app) { return app->name; } int app_is_watching_channel(struct app *app, const char *uniqueid) { RAII_VAR(char *, found, NULL, ao2_cleanup); found = ao2_find(app->channels, uniqueid, OBJ_KEY); return found != NULL; } int app_is_watching_bridge(struct app *app, const char *uniqueid) { RAII_VAR(char *, found, NULL, ao2_cleanup); found = ao2_find(app->bridges, uniqueid, OBJ_KEY); return found != NULL; }