chan_bridge_media.c File Reference

Bridge Media Channels driver. More...

#include "asterisk.h"
#include "asterisk/channel.h"
#include "asterisk/bridge.h"
#include "asterisk/core_unreal.h"
#include "asterisk/module.h"

Include dependency graph for chan_bridge_media.c:

Go to the source code of this file.

Functions
static void	__reg_module (void)
static void	__unreg_module (void)
static struct ast_channel *	announce_request (const char *type, struct ast_format_cap *cap, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *data, int *cause)
struct ast_module *	AST_MODULE_SELF_SYM (void)
static void	cleanup_capabilities (void)
static int	load_module (void)
static int	media_call (struct ast_channel *chan, const char *addr, int timeout)
static int	media_hangup (struct ast_channel *ast)
static struct ast_channel *	media_request_helper (struct ast_format_cap *cap, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *data, struct ast_channel_tech *tech, const char *role)
static struct ast_channel *	record_request (const char *type, struct ast_format_cap *cap, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *data, int *cause)
static int	unload_module (void)

Variables
static struct ast_module_info	__mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_DEFAULT , .description = "Bridge Media Channel Driver" , .key = ASTERISK_GPL_KEY , .buildopt_sum = AST_BUILDOPT_SUM, .support_level = AST_MODULE_SUPPORT_CORE, .load = load_module, .unload = unload_module, }
static struct ast_channel_tech	announce_tech
static const struct ast_module_info *	ast_module_info = &__mod_info
static struct ast_channel_tech	record_tech

Detailed Description

Bridge Media Channels driver.

Author

Jonathan Rose jrose.nosp@m.@dig.nosp@m.ium.c.nosp@m.om

Richard Mudgett rmudg.nosp@m.ett@.nosp@m.digiu.nosp@m.m.co.nosp@m.m

Bridge Media Channels

Definition in file chan_bridge_media.c.

Function Documentation

__reg_module()

static void __reg_module ( void  )

static

Definition at line 219 of file chan_bridge_media.c.

__unreg_module()

static void __unreg_module ( void  )

static

Definition at line 219 of file chan_bridge_media.c.

announce_request()

static struct ast_channel * announce_request ( const char *  type, struct ast_format_cap *  cap, const struct ast_assigned_ids *  assignedids, const struct ast_channel *  requestor, const char *  data, int *  cause  )

static

Definition at line 150 of file chan_bridge_media.c.

{
    return media_request_helper(cap, assignedids, requestor, data, &announce_tech, "announcer");
}

References announce_tech, ast_channel::data, and media_request_helper().

AST_MODULE_SELF_SYM()

struct ast_module * AST_MODULE_SELF_SYM

(

void

)

Definition at line 219 of file chan_bridge_media.c.

cleanup_capabilities()

static void cleanup_capabilities ( void  )

static

Definition at line 162 of file chan_bridge_media.c.

{
    if (announce_tech.capabilities) {
        ao2_ref(announce_tech.capabilities, -1);
        announce_tech.capabilities = NULL;
    }
 
    if (record_tech.capabilities) {
        ao2_ref(record_tech.capabilities, -1);
        record_tech.capabilities = NULL;
    }
}

References announce_tech, ao2_ref, ast_channel_tech::capabilities, NULL, and record_tech.

Referenced by load_module(), and unload_module().

load_module()

static int load_module ( void  )

static

Definition at line 183 of file chan_bridge_media.c.

{
    announce_tech.capabilities = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
    if (!announce_tech.capabilities) {
        return AST_MODULE_LOAD_DECLINE;
    }
 
    record_tech.capabilities = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
    if (!record_tech.capabilities) {
        return AST_MODULE_LOAD_DECLINE;
    }
 
    ast_format_cap_append_by_type(announce_tech.capabilities, AST_MEDIA_TYPE_UNKNOWN);
    ast_format_cap_append_by_type(record_tech.capabilities, AST_MEDIA_TYPE_UNKNOWN);
 
    if (ast_channel_register(&announce_tech)) {
        ast_log(LOG_ERROR, "Unable to register channel technology %s(%s).\n",
            announce_tech.type, announce_tech.description);
        cleanup_capabilities();
        return AST_MODULE_LOAD_DECLINE;
    }
 
    if (ast_channel_register(&record_tech)) {
        ast_log(LOG_ERROR, "Unable to register channel technology %s(%s).\n",
            record_tech.type, record_tech.description);
        cleanup_capabilities();
        return AST_MODULE_LOAD_DECLINE;
    }
 
    return AST_MODULE_LOAD_SUCCESS;
}

References announce_tech, ast_channel_register(), ast_format_cap_alloc, ast_format_cap_append_by_type(), AST_FORMAT_CAP_FLAG_DEFAULT, ast_log, AST_MEDIA_TYPE_UNKNOWN, AST_MODULE_LOAD_DECLINE, AST_MODULE_LOAD_SUCCESS, ast_channel_tech::capabilities, cleanup_capabilities(), ast_channel_tech::description, LOG_ERROR, record_tech, and ast_channel_tech::type.

media_call()

static int media_call ( struct ast_channel *  chan, const char *  addr, int  timeout  )

static

Definition at line 42 of file chan_bridge_media.c.

{
    /* ast_call() will fail unconditionally against channels provided by this driver */
    return -1;
}

media_hangup()

static int media_hangup ( struct ast_channel *  ast )

static

Definition at line 48 of file chan_bridge_media.c.

