Tue Apr 28 22:50:32 2009

Asterisk developer's documentation


channel.c File Reference

Channel Management. More...

#include "asterisk.h"
#include <stdio.h>
#include <stdlib.h>
#include <stdarg.h>
#include <string.h>
#include <sys/time.h>
#include <signal.h>
#include <errno.h>
#include <unistd.h>
#include <math.h>
#include "asterisk/pbx.h"
#include "asterisk/frame.h"
#include "asterisk/sched.h"
#include "asterisk/options.h"
#include "asterisk/channel.h"
#include "asterisk/audiohook.h"
#include "asterisk/musiconhold.h"
#include "asterisk/logger.h"
#include "asterisk/say.h"
#include "asterisk/file.h"
#include "asterisk/cli.h"
#include "asterisk/translate.h"
#include "asterisk/manager.h"
#include "asterisk/chanvars.h"
#include "asterisk/linkedlists.h"
#include "asterisk/indications.h"
#include "asterisk/monitor.h"
#include "asterisk/causes.h"
#include "asterisk/callerid.h"
#include "asterisk/utils.h"
#include "asterisk/lock.h"
#include "asterisk/app.h"
#include "asterisk/transcap.h"
#include "asterisk/devicestate.h"
#include "asterisk/sha1.h"
#include "asterisk/threadstorage.h"
#include "asterisk/slinfactory.h"

Go to the source code of this file.

Data Structures

struct  ast_cause
struct  ast_silence_generator
struct  backends
struct  chanlist
struct  channels
struct  tonepair_def
struct  tonepair_state

Defines

#define AST_DEFAULT_EMULATE_DTMF_DURATION   100
#define AST_MIN_DTMF_DURATION   80
#define AST_MIN_DTMF_GAP   45
#define FORMAT   "%-10.10s %-40.40s %-12.12s %-12.12s %-12.12s\n"
#define MONITOR_CONSTANT_DELAY
#define MONITOR_DELAY   150 * 8
#define STATE2STR_BUFSIZE   32

Functions

static int __ast_queue_frame (struct ast_channel *chan, struct ast_frame *fin, int head)
 Queue an outgoing media frame.
static struct ast_frame__ast_read (struct ast_channel *chan, int dropaudio)
ast_channel__ast_request_and_dial (const char *type, int format, void *data, int timeout, int *outstate, const char *cid_num, const char *cid_name, struct outgoing_helper *oh)
int ast_activate_generator (struct ast_channel *chan, struct ast_generator *gen, void *params)
int ast_active_channels (void)
 returns number of active/allocated channels
int ast_answer (struct ast_channel *chan)
 Answer a ringing call.
void ast_begin_shutdown (int hangup)
 Initiate system shutdown.
int ast_best_codec (int fmts)
 Pick the best audio codec.
ast_channelast_bridged_channel (struct ast_channel *chan)
 Find bridged channel.
int ast_call (struct ast_channel *chan, char *addr, int timeout)
 Make a call.
void ast_cancel_shutdown (void)
 Cancel a shutdown in progress.
const char * ast_cause2str (int cause)
 Gives the string form of a given hangup cause.
void ast_change_name (struct ast_channel *chan, char *newname)
 Change channel name.
ast_channelast_channel_alloc (int needqueue, int state, const char *cid_num, const char *cid_name, const char *acctcode, const char *exten, const char *context, const int amaflag, const char *name_fmt,...)
 Create a channel structure.
enum ast_bridge_result ast_channel_bridge (struct ast_channel *c0, struct ast_channel *c1, struct ast_bridge_config *config, struct ast_frame **fo, struct ast_channel **rc)
 Bridge two channels together.
int ast_channel_cmpwhentohangup (struct ast_channel *chan, time_t offset)
 Compare a offset with the settings of when to hang a channel up.
int ast_channel_datastore_add (struct ast_channel *chan, struct ast_datastore *datastore)
 Add a datastore to a channel.
ast_datastoreast_channel_datastore_alloc (const struct ast_datastore_info *info, char *uid)
 Create a channel datastore structure.
ast_datastoreast_channel_datastore_find (struct ast_channel *chan, const struct ast_datastore_info *info, char *uid)
 Find a datastore on a channel.
int ast_channel_datastore_free (struct ast_datastore *datastore)
 Free a channel datastore structure.
int ast_channel_datastore_inherit (struct ast_channel *from, struct ast_channel *to)
 Inherit datastores from a parent to a child.
int ast_channel_datastore_remove (struct ast_channel *chan, struct ast_datastore *datastore)
 Remove a datastore from a channel.
int ast_channel_defer_dtmf (struct ast_channel *chan)
 Set defer DTMF flag on channel.
void ast_channel_free (struct ast_channel *chan)
 Free a channel structure.
void ast_channel_inherit_variables (const struct ast_channel *parent, struct ast_channel *child)
 Inherits channel variable from parent to child channel.
int ast_channel_make_compatible (struct ast_channel *chan, struct ast_channel *peer)
 Makes two channel formats compatible.
int ast_channel_masquerade (struct ast_channel *original, struct ast_channel *clone)
 Weird function made for call transfers.
char * ast_channel_reason2str (int reason)
 return an english explanation of the code returned thru __ast_request_and_dial's 'outstate' argument
int ast_channel_register (const struct ast_channel_tech *tech)
 Register a channel technology (a new channel driver) Called by a channel module to register the kind of channels it supports.
int ast_channel_sendhtml (struct ast_channel *chan, int subclass, const char *data, int datalen)
int ast_channel_sendurl (struct ast_channel *chan, const char *url)
int ast_channel_setoption (struct ast_channel *chan, int option, void *data, int datalen, int block)
 Sets an option on a channel.
void ast_channel_setwhentohangup (struct ast_channel *chan, time_t offset)
 Set when to hang a channel up.
ast_silence_generatorast_channel_start_silence_generator (struct ast_channel *chan)
 Starts a silence generator on the given channel.
void ast_channel_stop_silence_generator (struct ast_channel *chan, struct ast_silence_generator *state)
 Stops a previously-started silence generator on the given channel.
int ast_channel_supports_html (struct ast_channel *chan)
void ast_channel_undefer_dtmf (struct ast_channel *chan)
 Unset defer DTMF flag on channel.
void ast_channel_unregister (const struct ast_channel_tech *tech)
 Unregister a channel technology.
ast_channelast_channel_walk_locked (const struct ast_channel *prev)
 Browse channels in use Browse the channels currently in use.
void ast_channels_init (void)
ast_variableast_channeltype_list (void)
 return an ast_variable list of channeltypes
int ast_check_hangup (struct ast_channel *chan)
 Check to see if a channel is needing hang up.
static int ast_check_hangup_locked (struct ast_channel *chan)
void ast_deactivate_generator (struct ast_channel *chan)
int ast_do_masquerade (struct ast_channel *original)
 Start masquerading a channel XXX This is a seriously wacked out operation. We're essentially putting the guts of the clone channel into the original channel. Start by killing off the original channel's backend. I'm not sure we're going to keep this function, because while the features are nice, the cost is very high in terms of pure nastiness. XXX.
static enum ast_bridge_result ast_generic_bridge (struct ast_channel *c0, struct ast_channel *c1, struct ast_bridge_config *config, struct ast_frame **fo, struct ast_channel **rc, struct timeval bridge_end)
ast_channelast_get_channel_by_exten_locked (const char *exten, const char *context)
 Get channel by exten (and optionally context) and lock it.
ast_channelast_get_channel_by_name_locked (const char *name)
 Get channel by name (locks channel).
ast_channelast_get_channel_by_name_prefix_locked (const char *name, const int namelen)
 Get channel by name prefix (locks channel).
ast_channel_techast_get_channel_tech (const char *name)
 Get a channel technology structure by name.
ast_group_t ast_get_group (const char *s)
int ast_hangup (struct ast_channel *chan)
 Hang up a channel.
int ast_indicate (struct ast_channel *chan, int condition)
 Indicates condition of channel.
int ast_indicate_data (struct ast_channel *chan, int _condition, const void *data, size_t datalen)
 Indicates condition of channel, with payload.
void ast_install_music_functions (int(*start_ptr)(struct ast_channel *, const char *, const char *), void(*stop_ptr)(struct ast_channel *), void(*cleanup_ptr)(struct ast_channel *))
int ast_internal_timing_enabled (struct ast_channel *chan)
 Check if the channel can run in internal timing mode.
void ast_moh_cleanup (struct ast_channel *chan)
int ast_moh_start (struct ast_channel *chan, const char *mclass, const char *interpclass)
 Turn on music on hold on a given channel.
void ast_moh_stop (struct ast_channel *chan)
 Turn off music on hold on a given channel.
char * ast_print_group (char *buf, int buflen, ast_group_t group)
 print call- and pickup groups into buffer
int ast_prod (struct ast_channel *chan)
 Send empty audio to prime a channel driver.
int ast_queue_control (struct ast_channel *chan, enum ast_control_frame_type control)
 Queue a control frame with payload.
int ast_queue_control_data (struct ast_channel *chan, enum ast_control_frame_type control, const void *data, size_t datalen)
 Queue a control frame with payload.
int ast_queue_frame (struct ast_channel *chan, struct ast_frame *fin)
 Queue an outgoing frame.
int ast_queue_frame_head (struct ast_channel *chan, struct ast_frame *fin)
 Queue an outgoing frame to the head of the frame queue.
int ast_queue_hangup (struct ast_channel *chan)
 Queue a hangup frame.
ast_frameast_read (struct ast_channel *chan)
 Reads a frame.
static void ast_read_generator_actions (struct ast_channel *chan, struct ast_frame *f)
ast_frameast_read_noaudio (struct ast_channel *chan)
 Reads a frame, returning AST_FRAME_NULL frame if audio. Read a frame.
int ast_readstring (struct ast_channel *c, char *s, int len, int timeout, int ftimeout, char *enders)
int ast_readstring_full (struct ast_channel *c, char *s, int len, int timeout, int ftimeout, char *enders, int audiofd, int ctrlfd)
int ast_recvchar (struct ast_channel *chan, int timeout)
 Receives a text character from a channel.
char * ast_recvtext (struct ast_channel *chan, int timeout)
 Receives a text string from a channel Read a string of text from a channel.
ast_channelast_request (const char *type, int format, void *data, int *cause)
 Requests a channel.
ast_channelast_request_and_dial (const char *type, int format, void *data, int timeout, int *outstate, const char *cidnum, const char *cidname)
 Request a channel of a given type, with data as optional information used by the low level module and attempt to place a call on it.
int ast_safe_sleep (struct ast_channel *chan, int ms)
 Wait for a specied amount of time, looking for hangups.
int ast_safe_sleep_conditional (struct ast_channel *chan, int ms, int(*cond)(void *), void *data)
 Wait for a specied amount of time, looking for hangups and a condition argument.
char * ast_safe_string_alloc (const char *fmt,...)
 printf the string into a correctly sized mallocd buffer, and return the buffer
int ast_say_character_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang)
int ast_say_digit_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang)
int ast_say_digits (struct ast_channel *chan, int num, const char *ints, const char *lang)
int ast_say_digits_full (struct ast_channel *chan, int num, const char *ints, const char *lang, int audiofd, int ctrlfd)
int ast_say_enumeration (struct ast_channel *chan, int num, const char *ints, const char *language, const char *options)
int ast_say_number (struct ast_channel *chan, int num, const char *ints, const char *language, const char *options)
int ast_say_phonetic_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang)
int ast_senddigit (struct ast_channel *chan, char digit)
 Send a DTMF digit to a channel Send a DTMF digit to a channel.
int ast_senddigit_begin (struct ast_channel *chan, char digit)
int ast_senddigit_end (struct ast_channel *chan, char digit, unsigned int duration)
int ast_sendtext (struct ast_channel *chan, const char *text)
 Sends text to a channel Write text to a display on a channel.
void ast_set_callerid (struct ast_channel *chan, const char *callerid, const char *calleridname, const char *ani)
int ast_set_read_format (struct ast_channel *chan, int fmt)
 Sets read format on channel chan Set read format for channel to whichever component of "format" is best.
void ast_set_variables (struct ast_channel *chan, struct ast_variable *vars)
 adds a list of channel variables to a channel
int ast_set_write_format (struct ast_channel *chan, int fmt)
 Sets write format on channel chan Set write format for channel to whichever compoent of "format" is best.
int ast_setstate (struct ast_channel *chan, enum ast_channel_state state)
 Change the state of a channel.
int ast_settimeout (struct ast_channel *c, int samples, int(*func)(const void *data), void *data)
int ast_shutting_down (void)
 Returns non-zero if Asterisk is being shut down.
int ast_softhangup (struct ast_channel *chan, int cause)
 Softly hangup up a channel.
int ast_softhangup_nolock (struct ast_channel *chan, int cause)
 Softly hangup up a channel (no channel lock).
char * ast_state2str (enum ast_channel_state state)
 Gives the string form of a given channel state.
int ast_str2cause (const char *name)
 Convert a symbolic hangup cause to number.
int ast_tonepair (struct ast_channel *chan, int freq1, int freq2, int duration, int vol)
int ast_tonepair_start (struct ast_channel *chan, int freq1, int freq2, int duration, int vol)
void ast_tonepair_stop (struct ast_channel *chan)
int ast_transfer (struct ast_channel *chan, char *dest)
 Transfer a channel (if supported). Returns -1 on error, 0 if not supported and 1 if supported and requested.
char * ast_transfercapability2str (int transfercapability)
 Gives the string form of a given transfer capability.
void ast_uninstall_music_functions (void)
int ast_waitfor (struct ast_channel *c, int ms)
 Wait for input on a channel.
ast_channelast_waitfor_n (struct ast_channel **c, int n, int *ms)
 Waits for input on a group of channels Wait for input on an array of channels for a given # of milliseconds.
int ast_waitfor_n_fd (int *fds, int n, int *ms, int *exception)
 Waits for input on an fd This version works on fd's only. Be careful with it.
ast_channelast_waitfor_nandfds (struct ast_channel **c, int n, int *fds, int nfds, int *exception, int *outfd, int *ms)
 Waits for activity on a group of channels.
int ast_waitfordigit (struct ast_channel *c, int ms)
 Waits for a digit.
int ast_waitfordigit_full (struct ast_channel *c, int ms, int audiofd, int cmdfd)
 Wait for a digit Same as ast_waitfordigit() with audio fd for outputting read audio and ctrlfd to monitor for reading.
ast_channelast_walk_channel_by_exten_locked (const struct ast_channel *chan, const char *exten, const char *context)
 Get next channel by exten (and optionally context) and lock it.
ast_channelast_walk_channel_by_name_prefix_locked (const struct ast_channel *chan, const char *name, const int namelen)
 Get channel by name prefix (locks channel).
int ast_write (struct ast_channel *chan, struct ast_frame *fr)
 Write a frame to a channel This function writes the given frame to the indicated channel.
int ast_write_video (struct ast_channel *chan, struct ast_frame *fr)
 Write video frame to a channel This function writes the given frame to the indicated channel.
static void bridge_playfile (struct ast_channel *chan, struct ast_channel *peer, const char *sound, int remain)
static struct ast_channelchannel_find_locked (const struct ast_channel *prev, const char *name, const int namelen, const char *context, const char *exten)
 Helper function to find channels.
const char * channelreloadreason2txt (enum channelreloadreason reason)
 Convert enum channelreloadreason to text string for manager event.
static void clone_variables (struct ast_channel *original, struct ast_channel *clone)
 Clone channel variables from 'clone' channel into 'original' channel.
static char * complete_channeltypes (const char *line, const char *word, int pos, int state)
static char * complete_channeltypes_deprecated (const char *line, const char *word, int pos, int state)
static void free_cid (struct ast_callerid *cid)
static void free_translation (struct ast_channel *clone)
static int generator_force (const void *data)
static int attribute_const is_visible_indication (enum ast_control_frame_type condition)
static void queue_dtmf_readq (struct ast_channel *chan, struct ast_frame *f)
static int set_format (struct ast_channel *chan, int fmt, int *rawformat, int *format, struct ast_trans_pvt **trans, const int direction)
static int should_skip_dtmf (struct ast_channel *chan)
 Determine whether or not we should ignore DTMF in the readq.
static int show_channeltype (int fd, int argc, char *argv[])
static int show_channeltype_deprecated (int fd, int argc, char *argv[])
static int show_channeltypes (int fd, int argc, char *argv[])
static void * silence_generator_alloc (struct ast_channel *chan, void *data)
static int silence_generator_generate (struct ast_channel *chan, void *data, int len, int samples)
static void silence_generator_release (struct ast_channel *chan, void *data)
static void state2str_threadbuf_init (void)
static void * tonepair_alloc (struct ast_channel *chan, void *params)
static int tonepair_generator (struct ast_channel *chan, void *data, int len, int samples)
static void tonepair_release (struct ast_channel *chan, void *params)

Variables

static void(*) ast_moh_cleanup_ptr (struct ast_channel *) = NULL
static int(*) ast_moh_start_ptr (struct ast_channel *, const char *, const char *) = NULL
static void(*) ast_moh_stop_ptr (struct ast_channel *) = NULL
ast_cause causes []
static struct ast_cli_entry cli_channel []
static struct ast_cli_entry cli_show_channeltype_deprecated
static struct ast_cli_entry cli_show_channeltypes_deprecated
unsigned long global_fin
unsigned long global_fout
static struct ast_channel_tech null_tech
static char show_channeltype_usage []
static char show_channeltypes_usage []
static int shutting_down
static struct ast_generator silence_generator
static struct ast_threadstorage state2str_threadbuf = { .once = PTHREAD_ONCE_INIT, .key_init = state2str_threadbuf_init , }
static struct ast_generator tonepair
static int uniqueint


Detailed Description

Channel Management.

Author:
Mark Spencer <markster@digium.com>

Definition in file channel.c.


Define Documentation

#define AST_DEFAULT_EMULATE_DTMF_DURATION   100

Default amount of time to use when emulating a digit as a begin and end 100ms

Definition at line 89 of file channel.c.

Referenced by __ast_read(), and ast_senddigit().

#define AST_MIN_DTMF_DURATION   80

Minimum allowed digit length - 80ms

Definition at line 92 of file channel.c.

Referenced by __ast_read().

#define AST_MIN_DTMF_GAP   45

Minimum amount of time between the end of the last digit and the beginning of a new one - 45ms

Definition at line 96 of file channel.c.

Referenced by __ast_read(), and should_skip_dtmf().

#define FORMAT   "%-10.10s %-40.40s %-12.12s %-12.12s %-12.12s\n"

#define MONITOR_CONSTANT_DELAY

Definition at line 74 of file channel.c.

#define MONITOR_DELAY   150 * 8

Definition at line 75 of file channel.c.

Referenced by __ast_read(), and ast_write().

#define STATE2STR_BUFSIZE   32

Definition at line 85 of file channel.c.

Referenced by ast_state2str().


Function Documentation

static int __ast_queue_frame ( struct ast_channel chan,
struct ast_frame fin,
int  head 
) [static]

Queue an outgoing media frame.

Definition at line 897 of file channel.c.

References ast_channel::alertpipe, ast_assert, ast_channel_lock, ast_channel_unlock, AST_CONTROL_HANGUP, AST_FLAG_BLOCKING, AST_FRAME_CONTROL, AST_FRAME_VOICE, ast_frdup(), ast_frfree, AST_LIST_INSERT_HEAD, AST_LIST_INSERT_TAIL, AST_LIST_LAST, AST_LIST_TRAVERSE, ast_log(), ast_test_flag, ast_channel::blocker, errno, f, ast_frame::frame_list, ast_frame::frametype, LOG_DEBUG, ast_channel::name, option_debug, ast_channel::readq, ast_frame::subclass, and ast_channel::timingfd.

Referenced by ast_queue_frame(), and ast_queue_frame_head().

00898 {
00899    struct ast_frame *f;
00900    struct ast_frame *cur;
00901    int blah = 1;
00902    int qlen = 0;
00903 
00904    /* Build us a copy and free the original one */
00905    if (!(f = ast_frdup(fin))) {
00906       return -1;
00907    }
00908 
00909    ast_channel_lock(chan);
00910 
00911    /* See if the last frame on the queue is a hangup, if so don't queue anything */
00912    if ((cur = AST_LIST_LAST(&chan->readq)) && (cur->frametype == AST_FRAME_CONTROL) && (cur->subclass == AST_CONTROL_HANGUP)) {
00913       ast_frfree(f);
00914       ast_channel_unlock(chan);
00915       return 0;
00916    }
00917 
00918    /* Count how many frames exist on the queue */
00919    AST_LIST_TRAVERSE(&chan->readq, cur, frame_list) {
00920       qlen++;
00921    }
00922 
00923    /* Allow up to 96 voice frames outstanding, and up to 128 total frames */
00924    if (((fin->frametype == AST_FRAME_VOICE) && (qlen > 96)) || (qlen  > 128)) {
00925       if (fin->frametype != AST_FRAME_VOICE) {
00926          ast_log(LOG_WARNING, "Exceptionally long queue length queuing to %s\n", chan->name);
00927          ast_assert(fin->frametype == AST_FRAME_VOICE);
00928       } else {
00929          if (option_debug)
00930             ast_log(LOG_DEBUG, "Dropping voice to exceptionally long queue on %s\n", chan->name);
00931          ast_frfree(f);
00932          ast_channel_unlock(chan);
00933          return 0;
00934       }
00935    }
00936 
00937    if (head) {
00938       AST_LIST_INSERT_HEAD(&chan->readq, f, frame_list);
00939    } else {
00940       AST_LIST_INSERT_TAIL(&chan->readq, f, frame_list);
00941    }
00942 
00943    if (chan->alertpipe[1] > -1) {
00944       if (write(chan->alertpipe[1], &blah, sizeof(blah)) != sizeof(blah)) {
00945          ast_log(LOG_WARNING, "Unable to write to alert pipe on %s, frametype/subclass %d/%d (qlen = %d): %s!\n",
00946             chan->name, f->frametype, f->subclass, qlen, strerror(errno));
00947       }
00948 #ifdef HAVE_DAHDI
00949    } else if (chan->timingfd > -1) {
00950       ioctl(chan->timingfd, DAHDI_TIMERPING, &blah);
00951 #endif            
00952    } else if (ast_test_flag(chan, AST_FLAG_BLOCKING)) {
00953       pthread_kill(chan->blocker, SIGURG);
00954    }
00955 
00956    ast_channel_unlock(chan);
00957 
00958    return 0;
00959 }

static struct ast_frame* __ast_read ( struct ast_channel chan,
int  dropaudio 
) [static]

Definition at line 2024 of file channel.c.

References ast_channel::_softhangup, ast_channel::_state, ast_channel::alertpipe, AST_AUDIOHOOK_DIRECTION_READ, ast_audiohook_write_list(), ast_channel_trylock, ast_channel_unlock, ast_check_hangup(), ast_clear_flag, AST_CONTROL_ANSWER, AST_CONTROL_HANGUP, ast_deactivate_generator(), AST_DEFAULT_EMULATE_DTMF_DURATION, ast_do_masquerade(), AST_FLAG_DEFER_DTMF, AST_FLAG_EMULATE_DTMF, AST_FLAG_END_DTMF_ONLY, AST_FLAG_EXCEPTION, AST_FLAG_IN_DTMF, AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, ast_frame_dump(), AST_FRAME_NULL, AST_FRAME_VOICE, ast_frfree, AST_GENERATOR_FD, ast_getformatname(), ast_getformatname_multiple(), AST_LIST_EMPTY, AST_LIST_FIRST, AST_LIST_HEAD_SET_NOLOCK, AST_LIST_NEXT, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_log(), AST_MIN_DTMF_DURATION, AST_MIN_DTMF_GAP, AST_MONITOR_RUNNING, ast_null_frame, ast_read_generator_actions(), ast_seekstream(), ast_set_flag, ast_setstate(), AST_SOFTHANGUP_DEV, AST_STATE_UP, ast_test_flag, AST_TIMING_FD, ast_translate(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), ast_writestream(), ast_channel::audiohooks, ast_channel::blocker, ast_frame::data, DEBUGCHAN_FLAG, ast_channel::dtmf_tv, ast_channel::dtmff, ast_channel::emulate_dtmf_digit, ast_channel::emulate_dtmf_duration, errno, ast_channel_tech::exception, f, ast_channel::fdno, ast_channel::fds, ast_channel::fin, ast_frame::flags, ast_frame::frame_list, FRAMECOUNT_INC, ast_frame::frametype, ast_generator::generate, ast_channel::generator, ast_channel::generatordata, ast_channel::insmpl, LOG_DEBUG, LOG_DTMF, LOG_ERROR, LOG_NOTICE, ast_channel::masq, ast_channel::monitor, MONITOR_DELAY, ast_channel::name, ast_channel::nativeformats, option_debug, ast_channel::outsmpl, queue_dtmf_readq(), ast_channel_tech::read, ast_channel_monitor::read_stream, ast_channel::readq, ast_channel::readtrans, SEEK_FORCECUR, should_skip_dtmf(), ast_channel_monitor::state, ast_channel::tech, ast_channel::timingdata, ast_channel::timingfd, and ast_channel::timingfunc.

Referenced by ast_read(), and ast_read_noaudio().

02025 {
02026    struct ast_frame *f = NULL;   /* the return value */
02027    int blah;
02028    int prestate;
02029    int count = 0;
02030 
02031    /* this function is very long so make sure there is only one return
02032     * point at the end (there are only two exceptions to this).
02033     */
02034    while(ast_channel_trylock(chan)) {
02035       if(count++ > 10) 
02036          /*cannot goto done since the channel is not locked*/
02037          return &ast_null_frame;
02038       usleep(1);
02039    }
02040 
02041    if (chan->fdno == -1) {
02042       ast_log(LOG_ERROR, "ast_read() called with no recorded file descriptor.\n");
02043       f = &ast_null_frame;
02044       goto done;
02045    }
02046 
02047    if (chan->masq) {
02048       if (ast_do_masquerade(chan))
02049          ast_log(LOG_WARNING, "Failed to perform masquerade\n");
02050       else
02051          f =  &ast_null_frame;
02052       goto done;
02053    }
02054 
02055    /* Stop if we're a zombie or need a soft hangup */
02056    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) {
02057       if (chan->generator)
02058          ast_deactivate_generator(chan);
02059       goto done;
02060    }
02061    prestate = chan->_state;
02062 
02063    /* Read and ignore anything on the alertpipe, but read only
02064       one sizeof(blah) per frame that we send from it */
02065    if (chan->alertpipe[0] > -1) {
02066       int flags = fcntl(chan->alertpipe[0], F_GETFL);
02067       /* For some odd reason, the alertpipe occasionally loses nonblocking status,
02068        * which immediately causes a deadlock scenario.  Detect and prevent this. */
02069       if ((flags & O_NONBLOCK) == 0) {
02070          ast_log(LOG_ERROR, "Alertpipe on channel %s lost O_NONBLOCK?!!\n", chan->name);
02071          if (fcntl(chan->alertpipe[0], F_SETFL, flags | O_NONBLOCK) < 0) {
02072             ast_log(LOG_WARNING, "Unable to set alertpipe nonblocking! (%d: %s)\n", errno, strerror(errno));
02073             f = &ast_null_frame;
02074             goto done;
02075          }
02076       }
02077       if (read(chan->alertpipe[0], &blah, sizeof(blah)) < 0) {
02078          if (errno != EINTR && errno != EAGAIN)
02079             ast_log(LOG_WARNING, "read() failed: %s\n", strerror(errno));
02080       }
02081    }
02082 
02083 #ifdef HAVE_DAHDI
02084    if (chan->timingfd > -1 && chan->fdno == AST_TIMING_FD && ast_test_flag(chan, AST_FLAG_EXCEPTION)) {
02085       int res;
02086 
02087       ast_clear_flag(chan, AST_FLAG_EXCEPTION);
02088       blah = -1;
02089       /* IF we can't get event, assume it's an expired as-per the old interface */
02090       res = ioctl(chan->timingfd, DAHDI_GETEVENT, &blah);
02091       if (res)
02092          blah = DAHDI_EVENT_TIMER_EXPIRED;
02093 
02094       if (blah == DAHDI_EVENT_TIMER_PING) {
02095          if (AST_LIST_EMPTY(&chan->readq) || !AST_LIST_NEXT(AST_LIST_FIRST(&chan->readq), frame_list)) {
02096             /* Acknowledge PONG unless we need it again */
02097             if (ioctl(chan->timingfd, DAHDI_TIMERPONG, &blah)) {
02098                ast_log(LOG_WARNING, "Failed to pong timer on '%s': %s\n", chan->name, strerror(errno));
02099             }
02100          }
02101       } else if (blah == DAHDI_EVENT_TIMER_EXPIRED) {
02102          ioctl(chan->timingfd, DAHDI_TIMERACK, &blah);
02103          if (chan->timingfunc) {
02104             /* save a copy of func/data before unlocking the channel */
02105             int (*func)(const void *) = chan->timingfunc;
02106             void *data = chan->timingdata;
02107             chan->fdno = -1;
02108             ast_channel_unlock(chan);
02109             func(data);
02110          } else {
02111             blah = 0;
02112             ioctl(chan->timingfd, DAHDI_TIMERCONFIG, &blah);
02113             chan->timingdata = NULL;
02114             chan->fdno = -1;
02115             ast_channel_unlock(chan);
02116          }
02117          /* cannot 'goto done' because the channel is already unlocked */
02118          return &ast_null_frame;
02119       } else
02120          ast_log(LOG_NOTICE, "No/unknown event '%d' on timer for '%s'?\n", blah, chan->name);
02121    } else
02122 #endif
02123    if (chan->fds[AST_GENERATOR_FD] > -1 && chan->fdno == AST_GENERATOR_FD) {
02124       /* if the AST_GENERATOR_FD is set, call the generator with args
02125        * set to -1 so it can do whatever it needs to.
02126        */
02127       void *tmp = chan->generatordata;
02128       chan->generatordata = NULL;     /* reset to let ast_write get through */
02129       chan->generator->generate(chan, tmp, -1, -1);
02130       chan->generatordata = tmp;
02131       f = &ast_null_frame;
02132       chan->fdno = -1;
02133       goto done;
02134    }
02135 
02136    /* Check for pending read queue */
02137    if (!AST_LIST_EMPTY(&chan->readq)) {
02138       int skip_dtmf = should_skip_dtmf(chan);
02139 
02140       AST_LIST_TRAVERSE_SAFE_BEGIN(&chan->readq, f, frame_list) {
02141          /* We have to be picky about which frame we pull off of the readq because
02142           * there are cases where we want to leave DTMF frames on the queue until
02143           * some later time. */
02144 
02145          if ( (f->frametype == AST_FRAME_DTMF_BEGIN || f->frametype == AST_FRAME_DTMF_END) && skip_dtmf) {
02146             continue;
02147          }
02148 
02149          AST_LIST_REMOVE_CURRENT(&chan->readq, frame_list);
02150          break;
02151       }
02152       AST_LIST_TRAVERSE_SAFE_END
02153       
02154       if (!f) {
02155          /* There were no acceptable frames on the readq. */
02156          f = &ast_null_frame;
02157          if (chan->alertpipe[0] > -1) {
02158             int poke = 0;
02159             /* Restore the state of the alertpipe since we aren't ready for any
02160              * of the frames in the readq. */
02161             if (write(chan->alertpipe[1], &poke, sizeof(poke)) != sizeof(poke)) {
02162                ast_log(LOG_ERROR, "Failed to write to alertpipe: %s\n", strerror(errno));
02163             }
02164          }
02165       }
02166 
02167       /* Interpret hangup and return NULL */
02168       /* XXX why not the same for frames from the channel ? */
02169       if (f->frametype == AST_FRAME_CONTROL && f->subclass == AST_CONTROL_HANGUP) {
02170          ast_frfree(f);
02171          f = NULL;
02172       }
02173    } else {
02174       chan->blocker = pthread_self();
02175       if (ast_test_flag(chan, AST_FLAG_EXCEPTION)) {
02176          if (chan->tech->exception)
02177             f = chan->tech->exception(chan);
02178          else {
02179             ast_log(LOG_WARNING, "Exception flag set on '%s', but no exception handler\n", chan->name);
02180             f = &ast_null_frame;
02181          }
02182          /* Clear the exception flag */
02183          ast_clear_flag(chan, AST_FLAG_EXCEPTION);
02184       } else if (chan->tech->read)
02185          f = chan->tech->read(chan);
02186       else
02187          ast_log(LOG_WARNING, "No read routine on channel %s\n", chan->name);
02188    }
02189 
02190    /*
02191     * Reset the recorded file descriptor that triggered this read so that we can
02192     * easily detect when ast_read() is called without properly using ast_waitfor().
02193     */
02194    chan->fdno = -1;
02195 
02196    if (f) {
02197       /* if the channel driver returned more than one frame, stuff the excess
02198          into the readq for the next ast_read call (note that we can safely assume
02199          that the readq is empty, because otherwise we would not have called into
02200          the channel driver and f would be only a single frame)
02201       */
02202       if (AST_LIST_NEXT(f, frame_list)) {
02203          AST_LIST_HEAD_SET_NOLOCK(&chan->readq, AST_LIST_NEXT(f, frame_list));
02204          AST_LIST_NEXT(f, frame_list) = NULL;
02205       }
02206 
02207       switch (f->frametype) {
02208       case AST_FRAME_CONTROL:
02209          if (f->subclass == AST_CONTROL_ANSWER) {
02210             if (!ast_test_flag(chan, AST_FLAG_OUTGOING)) {
02211                if (option_debug)
02212                   ast_log(LOG_DEBUG, "Ignoring answer on an inbound call!\n");
02213                ast_frfree(f);
02214                f = &ast_null_frame;
02215             } else if (prestate == AST_STATE_UP) {
02216                if (option_debug)
02217                   ast_log(LOG_DEBUG, "Dropping duplicate answer!\n");
02218                ast_frfree(f);
02219                f = &ast_null_frame;
02220             } else {
02221                /* Answer the CDR */
02222                ast_setstate(chan, AST_STATE_UP);
02223                /* removed a call to ast_cdr_answer(chan->cdr) from here. */
02224             }
02225          }
02226          break;
02227       case AST_FRAME_DTMF_END:
02228          ast_log(LOG_DTMF, "DTMF end '%c' received on %s, duration %ld ms\n", f->subclass, chan->name, f->len);
02229          /* Queue it up if DTMF is deferred, or if DTMF emulation is forced. */
02230          if (ast_test_flag(chan, AST_FLAG_DEFER_DTMF) || ast_test_flag(chan, AST_FLAG_EMULATE_DTMF)) {
02231             queue_dtmf_readq(chan, f);
02232             ast_frfree(f);
02233             f = &ast_null_frame;
02234          } else if (!ast_test_flag(chan, AST_FLAG_IN_DTMF | AST_FLAG_END_DTMF_ONLY)) {
02235             if (!ast_tvzero(chan->dtmf_tv) && 
02236                 ast_tvdiff_ms(ast_tvnow(), chan->dtmf_tv) < AST_MIN_DTMF_GAP) {
02237                /* If it hasn't been long enough, defer this digit */
02238                queue_dtmf_readq(chan, f);
02239                ast_frfree(f);
02240                f = &ast_null_frame;
02241             } else {
02242                /* There was no begin, turn this into a begin and send the end later */
02243                f->frametype = AST_FRAME_DTMF_BEGIN;
02244                ast_set_flag(chan, AST_FLAG_EMULATE_DTMF);
02245                chan->emulate_dtmf_digit = f->subclass;
02246                chan->dtmf_tv = ast_tvnow();
02247                if (f->len) {
02248                   if (f->len > AST_MIN_DTMF_DURATION)
02249                      chan->emulate_dtmf_duration = f->len;
02250                   else 
02251                      chan->emulate_dtmf_duration = AST_MIN_DTMF_DURATION;
02252                } else
02253                   chan->emulate_dtmf_duration = AST_DEFAULT_EMULATE_DTMF_DURATION;
02254                ast_log(LOG_DTMF, "DTMF begin emulation of '%c' with duration %u queued on %s\n", f->subclass, chan->emulate_dtmf_duration, chan->name);
02255             }
02256             if (chan->audiohooks) {
02257                struct ast_frame *old_frame = f;
02258                f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f);
02259                if (old_frame != f)
02260                   ast_frfree(old_frame);
02261                                 }
02262          } else {
02263             struct timeval now = ast_tvnow();
02264             if (ast_test_flag(chan, AST_FLAG_IN_DTMF)) {
02265                ast_log(LOG_DTMF, "DTMF end accepted with begin '%c' on %s\n", f->subclass, chan->name);
02266                ast_clear_flag(chan, AST_FLAG_IN_DTMF);
02267                if (!f->len)
02268                   f->len = ast_tvdiff_ms(now, chan->dtmf_tv);
02269             } else if (!f->len) {
02270                ast_log(LOG_DTMF, "DTMF end accepted without begin '%c' on %s\n", f->subclass, chan->name);
02271                f->len = AST_MIN_DTMF_DURATION;
02272             }
02273             if (f->len < AST_MIN_DTMF_DURATION && !ast_test_flag(chan, AST_FLAG_END_DTMF_ONLY)) {
02274                ast_log(LOG_DTMF, "DTMF end '%c' has duration %ld but want minimum %d, emulating on %s\n", f->subclass, f->len, AST_MIN_DTMF_DURATION, chan->name);
02275                ast_set_flag(chan, AST_FLAG_EMULATE_DTMF);
02276                chan->emulate_dtmf_digit = f->subclass;
02277                chan->emulate_dtmf_duration = AST_MIN_DTMF_DURATION - f->len;
02278                ast_frfree(f);
02279                f = &ast_null_frame;
02280             } else {
02281                ast_log(LOG_DTMF, "DTMF end passthrough '%c' on %s\n", f->subclass, chan->name);
02282                if (f->len < AST_MIN_DTMF_DURATION) {
02283                   f->len = AST_MIN_DTMF_DURATION;
02284                }
02285                chan->dtmf_tv = now;
02286             }
02287             if (chan->audiohooks) {
02288                struct ast_frame *old_frame = f;
02289                f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f);
02290                if (old_frame != f)
02291                   ast_frfree(old_frame);
02292             }
02293          }
02294          break;
02295       case AST_FRAME_DTMF_BEGIN:
02296          ast_log(LOG_DTMF, "DTMF begin '%c' received on %s\n", f->subclass, chan->name);
02297          if ( ast_test_flag(chan, AST_FLAG_DEFER_DTMF | AST_FLAG_END_DTMF_ONLY | AST_FLAG_EMULATE_DTMF) || 
02298              (!ast_tvzero(chan->dtmf_tv) && 
02299                ast_tvdiff_ms(ast_tvnow(), chan->dtmf_tv) < AST_MIN_DTMF_GAP) ) {
02300             ast_log(LOG_DTMF, "DTMF begin ignored '%c' on %s\n", f->subclass, chan->name);
02301             ast_frfree(f);
02302             f = &ast_null_frame;
02303          } else {
02304             ast_set_flag(chan, AST_FLAG_IN_DTMF);
02305             chan->dtmf_tv = ast_tvnow();
02306             ast_log(LOG_DTMF, "DTMF begin passthrough '%c' on %s\n", f->subclass, chan->name);
02307          }
02308          break;
02309       case AST_FRAME_NULL:
02310          /* The EMULATE_DTMF flag must be cleared here as opposed to when the duration
02311           * is reached , because we want to make sure we pass at least one
02312           * voice frame through before starting the next digit, to ensure a gap
02313           * between DTMF digits. */
02314          if (ast_test_flag(chan, AST_FLAG_EMULATE_DTMF)) {
02315             struct timeval now = ast_tvnow();
02316             if (!chan->emulate_dtmf_duration) {
02317                ast_clear_flag(chan, AST_FLAG_EMULATE_DTMF);
02318                chan->emulate_dtmf_digit = 0;
02319             } else if (ast_tvdiff_ms(now, chan->dtmf_tv) >= chan->emulate_dtmf_duration) {
02320                chan->emulate_dtmf_duration = 0;
02321                ast_frfree(f);
02322                f = &chan->dtmff;
02323                f->frametype = AST_FRAME_DTMF_END;
02324                f->subclass = chan->emulate_dtmf_digit;
02325                f->len = ast_tvdiff_ms(now, chan->dtmf_tv);
02326                chan->dtmf_tv = now;
02327                ast_clear_flag(chan, AST_FLAG_EMULATE_DTMF);
02328                chan->emulate_dtmf_digit = 0;
02329                ast_log(LOG_DTMF, "DTMF end emulation of '%c' queued on %s\n", f->subclass, chan->name);
02330             }
02331          }
02332          break;
02333       case AST_FRAME_VOICE:
02334          /* The EMULATE_DTMF flag must be cleared here as opposed to when the duration
02335           * is reached , because we want to make sure we pass at least one
02336           * voice frame through before starting the next digit, to ensure a gap
02337           * between DTMF digits. */
02338          if (ast_test_flag(chan, AST_FLAG_EMULATE_DTMF) && !chan->emulate_dtmf_duration) {
02339             ast_clear_flag(chan, AST_FLAG_EMULATE_DTMF);
02340             chan->emulate_dtmf_digit = 0;
02341          }
02342 
02343          if (dropaudio || ast_test_flag(chan, AST_FLAG_IN_DTMF)) {
02344             if (dropaudio)
02345                ast_read_generator_actions(chan, f);
02346             ast_frfree(f);
02347             f = &ast_null_frame;
02348          }
02349 
02350          if (ast_test_flag(chan, AST_FLAG_EMULATE_DTMF) && !ast_test_flag(chan, AST_FLAG_IN_DTMF)) {
02351             struct timeval now = ast_tvnow();
02352             if (ast_tvdiff_ms(now, chan->dtmf_tv) >= chan->emulate_dtmf_duration) {
02353                chan->emulate_dtmf_duration = 0;
02354                ast_frfree(f);
02355                f = &chan->dtmff;
02356                f->frametype = AST_FRAME_DTMF_END;
02357                f->subclass = chan->emulate_dtmf_digit;
02358                f->len = ast_tvdiff_ms(now, chan->dtmf_tv);
02359                chan->dtmf_tv = now;
02360                if (chan->audiohooks) {
02361                   struct ast_frame *old_frame = f;
02362                   f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f);
02363                   if (old_frame != f)
02364                      ast_frfree(old_frame);
02365                }
02366                ast_log(LOG_DTMF, "DTMF end emulation of '%c' queued on %s\n", f->subclass, chan->name);
02367             } else {
02368                /* Drop voice frames while we're still in the middle of the digit */
02369                ast_frfree(f);
02370                f = &ast_null_frame;
02371             }
02372          } else if ((f->frametype == AST_FRAME_VOICE) && !(f->subclass & chan->nativeformats)) {
02373             /* This frame is not one of the current native formats -- drop it on the floor */
02374             char to[200];
02375             ast_log(LOG_NOTICE, "Dropping incompatible voice frame on %s of format %s since our native format has changed to %s\n",
02376                chan->name, ast_getformatname(f->subclass), ast_getformatname_multiple(to, sizeof(to), chan->nativeformats));
02377             ast_frfree(f);
02378             f = &ast_null_frame;
02379          } else if ((f->frametype == AST_FRAME_VOICE)) {
02380             if (chan->audiohooks) {
02381                struct ast_frame *old_frame = f;
02382                f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f);
02383                if (old_frame != f)
02384                   ast_frfree(old_frame);
02385             }
02386             if (chan->monitor && chan->monitor->read_stream ) {
02387                /* XXX what does this do ? */
02388 #ifndef MONITOR_CONSTANT_DELAY
02389                int jump = chan->outsmpl - chan->insmpl - 4 * f->samples;
02390                if (jump >= 0) {
02391                   jump = chan->outsmpl - chan->insmpl;
02392                   if (ast_seekstream(chan->monitor->read_stream, jump, SEEK_FORCECUR) == -1)
02393                      ast_log(LOG_WARNING, "Failed to perform seek in monitoring read stream, synchronization between the files may be broken\n");
02394                   chan->insmpl += jump + f->samples;
02395                } else
02396                   chan->insmpl+= f->samples;
02397 #else
02398                int jump = chan->outsmpl - chan->insmpl;
02399                if (jump - MONITOR_DELAY >= 0) {
02400                   if (ast_seekstream(chan->monitor->read_stream, jump - f->samples, SEEK_FORCECUR) == -1)
02401                      ast_log(LOG_WARNING, "Failed to perform seek in monitoring read stream, synchronization between the files may be broken\n");
02402                   chan->insmpl += jump;
02403                } else
02404                   chan->insmpl += f->samples;
02405 #endif
02406                if (chan->monitor->state == AST_MONITOR_RUNNING) {
02407                   if (ast_writestream(chan->monitor->read_stream, f) < 0)
02408                      ast_log(LOG_WARNING, "Failed to write data to channel monitor read stream\n");
02409                }
02410             }
02411 
02412             if (chan->readtrans && (f = ast_translate(chan->readtrans, f, 1)) == NULL)
02413                f = &ast_null_frame;
02414 
02415             /* Run generator sitting on the line if timing device not available
02416             * and synchronous generation of outgoing frames is necessary       */
02417             ast_read_generator_actions(chan, f);
02418          }
02419       default:
02420          /* Just pass it on! */
02421          break;
02422       }
02423    } else {
02424       /* Make sure we always return NULL in the future */
02425       chan->_softhangup |= AST_SOFTHANGUP_DEV;
02426       if (chan->generator)
02427          ast_deactivate_generator(chan);
02428       /* We no longer End the CDR here */
02429    }
02430 
02431    /* High bit prints debugging */
02432    if (chan->fin & DEBUGCHAN_FLAG)
02433       ast_frame_dump(chan->name, f, "<<");
02434    chan->fin = FRAMECOUNT_INC(chan->fin);
02435 
02436 done:
02437    ast_channel_unlock(chan);
02438    return f;
02439 }

