Mon Mar 12 2012 21:31:15

Asterisk developer's documentation


chan_multicast_rtp.c File Reference

Multicast RTP Paging Channel. More...

#include "asterisk.h"
#include <fcntl.h>
#include <sys/signal.h>
#include "asterisk/lock.h"
#include "asterisk/channel.h"
#include "asterisk/config.h"
#include "asterisk/module.h"
#include "asterisk/pbx.h"
#include "asterisk/sched.h"
#include "asterisk/io.h"
#include "asterisk/acl.h"
#include "asterisk/callerid.h"
#include "asterisk/file.h"
#include "asterisk/cli.h"
#include "asterisk/app.h"
#include "asterisk/rtp_engine.h"
#include "asterisk/causes.h"
Include dependency graph for chan_multicast_rtp.c:

Go to the source code of this file.

Functions

static void __reg_module (void)
static void __unreg_module (void)
static int load_module (void)
 Function called when our module is loaded.
static int multicast_rtp_call (struct ast_channel *ast, char *dest, int timeout)
 Function called when we should actually call the destination.
static int multicast_rtp_hangup (struct ast_channel *ast)
 Function called when we should hang the channel up.
static struct ast_framemulticast_rtp_read (struct ast_channel *ast)
 Function called when we should read a frame from the channel.
static struct ast_channelmulticast_rtp_request (const char *type, format_t format, const struct ast_channel *requestor, void *data, int *cause)
 Function called when we should prepare to call the destination.
static int multicast_rtp_write (struct ast_channel *ast, struct ast_frame *f)
 Function called when we should write a frame to the channel.
static int unload_module (void)
 Function called when our module is unloaded.

Variables

static struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Multicast RTP Paging Channel" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_CHANNEL_DRIVER, }
static struct ast_module_infoast_module_info = &__mod_info
static struct ast_channel_tech multicast_rtp_tech
static const char tdesc [] = "Multicast RTP Paging Channel Driver"

Detailed Description

Multicast RTP Paging Channel.

Author:
Joshua Colp <jcolp@digium.com>
Andreas 'MacBrody' Broadmann <andreas.brodmann@gmail.com>

Definition in file chan_multicast_rtp.c.


Function Documentation

static void __reg_module ( void  ) [static]

Definition at line 197 of file chan_multicast_rtp.c.

static void __unreg_module ( void  ) [static]

Definition at line 197 of file chan_multicast_rtp.c.

static int load_module ( void  ) [static]

Function called when our module is loaded.

Definition at line 175 of file chan_multicast_rtp.c.

References ast_channel_register(), ast_log(), AST_MODULE_LOAD_DECLINE, AST_MODULE_LOAD_SUCCESS, and LOG_ERROR.

{
   if (ast_channel_register(&multicast_rtp_tech)) {
      ast_log(LOG_ERROR, "Unable to register channel class 'MulticastRTP'\n");
      return AST_MODULE_LOAD_DECLINE;
   }

   return AST_MODULE_LOAD_SUCCESS;
}
static int multicast_rtp_call ( struct ast_channel ast,
char *  dest,
int  timeout 
) [static]

Function called when we should actually call the destination.

Definition at line 92 of file chan_multicast_rtp.c.

References AST_CONTROL_ANSWER, ast_queue_control(), ast_rtp_instance_activate(), and ast_channel::tech_pvt.

{
   struct ast_rtp_instance *instance = ast->tech_pvt;

   ast_queue_control(ast, AST_CONTROL_ANSWER);

   return ast_rtp_instance_activate(instance);
}
static int multicast_rtp_hangup ( struct ast_channel ast) [static]

Function called when we should hang the channel up.

Definition at line 102 of file chan_multicast_rtp.c.

References ast_rtp_instance_destroy(), and ast_channel::tech_pvt.

{
   struct ast_rtp_instance *instance = ast->tech_pvt;

   ast_rtp_instance_destroy(instance);

   ast->tech_pvt = NULL;

   return 0;
}
static struct ast_frame * multicast_rtp_read ( struct ast_channel ast) [static, read]