{
    struct ast_unreal_pvt *p = ast_channel_tech_pvt(ast);
    int res;
 
    if (!p) {
        return -1;
    }
 
    /* Give the pvt a ref to fulfill calling requirements. */
    ao2_ref(p, +1);
    res = ast_unreal_hangup(p, ast);
    ao2_ref(p, -1);
 
    return res;
}

References ao2_ref, ast_channel_tech_pvt(), and ast_unreal_hangup().

media_request_helper()

static struct ast_channel * media_request_helper ( struct ast_format_cap *  cap, const struct ast_assigned_ids *  assignedids, const struct ast_channel *  requestor, const char *  data, struct ast_channel_tech *  tech, const char *  role  )

static

Definition at line 115 of file chan_bridge_media.c.

{
    struct ast_channel *chan;
    ast_callid callid;
 
    RAII_VAR(struct ast_unreal_pvt *, pvt, NULL, ao2_cleanup);
 
    if (!(pvt = ast_unreal_alloc(sizeof(*pvt), ast_unreal_destructor, cap))) {
        return NULL;
    }
 
    ast_copy_string(pvt->name, data, sizeof(pvt->name));
 
    ast_set_flag(pvt, AST_UNREAL_NO_OPTIMIZATION);
 
    callid = ast_read_threadstorage_callid();
 
    chan = ast_unreal_new_channels(pvt, tech,
        AST_STATE_UP, AST_STATE_UP, NULL, NULL, assignedids, requestor, callid);
    if (!chan) {
        return NULL;
    }
 
    ast_answer(pvt->owner);
    ast_answer(pvt->chan);
 
    if (ast_channel_add_bridge_role(pvt->chan, role)) {
        ast_hangup(chan);
        return NULL;
    }
 
    return chan;
}

References ao2_cleanup, ast_answer(), ast_channel_add_bridge_role(), ast_copy_string(), ast_hangup(), ast_read_threadstorage_callid(), ast_set_flag, AST_STATE_UP, ast_unreal_alloc(), ast_unreal_destructor(), ast_unreal_new_channels(), AST_UNREAL_NO_OPTIMIZATION, ast_channel::callid, ast_channel::data, NULL, RAII_VAR, and ast_channel::tech.

Referenced by announce_request(), and record_request().

record_request()

static struct ast_channel * record_request ( const char *  type, struct ast_format_cap *  cap, const struct ast_assigned_ids *  assignedids, const struct ast_channel *  requestor, const char *  data, int *  cause  )

static

Definition at line 156 of file chan_bridge_media.c.

{
    return media_request_helper(cap, assignedids, requestor, data, &record_tech, "recorder");
}

References ast_channel::data, media_request_helper(), and record_tech.

unload_module()

static int unload_module ( void  )

static

Definition at line 175 of file chan_bridge_media.c.

{
    ast_channel_unregister(&announce_tech);
    ast_channel_unregister(&record_tech);
    cleanup_capabilities();
    return 0;
}

References announce_tech, ast_channel_unregister(), cleanup_capabilities(), and record_tech.

Variable Documentation

__mod_info

struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_DEFAULT , .description = "Bridge Media Channel Driver" , .key = ASTERISK_GPL_KEY , .buildopt_sum = AST_BUILDOPT_SUM, .support_level = AST_MODULE_SUPPORT_CORE, .load = load_module, .unload = unload_module, }

static

Definition at line 219 of file chan_bridge_media.c.

announce_tech

struct ast_channel_tech announce_tech

static

Definition at line 71 of file chan_bridge_media.c.

                                               {
    .type = "Announcer",
    .description = "Bridge Media Announcing Channel Driver",
    .requester = announce_request,
    .call = media_call,
    .hangup = media_hangup,
 
    .send_digit_begin = ast_unreal_digit_begin,
    .send_digit_end = ast_unreal_digit_end,
    .read = ast_unreal_read,
    .write = ast_unreal_write,
    .write_video = ast_unreal_write,
    .exception = ast_unreal_read,
    .indicate = ast_unreal_indicate,
    .fixup = ast_unreal_fixup,
    .send_html = ast_unreal_sendhtml,
    .send_text = ast_unreal_sendtext,
    .queryoption = ast_unreal_queryoption,
    .setoption = ast_unreal_setoption,
    .properties = AST_CHAN_TP_INTERNAL,
};

Referenced by announce_request(), cleanup_capabilities(), load_module(), and unload_module().

ast_module_info

const struct ast_module_info* ast_module_info = &__mod_info

static

Definition at line 219 of file chan_bridge_media.c.

record_tech

struct ast_channel_tech record_tech

static

Definition at line 93 of file chan_bridge_media.c.

                                             {
    .type = "Recorder",
    .description = "Bridge Media Recording Channel Driver",
    .requester = record_request,
    .call = media_call,
    .hangup = media_hangup,
 
    .send_digit_begin = ast_unreal_digit_begin,
    .send_digit_end = ast_unreal_digit_end,
    .read = ast_unreal_read,
    .write = ast_unreal_write,
    .write_video = ast_unreal_write,
    .exception = ast_unreal_read,
    .indicate = ast_unreal_indicate,
    .fixup = ast_unreal_fixup,
    .send_html = ast_unreal_sendhtml,
    .send_text = ast_unreal_sendtext,
    .queryoption = ast_unreal_queryoption,
    .setoption = ast_unreal_setoption,
    .properties = AST_CHAN_TP_INTERNAL,
};

Referenced by cleanup_capabilities(), load_module(), record_request(), and unload_module().