struct ast_channel* __ast_request_and_dial ( const char *  type,
int  format,
void *  data,
int  timeout,
int *  outstate,
const char *  cid_num,
const char *  cid_name,
struct outgoing_helper oh 
)

Definition at line 3017 of file channel.c.

References ast_channel::_state, outgoing_helper::account, ast_call(), AST_CAUSE_BUSY, AST_CAUSE_CONGESTION, AST_CAUSE_NO_ANSWER, ast_cdr_alloc(), ast_cdr_disposition(), ast_cdr_end(), ast_cdr_failed(), ast_cdr_init(), ast_cdr_setaccount(), ast_cdr_setapp(), ast_cdr_start(), ast_cdr_update(), ast_channel_inherit_variables(), AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_PROCEEDING, AST_CONTROL_PROGRESS, AST_CONTROL_RINGING, AST_CONTROL_SRCUPDATE, AST_CONTROL_UNHOLD, AST_CONTROL_VIDUPDATE, ast_copy_string(), AST_FRAME_CONTROL, ast_frfree, ast_hangup(), ast_log(), ast_read(), ast_request(), ast_set_callerid(), ast_set_variables(), AST_STATE_UP, ast_strlen_zero(), ast_waitfor(), ast_channel::cdr, outgoing_helper::cid_name, outgoing_helper::cid_num, outgoing_helper::context, ast_channel::context, outgoing_helper::exten, ast_channel::exten, f, ast_channel::hangupcause, LOG_NOTICE, outgoing_helper::parent_channel, outgoing_helper::priority, ast_channel::priority, and outgoing_helper::vars.

Referenced by ast_pbx_outgoing_app(), ast_pbx_outgoing_exten(), ast_request_and_dial(), and parkandannounce_exec().

03018 {
03019    int dummy_outstate;
03020    int cause = 0;
03021    struct ast_channel *chan;
03022    int res = 0;
03023    int last_subclass = 0;
03024    
03025    if (outstate)
03026       *outstate = 0;
03027    else
03028       outstate = &dummy_outstate;   /* make outstate always a valid pointer */
03029 
03030    chan = ast_request(type, format, data, &cause);
03031    if (!chan) {
03032       ast_log(LOG_NOTICE, "Unable to request channel %s/%s\n", type, (char *)data);
03033       /* compute error and return */
03034       if (cause == AST_CAUSE_BUSY)
03035          *outstate = AST_CONTROL_BUSY;
03036       else if (cause == AST_CAUSE_CONGESTION)
03037          *outstate = AST_CONTROL_CONGESTION;
03038       return NULL;
03039    }
03040 
03041    if (oh) {
03042       if (oh->vars)  
03043          ast_set_variables(chan, oh->vars);
03044       /* XXX why is this necessary, for the parent_channel perhaps ? */
03045       if (!ast_strlen_zero(oh->cid_num) && !ast_strlen_zero(oh->cid_name))
03046          ast_set_callerid(chan, oh->cid_num, oh->cid_name, oh->cid_num);
03047       if (oh->parent_channel)
03048          ast_channel_inherit_variables(oh->parent_channel, chan);
03049       if (oh->account)
03050          ast_cdr_setaccount(chan, oh->account); 
03051    }
03052    ast_set_callerid(chan, cid_num, cid_name, cid_num);
03053 
03054    if (ast_call(chan, data, 0)) {   /* ast_call failed... */
03055       ast_log(LOG_NOTICE, "Unable to call channel %s/%s\n", type, (char *)data);
03056    } else {
03057       res = 1; /* mark success in case chan->_state is already AST_STATE_UP */
03058       while (timeout && chan->_state != AST_STATE_UP) {
03059          struct ast_frame *f;
03060          res = ast_waitfor(chan, timeout);
03061          if (res <= 0) /* error, timeout, or done */
03062             break;
03063          if (timeout > -1)
03064             timeout = res;
03065          f = ast_read(chan);
03066          if (!f) {
03067             *outstate = AST_CONTROL_HANGUP;
03068             res = 0;
03069             break;
03070          }
03071          if (f->frametype == AST_FRAME_CONTROL) {
03072             switch (f->subclass) {
03073             case AST_CONTROL_RINGING:  /* record but keep going */
03074                *outstate = f->subclass;
03075                break;
03076 
03077             case AST_CONTROL_BUSY:
03078             case AST_CONTROL_CONGESTION:
03079             case AST_CONTROL_ANSWER:
03080                *outstate = f->subclass;
03081                timeout = 0;      /* trick to force exit from the while() */
03082                break;
03083 
03084             /* Ignore these */
03085             case AST_CONTROL_PROGRESS:
03086             case AST_CONTROL_PROCEEDING:
03087             case AST_CONTROL_HOLD:
03088             case AST_CONTROL_UNHOLD:
03089             case AST_CONTROL_VIDUPDATE:
03090             case AST_CONTROL_SRCUPDATE:
03091             case -1:       /* Ignore -- just stopping indications */
03092                break;
03093 
03094             default:
03095                ast_log(LOG_NOTICE, "Don't know what to do with control frame %d\n", f->subclass);
03096             }
03097             last_subclass = f->subclass;
03098          }
03099          ast_frfree(f);
03100       }
03101    }
03102 
03103    /* Final fixups */
03104    if (oh) {
03105       if (!ast_strlen_zero(oh->context))
03106          ast_copy_string(chan->context, oh->context, sizeof(chan->context));
03107       if (!ast_strlen_zero(oh->exten))
03108          ast_copy_string(chan->exten, oh->exten, sizeof(chan->exten));
03109       if (oh->priority) 
03110          chan->priority = oh->priority;
03111    }
03112    if (chan->_state == AST_STATE_UP)
03113       *outstate = AST_CONTROL_ANSWER;
03114 
03115    if (res <= 0) {
03116       if ( AST_CONTROL_RINGING == last_subclass ) 
03117          chan->hangupcause = AST_CAUSE_NO_ANSWER;
03118       if (!chan->cdr && (chan->cdr = ast_cdr_alloc()))
03119          ast_cdr_init(chan->cdr, chan);
03120       if (chan->cdr) {
03121          char tmp[256];
03122          snprintf(tmp, sizeof(tmp), "%s/%s", type, (char *)data);
03123          ast_cdr_setapp(chan->cdr,"Dial",tmp);
03124          ast_cdr_update(chan);
03125          ast_cdr_start(chan->cdr);
03126          ast_cdr_end(chan->cdr);
03127          /* If the cause wasn't handled properly */
03128          if (ast_cdr_disposition(chan->cdr,chan->hangupcause))
03129             ast_cdr_failed(chan->cdr);
03130       }
03131       ast_hangup(chan);
03132       chan = NULL;
03133    }
03134    return chan;
03135 }

int ast_activate_generator ( struct ast_channel chan,
struct ast_generator gen,
void *  params 
)

Activate a given generator

Definition at line 1632 of file channel.c.

References ast_generator::alloc, ast_channel_lock, ast_channel_unlock, ast_prod(), ast_settimeout(), gen, ast_channel::generator, generator_force(), ast_channel::generatordata, and ast_generator::release.

Referenced by app_exec(), ast_channel_start_silence_generator(), ast_linear_stream(), ast_playtones_start(), ast_tonepair_start(), channel_spy(), local_ast_moh_start(), and old_milliwatt_exec().

01633 {
01634    int res = 0;
01635 
01636    ast_channel_lock(chan);
01637 
01638    if (chan->generatordata) {
01639       if (chan->generator && chan->generator->release)
01640          chan->generator->release(chan, chan->generatordata);
01641       chan->generatordata = NULL;
01642    }
01643 
01644    ast_prod(chan);
01645    if (gen->alloc && !(chan->generatordata = gen->alloc(chan, params))) {
01646       res = -1;
01647    }
01648    
01649    if (!res) {
01650       ast_settimeout(chan, 160, generator_force, chan);
01651       chan->generator = gen;
01652    }
01653 
01654    ast_channel_unlock(chan);
01655 
01656    return res;
01657 }

int ast_active_channels ( void   ) 

returns number of active/allocated channels

Returns number of active/allocated channels

Definition at line 443 of file channel.c.

References AST_LIST_LOCK, AST_LIST_TRAVERSE, and AST_LIST_UNLOCK.

Referenced by action_corestatus(), dahdi_restart(), handle_show_settings(), and quit_handler().

00444 {
00445    struct ast_channel *c;
00446    int cnt = 0;
00447    AST_LIST_LOCK(&channels);
00448    AST_LIST_TRAVERSE(&channels, c, chan_list)
00449       cnt++;
00450    AST_LIST_UNLOCK(&channels);
00451    return cnt;
00452 }

int ast_answer ( struct ast_channel chan  ) 

Answer a ringing call.

Parameters:
chan channel to answer This function answers a channel and handles all necessary call setup functions.
Returns:
Returns 0 on success, -1 on failure

Definition at line 1553 of file channel.c.

References ast_channel::_state, ast_channel_tech::answer, ast_cdr_answer(), ast_channel_lock, ast_channel_unlock, ast_check_hangup(), AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, ast_indicate(), ast_setstate(), AST_STATE_RING, AST_STATE_RINGING, AST_STATE_UP, ast_test_flag, ast_channel::cdr, ast_channel::tech, and ast_channel::visible_indication.

Referenced by __login_exec(), agi_exec_full(), alarmreceiver_exec(), answer_trunk_chan(), app_exec(), ast_bridge_call(), ast_control_streamfile(), ast_pickup_call(), auth_exec(), background_detect_exec(), builtin_parkcall(), common_exec(), conf_exec(), count_exec(), dictate_exec(), directory_exec(), disa_exec(), exec(), features_answer(), handle_answer(), ices_exec(), old_milliwatt_exec(), park_call_exec(), park_exec(), pbx_builtin_answer(), pbx_builtin_background(), pickup_do(), playback_exec(), privacy_exec(), read_exec(), sayunixtime_exec(), send_waveform_to_channel(), skel_exec(), sla_station_exec(), speech_background(), testclient_exec(), testserver_exec(), vm_exec(), vm_execmain(), waitforsilence_exec(), and zapateller_exec().

01554 {
01555    int res = 0;
01556    ast_channel_lock(chan);
01557    /* You can't answer an outbound call */
01558    if (ast_test_flag(chan, AST_FLAG_OUTGOING)) {
01559       ast_channel_unlock(chan);
01560       return 0;
01561    }
01562    /* Stop if we're a zombie or need a soft hangup */
01563    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) {
01564       ast_channel_unlock(chan);
01565       return -1;
01566    }
01567    switch(chan->_state) {
01568    case AST_STATE_RINGING:
01569    case AST_STATE_RING:
01570       if (chan->tech->answer)
01571          res = chan->tech->answer(chan);
01572       ast_setstate(chan, AST_STATE_UP);
01573       ast_cdr_answer(chan->cdr);
01574       break;
01575    case AST_STATE_UP:
01576       break;
01577    default:
01578       break;
01579    }
01580    ast_indicate(chan, -1);
01581    chan->visible_indication = 0;
01582    ast_channel_unlock(chan);
01583    return res;
01584 }

void ast_begin_shutdown ( int  hangup  ) 

Initiate system shutdown.

Initiate system shutdown -- prevents new channels from being allocated. If "hangup" is non-zero, all existing channels will receive soft hangups

Definition at line 430 of file channel.c.

References AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_softhangup(), and AST_SOFTHANGUP_SHUTDOWN.

Referenced by quit_handler().

00431 {
00432    struct ast_channel *c;
00433    shutting_down = 1;
00434    if (hangup) {
00435       AST_LIST_LOCK(&channels);
00436       AST_LIST_TRAVERSE(&channels, c, chan_list)
00437          ast_softhangup(c, AST_SOFTHANGUP_SHUTDOWN);
00438       AST_LIST_UNLOCK(&channels);
00439    }
00440 }

int ast_best_codec ( int  fmts  ) 

Pick the best audio codec.

Pick the best codec

Okay, ulaw is used by all telephony equipment, so start with it

Unless of course, you're a silly European, so then prefer ALAW

G.722 is better then all below, but not as common as the above... so give ulaw and alaw priority

Okay, well, signed linear is easy to translate into other stuff

G.726 is standard ADPCM, in RFC3551 packing order

G.726 is standard ADPCM, in AAL2 packing order

ADPCM has great sound quality and is still pretty easy to translate

Okay, we're down to vocoders now, so pick GSM because it's small and easier to translate and sounds pretty good

iLBC is not too bad

Speex is free, but computationally more expensive than GSM

Ick, LPC10 sounds terrible, but at least we have code for it, if you're tacky enough to use it

G.729a is faster than 723 and slightly less expensive

Down to G.723.1 which is proprietary but at least designed for voice

Definition at line 655 of file channel.c.

References AST_FORMAT_ADPCM, AST_FORMAT_ALAW, AST_FORMAT_AUDIO_MASK, AST_FORMAT_G722, AST_FORMAT_G723_1, AST_FORMAT_G726, AST_FORMAT_G726_AAL2, AST_FORMAT_G729A, AST_FORMAT_GSM, AST_FORMAT_ILBC, AST_FORMAT_LPC10, AST_FORMAT_SLINEAR, AST_FORMAT_SPEEX, AST_FORMAT_ULAW, ast_log(), LOG_WARNING, and prefs.

Referenced by __login_exec(), __oh323_new(), agent_call(), ast_codec_choose(), ast_iax2_new(), do_atxfer(), echo_exec(), findmeexec(), gtalk_new(), handle_open_receive_channel_ack_message(), iax2_request(), local_new(), mgcp_new(), sip_new(), skinny_new(), socket_process(), and transmit_connect().

00656 {
00657    /* This just our opinion, expressed in code.  We are asked to choose
00658       the best codec to use, given no information */
00659    int x;
00660    static int prefs[] =
00661    {
00662       /*! Okay, ulaw is used by all telephony equipment, so start with it */
00663       AST_FORMAT_ULAW,
00664       /*! Unless of course, you're a silly European, so then prefer ALAW */
00665       AST_FORMAT_ALAW,
00666       /*! G.722 is better then all below, but not as common as the above... so give ulaw and alaw priority */
00667       AST_FORMAT_G722,
00668       /*! Okay, well, signed linear is easy to translate into other stuff */
00669       AST_FORMAT_SLINEAR,
00670       /*! G.726 is standard ADPCM, in RFC3551 packing order */
00671       AST_FORMAT_G726,
00672       /*! G.726 is standard ADPCM, in AAL2 packing order */
00673       AST_FORMAT_G726_AAL2,
00674       /*! ADPCM has great sound quality and is still pretty easy to translate */
00675       AST_FORMAT_ADPCM,
00676       /*! Okay, we're down to vocoders now, so pick GSM because it's small and easier to
00677           translate and sounds pretty good */
00678       AST_FORMAT_GSM,
00679       /*! iLBC is not too bad */
00680       AST_FORMAT_ILBC,
00681       /*! Speex is free, but computationally more expensive than GSM */
00682       AST_FORMAT_SPEEX,
00683       /*! Ick, LPC10 sounds terrible, but at least we have code for it, if you're tacky enough
00684           to use it */
00685       AST_FORMAT_LPC10,
00686       /*! G.729a is faster than 723 and slightly less expensive */
00687       AST_FORMAT_G729A,
00688       /*! Down to G.723.1 which is proprietary but at least designed for voice */
00689       AST_FORMAT_G723_1,
00690    };
00691 
00692    /* Strip out video */
00693    fmts &= AST_FORMAT_AUDIO_MASK;
00694    
00695    /* Find the first preferred codec in the format given */
00696    for (x=0; x < (sizeof(prefs) / sizeof(prefs[0]) ); x++)
00697       if (fmts & prefs[x])
00698          return prefs[x];
00699    ast_log(LOG_WARNING, "Don't know any of 0x%x formats\n", fmts);
00700    return 0;
00701 }

struct ast_channel* ast_bridged_channel ( struct ast_channel chan  ) 

Find bridged channel.

Parameters:
chan Current channel

Definition at line 3864 of file channel.c.

References ast_channel::_bridge, ast_channel_tech::bridged_channel, and ast_channel::tech.

Referenced by __dahdi_exception(), action_agents(), agents_show(), agents_show_online(), ast_bridge_call(), ast_channel_masquerade(), attempt_transfer(), cb_events(), check_bridge(), common_exec(), console_transfer(), console_transfer_deprecated(), create_jb(), dahdi_handle_event(), dahdi_hangup(), export_aoc_vars(), handle_chanlist(), handle_chanlist_deprecated(), handle_hd_hf(), handle_invite_replaces(), handle_request(), handle_request_bye(), handle_request_info(), handle_request_invite(), handle_request_refer(), handle_response_invite(), handle_showchan(), handle_showchan_deprecated(), local_attended_transfer(), mgcp_hangup(), mgcp_ss(), misdn_transfer_bc(), mixmonitor_thread(), park_call_full(), schedule_delivery(), sip_read(), socket_process(), ss_thread(), start_spying(), and startmon().

03865 {
03866    struct ast_channel *bridged;
03867    bridged = chan->_bridge;
03868    if (bridged && bridged->tech->bridged_channel)
03869       bridged = bridged->tech->bridged_channel(chan, bridged);
03870    return bridged;
03871 }

int ast_call ( struct ast_channel chan,
char *  addr,
int  timeout 
)

Make a call.

Parameters:
chan which channel to make the call on
addr destination of the call
timeout time to wait on for connect Place a call, take no longer than timeout ms.
Returns:
Returns -1 on failure, 0 on not enough time (does not automatically stop ringing), and the number of seconds the connect took otherwise.

Definition at line 3192 of file channel.c.

References AST_CDR_FLAG_DIALED, ast_channel_lock, ast_channel_unlock, ast_check_hangup(), AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, ast_set_flag, ast_test_flag, ast_channel_tech::call, ast_channel::cdr, and ast_channel::tech.

Referenced by __ast_request_and_dial(), agent_call(), ast_feature_request_and_dial(), attempt_reconnect(), begin_dial(), connect_link(), do_idle_thread(), features_call(), findmeexec(), ring_entry(), rpt(), and wait_for_answer().

03193 {
03194    /* Place an outgoing call, but don't wait any longer than timeout ms before returning.
03195       If the remote end does not answer within the timeout, then do NOT hang up, but
03196       return anyway.  */
03197    int res = -1;
03198    /* Stop if we're a zombie or need a soft hangup */
03199    ast_channel_lock(chan);
03200    if (!ast_test_flag(chan, AST_FLAG_ZOMBIE) && !ast_check_hangup(chan)) {
03201       if (chan->cdr)
03202          ast_set_flag(chan->cdr, AST_CDR_FLAG_DIALED);
03203       if (chan->tech->call)
03204          res = chan->tech->call(chan, addr, timeout);
03205       ast_set_flag(chan, AST_FLAG_OUTGOING);
03206    }
03207    ast_channel_unlock(chan);
03208    return res;
03209 }

void ast_cancel_shutdown ( void   ) 

Cancel a shutdown in progress.

Cancels an existing shutdown and returns to normal operation

Definition at line 455 of file channel.c.

Referenced by handle_abort_halt().

00456 {
00457    shutting_down = 0;
00458 }

const char* ast_cause2str ( int  state  ) 

Gives the string form of a given hangup cause.

Parameters:
state cause to get the description of Give a name to a cause code Returns the text form of the binary cause code given

Definition at line 575 of file channel.c.

References causes, and desc.

Referenced by __transmit_response(), ast_do_masquerade(), ast_hangup(), findmeexec(), pbx_retrieve_variable(), sip_hangup(), and transmit_request_with_auth().

00576 {
00577    int x;
00578 
00579    for (x=0; x < sizeof(causes) / sizeof(causes[0]); x++) {
00580       if (causes[x].cause == cause)
00581          return causes[x].desc;
00582    }
00583 
00584    return "Unknown";
00585 }

void ast_change_name ( struct ast_channel chan,
char *  newname 
)

Change channel name.

Definition at line 3442 of file channel.c.

References ast_string_field_set, manager_event(), ast_channel::name, name, and ast_channel::uniqueid.

03443 {
03444    manager_event(EVENT_FLAG_CALL, "Rename", "Oldname: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", chan->name, newname, chan->uniqueid);
03445    ast_string_field_set(chan, name, newname);
03446 }

struct ast_channel* ast_channel_alloc ( int  needqueue,
int  state,
const char *  cid_num,
const char *  cid_name,
const char *  acctcode,
const char *  exten,
const char *  context,
const int  amaflag,
const char *  name_fmt,
  ... 
)

Create a channel structure.

Returns:
Returns NULL on failure to allocate.
Note:
New channels are by default set to the "default" context and extension "s"

Definition at line 709 of file channel.c.

References ast_calloc, ast_log(), AST_MAX_FDS, ast_string_field_init, DAHDI_FILE_TIMER, ast_channel::flags, free, LOG_WARNING, sched_context_create(), and sched_context_destroy().

Referenced by __oh323_new(), acf_odbc_read(), acf_odbc_write(), action_getvar(), agent_new(), alsa_new(), ast_async_goto(), ast_iax2_new(), ast_pbx_outgoing_cdr_failed(), ast_pbx_outgoing_exten(), check_goto_on_transfer(), dahdi_new(), do_atxfer(), features_new(), gtalk_new(), iax_park(), local_new(), make_email_file(), masq_park_call(), mgcp_new(), misdn_new(), nbs_new(), oss_new(), pbx_substitute_variables_helper_full(), phone_new(), sendpage(), sip_new(), sip_park(), and skinny_new().

00710 {
00711    struct ast_channel *tmp;
00712    int x;
00713    int flags;
00714    struct varshead *headp;
00715    va_list ap1, ap2;
00716 
00717    /* If shutting down, don't allocate any new channels */
00718    if (shutting_down) {
00719       ast_log(LOG_WARNING, "Channel allocation failed: Refusing due to active shutdown\n");
00720       return NULL;
00721    }
00722 
00723    if (!(tmp = ast_calloc(1, sizeof(*tmp))))
00724       return NULL;
00725 
00726    if (!(tmp->sched = sched_context_create())) {
00727       ast_log(LOG_WARNING, "Channel allocation failed: Unable to create schedule context\n");
00728       free(tmp);
00729       return NULL;
00730    }
00731    
00732    if ((ast_string_field_init(tmp, 128))) {
00733       sched_context_destroy(tmp->sched);
00734       free(tmp);
00735       return NULL;
00736    }
00737 
00738    /* Don't bother initializing the last two FD here, because they
00739       will *always* be set just a few lines down (AST_TIMING_FD,
00740       AST_ALERT_FD). */
00741    for (x = 0; x < AST_MAX_FDS - 2; x++)
00742       tmp->fds[x] = -1;
00743 
00744 #ifdef HAVE_DAHDI
00745 
00746    tmp->timingfd = open(DAHDI_FILE_TIMER, O_RDWR);
00747 
00748    if (tmp->timingfd > -1) {
00749       /* Check if timing interface supports new
00750          ping/pong scheme */
00751       flags = 1;
00752       if (!ioctl(tmp->timingfd, DAHDI_TIMERPONG, &flags))
00753          needqueue = 0;
00754    }
00755 #else
00756    tmp->timingfd = -1;              
00757 #endif               
00758 
00759    if (needqueue) {
00760       if (pipe(tmp->alertpipe)) {
00761          ast_log(LOG_WARNING, "Channel allocation failed: Can't create alert pipe!\n");
00762 alertpipe_failed:
00763 #ifdef HAVE_DAHDI
00764          if (tmp->timingfd > -1)
00765             close(tmp->timingfd);
00766 #endif
00767          sched_context_destroy(tmp->sched);
00768          ast_string_field_free_memory(tmp);
00769          free(tmp);
00770          return NULL;
00771       } else {
00772          flags = fcntl(tmp->alertpipe[0], F_GETFL);
00773          if (fcntl(tmp->alertpipe[0], F_SETFL, flags | O_NONBLOCK) < 0) {
00774             ast_log(LOG_WARNING, "Channel allocation failed: Unable to set alertpipe nonblocking! (%d: %s)\n", errno, strerror(errno));
00775             close(tmp->alertpipe[0]);
00776             close(tmp->alertpipe[1]);
00777             goto alertpipe_failed;
00778          }
00779          flags = fcntl(tmp->alertpipe[1], F_GETFL);
00780          if (fcntl(tmp->alertpipe[1], F_SETFL, flags | O_NONBLOCK) < 0) {
00781             ast_log(LOG_WARNING, "Channel allocation failed: Unable to set alertpipe nonblocking! (%d: %s)\n", errno, strerror(errno));
00782             close(tmp->alertpipe[0]);
00783             close(tmp->alertpipe[1]);
00784             goto alertpipe_failed;
00785          }
00786       }
00787    } else   /* Make sure we've got it done right if they don't */
00788       tmp->alertpipe[0] = tmp->alertpipe[1] = -1;
00789 
00790    /* Always watch the alertpipe */
00791    tmp->fds[AST_ALERT_FD] = tmp->alertpipe[0];
00792    /* And timing pipe */
00793    tmp->fds[AST_TIMING_FD] = tmp->timingfd;
00794    ast_string_field_set(tmp, name, "**Unknown**");
00795 
00796    /* Initial state */
00797    tmp->_state = state;
00798 
00799    tmp->streamid = -1;
00800    
00801    tmp->fin = global_fin;
00802    tmp->fout = global_fout;
00803 
00804    if (ast_strlen_zero(ast_config_AST_SYSTEM_NAME)) {
00805       ast_string_field_build(tmp, uniqueid, "%li.%d", (long) time(NULL), 
00806          ast_atomic_fetchadd_int(&uniqueint, 1));
00807    } else {
00808       ast_string_field_build(tmp, uniqueid, "%s-%li.%d", ast_config_AST_SYSTEM_NAME, 
00809          (long) time(NULL), ast_atomic_fetchadd_int(&uniqueint, 1));
00810    }
00811 
00812    tmp->cid.cid_name = ast_strdup(cid_name);
00813    tmp->cid.cid_num = ast_strdup(cid_num);
00814    
00815    if (!ast_strlen_zero(name_fmt)) {
00816       /* Almost every channel is calling this function, and setting the name via the ast_string_field_build() call.
00817        * And they all use slightly different formats for their name string.
00818        * This means, to set the name here, we have to accept variable args, and call the string_field_build from here.
00819        * This means, that the stringfields must have a routine that takes the va_lists directly, and 
00820        * uses them to build the string, instead of forming the va_lists internally from the vararg ... list.
00821        * This new function was written so this can be accomplished.
00822        */
00823       va_start(ap1, name_fmt);
00824       va_start(ap2, name_fmt);
00825       ast_string_field_build_va(tmp, name, name_fmt, ap1, ap2);
00826       va_end(ap1);
00827       va_end(ap2);
00828    }
00829 
00830    /* Reminder for the future: under what conditions do we NOT want to track cdrs on channels? */
00831 
00832    /* These 4 variables need to be set up for the cdr_init() to work right */
00833    if (amaflag)
00834       tmp->amaflags = amaflag;
00835    else
00836       tmp->amaflags = ast_default_amaflags;
00837    
00838    if (!ast_strlen_zero(acctcode))
00839       ast_string_field_set(tmp, accountcode, acctcode);
00840    else
00841       ast_string_field_set(tmp, accountcode, ast_default_accountcode);
00842       
00843    if (!ast_strlen_zero(context))
00844       ast_copy_string(tmp->context, context, sizeof(tmp->context));
00845    else
00846       strcpy(tmp->context, "default");
00847 
00848    if (!ast_strlen_zero(exten))
00849       ast_copy_string(tmp->exten, exten, sizeof(tmp->exten));
00850    else
00851       strcpy(tmp->exten, "s");
00852 
00853    tmp->priority = 1;
00854       
00855    tmp->cdr = ast_cdr_alloc();
00856    ast_cdr_init(tmp->cdr, tmp);
00857    ast_cdr_start(tmp->cdr);
00858    
00859    headp = &tmp->varshead;
00860    AST_LIST_HEAD_INIT_NOLOCK(headp);
00861    
00862    ast_mutex_init(&tmp->lock);
00863    
00864    AST_LIST_HEAD_INIT_NOLOCK(&tmp->datastores);
00865    
00866    ast_string_field_set(tmp, language, defaultlanguage);
00867 
00868    tmp->tech = &null_tech;
00869 
00870    AST_LIST_LOCK(&channels);
00871    AST_LIST_INSERT_HEAD(&channels, tmp, chan_list);
00872    AST_LIST_UNLOCK(&channels);
00873 
00874    /*\!note
00875     * and now, since the channel structure is built, and has its name, let's
00876     * call the manager event generator with this Newchannel event. This is the
00877     * proper and correct place to make this call, but you sure do have to pass
00878     * a lot of data into this func to do it here!
00879     */
00880    if (!ast_strlen_zero(name_fmt)) {
00881       manager_event(EVENT_FLAG_CALL, "Newchannel",
00882             "Channel: %s\r\n"
00883             "State: %s\r\n"
00884             "CallerIDNum: %s\r\n"
00885             "CallerIDName: %s\r\n"
00886             "Uniqueid: %s\r\n",
00887             tmp->name, ast_state2str(state),
00888             S_OR(cid_num, "<unknown>"),
00889             S_OR(cid_name, "<unknown>"),
00890             tmp->uniqueid);
00891    }
00892 
00893    return tmp;
00894 }

