Mon May 14 04:49:13 2007

Asterisk developer's documentation


func_channel.c File Reference

Channel info dialplan function. More...

#include "asterisk.h"
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <sys/types.h>
#include "asterisk/module.h"
#include "asterisk/channel.h"
#include "asterisk/pbx.h"
#include "asterisk/logger.h"
#include "asterisk/utils.h"
#include "asterisk/app.h"
#include "asterisk/indications.h"
#include "asterisk/stringfields.h"

Include dependency graph for func_channel.c:

Go to the source code of this file.

Defines

#define locked_copy_string(chan, dest, source, len)
#define locked_string_field_set(chan, field, source)

Functions

 AST_MODULE_INFO_STANDARD (ASTERISK_GPL_KEY,"Channel information dialplan function")
static int func_channel_read (struct ast_channel *chan, char *function, char *data, char *buf, size_t len)
static int func_channel_write (struct ast_channel *chan, char *function, char *data, const char *value)
static int load_module (void)
static int unload_module (void)

Variables

static struct ast_custom_function channel_function
char * transfercapability_table [0x20]


Detailed Description

Channel info dialplan function.

Author:
Kevin P. Fleming <kpfleming@digium.com>

Definition in file func_channel.c.


Define Documentation

#define locked_copy_string ( chan,
dest,
source,
len   ) 

Value:

do { \
      ast_channel_lock(chan); \
      ast_copy_string(dest, source, len); \
      ast_channel_unlock(chan); \
   } while (0)

Definition at line 44 of file func_channel.c.

Referenced by func_channel_read().

#define locked_string_field_set ( chan,
field,
source   ) 

Value:

do { \
      ast_channel_lock(chan); \
      ast_string_field_set(chan, field, source); \
      ast_channel_unlock(chan); \
   } while (0)

Definition at line 50 of file func_channel.c.

Referenced by func_channel_write().


Function Documentation

AST_MODULE_INFO_STANDARD ( ASTERISK_GPL_KEY  ,
"Channel information dialplan function"   
)

static int func_channel_read ( struct ast_channel chan,
char *  function,
char *  data,
char *  buf,
size_t  len 
) [static]

Definition at line 63 of file func_channel.c.

References ast_channel::_state, AST_FORMAT_AUDIO_MASK, AST_FORMAT_VIDEO_MASK, ast_getformatname(), ast_log(), ast_print_group(), ast_state2str(), ast_channel::callgroup, tone_zone::country, ast_channel_tech::func_channel_read, locked_copy_string, LOG_WARNING, ast_channel::nativeformats, ast_channel::readformat, ast_channel::tech, ast_channel::transfercapability, ast_channel_tech::type, ast_channel::writeformat, and ast_channel::zone.

00065 {
00066    int ret = 0;
00067 
00068    if (!strcasecmp(data, "audionativeformat"))
00069       /* use the _multiple version when chan->nativeformats holds multiple formats */
00070       /* ast_getformatname_multiple(buf, len, chan->nativeformats & AST_FORMAT_AUDIO_MASK); */
00071       ast_copy_string(buf, ast_getformatname(chan->nativeformats & AST_FORMAT_AUDIO_MASK), len);
00072    else if (!strcasecmp(data, "videonativeformat"))
00073       /* use the _multiple version when chan->nativeformats holds multiple formats */
00074       /* ast_getformatname_multiple(buf, len, chan->nativeformats & AST_FORMAT_VIDEO_MASK); */
00075       ast_copy_string(buf, ast_getformatname(chan->nativeformats & AST_FORMAT_VIDEO_MASK), len);
00076    else if (!strcasecmp(data, "audioreadformat"))
00077       ast_copy_string(buf, ast_getformatname(chan->readformat), len);
00078    else if (!strcasecmp(data, "audiowriteformat"))
00079       ast_copy_string(buf, ast_getformatname(chan->writeformat), len);
00080    else if (!strcasecmp(data, "tonezone") && chan->zone)
00081       locked_copy_string(chan, buf, chan->zone->country, len);
00082    else if (!strcasecmp(data, "language"))
00083       locked_copy_string(chan, buf, chan->language, len);
00084    else if (!strcasecmp(data, "musicclass"))
00085       locked_copy_string(chan, buf, chan->musicclass, len);
00086    else if (!strcasecmp(data, "state"))
00087       locked_copy_string(chan, buf, ast_state2str(chan->_state), len);
00088    else if (!strcasecmp(data, "channeltype"))
00089       locked_copy_string(chan, buf, chan->tech->type, len);
00090    else if (!strcasecmp(data, "transfercapability"))
00091       locked_copy_string(chan, buf, transfercapability_table[chan->transfercapability & 0x1f], len);
00092    else if (!strcasecmp(data, "callgroup")) {
00093       char groupbuf[256];
00094       locked_copy_string(chan, buf,  ast_print_group(groupbuf, sizeof(groupbuf), chan->callgroup), len);
00095    } else if (!chan->tech->func_channel_read
00096        || chan->tech->func_channel_read(chan, function, data, buf, len)) {
00097       ast_log(LOG_WARNING, "Unknown or unavailable item requested: '%s'\n", data);
00098       ret = -1;
00099    }
00100 
00101    return ret;
00102 }