Function called when we should read a frame from the channel.

Definition at line 78 of file chan_multicast_rtp.c.

References ast_null_frame.

{
   return &ast_null_frame;
}
static struct ast_channel * multicast_rtp_request ( const char *  type,
format_t  format,
const struct ast_channel requestor,
void *  data,
int *  cause 
) [static, read]

Function called when we should prepare to call the destination.

Definition at line 114 of file chan_multicast_rtp.c.

References ast_best_codec(), AST_CAUSE_FAILURE, ast_channel_alloc(), ast_rtp_instance_destroy(), ast_rtp_instance_new(), ast_rtp_instance_set_remote_address(), ast_sockaddr_parse(), ast_sockaddr_setnull(), AST_STATE_DOWN, ast_strdupa, ast_strlen_zero(), ast_channel::linkedid, multicast_rtp_tech, ast_channel::nativeformats, PARSE_PORT_REQUIRE, ast_channel::rawreadformat, ast_channel::rawwriteformat, ast_channel::readformat, ast_channel::tech, ast_channel::tech_pvt, and ast_channel::writeformat.

{
   char *tmp = ast_strdupa(data), *multicast_type = tmp, *destination, *control;
   struct ast_rtp_instance *instance;
   struct ast_sockaddr control_address;
   struct ast_sockaddr destination_address;
   struct ast_channel *chan;
   format_t fmt = ast_best_codec(format);

   ast_sockaddr_setnull(&control_address);

   /* If no type was given we can't do anything */
   if (ast_strlen_zero(multicast_type)) {
      goto failure;
   }

   if (!(destination = strchr(tmp, '/'))) {
      goto failure;
   }
   *destination++ = '\0';

   if ((control = strchr(destination, '/'))) {
      *control++ = '\0';
      if (!ast_sockaddr_parse(&control_address, control,
               PARSE_PORT_REQUIRE)) {
         goto failure;
      }
   }

   if (!ast_sockaddr_parse(&destination_address, destination,
            PARSE_PORT_REQUIRE)) {
      goto failure;
   }

   if (!(instance = ast_rtp_instance_new("multicast", NULL, &control_address, multicast_type))) {
      goto failure;
   }

   if (!(chan = ast_channel_alloc(1, AST_STATE_DOWN, "", "", "", "", "", requestor ? requestor->linkedid : "", 0, "MulticastRTP/%p", instance))) {
      ast_rtp_instance_destroy(instance);
      goto failure;
   }

   ast_rtp_instance_set_remote_address(instance, &destination_address);

   chan->tech = &multicast_rtp_tech;
   chan->nativeformats = fmt;
   chan->writeformat = fmt;
   chan->readformat = fmt;
   chan->rawwriteformat = fmt;
   chan->rawreadformat = fmt;
   chan->tech_pvt = instance;

   return chan;

failure:
   *cause = AST_CAUSE_FAILURE;
   return NULL;
}
static int multicast_rtp_write ( struct ast_channel ast,
struct ast_frame f 
) [static]

Function called when we should write a frame to the channel.

Definition at line 84 of file chan_multicast_rtp.c.

References ast_rtp_instance_write(), and ast_channel::tech_pvt.

{
   struct ast_rtp_instance *instance = ast->tech_pvt;

   return ast_rtp_instance_write(instance, f);
}
static int unload_module ( void  ) [static]

Function called when our module is unloaded.

Definition at line 186 of file chan_multicast_rtp.c.

References ast_channel_unregister().


Variable Documentation

struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Multicast RTP Paging Channel" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = AST_BUILDOPT_SUM, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_CHANNEL_DRIVER, } [static]

Definition at line 197 of file chan_multicast_rtp.c.

Definition at line 197 of file chan_multicast_rtp.c.

Definition at line 66 of file chan_multicast_rtp.c.

Referenced by multicast_rtp_request().

const char tdesc[] = "Multicast RTP Paging Channel Driver" [static]

Definition at line 56 of file chan_multicast_rtp.c.