enum ast_bridge_result ast_channel_bridge ( struct ast_channel c0,
struct ast_channel c1,
struct ast_bridge_config config,
struct ast_frame **  fo,
struct ast_channel **  rc 
)

Bridge two channels together.

Bridge two channels together

Parameters:
c0 first channel to bridge
c1 second channel to bridge
config config for the channels
fo destination frame(?)
rc destination channel(?) Bridge two channels (c0 and c1) together. If an important frame occurs, we return that frame in rf (remember, it could be NULL) and which channel (0 or 1) in rc

Definition at line 4063 of file channel.c.

References ast_channel::_bridge, ast_channel::_softhangup, AST_BRIDGE_COMPLETE, AST_BRIDGE_FAILED, AST_BRIDGE_FAILED_NOWARN, AST_BRIDGE_RETRY, ast_channel_make_compatible(), ast_check_hangup(), ast_check_hangup_locked(), ast_clear_flag, AST_CONTROL_SRCUPDATE, AST_FEATURE_PLAY_WARNING, AST_FEATURE_REDIRECT, AST_FEATURE_WARNING_ACTIVE, AST_FLAG_END_DTMF_ONLY, AST_FLAG_NBRIDGE, AST_FLAG_ZOMBIE, ast_generic_bridge(), ast_indicate(), ast_log(), ast_samp2tv(), ast_set_flag, AST_SOFTHANGUP_UNBRIDGE, ast_strlen_zero(), ast_test_flag, ast_tvadd(), ast_tvdiff_ms(), ast_tvnow(), ast_tvsub(), ast_tvzero(), ast_verbose(), ast_channel::audiohooks, ast_channel_tech::bridge, bridge_playfile(), ast_channel::cid, ast_callerid::cid_num, config, ast_channel::generator, LOG_DEBUG, manager_event(), ast_channel::masq, ast_channel::masqr, ast_channel::monitor, ast_channel::name, ast_channel::nativeformats, option_debug, option_verbose, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), ast_channel::readformat, ast_channel_tech::send_digit_begin, t, ast_channel::tech, ast_channel::uniqueid, VERBOSE_PREFIX_3, and ast_channel::writeformat.

Referenced by ast_bridge_call().

04065 {
04066    struct ast_channel *who = NULL;
04067    enum ast_bridge_result res = AST_BRIDGE_COMPLETE;
04068    int nativefailed=0;
04069    int firstpass;
04070    int o0nativeformats;
04071    int o1nativeformats;
04072    long time_left_ms=0;
04073    char caller_warning = 0;
04074    char callee_warning = 0;
04075 
04076    if (c0->_bridge) {
04077       ast_log(LOG_WARNING, "%s is already in a bridge with %s\n",
04078          c0->name, c0->_bridge->name);
04079       return -1;
04080    }
04081    if (c1->_bridge) {
04082       ast_log(LOG_WARNING, "%s is already in a bridge with %s\n",
04083          c1->name, c1->_bridge->name);
04084       return -1;
04085    }
04086    
04087    /* Stop if we're a zombie or need a soft hangup */
04088    if (ast_test_flag(c0, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c0) ||
04089        ast_test_flag(c1, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c1))
04090       return -1;
04091 
04092    *fo = NULL;
04093    firstpass = config->firstpass;
04094    config->firstpass = 0;
04095 
04096    if (ast_tvzero(config->start_time))
04097       config->start_time = ast_tvnow();
04098    time_left_ms = config->timelimit;
04099 
04100    caller_warning = ast_test_flag(&config->features_caller, AST_FEATURE_PLAY_WARNING);
04101    callee_warning = ast_test_flag(&config->features_callee, AST_FEATURE_PLAY_WARNING);
04102 
04103    if (config->start_sound && firstpass) {
04104       if (caller_warning)
04105          bridge_playfile(c0, c1, config->start_sound, time_left_ms / 1000);
04106       if (callee_warning)
04107          bridge_playfile(c1, c0, config->start_sound, time_left_ms / 1000);
04108    }
04109 
04110    /* Keep track of bridge */
04111    c0->_bridge = c1;
04112    c1->_bridge = c0;
04113 
04114    /* \todo  XXX here should check that cid_num is not NULL */
04115    manager_event(EVENT_FLAG_CALL, "Link",
04116             "Channel1: %s\r\n"
04117             "Channel2: %s\r\n"
04118             "Uniqueid1: %s\r\n"
04119             "Uniqueid2: %s\r\n"
04120             "CallerID1: %s\r\n"
04121             "CallerID2: %s\r\n",
04122             c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num);
04123 
04124    o0nativeformats = c0->nativeformats;
04125    o1nativeformats = c1->nativeformats;
04126 
04127    if (config->feature_timer && !ast_tvzero(config->nexteventts)) {
04128       config->nexteventts = ast_tvadd(config->start_time, ast_samp2tv(config->feature_timer, 1000));
04129    } else if (config->timelimit && firstpass) {
04130       config->nexteventts = ast_tvadd(config->start_time, ast_samp2tv(config->timelimit, 1000));
04131       if (caller_warning || callee_warning)
04132          config->nexteventts = ast_tvsub(config->nexteventts, ast_samp2tv(config->play_warning, 1000));
04133    }
04134 
04135    if (!c0->tech->send_digit_begin)
04136       ast_set_flag(c1, AST_FLAG_END_DTMF_ONLY);
04137    if (!c1->tech->send_digit_begin)
04138       ast_set_flag(c0, AST_FLAG_END_DTMF_ONLY);
04139 
04140    /* Before we enter in and bridge these two together tell them both the source of audio has changed */
04141    ast_indicate(c0, AST_CONTROL_SRCUPDATE);
04142    ast_indicate(c1, AST_CONTROL_SRCUPDATE);
04143 
04144    for (/* ever */;;) {
04145       struct timeval now = { 0, };
04146       int to;
04147 
04148       to = -1;
04149 
04150       if (!ast_tvzero(config->nexteventts)) {
04151          now = ast_tvnow();
04152          to = ast_tvdiff_ms(config->nexteventts, now);
04153          if (to <= 0) {
04154             if (!config->timelimit) {
04155                res = AST_BRIDGE_COMPLETE;
04156                break;
04157             }
04158             to = 0;
04159          }
04160       }
04161 
04162       if (config->timelimit) {
04163          time_left_ms = config->timelimit - ast_tvdiff_ms(now, config->start_time);
04164          if (time_left_ms < to)
04165             to = time_left_ms;
04166 
04167          if (time_left_ms <= 0) {
04168             if (caller_warning && config->end_sound)
04169                bridge_playfile(c0, c1, config->end_sound, 0);
04170             if (callee_warning && config->end_sound)
04171                bridge_playfile(c1, c0, config->end_sound, 0);
04172             *fo = NULL;
04173             if (who)
04174                *rc = who;
04175             res = 0;
04176             break;
04177          }
04178          
04179          if (!to) {
04180             if (time_left_ms >= 5000 && config->warning_sound && config->play_warning && ast_test_flag(config, AST_FEATURE_WARNING_ACTIVE)) {
04181                int t = (time_left_ms + 500) / 1000; /* round to nearest second */
04182                if (caller_warning)
04183                   bridge_playfile(c0, c1, config->warning_sound, t);
04184                if (callee_warning)
04185                   bridge_playfile(c1, c0, config->warning_sound, t);
04186             }
04187             if (config->warning_freq && (time_left_ms > (config->warning_freq + 5000)))
04188                config->nexteventts = ast_tvadd(config->nexteventts, ast_samp2tv(config->warning_freq, 1000));
04189             else
04190                config->nexteventts = ast_tvadd(config->start_time, ast_samp2tv(config->timelimit, 1000));
04191          }
04192          ast_clear_flag(config, AST_FEATURE_WARNING_ACTIVE);
04193       }
04194 
04195       if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE || c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE) {
04196          if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
04197             c0->_softhangup = 0;
04198          if (c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
04199             c1->_softhangup = 0;
04200          c0->_bridge = c1;
04201          c1->_bridge = c0;
04202          if (option_debug)
04203             ast_log(LOG_DEBUG, "Unbridge signal received. Ending native bridge.\n");
04204          continue;
04205       }
04206       
04207       /* Stop if we're a zombie or need a soft hangup */
04208       if (ast_test_flag(c0, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c0) ||
04209           ast_test_flag(c1, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c1)) {
04210          *fo = NULL;
04211          if (who)
04212             *rc = who;
04213          res = 0;
04214          if (option_debug)
04215             ast_log(LOG_DEBUG, "Bridge stops because we're zombie or need a soft hangup: c0=%s, c1=%s, flags: %s,%s,%s,%s\n",
04216                c0->name, c1->name,
04217                ast_test_flag(c0, AST_FLAG_ZOMBIE) ? "Yes" : "No",
04218                ast_check_hangup(c0) ? "Yes" : "No",
04219                ast_test_flag(c1, AST_FLAG_ZOMBIE) ? "Yes" : "No",
04220                ast_check_hangup(c1) ? "Yes" : "No");
04221          break;
04222       }
04223       
04224       /* See if the BRIDGEPEER variable needs to be updated */
04225       if (!ast_strlen_zero(pbx_builtin_getvar_helper(c0, "BRIDGEPEER")))
04226          pbx_builtin_setvar_helper(c0, "BRIDGEPEER", c1->name);
04227       if (!ast_strlen_zero(pbx_builtin_getvar_helper(c1, "BRIDGEPEER")))
04228          pbx_builtin_setvar_helper(c1, "BRIDGEPEER", c0->name);
04229       
04230       if (c0->tech->bridge &&
04231           (config->timelimit == 0) &&
04232           (c0->tech->bridge == c1->tech->bridge) &&
04233           !nativefailed && !c0->monitor && !c1->monitor &&
04234           !c0->audiohooks && !c1->audiohooks && !ast_test_flag(&(config->features_callee),AST_FEATURE_REDIRECT) &&
04235           !ast_test_flag(&(config->features_caller),AST_FEATURE_REDIRECT) &&
04236           !c0->masq && !c0->masqr && !c1->masq && !c1->masqr) {
04237          /* Looks like they share a bridge method and nothing else is in the way */
04238          ast_set_flag(c0, AST_FLAG_NBRIDGE);
04239          ast_set_flag(c1, AST_FLAG_NBRIDGE);
04240          if ((res = c0->tech->bridge(c0, c1, config->flags, fo, rc, to)) == AST_BRIDGE_COMPLETE) {
04241             /* \todo  XXX here should check that cid_num is not NULL */
04242             manager_event(EVENT_FLAG_CALL, "Unlink",
04243                      "Channel1: %s\r\n"
04244                      "Channel2: %s\r\n"
04245                      "Uniqueid1: %s\r\n"
04246                      "Uniqueid2: %s\r\n"
04247                      "CallerID1: %s\r\n"
04248                      "CallerID2: %s\r\n",
04249                      c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num);
04250             if (option_debug)
04251                ast_log(LOG_DEBUG, "Returning from native bridge, channels: %s, %s\n", c0->name, c1->name);
04252 
04253             ast_clear_flag(c0, AST_FLAG_NBRIDGE);
04254             ast_clear_flag(c1, AST_FLAG_NBRIDGE);
04255 
04256             if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE || c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
04257                continue;
04258 
04259             c0->_bridge = NULL;
04260             c1->_bridge = NULL;
04261 
04262             return res;
04263          } else {
04264             ast_clear_flag(c0, AST_FLAG_NBRIDGE);
04265             ast_clear_flag(c1, AST_FLAG_NBRIDGE);
04266          }
04267          switch (res) {
04268          case AST_BRIDGE_RETRY:
04269             continue;
04270          default:
04271             if (option_verbose > 2)
04272                ast_verbose(VERBOSE_PREFIX_3 "Native bridging %s and %s ended\n",
04273                       c0->name, c1->name);
04274             /* fallthrough */
04275          case AST_BRIDGE_FAILED_NOWARN:
04276             nativefailed++;
04277             break;
04278          }
04279       }
04280    
04281       if (((c0->writeformat != c1->readformat) || (c0->readformat != c1->writeformat) ||
04282           (c0->nativeformats != o0nativeformats) || (c1->nativeformats != o1nativeformats)) &&
04283           !(c0->generator || c1->generator)) {
04284          if (ast_channel_make_compatible(c0, c1)) {
04285             ast_log(LOG_WARNING, "Can't make %s and %s compatible\n", c0->name, c1->name);
04286             /* \todo  XXX here should check that cid_num is not NULL */
04287                                 manager_event(EVENT_FLAG_CALL, "Unlink",
04288                      "Channel1: %s\r\n"
04289                      "Channel2: %s\r\n"
04290                      "Uniqueid1: %s\r\n"
04291                      "Uniqueid2: %s\r\n"
04292                      "CallerID1: %s\r\n"
04293                      "CallerID2: %s\r\n",
04294                      c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num);
04295             return AST_BRIDGE_FAILED;
04296          }
04297          o0nativeformats = c0->nativeformats;
04298          o1nativeformats = c1->nativeformats;
04299       }
04300 
04301       if (!ast_strlen_zero(pbx_builtin_getvar_helper(c0, "BRIDGEPEER")))
04302          pbx_builtin_setvar_helper(c0, "BRIDGEPEER", c1->name);
04303       if (!ast_strlen_zero(pbx_builtin_getvar_helper(c1, "BRIDGEPEER")))
04304          pbx_builtin_setvar_helper(c1, "BRIDGEPEER", c0->name);
04305 
04306       res = ast_generic_bridge(c0, c1, config, fo, rc, config->nexteventts);
04307       if (res != AST_BRIDGE_RETRY) {
04308          break;
04309       } else if (config->feature_timer) {
04310          /* feature timer expired but has not been updated, sending to ast_bridge_call to do so */
04311          break;
04312       }
04313    }
04314 
04315    ast_clear_flag(c0, AST_FLAG_END_DTMF_ONLY);
04316    ast_clear_flag(c1, AST_FLAG_END_DTMF_ONLY);
04317 
04318    /* Now that we have broken the bridge the source will change yet again */
04319    ast_indicate(c0, AST_CONTROL_SRCUPDATE);
04320    ast_indicate(c1, AST_CONTROL_SRCUPDATE);
04321 
04322    c0->_bridge = NULL;
04323    c1->_bridge = NULL;
04324 
04325    /* \todo  XXX here should check that cid_num is not NULL */
04326    manager_event(EVENT_FLAG_CALL, "Unlink",
04327             "Channel1: %s\r\n"
04328             "Channel2: %s\r\n"
04329             "Uniqueid1: %s\r\n"
04330             "Uniqueid2: %s\r\n"
04331             "CallerID1: %s\r\n"
04332             "CallerID2: %s\r\n",
04333             c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num);
04334    if (option_debug)
04335       ast_log(LOG_DEBUG, "Bridge stops bridging channels %s and %s\n", c0->name, c1->name);
04336 
04337    return res;
04338 }

int ast_channel_cmpwhentohangup ( struct ast_channel chan,
time_t  offset 
)

Compare a offset with the settings of when to hang a channel up.

Parameters:
chan channel on which to check for hang up
offset offset in seconds from current time
Returns:
1, 0, or -1 This function compares a offset from current time with the absolute time out on a channel (when to hang up). If the absolute time out on a channel is earlier than current time plus the offset, it returns 1, if the two time values are equal, it return 0, otherwise, it retturn -1.

Definition at line 475 of file channel.c.

References ast_channel::whentohangup.

00476 {
00477    time_t whentohangup;
00478 
00479    if (chan->whentohangup == 0) {
00480       return (offset == 0) ? 0 : -1;
00481    } else {
00482       if (offset == 0)  /* XXX why is this special ? */
00483          return (1);
00484       else {
00485          whentohangup = offset + time (NULL);
00486          if (chan->whentohangup < whentohangup)
00487             return (1);
00488          else if (chan->whentohangup == whentohangup)
00489             return (0);
00490          else
00491             return (-1);
00492       }
00493    }
00494 }

int ast_channel_datastore_add ( struct ast_channel chan,
struct ast_datastore datastore 
)

Add a datastore to a channel.

Definition at line 1370 of file channel.c.

References AST_LIST_INSERT_HEAD, ast_channel::datastores, and ast_datastore::entry.

Referenced by _macro_exec(), add_features_datastores(), setup_chanspy_ds(), setup_inheritance_datastore(), setup_mixmonitor_ds(), setup_transfer_datastore(), smdi_msg_retrieve_read(), speech_create(), and try_calling().

01371 {
01372    int res = 0;
01373 
01374    AST_LIST_INSERT_HEAD(&chan->datastores, datastore, entry);
01375 
01376    return res;
01377 }

struct ast_datastore* ast_channel_datastore_alloc ( const struct ast_datastore_info info,
char *  uid 
)

Create a channel datastore structure.

Definition at line 1309 of file channel.c.

References ast_calloc, ast_strdup, and ast_datastore::info.

Referenced by _macro_exec(), add_features_datastores(), ast_channel_datastore_inherit(), setup_chanspy_ds(), setup_inheritance_datastore(), setup_mixmonitor_ds(), setup_transfer_datastore(), smdi_msg_retrieve_read(), speech_create(), and try_calling().

01310 {
01311    struct ast_datastore *datastore = NULL;
01312 
01313    /* Make sure we at least have type so we can identify this */
01314    if (info == NULL) {
01315       return NULL;
01316    }
01317 
01318    /* Allocate memory for datastore and clear it */
01319    datastore = ast_calloc(1, sizeof(*datastore));
01320    if (datastore == NULL) {
01321       return NULL;
01322    }
01323 
01324    datastore->info = info;
01325 
01326    datastore->uid = ast_strdup(uid);
01327 
01328    return datastore;
01329 }

struct ast_datastore* ast_channel_datastore_find ( struct ast_channel chan,
const struct ast_datastore_info info,
char *  uid 
)

Find a datastore on a channel.

Definition at line 1397 of file channel.c.

References AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_channel::datastores, ast_datastore::entry, ast_datastore::info, and ast_datastore::uid.

Referenced by _macro_exec(), add_features_datastores(), attended_transfer_occurred(), chanspy_ds_free(), do_atxfer(), do_parking_thread(), find_speech(), func_inheritance_write(), park_exec(), queue_transfer_fixup(), smdi_msg_read(), speech_background(), speech_destroy(), and try_calling().

01398 {
01399    struct ast_datastore *datastore = NULL;
01400    
01401    if (info == NULL)
01402       return NULL;
01403 
01404    AST_LIST_TRAVERSE_SAFE_BEGIN(&chan->datastores, datastore, entry) {
01405       if (datastore->info == info) {
01406          if (uid != NULL && datastore->uid != NULL) {
01407             if (!strcasecmp(uid, datastore->uid)) {
01408                /* Matched by type AND uid */
01409                break;
01410             }
01411          } else {
01412             /* Matched by type at least */
01413             break;
01414          }
01415       }
01416    }
01417    AST_LIST_TRAVERSE_SAFE_END
01418 
01419    return datastore;
01420 }

int ast_channel_datastore_free ( struct ast_datastore datastore  ) 

Free a channel datastore structure.

Definition at line 1331 of file channel.c.

References ast_datastore::data, ast_datastore_info::destroy, free, ast_datastore::info, and ast_datastore::uid.

Referenced by add_features_datastores(), ast_channel_free(), chanspy_ds_free(), setup_inheritance_datastore(), and try_calling().

01332 {
01333    int res = 0;
01334 
01335    /* Using the destroy function (if present) destroy the data */
01336    if (datastore->info->destroy != NULL && datastore->data != NULL) {
01337       datastore->info->destroy(datastore->data);
01338       datastore->data = NULL;
01339    }
01340 
01341    /* Free allocated UID memory */
01342    if (datastore->uid != NULL) {
01343       free(datastore->uid);
01344       datastore->uid = NULL;
01345    }
01346 
01347    /* Finally free memory used by ourselves */
01348    free(datastore);
01349 
01350    return res;
01351 }

int ast_channel_datastore_inherit ( struct ast_channel from,
struct ast_channel to 
)

Inherit datastores from a parent to a child.

Definition at line 1353 of file channel.c.

References ast_channel_datastore_alloc(), AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_datastore::data, DATASTORE_INHERIT_FOREVER, ast_channel::datastores, ast_datastore_info::duplicate, ast_datastore::entry, ast_datastore::info, ast_datastore::inheritance, and ast_datastore::uid.

Referenced by local_call(), and wait_for_answer().

01354 {
01355    struct ast_datastore *datastore = NULL, *datastore2;
01356 
01357    AST_LIST_TRAVERSE(&from->datastores, datastore, entry) {
01358       if (datastore->inheritance > 0) {
01359          datastore2 = ast_channel_datastore_alloc(datastore->info, datastore->uid);
01360          if (datastore2) {
01361             datastore2->data = datastore->info->duplicate ? datastore->info->duplicate(datastore->data) : NULL;
01362             datastore2->inheritance = datastore->inheritance == DATASTORE_INHERIT_FOREVER ? DATASTORE_INHERIT_FOREVER : datastore->inheritance - 1;
01363             AST_LIST_INSERT_TAIL(&to->datastores, datastore2, entry);
01364          }
01365       }
01366    }
01367    return 0;
01368 }

int ast_channel_datastore_remove ( struct ast_channel chan,
struct ast_datastore datastore 
)

Remove a datastore from a channel.

Definition at line 1379 of file channel.c.

References AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_channel::datastores, and ast_datastore::entry.

Referenced by chanspy_ds_free(), queue_transfer_fixup(), speech_background(), speech_destroy(), and try_calling().

01380 {
01381    struct ast_datastore *datastore2 = NULL;
01382    int res = -1;
01383 
01384    /* Find our position and remove ourselves */
01385    AST_LIST_TRAVERSE_SAFE_BEGIN(&chan->datastores, datastore2, entry) {
01386       if (datastore2 == datastore) {
01387          AST_LIST_REMOVE_CURRENT(&chan->datastores, entry);
01388          res = 0;
01389          break;
01390       }
01391    }
01392    AST_LIST_TRAVERSE_SAFE_END
01393 
01394    return res;
01395 }

int ast_channel_defer_dtmf ( struct ast_channel chan  ) 

Set defer DTMF flag on channel.

Defer DTMF so that you only read things like hangups and audio. Returns non-zero if channel was already DTMF-deferred or 0 if channel is just now being DTMF-deferred

Definition at line 1007 of file channel.c.

References AST_FLAG_DEFER_DTMF, ast_set_flag, and ast_test_flag.

Referenced by __adsi_transmit_messages(), and find_cache().

01008 {
01009    int pre = 0;
01010 
01011    if (chan) {
01012       pre = ast_test_flag(chan, AST_FLAG_DEFER_DTMF);
01013       ast_set_flag(chan, AST_FLAG_DEFER_DTMF);
01014    }
01015    return pre;
01016 }

void ast_channel_free ( struct ast_channel chan  ) 

Free a channel structure.

Definition at line 1214 of file channel.c.

References ast_channel::alertpipe, ast_app_group_discard(), ast_cdr_discard(), ast_channel_datastore_free(), ast_channel_lock, AST_CHANNEL_NAME, ast_channel_unlock, ast_copy_string(), ast_device_state_changed_literal(), ast_frfree, ast_jb_destroy(), AST_LIST_LOCK, AST_LIST_REMOVE, AST_LIST_REMOVE_HEAD, AST_LIST_UNLOCK, ast_log(), ast_moh_cleanup(), ast_mutex_destroy(), ast_string_field_free_memory, ast_translator_free_path(), ast_var_delete(), ast_channel::cdr, ast_channel::cid, ast_channel::datastores, ast_datastore::entry, f, free, free_cid(), ast_channel::lock, LOG_ERROR, ast_channel::monitor, ast_channel::music_state, name, ast_channel::name, ast_channel::pbx, ast_channel::readq, ast_channel::readtrans, ast_channel::sched, sched_context_destroy(), ast_channel_monitor::stop, ast_channel::tech_pvt, ast_channel::timingfd, ast_channel::varshead, and ast_channel::writetrans.

Referenced by acf_odbc_read(), acf_odbc_write(), action_getvar(), agent_cleanup(), agent_new(), ast_do_masquerade(), ast_hangup(), ast_iax2_new(), ast_pbx_outgoing_cdr_failed(), gtalk_newcall(), local_new(), make_email_file(), pbx_substitute_variables_helper_full(), and sendpage().

01215 {
01216    int fd;
01217    struct ast_var_t *vardata;
01218    struct ast_frame *f;
01219    struct varshead *headp;
01220    struct ast_datastore *datastore = NULL;
01221    char name[AST_CHANNEL_NAME], *dashptr;
01222    
01223    headp=&chan->varshead;
01224    
01225    AST_LIST_LOCK(&channels);
01226    if (!AST_LIST_REMOVE(&channels, chan, chan_list)) {
01227       AST_LIST_UNLOCK(&channels);
01228       ast_log(LOG_ERROR, "Unable to find channel in list to free. Assuming it has already been done.\n");
01229    }
01230    /* Lock and unlock the channel just to be sure nobody has it locked still
01231       due to a reference retrieved from the channel list. */
01232    ast_channel_lock(chan);
01233    ast_channel_unlock(chan);
01234 
01235    /* Get rid of each of the data stores on the channel */
01236    while ((datastore = AST_LIST_REMOVE_HEAD(&chan->datastores, entry)))
01237       /* Free the data store */
01238       ast_channel_datastore_free(datastore);
01239 
01240    /* Lock and unlock the channel just to be sure nobody has it locked still
01241       due to a reference that was stored in a datastore. (i.e. app_chanspy) */
01242    ast_channel_lock(chan);
01243    ast_channel_unlock(chan);
01244 
01245    if (chan->tech_pvt) {
01246       ast_log(LOG_WARNING, "Channel '%s' may not have been hung up properly\n", chan->name);
01247       free(chan->tech_pvt);
01248    }
01249 
01250    if (chan->sched)
01251       sched_context_destroy(chan->sched);
01252 
01253    ast_copy_string(name, chan->name, sizeof(name));
01254    if ((dashptr = strrchr(name, '-'))) {
01255       *dashptr = '\0';
01256    }
01257 
01258    /* Stop monitoring */
01259    if (chan->monitor)
01260       chan->monitor->stop( chan, 0 );
01261 
01262    /* If there is native format music-on-hold state, free it */
01263    if (chan->music_state)
01264       ast_moh_cleanup(chan);
01265 
01266    /* Free translators */
01267    if (chan->readtrans)
01268       ast_translator_free_path(chan->readtrans);
01269    if (chan->writetrans)
01270       ast_translator_free_path(chan->writetrans);
01271    if (chan->pbx)
01272       ast_log(LOG_WARNING, "PBX may not have been terminated properly on '%s'\n", chan->name);
01273    free_cid(&chan->cid);
01274    /* Close pipes if appropriate */
01275    if ((fd = chan->alertpipe[0]) > -1)
01276       close(fd);
01277    if ((fd = chan->alertpipe[1]) > -1)
01278       close(fd);
01279    if ((fd = chan->timingfd) > -1)
01280       close(fd);
01281    while ((f = AST_LIST_REMOVE_HEAD(&chan->readq, frame_list)))
01282       ast_frfree(f);
01283    
01284    /* loop over the variables list, freeing all data and deleting list items */
01285    /* no need to lock the list, as the channel is already locked */
01286    
01287    while ((vardata = AST_LIST_REMOVE_HEAD(headp, entries)))
01288       ast_var_delete(vardata);
01289 
01290    ast_app_group_discard(chan);
01291 
01292    /* Destroy the jitterbuffer */
01293    ast_jb_destroy(chan);
01294 
01295    if (chan->cdr) {
01296       ast_cdr_discard(chan->cdr);
01297       chan->cdr = NULL;
01298    }
01299    
01300    ast_mutex_destroy(&chan->lock);
01301 
01302    ast_string_field_free_memory(chan);
01303    free(chan);
01304    AST_LIST_UNLOCK(&channels);
01305 
01306    ast_device_state_changed_literal(name);
01307 }

void ast_channel_inherit_variables ( const struct ast_channel parent,
struct ast_channel child 
)

Inherits channel variable from parent to child channel.

Parameters:
parent Parent channel
child Child channel
Scans all channel variables in the parent channel, looking for those that should be copied into the child channel. Variables whose names begin with a single '_' are copied into the child channel with the prefix removed. Variables whose names begin with '__' are copied into the child channel with their names unchanged.

Definition at line 3448 of file channel.c.

References AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_log(), ast_var_assign(), ast_var_full_name(), ast_var_name(), ast_var_value(), ast_var_t::entries, LOG_DEBUG, option_debug, and ast_channel::varshead.

Referenced by __ast_request_and_dial(), agent_call(), ast_feature_request_and_dial(), begin_dial(), findmeexec(), ring_entry(), and wait_for_answer().

03449 {
03450    struct ast_var_t *current, *newvar;
03451    const char *varname;
03452 
03453    AST_LIST_TRAVERSE(&parent->varshead, current, entries) {
03454       int vartype = 0;
03455 
03456       varname = ast_var_full_name(current);
03457       if (!varname)
03458          continue;
03459 
03460       if (varname[0] == '_') {
03461          vartype = 1;
03462          if (varname[1] == '_')
03463             vartype = 2;
03464       }
03465 
03466       switch (vartype) {
03467       case 1:
03468          newvar = ast_var_assign(&varname[1], ast_var_value(current));
03469          if (newvar) {
03470             AST_LIST_INSERT_TAIL(&child->varshead, newvar, entries);
03471             if (option_debug)
03472                ast_log(LOG_DEBUG, "Copying soft-transferable variable %s.\n", ast_var_name(newvar));
03473          }
03474          break;
03475       case 2:
03476          newvar = ast_var_assign(ast_var_full_name(current), ast_var_value(current));
03477          if (newvar) {
03478             AST_LIST_INSERT_TAIL(&child->varshead, newvar, entries);
03479             if (option_debug)
03480                ast_log(LOG_DEBUG, "Copying hard-transferable variable %s.\n", ast_var_name(newvar));
03481          }
03482          break;
03483       default:
03484          if (option_debug)
03485             ast_log(LOG_DEBUG, "Not copying variable %s.\n", ast_var_name(current));
03486          break;
03487       }
03488    }
03489 }

int ast_channel_make_compatible ( struct ast_channel c0,
struct ast_channel c1 
)

Makes two channel formats compatible.

Parameters:
c0 first channel to make compatible
c1 other channel to make compatible Set two channels to compatible formats -- call before ast_channel_bridge in general .
Returns:
Returns 0 on success and -1 if it could not be done

Definition at line 3301 of file channel.c.

References AST_FORMAT_SLINEAR, ast_log(), ast_opt_transcode_via_slin, ast_set_read_format(), ast_set_write_format(), ast_translate_path_steps(), ast_translator_best_choice(), ast_channel::name, ast_channel::nativeformats, ast_channel::readformat, and ast_channel::writeformat.

Referenced by app_exec(), ast_channel_bridge(), check_compat(), park_exec(), try_calling(), and wait_for_answer().