static int func_channel_write ( struct ast_channel chan,
char *  function,
char *  data,
const char *  value 
) [static]

Definition at line 104 of file func_channel.c.

References ast_channel_setoption(), ast_get_group(), ast_get_indication_zone(), ast_log(), AST_OPTION_RXGAIN, AST_OPTION_TXGAIN, ast_channel::callgroup, ast_channel_tech::func_channel_write, language, locked_string_field_set, LOG_ERROR, LOG_WARNING, musicclass, ast_channel::tech, ast_channel::transfercapability, and ast_channel::zone.

00106 {
00107    int ret = 0;
00108    signed char gainset;
00109 
00110    if (!strcasecmp(data, "language"))
00111       locked_string_field_set(chan, language, value);
00112    else if (!strcasecmp(data, "musicclass"))
00113       locked_string_field_set(chan, musicclass, value);
00114    else if (!strcasecmp(data, "tonezone")) {
00115       struct tone_zone *new_zone;
00116       if (!(new_zone = ast_get_indication_zone(value))) {
00117          ast_log(LOG_ERROR, "Unknown country code '%s' for tonezone. Check indications.conf for available country codes.\n", value);
00118          ret = -1;   
00119       } else 
00120          chan->zone = new_zone;
00121    } else if (!strcasecmp(data, "callgroup"))
00122       chan->callgroup = ast_get_group(value);
00123    else if (!strcasecmp(data, "txgain")) {
00124       sscanf(value, "%hhd", &gainset);
00125       ast_channel_setoption(chan, AST_OPTION_TXGAIN, &gainset, sizeof(gainset), 0);
00126    } else if (!strcasecmp(data, "rxgain")) {
00127       sscanf(value, "%hhd", &gainset);
00128       ast_channel_setoption(chan, AST_OPTION_RXGAIN, &gainset, sizeof(gainset), 0);
00129    } else if (!strcasecmp(data, "transfercapability")) {
00130       unsigned short i;
00131       for (i = 0; i < 0x20; i++) {
00132          if (!strcasecmp(transfercapability_table[i], value) && strcmp(value, "UNK")) {
00133             chan->transfercapability = i;
00134             break;
00135          }
00136       }
00137    } else if (!chan->tech->func_channel_write
00138        || chan->tech->func_channel_write(chan, function, data, value)) {
00139       ast_log(LOG_WARNING, "Unknown or unavailable item requested: '%s'\n",
00140             data);
00141       ret = -1;
00142    }
00143 
00144    return ret;
00145 }

static int load_module ( void   )  [static]

Definition at line 198 of file func_channel.c.

References ast_custom_function_register(), and channel_function.

00199 {
00200    return ast_custom_function_register(&channel_function);
00201 }

static int unload_module ( void   )  [static]

Definition at line 193 of file func_channel.c.

References ast_custom_function_unregister(), and channel_function.

00194 {
00195    return ast_custom_function_unregister(&channel_function);
00196 }


Variable Documentation

struct ast_custom_function channel_function [static]

Definition at line 147 of file func_channel.c.

Referenced by load_module(), and unload_module().

char* transfercapability_table[0x20]

Initial value:

 {
   "SPEECH", "UNK", "UNK", "UNK", "UNK", "UNK", "UNK", "UNK",
   "DIGITAL", "RESTRICTED_DIGITAL", "UNK", "UNK", "UNK", "UNK", "UNK", "UNK",
   "3K1AUDIO", "DIGITAL_W_TONES", "UNK", "UNK", "UNK", "UNK", "UNK", "UNK",
   "VIDEO", "UNK", "UNK", "UNK", "UNK", "UNK", "UNK", "UNK", }

Definition at line 57 of file func_channel.c.


Generated on Mon May 14 04:49:14 2007 for Asterisk - the Open Source PBX by  doxygen 1.5.1