03302 {
03303    int src;
03304    int dst;
03305 
03306    if (chan->readformat == peer->writeformat && chan->writeformat == peer->readformat) {
03307       /* Already compatible!  Moving on ... */
03308       return 0;
03309    }
03310 
03311    /* Set up translation from the chan to the peer */
03312    src = chan->nativeformats;
03313    dst = peer->nativeformats;
03314    if (ast_translator_best_choice(&dst, &src) < 0) {
03315       ast_log(LOG_WARNING, "No path to translate from %s(%d) to %s(%d)\n", chan->name, src, peer->name, dst);
03316       return -1;
03317    }
03318 
03319    /* if the best path is not 'pass through', then
03320       transcoding is needed; if desired, force transcode path
03321       to use SLINEAR between channels, but only if there is
03322       no direct conversion available */
03323    if ((src != dst) && ast_opt_transcode_via_slin &&
03324        (ast_translate_path_steps(dst, src) != 1))
03325       dst = AST_FORMAT_SLINEAR;
03326    if (ast_set_read_format(chan, dst) < 0) {
03327       ast_log(LOG_WARNING, "Unable to set read format on channel %s to %d\n", chan->name, dst);
03328       return -1;
03329    }
03330    if (ast_set_write_format(peer, dst) < 0) {
03331       ast_log(LOG_WARNING, "Unable to set write format on channel %s to %d\n", peer->name, dst);
03332       return -1;
03333    }
03334 
03335    /* Set up translation from the peer to the chan */
03336    src = peer->nativeformats;
03337    dst = chan->nativeformats;
03338    if (ast_translator_best_choice(&dst, &src) < 0) {
03339       ast_log(LOG_WARNING, "No path to translate from %s(%d) to %s(%d)\n", peer->name, src, chan->name, dst);
03340       return -1;
03341    }
03342 
03343    /* if the best path is not 'pass through', then
03344       transcoding is needed; if desired, force transcode path
03345       to use SLINEAR between channels, but only if there is
03346       no direct conversion available */
03347    if ((src != dst) && ast_opt_transcode_via_slin &&
03348        (ast_translate_path_steps(dst, src) != 1))
03349       dst = AST_FORMAT_SLINEAR;
03350    if (ast_set_read_format(peer, dst) < 0) {
03351       ast_log(LOG_WARNING, "Unable to set read format on channel %s to %d\n", peer->name, dst);
03352       return -1;
03353    }
03354    if (ast_set_write_format(chan, dst) < 0) {
03355       ast_log(LOG_WARNING, "Unable to set write format on channel %s to %d\n", chan->name, dst);
03356       return -1;
03357    }
03358    return 0;
03359 }

int ast_channel_masquerade ( struct ast_channel original,
struct ast_channel clone 
)

Weird function made for call transfers.

Parameters:
original channel to make a copy of
clone copy of the original channel This is a very strange and freaky function used primarily for transfer. Suppose that "original" and "clone" are two channels in random situations. This function takes the guts out of "clone" and puts them into the "original" channel, then alerts the channel driver of the change, asking it to fixup any private information (like the p->owner pointer) that is affected by the change. The physical layer of the original channel is hung up.

Definition at line 3361 of file channel.c.

References ast_channel::_bridge, ast_bridged_channel(), ast_channel_lock, ast_channel_trylock, ast_channel_unlock, ast_log(), ast_null_frame, ast_queue_frame(), ast_channel_tech::get_base_channel, LOG_DEBUG, ast_channel::masq, ast_channel::masqr, ast_channel::name, option_debug, and ast_channel::tech.

Referenced by ast_async_goto(), ast_pickup_call(), attempt_transfer(), check_availability(), check_bridge(), check_goto_on_transfer(), do_atxfer(), handle_invite_replaces(), iax_park(), masq_park_call(), misdn_transfer_bc(), pickup_do(), and sip_park().

03362 {
03363    int res = -1;
03364    struct ast_channel *final_orig, *final_clone, *base;
03365 
03366 retrymasq:
03367    final_orig = original;
03368    final_clone = clone;
03369 
03370    ast_channel_lock(original);
03371    while (ast_channel_trylock(clone)) {
03372       ast_channel_unlock(original);
03373       usleep(1);
03374       ast_channel_lock(original);
03375    }
03376 
03377    /* each of these channels may be sitting behind a channel proxy (i.e. chan_agent)
03378       and if so, we don't really want to masquerade it, but its proxy */
03379    if (original->_bridge && (original->_bridge != ast_bridged_channel(original)) && (original->_bridge->_bridge != original))
03380       final_orig = original->_bridge;
03381 
03382    if (clone->_bridge && (clone->_bridge != ast_bridged_channel(clone)) && (clone->_bridge->_bridge != clone))
03383       final_clone = clone->_bridge;
03384    
03385    if (final_clone->tech->get_base_channel && (base = final_clone->tech->get_base_channel(final_clone))) {
03386       final_clone = base;
03387    }
03388 
03389    if ((final_orig != original) || (final_clone != clone)) {
03390       /* Lots and lots of deadlock avoidance.  The main one we're competing with
03391        * is ast_write(), which locks channels recursively, when working with a
03392        * proxy channel. */
03393       if (ast_channel_trylock(final_orig)) {
03394          ast_channel_unlock(clone);
03395          ast_channel_unlock(original);
03396          goto retrymasq;
03397       }
03398       if (ast_channel_trylock(final_clone)) {
03399          ast_channel_unlock(final_orig);
03400          ast_channel_unlock(clone);
03401          ast_channel_unlock(original);
03402          goto retrymasq;
03403       }
03404       ast_channel_unlock(clone);
03405       ast_channel_unlock(original);
03406       original = final_orig;
03407       clone = final_clone;
03408    }
03409 
03410    if (original == clone) {
03411       ast_log(LOG_WARNING, "Can't masquerade channel '%s' into itself!\n", original->name);
03412       ast_channel_unlock(clone);
03413       ast_channel_unlock(original);
03414       return -1;
03415    }
03416 
03417    if (option_debug)
03418       ast_log(LOG_DEBUG, "Planning to masquerade channel %s into the structure of %s\n",
03419          clone->name, original->name);
03420    if (original->masq) {
03421       ast_log(LOG_WARNING, "%s is already going to masquerade as %s\n",
03422          original->masq->name, original->name);
03423    } else if (clone->masqr) {
03424       ast_log(LOG_WARNING, "%s is already going to masquerade as %s\n",
03425          clone->name, clone->masqr->name);
03426    } else {
03427       original->masq = clone;
03428       clone->masqr = original;
03429       ast_queue_frame(original, &ast_null_frame);
03430       ast_queue_frame(clone, &ast_null_frame);
03431       if (option_debug)
03432          ast_log(LOG_DEBUG, "Done planning to masquerade channel %s into the structure of %s\n", clone->name, original->name);
03433       res = 0;
03434    }
03435 
03436    ast_channel_unlock(clone);
03437    ast_channel_unlock(original);
03438 
03439    return res;
03440 }

char* ast_channel_reason2str ( int  reason  ) 

return an english explanation of the code returned thru __ast_request_and_dial's 'outstate' argument

Parameters:
reason The integer argument, usually taken from AST_CONTROL_ macros
Returns:
char pointer explaining the code

Definition at line 2994 of file channel.c.

References AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_HANGUP, AST_CONTROL_RING, and AST_CONTROL_RINGING.

Referenced by attempt_thread().

02995 {
02996    switch (reason) /* the following appear to be the only ones actually returned by request_and_dial */
02997    {
02998    case 0:
02999       return "Call Failure (not BUSY, and not NO_ANSWER, maybe Circuit busy or down?)";
03000    case AST_CONTROL_HANGUP:
03001       return "Hangup";
03002    case AST_CONTROL_RING:
03003       return "Local Ring";
03004    case AST_CONTROL_RINGING:
03005       return "Remote end Ringing";
03006    case AST_CONTROL_ANSWER:
03007       return "Remote end has Answered";
03008    case AST_CONTROL_BUSY:
03009       return "Remote end is Busy";
03010    case AST_CONTROL_CONGESTION:
03011       return "Congestion (circuits busy)";
03012    default:
03013       return "Unknown Reason!!";
03014    }
03015 }

int ast_channel_register ( const struct ast_channel_tech tech  ) 

Register a channel technology (a new channel driver) Called by a channel module to register the kind of channels it supports.

Parameters:
tech Structure defining channel technology or "type"
Returns:
Returns 0 on success, -1 on failure.

Definition at line 497 of file channel.c.

References ast_calloc, AST_LIST_INSERT_HEAD, AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_verbose(), chanlist::list, LOG_DEBUG, LOG_WARNING, option_debug, option_verbose, chanlist::tech, ast_channel_tech::type, and VERBOSE_PREFIX_2.

Referenced by load_module(), and unload_module().

00498 {
00499    struct chanlist *chan;
00500 
00501    AST_LIST_LOCK(&channels);
00502 
00503    AST_LIST_TRAVERSE(&backends, chan, list) {
00504       if (!strcasecmp(tech->type, chan->tech->type)) {
00505          ast_log(LOG_WARNING, "Already have a handler for type '%s'\n", tech->type);
00506          AST_LIST_UNLOCK(&channels);
00507          return -1;
00508       }
00509    }
00510    
00511    if (!(chan = ast_calloc(1, sizeof(*chan)))) {
00512       AST_LIST_UNLOCK(&channels);
00513       return -1;
00514    }
00515    chan->tech = tech;
00516    AST_LIST_INSERT_HEAD(&backends, chan, list);
00517 
00518    if (option_debug)
00519       ast_log(LOG_DEBUG, "Registered handler for '%s' (%s)\n", chan->tech->type, chan->tech->description);
00520 
00521    if (option_verbose > 1)
00522       ast_verbose(VERBOSE_PREFIX_2 "Registered channel type '%s' (%s)\n", chan->tech->type,
00523              chan->tech->description);
00524 
00525    AST_LIST_UNLOCK(&channels);
00526    return 0;
00527 }

int ast_channel_sendhtml ( struct ast_channel channel,
int  subclass,
const char *  data,
int  datalen 
)

Send HTML or URL on link. Returns 0 on success or -1 on failure

Definition at line 3289 of file channel.c.

References ast_channel_tech::send_html, and ast_channel::tech.

Referenced by agent_sendhtml(), ast_channel_sendurl(), and wait_for_answer().

03290 {
03291    if (chan->tech->send_html)
03292       return chan->tech->send_html(chan, subclass, data, datalen);
03293    return -1;
03294 }

int ast_channel_sendurl ( struct ast_channel channel,
const char *  url 
)

Send URL on link. Returns 0 on success or -1 on failure

Definition at line 3296 of file channel.c.

References ast_channel_sendhtml(), and AST_HTML_URL.

Referenced by sendurl_exec(), and try_calling().

03297 {
03298    return ast_channel_sendhtml(chan, AST_HTML_URL, url, strlen(url) + 1);
03299 }

int ast_channel_setoption ( struct ast_channel channel,
int  option,
void *  data,
int  datalen,
int  block 
)

Sets an option on a channel.

Parameters:
channel channel to set options on
option option to change
data data specific to option
datalen length of the data
block blocking or not Set an option on a channel (see frame.h), optionally blocking awaiting the reply Returns 0 on success and -1 on failure

Definition at line 4341 of file channel.c.

References ast_log(), errno, LOG_ERROR, ast_channel_tech::setoption, and ast_channel::tech.

Referenced by ast_bridge_call(), common_exec(), conf_run(), dahdi_hangup(), func_channel_write(), handle_tddmode(), play_record_review(), reset_volumes(), rpt(), set_listen_volume(), set_talk_volume(), try_calling(), and vm_forwardoptions().

04342 {
04343    int res;
04344 
04345    if (chan->tech->setoption) {
04346       res = chan->tech->setoption(chan, option, data, datalen);
04347       if (res < 0)
04348          return res;
04349    } else {
04350       errno = ENOSYS;
04351       return -1;
04352    }
04353    if (block) {
04354       /* XXX Implement blocking -- just wait for our option frame reply, discarding
04355          intermediate packets. XXX */
04356       ast_log(LOG_ERROR, "XXX Blocking not implemented yet XXX\n");
04357       return -1;
04358    }
04359    return 0;
04360 }

void ast_channel_setwhentohangup ( struct ast_channel chan,
time_t  offset 
)

Set when to hang a channel up.

Parameters:
chan channel on which to check for hang up
offset offset in seconds from current time of when to hang up This function sets the absolute time out on a channel (when to hang up).

Definition at line 467 of file channel.c.

References ast_null_frame, ast_queue_frame(), and ast_channel::whentohangup.

Referenced by action_timeout(), and timeout_write().

00468 {
00469    chan->whentohangup = offset ? time(NULL) + offset : 0;
00470    ast_queue_frame(chan, &ast_null_frame);
00471    return;
00472 }

struct ast_silence_generator* ast_channel_start_silence_generator ( struct ast_channel chan  ) 

Starts a silence generator on the given channel.

Parameters:
chan The channel to generate silence on
Returns:
An ast_silence_generator pointer, or NULL if an error occurs
This function will cause SLINEAR silence to be generated on the supplied channel until it is disabled; if the channel cannot be put into SLINEAR mode then the function will fail.

The pointer returned by this function must be preserved and passed to ast_channel_stop_silence_generator when you wish to stop the silence generation.

Definition at line 4669 of file channel.c.

References ast_activate_generator(), ast_calloc, AST_FORMAT_SLINEAR, ast_log(), ast_set_write_format(), free, LOG_DEBUG, LOG_ERROR, ast_channel::name, ast_silence_generator::old_write_format, option_debug, silence_generator, and ast_channel::writeformat.

Referenced by __ast_play_and_record(), ast_dtmf_stream(), and channel_spy().

04670 {
04671    struct ast_silence_generator *state;
04672 
04673    if (!(state = ast_calloc(1, sizeof(*state)))) {
04674       return NULL;
04675    }
04676 
04677    state->old_write_format = chan->writeformat;
04678 
04679    if (ast_set_write_format(chan, AST_FORMAT_SLINEAR) < 0) {
04680       ast_log(LOG_ERROR, "Could not set write format to SLINEAR\n");
04681       free(state);
04682       return NULL;
04683    }
04684 
04685    ast_activate_generator(chan, &silence_generator, state);
04686 
04687    if (option_debug)
04688       ast_log(LOG_DEBUG, "Started silence generator on '%s'\n", chan->name);
04689 
04690    return state;
04691 }

void ast_channel_stop_silence_generator ( struct ast_channel chan,
struct ast_silence_generator state 
)

Stops a previously-started silence generator on the given channel.

Parameters:
chan The channel to operate on
state The ast_silence_generator pointer return by a previous call to ast_channel_start_silence_generator.
Returns:
nothing
This function will stop the operating silence generator and return the channel to its previous write format.

Definition at line 4693 of file channel.c.

References ast_deactivate_generator(), ast_log(), ast_set_write_format(), free, LOG_DEBUG, LOG_ERROR, ast_channel::name, ast_silence_generator::old_write_format, and option_debug.

Referenced by __ast_play_and_record(), ast_dtmf_stream(), and channel_spy().

04694 {
04695    if (!state)
04696       return;
04697 
04698    ast_deactivate_generator(chan);
04699 
04700    if (option_debug)
04701       ast_log(LOG_DEBUG, "Stopped silence generator on '%s'\n", chan->name);
04702 
04703    if (ast_set_write_format(chan, state->old_write_format) < 0)
04704       ast_log(LOG_ERROR, "Could not return write format to its original state\n");
04705 
04706    free(state);
04707 }

int ast_channel_supports_html ( struct ast_channel channel  ) 

Returns 0 if channel does not support HTML or non-zero if it does

Definition at line 3284 of file channel.c.

References ast_channel_tech::send_html, and ast_channel::tech.

Referenced by sendurl_exec(), and try_calling().

03285 {
03286    return (chan->tech->send_html) ? 1 : 0;
03287 }

void ast_channel_undefer_dtmf ( struct ast_channel chan  ) 

Unset defer DTMF flag on channel.

Undo defer. ast_read will return any dtmf characters that were queued

Definition at line 1019 of file channel.c.

References ast_clear_flag, and AST_FLAG_DEFER_DTMF.

Referenced by __adsi_transmit_messages(), find_cache(), and rpt_call().

01020 {
01021    if (chan)
01022       ast_clear_flag(chan, AST_FLAG_DEFER_DTMF);
01023 }

void ast_channel_unregister ( const struct ast_channel_tech tech  ) 

Unregister a channel technology.

Parameters:
tech Structure defining channel technology or "type" that was previously registered
Returns:
No return value.

Definition at line 529 of file channel.c.

References AST_LIST_LOCK, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, AST_LIST_UNLOCK, ast_log(), ast_verbose(), free, chanlist::list, LOG_DEBUG, option_debug, option_verbose, chanlist::tech, ast_channel_tech::type, and VERBOSE_PREFIX_2.

Referenced by __unload_module(), and unload_module().

00530 {
00531    struct chanlist *chan;
00532 
00533    if (option_debug)
00534       ast_log(LOG_DEBUG, "Unregistering channel type '%s'\n", tech->type);
00535 
00536    AST_LIST_LOCK(&channels);
00537 
00538    AST_LIST_TRAVERSE_SAFE_BEGIN(&backends, chan, list) {
00539       if (chan->tech == tech) {
00540          AST_LIST_REMOVE_CURRENT(&backends, list);
00541          free(chan);
00542          if (option_verbose > 1)
00543             ast_verbose(VERBOSE_PREFIX_2 "Unregistered channel type '%s'\n", tech->type);
00544          break;   
00545       }
00546    }
00547    AST_LIST_TRAVERSE_SAFE_END
00548 
00549    AST_LIST_UNLOCK(&channels);
00550 }

struct ast_channel* ast_channel_walk_locked ( const struct ast_channel prev  ) 

Browse channels in use Browse the channels currently in use.

Parameters:
prev where you want to start in the channel list
Returns:
Returns the next channel in the list, NULL on end. If it returns a channel, that channel *has been locked*!

Definition at line 1135 of file channel.c.

References channel_find_locked().

Referenced by action_status(), ast_complete_channels(), ast_pickup_call(), complete_ch_helper(), conf_exec(), handle_chanlist(), handle_chanlist_deprecated(), handle_core_set_debug_channel(), handle_debugchan_deprecated(), handle_nodebugchan_deprecated(), next_channel(), pickup_by_exten(), pickup_by_mark(), and softhangup_exec().

01136 {
01137    return channel_find_locked(prev, NULL, 0, NULL, NULL);
01138 }

void ast_channels_init ( void   ) 

Provided by channel.c

Definition at line 4593 of file channel.c.

References ast_cli_register_multiple(), and cli_channel.

Referenced by main().

04594 {
04595    ast_cli_register_multiple(cli_channel, sizeof(cli_channel) / sizeof(struct ast_cli_entry));
04596 }

struct ast_variable* ast_channeltype_list ( void   ) 

return an ast_variable list of channeltypes

Definition at line 163 of file channel.c.

References AST_LIST_TRAVERSE, ast_variable_new(), ast_channel_tech::description, chanlist::list, chanlist::tech, ast_channel_tech::type, and var.

00164 {
00165    struct chanlist *cl;
00166    struct ast_variable *var=NULL, *prev = NULL;
00167    AST_LIST_TRAVERSE(&backends, cl, list) {
00168       if (prev)  {
00169          if ((prev->next = ast_variable_new(cl->tech->type, cl->tech->description)))
00170             prev = prev->next;
00171       } else {
00172          var = ast_variable_new(cl->tech->type, cl->tech->description);
00173          prev = var;
00174       }
00175    }
00176    return var;
00177 }

int ast_check_hangup ( struct ast_channel chan  ) 

Check to see if a channel is needing hang up.

Parameters:
chan channel on which to check for hang up This function determines if the channel is being requested to be hung up.
Returns:
Returns 0 if not, or 1 if hang up is requested (including time-out).

Definition at line 385 of file channel.c.

References ast_channel::_softhangup, AST_SOFTHANGUP_TIMEOUT, ast_channel::tech_pvt, and ast_channel::whentohangup.

Referenced by __ast_read(), _macro_exec(), action_redirect(), agent_indicate(), agi_handle_command(), announce_thread(), app_exec(), ast_answer(), ast_bridge_call(), ast_call(), ast_channel_bridge(), ast_check_hangup_locked(), ast_feature_request_and_dial(), ast_indicate_data(), ast_readstring_full(), ast_recvtext(), ast_rtp_bridge(), ast_sendtext(), ast_transfer(), ast_udptl_bridge(), ast_waitfordigit_full(), ast_write(), bridge_native_loop(), channel_spy(), common_exec(), conf_run(), dahdi_sendtext(), dahdi_setoption(), deadagi_exec(), do_atxfer(), handle_request_invite(), handle_sendimage(), pbx_exec(), rpt(), and wait_for_answer().

00386 {
00387    if (chan->_softhangup)     /* yes if soft hangup flag set */
00388       return 1;
00389    if (!chan->tech_pvt)    /* yes if no technology private data */
00390       return 1;
00391    if (!chan->whentohangup)   /* no if no hangup scheduled */
00392       return 0;
00393    if (chan->whentohangup > time(NULL))   /* no if hangup time has not come yet. */
00394       return 0;
00395    chan->_softhangup |= AST_SOFTHANGUP_TIMEOUT; /* record event */
00396    return 1;
00397 }

static int ast_check_hangup_locked ( struct ast_channel chan  )  [static]

Definition at line 399 of file channel.c.

References ast_channel_lock, ast_channel_unlock, and ast_check_hangup().

Referenced by ast_channel_bridge().

00400 {
00401    int res;
00402    ast_channel_lock(chan);
00403    res = ast_check_hangup(chan);
00404    ast_channel_unlock(chan);
00405    return res;
00406 }

void ast_deactivate_generator ( struct ast_channel chan  ) 

Deactive an active generator

Definition at line 1586 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_clear_flag, AST_FLAG_WRITE_INT, AST_GENERATOR_FD, ast_settimeout(), ast_channel::fds, ast_channel::generator, ast_channel::generatordata, and ast_generator::release.

Referenced by __ast_read(), app_exec(), ast_channel_stop_silence_generator(), ast_openstream_full(), ast_playtones_stop(), ast_quiet_chan(), ast_read_generator_actions(), ast_tonepair_stop(), ast_write(), cb_events(), channel_spy(), generator_force(), local_ast_moh_stop(), old_milliwatt_exec(), and wait_for_answer().

01587 {
01588    ast_channel_lock(chan);
01589    if (chan->generatordata) {
01590       if (chan->generator && chan->generator->release)
01591          chan->generator->release(chan, chan->generatordata);
01592       chan->generatordata = NULL;
01593       chan->generator = NULL;
01594       chan->fds[AST_GENERATOR_FD] = -1;
01595       ast_clear_flag(chan, AST_FLAG_WRITE_INT);
01596       ast_settimeout(chan, 0, NULL, NULL);
01597    }
01598    ast_channel_unlock(chan);
01599 }

int ast_do_masquerade ( struct ast_channel original  ) 

Start masquerading a channel XXX This is a seriously wacked out operation. We're essentially putting the guts of the clone channel into the original channel. Start by killing off the original channel's backend. I'm not sure we're going to keep this function, because while the features are nice, the cost is very high in terms of pure nastiness. XXX.

Note:
Assumes channel will be locked when called

Definition at line 3522 of file channel.c.

References ast_channel::_softhangup, ast_channel::_state, ast_channel::adsicpe, ast_channel::alertpipe, ast_app_group_update(), ast_cause2str(), ast_channel_free(), ast_channel_lock, ast_channel_unlock, ast_copy_string(), AST_FLAG_BLOCKING, AST_FLAG_EXCEPTION, AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, AST_GENERATOR_FD, ast_indicate(), AST_LIST_APPEND_LIST, AST_LIST_FIRST, AST_LIST_HEAD_NOLOCK, AST_LIST_HEAD_SET_NOLOCK, AST_LIST_INSERT_TAIL, AST_LIST_REMOVE_HEAD, AST_LIST_TRAVERSE, ast_log(), AST_MAX_FDS, ast_null_frame, ast_queue_frame(), ast_set_flag, ast_set_read_format(), ast_set_write_format(), AST_SOFTHANGUP_DEV, ast_string_field_set, ast_test_flag, AST_TIMING_FD, ast_channel::blocker, ast_channel::cdr, ast_datastore_info::chan_fixup, ast_channel::cid, clone_variables(), ast_datastore::data, ast_channel::datastores, ast_datastore::entry, errno, ast_channel::fdno, ast_channel::fds, ast_channel_tech::fixup, free_translation(), ast_channel_tech::hangup, ast_datastore::info, language, ast_channel::language, ast_channel::lock, LOG_DEBUG, manager_event(), ast_channel::masq, ast_channel::masqr, ast_channel::monitor, musicclass, ast_channel::name, name, ast_channel::nativeformats, option_debug, ast_channel::rawreadformat, ast_channel::rawwriteformat, ast_channel::readformat, ast_channel::readq, t, ast_channel::tech, ast_channel::tech_pvt, ast_channel::timingfd, ast_channel_tech::type, ast_channel::uniqueid, ast_channel::visible_indication, and ast_channel::writeformat.

Referenced by __ast_read(), ast_async_goto(), ast_hangup(), ast_waitfor_nandfds(), ast_write(), iax_park(), sip_park(), and sip_park_thread().

03523 {
03524    int x,i;
03525    int res=0;
03526    int origstate;
03527    struct ast_frame *cur;
03528    const struct ast_channel_tech *t;
03529    void *t_pvt;
03530    struct ast_callerid tmpcid;
03531    struct ast_channel *clone = original->masq;
03532    struct ast_cdr *cdr;
03533    int rformat = original->readformat;
03534    int wformat = original->writeformat;
03535    char newn[100];
03536    char orig[100];
03537    char masqn[100];
03538    char zombn[100];
03539 
03540    if (option_debug > 3)
03541       ast_log(LOG_DEBUG, "Actually Masquerading %s(%d) into the structure of %s(%d)\n",
03542          clone->name, clone->_state, original->name, original->_state);
03543 
03544    /* XXX This is a seriously wacked out operation.  We're essentially putting the guts of
03545       the clone channel into the original channel.  Start by killing off the original
03546       channel's backend.   I'm not sure we're going to keep this function, because
03547       while the features are nice, the cost is very high in terms of pure nastiness. XXX */
03548 
03549    /* We need the clone's lock, too */
03550    ast_channel_lock(clone);
03551 
03552    if (option_debug > 1)
03553       ast_log(LOG_DEBUG, "Got clone lock for masquerade on '%s' at %p\n", clone->name, &clone->lock);
03554 
03555    /* Having remembered the original read/write formats, we turn off any translation on either
03556       one */
03557    free_translation(clone);
03558    free_translation(original);
03559 
03560 
03561    /* Unlink the masquerade */
03562    original->masq = NULL;
03563    clone->masqr = NULL;
03564    
03565    /* Save the original name */
03566    ast_copy_string(orig, original->name, sizeof(orig));
03567    /* Save the new name */
03568    ast_copy_string(newn, clone->name, sizeof(newn));
03569    /* Create the masq name */
03570    snprintf(masqn, sizeof(masqn), "%s<MASQ>", newn);
03571       
03572    /* Copy the name from the clone channel */
03573    ast_string_field_set(original, name, newn);
03574 
03575    /* Mangle the name of the clone channel */
03576    ast_string_field_set(clone, name, masqn);
03577    
03578    /* Notify any managers of the change, first the masq then the other */
03579    manager_event(EVENT_FLAG_CALL, "Rename", "Oldname: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", newn, masqn, clone->uniqueid);
03580    manager_event(EVENT_FLAG_CALL, "Rename", "Oldname: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", orig, newn, original->uniqueid);
03581 
03582    /* Swap the technologies */   
03583    t = original->tech;
03584    original->tech = clone->tech;
03585    clone->tech = t;
03586 
03587    /* Swap the cdrs */
03588    cdr = original->cdr;
03589    original->cdr = clone->cdr;
03590    clone->cdr = cdr;
03591 
03592    t_pvt = original->tech_pvt;
03593    original->tech_pvt = clone->tech_pvt;
03594    clone->tech_pvt = t_pvt;
03595 
03596    /* Swap the alertpipes */
03597    for (i = 0; i < 2; i++) {
03598       x = original->alertpipe[i];
03599       original->alertpipe[i] = clone->alertpipe[i];
03600       clone->alertpipe[i] = x;
03601    }
03602 
03603    /* 
03604     * Swap the readq's.  The end result should be this:
03605     *
03606     *  1) All frames should be on the new (original) channel.
03607     *  2) Any frames that were already on the new channel before this
03608     *     masquerade need to be at the end of the readq, after all of the
03609     *     frames on the old (clone) channel.
03610     *  3) The alertpipe needs to get poked for every frame that was already
03611     *     on the new channel, since we are now using the alert pipe from the
03612     *     old (clone) channel.
03613     */
03614    {
03615       AST_LIST_HEAD_NOLOCK(, ast_frame) tmp_readq;
03616       AST_LIST_HEAD_SET_NOLOCK(&tmp_readq, NULL);
03617 
03618       AST_LIST_APPEND_LIST(&tmp_readq, &original->readq, frame_list);
03619       AST_LIST_APPEND_LIST(&original->readq, &clone->readq, frame_list);
03620 
03621       while ((cur = AST_LIST_REMOVE_HEAD(&tmp_readq, frame_list))) {
03622          AST_LIST_INSERT_TAIL(&original->readq, cur, frame_list);
03623          if (original->alertpipe[1] > -1) {
03624             int poke = 0;
03625 
03626             if (write(original->alertpipe[1], &poke, sizeof(poke)) < 0) {
03627                ast_log(LOG_WARNING, "write() failed: %s\n", strerror(errno));
03628             }
03629          }
03630       }
03631    }
03632 
03633    /* Swap the raw formats */
03634    x = original->rawreadformat;
03635    original->rawreadformat = clone->rawreadformat;
03636    clone->rawreadformat = x;
03637    x = original->rawwriteformat;
03638    original->rawwriteformat = clone->rawwriteformat;
03639    clone->rawwriteformat = x;
03640 
03641    clone->_softhangup = AST_SOFTHANGUP_DEV;
03642 
03643    /* And of course, so does our current state.  Note we need not
03644       call ast_setstate since the event manager doesn't really consider
03645       these separate.  We do this early so that the clone has the proper
03646       state of the original channel. */
03647    origstate = original->_state;
03648    original->_state = clone->_state;
03649    clone->_state = origstate;
03650 
03651    if (clone->tech->fixup){
03652       res = clone->tech->fixup(original, clone);
03653       if (res)
03654          ast_log(LOG_WARNING, "Fixup failed on channel %s, strange things may happen.\n", clone->name);
03655    }
03656 
03657    /* Start by disconnecting the original's physical side */
03658    if (clone->tech->hangup)
03659       res = clone->tech->hangup(clone);
03660    if (res) {
03661       ast_log(LOG_WARNING, "Hangup failed!  Strange things may happen!\n");
03662       ast_channel_unlock(clone);
03663       return -1;
03664    }
03665    
03666    snprintf(zombn, sizeof(zombn), "%s<ZOMBIE>", orig);
03667    /* Mangle the name of the clone channel */
03668    ast_string_field_set(clone, name, zombn);
03669    manager_event(EVENT_FLAG_CALL, "Rename", "Oldname: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", masqn, zombn, clone->uniqueid);
03670 
03671    /* Update the type. */
03672    t_pvt = original->monitor;
03673    original->monitor = clone->monitor;
03674    clone->monitor = t_pvt;
03675    
03676    /* Keep the same language.  */
03677    ast_string_field_set(original, language, clone->language);
03678    /* Copy the FD's other than the generator fd */
03679    for (x = 0; x < AST_MAX_FDS; x++) {
03680       if (x != AST_GENERATOR_FD)
03681          original->fds[x] = clone->fds[x];
03682    }
03683 
03684    ast_app_group_update(clone, original);
03685    /* Move data stores over */
03686    if (AST_LIST_FIRST(&clone->datastores)) {
03687       struct ast_datastore *ds;
03688       AST_LIST_TRAVERSE(&clone->datastores, ds, entry) {
03689          if (ds->info->chan_fixup)
03690             ds->info->chan_fixup(ds->data, clone, original);
03691       }
03692       AST_LIST_APPEND_LIST(&original->datastores, &clone->datastores, entry);
03693    }
03694 
03695    clone_variables(original, clone);
03696    /* Presense of ADSI capable CPE follows clone */
03697    original->adsicpe = clone->adsicpe;
03698    /* Bridge remains the same */
03699    /* CDR fields remain the same */
03700    /* XXX What about blocking, softhangup, blocker, and lock and blockproc? XXX */
03701    /* Application and data remain the same */
03702    /* Clone exception  becomes real one, as with fdno */
03703    ast_set_flag(original, ast_test_flag(clone, AST_FLAG_OUTGOING | AST_FLAG_EXCEPTION));
03704    original->fdno = clone->fdno;
03705    /* Schedule context remains the same */
03706    /* Stream stuff stays the same */
03707    /* Keep the original state.  The fixup code will need to work with it most likely */
03708 
03709    /* Just swap the whole structures, nevermind the allocations, they'll work themselves
03710       out. */
03711    tmpcid = original->cid;
03712    original->cid = clone->cid;
03713    clone->cid = tmpcid;
03714    
03715    /* Restore original timing file descriptor */
03716    original->fds[AST_TIMING_FD] = original->timingfd;
03717    
03718    /* Our native formats are different now */
03719    original->nativeformats = clone->nativeformats;
03720    
03721    /* Context, extension, priority, app data, jump table,  remain the same */
03722    /* pvt switches.  pbx stays the same, as does next */
03723    
03724    /* Set the write format */
03725    ast_set_write_format(original, wformat);
03726 
03727    /* Set the read format */
03728    ast_set_read_format(original, rformat);
03729 
03730    /* Copy the music class */
03731    ast_string_field_set(original, musicclass, clone->musicclass);
03732 
03733    if (option_debug)
03734       ast_log(LOG_DEBUG, "Putting channel %s in %d/%d formats\n", original->name, wformat, rformat);
03735 
03736    /* Okay.  Last thing is to let the channel driver know about all this mess, so he
03737       can fix up everything as best as possible */
03738    if (original->tech->fixup) {
03739       res = original->tech->fixup(clone, original);
03740       if (res) {
03741          ast_log(LOG_WARNING, "Channel for type '%s' could not fixup channel %s\n",
03742             original->tech->type, original->name);
03743          ast_channel_unlock(clone);
03744          return -1;
03745       }
03746    } else
03747       ast_log(LOG_WARNING, "Channel type '%s' does not have a fixup routine (for %s)!  Bad things may happen.\n",
03748          original->tech->type, original->name);
03749 
03750    /* 
03751     * If an indication is currently playing, maintain it on the channel 
03752     * that is taking the place of original 
03753     *
03754     * This is needed because the masquerade is swapping out in the internals
03755     * of this channel, and the new channel private data needs to be made
03756     * aware of the current visible indication (RINGING, CONGESTION, etc.)
03757     */
03758    if (original->visible_indication) {
03759       ast_indicate(original, original->visible_indication);
03760    }
03761    
03762    /* Now, at this point, the "clone" channel is totally F'd up.  We mark it as
03763       a zombie so nothing tries to touch it.  If it's already been marked as a
03764       zombie, then free it now (since it already is considered invalid). */
03765    if (ast_test_flag(clone, AST_FLAG_ZOMBIE)) {
03766       if (option_debug)
03767          ast_log(LOG_DEBUG, "Destroying channel clone '%s'\n", clone->name);
03768       ast_channel_unlock(clone);
03769       manager_event(EVENT_FLAG_CALL, "Hangup",
03770          "Channel: %s\r\n"
03771          "Uniqueid: %s\r\n"
03772          "Cause: %d\r\n"
03773          "Cause-txt: %s\r\n",
03774          clone->name,
03775          clone->uniqueid,
03776          clone->hangupcause,
03777          ast_cause2str(clone->hangupcause)
03778          );
03779       ast_channel_free(clone);
03780    } else {
03781       if (option_debug)
03782          ast_log(LOG_DEBUG, "Released clone lock on '%s'\n", clone->name);
03783       ast_set_flag(clone, AST_FLAG_ZOMBIE);
03784       ast_queue_frame(clone, &ast_null_frame);
03785       ast_channel_unlock(clone);
03786    }
03787    
03788    /* Signal any blocker */
03789    if (ast_test_flag(original, AST_FLAG_BLOCKING))
03790       pthread_kill(original->blocker, SIGURG);
03791    if (option_debug)
03792       ast_log(LOG_DEBUG, "Done Masquerading %s (%d)\n", original->name, original->_state);
03793    return 0;
03794 }

static enum ast_bridge_result ast_generic_bridge ( struct ast_channel c0,
struct ast_channel c1,
struct ast_bridge_config config,
struct ast_frame **  fo,
struct ast_channel **  rc,
struct timeval  bridge_end 
) [static]

Definition at line 3907 of file channel.c.

References AST_BRIDGE_COMPLETE, AST_BRIDGE_DTMF_CHANNEL_0, AST_BRIDGE_DTMF_CHANNEL_1, AST_BRIDGE_RETRY, AST_FEATURE_WARNING_ACTIVE, ast_jb_do_usecheck(), ast_jb_empty_and_reset(), ast_set_flag, ast_tvdiff_ms(), ast_tvnow(), config, f, ast_channel::nativeformats, and ast_channel::tech_pvt.

Referenced by ast_channel_bridge().

03910 {
03911    /* Copy voice back and forth between the two channels. */
03912    struct ast_channel *cs[3];
03913    struct ast_frame *f;
03914    enum ast_bridge_result res = AST_BRIDGE_COMPLETE;
03915    int o0nativeformats;
03916    int o1nativeformats;
03917    int watch_c0_dtmf;
03918    int watch_c1_dtmf;
03919    void *pvt0, *pvt1;
03920    /* Indicates whether a frame was queued into a jitterbuffer */
03921    int frame_put_in_jb = 0;
03922    int jb_in_use;
03923    int to;
03924    
03925    cs[0] = c0;
03926    cs[1] = c1;
03927    pvt0 = c0->tech_pvt;
03928    pvt1 = c1->tech_pvt;
03929    o0nativeformats = c0->nativeformats;
03930    o1nativeformats = c1->nativeformats;
03931    watch_c0_dtmf = config->flags & AST_BRIDGE_DTMF_CHANNEL_0;
03932    watch_c1_dtmf = config->flags & AST_BRIDGE_DTMF_CHANNEL_1;
03933 
03934    /* Check the need of a jitterbuffer for each channel */
03935    jb_in_use = ast_jb_do_usecheck(c0, c1);
03936    if (jb_in_use)
03937       ast_jb_empty_and_reset(c0, c1);
03938 
03939    for (;;) {
03940       struct ast_channel *who, *other;
03941 
03942       if ((c0->tech_pvt != pvt0) || (c1->tech_pvt != pvt1) ||
03943           (o0nativeformats != c0->nativeformats) ||
03944           (o1nativeformats != c1->nativeformats)) {
03945          /* Check for Masquerade, codec changes, etc */
03946          res = AST_BRIDGE_RETRY;
03947          break;
03948       }
03949       if (bridge_end.tv_sec) {
03950          to = ast_tvdiff_ms(bridge_end, ast_tvnow());
03951          if (to <= 0) {
03952             if (config->timelimit) {
03953                res = AST_BRIDGE_RETRY;
03954                /* generic bridge ending to play warning */
03955                ast_set_flag(config, AST_FEATURE_WARNING_ACTIVE);
03956             } else {
03957                res = AST_BRIDGE_COMPLETE;
03958             }
03959             break;
03960          }
03961       } else
03962          to = -1;
03963       /* Calculate the appropriate max sleep interval - in general, this is the time,
03964          left to the closest jb delivery moment */
03965       if (jb_in_use)
03966          to = ast_jb_get_when_to_wakeup(c0, c1, to);
03967       who = ast_waitfor_n(cs, 2, &to);
03968       if (!who) {
03969          /* No frame received within the specified timeout - check if we have to deliver now */
03970          if (jb_in_use)
03971             ast_jb_get_and_deliver(c0, c1);
03972          if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE || c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE) {
03973             if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
03974                c0->_softhangup = 0;
03975             if (c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
03976                c1->_softhangup = 0;
03977             c0->_bridge = c1;
03978             c1->_bridge = c0;
03979          }
03980          continue;
03981       }
03982       f = ast_read(who);
03983       if (!f) {
03984          *fo = NULL;
03985          *rc = who;
03986          if (option_debug)
03987             ast_log(LOG_DEBUG, "Didn't get a frame from channel: %s\n",who->name);
03988          break;
03989       }
03990 
03991       other = (who == c0) ? c1 : c0; /* the 'other' channel */
03992       /* Try add the frame info the who's bridged channel jitterbuff */
03993       if (jb_in_use)
03994          frame_put_in_jb = !ast_jb_put(other, f);
03995 
03996       if ((f->frametype == AST_FRAME_CONTROL) && !(config->flags & AST_BRIDGE_IGNORE_SIGS)) {
03997          int bridge_exit = 0;
03998 
03999          switch (f->subclass) {
04000          case AST_CONTROL_HOLD:
04001          case AST_CONTROL_UNHOLD:
04002          case AST_CONTROL_VIDUPDATE:
04003          case AST_CONTROL_SRCUPDATE:
04004             ast_indicate_data(other, f->subclass, f->data, f->datalen);
04005             if (jb_in_use) {
04006                ast_jb_empty_and_reset(c0, c1);
04007             }
04008             break;
04009          default:
04010             *fo = f;
04011             *rc = who;
04012             bridge_exit = 1;
04013             if (option_debug)
04014                ast_log(LOG_DEBUG, "Got a FRAME_CONTROL (%d) frame on channel %s\n", f->subclass, who->name);
04015             break;
04016          }
04017          if (bridge_exit)
04018             break;
04019       }
04020       if ((f->frametype == AST_FRAME_VOICE) ||
04021           (f->frametype == AST_FRAME_DTMF_BEGIN) ||
04022           (f->frametype == AST_FRAME_DTMF) ||
04023           (f->frametype == AST_FRAME_VIDEO) ||
04024           (f->frametype == AST_FRAME_IMAGE) ||
04025           (f->frametype == AST_FRAME_HTML) ||
04026           (f->frametype == AST_FRAME_MODEM) ||
04027           (f->frametype == AST_FRAME_TEXT)) {
04028          /* monitored dtmf causes exit from bridge */
04029          int monitored_source = (who == c0) ? watch_c0_dtmf : watch_c1_dtmf;
04030 
04031          if (monitored_source && 
04032             (f->frametype == AST_FRAME_DTMF_END || 
04033             f->frametype == AST_FRAME_DTMF_BEGIN)) {
04034             *fo = f;
04035             *rc = who;
04036             if (option_debug)
04037                ast_log(LOG_DEBUG, "Got DTMF %s on channel (%s)\n", 
04038                   f->frametype == AST_FRAME_DTMF_END ? "end" : "begin",
04039                   who->name);
04040 
04041             break;
04042          }
04043          /* Write immediately frames, not passed through jb */
04044          if (!frame_put_in_jb)
04045             ast_write(other, f);
04046             
04047          /* Check if we have to deliver now */
04048          if (jb_in_use)
04049             ast_jb_get_and_deliver(c0, c1);
04050       }
04051       /* XXX do we want to pass on also frames not matched above ? */
04052       ast_frfree(f);
04053 
04054       /* Swap who gets priority */
04055       cs[2] = cs[0];
04056       cs[0] = cs[1];
04057       cs[1] = cs[2];
04058    }
04059    return res;
04060 }

struct ast_channel* ast_get_channel_by_exten_locked ( const char *  exten,
const char *  context 
)

Get channel by exten (and optionally context) and lock it.

Definition at line 1160 of file channel.c.

References channel_find_locked().

01161 {
01162    return channel_find_locked(NULL, NULL, 0, context, exten);
01163 }

struct ast_channel* ast_get_channel_by_name_locked ( const char *  name  ) 

Get channel by name (locks channel).

Definition at line 1141 of file channel.c.

References channel_find_locked().

Referenced by action_atxfer(), action_getvar(), action_hangup(), action_redirect(), action_setcdruserfield(), action_setvar(), action_status(), action_timeout(), ast_async_goto_by_name(), ast_bridge_call(), asyncgoto_exec(), change_monitor_action(), do_pause_or_unpause(), get_zap_channel_locked(), handle_channelstatus(), handle_core_set_debug_channel(), handle_debugchan_deprecated(), handle_getvariablefull(), handle_hangup(), handle_nodebugchan_deprecated(), handle_showchan(), handle_showchan_deprecated(), handle_softhangup(), manager_park(), manager_play_dtmf(), park_call_full(), pbx_builtin_importvar(), start_monitor_action(), and stop_monitor_action().

01142 {
01143    return channel_find_locked(NULL, name, 0, NULL, NULL);
01144 }

struct ast_channel* ast_get_channel_by_name_prefix_locked ( const char *  name,
const int  namelen 
)

Get channel by name prefix (locks channel).

Definition at line 1147 of file channel.c.

References channel_find_locked().

Referenced by ast_parse_device_state(), common_exec(), and mixmonitor_cli().

01148 {
01149    return channel_find_locked(NULL, name, namelen, NULL, NULL);
01150 }

struct ast_channel_tech* ast_get_channel_tech ( const char *  name  ) 

Get a channel technology structure by name.

Parameters:
name name of technology to find
Returns:
a pointer to the structure, or NULL if no matching technology found

Definition at line 552 of file channel.c.

References AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), chanlist::list, LOG_WARNING, chanlist::tech, and ast_channel_tech::type.

Referenced by ast_device_state().

00553 {
00554    struct chanlist *chanls;
00555    const struct ast_channel_tech *ret = NULL;
00556 
00557    if (AST_LIST_LOCK(&channels)) {
00558       ast_log(LOG_WARNING, "Unable to lock channel tech list\n");
00559       return NULL;
00560    }
00561 
00562    AST_LIST_TRAVERSE(&backends, chanls, list) {
00563       if (!strcasecmp(name, chanls->tech->type)) {
00564          ret = chanls->tech;
00565          break;
00566       }
00567    }
00568 
00569    AST_LIST_UNLOCK(&channels);
00570    
00571    return ret;
00572 }

ast_group_t ast_get_group ( const char *  s  ) 

Definition at line 4514 of file channel.c.

References ast_log(), ast_strdupa, ast_strlen_zero(), group, and LOG_ERROR.

Referenced by _parse(), build_device(), build_gateway(), build_peer(), build_user(), func_channel_write(), process_dahdi(), and read_agent_config().

04515 {
04516    char *piece;
04517    char *c;
04518    int start=0, finish=0, x;
04519    ast_group_t group = 0;
04520 
04521    if (ast_strlen_zero(s))
04522       return 0;
04523 
04524    c = ast_strdupa(s);
04525    
04526    while ((piece = strsep(&c, ","))) {
04527       if (sscanf(piece, "%d-%d", &start, &finish) == 2) {
04528          /* Range */
04529       } else if (sscanf(piece, "%d", &start)) {
04530          /* Just one */
04531          finish = start;
04532       } else {
04533          ast_log(LOG_ERROR, "Syntax error parsing group configuration '%s' at '%s'. Ignoring.\n", s, piece);
04534          continue;
04535       }
04536       for (x = start; x <= finish; x++) {
04537          if ((x > 63) || (x < 0)) {
04538             ast_log(LOG_WARNING, "Ignoring invalid group %d (maximum group is 63)\n", x);
04539          } else
04540             group |= ((ast_group_t) 1 << x);
04541       }
04542    }
04543    return group;
04544 }

int ast_hangup ( struct ast_channel chan  ) 

Hang up a channel.

Note:
This function performs a hard hangup on a channel. Unlike the soft-hangup, this function performs all stream stopping, etc, on the channel that needs to end. chan is no longer valid after this call.
Parameters:
chan channel to hang up
Returns:
Returns 0 on success, -1 on failure.

Definition at line 1459 of file channel.c.

References ast_assert, ast_audiohook_detach_list(), ast_autoservice_stop(), ast_cause2str(), ast_cdr_detach(), ast_cdr_end(), AST_CDR_FLAG_BRIDGED, AST_CDR_FLAG_DIALED, AST_CDR_FLAG_POST_DISABLED, AST_CDR_NULL, ast_channel_free(), ast_channel_lock, ast_channel_unlock, ast_closestream(), ast_do_masquerade(), AST_FLAG_BLOCKING, AST_FLAG_ZOMBIE, ast_log(), ast_set_flag, ast_test_flag, ast_channel::audiohooks, ast_channel::blocker, ast_channel::blockproc, ast_channel::cdr, ast_cdr::disposition, free_translation(), ast_channel::generator, ast_channel::generatordata, ast_channel_tech::hangup, ast_channel::hangupcause, LOG_DEBUG, manager_event(), ast_channel::masq, ast_channel::masqr, ast_channel::name, option_debug, ast_generator::release, ast_channel::sched, sched_context_destroy(), ast_channel::stream, ast_channel::tech, ast_channel::uniqueid, and ast_channel::vstream.

Referenced by __ast_request_and_dial(), __oh323_new(), agent_hangup(), agent_read(), alsa_new(), answer_exec_run(), app_exec(), ast_async_goto(), ast_bridge_call_thread(), ast_dial_destroy(), ast_dial_hangup(), ast_feature_request_and_dial(), ast_iax2_new(), ast_pbx_outgoing_app(), ast_pbx_outgoing_exten(), ast_pbx_run_app(), async_wait(), begin_dial(), build_conf(), chanavail_exec(), check_compat(), check_goto_on_transfer(), clear_caller(), conf_run(), connect_link(), dahdi_handle_event(), dahdi_new(), do_atxfer(), do_hang(), do_idle_thread(), do_parking_thread(), features_hangup(), findmeexec(), gtalk_new(), handle_enbloc_call_message(), handle_frame(), handle_frame_ownerless(), handle_hd_hf(), handle_init_event(), handle_invite_replaces(), handle_offhook_message(), handle_request_invite(), handle_soft_key_event_message(), handle_stimulus_message(), hangup_chan(), hangupcalls(), hanguptree(), iax2_request(), iax_park(), iax_park_thread(), local_attended_transfer(), local_hangup(), masq_park_call(), mgcp_new(), mgcp_ss(), monitor_dial(), nbs_new(), oss_new(), park_exec(), parkandannounce_exec(), phone_new(), rpt(), rpt_call(), rpt_tele_thread(), sip_new(), sip_park(), sip_park_thread(), skinny_new(), skinny_ss(), ss_thread(), try_calling(), wait_for_answer(), and wait_for_winner().

01460 {
01461    int res = 0;
01462 
01463    /* Don't actually hang up a channel that will masquerade as someone else, or
01464       if someone is going to masquerade as us */
01465    ast_channel_lock(chan);
01466 
01467    if (chan->audiohooks) {
01468       ast_audiohook_detach_list(chan->audiohooks);
01469       chan->audiohooks = NULL;
01470    }
01471 
01472    ast_autoservice_stop(chan);
01473 
01474    if (chan->masq) {
01475       if (ast_do_masquerade(chan))
01476          ast_log(LOG_WARNING, "Failed to perform masquerade\n");
01477    }
01478 
01479    if (chan->masq) {
01480       ast_log(LOG_WARNING, "%s getting hung up, but someone is trying to masq into us?!?\n", chan->name);
01481       ast_channel_unlock(chan);
01482       return 0;
01483    }
01484    /* If this channel is one which will be masqueraded into something,
01485       mark it as a zombie already, so we know to free it later */
01486    if (chan->masqr) {
01487       ast_set_flag(chan, AST_FLAG_ZOMBIE);
01488       ast_channel_unlock(chan);
01489       return 0;
01490    }
01491    free_translation(chan);
01492    /* Close audio stream */
01493    if (chan->stream) {
01494       ast_closestream(chan->stream);
01495       chan->stream = NULL;
01496    }
01497    /* Close video stream */
01498    if (chan->vstream) {
01499       ast_closestream(chan->vstream);
01500       chan->vstream = NULL;
01501    }
01502    if (chan->sched) {
01503       sched_context_destroy(chan->sched);
01504       chan->sched = NULL;
01505    }
01506    
01507    if (chan->generatordata)   /* Clear any tone stuff remaining */
01508       chan->generator->release(chan, chan->generatordata);
01509    chan->generatordata = NULL;
01510    chan->generator = NULL;
01511    if (ast_test_flag(chan, AST_FLAG_BLOCKING)) {
01512       ast_log(LOG_WARNING, "Hard hangup called by thread %ld on %s, while fd "
01513                "is blocked by thread %ld in procedure %s!  Expect a failure\n",
01514                (long)pthread_self(), chan->name, (long)chan->blocker, chan->blockproc);
01515       ast_assert(ast_test_flag(chan, AST_FLAG_BLOCKING) == 0);
01516    }
01517    if (!ast_test_flag(chan, AST_FLAG_ZOMBIE)) {
01518       if (option_debug)
01519          ast_log(LOG_DEBUG, "Hanging up channel '%s'\n", chan->name);
01520       if (chan->tech->hangup)
01521          res = chan->tech->hangup(chan);
01522    } else {
01523       if (option_debug)
01524          ast_log(LOG_DEBUG, "Hanging up zombie '%s'\n", chan->name);
01525    }
01526          
01527    ast_channel_unlock(chan);
01528    manager_event(EVENT_FLAG_CALL, "Hangup",
01529          "Channel: %s\r\n"
01530          "Uniqueid: %s\r\n"
01531          "Cause: %d\r\n"
01532          "Cause-txt: %s\r\n",
01533          chan->name,
01534          chan->uniqueid,
01535          chan->hangupcause,
01536          ast_cause2str(chan->hangupcause)
01537          );
01538 
01539    if (chan->cdr && !ast_test_flag(chan->cdr, AST_CDR_FLAG_BRIDGED) && 
01540       !ast_test_flag(chan->cdr, AST_CDR_FLAG_POST_DISABLED) && 
01541        (chan->cdr->disposition != AST_CDR_NULL || ast_test_flag(chan->cdr, AST_CDR_FLAG_DIALED))) {
01542          
01543       ast_cdr_end(chan->cdr);
01544       ast_cdr_detach(chan->cdr);
01545       chan->cdr = NULL;
01546    }
01547    
01548    ast_channel_free(chan);
01549 
01550    return res;
01551 }

int ast_indicate ( struct ast_channel chan,
int  condition 
)

Indicates condition of channel.

Note:
Indicate a condition such as AST_CONTROL_BUSY, AST_CONTROL_RINGING, or AST_CONTROL_CONGESTION on a channel
Parameters:
chan channel to change the indication
condition which condition to indicate on the channel
Returns:
Returns 0 on success, -1 on failure

Definition at line 2459 of file channel.c.

References ast_indicate_data().

Referenced by __ast_play_and_record(), agent_new(), answer_trunk_chan(), ast_answer(), ast_bridge_call(), ast_channel_bridge(), ast_do_masquerade(), ast_dtmf_stream(), ast_feature_request_and_dial(), attempt_transfer(), builtin_blindtransfer(), conf_run(), disa_exec(), do_atxfer(), do_parking_thread(), features_indicate(), finishup(), function_remote(), handle_frame(), handle_recordfile(), mgcp_ss(), monitor_dial(), park_exec(), pbx_builtin_busy(), pbx_builtin_congestion(), pbx_builtin_progress(), pbx_builtin_ringing(), pbx_builtin_waitexten(), queue_exec(), rpt(), send_waveform_to_channel(), skinny_ss(), sla_handle_hold_event(), sla_station_exec(), sla_trunk_exec(), and wait_for_answer().

02460 {
02461    return ast_indicate_data(chan, condition, NULL, 0);
02462 }

int ast_indicate_data ( struct ast_channel chan,
int  condition,
const void *  data,
size_t  datalen 
)

Indicates condition of channel, with payload.

Note:
Indicate a condition such as AST_CONTROL_BUSY, AST_CONTROL_RINGING, or AST_CONTROL_CONGESTION on a channel
Parameters:
chan channel to change the indication
condition which condition to indicate on the channel
data pointer to payload data
datalen size of payload data
Returns:
Returns 0 on success, -1 on failure

Note:
If we compare the enumeration type, which does not have any negative constants, the compiler may optimize this code away. Therefore, we must perform an integer comparison here.

Definition at line 2497 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_check_hangup(), AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_OFFHOOK, AST_CONTROL_OPTION, AST_CONTROL_PROCEEDING, AST_CONTROL_PROGRESS, AST_CONTROL_RADIO_KEY, AST_CONTROL_RADIO_UNKEY, AST_CONTROL_RING, AST_CONTROL_RINGING, AST_CONTROL_SRCUPDATE, AST_CONTROL_TAKEOFFHOOK, AST_CONTROL_UNHOLD, AST_CONTROL_VIDUPDATE, AST_CONTROL_WINK, AST_FLAG_ZOMBIE, ast_get_indication_tone(), ast_log(), ast_playtones_start(), ast_playtones_stop(), ast_test_flag, tone_zone_sound::data, ast_channel_tech::indicate, is_visible_indication(), LOG_DEBUG, ast_channel::name, option_debug, ast_channel::tech, ast_channel::visible_indication, and ast_channel::zone.

Referenced by __login_exec(), agent_hangup(), ast_bridge_call(), ast_indicate(), bridge_native_loop(), do_parking_thread(), park_call_full(), pbx_builtin_waitexten(), and wait_for_answer().

02499 {
02500    /* By using an enum, we'll get compiler warnings for values not handled 
02501     * in switch statements. */
02502    enum ast_control_frame_type condition = _condition;
02503    const struct tone_zone_sound *ts = NULL;
02504    int res = -1;
02505 
02506    ast_channel_lock(chan);
02507 
02508    /* Don't bother if the channel is about to go away, anyway. */
02509    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) {
02510       ast_channel_unlock(chan);
02511       return -1;
02512    }
02513 
02514    if (chan->tech->indicate) {
02515       /* See if the channel driver can handle this condition. */
02516       res = chan->tech->indicate(chan, condition, data, datalen);
02517    }
02518 
02519    ast_channel_unlock(chan);
02520 
02521    if (chan->tech->indicate && !res) {
02522       /* The channel driver successfully handled this indication */
02523       if (is_visible_indication(condition)) {
02524          chan->visible_indication = condition;
02525       }
02526       return 0;
02527    }
02528 
02529    /* The channel driver does not support this indication, let's fake
02530     * it by doing our own tone generation if applicable. */
02531 
02532    /*!\note If we compare the enumeration type, which does not have any
02533     * negative constants, the compiler may optimize this code away.
02534     * Therefore, we must perform an integer comparison here. */
02535    if (_condition < 0) {
02536       /* Stop any tones that are playing */
02537       ast_playtones_stop(chan);
02538       return 0;
02539    }
02540 
02541    /* Handle conditions that we have tones for. */
02542    switch (condition) {
02543    case AST_CONTROL_RINGING:
02544       ts = ast_get_indication_tone(chan->zone, "ring");
02545       break;
02546    case AST_CONTROL_BUSY:
02547       ts = ast_get_indication_tone(chan->zone, "busy");
02548       break;
02549    case AST_CONTROL_CONGESTION:
02550       ts = ast_get_indication_tone(chan->zone, "congestion");
02551       break;
02552    case AST_CONTROL_PROGRESS:
02553    case AST_CONTROL_PROCEEDING:
02554    case AST_CONTROL_VIDUPDATE:
02555    case AST_CONTROL_SRCUPDATE:
02556    case AST_CONTROL_RADIO_KEY:
02557    case AST_CONTROL_RADIO_UNKEY:
02558    case AST_CONTROL_OPTION:
02559    case AST_CONTROL_WINK:
02560    case AST_CONTROL_FLASH:
02561    case AST_CONTROL_OFFHOOK:
02562    case AST_CONTROL_TAKEOFFHOOK:
02563    case AST_CONTROL_ANSWER:
02564    case AST_CONTROL_HANGUP:
02565    case AST_CONTROL_RING:
02566    case AST_CONTROL_HOLD:
02567    case AST_CONTROL_UNHOLD:
02568       /* Nothing left to do for these. */
02569       res = 0;
02570       break;
02571    }
02572 
02573    if (ts && ts->data[0]) {
02574       /* We have a tone to play, yay. */
02575       if (option_debug) {
02576             ast_log(LOG_DEBUG, "Driver for channel '%s' does not support indication %d, emulating it\n", chan->name, condition);
02577       }
02578       ast_playtones_start(chan, 0, ts->data, 1);
02579       res = 0;
02580       chan->visible_indication = condition;
02581    }
02582 
02583    if (res) {
02584       /* not handled */
02585       ast_log(LOG_WARNING, "Unable to handle indication %d for '%s'\n", condition, chan->name);
02586    }
02587 
02588    return res;
02589 }

void ast_install_music_functions ( int(*)(struct ast_channel *, const char *, const char *)  start_ptr,
void(*)(struct ast_channel *)  stop_ptr,
void(*)(struct ast_channel *)  cleanup_ptr 
)

Definition at line 4550 of file channel.c.

References ast_moh_cleanup_ptr, ast_moh_start_ptr, and ast_moh_stop_ptr.

Referenced by load_module(), and reload().

04553 {
04554    ast_moh_start_ptr = start_ptr;
04555    ast_moh_stop_ptr = stop_ptr;
04556    ast_moh_cleanup_ptr = cleanup_ptr;
04557 }

int ast_internal_timing_enabled ( struct ast_channel chan  ) 

Check if the channel can run in internal timing mode.

Parameters:
chan The channel to check
Returns:
boolean
This function will return 1 if internal timing is enabled and the timing device is available.

Definition at line 2441 of file channel.c.

References ast_log(), ast_opt_internal_timing, LOG_DEBUG, option_debug, and ast_channel::timingfd.

Referenced by add_sdp(), and ast_read_generator_actions().

02442 {
02443    int ret = ast_opt_internal_timing && chan->timingfd > -1;
02444    if (option_debug > 4)
02445       ast_log(LOG_DEBUG, "Internal timing is %s (option_internal_timing=%d chan->timingfd=%d)\n", ret? "enabled": "disabled", ast_opt_internal_timing, chan->timingfd);
02446    return ret;
02447 }

void ast_moh_cleanup ( struct ast_channel chan  ) 

Definition at line 4587 of file channel.c.

References ast_moh_cleanup_ptr.

Referenced by ast_channel_free().

04588 {
04589    if (ast_moh_cleanup_ptr)
04590       ast_moh_cleanup_ptr(chan);
04591 }

int ast_moh_start ( struct ast_channel chan,
const char *  mclass,
const char *  interpclass 
)

Turn on music on hold on a given channel.

Parameters:
chan The channel structure that will get music on hold
mclass The class to use if the musicclass is not currently set on the channel structure.
interpclass The class to use if the musicclass is not currently set on the channel structure or in the mclass argument.
Return values:
0 success
non-zero failure

Definition at line 4567 of file channel.c.

References ast_moh_start_ptr, ast_verbose(), option_verbose, and VERBOSE_PREFIX_3.

Referenced by alsa_indicate(), app_exec(), cb_events(), conf_run(), dahdi_indicate(), feature_exec_app(), gtalk_indicate(), handle_setmusic(), iax2_indicate(), local_indicate(), mgcp_indicate(), misdn_indication(), moh0_exec(), moh1_exec(), moh3_exec(), oh323_indicate(), oss_indicate(), phone_indicate(), queue_exec(), retrydial_exec(), say_periodic_announcement(), say_position(), sip_indicate(), and skinny_indicate().

04568 {
04569    if (ast_moh_start_ptr)
04570       return ast_moh_start_ptr(chan, mclass, interpclass);
04571 
04572    if (option_verbose > 2) {
04573       ast_verbose(VERBOSE_PREFIX_3 "Music class %s requested but no musiconhold loaded.\n", 
04574          mclass ? mclass : (interpclass ? interpclass : "default"));
04575    }
04576 
04577    return 0;
04578 }

void ast_moh_stop ( struct ast_channel chan  ) 

Turn off music on hold on a given channel.

Turn off music on hold on a given channel

Definition at line 4581 of file channel.c.

References ast_moh_stop_ptr.

Referenced by alsa_indicate(), app_exec(), ast_quiet_chan(), cb_events(), conf_run(), dahdi_indicate(), feature_exec_app(), gtalk_indicate(), handle_setmusic(), iax2_indicate(), local_indicate(), mgcp_indicate(), misdn_indication(), misdn_transfer_bc(), moh0_exec(), moh1_exec(), moh4_exec(), oh323_indicate(), oss_indicate(), phone_indicate(), queue_exec(), retrydial_exec(), say_periodic_announcement(), say_position(), sip_indicate(), skinny_indicate(), and try_calling().

04582 {
04583    if (ast_moh_stop_ptr)
04584       ast_moh_stop_ptr(chan);
04585 }

char* ast_print_group ( char *  buf,
int  buflen,
ast_group_t  group 
)

print call- and pickup groups into buffer

Definition at line 4599 of file channel.c.

References first.

Referenced by _sip_show_peer(), func_channel_read(), misdn_cfg_get_config_string(), print_group(), read_config(), and serialize_showchan().

04600 {
04601    unsigned int i;
04602    int first=1;
04603    char num[3];
04604 
04605    buf[0] = '\0';
04606    
04607    if (!group) /* Return empty string if no group */
04608       return buf;
04609 
04610    for (i = 0; i <= 63; i++) {   /* Max group is 63 */
04611       if (group & ((ast_group_t) 1 << i)) {
04612             if (!first) {
04613             strncat(buf, ", ", buflen - strlen(buf) - 1);
04614          } else {
04615             first=0;
04616          }
04617          snprintf(num, sizeof(num), "%u", i);
04618          strncat(buf, num, buflen - strlen(buf) - 1);
04619       }
04620    }
04621    return buf;
04622 }

int ast_prod ( struct ast_channel chan  ) 

Send empty audio to prime a channel driver.

Definition at line 2711 of file channel.c.

References ast_channel::_state, AST_FRAME_VOICE, AST_FRIENDLY_OFFSET, ast_log(), AST_STATE_UP, ast_write(), ast_frame::data, LOG_DEBUG, ast_channel::name, option_debug, ast_channel::rawwriteformat, ast_frame::src, and ast_frame::subclass.

Referenced by ast_activate_generator().

02712 {
02713    struct ast_frame a = { AST_FRAME_VOICE };
02714    char nothing[128];
02715 
02716    /* Send an empty audio frame to get things moving */
02717    if (chan->_state != AST_STATE_UP) {
02718       if (option_debug)
02719          ast_log(LOG_DEBUG, "Prodding channel '%s'\n", chan->name);
02720       a.subclass = chan->rawwriteformat;
02721       a.data = nothing + AST_FRIENDLY_OFFSET;
02722       a.src = "ast_prod";
02723       if (ast_write(chan, &a))
02724          ast_log(LOG_WARNING, "Prodding channel '%s' failed\n", chan->name);
02725    }
02726    return 0;
02727 }

int ast_queue_control ( struct ast_channel chan,
enum ast_control_frame_type  control 
)

Queue a control frame with payload.

Parameters:
chan channel to queue frame onto
control type of control frame
Returns:
zero on success, non-zero on failure

Definition at line 984 of file channel.c.

References AST_FRAME_CONTROL, ast_queue_frame(), and f.

Referenced by __dahdi_exception(), __oh323_update_info(), ast_pickup_call(), attempt_transfer(), auto_congest(), cb_events(), dahdi_handle_event(), dahdi_hangup(), gtalk_is_answered(), gtalk_ringing_ack(), handle_hd_hf(), handle_offhook_message(), handle_request(), handle_request_bye(), handle_request_info(), handle_request_invite(), handle_request_refer(), handle_response(), handle_response_invite(), handle_response_refer(), handle_soft_key_event_message(), handle_stimulus_message(), mgcp_call(), nbs_call(), phone_call(), pickup_do(), process_sdp(), receive_digit(), send_cause2ast(), setup_rtp_connection(), skinny_call(), skinny_unhold(), ss_thread(), and update_state().

00985 {
00986    struct ast_frame f = { AST_FRAME_CONTROL, };
00987 
00988    f.subclass = control;
00989 
00990    return ast_queue_frame(chan, &f);
00991 }

int ast_queue_control_data ( struct ast_channel chan,
enum ast_control_frame_type  control,
const void *  data,
size_t  datalen 
)

Queue a control frame with payload.

Parameters:
chan channel to queue frame onto
control type of control frame
data pointer to payload data to be included in frame
datalen number of bytes of payload data
Returns:
zero on success, non-zero on failure
The supplied payload data is copied into the frame, so the caller's copy is not modified nor freed, and the resulting frame will retain a copy of the data even if the caller frees their local copy.

Note:
This method should be treated as a 'network transport'; in other words, your frames may be transferred across an IAX2 channel to another system, which may be a different endianness than yours. Because of this, you should ensure that either your frames will never be expected to work across systems, or that you always put your payload data into 'network byte order' before calling this function.

Definition at line 994 of file channel.c.

References AST_FRAME_CONTROL, ast_queue_frame(), and f.

Referenced by action_atxfer(), dahdi_handle_event(), dahdi_hangup(), iax2_queue_control_data(), process_sdp(), and skinny_hold().

00996 {
00997    struct ast_frame f = { AST_FRAME_CONTROL, };
00998 
00999    f.subclass = control;
01000    f.data = (void *) data;
01001    f.datalen = datalen;
01002 
01003    return ast_queue_frame(chan, &f);
01004 }

int ast_queue_frame ( struct ast_channel chan,
struct ast_frame fin 
)

Queue an outgoing frame.

Definition at line 961 of file channel.c.

References __ast_queue_frame().

Referenced by __oh323_rtp_create(), __oh323_update_info(), agent_new(), alsa_call(), ast_channel_masquerade(), ast_channel_setwhentohangup(), ast_do_masquerade(), ast_dsp_process(), ast_queue_control(), ast_queue_control_data(), ast_queue_hangup(), ast_softhangup_nolock(), cb_events(), console_answer(), console_answer_deprecated(), console_dial(), console_dial_deprecated(), console_flash(), console_flash_deprecated(), console_sendtext(), console_sendtext_deprecated(), dahdi_queue_frame(), dictate_exec(), do_immediate_setup(), gtalk_handle_dtmf(), handle_keypad_button_message(), handle_request_info(), handle_request_invite(), handle_response_invite(), iax2_queue_frame(), local_queue_frame(), mgcp_queue_frame(), oh323_simulate_dtmf_end(), oss_call(), process_sdp(), queue_dtmf_readq(), receive_digit(), receive_message(), rpt_call(), and wakeup_sub().

00962 {
00963    return __ast_queue_frame(chan, fin, 0);
00964 }

int ast_queue_frame_head ( struct ast_channel chan,
struct ast_frame f 
)

Queue an outgoing frame to the head of the frame queue.

Parameters:
chan the channel to queue the frame on
f the frame to queue. Note that this frame will be duplicated by this function. It is the responsibility of the caller to handle freeing the memory associated with the frame being passed if necessary.
Return values:
0 success
non-zero failure

Definition at line 966 of file channel.c.

References __ast_queue_frame().

Referenced by ast_autoservice_stop().

00967 {
00968    return __ast_queue_frame(chan, fin, 1);
00969 }

int ast_queue_hangup ( struct ast_channel chan  ) 

Queue a hangup frame.

Definition at line 972 of file channel.c.

References ast_channel::_softhangup, ast_channel_trylock, ast_channel_unlock, AST_CONTROL_HANGUP, AST_FRAME_CONTROL, ast_queue_frame(), AST_SOFTHANGUP_DEV, and f.

Referenced by __oh323_update_info(), __sip_autodestruct(), cleanup_connection(), console_hangup(), console_hangup_deprecated(), dahdi_handle_event(), gtalk_hangup_farend(), gtalk_is_answered(), handle_onhook_message(), handle_request_bye(), handle_request_cancel(), handle_response(), handle_response_invite(), handle_soft_key_event_message(), hangup_chan(), hangup_connection(), iax2_destroy(), iax2_queue_hangup(), local_hangup(), mgcp_queue_hangup(), misdn_answer(), pri_hangup_all(), and retrans_pkt().

00973 {
00974    struct ast_frame f = { AST_FRAME_CONTROL, AST_CONTROL_HANGUP };
00975    /* Yeah, let's not change a lock-critical value without locking */
00976    if (!ast_channel_trylock(chan)) {
00977       chan->_softhangup |= AST_SOFTHANGUP_DEV;
00978       ast_channel_unlock(chan);
00979    }
00980    return ast_queue_frame(chan, &f);
00981 }

struct ast_frame* ast_read ( struct ast_channel chan  ) 

Reads a frame.

Parameters:
chan channel to read a frame from Read a frame.
Returns:
Returns a frame, or NULL on error. If it returns NULL, you best just stop reading frames and assume the channel has been disconnected.

Definition at line 2449 of file channel.c.

References __ast_read().

Referenced by __adsi_transmit_messages(), __ast_play_and_record(), __ast_request_and_dial(), adsi_careful_send(), agent_ack_sleep(), agent_read(), app_exec(), ast_feature_request_and_dial(), ast_recvtext(), ast_safe_sleep_conditional(), ast_tonepair(), ast_udptl_bridge(), ast_waitfordigit_full(), async_wait(), autoservice_run(), background_detect_exec(), bridge_native_loop(), bridge_p2p_loop(), channel_spy(), check_goto_on_transfer(), conf_exec(), conf_flush(), conf_run(), dahdi_bridge(), dictate_exec(), disa_exec(), do_atxfer(), do_idle_thread(), do_parking_thread(), do_waiting(), echo_exec(), features_read(), find_cache(), handle_invite_replaces(), handle_recordfile(), iax_park_thread(), ices_exec(), isAnsweringMachine(), masq_park_call(), measurenoise(), misdn_bridge(), monitor_dial(), mp3_exec(), NBScat_exec(), receive_dtmf_digits(), recordthread(), rpt(), run_agi(), send_tone_burst(), send_waveform_to_channel(), sendurl_exec(), speech_background(), ss_thread(), wait_for_answer(), wait_for_hangup(), wait_for_winner(), waitforring_exec(), and waitstream_core().

02450 {
02451    return __ast_read(chan, 0);
02452 }

static void ast_read_generator_actions ( struct ast_channel chan,
struct ast_frame f 
) [static]

Definition at line 1934 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_deactivate_generator(), ast_format_rate(), AST_FRAME_CNG, ast_internal_timing_enabled(), ast_log(), ast_settimeout(), f, ast_generator::generate, ast_channel::generator, generator_force(), ast_channel::generatordata, LOG_DEBUG, option_debug, ast_channel::timingfd, ast_channel::timingfunc, and ast_channel::writeformat.

Referenced by __ast_read().

01935 {
01936    if (chan->generatordata &&  !ast_internal_timing_enabled(chan)) {
01937       void *tmp = chan->generatordata;
01938       int (*generate)(struct ast_channel *chan, void *tmp, int datalen, int samples) = NULL;
01939       int res;
01940       int samples;
01941 
01942       if (chan->timingfunc) {
01943          if (option_debug > 1)
01944             ast_log(LOG_DEBUG, "Generator got voice, switching to phase locked mode\n");
01945          ast_settimeout(chan, 0, NULL, NULL);
01946       }
01947 
01948       chan->generatordata = NULL;     /* reset, to let writes go through */
01949 
01950       if (f->subclass != chan->writeformat) {
01951          float factor;
01952          factor = ((float) ast_format_rate(chan->writeformat)) / ((float) ast_format_rate(f->subclass));
01953          samples = (int) ( ((float) f->samples) * factor );
01954       } else {
01955          samples = f->samples;
01956       }
01957 
01958       if (chan->generator->generate) {
01959          generate = chan->generator->generate;
01960       }
01961       /* This unlock is here based on two assumptions that hold true at this point in the
01962        * code. 1) this function is only called from within __ast_read() and 2) all generators
01963        * call ast_write() in their generate callback.
01964        *
01965        * The reason this is added is so that when ast_write is called, the lock that occurs 
01966        * there will not recursively lock the channel. Doing this will cause intended deadlock 
01967        * avoidance not to work in deeper functions
01968        */
01969       ast_channel_unlock(chan);
01970       res = generate(chan, tmp, f->datalen, samples);
01971       ast_channel_lock(chan);
01972       chan->generatordata = tmp;
01973       if (res) {
01974          if (option_debug > 1)
01975             ast_log(LOG_DEBUG, "Auto-deactivating generator\n");
01976          ast_deactivate_generator(chan);
01977       }
01978 
01979    } else if (f->frametype == AST_FRAME_CNG) {
01980       if (chan->generator && !chan->timingfunc && (chan->timingfd > -1)) {
01981          if (option_debug > 1)
01982             ast_log(LOG_DEBUG, "Generator got CNG, switching to timed mode\n");
01983          ast_settimeout(chan, 160, generator_force, chan);
01984       }
01985    }
01986 }

struct ast_frame* ast_read_noaudio ( struct ast_channel chan  ) 

Reads a frame, returning AST_FRAME_NULL frame if audio. Read a frame.

Parameters:
chan channel to read a frame from
Returns:
Returns a frame, or NULL on error. If it returns NULL, you best just stop reading frames and assume the channel has been disconnected.
Note:
Audio is replaced with AST_FRAME_NULL to avoid transcode when the resulting audio is not necessary.

Definition at line 2454 of file channel.c.

References __ast_read().

Referenced by conf_run().

02455 {
02456    return __ast_read(chan, 1);
02457 }

int ast_readstring ( struct ast_channel c,
char *  s,
int  len,
int  timeout,
int  rtimeout,
char *  enders 
)

Reads multiple digits

Parameters:
c channel to read from
s string to read in to. Must be at least the size of your length
len how many digits to read (maximum)
timeout how long to timeout between digits
rtimeout timeout to wait on the first digit
enders digits to end the string Read in a digit string "s", max length "len", maximum timeout between digits "timeout" (-1 for none), terminated by anything in "enders". Give them rtimeout for the first digit. Returns 0 on normal return, or 1 on a timeout. In the case of a timeout, any digits that were read before the timeout will still be available in s. RETURNS 2 in full version when ctrlfd is available, NOT 1

Definition at line 3236 of file channel.c.

References ast_readstring_full().

Referenced by __adsi_transmit_messages(), ast_adsi_begin_download(), ast_adsi_get_cpeinfo(), ast_adsi_load_session(), ast_app_getdata(), dialout(), do_directory(), forward_message(), privacy_exec(), vm_authenticate(), vm_newuser(), and vm_options().

03237 {
03238    return ast_readstring_full(c, s, len, timeout, ftimeout, enders, -1, -1);
03239 }

int ast_readstring_full ( struct ast_channel c,
char *  s,
int  len,
int  timeout,
int  ftimeout,
char *  enders,
int  audiofd,
int  ctrlfd 
)

Definition at line 3241 of file channel.c.

References ast_check_hangup(), AST_DIGIT_ANY, AST_FLAG_ZOMBIE, ast_stopstream(), ast_test_flag, ast_waitfordigit_full(), ast_waitstream_full(), and ast_channel::stream.

Referenced by ast_app_getdata_full(), and ast_readstring().

03242 {
03243    int pos = 0;   /* index in the buffer where we accumulate digits */
03244    int to = ftimeout;
03245 
03246    /* Stop if we're a zombie or need a soft hangup */
03247    if (ast_test_flag(c, AST_FLAG_ZOMBIE) || ast_check_hangup(c))
03248       return -1;
03249    if (!len)
03250       return -1;
03251    for (;;) {
03252       int d;
03253       if (c->stream) {
03254          d = ast_waitstream_full(c, AST_DIGIT_ANY, audiofd, ctrlfd);
03255          ast_stopstream(c);
03256          usleep(1000);
03257          if (!d)
03258             d = ast_waitfordigit_full(c, to, audiofd, ctrlfd);
03259       } else {
03260          d = ast_waitfordigit_full(c, to, audiofd, ctrlfd);
03261       }
03262       if (d < 0)
03263          return -1;
03264       if (d == 0) {
03265          s[pos]='\0';
03266          return 1;
03267       }
03268       if (d == 1) {
03269          s[pos]='\0';
03270          return 2;
03271       }
03272       if (!strchr(enders, d))
03273          s[pos++] = d;
03274       if (strchr(enders, d) || (pos >= len)) {
03275          s[pos]='\0';
03276          return 0;
03277       }
03278       to = timeout;
03279    }
03280    /* Never reached */
03281    return 0;
03282 }

int ast_recvchar ( struct ast_channel chan,
int  timeout 
)

Receives a text character from a channel.

Parameters:
chan channel to act upon
timeout timeout in milliseconds (0 for infinite wait) Read a char of text from a channel Returns 0 on success, -1 on failure

Definition at line 2591 of file channel.c.

References ast_recvtext(), and free.

Referenced by handle_recvchar().

02592 {
02593    int c;
02594    char *buf = ast_recvtext(chan, timeout);
02595    if (buf == NULL)
02596       return -1;  /* error or timeout */
02597    c = *(unsigned char *)buf;
02598    free(buf);
02599    return c;
02600 }

char* ast_recvtext ( struct ast_channel chan,
int  timeout 
)

Receives a text string from a channel Read a string of text from a channel.

Parameters:
chan channel to act upon
timeout timeout in milliseconds (0 for infinite wait)
Returns:
the received text, or NULL to signify failure.

Definition at line 2602 of file channel.c.

References ast_check_hangup(), AST_CONTROL_HANGUP, AST_FRAME_CONTROL, AST_FRAME_TEXT, ast_frfree, ast_read(), ast_strndup, ast_waitfor(), and f.

Referenced by ast_recvchar(), and handle_recvtext().

02603 {
02604    int res, done = 0;
02605    char *buf = NULL;
02606    
02607    while (!done) {
02608       struct ast_frame *f;
02609       if (ast_check_hangup(chan))
02610          break;
02611       res = ast_waitfor(chan, timeout);
02612       if (res <= 0) /* timeout or error */
02613          break;
02614       timeout = res; /* update timeout */
02615       f = ast_read(chan);
02616       if (f == NULL)
02617          break; /* no frame */
02618       if (f->frametype == AST_FRAME_CONTROL && f->subclass == AST_CONTROL_HANGUP)
02619          done = 1;   /* force a break */
02620       else if (f->frametype == AST_FRAME_TEXT) {      /* what we want */
02621          buf = ast_strndup((char *) f->data, f->datalen);   /* dup and break */
02622          done = 1;
02623       }
02624       ast_frfree(f);
02625    }
02626    return buf;
02627 }

struct ast_channel* ast_request ( const char *  type,
int  format,
void *  data,
int *  status 
)

Requests a channel.

Parameters:
type type of channel to request
format requested channel format (codec)
data data to pass to the channel requester
status status Request a channel of a given type, with data as optional information used by the low level module
Returns:
Returns an ast_channel on success, NULL on failure.

Definition at line 3142 of file channel.c.

References AST_CAUSE_BEARERCAPABILITY_NOTAVAIL, AST_CAUSE_NOSUCHDRIVER, AST_CAUSE_NOTDEFINED, AST_FORMAT_AUDIO_MASK, AST_FORMAT_VIDEO_MASK, AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_translator_best_choice(), capabilities, ast_channel_tech::capabilities, ast_channel_tech::requester, chanlist::tech, and ast_channel_tech::type.

Referenced by __ast_request_and_dial(), agent_request(), ast_feature_request_and_dial(), attempt_reconnect(), begin_dial(), build_conf(), chanavail_exec(), conf_run(), connect_link(), features_alloc(), findmeexec(), ring_entry(), rpt(), rpt_call(), rpt_tele_thread(), and wait_for_answer().

03143 {
03144    struct chanlist *chan;
03145    struct ast_channel *c;
03146    int capabilities;
03147    int fmt;
03148    int res;
03149    int foo;
03150    int videoformat = format & AST_FORMAT_VIDEO_MASK;
03151 
03152    if (!cause)
03153       cause = &foo;
03154    *cause = AST_CAUSE_NOTDEFINED;
03155 
03156    if (AST_LIST_LOCK(&channels)) {
03157       ast_log(LOG_WARNING, "Unable to lock channel list\n");
03158       return NULL;
03159    }
03160 
03161    AST_LIST_TRAVERSE(&backends, chan, list) {
03162       if (strcasecmp(type, chan->tech->type))
03163          continue;
03164 
03165       capabilities = chan->tech->capabilities;
03166       fmt = format & AST_FORMAT_AUDIO_MASK;
03167       res = ast_translator_best_choice(&fmt, &capabilities);
03168       if (res < 0) {
03169          ast_log(LOG_WARNING, "No translator path exists for channel type %s (native %d) to %d\n", type, chan->tech->capabilities, format);
03170          *cause = AST_CAUSE_BEARERCAPABILITY_NOTAVAIL;
03171          AST_LIST_UNLOCK(&channels);
03172          return NULL;
03173       }
03174       AST_LIST_UNLOCK(&channels);
03175       if (!chan->tech->requester)
03176          return NULL;
03177       
03178       if (!(c = chan->tech->requester(type, capabilities | videoformat, data, cause)))
03179          return NULL;
03180 
03181       /* no need to generate a Newchannel event here; it is done in the channel_alloc call */
03182       return c;
03183    }
03184 
03185    ast_log(LOG_WARNING, "No channel type registered for '%s'\n", type);
03186    *cause = AST_CAUSE_NOSUCHDRIVER;
03187    AST_LIST_UNLOCK(&channels);
03188 
03189    return NULL;
03190 }

struct ast_channel* ast_request_and_dial ( const char *  type,
int  format,
void *  data,
int  timeout,
int *  reason,
const char *  cidnum,
const char *  cidname 
)

Request a channel of a given type, with data as optional information used by the low level module and attempt to place a call on it.

Parameters:
type type of channel to request
format requested channel format
data data to pass to the channel requester
timeout maximum amount of time to wait for an answer
reason why unsuccessful (if unsuceessful)
cidnum Caller-ID Number
cidname Caller-ID Name
Returns:
Returns an ast_channel on success or no answer, NULL on failure. Check the value of chan->_state to know if the call was answered or not.

Definition at line 3137 of file channel.c.

References __ast_request_and_dial().

Referenced by ast_pbx_outgoing_exten().

03138 {
03139    return __ast_request_and_dial(type, format, data, timeout, outstate, cidnum, cidname, NULL);
03140 }

int ast_safe_sleep ( struct ast_channel chan,
int  ms 
)

Wait for a specied amount of time, looking for hangups.

Parameters:
chan channel to wait for
ms length of time in milliseconds to sleep Waits for a specified amount of time, servicing the channel as required.
Returns:
returns -1 on hangup, otherwise 0.

Definition at line 1194 of file channel.c.

References ast_safe_sleep_conditional().

Referenced by __login_exec(), alarmreceiver_exec(), ast_adsi_transmit_message_full(), ast_dtmf_stream(), ast_senddigit(), builtin_parkcall(), conf_run(), dictate_exec(), flash_exec(), function_ilink(), mgcp_ss(), milliwatt_exec(), moh0_exec(), moh1_exec(), old_milliwatt_exec(), park_call_exec(), pbx_builtin_answer(), pbx_builtin_wait(), play_tone_pair(), playtone(), privacy_exec(), receive_ademco_contact_id(), rpt_call(), rpt_exec(), rpt_tele_thread(), send_morse(), send_tone_telemetry(), skinny_ss(), ss_thread(), testclient_exec(), testserver_exec(), try_calling(), wait_for_hangup(), wait_interval(), and zapateller_exec().

01195 {
01196    return ast_safe_sleep_conditional(chan, ms, NULL, NULL);
01197 }

int ast_safe_sleep_conditional ( struct ast_channel chan,
int  ms,
int(*)(void *)  cond,
void *  data 
)

Wait for a specied amount of time, looking for hangups and a condition argument.

Parameters:
chan channel to wait for
ms length of time in milliseconds to sleep
cond a function pointer for testing continue condition
data argument to be passed to the condition test function
Returns:
returns -1 on hangup, otherwise 0. Waits for a specified amount of time, servicing the channel as required. If cond returns 0, this function returns.

Definition at line 1173 of file channel.c.

References ast_frfree, ast_read(), ast_waitfor(), and f.

Referenced by __login_exec(), and ast_safe_sleep().

01174 {
01175    struct ast_frame *f;
01176 
01177    while (ms > 0) {
01178       if (cond && ((*cond)(data) == 0))
01179          return 0;
01180       ms = ast_waitfor(chan, ms);
01181       if (ms < 0)
01182          return -1;
01183       if (ms > 0) {
01184          f = ast_read(chan);
01185          if (!f)
01186             return -1;
01187          ast_frfree(f);
01188       }
01189    }
01190    return 0;
01191 }

char* ast_safe_string_alloc ( const char *  fmt,
  ... 
)

printf the string into a correctly sized mallocd buffer, and return the buffer

return a mallocd string with the result of sprintf of the fmt and following args

Definition at line 409 of file channel.c.

References ast_malloc, and len().

Referenced by dahdi_new(), and features_new().

00410 {
00411    char *b2, buf[1];
00412    int len;
00413    va_list args;
00414 
00415    va_start(args, fmt);
00416    len = vsnprintf(buf, 1, fmt, args);
00417    va_end(args);
00418 
00419    if (!(b2 = ast_malloc(len + 1)))
00420       return NULL;
00421 
00422    va_start(args, fmt);
00423    vsnprintf(b2, len + 1,  fmt, args);
00424    va_end(args);
00425 
00426    return b2;
00427 }

int ast_say_character_str ( struct ast_channel chan,
const char *  str,
const char *  ints,
const char *  lang 
)

Definition at line 4881 of file channel.c.

References ast_say_character_str_full.

Referenced by common_exec(), pbx_builtin_saycharacters(), play_mailbox_owner(), rpt_tele_thread(), and saycharstr().

04883 {
04884         return ast_say_character_str_full(chan, str, ints, lang, -1, -1);
04885 }

int ast_say_digit_str ( struct ast_channel chan,
const char *  str,
const char *  ints,
const char *  lang 
)

Definition at line 4875 of file channel.c.

References ast_say_digit_str_full.

Referenced by invent_message(), mgcp_ss(), pbx_builtin_saydigits(), play_message_callerid(), and ss_thread().

04877 {
04878         return ast_say_digit_str_full(chan, str, ints, lang, -1, -1);
04879 }

int ast_say_digits ( struct ast_channel chan,
int  num,
const char *  ints,
const char *  lang 
)

Definition at line 4869 of file channel.c.

References ast_say_digits_full().

Referenced by common_exec(), conf_exec(), park_call_full(), parkandannounce_exec(), and rpt_tele_thread().

04871 {
04872         return ast_say_digits_full(chan, num, ints, lang, -1, -1);
04873 }

int ast_say_digits_full ( struct ast_channel chan,
int  num,
const char *  ints,
const char *  lang,
int  audiofd,
int  ctrlfd 
)

Definition at line 4893 of file channel.c.

References ast_say_digit_str_full.

Referenced by __say_init(), ast_say_digits(), ast_say_enumeration_full_da(), ast_say_enumeration_full_de(), ast_say_number_full_cz(), ast_say_number_full_da(), ast_say_number_full_de(), ast_say_number_full_en(), ast_say_number_full_en_GB(), ast_say_number_full_es(), ast_say_number_full_fr(), ast_say_number_full_ge(), ast_say_number_full_he(), ast_say_number_full_it(), ast_say_number_full_nl(), ast_say_number_full_no(), ast_say_number_full_pt(), ast_say_number_full_ru(), ast_say_number_full_se(), and ast_say_number_full_tw().

04895 {
04896         char buf[256];
04897 
04898         snprintf(buf, sizeof(buf), "%d", num);
04899         return ast_say_digit_str_full(chan, buf, ints, lang, audiofd, ctrlfd);
04900 }

int ast_say_enumeration ( struct ast_channel chan,
int  num,
const char *  ints,
const char *  language,
const char *  options 
)

Definition at line 4863 of file channel.c.

References ast_say_enumeration_full.

Referenced by ast_say_date_da(), ast_say_date_de(), ast_say_date_with_format_da(), ast_say_date_with_format_de(), ast_say_date_with_format_en(), and ast_say_date_with_format_pl().

04865 {
04866         return ast_say_enumeration_full(chan, num, ints, language, options, -1, -1);
04867 }

int ast_say_number ( struct ast_channel chan,
int  num,
const char *  ints,
const char *  language,
const char *  options 
)

Definition at line 4857 of file channel.c.

References ast_say_number_full.

Referenced by ast_say_date_da(), ast_say_date_de(), ast_say_date_en(), ast_say_date_es(), ast_say_date_fr(), ast_say_date_ge(), ast_say_date_gr(), ast_say_date_he(), ast_say_date_nl(), ast_say_date_pt(), ast_say_date_with_format_da(), ast_say_date_with_format_de(), ast_say_date_with_format_en(), ast_say_date_with_format_es(), ast_say_date_with_format_fr(), ast_say_date_with_format_it(), ast_say_date_with_format_nl(), ast_say_date_with_format_pl(), ast_say_date_with_format_pt(), ast_say_datetime_en(), ast_say_datetime_fr(), ast_say_datetime_from_now_en(), ast_say_datetime_from_now_fr(), ast_say_datetime_from_now_ge(), ast_say_datetime_from_now_he(), ast_say_datetime_from_now_pt(), ast_say_datetime_he(), ast_say_datetime_pt(), ast_say_datetime_tw(), ast_say_time_de(), ast_say_time_en(), ast_say_time_es(), ast_say_time_fr(), ast_say_time_ge(), ast_say_time_gr(), ast_say_time_nl(), ast_say_time_pt(), ast_say_time_pt_BR(), ast_say_time_tw(), bridge_playfile(), conf_exec(), conf_run(), count_exec(), dictate_exec(), get_folder(), gr_say_number_female(), pbx_builtin_saynumber(), play_message(), play_message_duration(), rpt_tele_thread(), say_and_wait(), say_position(), saynum(), try_calling(), vm_intro_gr(), vm_intro_he(), vm_intro_multilang(), vm_intro_pt(), and vm_intro_pt_BR().

04859 {
04860         return ast_say_number_full(chan, num, ints, language, options, -1, -1);
04861 }

int ast_say_phonetic_str ( struct ast_channel chan,
const char *  str,
const char *  ints,
const char *  lang 
)

Definition at line 4887 of file channel.c.

References ast_say_phonetic_str_full.

Referenced by pbx_builtin_sayphonetic().

04889 {
04890         return ast_say_phonetic_str_full(chan, str, ints, lang, -1, -1);
04891 }

int ast_senddigit ( struct ast_channel chan,
char  digit 
)

Send a DTMF digit to a channel Send a DTMF digit to a channel.

Parameters:
chan channel to act upon
digit the DTMF digit to send, encoded in ASCII
Returns:
Returns 0 on success, -1 on failure

Definition at line 2701 of file channel.c.

References AST_DEFAULT_EMULATE_DTMF_DURATION, ast_safe_sleep(), ast_senddigit_begin(), ast_senddigit_end(), ast_channel_tech::send_digit_begin, and ast_channel::tech.

Referenced by ast_dtmf_stream(), do_dtmf_phone(), manager_play_dtmf(), and rpt_call().

02702 {
02703    if (chan->tech->send_digit_begin) {
02704       ast_senddigit_begin(chan, digit);
02705       ast_safe_sleep(chan, AST_DEFAULT_EMULATE_DTMF_DURATION);
02706    }
02707    
02708    return ast_senddigit_end(chan, digit, AST_DEFAULT_EMULATE_DTMF_DURATION);
02709 }

int ast_senddigit_begin ( struct ast_channel chan,
char  digit 
)

Definition at line 2642 of file channel.c.

References ast_log(), ast_playtones_start(), LOG_DEBUG, ast_channel::name, option_debug, ast_channel_tech::send_digit_begin, and ast_channel::tech.

Referenced by agent_digit_begin(), ast_senddigit(), ast_write(), and features_digit_begin().

02643 {
02644    /* Device does not support DTMF tones, lets fake
02645     * it by doing our own generation. */
02646    static const char* dtmf_tones[] = {
02647       "941+1336", /* 0 */
02648       "697+1209", /* 1 */
02649       "697+1336", /* 2 */
02650       "697+1477", /* 3 */
02651       "770+1209", /* 4 */
02652       "770+1336", /* 5 */
02653       "770+1477", /* 6 */
02654       "852+1209", /* 7 */
02655       "852+1336", /* 8 */
02656       "852+1477", /* 9 */
02657       "697+1633", /* A */
02658       "770+1633", /* B */
02659       "852+1633", /* C */
02660       "941+1633", /* D */
02661       "941+1209", /* * */
02662       "941+1477"  /* # */
02663    };
02664 
02665    if (!chan->tech->send_digit_begin)
02666       return 0;
02667 
02668    if (!chan->tech->send_digit_begin(chan, digit))
02669       return 0;
02670 
02671    if (digit >= '0' && digit <='9')
02672       ast_playtones_start(chan, 0, dtmf_tones[digit-'0'], 0);
02673    else if (digit >= 'A' && digit <= 'D')
02674       ast_playtones_start(chan, 0, dtmf_tones[digit-'A'+10], 0);
02675    else if (digit == '*')
02676       ast_playtones_start(chan, 0, dtmf_tones[14], 0);
02677    else if (digit == '#')
02678       ast_playtones_start(chan, 0, dtmf_tones[15], 0);
02679    else {
02680       /* not handled */
02681       if (option_debug)
02682          ast_log(LOG_DEBUG, "Unable to generate DTMF tone '%c' for '%s'\n", digit, chan->name);
02683    }
02684 
02685    return 0;
02686 }

int ast_senddigit_end ( struct ast_channel chan,
char  digit,
unsigned int  duration 
)

Definition at line 2688 of file channel.c.

References ast_playtones_stop(), ast_channel::generator, ast_channel_tech::send_digit_end, and ast_channel::tech.

Referenced by agent_digit_end(), ast_senddigit(), ast_write(), and features_digit_end().

02689 {
02690    int res = -1;
02691 
02692    if (chan->tech->send_digit_end)
02693       res = chan->tech->send_digit_end(chan, digit, duration);
02694 
02695    if (res && chan->generator)
02696       ast_playtones_stop(chan);
02697    
02698    return 0;
02699 }

int ast_sendtext ( struct ast_channel chan,
const char *  text 
)

Sends text to a channel Write text to a display on a channel.

Parameters:
chan channel to act upon
text string of text to send on the channel
Returns:
Returns 0 on success, -1 on failure

Definition at line 2629 of file channel.c.

References ast_check_hangup(), ast_clear_flag, AST_FLAG_BLOCKING, AST_FLAG_ZOMBIE, ast_test_flag, CHECK_BLOCKING, ast_channel_tech::send_text, and ast_channel::tech.

Referenced by agent_sendtext(), handle_sendtext(), and sendtext_exec().

02630 {
02631    int res = 0;
02632    /* Stop if we're a zombie or need a soft hangup */
02633    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan))
02634       return -1;
02635    CHECK_BLOCKING(chan);
02636    if (chan->tech->send_text)
02637       res = chan->tech->send_text(chan, text);
02638    ast_clear_flag(chan, AST_FLAG_BLOCKING);
02639    return res;
02640 }

void ast_set_callerid ( struct ast_channel chan,
const char *  cidnum,
const char *  cidname,
const char *  ani 
)

Note:
The channel does not need to be locked before calling this function.

Definition at line 3796 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_describe_caller_presentation(), ast_strdup, ast_channel::cid, ast_callerid::cid_ani, ast_callerid::cid_name, ast_callerid::cid_num, ast_callerid::cid_pres, free, manager_event(), ast_channel::name, S_OR, and ast_channel::uniqueid.

Referenced by __ast_request_and_dial(), agent_call(), ast_feature_request_and_dial(), callerid_write(), dahdi_read(), disa_exec(), findmeexec(), handle_setcallerid(), lookupcidname_exec(), mgcp_ss(), privacy_exec(), read_config(), setcallerid_exec(), skinny_newcall(), ss_thread(), and wait_for_answer().

03797 {
03798    ast_channel_lock(chan);
03799 
03800    if (callerid) {
03801       if (chan->cid.cid_num)
03802          free(chan->cid.cid_num);
03803       chan->cid.cid_num = ast_strdup(callerid);
03804    }
03805    if (calleridname) {
03806       if (chan->cid.cid_name)
03807          free(chan->cid.cid_name);
03808       chan->cid.cid_name = ast_strdup(calleridname);
03809    }
03810    if (ani) {
03811       if (chan->cid.cid_ani)
03812          free(chan->cid.cid_ani);
03813       chan->cid.cid_ani = ast_strdup(ani);
03814    }
03815    manager_event(EVENT_FLAG_CALL, "Newcallerid",
03816             "Channel: %s\r\n"
03817             "CallerID: %s\r\n"
03818             "CallerIDName: %s\r\n"
03819             "Uniqueid: %s\r\n"
03820             "CID-CallingPres: %d (%s)\r\n",
03821             chan->name,
03822             S_OR(chan->cid.cid_num, "<Unknown>"),
03823             S_OR(chan->cid.cid_name, "<Unknown>"),
03824             chan->uniqueid,
03825             chan->cid.cid_pres,
03826             ast_describe_caller_presentation(chan->cid.cid_pres)
03827             );
03828    
03829    ast_channel_unlock(chan);
03830 }

int ast_set_read_format ( struct ast_channel chan,
int  format 
)

Sets read format on channel chan Set read format for channel to whichever component of "format" is best.

Parameters:
chan channel to change
format format to change to
Returns:
Returns 0 on success, -1 on failure

Definition at line 2982 of file channel.c.

References ast_channel::rawreadformat, ast_channel::readformat, ast_channel::readtrans, and set_format().

Referenced by __ast_play_and_record(), __login_exec(), __oh323_update_info(), agent_call(), alarmreceiver_exec(), ast_adsi_transmit_message_full(), ast_channel_make_compatible(), ast_do_masquerade(), attempt_reconnect(), background_detect_exec(), build_conf(), conf_run(), connect_link(), dictate_exec(), disa_exec(), do_waiting(), eagi_exec(), echo_exec(), gtalk_rtp_read(), handle_recordfile(), ices_exec(), isAnsweringMachine(), measurenoise(), mgcp_rtp_read(), oh323_rtp_read(), old_milliwatt_exec(), process_sdp(), rpt(), setup_rtp_connection(), sip_rtp_read(), skinny_rtp_read(), socket_process(), speech_background(), and update_features().

02983 {
02984    return set_format(chan, fmt, &chan->rawreadformat, &chan->readformat,
02985            &chan->readtrans, 0);
02986 }

void ast_set_variables ( struct ast_channel chan,
struct ast_variable vars 
)

adds a list of channel variables to a channel

Parameters:
chan the channel
vars a linked list of variables
Variable names can be for a regular channel variable or a dialplan function that has the ability to be written to.

Definition at line 4624 of file channel.c.

References ast_variable::name, ast_variable::next, pbx_builtin_setvar_helper(), and ast_variable::value.

Referenced by __ast_request_and_dial(), ast_pbx_outgoing_app(), and ast_pbx_outgoing_exten().

04625 {
04626    struct ast_variable *cur;
04627 
04628    for (cur = vars; cur; cur = cur->next)
04629       pbx_builtin_setvar_helper(chan, cur->name, cur->value);  
04630 }

int ast_set_write_format ( struct ast_channel chan,
int  format 
)

Sets write format on channel chan Set write format for channel to whichever compoent of "format" is best.

Parameters:
chan channel to change
format new format for writing
Returns:
Returns 0 on success, -1 on failure

Definition at line 2988 of file channel.c.

References ast_channel::rawwriteformat, set_format(), ast_channel::writeformat, and ast_channel::writetrans.

Referenced by __login_exec(), __oh323_update_info(), agent_call(), alarmreceiver_exec(), ast_adsi_transmit_message_full(), ast_channel_make_compatible(), ast_channel_start_silence_generator(), ast_channel_stop_silence_generator(), ast_do_masquerade(), ast_openstream_full(), ast_stopstream(), attempt_reconnect(), build_conf(), chanspy_exec(), conf_run(), connect_link(), disa_exec(), echo_exec(), extenspy_exec(), gtalk_rtp_read(), linear_alloc(), linear_release(), mgcp_rtp_read(), moh_alloc(), moh_files_release(), moh_release(), mp3_exec(), NBScat_exec(), oh323_rtp_read(), old_milliwatt_exec(), playtones_alloc(), playtones_release(), process_sdp(), rpt(), send_waveform_to_channel(), setup_rtp_connection(), sip_rtp_read(), skinny_rtp_read(), socket_process(), tonepair_alloc(), tonepair_release(), and update_features().

02989 {
02990    return set_format(chan, fmt, &chan->rawwriteformat, &chan->writeformat,
02991            &chan->writetrans, 1);
02992 }

int ast_setstate ( struct ast_channel chan,
enum ast_channel_state  state 
)

Change the state of a channel.

Definition at line 3832 of file channel.c.

References ast_channel::_state, AST_CHANNEL_NAME, ast_copy_string(), ast_device_state_changed_literal(), ast_state2str(), ast_channel::cid, ast_callerid::cid_name, ast_callerid::cid_num, manager_event(), name, ast_channel::name, S_OR, and ast_channel::uniqueid.

Referenced by __ast_read(), __dahdi_exception(), __oh323_update_info(), agent_call(), alsa_answer(), ast_answer(), cb_events(), check_availability(), dahdi_answer(), dahdi_call(), dahdi_handle_event(), dahdi_indicate(), dahdi_read(), gtalk_call(), gtalk_newcall(), handle_invite_replaces(), handle_offhook_message(), handle_request_invite(), handle_response_invite(), handle_soft_key_event_message(), handle_stimulus_message(), iax2_call(), mgcp_answer(), mgcp_call(), mgcp_ss(), misdn_call(), misdn_indication(), nbs_call(), nbs_hangup(), oh323_answer(), oss_answer(), pbx_builtin_busy(), pbx_builtin_congestion(), phone_answer(), phone_call(), phone_exception(), phone_hangup(), phone_write(), release_chan(), sip_answer(), skinny_answer(), skinny_call(), skinny_newcall(), ss_thread(), and update_state().

03833 {
03834    char name[AST_CHANNEL_NAME], *dashptr;
03835    int oldstate = chan->_state;
03836 
03837    if (oldstate == state)
03838       return 0;
03839 
03840    ast_copy_string(name, chan->name, sizeof(name));
03841    if ((dashptr = strrchr(name, '-'))) {
03842       *dashptr = '\0';
03843    }
03844 
03845    chan->_state = state;
03846    ast_device_state_changed_literal(name);
03847    /* setstate used to conditionally report Newchannel; this is no more */
03848    manager_event(EVENT_FLAG_CALL,
03849             "Newstate",
03850             "Channel: %s\r\n"
03851             "State: %s\r\n"
03852             "CallerID: %s\r\n"
03853             "CallerIDName: %s\r\n"
03854             "Uniqueid: %s\r\n",
03855             chan->name, ast_state2str(chan->_state),
03856             S_OR(chan->cid.cid_num, "<unknown>"),
03857             S_OR(chan->cid.cid_name, "<unknown>"),
03858             chan->uniqueid);
03859 
03860    return 0;
03861 }

int ast_settimeout ( struct ast_channel c,
int  samples,
int(*)(const void *data)  func,
void *  data 
)

Definition at line 1837 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_log(), LOG_DEBUG, option_debug, ast_channel::timingdata, ast_channel::timingfd, and ast_channel::timingfunc.

Referenced by ast_activate_generator(), ast_deactivate_generator(), ast_read_generator_actions(), ast_readaudio_callback(), and filestream_destructor().

01838 {
01839    int res = -1;
01840 #ifdef HAVE_DAHDI
01841    ast_channel_lock(c);
01842    if (c->timingfd > -1) {
01843       if (!func) {
01844          samples = 0;
01845          data = 0;
01846       }
01847       if (option_debug)
01848          ast_log(LOG_DEBUG, "Scheduling timer at %d sample intervals\n", samples);
01849       res = ioctl(c->timingfd, DAHDI_TIMERCONFIG, &samples);
01850       c->timingfunc = func;
01851       c->timingdata = data;
01852    }
01853    ast_channel_unlock(c);
01854 #endif   
01855    return res;
01856 }

int ast_shutting_down ( void   ) 

Returns non-zero if Asterisk is being shut down.

Returns non-zero if Asterisk is being shut down

Definition at line 461 of file channel.c.

Referenced by handle_request_options().

00462 {
00463    return shutting_down;
00464 }

int ast_softhangup ( struct ast_channel chan,
int  cause 
)

Softly hangup up a channel.

Parameters:
chan channel to be soft-hung-up Call the protocol layer, but don't destroy the channel structure (use this if you are trying to safely hangup a channel managed by another thread.
cause Ast hangupcause for hangup
Returns:
Returns 0 regardless

Definition at line 1437 of file channel.c.

References ast_channel_lock, ast_channel_unlock, and ast_softhangup_nolock().

Referenced by __ast_module_user_hangup_all(), __login_exec(), __unload_module(), action_hangup(), agent_hangup(), agent_logoff(), ast_begin_shutdown(), ast_dial_join(), conf_free(), connect_link(), dahdi_handle_event(), function_ilink(), handle_hangup(), handle_link_data(), handle_softhangup(), manager_park(), read_agent_config(), rpt(), rpt_call(), rpt_do_restart(), sla_handle_hold_event(), softhangup_exec(), start_spying(), startmon(), and unload_module().

01438 {
01439    int res;
01440    ast_channel_lock(chan);
01441    res = ast_softhangup_nolock(chan, cause);
01442    ast_channel_unlock(chan);
01443    return res;
01444 }

int ast_softhangup_nolock ( struct ast_channel chan,
int  cause 
)

Softly hangup up a channel (no channel lock).

Parameters:
chan channel to be soft-hung-up
cause Ast hangupcause for hangup (see cause.h)

Definition at line 1423 of file channel.c.

References ast_channel::_softhangup, AST_FLAG_BLOCKING, ast_log(), ast_null_frame, ast_queue_frame(), ast_test_flag, ast_channel::blocker, LOG_DEBUG, ast_channel::name, and option_debug.

Referenced by ast_async_goto(), ast_softhangup(), attempt_transfer(), dahdi_softhangup_all(), do_monitor(), oh323_indicate(), sip_indicate(), and skinny_indicate().

01424 {
01425    if (option_debug)
01426       ast_log(LOG_DEBUG, "Soft-Hanging up channel '%s'\n", chan->name);
01427    /* Inform channel driver that we need to be hung up, if it cares */
01428    chan->_softhangup |= cause;
01429    ast_queue_frame(chan, &ast_null_frame);
01430    /* Interrupt any poll call or such */
01431    if (ast_test_flag(chan, AST_FLAG_BLOCKING))
01432       pthread_kill(chan->blocker, SIGURG);
01433    return 0;
01434 }

char* ast_state2str ( enum  ast_channel_state  ) 

Gives the string form of a given channel state.

Parameters:
ast_channel_state state to get the name of Give a name to a state Returns the text form of the binary state given

Definition at line 600 of file channel.c.

References AST_STATE_BUSY, AST_STATE_DIALING, AST_STATE_DIALING_OFFHOOK, AST_STATE_DOWN, AST_STATE_OFFHOOK, AST_STATE_PRERING, AST_STATE_RESERVED, AST_STATE_RING, AST_STATE_RINGING, AST_STATE_UP, ast_threadstorage_get(), STATE2STR_BUFSIZE, and state2str_threadbuf.

Referenced by action_status(), agent_hangup(), ast_setstate(), attempt_transfer(), func_channel_read(), handle_chanlist(), handle_chanlist_deprecated(), handle_invite_replaces(), handle_showchan(), handle_showchan_deprecated(), local_attended_transfer(), mgcp_new(), serialize_showchan(), and sip_hangup().

00601 {
00602    char *buf;
00603 
00604    switch(state) {
00605    case AST_STATE_DOWN:
00606       return "Down";
00607    case AST_STATE_RESERVED:
00608       return "Rsrvd";
00609    case AST_STATE_OFFHOOK:
00610       return "OffHook";
00611    case AST_STATE_DIALING:
00612       return "Dialing";
00613    case AST_STATE_RING:
00614       return "Ring";
00615    case AST_STATE_RINGING:
00616       return "Ringing";
00617    case AST_STATE_UP:
00618       return "Up";
00619    case AST_STATE_BUSY:
00620       return "Busy";
00621    case AST_STATE_DIALING_OFFHOOK:
00622       return "Dialing Offhook";
00623    case AST_STATE_PRERING:
00624       return "Pre-ring";
00625    default:
00626       if (!(buf = ast_threadstorage_get(&state2str_threadbuf, STATE2STR_BUFSIZE)))
00627          return "Unknown";
00628       snprintf(buf, STATE2STR_BUFSIZE, "Unknown (%d)", state);
00629       return buf;
00630    }
00631 }

int ast_str2cause ( const char *  name  ) 

Convert a symbolic hangup cause to number.

Parameters:
name string form of the cause Returns the cause code

Definition at line 588 of file channel.c.

References causes.

Referenced by pbx_builtin_hangup().

00589 {
00590    int x;
00591 
00592    for (x = 0; x < sizeof(causes) / sizeof(causes[0]); x++)
00593       if (strncasecmp(causes[x].name, name, strlen(causes[x].name)) == 0)
00594          return causes[x].cause;
00595 
00596    return -1;
00597 }

int ast_tonepair ( struct ast_channel chan,
int  freq1,
int  freq2,
int  duration,
int  vol 
)

Play a tone pair for a given amount of time

Definition at line 4496 of file channel.c.

References ast_frfree, ast_read(), ast_tonepair_start(), ast_waitfor(), f, and ast_channel::generatordata.

Referenced by zapateller_exec().

04497 {
04498    int res;
04499 
04500    if ((res = ast_tonepair_start(chan, freq1, freq2, duration, vol)))
04501       return res;
04502 
04503    /* Give us some wiggle room */
04504    while (chan->generatordata && ast_waitfor(chan, 100) >= 0) {
04505       struct ast_frame *f = ast_read(chan);
04506       if (f)
04507          ast_frfree(f);
04508       else
04509          return -1;
04510    }
04511    return 0;
04512 }

int ast_tonepair_start ( struct ast_channel chan,
int  freq1,
int  freq2,
int  duration,
int  vol 
)

Start a tone going

Definition at line 4478 of file channel.c.

References ast_activate_generator(), tonepair_def::duration, tonepair_def::freq1, tonepair_def::freq2, tonepair, and tonepair_def::vol.

Referenced by ast_tonepair(), play_dialtone(), play_tone_pair(), rpt_tele_thread(), and sendnoise().

04479 {
04480    struct tonepair_def d = { 0, };
04481 
04482    d.freq1 = freq1;
04483    d.freq2 = freq2;
04484    d.duration = duration;
04485    d.vol = (vol < 1) ? 8192 : vol; /* force invalid to 8192 */
04486    if (ast_activate_generator(chan, &tonepair, &d))
04487       return -1;
04488    return 0;
04489 }

void ast_tonepair_stop ( struct ast_channel chan  ) 

Stop a tone from playing

Definition at line 4491 of file channel.c.

References ast_deactivate_generator().

Referenced by sendnoise().

04492 {
04493    ast_deactivate_generator(chan);
04494 }

int ast_transfer ( struct ast_channel chan,
char *  dest 
)

Transfer a channel (if supported). Returns -1 on error, 0 if not supported and 1 if supported and requested.

Called by:

Definition at line 3218 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_check_hangup(), AST_FLAG_ZOMBIE, ast_test_flag, ast_channel::tech, and ast_channel_tech::transfer.

Referenced by transfer_exec().

03219 {
03220    int res = -1;
03221 
03222    /* Stop if we're a zombie or need a soft hangup */
03223    ast_channel_lock(chan);
03224    if (!ast_test_flag(chan, AST_FLAG_ZOMBIE) && !ast_check_hangup(chan)) {
03225       if (chan->tech->transfer) {
03226          res = chan->tech->transfer(chan, dest);
03227          if (!res)
03228             res = 1;
03229       } else
03230          res = 0;
03231    }
03232    ast_channel_unlock(chan);
03233    return res;
03234 }

char* ast_transfercapability2str ( int  transfercapability  )  const

Gives the string form of a given transfer capability.

Parameters:
transfercapability transfercapabilty to get the name of Give a name to a transfercapbility See above Returns the text form of the binary transfer capbility

Definition at line 634 of file channel.c.

References AST_TRANS_CAP_3_1K_AUDIO, AST_TRANS_CAP_DIGITAL, AST_TRANS_CAP_DIGITAL_W_TONES, AST_TRANS_CAP_RESTRICTED_DIGITAL, AST_TRANS_CAP_SPEECH, and AST_TRANS_CAP_VIDEO.

Referenced by cb_events(), dahdi_call(), dahdi_new(), misdn_call(), and oh323_call().

00635 {
00636    switch(transfercapability) {
00637    case AST_TRANS_CAP_SPEECH:
00638       return "SPEECH";
00639    case AST_TRANS_CAP_DIGITAL:
00640       return "DIGITAL";
00641    case AST_TRANS_CAP_RESTRICTED_DIGITAL:
00642       return "RESTRICTED_DIGITAL";
00643    case AST_TRANS_CAP_3_1K_AUDIO:
00644       return "3K1AUDIO";
00645    case AST_TRANS_CAP_DIGITAL_W_TONES:
00646       return "DIGITAL_W_TONES";
00647    case AST_TRANS_CAP_VIDEO:
00648       return "VIDEO";
00649    default:
00650       return "UNKNOWN";
00651    }
00652 }

void ast_uninstall_music_functions ( void   ) 

Definition at line 4559 of file channel.c.

References ast_moh_cleanup_ptr, ast_moh_start_ptr, and ast_moh_stop_ptr.

Referenced by unload_module().

04560 {
04561    ast_moh_start_ptr = NULL;
04562    ast_moh_stop_ptr = NULL;
04563    ast_moh_cleanup_ptr = NULL;
04564 }

int ast_waitfor ( struct ast_channel chan,
int  ms 
)

Wait for input on a channel.

Parameters:
chan channel to wait on
ms length of time to wait on the channel Wait for input on a channel for a given # of milliseconds (<0 for indefinite).
Returns:
Returns < 0 on failure, 0 if nothing ever arrived, and the # of ms remaining otherwise

Definition at line 1821 of file channel.c.

References ast_waitfor_nandfds().

Referenced by __adsi_transmit_messages(), __ast_play_and_record(), __ast_request_and_dial(), adsi_careful_send(), agent_ack_sleep(), ast_dtmf_stream(), ast_recvtext(), ast_safe_sleep_conditional(), ast_tonepair(), async_wait(), background_detect_exec(), channel_spy(), conf_exec(), conf_flush(), dictate_exec(), disa_exec(), do_idle_thread(), do_waiting(), echo_exec(), handle_recordfile(), ices_exec(), isAnsweringMachine(), measurenoise(), mp3_exec(), NBScat_exec(), receive_dtmf_digits(), recordthread(), send_tone_burst(), send_waveform_to_channel(), sendurl_exec(), speech_background(), ss_thread(), wait_for_hangup(), waitforring_exec(), and waitstream_core().

01822 {
01823    int oldms = ms;   /* -1 if no timeout */
01824 
01825    ast_waitfor_nandfds(&c, 1, NULL, 0, NULL, NULL, &ms);
01826    if ((ms < 0) && (oldms < 0))
01827       ms = 0;
01828    return ms;
01829 }

struct ast_channel* ast_waitfor_n ( struct ast_channel **  chan,
int  n,
int *  ms 
)

Waits for input on a group of channels Wait for input on an array of channels for a given # of milliseconds.

Returns:
Return channel with activity, or NULL if none has activity.
Parameters:
chan an array of pointers to channels
n number of channels that are to be waited upon
ms time "ms" is modified in-place, if applicable

Definition at line 1816 of file channel.c.

References ast_waitfor_nandfds().

Referenced by ast_feature_request_and_dial(), ast_udptl_bridge(), autoservice_run(), bridge_native_loop(), dahdi_bridge(), misdn_bridge(), monitor_dial(), rpt(), wait_for_answer(), and wait_for_winner().

01817 {
01818    return ast_waitfor_nandfds(c, n, NULL, 0, NULL, NULL, ms);
01819 }

int ast_waitfor_n_fd ( int *  fds,
int  n,
int *  ms,
int *  exception 
)

Waits for input on an fd This version works on fd's only. Be careful with it.

Definition at line 1660 of file channel.c.

References ast_waitfor_nandfds().

Referenced by dundi_lookup_internal(), and dundi_precache_internal().

01661 {
01662    int winner = -1;
01663    ast_waitfor_nandfds(NULL, 0, fds, n, exception, &winner, ms);
01664    return winner;
01665 }

struct ast_channel* ast_waitfor_nandfds ( struct ast_channel **  chan,
int  n,
int *  fds,
int  nfds,
int *  exception,
int *  outfd,
int *  ms 
)

Waits for activity on a group of channels.

Parameters:
chan an array of pointers to channels
n number of channels that are to be waited upon
fds an array of fds to wait upon
nfds the number of fds to wait upon
exception exception flag
outfd fd that had activity on it
ms how long the wait was Big momma function here. Wait for activity on any of the n channels, or any of the nfds file descriptors.
Returns:
Returns the channel with activity, or NULL on error or if an FD came first. If the FD came first, it will be returned in outfd, otherwise, outfd will be -1

Definition at line 1668 of file channel.c.

References ast_channel::_softhangup, ast_add_fd(), ast_channel_lock, ast_channel_unlock, ast_clear_flag, ast_do_masquerade(), AST_FLAG_BLOCKING, AST_FLAG_EXCEPTION, ast_log(), AST_MAX_FDS, ast_set_flag, AST_SOFTHANGUP_TIMEOUT, ast_tvdiff_ms(), ast_tvnow(), CHECK_BLOCKING, errno, pollfd::fd, poll(), POLLPRI, and ast_channel::whentohangup.

Referenced by app_exec(), ast_waitfor(), ast_waitfor_n(), ast_waitfor_n_fd(), ast_waitfordigit_full(), conf_run(), find_cache(), run_agi(), and waitstream_core().

01670 {
01671    struct timeval start = { 0 , 0 };
01672    struct pollfd *pfds = NULL;
01673    int res;
01674    long rms;
01675    int x, y, max;
01676    int sz;
01677    time_t now = 0;
01678    long whentohangup = 0, diff;
01679    struct ast_channel *winner = NULL;
01680    struct fdmap {
01681       int chan;
01682       int fdno;
01683    } *fdmap = NULL;
01684 
01685    if ((sz = n * AST_MAX_FDS + nfds)) {
01686       pfds = alloca(sizeof(*pfds) * sz);
01687       fdmap = alloca(sizeof(*fdmap) * sz);
01688    }
01689 
01690    if (outfd)
01691       *outfd = -99999;
01692    if (exception)
01693       *exception = 0;
01694    
01695    /* Perform any pending masquerades */
01696    for (x=0; x < n; x++) {
01697       ast_channel_lock(c[x]);
01698       if (c[x]->masq) {
01699          if (ast_do_masquerade(c[x])) {
01700             ast_log(LOG_WARNING, "Masquerade failed\n");
01701             *ms = -1;
01702             ast_channel_unlock(c[x]);
01703             return NULL;
01704          }
01705       }
01706       if (c[x]->whentohangup) {
01707          if (!whentohangup)
01708             time(&now);
01709          diff = c[x]->whentohangup - now;
01710          if (diff < 1) {
01711             /* Should already be hungup */
01712             c[x]->_softhangup |= AST_SOFTHANGUP_TIMEOUT;
01713             ast_channel_unlock(c[x]);
01714             return c[x];
01715          }
01716          if (!whentohangup || (diff < whentohangup))
01717             whentohangup = diff;
01718       }
01719       ast_channel_unlock(c[x]);
01720    }
01721    /* Wait full interval */
01722    rms = *ms;
01723    if (whentohangup) {
01724       rms = whentohangup * 1000;              /* timeout in milliseconds */
01725       if (*ms >= 0 && *ms < rms)    /* original *ms still smaller */
01726          rms =  *ms;
01727    }
01728    /*
01729     * Build the pollfd array, putting the channels' fds first,
01730     * followed by individual fds. Order is important because
01731     * individual fd's must have priority over channel fds.
01732     */
01733    max = 0;
01734    for (x=0; x<n; x++) {
01735       for (y=0; y<AST_MAX_FDS; y++) {
01736          fdmap[max].fdno = y;  /* fd y is linked to this pfds */
01737          fdmap[max].chan = x;  /* channel x is linked to this pfds */
01738          max += ast_add_fd(&pfds[max], c[x]->fds[y]);
01739       }
01740       CHECK_BLOCKING(c[x]);
01741    }
01742    /* Add the individual fds */
01743    for (x=0; x<nfds; x++) {
01744       fdmap[max].chan = -1;
01745       max += ast_add_fd(&pfds[max], fds[x]);
01746    }
01747 
01748    if (*ms > 0)
01749       start = ast_tvnow();
01750    
01751    if (sizeof(int) == 4) { /* XXX fix timeout > 600000 on linux x86-32 */
01752       do {
01753          int kbrms = rms;
01754          if (kbrms > 600000)
01755             kbrms = 600000;
01756          res = poll(pfds, max, kbrms);
01757          if (!res)
01758             rms -= kbrms;
01759       } while (!res && (rms > 0));
01760    } else {
01761       res = poll(pfds, max, rms);
01762    }
01763    for (x=0; x<n; x++)
01764       ast_clear_flag(c[x], AST_FLAG_BLOCKING);
01765    if (res < 0) { /* Simulate a timeout if we were interrupted */
01766       if (errno != EINTR)
01767          *ms = -1;
01768       return NULL;
01769    }
01770    if (whentohangup) {   /* if we have a timeout, check who expired */
01771       time(&now);
01772       for (x=0; x<n; x++) {
01773          if (c[x]->whentohangup && now >= c[x]->whentohangup) {
01774             c[x]->_softhangup |= AST_SOFTHANGUP_TIMEOUT;
01775             if (winner == NULL)
01776                winner = c[x];
01777          }
01778       }
01779    }
01780    if (res == 0) { /* no fd ready, reset timeout and done */
01781       *ms = 0; /* XXX use 0 since we may not have an exact timeout. */
01782       return winner;
01783    }
01784    /*
01785     * Then check if any channel or fd has a pending event.
01786     * Remember to check channels first and fds last, as they
01787     * must have priority on setting 'winner'
01788     */
01789    for (x = 0; x < max; x++) {
01790       res = pfds[x].revents;
01791       if (res == 0)
01792          continue;
01793       if (fdmap[x].chan >= 0) {  /* this is a channel */
01794          winner = c[fdmap[x].chan]; /* override previous winners */
01795          if (res & POLLPRI)
01796             ast_set_flag(winner, AST_FLAG_EXCEPTION);
01797          else
01798             ast_clear_flag(winner, AST_FLAG_EXCEPTION);
01799          winner->fdno = fdmap[x].fdno;
01800       } else {       /* this is an fd */
01801          if (outfd)
01802             *outfd = pfds[x].fd;
01803          if (exception)
01804             *exception = (res & POLLPRI) ? -1 : 0;
01805          winner = NULL;
01806       }
01807    }
01808    if (*ms > 0) {
01809       *ms -= ast_tvdiff_ms(ast_tvnow(), start);
01810       if (*ms < 0)
01811          *ms = 0;
01812    }
01813    return winner;
01814 }

int ast_waitfordigit ( struct ast_channel c,
int  ms 
)

Waits for a digit.

!

Parameters:
c channel to wait for a digit on
ms how many milliseconds to wait
Returns:
Returns <0 on error, 0 on no entry, and the digit on success.

Definition at line 1832 of file channel.c.

References ast_waitfordigit_full().

Referenced by _while_exec(), advanced_options(), ast_adsi_get_cpeid(), ast_adsi_get_cpeinfo(), ast_adsi_print(), ast_adsi_read_encoded_dtmf(), ast_adsi_transmit_message_full(), ast_app_dtget(), ast_control_streamfile(), ast_record_review(), collect_digits(), common_exec(), cpeid_exec(), dialout(), directory_exec(), do_atxfer(), forward_message(), get_folder(), ivr_dispatch(), mgcp_ss(), my_getsigstr(), pbx_builtin_waitexten(), play_mailbox_owner(), play_record_review(), read_exec(), read_newoption(), retrydial_exec(), sendnoise(), ss_thread(), testclient_exec(), testserver_exec(), vm_execmain(), vm_forwardoptions(), vm_instructions(), vm_options(), vm_tempgreeting(), wait_a_bit(), and wait_our_turn().

01833 {
01834    return ast_waitfordigit_full(c, ms, -1, -1);
01835 }

int ast_waitfordigit_full ( struct ast_channel c,
int  ms,
int  audiofd,
int  ctrlfd 
)

Wait for a digit Same as ast_waitfordigit() with audio fd for outputting read audio and ctrlfd to monitor for reading.

Parameters:
c channel to wait for a digit on
ms how many milliseconds to wait
audiofd audio file descriptor to write to if audio frames are received
ctrlfd control file descriptor to monitor for reading
Returns:
Returns 1 if ctrlfd becomes available

Definition at line 1858 of file channel.c.

References ast_check_hangup(), ast_clear_flag, AST_CONTROL_ANSWER, AST_CONTROL_HANGUP, AST_CONTROL_RINGING, AST_CONTROL_SRCUPDATE, AST_FLAG_END_DTMF_ONLY, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, AST_FRAME_VOICE, ast_frfree, ast_log(), ast_read(), ast_set_flag, ast_test_flag, ast_waitfor_nandfds(), errno, and f.

Referenced by ast_readstring_full(), ast_waitfordigit(), handle_getoption(), and handle_waitfordigit().

01859 {
01860    /* Stop if we're a zombie or need a soft hangup */
01861    if (ast_test_flag(c, AST_FLAG_ZOMBIE) || ast_check_hangup(c))
01862       return -1;
01863 
01864    /* Only look for the end of DTMF, don't bother with the beginning and don't emulate things */
01865    ast_set_flag(c, AST_FLAG_END_DTMF_ONLY);
01866 
01867    /* Wait for a digit, no more than ms milliseconds total. */
01868    while (ms) {
01869       struct ast_channel *rchan;
01870       int outfd;
01871 
01872       errno = 0;
01873       rchan = ast_waitfor_nandfds(&c, 1, &cmdfd, (cmdfd > -1) ? 1 : 0, NULL, &outfd, &ms);
01874       if (!rchan && outfd < 0 && ms) {
01875          if (errno == 0 || errno == EINTR)
01876             continue;
01877          ast_log(LOG_WARNING, "Wait failed (%s)\n", strerror(errno));
01878          ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
01879          return -1;
01880       } else if (outfd > -1) {
01881          /* The FD we were watching has something waiting */
01882          ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
01883          return 1;
01884       } else if (rchan) {
01885          int res;
01886          struct ast_frame *f = ast_read(c);
01887          if (!f)
01888             return -1;
01889 
01890          switch(f->frametype) {
01891          case AST_FRAME_DTMF_BEGIN:
01892             break;
01893          case AST_FRAME_DTMF_END:
01894             res = f->subclass;
01895             ast_frfree(f);
01896             ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
01897             return res;
01898          case AST_FRAME_CONTROL:
01899             switch(f->subclass) {
01900             case AST_CONTROL_HANGUP:
01901                ast_frfree(f);
01902                ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
01903                return -1;
01904             case AST_CONTROL_RINGING:
01905             case AST_CONTROL_ANSWER:
01906             case AST_CONTROL_SRCUPDATE:
01907                /* Unimportant */
01908                break;
01909             default:
01910                ast_log(LOG_WARNING, "Unexpected control subclass '%d'\n", f->subclass);
01911                break;
01912             }
01913             break;
01914          case AST_FRAME_VOICE:
01915             /* Write audio if appropriate */
01916             if (audiofd > -1) {
01917                if (write(audiofd, f->data, f->datalen) < 0) {
01918                   ast_log(LOG_WARNING, "write() failed: %s\n", strerror(errno));
01919                }
01920             }
01921          default:
01922             /* Ignore */
01923             break;
01924          }
01925          ast_frfree(f);
01926       }
01927    }
01928 
01929    ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
01930 
01931    return 0; /* Time is up */
01932 }

struct ast_channel* ast_walk_channel_by_exten_locked ( const struct ast_channel chan,
const char *  exten,
const char *  context 
)

Get next channel by exten (and optionally context) and lock it.

Definition at line 1166 of file channel.c.

References channel_find_locked().

Referenced by next_channel().

01168 {
01169    return channel_find_locked(chan, NULL, 0, context, exten);
01170 }

struct ast_channel* ast_walk_channel_by_name_prefix_locked ( const struct ast_channel chan,
const char *  name,
const int  namelen 
)

Get channel by name prefix (locks channel).

Definition at line 1153 of file channel.c.

References channel_find_locked().

Referenced by next_channel().

01155 {
01156    return channel_find_locked(chan, name, namelen, NULL, NULL);
01157 }

int ast_write ( struct ast_channel chan,
struct ast_frame frame 
)

Write a frame to a channel This function writes the given frame to the indicated channel.

Parameters:
chan destination channel of the frame
frame frame that will be written
Returns:
It returns 0 on success, -1 on failure.

Todo:
XXX should return 0 maybe ?

Definition at line 2740 of file channel.c.

References ast_channel::_softhangup, AST_AUDIOHOOK_DIRECTION_WRITE, ast_audiohook_write_list(), ast_channel_lock, ast_channel_trylock, ast_channel_unlock, ast_check_hangup(), ast_clear_flag, AST_CONTROL_UNHOLD, ast_deactivate_generator(), ast_do_masquerade(), AST_FLAG_BLOCKING, AST_FLAG_WRITE_INT, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, ast_frame_dump(), AST_FRAME_HTML, AST_FRAME_IAX, AST_FRAME_MODEM, AST_FRAME_NULL, AST_FRAME_TEXT, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_frfree, ast_log(), AST_MONITOR_RUNNING, ast_seekstream(), ast_senddigit_begin(), ast_senddigit_end(), AST_SOFTHANGUP_DEV, ast_test_flag, ast_translate(), ast_writestream(), ast_channel::audiohooks, CHECK_BLOCKING, ast_frame::data, ast_frame::datalen, DEBUGCHAN_FLAG, f, ast_channel::fout, FRAMECOUNT_INC, ast_frame::frametype, ast_channel::generatordata, ast_channel_tech::indicate, ast_channel::insmpl, ast_frame::len, LOG_DEBUG, ast_channel::masq, ast_channel::masqr, ast_channel::monitor, MONITOR_DELAY, ast_channel::name, option_debug, ast_channel::outsmpl, ast_channel::rawwriteformat, SEEK_FORCECUR, ast_channel_tech::send_html, ast_channel_tech::send_text, ast_channel_monitor::state, ast_frame::subclass, ast_channel::tech, ast_channel_tech::write, ast_channel_monitor::write_stream, ast_channel_tech::write_video, and ast_channel::writetrans.

Referenced by adsi_careful_send(), agent_write(), ast_prod(), ast_readaudio_callback(), ast_readvideo_callback(), ast_udptl_bridge(), ast_write_video(), bridge_native_loop(), conf_queue_dtmf(), conf_run(), dahdi_bridge(), dictate_exec(), echo_exec(), features_write(), function_ilink(), gen_generate(), handle_link_data(), jb_get_and_deliver(), linear_generator(), milliwatt_generate(), misdn_bridge(), moh_files_generator(), moh_generate(), mp3_exec(), NBScat_exec(), rpt(), send_link_dtmf(), send_tone_burst(), send_waveform_to_channel(), silence_generator_generate(), spy_generate(), and wait_for_answer().

02741 {
02742    int res = -1;
02743    int count = 0;
02744    struct ast_frame *f = NULL, *f2 = NULL;
02745 
02746    /*Deadlock avoidance*/
02747    while(ast_channel_trylock(chan)) {
02748       /*cannot goto done since the channel is not locked*/
02749       if(count++ > 10) {
02750          if(option_debug)
02751             ast_log(LOG_DEBUG, "Deadlock avoided for write to channel '%s'\n", chan->name);
02752          return 0;
02753       }
02754       usleep(1);
02755    }
02756    /* Stop if we're a zombie or need a soft hangup */
02757    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan))
02758       goto done;
02759 
02760    /* Handle any pending masquerades */
02761    if (chan->masq && ast_do_masquerade(chan)) {
02762       ast_log(LOG_WARNING, "Failed to perform masquerade\n");
02763       goto done;
02764    }
02765    if (chan->masqr) {
02766       res = 0; /* XXX explain, why 0 ? */
02767       goto done;
02768    }
02769    if (chan->generatordata) {
02770       if (ast_test_flag(chan, AST_FLAG_WRITE_INT))
02771          ast_deactivate_generator(chan);
02772       else {
02773          if (fr->frametype == AST_FRAME_DTMF_END) {
02774             /* There is a generator running while we're in the middle of a digit.
02775              * It's probably inband DTMF, so go ahead and pass it so it can
02776              * stop the generator */
02777             ast_clear_flag(chan, AST_FLAG_BLOCKING);
02778             ast_channel_unlock(chan);
02779             res = ast_senddigit_end(chan, fr->subclass, fr->len);
02780             ast_channel_lock(chan);
02781             CHECK_BLOCKING(chan);
02782          } else if (fr->frametype == AST_FRAME_CONTROL && fr->subclass == AST_CONTROL_UNHOLD) {
02783             /* This is a side case where Echo is basically being called and the person put themselves on hold and took themselves off hold */
02784             res = (chan->tech->indicate == NULL) ? 0 :
02785                chan->tech->indicate(chan, fr->subclass, fr->data, fr->datalen);
02786          }
02787          res = 0; /* XXX explain, why 0 ? */
02788          goto done;
02789       }
02790    }
02791    /* High bit prints debugging */
02792    if (chan->fout & DEBUGCHAN_FLAG)
02793       ast_frame_dump(chan->name, fr, ">>");
02794    CHECK_BLOCKING(chan);
02795    switch(fr->frametype) {
02796    case AST_FRAME_CONTROL:
02797       res = (chan->tech->indicate == NULL) ? 0 :
02798          chan->tech->indicate(chan, fr->subclass, fr->data, fr->datalen);
02799       break;
02800    case AST_FRAME_DTMF_BEGIN:
02801       if (chan->audiohooks) {
02802          struct ast_frame *old_frame = fr;
02803          fr = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_WRITE, fr);
02804          if (old_frame != fr)
02805             f = fr;
02806       }
02807       ast_clear_flag(chan, AST_FLAG_BLOCKING);
02808       ast_channel_unlock(chan);
02809       res = ast_senddigit_begin(chan, fr->subclass);
02810       ast_channel_lock(chan);
02811       CHECK_BLOCKING(chan);
02812       break;
02813    case AST_FRAME_DTMF_END:
02814       if (chan->audiohooks) {
02815          struct ast_frame *old_frame = fr;
02816          fr = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_WRITE, fr);
02817          if (old_frame != fr)
02818             f = fr;
02819       }
02820       ast_clear_flag(chan, AST_FLAG_BLOCKING);
02821       ast_channel_unlock(chan);
02822       res = ast_senddigit_end(chan, fr->subclass, fr->len);
02823       ast_channel_lock(chan);
02824       CHECK_BLOCKING(chan);
02825       break;
02826    case AST_FRAME_TEXT:
02827       res = (chan->tech->send_text == NULL) ? 0 :
02828          chan->tech->send_text(chan, (char *) fr->data);
02829       break;
02830    case AST_FRAME_HTML:
02831       res = (chan->tech->send_html == NULL) ? 0 :
02832          chan->tech->send_html(chan, fr->subclass, (char *) fr->data, fr->datalen);
02833       break;
02834    case AST_FRAME_VIDEO:
02835       /* XXX Handle translation of video codecs one day XXX */
02836       res = (chan->tech->write_video == NULL) ? 0 :
02837          chan->tech->write_video(chan, fr);
02838       break;
02839    case AST_FRAME_MODEM:
02840       res = (chan->tech->write == NULL) ? 0 :
02841          chan->tech->write(chan, fr);
02842       break;
02843    case AST_FRAME_VOICE:
02844       if (chan->tech->write == NULL)
02845          break;   /*! \todo XXX should return 0 maybe ? */
02846 
02847       if (chan->audiohooks) {
02848          struct ast_frame *old_frame = fr;
02849          fr = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_WRITE, fr);
02850          if (old_frame != fr)
02851             f2 = fr;
02852       }
02853       
02854       /* If the frame is in the raw write format, then it's easy... just use the frame - otherwise we will have to translate */
02855       if (fr->subclass == chan->rawwriteformat)
02856          f = fr;
02857       else
02858          f = (chan->writetrans) ? ast_translate(chan->writetrans, fr, 0) : fr;
02859 
02860       /* If we have no frame of audio, then we have to bail out */
02861       if (!f) {
02862          res = 0;
02863          break;
02864       }
02865 
02866       /* If Monitor is running on this channel, then we have to write frames out there too */
02867       if (chan->monitor && chan->monitor->write_stream) {
02868          /* XXX must explain this code */
02869 #ifndef MONITOR_CONSTANT_DELAY
02870          int jump = chan->insmpl - chan->outsmpl - 4 * f->samples;
02871          if (jump >= 0) {
02872             jump = chan->insmpl - chan->outsmpl;
02873             if (ast_seekstream(chan->monitor->write_stream, jump, SEEK_FORCECUR) == -1)
02874                ast_log(LOG_WARNING, "Failed to perform seek in monitoring write stream, synchronization between the files may be broken\n");
02875             chan->outsmpl += jump + f->samples;
02876          } else
02877             chan->outsmpl += f->samples;
02878 #else
02879          int jump = chan->insmpl - chan->outsmpl;
02880          if (jump - MONITOR_DELAY >= 0) {
02881             if (ast_seekstream(chan->monitor->write_stream, jump - f->samples, SEEK_FORCECUR) == -1)
02882                ast_log(LOG_WARNING, "Failed to perform seek in monitoring write stream, synchronization between the files may be broken\n");
02883             chan->outsmpl += jump;
02884          } else
02885             chan->outsmpl += f->samples;
02886 #endif
02887          if (chan->monitor->state == AST_MONITOR_RUNNING) {
02888             if (ast_writestream(chan->monitor->write_stream, f) < 0)
02889                ast_log(LOG_WARNING, "Failed to write data to channel monitor write stream\n");
02890          }
02891       }
02892 
02893       if (f) 
02894          res = chan->tech->write(chan,f);
02895       else
02896          res = 0;
02897       break;
02898    case AST_FRAME_NULL:
02899    case AST_FRAME_IAX:
02900       /* Ignore these */
02901       res = 0;
02902       break;
02903    default:
02904       /* At this point, fr is the incoming frame and f is NULL.  Channels do
02905        * not expect to get NULL as a frame pointer and will segfault.  Hence,
02906        * we output the original frame passed in. */
02907       res = chan->tech->write(chan, fr);
02908       break;
02909    }
02910 
02911    if (f && f != fr)
02912       ast_frfree(f);
02913    if (f2)
02914       ast_frfree(f2);
02915    ast_clear_flag(chan, AST_FLAG_BLOCKING);
02916    /* Consider a write failure to force a soft hangup */
02917    if (res < 0)
02918       chan->_softhangup |= AST_SOFTHANGUP_DEV;
02919    else {
02920       chan->fout = FRAMECOUNT_INC(chan->fout);
02921    }
02922 done:
02923    ast_channel_unlock(chan);
02924    return res;
02925 }

int ast_write_video ( struct ast_channel chan,
struct ast_frame frame 
)

Write video frame to a channel This function writes the given frame to the indicated channel.

Parameters:
chan destination channel of the frame
frame frame that will be written
Returns:
It returns 1 on success, 0 if not implemented, and -1 on failure.

Definition at line 2729 of file channel.c.

References ast_write(), ast_channel::tech, and ast_channel_tech::write_video.

02730 {
02731    int res;
02732    if (!chan->tech->write_video)
02733       return 0;
02734    res = ast_write(chan, fr);
02735    if (!res)
02736       res = 1;
02737    return res;
02738 }

static void bridge_playfile ( struct ast_channel chan,
struct ast_channel peer,
const char *  sound,
int  remain 
) [static]

Definition at line 3873 of file channel.c.

References ast_autoservice_start(), ast_autoservice_stop(), AST_DIGIT_ANY, ast_say_number(), ast_stream_and_wait(), and ast_channel::language.

Referenced by ast_channel_bridge().

03874 {
03875    int min = 0, sec = 0, check;
03876 
03877    check = ast_autoservice_start(peer);
03878    if (check)
03879       return;
03880 
03881    if (remain > 0) {
03882       if (remain / 60 > 1) {
03883          min = remain / 60;
03884          sec = remain % 60;
03885       } else {
03886          sec = remain;
03887       }
03888    }
03889    
03890    if (!strcmp(sound,"timeleft")) { /* Queue support */
03891       ast_stream_and_wait(chan, "vm-youhave", chan->language, "");
03892       if (min) {
03893          ast_say_number(chan, min, AST_DIGIT_ANY, chan->language, NULL);
03894          ast_stream_and_wait(chan, "queue-minutes", chan->language, "");
03895       }
03896       if (sec) {
03897          ast_say_number(chan, sec, AST_DIGIT_ANY, chan->language, NULL);
03898          ast_stream_and_wait(chan, "queue-seconds", chan->language, "");
03899       }
03900    } else {
03901       ast_stream_and_wait(chan, sound, chan->language, "");
03902    }
03903 
03904    ast_autoservice_stop(peer);
03905 }

static struct ast_channel* channel_find_locked ( const struct ast_channel prev,
const char *  name,
const int  namelen,
const char *  context,
const char *  exten 
) [static]

Helper function to find channels.

It supports these modes:

prev != NULL : get channel next in list after prev name != NULL : get channel with matching name name != NULL && namelen != 0 : get channel whose name starts with prefix exten != NULL : get channel whose exten or macroexten matches context != NULL && exten != NULL : get channel whose context or macrocontext

It returns with the channel's lock held. If getting the individual lock fails, unlock and retry quickly up to 10 times, then give up.

Note:
XXX Note that this code has cost O(N) because of the need to verify that the object is still on the global list.

XXX also note that accessing fields (e.g. c->name in ast_log()) can only be done with the lock held or someone could delete the object while we work on it. This causes some ugliness in the code. Note that removing the first ast_log() may be harmful, as it would shorten the retry period and possibly cause failures. We should definitely go for a better scheme that is deadlock-free.

Note:
We're done searching through the list for the previous item. Any item after this point, we want to evaluate for a match. If we didn't set prev to NULL here, then we would only return matches for the first matching item (since the above "if (c != prev)" would not permit any other potential matches to reach the additional matching logic, below). Instead, it would just iterate until it once again found the original match, then iterate down to the end of the list and quit.

Definition at line 1049 of file channel.c.

References ast_channel_trylock, AST_LIST_LOCK, AST_LIST_NEXT, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_channel::context, ast_channel::exten, LOG_DEBUG, ast_channel::macrocontext, ast_channel::macroexten, ast_channel::name, and option_debug.

Referenced by ast_channel_walk_locked(), ast_get_channel_by_exten_locked(), ast_get_channel_by_name_locked(), ast_get_channel_by_name_prefix_locked(), ast_walk_channel_by_exten_locked(), and ast_walk_channel_by_name_prefix_locked().

01052 {
01053    const char *msg = prev ? "deadlock" : "initial deadlock";
01054    int retries;
01055    struct ast_channel *c;
01056    const struct ast_channel *_prev = prev;
01057 
01058    for (retries = 0; retries < 200; retries++) {
01059       int done;
01060       /* Reset prev on each retry.  See note below for the reason. */
01061       prev = _prev;
01062       AST_LIST_LOCK(&channels);
01063       AST_LIST_TRAVERSE(&channels, c, chan_list) {
01064          if (prev) { /* look for last item, first, before any evaluation */
01065             if (c != prev) /* not this one */
01066                continue;
01067             /* found, prepare to return c->next */
01068             if ((c = AST_LIST_NEXT(c, chan_list)) == NULL) break;
01069             /*!\note
01070              * We're done searching through the list for the previous item.
01071              * Any item after this point, we want to evaluate for a match.
01072              * If we didn't set prev to NULL here, then we would only
01073              * return matches for the first matching item (since the above
01074              * "if (c != prev)" would not permit any other potential
01075              * matches to reach the additional matching logic, below).
01076              * Instead, it would just iterate until it once again found the
01077              * original match, then iterate down to the end of the list and
01078              * quit.
01079              */
01080             prev = NULL;
01081          }
01082          if (name) { /* want match by name */
01083             if ((!namelen && strcasecmp(c->name, name)) ||
01084                 (namelen && strncasecmp(c->name, name, namelen)))
01085                continue;   /* name match failed */
01086          } else if (exten) {
01087             if (context && strcasecmp(c->context, context) &&
01088                 strcasecmp(c->macrocontext, context))
01089                continue;   /* context match failed */
01090             if (strcasecmp(c->exten, exten) &&
01091                 strcasecmp(c->macroexten, exten))
01092                continue;   /* exten match failed */
01093          }
01094          /* if we get here, c points to the desired record */
01095          break;
01096       }
01097       /* exit if chan not found or mutex acquired successfully */
01098       /* this is slightly unsafe, as we _should_ hold the lock to access c->name */
01099       done = c == NULL || ast_channel_trylock(c) == 0;
01100       if (!done) {
01101          if (option_debug)
01102             ast_log(LOG_DEBUG, "Avoiding %s for channel '%p'\n", msg, c);
01103          if (retries == 199) {
01104             /* We are about to fail due to a deadlock, so report this
01105              * while we still have the list lock.
01106              */
01107             if (option_debug)
01108                ast_log(LOG_DEBUG, "Failure, could not lock '%p' after %d retries!\n", c, retries);
01109             /* As we have deadlocked, we will skip this channel and
01110              * see if there is another match.
01111              * NOTE: No point doing this for a full-name match,
01112              * as there can be no more matches.
01113              */
01114             if (!(name && !namelen)) {
01115                prev = c;
01116                retries = -1;
01117             }
01118          }
01119       }
01120       AST_LIST_UNLOCK(&channels);
01121       if (done)
01122          return c;
01123       /* If we reach this point we basically tried to lock a channel and failed. Instead of
01124        * starting from the beginning of the list we can restore our saved pointer to the previous
01125        * channel and start from there.
01126        */
01127       prev = _prev;
01128       usleep(1);  /* give other threads a chance before retrying */
01129    }
01130 
01131    return NULL;
01132 }

const char* channelreloadreason2txt ( enum channelreloadreason  reason  ) 

Convert enum channelreloadreason to text string for manager event.

\ brief Convert channel reloadreason (ENUM) to text string for manager event

Definition at line 4711 of file channel.c.

References CHANNEL_CLI_RELOAD, CHANNEL_MODULE_LOAD, and CHANNEL_MODULE_RELOAD.

04712 {
04713    switch (reason) {
04714    case CHANNEL_MODULE_LOAD:
04715       return "LOAD (Channel module load)";
04716 
04717    case CHANNEL_MODULE_RELOAD:
04718       return "RELOAD (Channel module reload)";
04719 
04720    case CHANNEL_CLI_RELOAD:
04721       return "CLIRELOAD (Channel module reload by CLI command)";
04722 
04723    default:
04724       return "MANAGERRELOAD (Channel module reload by manager)";
04725    }
04726 };

static void clone_variables ( struct ast_channel original,
struct ast_channel clone 
) [static]

Clone channel variables from 'clone' channel into 'original' channel.

All variables except those related to app_groupcount are cloned. Variables are actually _removed_ from 'clone' channel, presumably because it will subsequently be destroyed.

Note:
Assumes locks will be in place on both channels when called.

Definition at line 3500 of file channel.c.

References AST_LIST_APPEND_LIST, AST_LIST_FIRST, AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_var_assign(), ast_var_t::entries, ast_var_t::name, ast_var_t::value, and ast_channel::varshead.

Referenced by ast_do_masquerade().

03501 {
03502    struct ast_var_t *current, *newvar;
03503    /* Append variables from clone channel into original channel */
03504    /* XXX Is this always correct?  We have to in order to keep MACROS working XXX */
03505    if (AST_LIST_FIRST(&clone->varshead))
03506       AST_LIST_APPEND_LIST(&original->varshead, &clone->varshead, entries);
03507 
03508    /* then, dup the varshead list into the clone */
03509    
03510    AST_LIST_TRAVERSE(&original->varshead, current, entries) {
03511       newvar = ast_var_assign(current->name, current->value);
03512       if (newvar)
03513          AST_LIST_INSERT_TAIL(&clone->varshead, newvar, entries);
03514    }
03515 }

static char* complete_channeltypes ( const char *  line,
const char *  word,
int  pos,
int  state 
) [static]

Definition at line 334 of file channel.c.

References AST_LIST_TRAVERSE, chanlist::list, strdup, chanlist::tech, and ast_channel_tech::type.

00335 {
00336    struct chanlist *cl;
00337    int which = 0;
00338    int wordlen;
00339    char *ret = NULL;
00340 
00341    if (pos != 3)
00342       return NULL;
00343 
00344    wordlen = strlen(word);
00345 
00346    AST_LIST_TRAVERSE(&backends, cl, list) {
00347       if (!strncasecmp(word, cl->tech->type, wordlen) && ++which > state) {
00348          ret = strdup(cl->tech->type);
00349          break;
00350       }
00351    }
00352    
00353    return ret;
00354 }

static char* complete_channeltypes_deprecated ( const char *  line,
const char *  word,
int  pos,
int  state 
) [static]

Definition at line 312 of file channel.c.

References AST_LIST_TRAVERSE, chanlist::list, strdup, chanlist::tech, and ast_channel_tech::type.

00313 {
00314    struct chanlist *cl;
00315    int which = 0;
00316    int wordlen;
00317    char *ret = NULL;
00318 
00319    if (pos != 2)
00320       return NULL;
00321 
00322    wordlen = strlen(word);
00323 
00324    AST_LIST_TRAVERSE(&backends, cl, list) {
00325       if (!strncasecmp(word, cl->tech->type, wordlen) && ++which > state) {
00326          ret = strdup(cl->tech->type);
00327          break;
00328       }
00329    }
00330    
00331    return ret;
00332 }

static void free_cid ( struct ast_callerid cid  )  [static]

Definition at line 1199 of file channel.c.

References ast_callerid::cid_ani, ast_callerid::cid_dnid, ast_callerid::cid_name, ast_callerid::cid_num, ast_callerid::cid_rdnis, and free.

Referenced by ast_channel_free().

01200 {
01201    if (cid->cid_dnid)
01202       free(cid->cid_dnid);
01203    if (cid->cid_num)
01204       free(cid->cid_num);  
01205    if (cid->cid_name)
01206       free(cid->cid_name); 
01207    if (cid->cid_ani)
01208       free(cid->cid_ani);
01209    if (cid->cid_rdnis)
01210       free(cid->cid_rdnis);
01211 }

static void free_translation ( struct ast_channel clone  )  [static]

Definition at line 1446 of file channel.c.

References ast_translator_free_path(), ast_channel::nativeformats, ast_channel::rawreadformat, ast_channel::rawwriteformat, ast_channel::readtrans, and ast_channel::writetrans.

Referenced by ast_do_masquerade(), and ast_hangup().

01447 {
01448    if (clone->writetrans)
01449       ast_translator_free_path(clone->writetrans);
01450    if (clone->readtrans)
01451       ast_translator_free_path(clone->readtrans);
01452    clone->writetrans = NULL;
01453    clone->readtrans = NULL;
01454    clone->rawwriteformat = clone->nativeformats;
01455    clone->rawreadformat = clone->nativeformats;
01456 }

static int generator_force ( const void *  data  )  [static]

Definition at line 1601 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_deactivate_generator(), AST_FORMAT_AUDIO_MASK, ast_format_rate(), ast_log(), LOG_DEBUG, and option_debug.

Referenced by ast_activate_generator(), and ast_read_generator_actions().

01602 {
01603    /* Called if generator doesn't have data */
01604    void *tmp;
01605    int res;
01606    int (*generate)(struct ast_channel *chan, void *tmp, int datalen, int samples) = NULL;
01607    struct ast_channel *chan = (struct ast_channel *)data;
01608 
01609    ast_channel_lock(chan);
01610    tmp = chan->generatordata;
01611    chan->generatordata = NULL;
01612    if (chan->generator)
01613       generate = chan->generator->generate;
01614    ast_channel_unlock(chan);
01615 
01616    if (!tmp || !generate)
01617       return 0;
01618 
01619    res = generate(chan, tmp, 0, ast_format_rate(chan->writeformat & AST_FORMAT_AUDIO_MASK) / 50);
01620 
01621    chan->generatordata = tmp;
01622 
01623    if (res) {
01624       if (option_debug)
01625          ast_log(LOG_DEBUG, "Auto-deactivating generator\n");
01626       ast_deactivate_generator(chan);
01627    }
01628 
01629    return 0;
01630 }

static int attribute_const is_visible_indication ( enum ast_control_frame_type  condition  )  [static]

Definition at line 2464 of file channel.c.

References AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_OFFHOOK, AST_CONTROL_OPTION, AST_CONTROL_PROCEEDING, AST_CONTROL_PROGRESS, AST_CONTROL_RADIO_KEY, AST_CONTROL_RADIO_UNKEY, AST_CONTROL_RING, AST_CONTROL_RINGING, AST_CONTROL_SRCUPDATE, AST_CONTROL_TAKEOFFHOOK, AST_CONTROL_UNHOLD, AST_CONTROL_VIDUPDATE, and AST_CONTROL_WINK.

Referenced by ast_indicate_data().

02465 {
02466    /* Don't include a default case here so that we get compiler warnings
02467     * when a new type is added. */
02468 
02469    switch (condition) {
02470    case AST_CONTROL_PROGRESS:
02471    case AST_CONTROL_PROCEEDING:
02472    case AST_CONTROL_VIDUPDATE:
02473    case AST_CONTROL_SRCUPDATE:
02474    case AST_CONTROL_RADIO_KEY:
02475    case AST_CONTROL_RADIO_UNKEY:
02476    case AST_CONTROL_OPTION:
02477    case AST_CONTROL_WINK:
02478    case AST_CONTROL_FLASH:
02479    case AST_CONTROL_OFFHOOK:
02480    case AST_CONTROL_TAKEOFFHOOK:
02481    case AST_CONTROL_ANSWER:
02482    case AST_CONTROL_HANGUP:
02483       return 0;
02484 
02485    case AST_CONTROL_CONGESTION:
02486    case AST_CONTROL_BUSY:
02487    case AST_CONTROL_RINGING:
02488    case AST_CONTROL_RING:
02489    case AST_CONTROL_HOLD:
02490    case AST_CONTROL_UNHOLD:
02491       return 1;
02492    }
02493 
02494    return 0;
02495 }

static void queue_dtmf_readq ( struct ast_channel chan,
struct ast_frame f 
) [inline, static]

Definition at line 1988 of file channel.c.

References AST_FRAME_DTMF_END, ast_queue_frame(), ast_channel::dtmff, f, ast_frame::frametype, ast_frame::len, and ast_frame::subclass.

Referenced by __ast_read().

01989 {
01990    struct ast_frame *fr = &chan->dtmff;
01991 
01992    fr->frametype = AST_FRAME_DTMF_END;
01993    fr->subclass = f->subclass;
01994    fr->len = f->len;
01995 
01996    /* The only time this function will be called is for a frame that just came
01997     * out of the channel driver.  So, we want to stick it on the tail of the
01998     * readq. */
01999 
02000    ast_queue_frame(chan, fr);
02001 }

static int set_format ( struct ast_channel chan,
int  fmt,
int *  rawformat,
int *  format,
struct ast_trans_pvt **  trans,
const int  direction 
) [static]

Definition at line 2927 of file channel.c.

References ast_channel_lock, ast_channel_unlock, AST_FORMAT_AUDIO_MASK, ast_getformatname(), ast_getformatname_multiple(), ast_log(), ast_translator_best_choice(), ast_translator_build_path(), ast_translator_free_path(), LOG_DEBUG, ast_channel::name, ast_channel::nativeformats, and option_debug.

Referenced by ast_set_read_format(), and ast_set_write_format().

02929 {
02930    int native;
02931    int res;
02932    char from[200], to[200];
02933    
02934    /* Make sure we only consider audio */
02935    fmt &= AST_FORMAT_AUDIO_MASK;
02936    
02937    native = chan->nativeformats;
02938    /* Find a translation path from the native format to one of the desired formats */
02939    if (!direction)
02940       /* reading */
02941       res = ast_translator_best_choice(&fmt, &native);
02942    else
02943       /* writing */
02944       res = ast_translator_best_choice(&native, &fmt);
02945 
02946    if (res < 0) {
02947       ast_log(LOG_WARNING, "Unable to find a codec translation path from %s to %s\n",
02948          ast_getformatname_multiple(from, sizeof(from), native),
02949          ast_getformatname_multiple(to, sizeof(to), fmt));
02950       return -1;
02951    }
02952    
02953    /* Now we have a good choice for both. */
02954    ast_channel_lock(chan);
02955 
02956    if ((*rawformat == native) && (*format == fmt) && ((*rawformat == *format) || (*trans))) {
02957       /* the channel is already in these formats, so nothing to do */
02958       ast_channel_unlock(chan);
02959       return 0;
02960    }
02961 
02962    *rawformat = native;
02963    /* User perspective is fmt */
02964    *format = fmt;
02965    /* Free any read translation we have right now */
02966    if (*trans)
02967       ast_translator_free_path(*trans);
02968    /* Build a translation path from the raw format to the desired format */
02969    if (!direction)
02970       /* reading */
02971       *trans = ast_translator_build_path(*format, *rawformat);
02972    else
02973       /* writing */
02974       *trans = ast_translator_build_path(*rawformat, *format);
02975    ast_channel_unlock(chan);
02976    if (option_debug)
02977       ast_log(LOG_DEBUG, "Set channel %s to %s format %s\n", chan->name,
02978          direction ? "write" : "read", ast_getformatname(fmt));
02979    return 0;
02980 }

static int should_skip_dtmf ( struct ast_channel chan  )  [inline, static]

Determine whether or not we should ignore DTMF in the readq.

Definition at line 2006 of file channel.c.

References AST_FLAG_DEFER_DTMF, AST_FLAG_EMULATE_DTMF, AST_MIN_DTMF_GAP, ast_test_flag, ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), and ast_channel::dtmf_tv.

Referenced by __ast_read().

02007 {
02008    if (ast_test_flag(chan, AST_FLAG_DEFER_DTMF | AST_FLAG_EMULATE_DTMF)) {
02009       /* We're in the middle of emulating a digit, or DTMF has been
02010        * explicitly deferred.  Skip this digit, then. */
02011       return 1;
02012    }
02013          
02014    if (!ast_tvzero(chan->dtmf_tv) && 
02015          ast_tvdiff_ms(ast_tvnow(), chan->dtmf_tv) < AST_MIN_DTMF_GAP) {
02016       /* We're not in the middle of a digit, but it hasn't been long enough
02017        * since the last digit, so we'll have to skip DTMF for now. */
02018       return 1;
02019    }
02020 
02021    return 0;
02022 }

static int show_channeltype ( int  fd,
int  argc,
char *  argv[] 
) [static]

Definition at line 259 of file channel.c.

References ast_cli(), AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_channel_tech::capabilities, ast_channel_tech::devicestate, ast_channel_tech::indicate, chanlist::list, LOG_WARNING, RESULT_FAILURE, RESULT_SHOWUSAGE, RESULT_SUCCESS, ast_channel_tech::send_digit_begin, ast_channel_tech::send_digit_end, ast_channel_tech::send_html, ast_channel_tech::send_image, ast_channel_tech::send_text, chanlist::tech, ast_channel_tech::transfer, and ast_channel_tech::type.

00260 {
00261    struct chanlist *cl = NULL;
00262 
00263    if (argc != 4)
00264       return RESULT_SHOWUSAGE;
00265    
00266    if (AST_LIST_LOCK(&channels)) {
00267       ast_log(LOG_WARNING, "Unable to lock channel list\n");
00268       return RESULT_FAILURE;
00269    }
00270 
00271    AST_LIST_TRAVERSE(&backends, cl, list) {
00272       if (!strncasecmp(cl->tech->type, argv[3], strlen(cl->tech->type))) {
00273          break;
00274       }
00275    }
00276 
00277 
00278    if (!cl) {
00279       ast_cli(fd, "\n%s is not a registered channel driver.\n", argv[3]);
00280       AST_LIST_UNLOCK(&channels);
00281       return RESULT_FAILURE;
00282    }
00283 
00284    ast_cli(fd,
00285       "-- Info about channel driver: %s --\n"
00286       "  Device State: %s\n"
00287       "    Indication: %s\n"
00288       "     Transfer : %s\n"
00289       "  Capabilities: %d\n"
00290       "   Digit Begin: %s\n"
00291       "     Digit End: %s\n"
00292       "    Send HTML : %s\n"
00293       " Image Support: %s\n"
00294       "  Text Support: %s\n",
00295       cl->tech->type,
00296       (cl->tech->devicestate) ? "yes" : "no",
00297       (cl->tech->indicate) ? "yes" : "no",
00298       (cl->tech->transfer) ? "yes" : "no",
00299       (cl->tech->capabilities) ? cl->tech->capabilities : -1,
00300       (cl->tech->send_digit_begin) ? "yes" : "no",
00301       (cl->tech->send_digit_end) ? "yes" : "no",
00302       (cl->tech->send_html) ? "yes" : "no",
00303       (cl->tech->send_image) ? "yes" : "no",
00304       (cl->tech->send_text) ? "yes" : "no"
00305       
00306    );
00307 
00308    AST_LIST_UNLOCK(&channels);
00309    return RESULT_SUCCESS;
00310 }

static int show_channeltype_deprecated ( int  fd,
int  argc,
char *  argv[] 
) [static]

Definition at line 206 of file channel.c.

References ast_cli(), AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_channel_tech::capabilities, ast_channel_tech::devicestate, ast_channel_tech::indicate, chanlist::list, LOG_WARNING, RESULT_FAILURE, RESULT_SHOWUSAGE, RESULT_SUCCESS, ast_channel_tech::send_digit_begin, ast_channel_tech::send_digit_end, ast_channel_tech::send_html, ast_channel_tech::send_image, ast_channel_tech::send_text, chanlist::tech, ast_channel_tech::transfer, and ast_channel_tech::type.

00207 {
00208    struct chanlist *cl = NULL;
00209 
00210    if (argc != 3)
00211       return RESULT_SHOWUSAGE;
00212    
00213    if (AST_LIST_LOCK(&channels)) {
00214       ast_log(LOG_WARNING, "Unable to lock channel list\n");
00215       return RESULT_FAILURE;
00216    }
00217 
00218    AST_LIST_TRAVERSE(&backends, cl, list) {
00219       if (!strncasecmp(cl->tech->type, argv[2], strlen(cl->tech->type))) {
00220          break;
00221       }
00222    }
00223 
00224 
00225    if (!cl) {
00226       ast_cli(fd, "\n%s is not a registered channel driver.\n", argv[2]);
00227       AST_LIST_UNLOCK(&channels);
00228       return RESULT_FAILURE;
00229    }
00230 
00231    ast_cli(fd,
00232       "-- Info about channel driver: %s --\n"
00233       "  Device State: %s\n"
00234       "    Indication: %s\n"
00235       "     Transfer : %s\n"
00236       "  Capabilities: %d\n"
00237       "   Digit Begin: %s\n"
00238       "     Digit End: %s\n"
00239       "    Send HTML : %s\n"
00240       " Image Support: %s\n"
00241       "  Text Support: %s\n",
00242       cl->tech->type,
00243       (cl->tech->devicestate) ? "yes" : "no",
00244       (cl->tech->indicate) ? "yes" : "no",
00245       (cl->tech->transfer) ? "yes" : "no",
00246       (cl->tech->capabilities) ? cl->tech->capabilities : -1,
00247       (cl->tech->send_digit_begin) ? "yes" : "no",
00248       (cl->tech->send_digit_end) ? "yes" : "no",
00249       (cl->tech->send_html) ? "yes" : "no",
00250       (cl->tech->send_image) ? "yes" : "no",
00251       (cl->tech->send_text) ? "yes" : "no"
00252       
00253    );
00254 
00255    AST_LIST_UNLOCK(&channels);
00256    return RESULT_SUCCESS;
00257 }

static int show_channeltypes ( int  fd,
int  argc,
char *  argv[] 
) [static]

Definition at line 179 of file channel.c.

References ast_cli(), AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_channel_tech::description, ast_channel_tech::devicestate, FORMAT, ast_channel_tech::indicate, chanlist::list, LOG_WARNING, RESULT_SUCCESS, chanlist::tech, ast_channel_tech::transfer, and ast_channel_tech::type.

00180 {
00181 #define FORMAT  "%-10.10s  %-40.40s %-12.12s %-12.12s %-12.12s\n"
00182    struct chanlist *cl;
00183    int count_chan = 0;
00184 
00185    ast_cli(fd, FORMAT, "Type", "Description",       "Devicestate", "Indications", "Transfer");
00186    ast_cli(fd, FORMAT, "----------", "-----------", "-----------", "-----------", "--------");
00187    if (AST_LIST_LOCK(&channels)) {
00188       ast_log(LOG_WARNING, "Unable to lock channel list\n");
00189       return -1;
00190    }
00191    AST_LIST_TRAVERSE(&backends, cl, list) {
00192       ast_cli(fd, FORMAT, cl->tech->type, cl->tech->description,
00193          (cl->tech->devicestate) ? "yes" : "no",
00194          (cl->tech->indicate) ? "yes" : "no",
00195          (cl->tech->transfer) ? "yes" : "no");
00196       count_chan++;
00197    }
00198    AST_LIST_UNLOCK(&channels);
00199    ast_cli(fd, "----------\n%d channel drivers registered.\n", count_chan);
00200    return RESULT_SUCCESS;
00201 
00202 #undef FORMAT
00203 
00204 }

static void* silence_generator_alloc ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 4632 of file channel.c.

04633 {
04634    /* just store the data pointer in the channel structure */
04635    return data;
04636 }

static int silence_generator_generate ( struct ast_channel chan,
void *  data,
int  len,
int  samples 
) [static]

Definition at line 4643 of file channel.c.

References AST_FORMAT_SLINEAR, AST_FRAME_VOICE, ast_write(), and ast_frame::frametype.

04644 {
04645    short buf[samples];
04646    struct ast_frame frame = {
04647       .frametype = AST_FRAME_VOICE,
04648       .subclass = AST_FORMAT_SLINEAR,
04649       .data = buf,
04650       .samples = samples,
04651       .datalen = sizeof(buf),
04652    };
04653    memset(buf, 0, sizeof(buf));
04654    if (ast_write(chan, &frame))
04655       return -1;
04656    return 0;
04657 }

static void silence_generator_release ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 4638 of file channel.c.

04639 {
04640    /* nothing to do */
04641 }

static void state2str_threadbuf_init ( void   )  [static]

Definition at line 84 of file channel.c.

00098 {

static void* tonepair_alloc ( struct ast_channel chan,
void *  params 
) [static]

Definition at line 4396 of file channel.c.

References ast_calloc, AST_FLAG_WRITE_INT, AST_FORMAT_SLINEAR, ast_log(), ast_set_flag, ast_set_write_format(), tonepair_def::duration, tonepair_def::freq1, tonepair_def::freq2, ast_channel::name, tonepair_release(), tonepair_def::vol, and ast_channel::writeformat.

04397 {
04398    struct tonepair_state *ts;
04399    struct tonepair_def *td = params;
04400 
04401    if (!(ts = ast_calloc(1, sizeof(*ts))))
04402       return NULL;
04403    ts->origwfmt = chan->writeformat;
04404    if (ast_set_write_format(chan, AST_FORMAT_SLINEAR)) {
04405       ast_log(LOG_WARNING, "Unable to set '%s' to signed linear format (write)\n", chan->name);
04406       tonepair_release(NULL, ts);
04407       ts = NULL;
04408    } else {
04409       ts->fac1 = 2.0 * cos(2.0 * M_PI * (td->freq1 / 8000.0)) * 32768.0;
04410       ts->v1_1 = 0;
04411       ts->v2_1 = sin(-4.0 * M_PI * (td->freq1 / 8000.0)) * td->vol;
04412       ts->v3_1 = sin(-2.0 * M_PI * (td->freq1 / 8000.0)) * td->vol;
04413       ts->v2_1 = 0;
04414       ts->fac2 = 2.0 * cos(2.0 * M_PI * (td->freq2 / 8000.0)) * 32768.0;
04415       ts->v2_2 = sin(-4.0 * M_PI * (td->freq2 / 8000.0)) * td->vol;
04416       ts->v3_2 = sin(-2.0 * M_PI * (td->freq2 / 8000.0)) * td->vol;
04417       ts->duration = td->duration;
04418       ts->modulate = 0;
04419    }
04420    /* Let interrupts interrupt :) */
04421    ast_set_flag(chan, AST_FLAG_WRITE_INT);
04422    return ts;
04423 }

static int tonepair_generator ( struct ast_channel chan,
void *  data,
int  len,
int  samples 
) [static]

Definition at line 4425 of file channel.c.

References ast_log(), tonepair_state::data, tonepair_state::f, tonepair_state::fac1, tonepair_state::fac2, tonepair_state::modulate, tonepair_state::v1_1, tonepair_state::v1_2, tonepair_state::v2_1, tonepair_state::v2_2, tonepair_state::v3_1, and tonepair_state::v3_2.

04426 {
04427    struct tonepair_state *ts = data;
04428    int x;
04429 
04430    /* we need to prepare a frame with 16 * timelen samples as we're
04431     * generating SLIN audio
04432     */
04433    len = samples * 2;
04434 
04435    if (len > sizeof(ts->data) / 2 - 1) {
04436       ast_log(LOG_WARNING, "Can't generate that much data!\n");
04437       return -1;
04438    }
04439    memset(&ts->f, 0, sizeof(ts->f));
04440    for (x=0;x<len/2;x++) {
04441       ts->v1_1 = ts->v2_1;
04442       ts->v2_1 = ts->v3_1;
04443       ts->v3_1 = (ts->fac1 * ts->v2_1 >> 15) - ts->v1_1;
04444       
04445       ts->v1_2 = ts->v2_2;
04446       ts->v2_2 = ts->v3_2;
04447       ts->v3_2 = (ts->fac2 * ts->v2_2 >> 15) - ts->v1_2;
04448       if (ts->modulate) {
04449          int p;
04450          p = ts->v3_2 - 32768;
04451          if (p < 0) p = -p;
04452          p = ((p * 9) / 10) + 1;
04453          ts->data[x] = (ts->v3_1 * p) >> 15;
04454       } else
04455          ts->data[x] = ts->v3_1 + ts->v3_2; 
04456    }
04457    ts->f.frametype = AST_FRAME_VOICE;
04458    ts->f.subclass = AST_FORMAT_SLINEAR;
04459    ts->f.datalen = len;
04460    ts->f.samples = samples;
04461    ts->f.offset = AST_FRIENDLY_OFFSET;
04462    ts->f.data = ts->data;
04463    ast_write(chan, &ts->f);
04464    ts->pos += x;
04465    if (ts->duration > 0) {
04466       if (ts->pos >= ts->duration * 8)
04467          return -1;
04468    }
04469    return 0;
04470 }

static void tonepair_release ( struct ast_channel chan,
void *  params 
) [static]

Definition at line 4387 of file channel.c.

References ast_set_write_format(), free, and tonepair_state::origwfmt.

Referenced by tonepair_alloc().

04388 {
04389    struct tonepair_state *ts = params;
04390 
04391    if (chan)
04392       ast_set_write_format(chan, ts->origwfmt);
04393    free(ts);
04394 }


Variable Documentation

void(*) ast_moh_cleanup_ptr(struct ast_channel *) = NULL [static]

Definition at line 4548 of file channel.c.

Referenced by ast_install_music_functions(), ast_moh_cleanup(), and ast_uninstall_music_functions().

int(*) ast_moh_start_ptr(struct ast_channel *, const char *, const char *) = NULL [static]

Definition at line 4546 of file channel.c.

Referenced by ast_install_music_functions(), ast_moh_start(), and ast_uninstall_music_functions().

void(*) ast_moh_stop_ptr(struct ast_channel *) = NULL [static]

Definition at line 4547 of file channel.c.

Referenced by ast_install_music_functions(), ast_moh_stop(), and ast_uninstall_music_functions().

struct ast_cause causes[]

map AST_CAUSE's to readable string representations

Referenced by ast_cause2str(), ast_str2cause(), and dump_cause().

struct ast_cli_entry cli_channel[] [static]

Definition at line 374 of file channel.c.

Referenced by ast_channels_init().

struct ast_cli_entry cli_show_channeltype_deprecated [static]

Initial value:

 {
   { "show", "channeltype", NULL },
   show_channeltype_deprecated, NULL,
   NULL, complete_channeltypes_deprecated }

Definition at line 369 of file channel.c.

struct ast_cli_entry cli_show_channeltypes_deprecated [static]

Initial value:

 {
   { "show", "channeltypes", NULL },
   show_channeltypes, NULL,
   NULL }

Definition at line 364 of file channel.c.

unsigned long global_fin

Definition at line 82 of file channel.c.

unsigned long global_fout

Definition at line 82 of file channel.c.

struct ast_channel_tech null_tech [static]

Initial value:

 {
   .type = "NULL",
   .description = "Null channel (should not see this)",
}

Definition at line 703 of file channel.c.

char show_channeltype_usage[] [static]

Initial value:

"Usage: core show channeltype <name>\n"
"  Show details about the specified channel type, <name>.\n"

Definition at line 360 of file channel.c.

char show_channeltypes_usage[] [static]

Initial value:

"Usage: core show channeltypes\n"
"       Lists available channel types registered in your Asterisk server.\n"

Definition at line 356 of file channel.c.

int shutting_down [static]

Prevent new channel allocation if shutting down.

Definition at line 78 of file channel.c.

struct ast_generator silence_generator [static]

Initial value:

Definition at line 4659 of file channel.c.

Referenced by ast_channel_start_silence_generator().

struct ast_threadstorage state2str_threadbuf = { .once = PTHREAD_ONCE_INIT, .key_init = state2str_threadbuf_init , } [static]

Definition at line 84 of file channel.c.

Referenced by ast_state2str().

struct ast_generator tonepair [static]

Initial value:

 {
   alloc: tonepair_alloc,
   release: tonepair_release,
   generate: tonepair_generator,
}

Definition at line 4472 of file channel.c.

Referenced by ast_tonepair_start().

int uniqueint [static]

Definition at line 80 of file channel.c.


Generated on Tue Apr 28 22:50:32 2009 for Asterisk - the Open Source PBX by  doxygen 1.4.7