Fri Jun 19 12:10:28 2009

Asterisk developer's documentation


channel.c File Reference

Channel Management. More...

#include "asterisk.h"
#include "asterisk/_private.h"
#include <sys/time.h>
#include <signal.h>
#include <math.h>
#include "asterisk/paths.h"
#include "asterisk/pbx.h"
#include "asterisk/frame.h"
#include "asterisk/sched.h"
#include "asterisk/channel.h"
#include "asterisk/musiconhold.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"
#include "asterisk/audiohook.h"
#include "asterisk/timing.h"

Go to the source code of this file.

Data Structures

struct  ast_cause
 map AST_CAUSE's to readable string representations More...
struct  ast_epoll_data
struct  ast_silence_generator
struct  backends
 the list of registered channel types More...
struct  chanlist
 List of channel drivers. More...
struct  channels
 the list of channels we have. Note that the lock for this list is used for both the channels list and the backends list. More...
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 STATE2STR_BUFSIZE   32

Functions

int __ast_answer (struct ast_channel *chan, unsigned int delay, int cdr_answer)
 Answer a channel, with a selectable delay before returning.
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)
 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.
static void __init_state2str_threadbuf (void)
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 channel.
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_cmpwhentohangup_tv (struct ast_channel *chan, struct timeval 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, const char *uid)
 Create a channel data store object.
ast_datastoreast_channel_datastore_find (struct ast_channel *chan, const struct ast_datastore_info *info, const char *uid)
 Find a datastore on a channel.
int ast_channel_datastore_free (struct ast_datastore *datastore)
 Free a channel data store object.
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.
int ast_channel_early_bridge (struct ast_channel *c0, struct ast_channel *c1)
 Bridge two channels together (early).
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.
static int ast_channel_make_compatible_helper (struct ast_channel *from, struct ast_channel *to)
 Set up translation from one channel to another.
int ast_channel_masquerade (struct ast_channel *original, struct ast_channel *clonechan)
 Weird function made for call transfers.
int ast_channel_queryoption (struct ast_channel *chan, int option, void *data, int *datalen, int block)
const 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)
void ast_channel_set_fd (struct ast_channel *chan, int which, int fd)
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.
void ast_channel_setwhentohangup_tv (struct ast_channel *chan, struct timeval 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 whacked 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 or uniqueid (locks channel).
ast_channelast_get_channel_by_name_prefix_locked (const char *name, const int namelen)
 Get channel by name or uniqueid 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.
void ast_poll_channel_add (struct ast_channel *chan0, struct ast_channel *chan1)
void ast_poll_channel_del (struct ast_channel *chan0, struct ast_channel *chan1)
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.
int ast_queue_hangup_with_cause (struct ast_channel *chan, int cause)
 Queue a hangup frame with hangupcause set.
int ast_raw_answer (struct ast_channel *chan, int cdr_answer)
 Answer a channel.
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.
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 specified 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 specified amount of time, looking for hangups and a condition argument.
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, unsigned int duration)
 Send a DTMF digit to a channel Send a DTMF digit to a channel.
int ast_senddigit_begin (struct ast_channel *chan, char digit)
 Send a DTMF digit to a channel Send a DTMF digit to a channel.
int ast_senddigit_end (struct ast_channel *chan, char digit, unsigned int duration)
 Send a DTMF digit to a channel.
int ast_sendtext (struct ast_channel *chan, const char *text)
 Sends text to a channel.
void ast_set_callerid (struct ast_channel *chan, const char *cid_num, const char *cid_name, const char *cid_ani)
 Set caller ID number, name and 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 component 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, unsigned int rate, int(*func)(const void *data), void *data)
 Enable or disable timer ticks for a channel.
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).
const 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 or uniqueid 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_play_sounds (struct ast_channel *c0, struct ast_channel *c1)
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 *clonechan)
 Clone channel variables from 'clone' channel into 'original' channel.
static char * complete_channeltypes (struct ast_cli_args *a)
static void free_cid (struct ast_callerid *cid)
static void free_translation (struct ast_channel *clonechan)
static int generator_force (const void *data)
static char * handle_cli_core_show_channeltype (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
 Show details about a channel driver - CLI command.
static char * handle_cli_core_show_channeltypes (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
 Show channel types - CLI command.
static int attribute_const is_visible_indication (enum ast_control_frame_type condition)
static void manager_bridge_event (int onoff, int type, struct ast_channel *c0, struct ast_channel *c1)
 Send manager event for bridge link and unlink events.
static void queue_dtmf_readq (struct ast_channel *chan, struct ast_frame *f)
static void send_dtmf_event (const struct ast_channel *chan, const char *direction, const char digit, const char *begin, const char *end)
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 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 * 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)
static void update_bridge_vars (struct ast_channel *c0, struct ast_channel *c1)

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 []
 map AST_CAUSE's to readable string representations
static struct ast_cli_entry cli_channel []
unsigned long global_fin
unsigned long global_fout
static struct ast_channel_tech null_tech
static int shutting_down
 Prevent new channel allocation if shutting down.
static struct ast_generator silence_generator
static struct ast_threadstorage state2str_threadbuf = { .once = PTHREAD_ONCE_INIT, .key_init = __init_state2str_threadbuf , .custom_init = NULL , }
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 92 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 95 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 99 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 STATE2STR_BUFSIZE   32

Definition at line 88 of file channel.c.

Referenced by ast_state2str().


Function Documentation

int __ast_answer ( struct ast_channel chan,
unsigned int  delay,
int  cdr_answer 
)

Answer a channel, with a selectable delay before returning.

Parameters:
chan channel to answer
delay maximum amount of time to wait for incoming media
cdr_answer flag to control whether any associated CDR should be marked as 'answered'
This function answers a channel and handles all necessary call setup functions.

Note:
The channel passed does not need to be locked, but is locked by the function when needed.

This function will wait up to 'delay' milliseconds for media to arrive on the channel before returning to the caller, so that the caller can properly assume the channel is 'ready' for media flow. If 'delay' is less than 500, the function will wait up to 500 milliseconds.

Return values:
0 on success
non-zero on failure

Definition at line 1732 of file channel.c.

References ast_channel::_state, ast_channel_lock, ast_channel_unlock, AST_CONTROL_HANGUP, ast_debug, AST_FRAME_CNG, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, AST_FRAME_HTML, AST_FRAME_IAX, AST_FRAME_IMAGE, AST_FRAME_MODEM, AST_FRAME_NULL, AST_FRAME_TEXT, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_frfree, ast_frisolate(), AST_LIST_HEAD_INIT_NOLOCK, AST_LIST_HEAD_NOLOCK, AST_LIST_INSERT_HEAD, AST_LIST_REMOVE_HEAD, ast_log(), ast_queue_frame_head(), ast_raw_answer(), ast_read(), AST_STATE_RING, AST_STATE_RINGING, ast_waitfor(), chanlist::chan, errno, ast_frame::frame_list, frames, ast_frame::frametype, LOG_WARNING, MAX, ast_channel::name, and ast_frame::subclass.

Referenced by ast_answer(), dial_exec_full(), pbx_builtin_answer(), and pbx_builtin_incomplete().

01733 {
01734    int res = 0;
01735    enum ast_channel_state old_state;
01736 
01737    old_state = chan->_state;
01738    if ((res = ast_raw_answer(chan, cdr_answer))) {
01739       return res;
01740    }
01741 
01742    switch (old_state) {
01743    case AST_STATE_RINGING:
01744    case AST_STATE_RING:
01745       /* wait for media to start flowing, but don't wait any longer
01746        * than 'delay' or 500 milliseconds, whichever is longer
01747        */
01748       do {
01749          AST_LIST_HEAD_NOLOCK(, ast_frame) frames;
01750          struct ast_frame *cur, *new;
01751          int ms = MAX(delay, 500);
01752          unsigned int done = 0;
01753 
01754          AST_LIST_HEAD_INIT_NOLOCK(&frames);
01755 
01756          for (;;) {
01757             ms = ast_waitfor(chan, ms);
01758             if (ms < 0) {
01759                ast_log(LOG_WARNING, "Error condition occurred when polling channel %s for a voice frame: %s\n", chan->name, strerror(errno));
01760                res = -1;
01761                break;
01762             }
01763             if (ms == 0) {
01764                ast_debug(2, "Didn't receive a media frame from %s within %d ms of answering. Continuing anyway\n", chan->name, MAX(delay, 500));
01765                break;
01766             }
01767             cur = ast_read(chan);
01768             if (!cur || ((cur->frametype == AST_FRAME_CONTROL) &&
01769                     (cur->subclass == AST_CONTROL_HANGUP))) {
01770                if (cur) {
01771                   ast_frfree(cur);
01772                }
01773                res = -1;
01774                ast_debug(2, "Hangup of channel %s detected in answer routine\n", chan->name);
01775                break;
01776             }
01777 
01778             if ((new = ast_frisolate(cur)) != cur) {
01779                ast_frfree(cur);
01780             }
01781 
01782             AST_LIST_INSERT_HEAD(&frames, new, frame_list);
01783 
01784             /* if a specific delay period was requested, continue
01785              * until that delay has passed. don't stop just because
01786              * incoming media has arrived.
01787              */
01788             if (delay) {
01789                continue;
01790             }
01791 
01792             switch (new->frametype) {
01793                /* all of these frametypes qualify as 'media' */
01794             case AST_FRAME_VOICE:
01795             case AST_FRAME_VIDEO:
01796             case AST_FRAME_TEXT:
01797             case AST_FRAME_DTMF_BEGIN:
01798             case AST_FRAME_DTMF_END:
01799             case AST_FRAME_IMAGE:
01800             case AST_FRAME_HTML:
01801             case AST_FRAME_MODEM:
01802                done = 1;
01803                break;
01804             case AST_FRAME_CONTROL:
01805             case AST_FRAME_IAX:
01806             case AST_FRAME_NULL:
01807             case AST_FRAME_CNG:
01808                break;
01809             }
01810 
01811             if (done) {
01812                break;
01813             }
01814          }
01815 
01816          if (res == 0) {
01817             ast_channel_lock(chan);
01818             while ((cur = AST_LIST_REMOVE_HEAD(&frames, frame_list))) {
01819                ast_queue_frame_head(chan, cur);
01820                ast_frfree(cur);
01821             }
01822             ast_channel_unlock(chan);
01823          }
01824       } while (0);
01825       break;
01826    default:
01827       break;
01828    }
01829 
01830    return res;
01831 }

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

Queue an outgoing media frame.

Definition at line 959 of file channel.c.

References ast_channel::alertpipe, ast_assert, ast_channel_lock, ast_channel_unlock, AST_CONTROL_HANGUP, ast_debug, 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_timer_enable_continuous(), ast_channel::blocker, chanlist::chan, errno, f, ast_frame::frame_list, ast_frame::frametype, LOG_WARNING, ast_channel::name, ast_channel::readq, ast_frame::subclass, ast_channel::timer, and ast_channel::timingfd.

Referenced by ast_queue_frame(), and ast_queue_frame_head().

00960 {
00961    struct ast_frame *f;
00962    struct ast_frame *cur;
00963    int blah = 1;
00964    int qlen = 0;
00965 
00966    /* Build us a copy and free the original one */
00967    if (!(f = ast_frdup(fin))) {
00968       return -1;
00969    }
00970 
00971    ast_channel_lock(chan);
00972 
00973    /* See if the last frame on the queue is a hangup, if so don't queue anything */
00974    if ((cur = AST_LIST_LAST(&chan->readq)) && (cur->frametype == AST_FRAME_CONTROL) && (cur->subclass == AST_CONTROL_HANGUP)) {
00975       ast_frfree(f);
00976       ast_channel_unlock(chan);
00977       return 0;
00978    }
00979 
00980    /* Count how many frames exist on the queue */
00981    AST_LIST_TRAVERSE(&chan->readq, cur, frame_list) {
00982       qlen++;
00983    }
00984 
00985    /* Allow up to 96 voice frames outstanding, and up to 128 total frames */
00986    if (((fin->frametype == AST_FRAME_VOICE) && (qlen > 96)) || (qlen  > 128)) {
00987       if (fin->frametype != AST_FRAME_VOICE) {
00988          ast_log(LOG_WARNING, "Exceptionally long queue length queuing to %s\n", chan->name);
00989          ast_assert(fin->frametype == AST_FRAME_VOICE);
00990       } else {
00991          ast_debug(1, "Dropping voice to exceptionally long queue on %s\n", chan->name);
00992          ast_frfree(f);
00993          ast_channel_unlock(chan);
00994          return 0;
00995       }
00996    }
00997 
00998    if (head) {
00999       AST_LIST_INSERT_HEAD(&chan->readq, f, frame_list);
01000    } else {
01001       AST_LIST_INSERT_TAIL(&chan->readq, f, frame_list);
01002    }
01003 
01004    if (chan->alertpipe[1] > -1) {
01005       if (write(chan->alertpipe[1], &blah, sizeof(blah)) != sizeof(blah)) {
01006          ast_log(LOG_WARNING, "Unable to write to alert pipe on %s, frametype/subclass %d/%d (qlen = %d): %s!\n",
01007             chan->name, f->frametype, f->subclass, qlen, strerror(errno));
01008       }
01009    } else if (chan->timingfd > -1) {
01010       ast_timer_enable_continuous(chan->timer);
01011    } else if (ast_test_flag(chan, AST_FLAG_BLOCKING)) {
01012       pthread_kill(chan->blocker, SIGURG);
01013    }
01014 
01015    ast_channel_unlock(chan);
01016 
01017    return 0;
01018 }

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

Definition at line 2499 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_debug, 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_timer_ack(), ast_timer_disable_continuous(), ast_timer_get_event(), ast_timer_set_rate(), AST_TIMING_EVENT_CONTINUOUS, AST_TIMING_EVENT_EXPIRED, AST_TIMING_FD, ast_translate(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), ast_writestream(), ast_channel::audiohooks, ast_channel::blocker, chanlist::chan, DEBUGCHAN_FLAG, ast_generator::digit, 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, chanlist::flags, ast_frame::frame_list, FRAMECOUNT_INC, ast_frame::frametype, ast_generator::generate, ast_channel::generator, ast_channel::generatordata, ast_channel::hangupcause, ast_channel::insmpl, LOG_DTMF, LOG_ERROR, LOG_NOTICE, LOG_WARNING, ast_channel::masq, ast_channel::monitor, ast_channel::music_state, ast_channel::name, ast_channel::nativeformats, ast_channel::outsmpl, queue_dtmf_readq(), ast_channel_tech::read, ast_channel_monitor::read_stream, ast_channel::readq, ast_channel::readtrans, SEEK_FORCECUR, send_dtmf_event(), should_skip_dtmf(), ast_channel_monitor::state, ast_channel::tech, ast_channel::timer, ast_channel::timingdata, ast_channel::timingfd, and ast_channel::timingfunc.

Referenced by ast_read(), and ast_read_noaudio().

02500 {
02501    struct ast_frame *f = NULL;   /* the return value */
02502    int blah;
02503    int prestate;
02504    int count = 0, cause = 0;
02505 
02506    /* this function is very long so make sure there is only one return
02507     * point at the end (there are only two exceptions to this).
02508     */
02509    while(ast_channel_trylock(chan)) {
02510       if(count++ > 10) 
02511          /*cannot goto done since the channel is not locked*/
02512          return &ast_null_frame;
02513       usleep(1);
02514    }
02515 
02516    if (chan->masq) {
02517       if (ast_do_masquerade(chan))
02518          ast_log(LOG_WARNING, "Failed to perform masquerade\n");
02519       else
02520          f =  &ast_null_frame;
02521       goto done;
02522    }
02523 
02524    /* Stop if we're a zombie or need a soft hangup */
02525    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) {
02526       if (chan->generator)
02527          ast_deactivate_generator(chan);
02528       goto done;
02529    }
02530 
02531    if (chan->fdno == -1) {
02532 #ifdef AST_DEVMODE
02533       ast_log(LOG_ERROR, "ast_read() called with no recorded file descriptor.\n");
02534 #else
02535       ast_debug(2, "ast_read() called with no recorded file descriptor.\n");
02536 #endif
02537       f = &ast_null_frame;
02538       goto done;
02539    }
02540    prestate = chan->_state;
02541 
02542    /* Read and ignore anything on the alertpipe, but read only
02543       one sizeof(blah) per frame that we send from it */
02544    if (chan->alertpipe[0] > -1) {
02545       int flags = fcntl(chan->alertpipe[0], F_GETFL);
02546       /* For some odd reason, the alertpipe occasionally loses nonblocking status,
02547        * which immediately causes a deadlock scenario.  Detect and prevent this. */
02548       if ((flags & O_NONBLOCK) == 0) {
02549          ast_log(LOG_ERROR, "Alertpipe on channel %s lost O_NONBLOCK?!!\n", chan->name);
02550          if (fcntl(chan->alertpipe[0], F_SETFL, flags | O_NONBLOCK) < 0) {
02551             ast_log(LOG_WARNING, "Unable to set alertpipe nonblocking! (%d: %s)\n", errno, strerror(errno));
02552             f = &ast_null_frame;
02553             goto done;
02554          }
02555       }
02556       if (read(chan->alertpipe[0], &blah, sizeof(blah)) < 0) {
02557          if (errno != EINTR && errno != EAGAIN)
02558             ast_log(LOG_WARNING, "read() failed: %s\n", strerror(errno));
02559       }
02560    }
02561 
02562    if (chan->timingfd > -1 && chan->fdno == AST_TIMING_FD) {
02563       enum ast_timer_event res;
02564 
02565       ast_clear_flag(chan, AST_FLAG_EXCEPTION);
02566 
02567       res = ast_timer_get_event(chan->timer);
02568 
02569       switch (res) {
02570       case AST_TIMING_EVENT_EXPIRED:
02571          ast_timer_ack(chan->timer, 1);
02572 
02573          if (chan->timingfunc) {
02574             /* save a copy of func/data before unlocking the channel */
02575             int (*func)(const void *) = chan->timingfunc;
02576             void *data = chan->timingdata;
02577             chan->fdno = -1;
02578             ast_channel_unlock(chan);
02579             func(data);
02580          } else {
02581             ast_timer_set_rate(chan->timer, 0);
02582             chan->fdno = -1;
02583             ast_channel_unlock(chan);
02584          }
02585 
02586          /* cannot 'goto done' because the channel is already unlocked */
02587          return &ast_null_frame;
02588 
02589       case AST_TIMING_EVENT_CONTINUOUS:
02590          if (AST_LIST_EMPTY(&chan->readq) || 
02591             !AST_LIST_NEXT(AST_LIST_FIRST(&chan->readq), frame_list)) {
02592             ast_timer_disable_continuous(chan->timer);
02593          }
02594          break;
02595       }
02596 
02597    } else if (chan->fds[AST_GENERATOR_FD] > -1 && chan->fdno == AST_GENERATOR_FD) {
02598       /* if the AST_GENERATOR_FD is set, call the generator with args
02599        * set to -1 so it can do whatever it needs to.
02600        */
02601       void *tmp = chan->generatordata;
02602       chan->generatordata = NULL;     /* reset to let ast_write get through */
02603       chan->generator->generate(chan, tmp, -1, -1);
02604       chan->generatordata = tmp;
02605       f = &ast_null_frame;
02606       chan->fdno = -1;
02607       goto done;
02608    }
02609 
02610    /* Check for pending read queue */
02611    if (!AST_LIST_EMPTY(&chan->readq)) {
02612       int skip_dtmf = should_skip_dtmf(chan);
02613 
02614       AST_LIST_TRAVERSE_SAFE_BEGIN(&chan->readq, f, frame_list) {
02615          /* We have to be picky about which frame we pull off of the readq because
02616           * there are cases where we want to leave DTMF frames on the queue until
02617           * some later time. */
02618 
02619          if ( (f->frametype == AST_FRAME_DTMF_BEGIN || f->frametype == AST_FRAME_DTMF_END) && skip_dtmf) {
02620             continue;
02621          }
02622 
02623          AST_LIST_REMOVE_CURRENT(frame_list);
02624          break;
02625       }
02626       AST_LIST_TRAVERSE_SAFE_END;
02627       
02628       if (!f) {
02629          /* There were no acceptable frames on the readq. */
02630          f = &ast_null_frame;
02631          if (chan->alertpipe[0] > -1) {
02632             int poke = 0;
02633             /* Restore the state of the alertpipe since we aren't ready for any
02634              * of the frames in the readq. */
02635             if (write(chan->alertpipe[1], &poke, sizeof(poke)) != sizeof(poke)) {
02636                ast_log(LOG_ERROR, "Failed to write to alertpipe: %s\n", strerror(errno));
02637             }
02638          }
02639       }
02640 
02641       /* Interpret hangup and return NULL */
02642       /* XXX why not the same for frames from the channel ? */
02643       if (f->frametype == AST_FRAME_CONTROL && f->subclass == AST_CONTROL_HANGUP) {
02644          cause = f->data.uint32;
02645          ast_frfree(f);
02646          f = NULL;
02647       }
02648    } else {
02649       chan->blocker = pthread_self();
02650       if (ast_test_flag(chan, AST_FLAG_EXCEPTION)) {
02651          if (chan->tech->exception)
02652             f = chan->tech->exception(chan);
02653          else {
02654             ast_log(LOG_WARNING, "Exception flag set on '%s', but no exception handler\n", chan->name);
02655             f = &ast_null_frame;
02656          }
02657          /* Clear the exception flag */
02658          ast_clear_flag(chan, AST_FLAG_EXCEPTION);
02659       } else if (chan->tech->read)
02660          f = chan->tech->read(chan);
02661       else
02662          ast_log(LOG_WARNING, "No read routine on channel %s\n", chan->name);
02663    }
02664 
02665    /*
02666     * Reset the recorded file descriptor that triggered this read so that we can
02667     * easily detect when ast_read() is called without properly using ast_waitfor().
02668     */
02669    chan->fdno = -1;
02670 
02671    if (f) {
02672       /* if the channel driver returned more than one frame, stuff the excess
02673          into the readq for the next ast_read call (note that we can safely assume
02674          that the readq is empty, because otherwise we would not have called into
02675          the channel driver and f would be only a single frame)
02676       */
02677       if (AST_LIST_NEXT(f, frame_list)) {
02678          AST_LIST_HEAD_SET_NOLOCK(&chan->readq, AST_LIST_NEXT(f, frame_list));
02679          AST_LIST_NEXT(f, frame_list) = NULL;
02680       }
02681 
02682       switch (f->frametype) {
02683       case AST_FRAME_CONTROL:
02684          if (f->subclass == AST_CONTROL_ANSWER) {
02685             if (!ast_test_flag(chan, AST_FLAG_OUTGOING)) {
02686                ast_debug(1, "Ignoring answer on an inbound call!\n");
02687                ast_frfree(f);
02688                f = &ast_null_frame;
02689             } else if (prestate == AST_STATE_UP) {
02690                ast_debug(1, "Dropping duplicate answer!\n");
02691                ast_frfree(f);
02692                f = &ast_null_frame;
02693             } else {
02694                /* Answer the CDR */
02695                ast_setstate(chan, AST_STATE_UP);
02696                /* removed a call to ast_cdr_answer(chan->cdr) from here. */
02697             }
02698          }
02699          break;
02700       case AST_FRAME_DTMF_END:
02701          send_dtmf_event(chan, "Received", f->subclass, "No", "Yes");
02702          ast_log(LOG_DTMF, "DTMF end '%c' received on %s, duration %ld ms\n", f->subclass, chan->name, f->len);
02703          /* Queue it up if DTMF is deferred, or if DTMF emulation is forced. */
02704          if (ast_test_flag(chan, AST_FLAG_DEFER_DTMF) || ast_test_flag(chan, AST_FLAG_EMULATE_DTMF)) {
02705             queue_dtmf_readq(chan, f);
02706             ast_frfree(f);
02707             f = &ast_null_frame;
02708          } else if (!ast_test_flag(chan, AST_FLAG_IN_DTMF | AST_FLAG_END_DTMF_ONLY)) {
02709             if (!ast_tvzero(chan->dtmf_tv) && 
02710                 ast_tvdiff_ms(ast_tvnow(), chan->dtmf_tv) < AST_MIN_DTMF_GAP) {
02711                /* If it hasn't been long enough, defer this digit */
02712                queue_dtmf_readq(chan, f);
02713                ast_frfree(f);
02714                f = &ast_null_frame;
02715             } else {
02716                /* There was no begin, turn this into a begin and send the end later */
02717                f->frametype = AST_FRAME_DTMF_BEGIN;
02718                ast_set_flag(chan, AST_FLAG_EMULATE_DTMF);
02719                chan->emulate_dtmf_digit = f->subclass;
02720                chan->dtmf_tv = ast_tvnow();
02721                if (f->len) {
02722                   if (f->len > AST_MIN_DTMF_DURATION)
02723                      chan->emulate_dtmf_duration = f->len;
02724                   else 
02725                      chan->emulate_dtmf_duration = AST_MIN_DTMF_DURATION;
02726                } else
02727                   chan->emulate_dtmf_duration = AST_DEFAULT_EMULATE_DTMF_DURATION;
02728                ast_log(LOG_DTMF, "DTMF begin emulation of '%c' with duration %u queued on %s\n", f->subclass, chan->emulate_dtmf_duration, chan->name);
02729             }
02730             if (chan->audiohooks) {
02731                struct ast_frame *old_frame = f;
02732                /*!
02733                 * \todo XXX It is possible to write a digit to the audiohook twice
02734                 * if the digit was originally read while the channel was in autoservice. */
02735                f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f);
02736                if (old_frame != f)
02737                   ast_frfree(old_frame);
02738             }
02739          } else {
02740             struct timeval now = ast_tvnow();
02741             if (ast_test_flag(chan, AST_FLAG_IN_DTMF)) {
02742                ast_log(LOG_DTMF, "DTMF end accepted with begin '%c' on %s\n", f->subclass, chan->name);
02743                ast_clear_flag(chan, AST_FLAG_IN_DTMF);
02744                if (!f->len)
02745                   f->len = ast_tvdiff_ms(now, chan->dtmf_tv);
02746             } else if (!f->len) {
02747                ast_log(LOG_DTMF, "DTMF end accepted without begin '%c' on %s\n", f->subclass, chan->name);
02748                f->len = AST_MIN_DTMF_DURATION;
02749             }
02750             if (f->len < AST_MIN_DTMF_DURATION && !ast_test_flag(chan, AST_FLAG_END_DTMF_ONLY)) {
02751                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);
02752                ast_set_flag(chan, AST_FLAG_EMULATE_DTMF);
02753                chan->emulate_dtmf_digit = f->subclass;
02754                chan->emulate_dtmf_duration = AST_MIN_DTMF_DURATION - f->len;
02755                ast_frfree(f);
02756                f = &ast_null_frame;
02757             } else {
02758                ast_log(LOG_DTMF, "DTMF end passthrough '%c' on %s\n", f->subclass, chan->name);
02759                if (f->len < AST_MIN_DTMF_DURATION) {
02760                   f->len = AST_MIN_DTMF_DURATION;
02761                }
02762                chan->dtmf_tv = now;
02763             }
02764             if (chan->audiohooks) {
02765                struct ast_frame *old_frame = f;
02766                f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f);
02767                if (old_frame != f)
02768                   ast_frfree(old_frame);
02769             }
02770          }
02771          break;
02772       case AST_FRAME_DTMF_BEGIN:
02773          send_dtmf_event(chan, "Received", f->subclass, "Yes", "No");
02774          ast_log(LOG_DTMF, "DTMF begin '%c' received on %s\n", f->subclass, chan->name);
02775          if ( ast_test_flag(chan, AST_FLAG_DEFER_DTMF | AST_FLAG_END_DTMF_ONLY | AST_FLAG_EMULATE_DTMF) || 
02776              (!ast_tvzero(chan->dtmf_tv) && 
02777                ast_tvdiff_ms(ast_tvnow(), chan->dtmf_tv) < AST_MIN_DTMF_GAP) ) {
02778             ast_log(LOG_DTMF, "DTMF begin ignored '%c' on %s\n", f->subclass, chan->name);
02779             ast_frfree(f);
02780             f = &ast_null_frame;
02781          } else {
02782             ast_set_flag(chan, AST_FLAG_IN_DTMF);
02783             chan->dtmf_tv = ast_tvnow();
02784             ast_log(LOG_DTMF, "DTMF begin passthrough '%c' on %s\n", f->subclass, chan->name);
02785          }
02786          break;
02787       case AST_FRAME_NULL:
02788          /* The EMULATE_DTMF flag must be cleared here as opposed to when the duration
02789           * is reached , because we want to make sure we pass at least one
02790           * voice frame through before starting the next digit, to ensure a gap
02791           * between DTMF digits. */
02792          if (ast_test_flag(chan, AST_FLAG_EMULATE_DTMF)) {
02793             struct timeval now = ast_tvnow();
02794             if (!chan->emulate_dtmf_duration) {
02795                ast_clear_flag(chan, AST_FLAG_EMULATE_DTMF);
02796                chan->emulate_dtmf_digit = 0;
02797             } else if (ast_tvdiff_ms(now, chan->dtmf_tv) >= chan->emulate_dtmf_duration) {
02798                chan->emulate_dtmf_duration = 0;
02799                ast_frfree(f);
02800                f = &chan->dtmff;
02801                f->frametype = AST_FRAME_DTMF_END;
02802                f->subclass = chan->emulate_dtmf_digit;
02803                f->len = ast_tvdiff_ms(now, chan->dtmf_tv);
02804                chan->dtmf_tv = now;
02805                ast_clear_flag(chan, AST_FLAG_EMULATE_DTMF);
02806                chan->emulate_dtmf_digit = 0;
02807                ast_log(LOG_DTMF, "DTMF end emulation of '%c' queued on %s\n", f->subclass, chan->name);
02808                if (chan->audiohooks) {
02809                   struct ast_frame *old_frame = f;
02810                   f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f);
02811                   if (old_frame != f) {
02812                      ast_frfree(old_frame);
02813                   }
02814                }
02815             }
02816          }
02817          break;
02818       case AST_FRAME_VOICE:
02819          /* The EMULATE_DTMF flag must be cleared here as opposed to when the duration
02820           * is reached , because we want to make sure we pass at least one
02821           * voice frame through before starting the next digit, to ensure a gap
02822           * between DTMF digits. */
02823          if (ast_test_flag(chan, AST_FLAG_EMULATE_DTMF) && !chan->emulate_dtmf_duration) {
02824             ast_clear_flag(chan, AST_FLAG_EMULATE_DTMF);
02825             chan->emulate_dtmf_digit = 0;
02826          }
02827 
02828          if (dropaudio || ast_test_flag(chan, AST_FLAG_IN_DTMF)) {
02829             if (dropaudio)
02830                ast_read_generator_actions(chan, f);
02831             ast_frfree(f);
02832             f = &ast_null_frame;
02833          }
02834 
02835          if (ast_test_flag(chan, AST_FLAG_EMULATE_DTMF) && !ast_test_flag(chan, AST_FLAG_IN_DTMF)) {
02836             struct timeval now = ast_tvnow();
02837             if (ast_tvdiff_ms(now, chan->dtmf_tv) >= chan->emulate_dtmf_duration) {
02838                chan->emulate_dtmf_duration = 0;
02839                ast_frfree(f);
02840                f = &chan->dtmff;
02841                f->frametype = AST_FRAME_DTMF_END;
02842                f->subclass = chan->emulate_dtmf_digit;
02843                f->len = ast_tvdiff_ms(now, chan->dtmf_tv);
02844                chan->dtmf_tv = now;
02845                if (chan->audiohooks) {
02846                   struct ast_frame *old_frame = f;
02847                   f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f);
02848                   if (old_frame != f)
02849                      ast_frfree(old_frame);
02850                }
02851                ast_log(LOG_DTMF, "DTMF end emulation of '%c' queued on %s\n", f->subclass, chan->name);
02852             } else {
02853                /* Drop voice frames while we're still in the middle of the digit */
02854                ast_frfree(f);
02855                f = &ast_null_frame;
02856             }
02857          } else if ((f->frametype == AST_FRAME_VOICE) && !(f->subclass & chan->nativeformats)) {
02858             /* This frame is not one of the current native formats -- drop it on the floor */
02859             char to[200];
02860             ast_log(LOG_NOTICE, "Dropping incompatible voice frame on %s of format %s since our native format has changed to %s\n",
02861                chan->name, ast_getformatname(f->subclass), ast_getformatname_multiple(to, sizeof(to), chan->nativeformats));
02862             ast_frfree(f);
02863             f = &ast_null_frame;
02864          } else if ((f->frametype == AST_FRAME_VOICE)) {
02865             /* Send frame to audiohooks if present */
02866             if (chan->audiohooks) {
02867                struct ast_frame *old_frame = f;
02868                f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f);
02869                if (old_frame != f)
02870                   ast_frfree(old_frame);
02871             }
02872             if (chan->monitor && chan->monitor->read_stream ) {
02873                /* XXX what does this do ? */
02874 #ifndef MONITOR_CONSTANT_DELAY
02875                int jump = chan->outsmpl - chan->insmpl - 4 * f->samples;
02876                if (jump >= 0) {
02877                   jump = chan->outsmpl - chan->insmpl;
02878                   if (ast_seekstream(chan->monitor->read_stream, jump, SEEK_FORCECUR) == -1)
02879                      ast_log(LOG_WARNING, "Failed to perform seek in monitoring read stream, synchronization between the files may be broken\n");
02880                   chan->insmpl += jump + f->samples;
02881                } else
02882                   chan->insmpl+= f->samples;
02883 #else
02884                int jump = chan->outsmpl - chan->insmpl;
02885                if (jump - MONITOR_DELAY >= 0) {
02886                   if (ast_seekstream(chan->monitor->read_stream, jump - f->samples, SEEK_FORCECUR) == -1)
02887                      ast_log(LOG_WARNING, "Failed to perform seek in monitoring read stream, synchronization between the files may be broken\n");
02888                   chan->insmpl += jump;
02889                } else
02890                   chan->insmpl += f->samples;
02891 #endif
02892                if (chan->monitor->state == AST_MONITOR_RUNNING) {
02893                   if (ast_writestream(chan->monitor->read_stream, f) < 0)
02894                      ast_log(LOG_WARNING, "Failed to write data to channel monitor read stream\n");
02895                }
02896             }
02897 
02898             if (chan->readtrans && (f = ast_translate(chan->readtrans, f, 1)) == NULL)
02899                f = &ast_null_frame;
02900             else
02901                /* Run generator sitting on the line if timing device not available
02902                 * and synchronous generation of outgoing frames is necessary       */
02903                ast_read_generator_actions(chan, f);
02904          }
02905       default:
02906          /* Just pass it on! */
02907          break;
02908       }
02909    } else {
02910       /* Make sure we always return NULL in the future */
02911       chan->_softhangup |= AST_SOFTHANGUP_DEV;
02912       if (cause)
02913          chan->hangupcause = cause;
02914       if (chan->generator)
02915          ast_deactivate_generator(chan);
02916       /* We no longer End the CDR here */
02917    }
02918 
02919    /* High bit prints debugging */
02920    if (chan->fin & DEBUGCHAN_FLAG)
02921       ast_frame_dump(chan->name, f, "<<");
02922    chan->fin = FRAMECOUNT_INC(chan->fin);
02923 
02924 done:
02925    if (chan->music_state && chan->generator && chan->generator->digit && f && f->frametype == AST_FRAME_DTMF_END)
02926       chan->generator->digit(chan, f->subclass);
02927 
02928    ast_channel_unlock(chan);
02929    return f;
02930 }

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

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 unsuccessful)
cid_num Caller-ID Number
cid_name Caller-ID Name (ascii)
oh Outgoing helper
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 3514 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_datastore_inherit(), 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, chanlist::chan, 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().

03515 {
03516    int dummy_outstate;
03517    int cause = 0;
03518    struct ast_channel *chan;
03519    int res = 0;
03520    int last_subclass = 0;
03521    
03522    if (outstate)
03523       *outstate = 0;
03524    else
03525       outstate = &dummy_outstate;   /* make outstate always a valid pointer */
03526 
03527    chan = ast_request(type, format, data, &cause);
03528    if (!chan) {
03529       ast_log(LOG_NOTICE, "Unable to request channel %s/%s\n", type, (char *)data);
03530       /* compute error and return */
03531       if (cause == AST_CAUSE_BUSY)
03532          *outstate = AST_CONTROL_BUSY;
03533       else if (cause == AST_CAUSE_CONGESTION)
03534          *outstate = AST_CONTROL_CONGESTION;
03535       return NULL;
03536    }
03537 
03538    if (oh) {
03539       if (oh->vars)  
03540          ast_set_variables(chan, oh->vars);
03541       /* XXX why is this necessary, for the parent_channel perhaps ? */
03542       if (!ast_strlen_zero(oh->cid_num) && !ast_strlen_zero(oh->cid_name))
03543          ast_set_callerid(chan, oh->cid_num, oh->cid_name, oh->cid_num);
03544       if (oh->parent_channel) {
03545          ast_channel_inherit_variables(oh->parent_channel, chan);
03546          ast_channel_datastore_inherit(oh->parent_channel, chan);
03547       }
03548       if (oh->account)
03549          ast_cdr_setaccount(chan, oh->account); 
03550    }
03551    ast_set_callerid(chan, cid_num, cid_name, cid_num);
03552 
03553    if (ast_call(chan, data, 0)) {   /* ast_call failed... */
03554       ast_log(LOG_NOTICE, "Unable to call channel %s/%s\n", type, (char *)data);
03555    } else {
03556       res = 1; /* mark success in case chan->_state is already AST_STATE_UP */
03557       while (timeout && chan->_state != AST_STATE_UP) {
03558          struct ast_frame *f;
03559          res = ast_waitfor(chan, timeout);
03560          if (res <= 0) /* error, timeout, or done */
03561             break;
03562          if (timeout > -1)
03563             timeout = res;
03564          f = ast_read(chan);
03565          if (!f) {
03566             *outstate = AST_CONTROL_HANGUP;
03567             res = 0;
03568             break;
03569          }
03570          if (f->frametype == AST_FRAME_CONTROL) {
03571             switch (f->subclass) {
03572             case AST_CONTROL_RINGING:  /* record but keep going */
03573                *outstate = f->subclass;
03574                break;
03575 
03576             case AST_CONTROL_BUSY:
03577             case AST_CONTROL_CONGESTION:
03578             case AST_CONTROL_ANSWER:
03579                *outstate = f->subclass;
03580                timeout = 0;      /* trick to force exit from the while() */
03581                break;
03582 
03583             /* Ignore these */
03584             case AST_CONTROL_PROGRESS:
03585             case AST_CONTROL_PROCEEDING:
03586             case AST_CONTROL_HOLD:
03587             case AST_CONTROL_UNHOLD:
03588             case AST_CONTROL_VIDUPDATE:
03589             case AST_CONTROL_SRCUPDATE:
03590             case -1:       /* Ignore -- just stopping indications */
03591                break;
03592 
03593             default:
03594                ast_log(LOG_NOTICE, "Don't know what to do with control frame %d\n", f->subclass);
03595             }
03596             last_subclass = f->subclass;
03597          }
03598          ast_frfree(f);
03599       }
03600    }
03601 
03602    /* Final fixups */
03603    if (oh) {
03604       if (!ast_strlen_zero(oh->context))
03605          ast_copy_string(chan->context, oh->context, sizeof(chan->context));
03606       if (!ast_strlen_zero(oh->exten))
03607          ast_copy_string(chan->exten, oh->exten, sizeof(chan->exten));
03608       if (oh->priority) 
03609          chan->priority = oh->priority;
03610    }
03611    if (chan->_state == AST_STATE_UP)
03612       *outstate = AST_CONTROL_ANSWER;
03613 
03614    if (res <= 0) {
03615       if ( AST_CONTROL_RINGING == last_subclass ) 
03616          chan->hangupcause = AST_CAUSE_NO_ANSWER;
03617       if (!chan->cdr && (chan->cdr = ast_cdr_alloc()))
03618          ast_cdr_init(chan->cdr, chan);
03619       if (chan->cdr) {
03620          char tmp[256];
03621          snprintf(tmp, sizeof(tmp), "%s/%s", type, (char *)data);
03622          ast_cdr_setapp(chan->cdr,"Dial",tmp);
03623          ast_cdr_update(chan);
03624          ast_cdr_start(chan->cdr);
03625          ast_cdr_end(chan->cdr);
03626          /* If the cause wasn't handled properly */
03627          if (ast_cdr_disposition(chan->cdr,chan->hangupcause))
03628             ast_cdr_failed(chan->cdr);
03629       }
03630       ast_hangup(chan);
03631       chan = NULL;
03632    }
03633    return chan;
03634 }

static void __init_state2str_threadbuf ( void   )  [static]

Definition at line 87 of file channel.c.

00102 {

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

Activate a given generator

Definition at line 1883 of file channel.c.

References ast_generator::alloc, ast_channel_lock, ast_channel_unlock, ast_prod(), ast_settimeout(), chanlist::chan, 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(), eivr_comm(), old_milliwatt_exec(), and transmit_audio().

01884 {
01885    int res = 0;
01886 
01887    ast_channel_lock(chan);
01888 
01889    if (chan->generatordata) {
01890       if (chan->generator && chan->generator->release)
01891          chan->generator->release(chan, chan->generatordata);
01892       chan->generatordata = NULL;
01893    }
01894 
01895    ast_prod(chan);
01896    if (gen->alloc && !(chan->generatordata = gen->alloc(chan, params))) {
01897       res = -1;
01898    }
01899    
01900    if (!res) {
01901       ast_settimeout(chan, 50, generator_force, chan);
01902       chan->generator = gen;
01903    }
01904 
01905    ast_channel_unlock(chan);
01906 
01907    return res;
01908 }

int ast_active_channels ( void   ) 

returns number of active/allocated channels

Returns number of active/allocated channels

Definition at line 497 of file channel.c.

References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, and AST_RWLIST_UNLOCK.

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

00498 {
00499    struct ast_channel *c;
00500    int cnt = 0;
00501    AST_RWLIST_RDLOCK(&channels);
00502    AST_RWLIST_TRAVERSE(&channels, c, chan_list)
00503       cnt++;
00504    AST_RWLIST_UNLOCK(&channels);
00505    return cnt;
00506 }

int ast_answer ( struct ast_channel chan  ) 

Answer a channel.

Parameters:
chan channel to answer
This function answers a channel and handles all necessary call setup functions.

Note:
The channel passed does not need to be locked, but is locked by the function when needed.

This function will wait up to 500 milliseconds for media to arrive on the channel before returning to the caller, so that the caller can properly assume the channel is 'ready' for media flow.

Return values:
0 on success
non-zero on failure

Definition at line 1833 of file channel.c.

References __ast_answer(), and chanlist::chan.

Referenced by action_bridge(), agi_exec_full(), alarmreceiver_exec(), answer_trunk_chan(), app_exec(), ast_control_streamfile(), ast_pickup_call(), auth_exec(), background_detect_exec(), bridge_exec(), builtin_parkcall(), common_exec(), conf_exec(), count_exec(), dahdiras_exec(), dictate_exec(), directory_exec(), disa_exec(), eivr_comm(), handle_answer(), ices_exec(), login_exec(), minivm_accmess_exec(), minivm_greet_exec(), minivm_record_exec(), old_milliwatt_exec(), park_call_exec(), park_exec_full(), pbx_builtin_background(), pickup_do(), playback_exec(), privacy_exec(), read_exec(), readexten_exec(), rpt_exec(), sayunixtime_exec(), send_waveform_to_channel(), setup_privacy_args(), skel_exec(), sla_station_exec(), speech_background(), testclient_exec(), testserver_exec(), transmit(), vm_exec(), vm_execmain(), waitfor_exec(), and zapateller_exec().

01834 {
01835    return __ast_answer(chan, 0, 1);
01836 }

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 483 of file channel.c.

References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_softhangup(), and AST_SOFTHANGUP_SHUTDOWN.

Referenced by quit_handler().

00484 {
00485    struct ast_channel *c;
00486    shutting_down = 1;
00487    if (hangup) {
00488       AST_RWLIST_RDLOCK(&channels);
00489       AST_RWLIST_TRAVERSE(&channels, c, chan_list) {
00490          ast_softhangup(c, AST_SOFTHANGUP_SHUTDOWN);
00491       }
00492       AST_RWLIST_UNLOCK(&channels);
00493    }
00494 }

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 711 of file channel.c.

References ARRAY_LEN, 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_SLINEAR16, AST_FORMAT_SPEEX, AST_FORMAT_ULAW, ast_log(), LOG_WARNING, and prefs.

Referenced by __oh323_new(), agent_call(), ast_codec_choose(), ast_iax2_new(), ast_speech_new(), builtin_atxfer(), echo_exec(), findmeexec(), gtalk_new(), handle_open_receive_channel_ack_message(), iax2_request(), jingle_new(), local_new(), login_exec(), mgcp_new(), sip_new(), skinny_new(), skinny_set_rtp_peer(), socket_process(), start_rtp(), transmit_connect(), and unistim_new().

00712 {
00713    /* This just our opinion, expressed in code.  We are asked to choose
00714       the best codec to use, given no information */
00715    int x;
00716    static const int prefs[] =
00717    {
00718       /*! Okay, ulaw is used by all telephony equipment, so start with it */
00719       AST_FORMAT_ULAW,
00720       /*! Unless of course, you're a silly European, so then prefer ALAW */
00721       AST_FORMAT_ALAW,
00722       /*! G.722 is better then all below, but not as common as the above... so give ulaw and alaw priority */
00723       AST_FORMAT_G722,
00724       /*! Okay, well, signed linear is easy to translate into other stuff */
00725       AST_FORMAT_SLINEAR16,
00726       AST_FORMAT_SLINEAR,
00727       /*! G.726 is standard ADPCM, in RFC3551 packing order */
00728       AST_FORMAT_G726,
00729       /*! G.726 is standard ADPCM, in AAL2 packing order */
00730       AST_FORMAT_G726_AAL2,
00731       /*! ADPCM has great sound quality and is still pretty easy to translate */
00732       AST_FORMAT_ADPCM,
00733       /*! Okay, we're down to vocoders now, so pick GSM because it's small and easier to
00734           translate and sounds pretty good */
00735       AST_FORMAT_GSM,
00736       /*! iLBC is not too bad */
00737       AST_FORMAT_ILBC,
00738       /*! Speex is free, but computationally more expensive than GSM */
00739       AST_FORMAT_SPEEX,
00740       /*! Ick, LPC10 sounds terrible, but at least we have code for it, if you're tacky enough
00741           to use it */
00742       AST_FORMAT_LPC10,
00743       /*! G.729a is faster than 723 and slightly less expensive */
00744       AST_FORMAT_G729A,
00745       /*! Down to G.723.1 which is proprietary but at least designed for voice */
00746       AST_FORMAT_G723_1,
00747    };
00748 
00749    /* Strip out video */
00750    fmts &= AST_FORMAT_AUDIO_MASK;
00751    
00752    /* Find the first preferred codec in the format given */
00753    for (x = 0; x < ARRAY_LEN(prefs); x++) {
00754       if (fmts & prefs[x])
00755          return prefs[x];
00756    }
00757 
00758    ast_log(LOG_WARNING, "Don't know any of 0x%x formats\n", fmts);
00759 
00760    return 0;
00761 }

struct ast_channel* ast_bridged_channel ( struct ast_channel chan  ) 

Find bridged channel.

Parameters:
chan Current channel

Definition at line 4372 of file channel.c.

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

Referenced by __dahdi_exception(), action_agents(), action_coreshowchannels(), agents_show(), agents_show_online(), ast_bridge_call(), ast_channel_masquerade(), ast_park_call_full(), ast_rtp_set_vars(), attempt_transfer(), cb_events(), channel_spy(), check_bridge(), common_exec(), console_transfer(), create_jb(), dahdi_handle_event(), dahdi_hangup(), export_aoc_vars(), get_refer_info(), handle_chanlist(), handle_hd_hf(), handle_invite_replaces(), handle_request(), handle_request_bye(), handle_request_info(), handle_request_refer(), handle_showchan(), handle_soft_key_event_message(), handle_stimulus_message(), key_call(), key_dial_page(), local_attended_transfer(), mgcp_hangup(), mgcp_ss(), misdn_transfer_bc(), mixmonitor_thread(), schedule_delivery(), sip_hangup(), sip_read(), skinny_transfer(), socket_process(), ss_thread(), start_spying(), startmon(), TransferCallStep1(), and unistim_hangup().

04373 {
04374    struct ast_channel *bridged;
04375    bridged = chan->_bridge;
04376    if (bridged && bridged->tech->bridged_channel)
04377       bridged = bridged->tech->bridged_channel(chan, bridged);
04378    return bridged;
04379 }

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 3697 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, chanlist::chan, and ast_channel::tech.

Referenced by __ast_request_and_dial(), agent_call(), ast_feature_request_and_dial(), attempt_reconnect(), begin_dial_channel(), connect_link(), dial_exec_full(), do_forward(), do_idle_thread(), findmeexec(), ring_entry(), and rpt().

03698 {
03699    /* Place an outgoing call, but don't wait any longer than timeout ms before returning.
03700       If the remote end does not answer within the timeout, then do NOT hang up, but
03701       return anyway.  */
03702    int res = -1;
03703    /* Stop if we're a zombie or need a soft hangup */
03704    ast_channel_lock(chan);
03705    if (!ast_test_flag(chan, AST_FLAG_ZOMBIE) && !ast_check_hangup(chan)) {
03706       if (chan->cdr)
03707          ast_set_flag(chan->cdr, AST_CDR_FLAG_DIALED);
03708       if (chan->tech->call)
03709          res = chan->tech->call(chan, addr, timeout);
03710       ast_set_flag(chan, AST_FLAG_OUTGOING);
03711    }
03712    ast_channel_unlock(chan);
03713    return res;
03714 }

void ast_cancel_shutdown ( void   ) 

Cancel a shutdown in progress.

Cancels an existing shutdown and returns to normal operation

Definition at line 509 of file channel.c.

Referenced by handle_abort_shutdown().

00510 {
00511    shutting_down = 0;
00512 }

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 629 of file channel.c.

References ARRAY_LEN, causes, and ast_cause::desc.

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

00630 {
00631    int x;
00632 
00633    for (x = 0; x < ARRAY_LEN(causes); x++) {
00634       if (causes[x].cause == cause)
00635          return causes[x].desc;
00636    }
00637 
00638    return "Unknown";
00639 }

void ast_change_name ( struct ast_channel chan,
char *  newname 
)

Change channel name.

Note:
The channel must be locked before calling this function.

Definition at line 3949 of file channel.c.

References ast_string_field_set, chanlist::chan, EVENT_FLAG_CALL, manager_event, ast_channel::name, name, and ast_channel::uniqueid.

Referenced by update_name().

03950 {
03951    manager_event(EVENT_FLAG_CALL, "Rename", "Channel: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", chan->name, newname, chan->uniqueid);
03952    ast_string_field_set(chan, name, newname);
03953 }

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.

Return values:
NULL failure
non-NULL successfully allocated channel
Note:
By default, new channels are set to the "s" extension and "default" context.

Definition at line 769 of file channel.c.

References accountcode, AST_ALERT_FD, ast_atomic_fetchadd_int(), ast_calloc, ast_cdr_alloc(), ast_cdr_init(), ast_cdr_start(), ast_channel_set_fd(), ast_config_AST_SYSTEM_NAME, ast_copy_string(), ast_default_accountcode, ast_default_amaflags, ast_free, AST_LIST_HEAD_INIT_NOLOCK, ast_log(), AST_MAX_FDS, ast_mutex_init(), AST_RWLIST_INSERT_HEAD, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_state2str(), ast_strdup, ast_string_field_build, ast_string_field_build_va, ast_string_field_free_memory, ast_string_field_init, ast_string_field_set, ast_strlen_zero(), ast_timer_close(), ast_timer_fd(), ast_timer_open(), AST_TIMING_FD, defaultlanguage, errno, EVENT_FLAG_CALL, chanlist::flags, language, LOG_WARNING, manager_event, name, null_tech, S_OR, sched_context_create(), and sched_context_destroy().

Referenced by __oh323_new(), acf_odbc_read(), acf_odbc_write(), action_bridge(), action_getvar(), agent_new(), alsa_new(), ast_async_goto(), ast_iax2_new(), ast_pbx_outgoing_cdr_failed(), ast_pbx_outgoing_exten(), bridge_exec(), builtin_atxfer(), check_goto_on_transfer(), console_new(), dahdi_new(), gtalk_new(), iax_park(), jingle_new(), local_new(), make_email_file(), masq_park_call(), mgcp_new(), misdn_new(), nbs_new(), oss_new(), pbx_substitute_variables_helper_full(), phone_new(), rotate_file(), sendmail(), sendpage(), sip_new(), sip_park(), skinny_new(), unistim_new(), and usbradio_new().

00770 {
00771    struct ast_channel *tmp;
00772    int x;
00773    int flags;
00774    struct varshead *headp;
00775    va_list ap1, ap2;
00776 
00777    /* If shutting down, don't allocate any new channels */
00778    if (shutting_down) {
00779       ast_log(LOG_WARNING, "Channel allocation failed: Refusing due to active shutdown\n");
00780       return NULL;
00781    }
00782 
00783    if (!(tmp = ast_calloc(1, sizeof(*tmp))))
00784       return NULL;
00785 
00786    if (!(tmp->sched = sched_context_create())) {
00787       ast_log(LOG_WARNING, "Channel allocation failed: Unable to create schedule context\n");
00788       ast_free(tmp);
00789       return NULL;
00790    }
00791    
00792    if ((ast_string_field_init(tmp, 128))) {
00793       sched_context_destroy(tmp->sched);
00794       ast_free(tmp);
00795       return NULL;
00796    }
00797 
00798 #ifdef HAVE_EPOLL
00799    tmp->epfd = epoll_create(25);
00800 #endif
00801 
00802    for (x = 0; x < AST_MAX_FDS; x++) {
00803       tmp->fds[x] = -1;
00804 #ifdef HAVE_EPOLL
00805       tmp->epfd_data[x] = NULL;
00806 #endif
00807    }
00808 
00809    if ((tmp->timer = ast_timer_open())) {
00810       needqueue = 0;
00811       tmp->timingfd = ast_timer_fd(tmp->timer);
00812    } else {
00813       tmp->timingfd = -1;
00814    }
00815 
00816    if (needqueue) {
00817       if (pipe(tmp->alertpipe)) {
00818          ast_log(LOG_WARNING, "Channel allocation failed: Can't create alert pipe!\n");
00819 alertpipe_failed:
00820          if (tmp->timer) {
00821             ast_timer_close(tmp->timer);
00822          }
00823 
00824          sched_context_destroy(tmp->sched);
00825          ast_string_field_free_memory(tmp);
00826          ast_free(tmp);
00827          return NULL;
00828       } else {
00829          flags = fcntl(tmp->alertpipe[0], F_GETFL);
00830          if (fcntl(tmp->alertpipe[0], F_SETFL, flags | O_NONBLOCK) < 0) {
00831             ast_log(LOG_WARNING, "Channel allocation failed: Unable to set alertpipe nonblocking! (%d: %s)\n", errno, strerror(errno));
00832             close(tmp->alertpipe[0]);
00833             close(tmp->alertpipe[1]);
00834             goto alertpipe_failed;
00835          }
00836          flags = fcntl(tmp->alertpipe[1], F_GETFL);
00837          if (fcntl(tmp->alertpipe[1], F_SETFL, flags | O_NONBLOCK) < 0) {
00838             ast_log(LOG_WARNING, "Channel allocation failed: Unable to set alertpipe nonblocking! (%d: %s)\n", errno, strerror(errno));
00839             close(tmp->alertpipe[0]);
00840             close(tmp->alertpipe[1]);
00841             goto alertpipe_failed;
00842          }
00843       }
00844    } else   /* Make sure we've got it done right if they don't */
00845       tmp->alertpipe[0] = tmp->alertpipe[1] = -1;
00846 
00847    /* Always watch the alertpipe */
00848    ast_channel_set_fd(tmp, AST_ALERT_FD, tmp->alertpipe[0]);
00849    /* And timing pipe */
00850    ast_channel_set_fd(tmp, AST_TIMING_FD, tmp->timingfd);
00851    ast_string_field_set(tmp, name, "**Unknown**");
00852 
00853    /* Initial state */
00854    tmp->_state = state;
00855 
00856    tmp->streamid = -1;
00857    
00858    tmp->fin = global_fin;
00859    tmp->fout = global_fout;
00860 
00861    if (ast_strlen_zero(ast_config_AST_SYSTEM_NAME)) {
00862       ast_string_field_build(tmp, uniqueid, "%li.%d", (long) time(NULL), 
00863                    ast_atomic_fetchadd_int(&uniqueint, 1));
00864    } else {
00865       ast_string_field_build(tmp, uniqueid, "%s-%li.%d", ast_config_AST_SYSTEM_NAME, 
00866                    (long) time(NULL), ast_atomic_fetchadd_int(&uniqueint, 1));
00867    }
00868 
00869    tmp->cid.cid_name = ast_strdup(cid_name);
00870    tmp->cid.cid_num = ast_strdup(cid_num);
00871    
00872    if (!ast_strlen_zero(name_fmt)) {
00873       /* Almost every channel is calling this function, and setting the name via the ast_string_field_build() call.
00874        * And they all use slightly different formats for their name string.
00875        * This means, to set the name here, we have to accept variable args, and call the string_field_build from here.
00876        * This means, that the stringfields must have a routine that takes the va_lists directly, and 
00877        * uses them to build the string, instead of forming the va_lists internally from the vararg ... list.
00878        * This new function was written so this can be accomplished.
00879        */
00880       va_start(ap1, name_fmt);
00881       va_start(ap2, name_fmt);
00882       ast_string_field_build_va(tmp, name, name_fmt, ap1, ap2);
00883       va_end(ap1);
00884       va_end(ap2);
00885    }
00886 
00887    /* Reminder for the future: under what conditions do we NOT want to track cdrs on channels? */
00888 
00889    /* These 4 variables need to be set up for the cdr_init() to work right */
00890    if (amaflag)
00891       tmp->amaflags = amaflag;
00892    else
00893       tmp->amaflags = ast_default_amaflags;
00894    
00895    if (!ast_strlen_zero(acctcode))
00896       ast_string_field_set(tmp, accountcode, acctcode);
00897    else
00898       ast_string_field_set(tmp, accountcode, ast_default_accountcode);
00899       
00900    if (!ast_strlen_zero(context))
00901       ast_copy_string(tmp->context, context, sizeof(tmp->context));
00902    else
00903       strcpy(tmp->context, "default");
00904 
00905    if (!ast_strlen_zero(exten))
00906       ast_copy_string(tmp->exten, exten, sizeof(tmp->exten));
00907    else
00908       strcpy(tmp->exten, "s");
00909 
00910    tmp->priority = 1;
00911       
00912    tmp->cdr = ast_cdr_alloc();
00913    ast_cdr_init(tmp->cdr, tmp);
00914    ast_cdr_start(tmp->cdr);
00915    
00916    headp = &tmp->varshead;
00917    AST_LIST_HEAD_INIT_NOLOCK(headp);
00918    
00919    ast_mutex_init(&tmp->lock_dont_use);
00920    
00921    AST_LIST_HEAD_INIT_NOLOCK(&tmp->datastores);
00922    
00923    ast_string_field_set(tmp, language, defaultlanguage);
00924 
00925    tmp->tech = &null_tech;
00926 
00927    AST_RWLIST_WRLOCK(&channels);
00928    AST_RWLIST_INSERT_HEAD(&channels, tmp, chan_list);
00929    AST_RWLIST_UNLOCK(&channels);
00930 
00931    /*\!note
00932     * and now, since the channel structure is built, and has its name, let's
00933     * call the manager event generator with this Newchannel event. This is the
00934     * proper and correct place to make this call, but you sure do have to pass
00935     * a lot of data into this func to do it here!
00936     */
00937    if (!ast_strlen_zero(name_fmt)) {
00938       manager_event(EVENT_FLAG_CALL, "Newchannel",
00939          "Channel: %s\r\n"
00940          "ChannelState: %d\r\n"
00941          "ChannelStateDesc: %s\r\n"
00942          "CallerIDNum: %s\r\n"
00943          "CallerIDName: %s\r\n"
00944          "AccountCode: %s\r\n"
00945          "Uniqueid: %s\r\n",
00946          tmp->name, 
00947          state, 
00948          ast_state2str(state),
00949          S_OR(cid_num, ""),
00950          S_OR(cid_name, ""),
00951          tmp->accountcode,
00952          tmp->uniqueid);
00953    }
00954 
00955    return tmp;
00956 }

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 4674 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_debug, AST_FEATURE_PLAY_WARNING, 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_test_flag, ast_tvadd(), ast_tvdiff_ms(), ast_tvnow(), ast_tvsub(), ast_tvzero(), ast_verb, ast_channel::audiohooks, ast_channel_tech::bridge, bridge_play_sounds(), bridge_playfile(), ast_channel::cid, ast_callerid::cid_num, config, EVENT_FLAG_CALL, ast_channel::generator, LOG_WARNING, manager_bridge_event(), manager_event, ast_channel::masq, ast_channel::masqr, ast_channel::monitor, ast_channel::name, ast_channel::nativeformats, ast_channel::readformat, ast_channel_tech::send_digit_begin, ast_channel::tech, ast_channel::uniqueid, update_bridge_vars(), and ast_channel::writeformat.

Referenced by ast_bridge_call().

04676 {
04677    struct ast_channel *who = NULL;
04678    enum ast_bridge_result res = AST_BRIDGE_COMPLETE;
04679    int nativefailed=0;
04680    int firstpass;
04681    int o0nativeformats;
04682    int o1nativeformats;
04683    long time_left_ms=0;
04684    char caller_warning = 0;
04685    char callee_warning = 0;
04686 
04687    if (c0->_bridge) {
04688       ast_log(LOG_WARNING, "%s is already in a bridge with %s\n",
04689          c0->name, c0->_bridge->name);
04690       return -1;
04691    }
04692    if (c1->_bridge) {
04693       ast_log(LOG_WARNING, "%s is already in a bridge with %s\n",
04694          c1->name, c1->_bridge->name);
04695       return -1;
04696    }
04697    
04698    /* Stop if we're a zombie or need a soft hangup */
04699    if (ast_test_flag(c0, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c0) ||
04700        ast_test_flag(c1, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c1))
04701       return -1;
04702 
04703    *fo = NULL;
04704    firstpass = config->firstpass;
04705    config->firstpass = 0;
04706 
04707    if (ast_tvzero(config->start_time))
04708       config->start_time = ast_tvnow();
04709    time_left_ms = config->timelimit;
04710 
04711    caller_warning = ast_test_flag(&config->features_caller, AST_FEATURE_PLAY_WARNING);
04712    callee_warning = ast_test_flag(&config->features_callee, AST_FEATURE_PLAY_WARNING);
04713 
04714    if (config->start_sound && firstpass) {
04715       if (caller_warning)
04716          bridge_playfile(c0, c1, config->start_sound, time_left_ms / 1000);
04717       if (callee_warning)
04718          bridge_playfile(c1, c0, config->start_sound, time_left_ms / 1000);
04719    }
04720 
04721    /* Keep track of bridge */
04722    c0->_bridge = c1;
04723    c1->_bridge = c0;
04724 
04725 
04726    o0nativeformats = c0->nativeformats;
04727    o1nativeformats = c1->nativeformats;
04728 
04729    if (config->feature_timer && !ast_tvzero(config->nexteventts)) {
04730       config->nexteventts = ast_tvadd(config->start_time, ast_samp2tv(config->feature_timer, 1000));
04731    } else if (config->timelimit && firstpass) {
04732       config->nexteventts = ast_tvadd(config->start_time, ast_samp2tv(config->timelimit, 1000));
04733       if (caller_warning || callee_warning)
04734          config->nexteventts = ast_tvsub(config->nexteventts, ast_samp2tv(config->play_warning, 1000));
04735    }
04736 
04737    if (!c0->tech->send_digit_begin)
04738       ast_set_flag(c1, AST_FLAG_END_DTMF_ONLY);
04739    if (!c1->tech->send_digit_begin)
04740       ast_set_flag(c0, AST_FLAG_END_DTMF_ONLY);
04741    manager_bridge_event(1, 1, c0, c1);
04742 
04743    /* Before we enter in and bridge these two together tell them both the source of audio has changed */
04744    ast_indicate(c0, AST_CONTROL_SRCUPDATE);
04745    ast_indicate(c1, AST_CONTROL_SRCUPDATE);
04746 
04747    for (/* ever */;;) {
04748       struct timeval now = { 0, };
04749       int to;
04750 
04751       to = -1;
04752 
04753       if (!ast_tvzero(config->nexteventts)) {
04754          now = ast_tvnow();
04755          to = ast_tvdiff_ms(config->nexteventts, now);
04756          if (to <= 0) {
04757             if (!config->timelimit) {
04758                res = AST_BRIDGE_COMPLETE;
04759                break;
04760             }
04761             to = 0;
04762          }
04763       }
04764 
04765       if (config->timelimit) {
04766          time_left_ms = config->timelimit - ast_tvdiff_ms(now, config->start_time);
04767          if (time_left_ms < to)
04768             to = time_left_ms;
04769 
04770          if (time_left_ms <= 0) {
04771             if (caller_warning && config->end_sound)
04772                bridge_playfile(c0, c1, config->end_sound, 0);
04773             if (callee_warning && config->end_sound)
04774                bridge_playfile(c1, c0, config->end_sound, 0);
04775             *fo = NULL;
04776             if (who)
04777                *rc = who;
04778             res = 0;
04779             break;
04780          }
04781 
04782          if (!to) {
04783             if (time_left_ms >= 5000 && config->warning_sound && config->play_warning && ast_test_flag(config, AST_FEATURE_WARNING_ACTIVE)) {
04784                int t = (time_left_ms + 500) / 1000; /* round to nearest second */
04785                if (caller_warning)
04786                   bridge_playfile(c0, c1, config->warning_sound, t);
04787                if (callee_warning)
04788                   bridge_playfile(c1, c0, config->warning_sound, t);
04789             }
04790             if (config->warning_freq && (time_left_ms > (config->warning_freq + 5000)))
04791                config->nexteventts = ast_tvadd(config->nexteventts, ast_samp2tv(config->warning_freq, 1000));
04792             else
04793                config->nexteventts = ast_tvadd(config->start_time, ast_samp2tv(config->timelimit, 1000));
04794          }
04795          ast_clear_flag(config, AST_FEATURE_WARNING_ACTIVE);
04796       }
04797 
04798       if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE || c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE) {
04799          if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
04800             c0->_softhangup = 0;
04801          if (c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
04802             c1->_softhangup = 0;
04803          c0->_bridge = c1;
04804          c1->_bridge = c0;
04805          ast_debug(1, "Unbridge signal received. Ending native bridge.\n");
04806          continue;
04807       }
04808 
04809       /* Stop if we're a zombie or need a soft hangup */
04810       if (ast_test_flag(c0, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c0) ||
04811           ast_test_flag(c1, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c1)) {
04812          *fo = NULL;
04813          if (who)
04814             *rc = who;
04815          res = 0;
04816          ast_debug(1, "Bridge stops because we're zombie or need a soft hangup: c0=%s, c1=%s, flags: %s,%s,%s,%s\n",
04817             c0->name, c1->name,
04818             ast_test_flag(c0, AST_FLAG_ZOMBIE) ? "Yes" : "No",
04819             ast_check_hangup(c0) ? "Yes" : "No",
04820             ast_test_flag(c1, AST_FLAG_ZOMBIE) ? "Yes" : "No",
04821             ast_check_hangup(c1) ? "Yes" : "No");
04822          break;
04823       }
04824 
04825       update_bridge_vars(c0, c1);
04826 
04827       bridge_play_sounds(c0, c1);
04828 
04829       if (c0->tech->bridge &&
04830           (c0->tech->bridge == c1->tech->bridge) &&
04831           !nativefailed && !c0->monitor && !c1->monitor &&
04832           !c0->audiohooks && !c1->audiohooks && 
04833           !c0->masq && !c0->masqr && !c1->masq && !c1->masqr) {
04834          /* Looks like they share a bridge method and nothing else is in the way */
04835          ast_set_flag(c0, AST_FLAG_NBRIDGE);
04836          ast_set_flag(c1, AST_FLAG_NBRIDGE);
04837          if ((res = c0->tech->bridge(c0, c1, config->flags, fo, rc, to)) == AST_BRIDGE_COMPLETE) {
04838             /* \todo  XXX here should check that cid_num is not NULL */
04839             manager_event(EVENT_FLAG_CALL, "Unlink",
04840                      "Channel1: %s\r\n"
04841                      "Channel2: %s\r\n"
04842                      "Uniqueid1: %s\r\n"
04843                      "Uniqueid2: %s\r\n"
04844                      "CallerID1: %s\r\n"
04845                      "CallerID2: %s\r\n",
04846                      c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num);
04847             ast_debug(1, "Returning from native bridge, channels: %s, %s\n", c0->name, c1->name);
04848 
04849             ast_clear_flag(c0, AST_FLAG_NBRIDGE);
04850             ast_clear_flag(c1, AST_FLAG_NBRIDGE);
04851 
04852             if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE || c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
04853                continue;
04854 
04855             c0->_bridge = NULL;
04856             c1->_bridge = NULL;
04857 
04858             return res;
04859          } else {
04860             ast_clear_flag(c0, AST_FLAG_NBRIDGE);
04861             ast_clear_flag(c1, AST_FLAG_NBRIDGE);
04862          }
04863          switch (res) {
04864          case AST_BRIDGE_RETRY:
04865             if (config->play_warning) {
04866                ast_set_flag(config, AST_FEATURE_WARNING_ACTIVE);
04867             }
04868             continue;
04869          default:
04870             ast_verb(3, "Native bridging %s and %s ended\n", c0->name, c1->name);
04871             /* fallthrough */
04872          case AST_BRIDGE_FAILED_NOWARN:
04873             nativefailed++;
04874             break;
04875          }
04876       }
04877 
04878       if (((c0->writeformat != c1->readformat) || (c0->readformat != c1->writeformat) ||
04879           (c0->nativeformats != o0nativeformats) || (c1->nativeformats != o1nativeformats)) &&
04880           !(c0->generator || c1->generator)) {
04881          if (ast_channel_make_compatible(c0, c1)) {
04882             ast_log(LOG_WARNING, "Can't make %s and %s compatible\n", c0->name, c1->name);
04883             manager_bridge_event(0, 1, c0, c1);
04884             return AST_BRIDGE_FAILED;
04885          }
04886          o0nativeformats = c0->nativeformats;
04887          o1nativeformats = c1->nativeformats;
04888       }
04889 
04890       update_bridge_vars(c0, c1);
04891 
04892       res = ast_generic_bridge(c0, c1, config, fo, rc, config->nexteventts);
04893       if (res != AST_BRIDGE_RETRY) {
04894          break;
04895       } else if (config->feature_timer) {
04896          /* feature timer expired but has not been updated, sending to ast_bridge_call to do so */
04897          break;
04898       }
04899    }
04900 
04901    ast_clear_flag(c0, AST_FLAG_END_DTMF_ONLY);
04902    ast_clear_flag(c1, AST_FLAG_END_DTMF_ONLY);
04903 
04904    /* Now that we have broken the bridge the source will change yet again */
04905    ast_indicate(c0, AST_CONTROL_SRCUPDATE);
04906    ast_indicate(c1, AST_CONTROL_SRCUPDATE);
04907 
04908    c0->_bridge = NULL;
04909    c1->_bridge = NULL;
04910 
04911    /* \todo  XXX here should check that cid_num is not NULL */
04912    manager_event(EVENT_FLAG_CALL, "Unlink",
04913             "Channel1: %s\r\n"
04914             "Channel2: %s\r\n"
04915             "Uniqueid1: %s\r\n"
04916             "Uniqueid2: %s\r\n"
04917             "CallerID1: %s\r\n"
04918             "CallerID2: %s\r\n",
04919             c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num);
04920    ast_debug(1, "Bridge stops bridging channels %s and %s\n", c0->name, c1->name);
04921 
04922    return res;
04923 }

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 return -1.
See also:
ast_channel_cmpwhentohangup_tv()
Version:
1.6.1 deprecated function (only had seconds precision)

Definition at line 550 of file channel.c.

References ast_channel_cmpwhentohangup_tv(), and chanlist::chan.

00551 {
00552    struct timeval when = { offset, };
00553    return ast_channel_cmpwhentohangup_tv(chan, when);
00554 }

int ast_channel_cmpwhentohangup_tv ( struct ast_channel chan,
struct timeval  offset 
)

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

Parameters:
chan channel on which to check for hangup
offset offset in seconds and microseconds 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 return -1.
Since:
1.6.1

Definition at line 535 of file channel.c.

References ast_tvadd(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), chanlist::chan, and ast_channel::whentohangup.

Referenced by ast_channel_cmpwhentohangup().

00536 {
00537    struct timeval whentohangup;
00538 
00539    if (ast_tvzero(chan->whentohangup))
00540       return ast_tvzero(offset) ? 0 : -1;
00541 
00542    if (ast_tvzero(offset))
00543       return 1;
00544 
00545    whentohangup = ast_tvadd(offset, ast_tvnow());
00546 
00547    return ast_tvdiff_ms(whentohangup, chan->whentohangup);
00548 }

int ast_channel_datastore_add ( struct ast_channel chan,
struct ast_datastore datastore 
)

Add a datastore to a channel.

Note:
The channel should be locked before calling this function.
Return values:
0 success
non-zero failure

Definition at line 1428 of file channel.c.

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

Referenced by _macro_exec(), acf_iaxvar_write(), add_features_datastores(), add_to_agi(), ast_iax2_new(), audiohook_volume_get(), authenticate_reply(), dial_exec_full(), dundi_query_read(), enable_jack_hook(), enum_query_read(), get_lock(), gosub_exec(), lua_get_state(), pbx_builtin_raise_exception(), setup_chanspy_ds(), setup_inheritance_datastore(), setup_mixmonitor_ds(), setup_transfer_datastore(), shared_write(), smdi_msg_retrieve_read(), socket_process(), speech_create(), speex_write(), try_calling(), and volume_write().

01429 {
01430    int res = 0;
01431 
01432    AST_LIST_INSERT_HEAD(&chan->datastores, datastore, entry);
01433 
01434    return res;
01435 }

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

Create a channel data store object.

Deprecated:
You should use the ast_datastore_alloc() generic function instead.
Version:
1.6.1 deprecated

Definition at line 1401 of file channel.c.

References ast_datastore_alloc(), and ast_datastore::info.

01402 {
01403    return ast_datastore_alloc(info, uid);
01404 }

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

Find a datastore on a channel.

Note:
The channel should be locked before calling this function.

The datastore returned from this function must not be used if the reference to the channel is released.

Return values:
pointer to the datastore if found
NULL if not found

Definition at line 1442 of file channel.c.

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

Referenced by _macro_exec(), acf_exception_read(), acf_fetch(), acf_iaxvar_read(), acf_iaxvar_write(), add_agi_cmd(), add_features_datastores(), add_to_agi(), attended_transfer_occurred(), audiohook_volume_callback(), audiohook_volume_get(), builtin_atxfer(), chanspy_ds_free(), dial_exec_full(), disable_jack_hook(), dundi_result_read(), enable_jack_hook(), enum_result_read(), exec_odbcfinish(), find_speech(), func_inheritance_write(), get_agi_cmd(), get_lock(), gosub_exec(), iax2_call(), jack_hook_callback(), local_read(), local_write(), lua_get_state(), manage_parkinglot(), park_exec_full(), pbx_builtin_raise_exception(), pop_exec(), queue_transfer_fixup(), return_exec(), shared_read(), shared_write(), smdi_msg_read(), speech_background(), speech_destroy(), speex_callback(), speex_read(), speex_write(), try_calling(), unlock_read(), volume_callback(), and volume_write().

01443 {
01444    struct ast_datastore *datastore = NULL;
01445    
01446    if (info == NULL)
01447       return NULL;
01448 
01449    AST_LIST_TRAVERSE_SAFE_BEGIN(&chan->datastores, datastore, entry) {
01450       if (datastore->info != info) {
01451          continue;
01452       }
01453 
01454       if (uid == NULL) {
01455          /* matched by type only */
01456          break;
01457       }
01458 
01459       if ((datastore->uid != NULL) && !strcasecmp(uid, datastore->uid)) {
01460          /* Matched by type AND uid */
01461          break;
01462       }
01463    }
01464    AST_LIST_TRAVERSE_SAFE_END;
01465 
01466    return datastore;
01467 }

int ast_channel_datastore_free ( struct ast_datastore datastore  ) 

Free a channel data store object.

Deprecated:
You should use the ast_datastore_free() generic function instead.
Version:
1.6.1 deprecated

Definition at line 1406 of file channel.c.

References ast_datastore_free().

01407 {
01408    return ast_datastore_free(datastore);
01409 }

int ast_channel_datastore_inherit ( struct ast_channel from,
struct ast_channel to 
)

Inherit datastores from a parent to a child.

Definition at line 1411 of file channel.c.

References ast_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 __ast_request_and_dial(), dial_exec_full(), do_forward(), and local_call().

01412 {
01413    struct ast_datastore *datastore = NULL, *datastore2;
01414 
01415    AST_LIST_TRAVERSE(&from->datastores, datastore, entry) {
01416       if (datastore->inheritance > 0) {
01417          datastore2 = ast_datastore_alloc(datastore->info, datastore->uid);
01418          if (datastore2) {
01419             datastore2->data = datastore->info->duplicate ? datastore->info->duplicate(datastore->data) : NULL;
01420             datastore2->inheritance = datastore->inheritance == DATASTORE_INHERIT_FOREVER ? DATASTORE_INHERIT_FOREVER : datastore->inheritance - 1;
01421             AST_LIST_INSERT_TAIL(&to->datastores, datastore2, entry);
01422          }
01423       }
01424    }
01425    return 0;
01426 }

int ast_channel_datastore_remove ( struct ast_channel chan,
struct ast_datastore datastore 
)

Remove a datastore from a channel.

Note:
The channel should be locked before calling this function.
Return values:
0 success
non-zero failure

Definition at line 1437 of file channel.c.

References AST_LIST_REMOVE, chanlist::chan, ast_channel::datastores, and ast_datastore::entry.

Referenced by acf_fetch(), chanspy_ds_free(), dial_exec_full(), disable_jack_hook(), exec_odbcfinish(), lua_get_state(), queue_transfer_fixup(), speech_background(), speech_destroy(), speex_write(), and try_calling().

01438 {
01439    return AST_LIST_REMOVE(&chan->datastores, datastore, entry) ? 0 : -1;
01440 }

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 1086 of file channel.c.

References AST_FLAG_DEFER_DTMF, ast_set_flag, ast_test_flag, and chanlist::chan.

Referenced by find_cache().

01087 {
01088    int pre = 0;
01089 
01090    if (chan) {
01091       pre = ast_test_flag(chan, AST_FLAG_DEFER_DTMF);
01092       ast_set_flag(chan, AST_FLAG_DEFER_DTMF);
01093    }
01094    return pre;
01095 }

int ast_channel_early_bridge ( struct ast_channel c0,
struct ast_channel c1 
)

Bridge two channels together (early).

Bridge two channels together (early)

Parameters:
c0 first channel to bridge
c1 second channel to bridge Bridge two channels (c0 and c1) together early. This implies either side may not be answered yet.
Returns:
Returns 0 on success and -1 if it could not be done

Definition at line 4576 of file channel.c.

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

Referenced by dial_exec_full(), and wait_for_answer().

04577 {
04578    /* Make sure we can early bridge, if not error out */
04579    if (!c0->tech->early_bridge || (c1 && (!c1->tech->early_bridge || c0->tech->early_bridge != c1->tech->early_bridge)))
04580       return -1;
04581 
04582    return c0->tech->early_bridge(c0, c1);
04583 }

void ast_channel_free ( struct ast_channel chan  ) 

Free a channel structure.

Definition at line 1292 of file channel.c.

References ast_channel::alertpipe, ast_app_group_discard(), ast_cdr_discard(), ast_channel_lock, AST_CHANNEL_NAME, ast_channel_unlock, ast_copy_string(), ast_datastore_free(), AST_DEVICE_UNKNOWN, ast_devstate_changed_literal(), ast_free, ast_frfree, ast_jb_destroy(), AST_LIST_REMOVE_HEAD, ast_log(), AST_MAX_FDS, ast_moh_cleanup(), ast_mutex_destroy(), AST_RWLIST_REMOVE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_string_field_free_memory, ast_timer_close(), ast_translator_free_path(), ast_var_delete(), ast_channel::cdr, chanlist::chan, ast_channel::cid, ast_channel::datastores, ast_datastore::entry, f, free, free_cid(), ast_channel::lock_dont_use, LOG_ERROR, LOG_WARNING, 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::timer, ast_channel::varshead, and ast_channel::writetrans.

Referenced by 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(), rotate_file(), sendmail(), and sendpage().

01293 {
01294    int fd;
01295 #ifdef HAVE_EPOLL
01296    int i;
01297 #endif
01298    struct ast_var_t *vardata;
01299    struct ast_frame *f;
01300    struct varshead *headp;
01301    struct ast_datastore *datastore = NULL;
01302    char name[AST_CHANNEL_NAME], *dashptr;
01303    
01304    headp=&chan->varshead;
01305    
01306    AST_RWLIST_WRLOCK(&channels);
01307    if (!AST_RWLIST_REMOVE(&channels, chan, chan_list)) {
01308       AST_RWLIST_UNLOCK(&channels);
01309       ast_log(LOG_ERROR, "Unable to find channel in list to free. Assuming it has already been done.\n");
01310    }
01311    /* Lock and unlock the channel just to be sure nobody has it locked still
01312       due to a reference retrieved from the channel list. */
01313    ast_channel_lock(chan);
01314    ast_channel_unlock(chan);
01315 
01316    /* Get rid of each of the data stores on the channel */
01317    while ((datastore = AST_LIST_REMOVE_HEAD(&chan->datastores, entry)))
01318       /* Free the data store */
01319       ast_datastore_free(datastore);
01320 
01321    /* Lock and unlock the channel just to be sure nobody has it locked still
01322       due to a reference that was stored in a datastore. (i.e. app_chanspy) */
01323    ast_channel_lock(chan);
01324    ast_channel_unlock(chan);
01325 
01326    if (chan->tech_pvt) {
01327       ast_log(LOG_WARNING, "Channel '%s' may not have been hung up properly\n", chan->name);
01328       ast_free(chan->tech_pvt);
01329    }
01330 
01331    if (chan->sched)
01332       sched_context_destroy(chan->sched);
01333 
01334    ast_copy_string(name, chan->name, sizeof(name));
01335    if ((dashptr = strrchr(name, '-'))) {
01336       *dashptr = '\0';
01337    }
01338 
01339    /* Stop monitoring */
01340    if (chan->monitor)
01341       chan->monitor->stop( chan, 0 );
01342 
01343    /* If there is native format music-on-hold state, free it */
01344    if (chan->music_state)
01345       ast_moh_cleanup(chan);
01346 
01347    /* Free translators */
01348    if (chan->readtrans)
01349       ast_translator_free_path(chan->readtrans);
01350    if (chan->writetrans)
01351       ast_translator_free_path(chan->writetrans);
01352    if (chan->pbx)
01353       ast_log(LOG_WARNING, "PBX may not have been terminated properly on '%s'\n", chan->name);
01354    free_cid(&chan->cid);
01355    /* Close pipes if appropriate */
01356    if ((fd = chan->alertpipe[0]) > -1)
01357       close(fd);
01358    if ((fd = chan->alertpipe[1]) > -1)
01359       close(fd);
01360    if (chan->timer) {
01361       ast_timer_close(chan->timer);
01362    }
01363 #ifdef HAVE_EPOLL
01364    for (i = 0; i < AST_MAX_FDS; i++) {
01365       if (chan->epfd_data[i])
01366          free(chan->epfd_data[i]);
01367    }
01368    close(chan->epfd);
01369 #endif
01370    while ((f = AST_LIST_REMOVE_HEAD(&chan->readq, frame_list)))
01371       ast_frfree(f);
01372    
01373    /* loop over the variables list, freeing all data and deleting list items */
01374    /* no need to lock the list, as the channel is already locked */
01375    
01376    while ((vardata = AST_LIST_REMOVE_HEAD(headp, entries)))
01377       ast_var_delete(vardata);
01378 
01379    ast_app_group_discard(chan);
01380 
01381    /* Destroy the jitterbuffer */
01382    ast_jb_destroy(chan);
01383 
01384    if (chan->cdr) {
01385       ast_cdr_discard(chan->cdr);
01386       chan->cdr = NULL;
01387    }
01388    
01389    ast_mutex_destroy(&chan->lock_dont_use);
01390 
01391    ast_string_field_free_memory(chan);
01392    ast_free(chan);
01393    AST_RWLIST_UNLOCK(&channels);
01394 
01395    /* Queue an unknown state, because, while we know that this particular
01396     * instance is dead, we don't know the state of all other possible
01397     * instances. */
01398    ast_devstate_changed_literal(AST_DEVICE_UNKNOWN, name);
01399 }

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 3955 of file channel.c.

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

Referenced by __ast_request_and_dial(), agent_call(), ast_feature_request_and_dial(), begin_dial_channel(), dial_exec_full(), do_forward(), findmeexec(), and ring_entry().

03956 {
03957    struct ast_var_t *current, *newvar;
03958    const char *varname;
03959 
03960    AST_LIST_TRAVERSE(&parent->varshead, current, entries) {
03961       int vartype = 0;
03962 
03963       varname = ast_var_full_name(current);
03964       if (!varname)
03965          continue;
03966 
03967       if (varname[0] == '_') {
03968          vartype = 1;
03969          if (varname[1] == '_')
03970             vartype = 2;
03971       }
03972 
03973       switch (vartype) {
03974       case 1:
03975          newvar = ast_var_assign(&varname[1], ast_var_value(current));
03976          if (newvar) {
03977             AST_LIST_INSERT_TAIL(&child->varshead, newvar, entries);
03978             ast_debug(1, "Copying soft-transferable variable %s.\n", ast_var_name(newvar));
03979          }
03980          break;
03981       case 2:
03982          newvar = ast_var_assign(varname, ast_var_value(current));
03983          if (newvar) {
03984             AST_LIST_INSERT_TAIL(&child->varshead, newvar, entries);
03985             ast_debug(1, "Copying hard-transferable variable %s.\n", ast_var_name(newvar));
03986          }
03987          break;
03988       default:
03989          ast_debug(1, "Not copying variable %s.\n", ast_var_name(current));
03990          break;
03991       }
03992    }
03993 }

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 3853 of file channel.c.

References ast_channel_make_compatible_helper(), and chanlist::chan.

Referenced by action_bridge(), app_exec(), ast_channel_bridge(), bridge_exec(), check_compat(), dial_exec_full(), do_forward(), park_exec_full(), try_calling(), and wait_for_answer().

03854 {
03855    /* Some callers do not check return code, and we must try to set all call legs correctly */
03856    int rc = 0;
03857 
03858    /* Set up translation from the chan to the peer */
03859    rc = ast_channel_make_compatible_helper(chan, peer);
03860 
03861    if (rc < 0)
03862       return rc;
03863 
03864    /* Set up translation from the peer to the chan */
03865    rc = ast_channel_make_compatible_helper(peer, chan);
03866 
03867    return rc;
03868 }

static int ast_channel_make_compatible_helper ( struct ast_channel from,
struct ast_channel to 
) [static]

Set up translation from one channel to another.

Definition at line 3812 of file channel.c.

References AST_FORMAT_AUDIO_MASK, 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(), LOG_WARNING, ast_channel::name, ast_channel::nativeformats, ast_channel::readformat, and ast_channel::writeformat.

Referenced by ast_channel_make_compatible().

03813 {
03814    int src;
03815    int dst;
03816 
03817    if (from->readformat == to->writeformat && from->writeformat == to->readformat) {
03818       /* Already compatible!  Moving on ... */
03819       return 0;
03820    }
03821 
03822    /* Set up translation from the 'from' channel to the 'to' channel */
03823    src = from->nativeformats;
03824    dst = to->nativeformats;
03825 
03826    /* If there's no audio in this call, don't bother with trying to find a translation path */
03827    if ((src & AST_FORMAT_AUDIO_MASK) == 0 || (dst & AST_FORMAT_AUDIO_MASK) == 0)
03828       return 0;
03829 
03830    if (ast_translator_best_choice(&dst, &src) < 0) {
03831       ast_log(LOG_WARNING, "No path to translate from %s(%d) to %s(%d)\n", from->name, src, to->name, dst);
03832       return -1;
03833    }
03834 
03835    /* if the best path is not 'pass through', then
03836       transcoding is needed; if desired, force transcode path
03837       to use SLINEAR between channels, but only if there is
03838       no direct conversion available */
03839    if ((src != dst) && ast_opt_transcode_via_slin &&
03840        (ast_translate_path_steps(dst, src) != 1))
03841       dst = AST_FORMAT_SLINEAR;
03842    if (ast_set_read_format(from, dst) < 0) {
03843       ast_log(LOG_WARNING, "Unable to set read format on channel %s to %d\n", from->name, dst);
03844       return -1;
03845    }
03846    if (ast_set_write_format(to, dst) < 0) {
03847       ast_log(LOG_WARNING, "Unable to set write format on channel %s to %d\n", to->name, dst);
03848       return -1;
03849    }
03850    return 0;
03851 }

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.

Note:
Neither channel passed here needs to be locked before calling this function.

Definition at line 3870 of file channel.c.

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

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

03871 {
03872    int res = -1;
03873    struct ast_channel *final_orig, *final_clone, *base;
03874 
03875 retrymasq:
03876    final_orig = original;
03877    final_clone = clonechan;
03878 
03879    ast_channel_lock(original);
03880    while (ast_channel_trylock(clonechan)) {
03881       ast_channel_unlock(original);
03882       usleep(1);
03883       ast_channel_lock(original);
03884    }
03885 
03886    /* each of these channels may be sitting behind a channel proxy (i.e. chan_agent)
03887       and if so, we don't really want to masquerade it, but its proxy */
03888    if (original->_bridge && (original->_bridge != ast_bridged_channel(original)) && (original->_bridge->_bridge != original))
03889       final_orig = original->_bridge;
03890 
03891    if (clonechan->_bridge && (clonechan->_bridge != ast_bridged_channel(clonechan)) && (clonechan->_bridge->_bridge != clonechan))
03892       final_clone = clonechan->_bridge;
03893    
03894    if (final_clone->tech->get_base_channel && (base = final_clone->tech->get_base_channel(final_clone))) {
03895       final_clone = base;
03896    }
03897 
03898    if ((final_orig != original) || (final_clone != clonechan)) {
03899       /* Lots and lots of deadlock avoidance.  The main one we're competing with
03900        * is ast_write(), which locks channels recursively, when working with a
03901        * proxy channel. */
03902       if (ast_channel_trylock(final_orig)) {
03903          ast_channel_unlock(clonechan);
03904          ast_channel_unlock(original);
03905          goto retrymasq;
03906       }
03907       if (ast_channel_trylock(final_clone)) {
03908          ast_channel_unlock(final_orig);
03909          ast_channel_unlock(clonechan);
03910          ast_channel_unlock(original);
03911          goto retrymasq;
03912       }
03913       ast_channel_unlock(clonechan);
03914       ast_channel_unlock(original);
03915       original = final_orig;
03916       clonechan = final_clone;
03917    }
03918 
03919    if (original == clonechan) {
03920       ast_log(LOG_WARNING, "Can't masquerade channel '%s' into itself!\n", original->name);
03921       ast_channel_unlock(clonechan);
03922       ast_channel_unlock(original);
03923       return -1;
03924    }
03925 
03926    ast_debug(1, "Planning to masquerade channel %s into the structure of %s\n",
03927       clonechan->name, original->name);
03928    if (original->masq) {
03929       ast_log(LOG_WARNING, "%s is already going to masquerade as %s\n",
03930          original->masq->name, original->name);
03931    } else if (clonechan->masqr) {
03932       ast_log(LOG_WARNING, "%s is already going to masquerade as %s\n",
03933          clonechan->name, clonechan->masqr->name);
03934    } else {
03935       original->masq = clonechan;
03936       clonechan->masqr = original;
03937       ast_queue_frame(original, &ast_null_frame);
03938       ast_queue_frame(clonechan, &ast_null_frame);
03939       ast_debug(1, "Done planning to masquerade channel %s into the structure of %s\n", clonechan->name, original->name);
03940       res = 0;
03941    }
03942 
03943    ast_channel_unlock(clonechan);
03944    ast_channel_unlock(original);
03945 
03946    return res;
03947 }

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

Query the value of an option Works similarly to setoption except only reads the options.

Definition at line 4939 of file channel.c.

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

Referenced by ast_channel_get_t38_state().

04940 {
04941    if (!chan->tech->queryoption) {
04942       errno = ENOSYS;
04943       return -1;
04944    }
04945 
04946    if (block)
04947       ast_log(LOG_ERROR, "XXX Blocking not implemented yet XXX\n");
04948 
04949    return chan->tech->queryoption(chan, option, data, datalen);
04950 }

const 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 3491 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().

03492 {
03493    switch (reason) /* the following appear to be the only ones actually returned by request_and_dial */
03494    {
03495    case 0:
03496       return "Call Failure (not BUSY, and not NO_ANSWER, maybe Circuit busy or down?)";
03497    case AST_CONTROL_HANGUP:
03498       return "Hangup";
03499    case AST_CONTROL_RING:
03500       return "Local Ring";
03501    case AST_CONTROL_RINGING:
03502       return "Remote end Ringing";
03503    case AST_CONTROL_ANSWER:
03504       return "Remote end has Answered";
03505    case AST_CONTROL_BUSY:
03506       return "Remote end is Busy";
03507    case AST_CONTROL_CONGESTION:
03508       return "Congestion (circuits busy)";
03509    default:
03510       return "Unknown Reason!!";
03511    }
03512 }

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 557 of file channel.c.

References ast_calloc, ast_debug, AST_LIST_INSERT_HEAD, AST_LIST_TRAVERSE, ast_log(), AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verb, chanlist::chan, chanlist::list, LOG_WARNING, chanlist::tech, ast_channel::tech, and ast_channel_tech::type.

Referenced by load_module(), and unload_module().

00558 {
00559    struct chanlist *chan;
00560 
00561    AST_RWLIST_WRLOCK(&channels);
00562 
00563    AST_LIST_TRAVERSE(&backends, chan, list) {
00564       if (!strcasecmp(tech->type, chan->tech->type)) {
00565          ast_log(LOG_WARNING, "Already have a handler for type '%s'\n", tech->type);
00566          AST_RWLIST_UNLOCK(&channels);
00567          return -1;
00568       }
00569    }
00570    
00571    if (!(chan = ast_calloc(1, sizeof(*chan)))) {
00572       AST_RWLIST_UNLOCK(&channels);
00573       return -1;
00574    }
00575    chan->tech = tech;
00576    AST_LIST_INSERT_HEAD(&backends, chan, list);
00577 
00578    ast_debug(1, "Registered handler for '%s' (%s)\n", chan->tech->type, chan->tech->description);
00579 
00580    ast_verb(2, "Registered channel type '%s' (%s)\n", chan->tech->type, chan->tech->description);
00581 
00582    AST_RWLIST_UNLOCK(&channels);
00583    return 0;
00584 }

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 3799 of file channel.c.

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

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

03800 {
03801    if (chan->tech->send_html)
03802       return chan->tech->send_html(chan, subclass, data, datalen);
03803    return -1;
03804 }

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 3806 of file channel.c.

References ast_channel_sendhtml(), AST_HTML_URL, and chanlist::chan.

Referenced by dial_exec_full(), sendurl_exec(), and try_calling().

03807 {
03808    return ast_channel_sendhtml(chan, AST_HTML_URL, url, strlen(url) + 1);
03809 }

void ast_channel_set_fd ( struct ast_channel chan,
int  which,
int  fd 
)

Set the file descriptor on the channel

Definition at line 1470 of file channel.c.

References ast_calloc, chanlist::chan, ast_channel::data, ast_channel::fds, and free.

Referenced by __oh323_new(), __oh323_rtp_create(), __oh323_update_info(), alsa_new(), ast_channel_alloc(), ast_deactivate_generator(), ast_do_masquerade(), dahdi_new(), gtalk_new(), jingle_new(), mgcp_new(), misdn_new(), nbs_new(), oss_new(), phone_new(), pri_assign_bearer(), pri_fixup_principle(), setformat(), sip_new(), skinny_new(), start_rtp(), and swap_subs().

01471 {
01472 #ifdef HAVE_EPOLL
01473    struct epoll_event ev;
01474    struct ast_epoll_data *aed = NULL;
01475 
01476    if (chan->fds[which] > -1) {
01477       epoll_ctl(chan->epfd, EPOLL_CTL_DEL, chan->fds[which], &ev);
01478       aed = chan->epfd_data[which];
01479    }
01480 
01481    /* If this new fd is valid, add it to the epoll */
01482    if (fd > -1) {
01483       if (!aed && (!(aed = ast_calloc(1, sizeof(*aed)))))
01484          return;
01485       
01486       chan->epfd_data[which] = aed;
01487       aed->chan = chan;
01488       aed->which = which;
01489       
01490       ev.events = EPOLLIN | EPOLLPRI | EPOLLERR | EPOLLHUP;
01491       ev.data.ptr = aed;
01492       epoll_ctl(chan->epfd, EPOLL_CTL_ADD, fd, &ev);
01493    } else if (aed) {
01494       /* We don't have to keep around this epoll data structure now */
01495       free(aed);
01496       chan->epfd_data[which] = NULL;
01497    }
01498 #endif
01499    chan->fds[which] = fd;
01500    return;
01501 }

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 4926 of file channel.c.

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

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

04927 {
04928    if (!chan->tech->setoption) {
04929       errno = ENOSYS;
04930       return -1;
04931    }
04932 
04933    if (block)
04934       ast_log(LOG_ERROR, "XXX Blocking not implemented yet XXX\n");
04935 
04936    return chan->tech->setoption(chan, option, data, datalen);
04937 }

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 relative to the current time of when to hang up
This function sets the absolute time out on a channel (when to hang up).

Note:
This function does not require that the channel is locked before calling it.
Returns:
Nothing
See also:
ast_channel_setwhentohangup_tv()
Version:
1.6.1 deprecated function (only had seconds precision)

Definition at line 528 of file channel.c.

References ast_channel_setwhentohangup_tv(), and chanlist::chan.

00529 {
00530    struct timeval when = { offset, };
00531    ast_channel_setwhentohangup_tv(chan, when);
00532 }

void ast_channel_setwhentohangup_tv ( struct ast_channel chan,
struct timeval  offset 
)

Set when to hang a channel up.

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

Note:
This function does not require that the channel is locked before calling it.
Returns:
Nothing
Since:
1.6.1

Definition at line 521 of file channel.c.

References ast_null_frame, ast_queue_frame(), ast_tvadd(), ast_tvnow(), ast_tvzero(), chanlist::chan, and ast_channel::whentohangup.

Referenced by action_timeout(), ast_channel_setwhentohangup(), handle_autohangup(), and timeout_write().

00522 {
00523    chan->whentohangup = ast_tvzero(offset) ? offset : ast_tvadd(offset, ast_tvnow());
00524    ast_queue_frame(chan, &ast_null_frame);
00525    return;
00526 }

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 5259 of file channel.c.

References ast_activate_generator(), ast_calloc, ast_debug, AST_FORMAT_SLINEAR, ast_free, ast_log(), ast_set_write_format(), chan, LOG_ERROR, ast_channel::name, ast_silence_generator::old_write_format, silence_generator, and ast_channel::writeformat.

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

05260 {
05261    struct ast_silence_generator *state;
05262 
05263    if (!(state = ast_calloc(1, sizeof(*state)))) {
05264       return NULL;
05265    }
05266 
05267    state->old_write_format = chan->writeformat;
05268 
05269    if (ast_set_write_format(chan, AST_FORMAT_SLINEAR) < 0) {
05270       ast_log(LOG_ERROR, "Could not set write format to SLINEAR\n");
05271       ast_free(state);
05272       return NULL;
05273    }
05274 
05275    ast_activate_generator(chan, &silence_generator, state);
05276 
05277    ast_debug(1, "Started silence generator on '%s'\n", chan->name);
05278 
05279    return state;
05280 }

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 5282 of file channel.c.

References ast_deactivate_generator(), ast_debug, ast_free, ast_log(), ast_set_write_format(), chan, LOG_ERROR, ast_channel::name, and ast_silence_generator::old_write_format.

Referenced by __ast_play_and_record(), ast_dtmf_stream(), channel_spy(), HandleCallOutgoing(), key_dial_page(), and unistim_hangup().

05283 {
05284    if (!state)
05285       return;
05286 
05287    ast_deactivate_generator(chan);
05288 
05289    ast_debug(1, "Stopped silence generator on '%s'\n", chan->name);
05290 
05291    if (ast_set_write_format(chan, state->old_write_format) < 0)
05292       ast_log(LOG_ERROR, "Could not return write format to its original state\n");
05293 
05294    ast_free(state);
05295 }

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 3794 of file channel.c.

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

Referenced by dial_exec_full(), sendurl_exec(), and try_calling().

03795 {
03796    return (chan->tech->send_html) ? 1 : 0;
03797 }

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 1098 of file channel.c.

References ast_clear_flag, AST_FLAG_DEFER_DTMF, and chanlist::chan.

Referenced by find_cache(), and rpt_call().

01099 {
01100    if (chan)
01101       ast_clear_flag(chan, AST_FLAG_DEFER_DTMF);
01102 }

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 587 of file channel.c.

References ast_debug, ast_free, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verb, chanlist::chan, chanlist::list, chanlist::tech, ast_channel::tech, and ast_channel_tech::type.

Referenced by __unload_module(), load_module(), and unload_module().

00588 {
00589    struct chanlist *chan;
00590 
00591    ast_debug(1, "Unregistering channel type '%s'\n", tech->type);
00592 
00593    AST_RWLIST_WRLOCK(&channels);
00594 
00595    AST_LIST_TRAVERSE_SAFE_BEGIN(&backends, chan, list) {
00596       if (chan->tech == tech) {
00597          AST_LIST_REMOVE_CURRENT(list);
00598          ast_free(chan);
00599          ast_verb(2, "Unregistered channel type '%s'\n", tech->type);
00600          break;   
00601       }
00602    }
00603    AST_LIST_TRAVERSE_SAFE_END;
00604 
00605    AST_RWLIST_UNLOCK(&channels);
00606 }

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 1212 of file channel.c.

References channel_find_locked().

Referenced by action_coreshowchannels(), action_status(), ast_complete_channels(), ast_pickup_call(), conf_exec(), func_channels_read(), handle_chanlist(), handle_core_set_debug_channel(), next_channel(), pickup_by_exten(), and pickup_by_mark().

01213 {
01214    return channel_find_locked(prev, NULL, 0, NULL, NULL);
01215 }

void ast_channels_init ( void   ) 

Provided by channel.c

Definition at line 5180 of file channel.c.

References ARRAY_LEN, ast_cli_register_multiple(), and cli_channel.

Referenced by main().

05181 {
05182    ast_cli_register_multiple(cli_channel, ARRAY_LEN(cli_channel));
05183 }

struct ast_variable* ast_channeltype_list ( void   ) 

return an ast_variable list of channeltypes

Definition at line 185 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.

00186 {
00187    struct chanlist *cl;
00188    struct ast_variable *var=NULL, *prev = NULL;
00189    AST_LIST_TRAVERSE(&backends, cl, list) {
00190       if (prev)  {
00191          if ((prev->next = ast_variable_new(cl->tech->type, cl->tech->description, "")))
00192             prev = prev->next;
00193       } else {
00194          var = ast_variable_new(cl->tech->type, cl->tech->description, "");
00195          prev = var;
00196       }
00197    }
00198    return var;
00199 }

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 461 of file channel.c.

References ast_channel::_softhangup, AST_SOFTHANGUP_TIMEOUT, ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), chanlist::chan, and ast_channel::whentohangup.

Referenced by __ast_pbx_run(), __ast_read(), _macro_exec(), action_redirect(), agent_indicate(), agi_exec(), agi_handle_command(), announce_thread(), ast_bridge_call(), ast_bridge_call_thread(), ast_call(), ast_channel_bridge(), ast_check_hangup_locked(), ast_feature_request_and_dial(), ast_indicate_data(), ast_raw_answer(), ast_readstring_full(), ast_recvtext(), ast_rtp_bridge(), ast_sendtext(), ast_transfer(), ast_udptl_bridge(), ast_waitfordigit_full(), ast_write(), autoservice_run(), bridge_exec(), bridge_native_loop(), builtin_atxfer(), channel_spy(), check_bridge(), common_exec(), conf_play(), conf_run(), dahdi_sendtext(), dahdi_setoption(), dial_exec_full(), dundi_lookup_internal(), eagi_exec(), eivr_comm(), handle_sendimage(), launch_asyncagi(), lua_check_hangup(), ospfinished_exec(), pbx_builtin_incomplete(), pbx_exec(), read_exec(), readexten_exec(), rpt(), run_ras(), and try_calling().

00462 {
00463    if (chan->_softhangup)     /* yes if soft hangup flag set */
00464       return 1;
00465    if (ast_tvzero(chan->whentohangup)) /* no if no hangup scheduled */
00466       return 0;
00467    if (ast_tvdiff_ms(chan->whentohangup, ast_tvnow()) > 0)  /* no if hangup time has not come yet. */
00468       return 0;
00469    chan->_softhangup |= AST_SOFTHANGUP_TIMEOUT; /* record event */
00470    return 1;
00471 }

static int ast_check_hangup_locked ( struct ast_channel chan  )  [static]

Definition at line 473 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_check_hangup(), and chanlist::chan.

Referenced by ast_channel_bridge().

00474 {
00475    int res;
00476    ast_channel_lock(chan);
00477    res = ast_check_hangup(chan);
00478    ast_channel_unlock(chan);
00479    return res;
00480 }

void ast_deactivate_generator ( struct ast_channel chan  ) 

Deactivate an active generator

Definition at line 1838 of file channel.c.

References ast_channel_lock, ast_channel_set_fd(), ast_channel_unlock, ast_clear_flag, AST_FLAG_WRITE_INT, AST_GENERATOR_FD, ast_settimeout(), chanlist::chan, 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(), dial_exec_full(), generator_force(), local_ast_moh_stop(), old_milliwatt_exec(), transmit_audio(), and wait_for_answer().

01839 {
01840    ast_channel_lock(chan);
01841    if (chan->generatordata) {
01842       if (chan->generator && chan->generator->release)
01843          chan->generator->release(chan, chan->generatordata);
01844       chan->generatordata = NULL;
01845       chan->generator = NULL;
01846       ast_channel_set_fd(chan, AST_GENERATOR_FD, -1);
01847       ast_clear_flag(chan, AST_FLAG_WRITE_INT);
01848       ast_settimeout(chan, 0, NULL, NULL);
01849    }
01850    ast_channel_unlock(chan);
01851 }

int ast_do_masquerade ( struct ast_channel original  ) 

Start masquerading a channel XXX This is a seriously whacked 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 4026 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_NAME, ast_channel_set_fd(), ast_channel_unlock, ast_copy_string(), ast_debug, 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_state2str(), 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, EVENT_FLAG_CALL, 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_dont_use, LOG_WARNING, manager_event, ast_channel::masq, ast_channel::masqr, ast_channel::monitor, musicclass, ast_channel::name, name, ast_channel::nativeformats, ast_channel::rawreadformat, ast_channel::rawwriteformat, ast_channel::readformat, ast_channel::readq, 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(), do_bridge_masquerade(), iax_park(), sip_park(), and sip_park_thread().

04027 {
04028    int x,i;
04029    int res=0;
04030    int origstate;
04031    struct ast_frame *current;
04032    const struct ast_channel_tech *t;
04033    void *t_pvt;
04034    struct ast_callerid tmpcid;
04035    struct ast_channel *clonechan = original->masq;
04036    struct ast_cdr *cdr;
04037    int rformat = original->readformat;
04038    int wformat = original->writeformat;
04039    char newn[AST_CHANNEL_NAME];
04040    char orig[AST_CHANNEL_NAME];
04041    char masqn[AST_CHANNEL_NAME];
04042    char zombn[AST_CHANNEL_NAME];
04043 
04044    ast_debug(4, "Actually Masquerading %s(%d) into the structure of %s(%d)\n",
04045       clonechan->name, clonechan->_state, original->name, original->_state);
04046 
04047    manager_event(EVENT_FLAG_CALL, "Masquerade", "Clone: %s\r\nCloneState: %s\r\nOriginal: %s\r\nOriginalState: %s\r\n",
04048             clonechan->name, ast_state2str(clonechan->_state), original->name, ast_state2str(original->_state));
04049 
04050    /* XXX This is a seriously wacked out operation.  We're essentially putting the guts of
04051       the clone channel into the original channel.  Start by killing off the original
04052       channel's backend.   I'm not sure we're going to keep this function, because
04053       while the features are nice, the cost is very high in terms of pure nastiness. XXX */
04054 
04055    /* We need the clone's lock, too */
04056    ast_channel_lock(clonechan);
04057 
04058    ast_debug(2, "Got clone lock for masquerade on '%s' at %p\n", clonechan->name, &clonechan->lock_dont_use);
04059 
04060    /* Having remembered the original read/write formats, we turn off any translation on either
04061       one */
04062    free_translation(clonechan);
04063    free_translation(original);
04064 
04065 
04066    /* Unlink the masquerade */
04067    original->masq = NULL;
04068    clonechan->masqr = NULL;
04069    
04070    /* Save the original name */
04071    ast_copy_string(orig, original->name, sizeof(orig));
04072    /* Save the new name */
04073    ast_copy_string(newn, clonechan->name, sizeof(newn));
04074    /* Create the masq name */
04075    snprintf(masqn, sizeof(masqn), "%s<MASQ>", newn);
04076       
04077    /* Copy the name from the clone channel */
04078    ast_string_field_set(original, name, newn);
04079 
04080    /* Mangle the name of the clone channel */
04081    ast_string_field_set(clonechan, name, masqn);
04082    
04083    /* Notify any managers of the change, first the masq then the other */
04084    manager_event(EVENT_FLAG_CALL, "Rename", "Channel: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", newn, masqn, clonechan->uniqueid);
04085    manager_event(EVENT_FLAG_CALL, "Rename", "Channel: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", orig, newn, original->uniqueid);
04086 
04087    /* Swap the technologies */   
04088    t = original->tech;
04089    original->tech = clonechan->tech;
04090    clonechan->tech = t;
04091 
04092    /* Swap the cdrs */
04093    cdr = original->cdr;
04094    original->cdr = clonechan->cdr;
04095    clonechan->cdr = cdr;
04096 
04097    t_pvt = original->tech_pvt;
04098    original->tech_pvt = clonechan->tech_pvt;
04099    clonechan->tech_pvt = t_pvt;
04100 
04101    /* Swap the alertpipes */
04102    for (i = 0; i < 2; i++) {
04103       x = original->alertpipe[i];
04104       original->alertpipe[i] = clonechan->alertpipe[i];
04105       clonechan->alertpipe[i] = x;
04106    }
04107 
04108    /* 
04109     * Swap the readq's.  The end result should be this:
04110     *
04111     *  1) All frames should be on the new (original) channel.
04112     *  2) Any frames that were already on the new channel before this
04113     *     masquerade need to be at the end of the readq, after all of the
04114     *     frames on the old (clone) channel.
04115     *  3) The alertpipe needs to get poked for every frame that was already
04116     *     on the new channel, since we are now using the alert pipe from the
04117     *     old (clone) channel.
04118     */
04119    {
04120       AST_LIST_HEAD_NOLOCK(, ast_frame) tmp_readq;
04121       AST_LIST_HEAD_SET_NOLOCK(&tmp_readq, NULL);
04122 
04123       AST_LIST_APPEND_LIST(&tmp_readq, &original->readq, frame_list);
04124       AST_LIST_APPEND_LIST(&original->readq, &clonechan->readq, frame_list);
04125 
04126       while ((current = AST_LIST_REMOVE_HEAD(&tmp_readq, frame_list))) {
04127          AST_LIST_INSERT_TAIL(&original->readq, current, frame_list);
04128          if (original->alertpipe[1] > -1) {
04129             int poke = 0;
04130 
04131             if (write(original->alertpipe[1], &poke, sizeof(poke)) < 0) {
04132                ast_log(LOG_WARNING, "write() failed: %s\n", strerror(errno));
04133             }
04134          }
04135       }
04136    }
04137 
04138    /* Swap the raw formats */
04139    x = original->rawreadformat;
04140    original->rawreadformat = clonechan->rawreadformat;
04141    clonechan->rawreadformat = x;
04142    x = original->rawwriteformat;
04143    original->rawwriteformat = clonechan->rawwriteformat;
04144    clonechan->rawwriteformat = x;
04145 
04146    clonechan->_softhangup = AST_SOFTHANGUP_DEV;
04147 
04148    /* And of course, so does our current state.  Note we need not
04149       call ast_setstate since the event manager doesn't really consider
04150       these separate.  We do this early so that the clone has the proper
04151       state of the original channel. */
04152    origstate = original->_state;
04153    original->_state = clonechan->_state;
04154    clonechan->_state = origstate;
04155 
04156    if (clonechan->tech->fixup){
04157       res = clonechan->tech->fixup(original, clonechan);
04158       if (res)
04159          ast_log(LOG_WARNING, "Fixup failed on channel %s, strange things may happen.\n", clonechan->name);
04160    }
04161 
04162    /* Start by disconnecting the original's physical side */
04163    if (clonechan->tech->hangup)
04164       res = clonechan->tech->hangup(clonechan);
04165    if (res) {
04166       ast_log(LOG_WARNING, "Hangup failed!  Strange things may happen!\n");
04167       ast_channel_unlock(clonechan);
04168       return -1;
04169    }
04170 
04171    snprintf(zombn, sizeof(zombn), "%s<ZOMBIE>", orig);
04172    /* Mangle the name of the clone channel */
04173    ast_string_field_set(clonechan, name, zombn);
04174    manager_event(EVENT_FLAG_CALL, "Rename", "Channel: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", masqn, zombn, clonechan->uniqueid);
04175 
04176    /* Update the type. */
04177    t_pvt = original->monitor;
04178    original->monitor = clonechan->monitor;
04179    clonechan->monitor = t_pvt;
04180 
04181    /* Keep the same language.  */
04182    ast_string_field_set(original, language, clonechan->language);
04183    /* Copy the FD's other than the generator fd */
04184    for (x = 0; x < AST_MAX_FDS; x++) {
04185       if (x != AST_GENERATOR_FD)
04186          ast_channel_set_fd(original, x, clonechan->fds[x]);
04187    }
04188 
04189    ast_app_group_update(clonechan, original);
04190 
04191    /* Move data stores over */
04192    if (AST_LIST_FIRST(&clonechan->datastores)) {
04193       struct ast_datastore *ds;
04194       AST_LIST_TRAVERSE(&clonechan->datastores, ds, entry) {
04195          if (ds->info->chan_fixup)
04196             ds->info->chan_fixup(ds->data, clonechan, original);
04197       }
04198       AST_LIST_APPEND_LIST(&original->datastores, &clonechan->datastores, entry);
04199    }
04200 
04201    clone_variables(original, clonechan);
04202    /* Presense of ADSI capable CPE follows clone */
04203    original->adsicpe = clonechan->adsicpe;
04204    /* Bridge remains the same */
04205    /* CDR fields remain the same */
04206    /* XXX What about blocking, softhangup, blocker, and lock and blockproc? XXX */
04207    /* Application and data remain the same */
04208    /* Clone exception  becomes real one, as with fdno */
04209    ast_set_flag(original, ast_test_flag(clonechan, AST_FLAG_OUTGOING | AST_FLAG_EXCEPTION));
04210    original->fdno = clonechan->fdno;
04211    /* Schedule context remains the same */
04212    /* Stream stuff stays the same */
04213    /* Keep the original state.  The fixup code will need to work with it most likely */
04214 
04215    /* Just swap the whole structures, nevermind the allocations, they'll work themselves
04216       out. */
04217    tmpcid = original->cid;
04218    original->cid = clonechan->cid;
04219    clonechan->cid = tmpcid;
04220 
04221    /* Restore original timing file descriptor */
04222    ast_channel_set_fd(original, AST_TIMING_FD, original->timingfd);
04223 
04224    /* Our native formats are different now */
04225    original->nativeformats = clonechan->nativeformats;
04226 
04227    /* Context, extension, priority, app data, jump table,  remain the same */
04228    /* pvt switches.  pbx stays the same, as does next */
04229 
04230    /* Set the write format */
04231    ast_set_write_format(original, wformat);
04232 
04233    /* Set the read format */
04234    ast_set_read_format(original, rformat);
04235 
04236    /* Copy the music class */
04237    ast_string_field_set(original, musicclass, clonechan->musicclass);
04238 
04239    ast_debug(1, "Putting channel %s in %d/%d formats\n", original->name, wformat, rformat);
04240 
04241    /* Okay.  Last thing is to let the channel driver know about all this mess, so he
04242       can fix up everything as best as possible */
04243    if (original->tech->fixup) {
04244       res = original->tech->fixup(clonechan, original);
04245       if (res) {
04246          ast_log(LOG_WARNING, "Channel for type '%s' could not fixup channel %s\n",
04247             original->tech->type, original->name);
04248          ast_channel_unlock(clonechan);
04249          return -1;
04250       }
04251    } else
04252       ast_log(LOG_WARNING, "Channel type '%s' does not have a fixup routine (for %s)!  Bad things may happen.\n",
04253          original->tech->type, original->name);
04254 
04255    /* 
04256     * If an indication is currently playing, maintain it on the channel 
04257     * that is taking the place of original 
04258     *
04259     * This is needed because the masquerade is swapping out in the internals
04260     * of this channel, and the new channel private data needs to be made
04261     * aware of the current visible indication (RINGING, CONGESTION, etc.)
04262     */
04263    if (original->visible_indication) {
04264       ast_indicate(original, original->visible_indication);
04265    }
04266    
04267    /* Now, at this point, the "clone" channel is totally F'd up.  We mark it as
04268       a zombie so nothing tries to touch it.  If it's already been marked as a
04269       zombie, then free it now (since it already is considered invalid). */
04270    if (ast_test_flag(clonechan, AST_FLAG_ZOMBIE)) {
04271       ast_debug(1, "Destroying channel clone '%s'\n", clonechan->name);
04272       ast_channel_unlock(clonechan);
04273       manager_event(EVENT_FLAG_CALL, "Hangup",
04274          "Channel: %s\r\n"
04275          "Uniqueid: %s\r\n"
04276          "Cause: %d\r\n"
04277          "Cause-txt: %s\r\n",
04278          clonechan->name,
04279          clonechan->uniqueid,
04280          clonechan->hangupcause,
04281          ast_cause2str(clonechan->hangupcause)
04282          );
04283       ast_channel_free(clonechan);
04284    } else {
04285       ast_debug(1, "Released clone lock on '%s'\n", clonechan->name);
04286       ast_set_flag(clonechan, AST_FLAG_ZOMBIE);
04287       ast_queue_frame(clonechan, &ast_null_frame);
04288       ast_channel_unlock(clonechan);
04289    }
04290 
04291    /* Signal any blocker */
04292    if (ast_test_flag(original, AST_FLAG_BLOCKING))
04293       pthread_kill(original->blocker, SIGURG);
04294    ast_debug(1, "Done Masquerading %s (%d)\n", original->name, original->_state);
04295    return 0;
04296 }

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 4415 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_poll_channel_add(), ast_set_flag, ast_tvdiff_ms(), ast_tvnow(), config, f, ast_channel::nativeformats, and ast_channel::tech_pvt.

Referenced by ast_channel_bridge().

04418 {
04419    /* Copy voice back and forth between the two channels. */
04420    struct ast_channel *cs[3];
04421    struct ast_frame *f;
04422    enum ast_bridge_result res = AST_BRIDGE_COMPLETE;
04423    int o0nativeformats;
04424    int o1nativeformats;
04425    int watch_c0_dtmf;
04426    int watch_c1_dtmf;
04427    void *pvt0, *pvt1;
04428    /* Indicates whether a frame was queued into a jitterbuffer */
04429    int frame_put_in_jb = 0;
04430    int jb_in_use;
04431    int to;
04432    
04433    cs[0] = c0;
04434    cs[1] = c1;
04435    pvt0 = c0->tech_pvt;
04436    pvt1 = c1->tech_pvt;
04437    o0nativeformats = c0->nativeformats;
04438    o1nativeformats = c1->nativeformats;
04439    watch_c0_dtmf = config->flags & AST_BRIDGE_DTMF_CHANNEL_0;
04440    watch_c1_dtmf = config->flags & AST_BRIDGE_DTMF_CHANNEL_1;
04441 
04442    /* Check the need of a jitterbuffer for each channel */
04443    jb_in_use = ast_jb_do_usecheck(c0, c1);
04444    if (jb_in_use)
04445       ast_jb_empty_and_reset(c0, c1);
04446 
04447    ast_poll_channel_add(c0, c1);
04448 
04449    for (;;) {
04450       struct ast_channel *who, *other;
04451 
04452       if ((c0->tech_pvt != pvt0) || (c1->tech_pvt != pvt1) ||
04453           (o0nativeformats != c0->nativeformats) ||
04454           (o1nativeformats != c1->nativeformats)) {
04455          /* Check for Masquerade, codec changes, etc */
04456          res = AST_BRIDGE_RETRY;
04457          break;
04458       }
04459       if (bridge_end.tv_sec) {
04460          to = ast_tvdiff_ms(bridge_end, ast_tvnow());
04461          if (to <= 0) {
04462             if (config->timelimit) {
04463                res = AST_BRIDGE_RETRY;
04464                /* generic bridge ending to play warning */
04465                ast_set_flag(config, AST_FEATURE_WARNING_ACTIVE);
04466             } else {
04467                res = AST_BRIDGE_COMPLETE;
04468             }
04469             break;
04470          }
04471       } else
04472          to = -1;
04473       /* Calculate the appropriate max sleep interval - in general, this is the time,
04474          left to the closest jb delivery moment */
04475       if (jb_in_use)
04476          to = ast_jb_get_when_to_wakeup(c0, c1, to);
04477       who = ast_waitfor_n(cs, 2, &to);
04478       if (!who) {
04479          /* No frame received within the specified timeout - check if we have to deliver now */
04480          if (jb_in_use)
04481             ast_jb_get_and_deliver(c0, c1);
04482          if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE || c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE) {
04483             if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
04484                c0->_softhangup = 0;
04485             if (c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE)
04486                c1->_softhangup = 0;
04487             c0->_bridge = c1;
04488             c1->_bridge = c0;
04489          }
04490          continue;
04491       }
04492       f = ast_read(who);
04493       if (!f) {
04494          *fo = NULL;
04495          *rc = who;
04496          ast_debug(1, "Didn't get a frame from channel: %s\n",who->name);
04497          break;
04498       }
04499 
04500       other = (who == c0) ? c1 : c0; /* the 'other' channel */
04501       /* Try add the frame info the who's bridged channel jitterbuff */
04502       if (jb_in_use)
04503          frame_put_in_jb = !ast_jb_put(other, f);
04504 
04505       if ((f->frametype == AST_FRAME_CONTROL) && !(config->flags & AST_BRIDGE_IGNORE_SIGS)) {
04506          int bridge_exit = 0;
04507 
04508          switch (f->subclass) {
04509          case AST_CONTROL_HOLD:
04510          case AST_CONTROL_UNHOLD:
04511          case AST_CONTROL_VIDUPDATE:
04512          case AST_CONTROL_SRCUPDATE:
04513          case AST_CONTROL_T38:
04514             ast_indicate_data(other, f->subclass, f->data.ptr, f->datalen);
04515             if (jb_in_use) {
04516                ast_jb_empty_and_reset(c0, c1);
04517             }
04518             break;
04519          default:
04520             *fo = f;
04521             *rc = who;
04522             bridge_exit = 1;
04523             ast_debug(1, "Got a FRAME_CONTROL (%d) frame on channel %s\n", f->subclass, who->name);
04524             break;
04525          }
04526          if (bridge_exit)
04527             break;
04528       }
04529       if ((f->frametype == AST_FRAME_VOICE) ||
04530           (f->frametype == AST_FRAME_DTMF_BEGIN) ||
04531           (f->frametype == AST_FRAME_DTMF) ||
04532           (f->frametype == AST_FRAME_VIDEO) ||
04533           (f->frametype == AST_FRAME_IMAGE) ||
04534           (f->frametype == AST_FRAME_HTML) ||
04535           (f->frametype == AST_FRAME_MODEM) ||
04536           (f->frametype == AST_FRAME_TEXT)) {
04537          /* monitored dtmf causes exit from bridge */
04538          int monitored_source = (who == c0) ? watch_c0_dtmf : watch_c1_dtmf;
04539 
04540          if (monitored_source && 
04541             (f->frametype == AST_FRAME_DTMF_END || 
04542             f->frametype == AST_FRAME_DTMF_BEGIN)) {
04543             *fo = f;
04544             *rc = who;
04545             ast_debug(1, "Got DTMF %s on channel (%s)\n", 
04546                f->frametype == AST_FRAME_DTMF_END ? "end" : "begin",
04547                who->name);
04548 
04549             break;
04550          }
04551          /* Write immediately frames, not passed through jb */
04552          if (!frame_put_in_jb)
04553             ast_write(other, f);
04554             
04555          /* Check if we have to deliver now */
04556          if (jb_in_use)
04557             ast_jb_get_and_deliver(c0, c1);
04558       }
04559       /* XXX do we want to pass on also frames not matched above ? */
04560       ast_frfree(f);
04561 
04562 #ifndef HAVE_EPOLL
04563       /* Swap who gets priority */
04564       cs[2] = cs[0];
04565       cs[0] = cs[1];
04566       cs[1] = cs[2];
04567 #endif
04568    }
04569 
04570    ast_poll_channel_del(c0, c1);
04571 
04572    return res;
04573 }

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 1237 of file channel.c.

References channel_find_locked().

01238 {
01239    return channel_find_locked(NULL, NULL, 0, context, exten);
01240 }

struct ast_channel* ast_get_channel_by_name_locked ( const char *  name  ) 

Get channel by name or uniqueid (locks channel).

Definition at line 1218 of file channel.c.

References channel_find_locked().

Referenced by acf_import(), action_add_agi_cmd(), action_atxfer(), action_getvar(), action_hangup(), action_redirect(), action_sendtext(), action_setvar(), action_status(), action_timeout(), ast_async_goto_by_name(), ast_bridge_call(), ast_park_call_full(), asyncgoto_exec(), change_monitor_action(), do_pause_or_unpause(), get_dahdi_channel_locked(), handle_channelstatus(), handle_cli_agi_add_cmd(), handle_core_set_debug_channel(), handle_getvariablefull(), handle_hangup(), handle_set_chanvar(), handle_show_chanvar(), handle_showchan(), handle_softhangup(), manager_park(), manager_play_dtmf(), pbx_builtin_importvar(), shared_read(), shared_write(), start_monitor_action(), and stop_monitor_action().

01219 {
01220    return channel_find_locked(NULL, name, 0, NULL, NULL);
01221 }

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

Get channel by name or uniqueid prefix (locks channel).

Definition at line 1224 of file channel.c.

References channel_find_locked().

Referenced by action_bridge(), ast_parse_device_state(), bridge_exec(), common_exec(), handle_cli_mixmonitor(), shared_read(), and shared_write().

01225 {
01226    return channel_find_locked(NULL, name, namelen, NULL, NULL);
01227 }

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 609 of file channel.c.

References AST_LIST_TRAVERSE, AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, chanlist::list, chanlist::tech, and ast_channel_tech::type.

Referenced by _ast_device_state().

00610 {
00611    struct chanlist *chanls;
00612    const struct ast_channel_tech *ret = NULL;
00613 
00614    AST_RWLIST_RDLOCK(&channels);
00615 
00616    AST_LIST_TRAVERSE(&backends, chanls, list) {
00617       if (!strcasecmp(name, chanls->tech->type)) {
00618          ret = chanls->tech;
00619          break;
00620       }
00621    }
00622 
00623    AST_RWLIST_UNLOCK(&channels);
00624    
00625    return ret;
00626 }

ast_group_t ast_get_group ( const char *  s  ) 

Definition at line 5104 of file channel.c.

References ast_log(), ast_strdupa, ast_strlen_zero(), LOG_ERROR, LOG_WARNING, and strsep().

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

05105 {
05106    char *piece;
05107    char *c;
05108    int start=0, finish=0, x;
05109    ast_group_t group = 0;
05110 
05111    if (ast_strlen_zero(s))
05112       return 0;
05113 
05114    c = ast_strdupa(s);
05115    
05116    while ((piece = strsep(&c, ","))) {
05117       if (sscanf(piece, "%d-%d", &start, &finish) == 2) {
05118          /* Range */
05119       } else if (sscanf(piece, "%d", &start)) {
05120          /* Just one */
05121          finish = start;
05122       } else {
05123          ast_log(LOG_ERROR, "Syntax error parsing group configuration '%s' at '%s'. Ignoring.\n", s, piece);
05124          continue;
05125       }
05126       for (x = start; x <= finish; x++) {
05127          if ((x > 63) || (x < 0)) {
05128             ast_log(LOG_WARNING, "Ignoring invalid group %d (maximum group is 63)\n", x);
05129          } else
05130             group |= ((ast_group_t) 1 << x);
05131       }
05132    }
05133    return group;
05134 }

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 1584 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_debug, 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, chanlist::chan, ast_channel::cid, ast_callerid::cid_name, ast_callerid::cid_num, ast_cdr::disposition, EVENT_FLAG_CALL, free_translation(), ast_channel::generator, ast_channel::generatordata, ast_channel_tech::hangup, ast_channel::hangupcause, LOG_WARNING, manager_event, ast_channel::masq, ast_channel::masqr, ast_channel::name, ast_generator::release, S_OR, 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(), action_bridge(), 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_channel(), bridge_exec(), build_conf(), builtin_atxfer(), chanavail_exec(), check_compat(), check_goto_on_transfer(), clear_caller(), conf_run(), connect_link(), console_new(), dahdi_handle_event(), dahdi_new(), dial_exec_full(), do_forward(), do_hang(), do_idle_thread(), findmeexec(), gtalk_new(), handle_call_forward(), handle_callforward_button(), 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(), handle_timeout_trip(), handle_transfer_button(), HandleCallOutgoing(), hangup_chan(), hangupcalls(), hanguptree(), iax2_request(), iax_park(), iax_park_thread(), jingle_new(), local_hangup(), manage_parkinglot(), masq_park_call(), mgcp_new(), mgcp_ss(), monitor_dial(), mwi_thread(), nbs_new(), oss_new(), park_exec_full(), 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(), unistim_new(), usbradio_new(), wait_for_answer(), and wait_for_winner().

01585 {
01586    int res = 0;
01587 
01588    /* Don't actually hang up a channel that will masquerade as someone else, or
01589       if someone is going to masquerade as us */
01590    ast_channel_lock(chan);
01591 
01592    if (chan->audiohooks) {
01593       ast_audiohook_detach_list(chan->audiohooks);
01594       chan->audiohooks = NULL;
01595    }
01596 
01597    ast_autoservice_stop(chan);
01598 
01599    if (chan->masq) {
01600       if (ast_do_masquerade(chan))
01601          ast_log(LOG_WARNING, "Failed to perform masquerade\n");
01602    }
01603 
01604    if (chan->masq) {
01605       ast_log(LOG_WARNING, "%s getting hung up, but someone is trying to masq into us?!?\n", chan->name);
01606       ast_channel_unlock(chan);
01607       return 0;
01608    }
01609    /* If this channel is one which will be masqueraded into something,
01610       mark it as a zombie already, so we know to free it later */
01611    if (chan->masqr) {
01612       ast_set_flag(chan, AST_FLAG_ZOMBIE);
01613       ast_channel_unlock(chan);
01614       return 0;
01615    }
01616    free_translation(chan);
01617    /* Close audio stream */
01618    if (chan->stream) {
01619       ast_closestream(chan->stream);
01620       chan->stream = NULL;
01621    }
01622    /* Close video stream */
01623    if (chan->vstream) {
01624       ast_closestream(chan->vstream);
01625       chan->vstream = NULL;
01626    }
01627    if (chan->sched) {
01628       sched_context_destroy(chan->sched);
01629       chan->sched = NULL;
01630    }
01631    
01632    if (chan->generatordata)   /* Clear any tone stuff remaining */
01633       if (chan->generator && chan->generator->release)
01634          chan->generator->release(chan, chan->generatordata);
01635    chan->generatordata = NULL;
01636    chan->generator = NULL;
01637    if (ast_test_flag(chan, AST_FLAG_BLOCKING)) {
01638       ast_log(LOG_WARNING, "Hard hangup called by thread %ld on %s, while fd "
01639                "is blocked by thread %ld in procedure %s!  Expect a failure\n",
01640                (long)pthread_self(), chan->name, (long)chan->blocker, chan->blockproc);
01641       ast_assert(ast_test_flag(chan, AST_FLAG_BLOCKING) == 0);
01642    }
01643    if (!ast_test_flag(chan, AST_FLAG_ZOMBIE)) {
01644       ast_debug(1, "Hanging up channel '%s'\n", chan->name);
01645       if (chan->tech->hangup)
01646          res = chan->tech->hangup(chan);
01647    } else {
01648       ast_debug(1, "Hanging up zombie '%s'\n", chan->name);
01649    }
01650          
01651    ast_channel_unlock(chan);
01652    manager_event(EVENT_FLAG_CALL, "Hangup",
01653          "Channel: %s\r\n"
01654          "Uniqueid: %s\r\n"
01655          "CallerIDNum: %s\r\n"
01656          "CallerIDName: %s\r\n"
01657          "Cause: %d\r\n"
01658          "Cause-txt: %s\r\n",
01659          chan->name,
01660          chan->uniqueid,
01661          S_OR(chan->cid.cid_num, "<unknown>"),
01662          S_OR(chan->cid.cid_name, "<unknown>"),
01663          chan->hangupcause,
01664          ast_cause2str(chan->hangupcause)
01665          );
01666 
01667    if (chan->cdr && !ast_test_flag(chan->cdr, AST_CDR_FLAG_BRIDGED) && 
01668       !ast_test_flag(chan->cdr, AST_CDR_FLAG_POST_DISABLED) && 
01669        (chan->cdr->disposition != AST_CDR_NULL || ast_test_flag(chan->cdr, AST_CDR_FLAG_DIALED))) {
01670          
01671       ast_cdr_end(chan->cdr);
01672       ast_cdr_detach(chan->cdr);
01673       chan->cdr = NULL;
01674    }
01675    
01676    ast_channel_free(chan);
01677 
01678    return res;
01679 }

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 2949 of file channel.c.

References ast_indicate_data(), and chanlist::chan.

Referenced by __ast_play_and_record(), agent_new(), alsa_call(), answer_trunk_chan(), ast_bridge_call(), ast_channel_bridge(), ast_do_masquerade(), ast_dtmf_stream(), ast_feature_request_and_dial(), ast_park_call_full(), ast_raw_answer(), attempt_transfer(), builtin_atxfer(), builtin_blindtransfer(), cli_console_answer(), conf_run(), console_call(), dial_exec_full(), do_forward(), finishup(), function_remote(), handle_callforward_button(), handle_frame(), handle_recordfile(), manage_parkinglot(), mgcp_ss(), monitor_dial(), oss_call(), park_exec_full(), pbx_builtin_busy(), pbx_builtin_congestion(), pbx_builtin_proceeding(), pbx_builtin_progress(), pbx_builtin_ringing(), pbx_builtin_waitexten(), queue_exec(), rpt(), rpt_exec(), say_periodic_announcement(), say_position(), send_waveform_to_channel(), skinny_ss(), sla_handle_hold_event(), sla_station_exec(), sla_trunk_exec(), try_calling(), and wait_for_answer().

02950 {
02951    return ast_indicate_data(chan, condition, NULL, 0);
02952 }

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_HOLD with payload being music on hold class
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 2988 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_T38, AST_CONTROL_TAKEOFFHOOK, AST_CONTROL_UNHOLD, AST_CONTROL_VIDUPDATE, AST_CONTROL_WINK, ast_debug, AST_FLAG_ZOMBIE, ast_get_indication_tone(), ast_log(), ast_playtones_start(), ast_playtones_stop(), ast_test_flag, chanlist::chan, tone_zone_sound::data, ast_channel_tech::indicate, is_visible_indication(), LOG_WARNING, ast_channel::name, ast_channel::tech, ast_channel::visible_indication, and ast_channel::zone.

Referenced by agent_hangup(), ast_bridge_call(), ast_indicate(), ast_park_call_full(), bridge_native_loop(), login_exec(), manage_parkinglot(), pbx_builtin_waitexten(), and transmit_audio().

02990 {
02991    /* By using an enum, we'll get compiler warnings for values not handled 
02992     * in switch statements. */
02993    enum ast_control_frame_type condition = _condition;
02994    const struct tone_zone_sound *ts = NULL;
02995    int res = -1;
02996 
02997    ast_channel_lock(chan);
02998 
02999    /* Don't bother if the channel is about to go away, anyway. */
03000    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) {
03001       ast_channel_unlock(chan);
03002       return -1;
03003    }
03004 
03005    if (chan->tech->indicate) {
03006       /* See if the channel driver can handle this condition. */
03007       res = chan->tech->indicate(chan, condition, data, datalen);
03008    }
03009 
03010    ast_channel_unlock(chan);
03011 
03012    if (chan->tech->indicate && !res) {
03013       /* The channel driver successfully handled this indication */
03014       if (is_visible_indication(condition)) {
03015          chan->visible_indication = condition;
03016       }
03017       return 0;
03018    }
03019 
03020    /* The channel driver does not support this indication, let's fake
03021     * it by doing our own tone generation if applicable. */
03022 
03023    /*!\note If we compare the enumeration type, which does not have any
03024     * negative constants, the compiler may optimize this code away.
03025     * Therefore, we must perform an integer comparison here. */
03026    if (_condition < 0) {
03027       /* Stop any tones that are playing */
03028       ast_playtones_stop(chan);
03029       return 0;
03030    }
03031 
03032    /* Handle conditions that we have tones for. */
03033    switch (condition) {
03034    case AST_CONTROL_RINGING:
03035       ts = ast_get_indication_tone(chan->zone, "ring");
03036       break;
03037    case AST_CONTROL_BUSY:
03038       ts = ast_get_indication_tone(chan->zone, "busy");
03039       break;
03040    case AST_CONTROL_CONGESTION:
03041       ts = ast_get_indication_tone(chan->zone, "congestion");
03042       break;
03043    case AST_CONTROL_PROGRESS:
03044    case AST_CONTROL_PROCEEDING:
03045    case AST_CONTROL_VIDUPDATE:
03046    case AST_CONTROL_SRCUPDATE:
03047    case AST_CONTROL_RADIO_KEY:
03048    case AST_CONTROL_RADIO_UNKEY:
03049    case AST_CONTROL_OPTION:
03050    case AST_CONTROL_WINK:
03051    case AST_CONTROL_FLASH:
03052    case AST_CONTROL_OFFHOOK:
03053    case AST_CONTROL_TAKEOFFHOOK:
03054    case AST_CONTROL_ANSWER:
03055    case AST_CONTROL_HANGUP:
03056    case AST_CONTROL_RING:
03057    case AST_CONTROL_HOLD:
03058    case AST_CONTROL_UNHOLD:
03059    case AST_CONTROL_T38:
03060       /* Nothing left to do for these. */
03061       res = 0;
03062       break;
03063    }
03064 
03065    if (ts && ts->data[0]) {
03066       /* We have a tone to play, yay. */
03067       ast_debug(1, "Driver for channel '%s' does not support indication %d, emulating it\n", chan->name, condition);
03068       ast_playtones_start(chan, 0, ts->data, 1);
03069       res = 0;
03070       chan->visible_indication = condition;
03071    }
03072 
03073    if (res) {
03074       /* not handled */
03075       ast_log(LOG_WARNING, "Unable to handle indication %d for '%s'\n", condition, chan->name);
03076    }
03077 
03078    return res;
03079 }

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 5140 of file channel.c.

References ast_moh_cleanup_ptr, ast_moh_start_ptr, and ast_moh_stop_ptr.

Referenced by load_module().

05143 {
05144    ast_moh_start_ptr = start_ptr;
05145    ast_moh_stop_ptr = stop_ptr;
05146    ast_moh_cleanup_ptr = cleanup_ptr;
05147 }

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 2932 of file channel.c.

References ast_debug, ast_opt_internal_timing, chanlist::chan, and ast_channel::timingfd.

Referenced by add_sdp(), and ast_read_generator_actions().

02933 {
02934    int ret = ast_opt_internal_timing && chan->timingfd > -1;
02935    ast_debug(5, "Internal timing is %s (option_internal_timing=%d chan->timingfd=%d)\n", ret? "enabled": "disabled", ast_opt_internal_timing, chan->timingfd);
02936    return ret;
02937 }

void ast_moh_cleanup ( struct ast_channel chan  ) 

Definition at line 5174 of file channel.c.

References ast_moh_cleanup_ptr, and chan.

Referenced by ast_channel_free().

05175 {
05176    if (ast_moh_cleanup_ptr)
05177       ast_moh_cleanup_ptr(chan);
05178 }

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:
Zero on success
non-zero on failure

Definition at line 5157 of file channel.c.

References ast_moh_start_ptr, ast_verb, and chan.

Referenced by alsa_indicate(), app_exec(), cb_events(), conf_start_moh(), console_indicate(), dahdi_indicate(), dial_exec_full(), feature_exec_app(), gtalk_indicate(), handle_setmusic(), iax2_indicate(), jingle_indicate(), key_call(), local_indicate(), mgcp_indicate(), misdn_indication(), moh_handle_digit(), monitor_dial(), oh323_indicate(), oss_indicate(), phone_indicate(), play_moh_exec(), queue_exec(), retrydial_exec(), say_periodic_announcement(), say_position(), sip_indicate(), skinny_indicate(), start_moh_exec(), TransferCallStep1(), unistim_indicate(), usbradio_indicate(), and wait_moh_exec().

05158 {
05159    if (ast_moh_start_ptr)
05160       return ast_moh_start_ptr(chan, mclass, interpclass);
05161 
05162    ast_verb(3, "Music class %s requested but no musiconhold loaded.\n", mclass ? mclass : (interpclass ? interpclass : "default"));
05163 
05164    return 0;
05165 }

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 5168 of file channel.c.

References ast_moh_stop_ptr, and chan.

Referenced by alsa_indicate(), app_exec(), ast_quiet_chan(), cb_events(), conf_run(), console_indicate(), dahdi_indicate(), dial_exec_full(), do_bridge_masquerade(), feature_exec_app(), gtalk_indicate(), handle_setmusic(), iax2_indicate(), jingle_indicate(), key_call(), key_dial_page(), local_indicate(), mgcp_indicate(), misdn_indication(), misdn_transfer_bc(), moh_handle_digit(), monitor_dial(), oh323_indicate(), oss_indicate(), phone_indicate(), play_moh_exec(), retrydial_exec(), say_periodic_announcement(), say_position(), sip_indicate(), skinny_indicate(), stop_moh_exec(), try_calling(), unistim_hangup(), unistim_indicate(), usbradio_indicate(), and wait_moh_exec().

05169 {
05170    if (ast_moh_stop_ptr)
05171       ast_moh_stop_ptr(chan);
05172 }

void ast_poll_channel_add ( struct ast_channel chan0,
struct ast_channel chan1 
)

Add a channel to an optimized waitfor

Definition at line 1504 of file channel.c.

References AST_MAX_FDS, and ast_channel::fds.

Referenced by ast_feature_request_and_dial(), ast_generic_bridge(), begin_dial_channel(), bridge_native_loop(), bridge_p2p_loop(), and wait_for_answer().

01505 {
01506 #ifdef HAVE_EPOLL
01507    struct epoll_event ev;
01508    int i = 0;
01509 
01510    if (chan0->epfd == -1)
01511       return;
01512 
01513    /* Iterate through the file descriptors on chan1, adding them to chan0 */
01514    for (i = 0; i < AST_MAX_FDS; i++) {
01515       if (chan1->fds[i] == -1)
01516          continue;
01517       ev.events = EPOLLIN | EPOLLPRI | EPOLLERR | EPOLLHUP;
01518       ev.data.ptr = chan1->epfd_data[i];
01519       epoll_ctl(chan0->epfd, EPOLL_CTL_ADD, chan1->fds[i], &ev);
01520    }
01521 
01522 #endif
01523    return;
01524 }

void ast_poll_channel_del ( struct ast_channel chan0,
struct ast_channel chan1 
)

Delete a channel from an optimized waitfor

Definition at line 1527 of file channel.c.

References AST_MAX_FDS, and ast_channel::fds.

Referenced by ast_feature_request_and_dial(), bridge_native_loop(), monitor_dial(), and wait_for_answer().

01528 {
01529 #ifdef HAVE_EPOLL
01530    struct epoll_event ev;
01531    int i = 0;
01532 
01533    if (chan0->epfd == -1)
01534       return;
01535 
01536    for (i = 0; i < AST_MAX_FDS; i++) {
01537       if (chan1->fds[i] == -1)
01538          continue;
01539       epoll_ctl(chan0->epfd, EPOLL_CTL_DEL, chan1->fds[i], &ev);
01540    }
01541 
01542 #endif
01543    return;
01544 }

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

print call- and pickup groups into buffer

Definition at line 5186 of file channel.c.

References first, and num.

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

05187 {
05188    unsigned int i;
05189    int first = 1;
05190    char num[3];
05191 
05192    buf[0] = '\0';
05193    
05194    if (!group) /* Return empty string if no group */
05195       return buf;
05196 
05197    for (i = 0; i <= 63; i++) {   /* Max group is 63 */
05198       if (group & ((ast_group_t) 1 << i)) {
05199             if (!first) {
05200             strncat(buf, ", ", buflen - strlen(buf) - 1);
05201          } else {
05202             first = 0;
05203          }
05204          snprintf(num, sizeof(num), "%u", i);
05205          strncat(buf, num, buflen - strlen(buf) - 1);
05206       }
05207    }
05208    return buf;
05209 }

int ast_prod ( struct ast_channel chan  ) 

Send empty audio to prime a channel driver.

Definition at line 3200 of file channel.c.

References ast_channel::_state, ast_debug, AST_FRAME_VOICE, AST_FRIENDLY_OFFSET, ast_log(), AST_STATE_UP, ast_write(), chanlist::chan, ast_frame::data, LOG_WARNING, ast_channel::name, ast_frame::ptr, ast_channel::rawwriteformat, ast_frame::src, and ast_frame::subclass.

Referenced by ast_activate_generator().

03201 {
03202    struct ast_frame a = { AST_FRAME_VOICE };
03203    char nothing[128];
03204 
03205    /* Send an empty audio frame to get things moving */
03206    if (chan->_state != AST_STATE_UP) {
03207       ast_debug(1, "Prodding channel '%s'\n", chan->name);
03208       a.subclass = chan->rawwriteformat;
03209       a.data.ptr = nothing + AST_FRIENDLY_OFFSET;
03210       a.src = "ast_prod";
03211       if (ast_write(chan, &a))
03212          ast_log(LOG_WARNING, "Prodding channel '%s' failed\n", chan->name);
03213    }
03214    return 0;
03215 }

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
Note:
The channel does not need to be locked before calling this function.
Return values:
zero on success
non-zero on failure

Definition at line 1063 of file channel.c.

References AST_FRAME_CONTROL, ast_queue_frame(), chanlist::chan, 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_refer(), handle_response(), handle_response_invite(), handle_response_refer(), handle_soft_key_event_message(), handle_stimulus_message(), HandleCallIncoming(), jingle_is_answered(), jingle_ringing_ack(), mgcp_call(), nbs_call(), phone_call(), pickup_do(), process_sdp(), receive_digit(), remote_hold(), send_cause2ast(), setup_rtp_connection(), skinny_call(), skinny_transfer(), skinny_unhold(), ss_thread(), unistim_call(), and update_state().

01064 {
01065    struct ast_frame f = { AST_FRAME_CONTROL, };
01066 
01067    f.subclass = control;
01068 
01069    return ast_queue_frame(chan, &f);
01070 }

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
Return values:
0 success
non-zero 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.

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

Definition at line 1073 of file channel.c.

References AST_FRAME_CONTROL, ast_queue_frame(), chanlist::chan, and f.

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

01075 {
01076    struct ast_frame f = { AST_FRAME_CONTROL, };
01077 
01078    f.subclass = control;
01079    f.data.ptr = (void *) data;
01080    f.datalen = datalen;
01081 
01082    return ast_queue_frame(chan, &f);
01083 }

int ast_queue_frame ( struct ast_channel chan,
struct ast_frame f 
)

Queue an outgoing frame.

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

Definition at line 1020 of file channel.c.

References __ast_queue_frame(), and chanlist::chan.

Referenced by __oh323_rtp_create(), __oh323_update_info(), action_atxfer(), agent_new(), alsa_call(), ast_channel_masquerade(), ast_channel_setwhentohangup_tv(), ast_do_masquerade(), ast_dsp_process(), ast_queue_control(), ast_queue_control_data(), ast_queue_hangup(), ast_queue_hangup_with_cause(), ast_softhangup_nolock(), cb_events(), cli_console_answer(), cli_console_dial(), cli_console_flash(), cli_console_sendtext(), console_answer(), console_call(), console_dial(), console_do_answer(), console_flash(), console_sendtext(), 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(), jingle_handle_dtmf(), keypad_digit(), local_queue_frame(), mgcp_queue_frame(), oh323_simulate_dtmf_end(), oss_call(), process_sdp(), queue_dtmf_readq(), receive_digit(), receive_message(), rpt_call(), stream_monitor(), unistim_do_senddigit(), unistim_senddigit_end(), usbradio_read(), and wakeup_sub().

01021 {
01022    return __ast_queue_frame(chan, fin, 0);
01023 }

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 1025 of file channel.c.

References __ast_queue_frame(), and chanlist::chan.

Referenced by __ast_answer(), and ast_autoservice_stop().

01026 {
01027    return __ast_queue_frame(chan, fin, 1);
01028 }

int ast_queue_hangup ( struct ast_channel chan  ) 

Queue a hangup frame.

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

Definition at line 1031 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, chanlist::chan, and f.

Referenced by cleanup_connection(), cli_console_hangup(), close_call(), gtalk_hangup_farend(), gtalk_is_answered(), handle_onhook_message(), handle_request_bye(), handle_request_cancel(), handle_soft_key_event_message(), iax2_destroy(), iax2_queue_hangup(), jingle_hangup_farend(), local_hangup(), and mgcp_queue_hangup().

01032 {
01033    struct ast_frame f = { AST_FRAME_CONTROL, AST_CONTROL_HANGUP };
01034    /* Yeah, let's not change a lock-critical value without locking */
01035    if (!ast_channel_trylock(chan)) {
01036       chan->_softhangup |= AST_SOFTHANGUP_DEV;
01037       ast_channel_unlock(chan);
01038    }
01039    return ast_queue_frame(chan, &f);
01040 }

int ast_queue_hangup_with_cause ( struct ast_channel chan,
int  cause 
)

Queue a hangup frame with hangupcause set.

Note:
The channel does not need to be locked before calling this function.
Parameters:
[in] chan channel to queue frame onto
[in] cause the hangup cause
Returns:
0 on success, -1 on error
Since:
1.6.1

Definition at line 1043 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, chanlist::chan, f, and ast_channel::hangupcause.

Referenced by __oh323_update_info(), __sip_autodestruct(), close_call(), close_client(), console_hangup(), dahdi_handle_event(), handle_request_bye(), handle_response(), handle_response_invite(), handle_response_notify(), HandleCallOutgoing(), hangup_chan(), hangup_connection(), misdn_answer(), pri_hangup_all(), retrans_pkt(), and TransferCallStep1().

01044 {
01045    struct ast_frame f = { AST_FRAME_CONTROL, AST_CONTROL_HANGUP };
01046 
01047    if (cause >= 0)
01048       f.data.uint32 = cause;
01049 
01050    /* Yeah, let's not change a lock-critical value without locking */
01051    if (!ast_channel_trylock(chan)) {
01052       chan->_softhangup |= AST_SOFTHANGUP_DEV;
01053       if (cause < 0)
01054          f.data.uint32 = chan->hangupcause;
01055 
01056       ast_channel_unlock(chan);
01057    }
01058 
01059    return ast_queue_frame(chan, &f);
01060 }

int ast_raw_answer ( struct ast_channel chan,
int  cdr_answer 
)

Answer a channel.

Parameters:
chan channel to answer
cdr_answer flag to control whether any associated CDR should be marked as 'answered'
This function answers a channel and handles all necessary call setup functions.

Note:
The channel passed does not need to be locked, but is locked by the function when needed.

Unlike ast_answer(), this function will not wait for media flow to begin. The caller should be careful before sending media to the channel before incoming media arrives, as the outgoing media may be lost.

Return values:
0 on success
non-zero on failure

Definition at line 1681 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, chanlist::chan, ast_channel::tech, and ast_channel::visible_indication.

Referenced by __ast_answer(), and ast_bridge_call().

01682 {
01683    int res = 0;
01684 
01685    ast_channel_lock(chan);
01686 
01687    /* You can't answer an outbound call */
01688    if (ast_test_flag(chan, AST_FLAG_OUTGOING)) {
01689       ast_channel_unlock(chan);
01690       return 0;
01691    }
01692 
01693    /* Stop if we're a zombie or need a soft hangup */
01694    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) {
01695       ast_channel_unlock(chan);
01696       return -1;
01697    }
01698 
01699    ast_channel_unlock(chan);
01700 
01701    switch (chan->_state) {
01702    case AST_STATE_RINGING:
01703    case AST_STATE_RING:
01704       ast_channel_lock(chan);
01705       if (chan->tech->answer) {
01706          res = chan->tech->answer(chan);
01707       }
01708       ast_setstate(chan, AST_STATE_UP);
01709       if (cdr_answer) {
01710          ast_cdr_answer(chan->cdr);
01711       }
01712       ast_channel_unlock(chan);
01713       break;
01714    case AST_STATE_UP:
01715       /* Calling ast_cdr_answer when it it has previously been called
01716        * is essentially a no-op, so it is safe.
01717        */
01718       if (cdr_answer) {
01719          ast_cdr_answer(chan->cdr);
01720       }
01721       break;
01722    default:
01723       break;
01724    }
01725 
01726    ast_indicate(chan, -1);
01727    chan->visible_indication = 0;
01728 
01729    return res;
01730 }

struct ast_frame* ast_read ( struct ast_channel chan  ) 

Reads 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.

Definition at line 2939 of file channel.c.

References __ast_read(), and chanlist::chan.

Referenced by __adsi_transmit_messages(), __ast_answer(), __ast_play_and_record(), __ast_request_and_dial(), adsi_careful_send(), agent_ack_sleep(), agent_read(), 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(), builtin_atxfer(), channel_spy(), check_goto_on_transfer(), conf_exec(), conf_flush(), conf_run(), dahdi_bridge(), dictate_exec(), disa_exec(), do_idle_thread(), do_waiting(), echo_exec(), eivr_comm(), find_cache(), handle_invite_replaces(), handle_recordfile(), handle_speechrecognize(), iax_park_thread(), ices_exec(), isAnsweringMachine(), launch_asyncagi(), manage_parkinglot(), 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(), transmit_audio(), transmit_t38(), wait_for_answer(), wait_for_hangup(), wait_for_winner(), waitforring_exec(), and waitstream_core().

02940 {
02941    return __ast_read(chan, 0);
02942 }

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

Definition at line 2412 of file channel.c.

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

Referenced by __ast_read().

02413 {
02414    if (chan->generatordata &&  !ast_internal_timing_enabled(chan)) {
02415       void *tmp = chan->generatordata;
02416       int (*generate)(struct ast_channel *chan, void *tmp, int datalen, int samples) = NULL;
02417       int res;
02418       int samples;
02419 
02420       if (chan->timingfunc) {
02421          ast_debug(1, "Generator got voice, switching to phase locked mode\n");
02422          ast_settimeout(chan, 0, NULL, NULL);
02423       }
02424 
02425       chan->generatordata = NULL;     /* reset, to let writes go through */
02426 
02427       if (f->subclass != chan->writeformat) {
02428          float factor;
02429          factor = ((float) ast_format_rate(chan->writeformat)) / ((float) ast_format_rate(f->subclass));
02430          samples = (int) ( ((float) f->samples) * factor );
02431       } else {
02432          samples = f->samples;
02433       }
02434       
02435       if (chan->generator->generate) {
02436          generate = chan->generator->generate;
02437       }
02438       /* This unlock is here based on two assumptions that hold true at this point in the
02439        * code. 1) this function is only called from within __ast_read() and 2) all generators
02440        * call ast_write() in their generate callback.
02441        *
02442        * The reason this is added is so that when ast_write is called, the lock that occurs 
02443        * there will not recursively lock the channel. Doing this will cause intended deadlock 
02444        * avoidance not to work in deeper functions
02445        */
02446       ast_channel_unlock(chan);
02447       res = generate(chan, tmp, f->datalen, samples);
02448       ast_channel_lock(chan);
02449       chan->generatordata = tmp;
02450       if (res) {
02451          ast_debug(1, "Auto-deactivating generator\n");
02452          ast_deactivate_generator(chan);
02453       }
02454 
02455    } else if (f->frametype == AST_FRAME_CNG) {
02456       if (chan->generator && !chan->timingfunc && (chan->timingfd > -1)) {
02457          ast_debug(1, "Generator got CNG, switching to timed mode\n");
02458          ast_settimeout(chan, 50, generator_force, chan);
02459       }
02460    }
02461 }

struct ast_frame* ast_read_noaudio ( struct ast_channel chan  ) 

Reads a frame, returning AST_FRAME_NULL frame if audio.

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 2944 of file channel.c.

References __ast_read(), and chanlist::chan.

Referenced by conf_run().

02945 {
02946    return __ast_read(chan, 1);
02947 }

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 3741 of file channel.c.

References ast_readstring_full().

Referenced by _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().

03742 {
03743    return ast_readstring_full(c, s, len, timeout, ftimeout, enders, -1, -1);
03744 }

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 3746 of file channel.c.

References ast_check_hangup(), AST_DIGIT_ANY, AST_FLAG_ZOMBIE, AST_GETDATA_COMPLETE, AST_GETDATA_EMPTY_END_TERMINATED, AST_GETDATA_FAILED, AST_GETDATA_INTERRUPTED, AST_GETDATA_TIMEOUT, ast_stopstream(), ast_test_flag, ast_waitfordigit_full(), ast_waitstream_full(), and ast_channel::stream.

Referenced by ast_app_getdata_full(), and ast_readstring().

03747 {
03748    int pos = 0;   /* index in the buffer where we accumulate digits */
03749    int to = ftimeout;
03750 
03751    /* Stop if we're a zombie or need a soft hangup */
03752    if (ast_test_flag(c, AST_FLAG_ZOMBIE) || ast_check_hangup(c))
03753       return -1;
03754    if (!len)
03755       return -1;
03756    for (;;) {
03757       int d;
03758       if (c->stream) {
03759          d = ast_waitstream_full(c, AST_DIGIT_ANY, audiofd, ctrlfd);
03760          ast_stopstream(c);
03761          usleep(1000);
03762          if (!d)
03763             d = ast_waitfordigit_full(c, to, audiofd, ctrlfd);
03764       } else {
03765          d = ast_waitfordigit_full(c, to, audiofd, ctrlfd);
03766       }
03767       if (d < 0)
03768          return AST_GETDATA_FAILED;
03769       if (d == 0) {
03770          s[pos] = '\0';
03771          return AST_GETDATA_TIMEOUT;
03772       }
03773       if (d == 1) {
03774          s[pos] = '\0';
03775          return AST_GETDATA_INTERRUPTED;
03776       }
03777       if (strchr(enders, d) && (pos == 0)) {
03778          s[pos] = '\0';
03779          return AST_GETDATA_EMPTY_END_TERMINATED;
03780       }
03781       if (!strchr(enders, d)) {
03782          s[pos++] = d;
03783       }
03784       if (strchr(enders, d) || (pos >= len)) {
03785          s[pos] = '\0';
03786          return AST_GETDATA_COMPLETE;
03787       }
03788       to = timeout;
03789    }
03790    /* Never reached */
03791    return 0;
03792 }

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 3081 of file channel.c.

References ast_free, ast_recvtext(), buf, and chanlist::chan.

Referenced by handle_recvchar().

03082 {
03083    int c;
03084    char *buf = ast_recvtext(chan, timeout);
03085    if (buf == NULL)
03086       return -1;  /* error or timeout */
03087    c = *(unsigned char *)buf;
03088    ast_free(buf);
03089    return c;
03090 }

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 3092 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(), buf, chanlist::chan, and f.

Referenced by ast_recvchar(), and handle_recvtext().

03093 {
03094    int res, done = 0;
03095    char *buf = NULL;
03096    
03097    while (!done) {
03098       struct ast_frame *f;
03099       if (ast_check_hangup(chan))
03100          break;
03101       res = ast_waitfor(chan, timeout);
03102       if (res <= 0) /* timeout or error */
03103          break;
03104       timeout = res; /* update timeout */
03105       f = ast_read(chan);
03106       if (f == NULL)
03107          break; /* no frame */
03108       if (f->frametype == AST_FRAME_CONTROL && f->subclass == AST_CONTROL_HANGUP)
03109          done = 1;   /* force a break */
03110       else if (f->frametype == AST_FRAME_TEXT) {      /* what we want */
03111          buf = ast_strndup((char *) f->data.ptr, f->datalen);  /* dup and break */
03112          done = 1;
03113       }
03114       ast_frfree(f);
03115    }
03116    return buf;
03117 }

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

Return values:
NULL failure
non-NULL channel on success

Definition at line 3641 of file channel.c.

References AST_CAUSE_BEARERCAPABILITY_NOTAVAIL, AST_CAUSE_NOSUCHDRIVER, AST_CAUSE_NOTDEFINED, AST_FORMAT_AUDIO_MASK, AST_FORMAT_TEXT_MASK, AST_FORMAT_VIDEO_MASK, AST_LIST_TRAVERSE, ast_log(), AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, ast_translator_best_choice(), capabilities, ast_channel_tech::capabilities, chanlist::chan, chanlist::list, LOG_WARNING, ast_channel_tech::requester, ast_channel::tech, and ast_channel_tech::type.

Referenced by __ast_request_and_dial(), agent_request(), ast_feature_request_and_dial(), attempt_reconnect(), begin_dial_channel(), build_conf(), chanavail_exec(), conf_run(), connect_link(), dial_exec_full(), do_forward(), findmeexec(), ring_entry(), rpt(), rpt_call(), rpt_exec(), and rpt_tele_thread().

03642 {
03643    struct chanlist *chan;
03644    struct ast_channel *c;
03645    int capabilities;
03646    int fmt;
03647    int res;
03648    int foo;
03649    int videoformat = format & AST_FORMAT_VIDEO_MASK;
03650    int textformat = format & AST_FORMAT_TEXT_MASK;
03651 
03652    if (!cause)
03653       cause = &foo;
03654    *cause = AST_CAUSE_NOTDEFINED;
03655 
03656    if (AST_RWLIST_RDLOCK(&channels)) {
03657       ast_log(LOG_WARNING, "Unable to lock channel list\n");
03658       return NULL;
03659    }
03660 
03661    AST_LIST_TRAVERSE(&backends, chan, list) {
03662       if (strcasecmp(type, chan->tech->type))
03663          continue;
03664 
03665       capabilities = chan->tech->capabilities;
03666       fmt = format & AST_FORMAT_AUDIO_MASK;
03667       if (fmt) {
03668          /* We have audio - is it possible to connect the various calls to each other? 
03669             (Avoid this check for calls without audio, like text+video calls)
03670          */
03671          res = ast_translator_best_choice(&fmt, &capabilities);
03672          if (res < 0) {
03673             ast_log(LOG_WARNING, "No translator path exists for channel type %s (native 0x%x) to 0x%x\n", type, chan->tech->capabilities, format);
03674             *cause = AST_CAUSE_BEARERCAPABILITY_NOTAVAIL;
03675             AST_RWLIST_UNLOCK(&channels);
03676             return NULL;
03677          }
03678       }
03679       AST_RWLIST_UNLOCK(&channels);
03680       if (!chan->tech->requester)
03681          return NULL;
03682       
03683       if (!(c = chan->tech->requester(type, capabilities | videoformat | textformat, data, cause)))
03684          return NULL;
03685       
03686       /* no need to generate a Newchannel event here; it is done in the channel_alloc call */
03687       return c;
03688    }
03689 
03690    ast_log(LOG_WARNING, "No channel type registered for '%s'\n", type);
03691    *cause = AST_CAUSE_NOSUCHDRIVER;
03692    AST_RWLIST_UNLOCK(&channels);
03693 
03694    return NULL;
03695 }

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

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 unsuccessful)
cid_num Caller-ID Number
cid_name Caller-ID Name (ascii)
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 3636 of file channel.c.

References __ast_request_and_dial().

Referenced by ast_pbx_outgoing_exten().

03637 {
03638    return __ast_request_and_dial(type, format, data, timeout, outstate, cidnum, cidname, NULL);
03639 }

int ast_safe_sleep ( struct ast_channel chan,
int  ms 
)

Wait for a specified 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 1271 of file channel.c.

References ast_safe_sleep_conditional(), and chanlist::chan.

Referenced by _ast_adsi_transmit_message_full(), alarmreceiver_exec(), ast_dtmf_stream(), ast_senddigit(), builtin_atxfer(), builtin_parkcall(), conf_run(), dictate_exec(), flash_exec(), function_ilink(), handle_callforward_button(), login_exec(), mgcp_ss(), milliwatt_exec(), misdn_check_l2l1(), old_milliwatt_exec(), park_call_exec(), pbx_builtin_wait(), play_moh_exec(), 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(), wait_moh_exec(), waituntil_exec(), and zapateller_exec().

01272 {
01273    return ast_safe_sleep_conditional(chan, ms, NULL, NULL);
01274 }

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

Wait for a specified 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 1250 of file channel.c.

References ast_frfree, ast_read(), ast_waitfor(), chanlist::chan, and f.

Referenced by ast_safe_sleep(), and login_exec().

01251 {
01252    struct ast_frame *f;
01253 
01254    while (ms > 0) {
01255       if (cond && ((*cond)(data) == 0))
01256          return 0;
01257       ms = ast_waitfor(chan, ms);
01258       if (ms < 0)
01259          return -1;
01260       if (ms > 0) {
01261          f = ast_read(chan);
01262          if (!f)
01263             return -1;
01264          ast_frfree(f);
01265       }
01266    }
01267    return 0;
01268 }

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

Definition at line 5458 of file channel.c.

References ast_say_character_str_full, and chan.

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

05460 {
05461    return ast_say_character_str_full(chan, str, ints, lang, -1, -1);
05462 }

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

Definition at line 5452 of file channel.c.

References ast_say_digit_str_full, and chan.

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

05454 {
05455    return ast_say_digit_str_full(chan, str, ints, lang, -1, -1);
05456 }

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

Definition at line 5446 of file channel.c.

References ast_say_digits_full(), and chan.

Referenced by ast_park_call_full(), common_exec(), conf_exec(), conf_run(), parkandannounce_exec(), and rpt_tele_thread().

05448 {
05449    return ast_say_digits_full(chan, num, ints, lang, -1, -1);
05450 }

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

Definition at line 5470 of file channel.c.

References ast_say_digit_str_full, and chan.

Referenced by 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_hu(), 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(), ast_say_number_full_th(), ast_say_number_full_tw(), and say_init_mode().

05472 {
05473    char buf[256];
05474 
05475    snprintf(buf, sizeof(buf), "%d", num);
05476 
05477    return ast_say_digit_str_full(chan, buf, ints, lang, audiofd, ctrlfd);
05478 }

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

Definition at line 5440 of file channel.c.

References ast_say_enumeration_full, and chan.

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().

05442 {
05443    return ast_say_enumeration_full(chan, num, ints, language, options, -1, -1);
05444 }

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

Definition at line 5434 of file channel.c.

References ast_say_number_full, and chan.

Referenced by ast_say_date_da(), ast_say_date_de(), ast_say_date_en(), ast_say_date_fr(), ast_say_date_ge(), ast_say_date_gr(), ast_say_date_he(), ast_say_date_hu(), ast_say_date_nl(), ast_say_date_pt(), ast_say_date_th(), 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_date_with_format_th(), 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_th(), ast_say_datetime_tw(), ast_say_time_de(), ast_say_time_en(), ast_say_time_fr(), ast_say_time_ge(), ast_say_time_gr(), ast_say_time_hu(), ast_say_time_nl(), ast_say_time_pt(), ast_say_time_pt_BR(), ast_say_time_th(), 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().

05436 {
05437    return ast_say_number_full(chan, num, ints, language, options, -1, -1);
05438 }

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

Definition at line 5464 of file channel.c.

References ast_say_phonetic_str_full, and chan.

Referenced by pbx_builtin_sayphonetic().

05466 {
05467    return ast_say_phonetic_str_full(chan, str, ints, lang, -1, -1);
05468 }

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

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
duration the duration of the digit ending in ms
Returns:
Returns 0 on success, -1 on failure

Definition at line 3190 of file channel.c.

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

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

03191 {
03192    if (chan->tech->send_digit_begin) {
03193       ast_senddigit_begin(chan, digit);
03194       ast_safe_sleep(chan, (duration >= AST_DEFAULT_EMULATE_DTMF_DURATION ? duration : AST_DEFAULT_EMULATE_DTMF_DURATION));
03195    }
03196    
03197    return ast_senddigit_end(chan, digit, (duration >= AST_DEFAULT_EMULATE_DTMF_DURATION ? duration : AST_DEFAULT_EMULATE_DTMF_DURATION));
03198 }

int ast_senddigit_begin ( 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 3132 of file channel.c.

References ast_debug, ast_playtones_start(), chanlist::chan, ast_channel::name, ast_channel_tech::send_digit_begin, and ast_channel::tech.

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

03133 {
03134    /* Device does not support DTMF tones, lets fake
03135     * it by doing our own generation. */
03136    static const char* dtmf_tones[] = {
03137       "941+1336", /* 0 */
03138       "697+1209", /* 1 */
03139       "697+1336", /* 2 */
03140       "697+1477", /* 3 */
03141       "770+1209", /* 4 */
03142       "770+1336", /* 5 */
03143       "770+1477", /* 6 */
03144       "852+1209", /* 7 */
03145       "852+1336", /* 8 */
03146       "852+1477", /* 9 */
03147       "697+1633", /* A */
03148       "770+1633", /* B */
03149       "852+1633", /* C */
03150       "941+1633", /* D */
03151       "941+1209", /* * */
03152       "941+1477"  /* # */
03153    };
03154 
03155    if (!chan->tech->send_digit_begin)
03156       return 0;
03157 
03158    if (!chan->tech->send_digit_begin(chan, digit))
03159       return 0;
03160 
03161    if (digit >= '0' && digit <='9')
03162       ast_playtones_start(chan, 0, dtmf_tones[digit-'0'], 0);
03163    else if (digit >= 'A' && digit <= 'D')
03164       ast_playtones_start(chan, 0, dtmf_tones[digit-'A'+10], 0);
03165    else if (digit == '*')
03166       ast_playtones_start(chan, 0, dtmf_tones[14], 0);
03167    else if (digit == '#')
03168       ast_playtones_start(chan, 0, dtmf_tones[15], 0);
03169    else {
03170       /* not handled */
03171       ast_debug(1, "Unable to generate DTMF tone '%c' for '%s'\n", digit, chan->name);
03172    }
03173 
03174    return 0;
03175 }

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

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
duration the duration of the digit ending in ms
Returns:
Returns 0 on success, -1 on failure

Definition at line 3177 of file channel.c.

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

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

03178 {
03179    int res = -1;
03180 
03181    if (chan->tech->send_digit_end)
03182       res = chan->tech->send_digit_end(chan, digit, duration);
03183 
03184    if (res && chan->generator)
03185       ast_playtones_stop(chan);
03186    
03187    return 0;
03188 }

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

Sends text to a channel.

Parameters:
chan channel to act upon
text string of text to send on the channel
Write text to a display on a channel

Note:
The channel does not need to be locked before calling this function.
Return values:
0 on success
-1 on failure

Definition at line 3119 of file channel.c.

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

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

03120 {
03121    int res = 0;
03122    /* Stop if we're a zombie or need a soft hangup */
03123    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan))
03124       return -1;
03125    CHECK_BLOCKING(chan);
03126    if (chan->tech->send_text)
03127       res = chan->tech->send_text(chan, text);
03128    ast_clear_flag(chan, AST_FLAG_BLOCKING);
03129    return res;
03130 }

void ast_set_callerid ( struct ast_channel chan,
const char *  cid_num,
const char *  cid_name,
const char *  cid_ani 
)

Set caller ID number, name and ANI.

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

Definition at line 4298 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_describe_caller_presentation(), ast_free, ast_strdup, chanlist::chan, ast_channel::cid, ast_callerid::cid_ani, ast_callerid::cid_name, ast_callerid::cid_num, ast_callerid::cid_pres, EVENT_FLAG_CALL, 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(), dial_exec_full(), do_forward(), findmeexec(), handle_setcallerid(), mgcp_ss(), read_config(), rpt_exec(), skinny_newcall(), and ss_thread().

04299 {
04300    ast_channel_lock(chan);
04301 
04302    if (cid_num) {
04303       if (chan->cid.cid_num)
04304          ast_free(chan->cid.cid_num);
04305       chan->cid.cid_num = ast_strdup(cid_num);
04306    }
04307    if (cid_name) {
04308       if (chan->cid.cid_name)
04309          ast_free(chan->cid.cid_name);
04310       chan->cid.cid_name = ast_strdup(cid_name);
04311    }
04312    if (cid_ani) {
04313       if (chan->cid.cid_ani)
04314          ast_free(chan->cid.cid_ani);
04315       chan->cid.cid_ani = ast_strdup(cid_ani);
04316    }
04317    manager_event(EVENT_FLAG_CALL, "NewCallerid",
04318             "Channel: %s\r\n"
04319             "CallerIDNum: %s\r\n"
04320             "CallerIDName: %s\r\n"
04321             "Uniqueid: %s\r\n"
04322             "CID-CallingPres: %d (%s)\r\n",
04323             chan->name,
04324             S_OR(chan->cid.cid_num, ""),
04325             S_OR(chan->cid.cid_name, ""),
04326             chan->uniqueid,
04327             chan->cid.cid_pres,
04328             ast_describe_caller_presentation(chan->cid.cid_pres)
04329             );
04330    
04331    ast_channel_unlock(chan);
04332 }

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 3479 of file channel.c.

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

Referenced by __ast_play_and_record(), __oh323_update_info(), _ast_adsi_transmit_message_full(), agent_call(), alarmreceiver_exec(), ast_channel_make_compatible_helper(), ast_do_masquerade(), attempt_reconnect(), background_detect_exec(), build_conf(), conf_run(), connect_link(), dictate_exec(), do_waiting(), eagi_exec(), echo_exec(), gtalk_rtp_read(), handle_recordfile(), handle_speechrecognize(), ices_exec(), isAnsweringMachine(), jingle_rtp_read(), login_exec(), measurenoise(), mgcp_rtp_read(), oh323_rtp_read(), old_milliwatt_exec(), process_sdp(), rpt(), rpt_exec(), setup_rtp_connection(), sip_rtp_read(), skinny_rtp_read(), socket_process(), speech_background(), transmit_audio(), and unistim_rtp_read().

03480 {
03481    return set_format(chan, fmt, &chan->rawreadformat, &chan->readformat,
03482            &chan->readtrans, 0);
03483 }

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 5211 of file channel.c.

References chan, 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().

05212 {
05213    struct ast_variable *cur;
05214 
05215    for (cur = vars; cur; cur = cur->next)
05216       pbx_builtin_setvar_helper(chan, cur->name, cur->value);  
05217 }

int ast_set_write_format ( struct ast_channel chan,
int  format 
)

Sets write format on channel chan Set write format for channel to whichever component 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 3485 of file channel.c.

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

Referenced by __oh323_update_info(), _ast_adsi_transmit_message_full(), agent_call(), alarmreceiver_exec(), ast_channel_make_compatible_helper(), 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(), echo_exec(), extenspy_exec(), gtalk_rtp_read(), jingle_rtp_read(), linear_alloc(), linear_release(), login_exec(), 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(), rpt_exec(), send_waveform_to_channel(), setup_rtp_connection(), sip_rtp_read(), skinny_rtp_read(), socket_process(), tonepair_alloc(), tonepair_release(), transmit_audio(), and unistim_rtp_read().

03486 {
03487    return set_format(chan, fmt, &chan->rawwriteformat, &chan->writeformat,
03488            &chan->writetrans, 1);
03489 }

int ast_setstate ( struct ast_channel chan,
enum ast_channel_state  state 
)

Change the state of a channel.

Definition at line 4334 of file channel.c.

References ast_channel::_state, AST_CHANNEL_NAME, ast_copy_string(), AST_DEVICE_UNKNOWN, ast_devstate_changed_literal(), ast_state2str(), chanlist::chan, ast_channel::cid, ast_callerid::cid_name, ast_callerid::cid_num, EVENT_FLAG_CALL, 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_raw_answer(), cb_events(), check_availability(), console_answer(), dahdi_answer(), dahdi_call(), dahdi_handle_event(), dahdi_indicate(), dahdi_read(), do_bridge_masquerade(), 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(), jingle_call(), jingle_newcall(), 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(), unistim_answer(), unistim_call(), unistim_new(), unistim_ss(), update_state(), usbradio_answer(), and usbradio_call().

04335 {
04336    int oldstate = chan->_state;
04337    char name[AST_CHANNEL_NAME], *dashptr;
04338 
04339    if (oldstate == state)
04340       return 0;
04341 
04342    ast_copy_string(name, chan->name, sizeof(name));
04343    if ((dashptr = strrchr(name, '-'))) {
04344       *dashptr = '\0';
04345    }
04346 
04347    chan->_state = state;
04348 
04349    /* We have to pass AST_DEVICE_UNKNOWN here because it is entirely possible that the channel driver
04350     * for this channel is using the callback method for device state. If we pass in an actual state here
04351     * we override what they are saying the state is and things go amuck. */
04352    ast_devstate_changed_literal(AST_DEVICE_UNKNOWN, name);
04353 
04354    /* setstate used to conditionally report Newchannel; this is no more */
04355    manager_event(EVENT_FLAG_CALL,
04356             "Newstate",
04357             "Channel: %s\r\n"
04358             "ChannelState: %d\r\n"
04359             "ChannelStateDesc: %s\r\n"
04360             "CallerIDNum: %s\r\n"
04361             "CallerIDName: %s\r\n"
04362             "Uniqueid: %s\r\n",
04363             chan->name, chan->_state, ast_state2str(chan->_state),
04364             S_OR(chan->cid.cid_num, ""),
04365             S_OR(chan->cid.cid_name, ""),
04366             chan->uniqueid);
04367 
04368    return 0;
04369 }

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

Enable or disable timer ticks for a channel.

Parameters:
rate number of timer ticks per second
If timers are supported, force a scheduled expiration on the timer fd, at which point we call the callback function / data

Call this function with a rate of 0 to turn off the timer ticks

Version:
1.6.1 changed samples parameter to rate, accomodates new timing methods

Definition at line 2287 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_debug, ast_timer_get_max_rate(), ast_timer_set_rate(), ast_channel::timer, 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().

02288 {
02289    int res;
02290    unsigned int real_rate = rate, max_rate;
02291 
02292    ast_channel_lock(c);
02293 
02294    if (c->timingfd == -1) {
02295       ast_channel_unlock(c);
02296       return -1;
02297    }
02298 
02299    if (!func) {
02300       rate = 0;
02301       data = NULL;
02302    }
02303 
02304    if (rate && rate > (max_rate = ast_timer_get_max_rate(c->timer))) {
02305       real_rate = max_rate;
02306    }
02307 
02308    ast_debug(1, "Scheduling timer at (%u requested / %u actual) timer ticks per second\n", rate, real_rate);
02309 
02310    res = ast_timer_set_rate(c->timer, real_rate);
02311 
02312    c->timingfunc = func;
02313    c->timingdata = data;
02314 
02315    ast_channel_unlock(c);
02316 
02317    return res;
02318 }

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 515 of file channel.c.

Referenced by handle_request_options().

00516 {
00517    return shutting_down;
00518 }

int ast_softhangup ( struct ast_channel chan,
int  cause 
)

Softly hangup up a channel.

Parameters:
chan channel to be soft-hung-up
cause Ast hangupcause for hangup
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.

Note:
The channel passed to this function does not need to be locked.
Returns:
Returns 0 regardless

Definition at line 1560 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_softhangup_nolock(), and chanlist::chan.

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

01561 {
01562    int res;
01563 
01564    ast_channel_lock(chan);
01565    res = ast_softhangup_nolock(chan, cause);
01566    ast_channel_unlock(chan);
01567 
01568    return res;
01569 }

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 1547 of file channel.c.

References ast_channel::_softhangup, ast_debug, AST_FLAG_BLOCKING, ast_null_frame, ast_queue_frame(), ast_test_flag, ast_channel::blocker, chanlist::chan, and ast_channel::name.

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

01548 {
01549    ast_debug(1, "Soft-Hanging up channel '%s'\n", chan->name);
01550    /* Inform channel driver that we need to be hung up, if it cares */
01551    chan->_softhangup |= cause;
01552    ast_queue_frame(chan, &ast_null_frame);
01553    /* Interrupt any poll call or such */
01554    if (ast_test_flag(chan, AST_FLAG_BLOCKING))
01555       pthread_kill(chan->blocker, SIGURG);
01556    return 0;
01557 }

const char* ast_state2str ( enum ast_channel_state  state  ) 

Gives the string form of a given channel state.

Note:
This function is not reentrant.

Definition at line 656 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(), buf, STATE2STR_BUFSIZE, and state2str_threadbuf.

Referenced by action_coreshowchannels(), agent_hangup(), ast_channel_alloc(), ast_do_masquerade(), ast_setstate(), attempt_transfer(), func_channel_read(), handle_chanlist(), handle_invite_replaces(), handle_showchan(), local_attended_transfer(), mgcp_new(), serialize_showchan(), and sip_hangup().

00657 {
00658    char *buf;
00659 
00660    switch (state) {
00661    case AST_STATE_DOWN:
00662       return "Down";
00663    case AST_STATE_RESERVED:
00664       return "Rsrvd";
00665    case AST_STATE_OFFHOOK:
00666       return "OffHook";
00667    case AST_STATE_DIALING:
00668       return "Dialing";
00669    case AST_STATE_RING:
00670       return "Ring";
00671    case AST_STATE_RINGING:
00672       return "Ringing";
00673    case AST_STATE_UP:
00674       return "Up";
00675    case AST_STATE_BUSY:
00676       return "Busy";
00677    case AST_STATE_DIALING_OFFHOOK:
00678       return "Dialing Offhook";
00679    case AST_STATE_PRERING:
00680       return "Pre-ring";
00681    default:
00682       if (!(buf = ast_threadstorage_get(&state2str_threadbuf, STATE2STR_BUFSIZE)))
00683          return "Unknown";
00684       snprintf(buf, STATE2STR_BUFSIZE, "Unknown (%d)", state);
00685       return buf;
00686    }
00687 }

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 642 of file channel.c.

References ARRAY_LEN, ast_cause::cause, and causes.

Referenced by pbx_builtin_hangup().

00643 {
00644    int x;
00645 
00646    for (x = 0; x < ARRAY_LEN(causes); x++)
00647       if (!strncasecmp(causes[x].name, name, strlen(causes[x].name)))
00648          return causes[x].cause;
00649 
00650    return -1;
00651 }

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 5086 of file channel.c.

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

Referenced by zapateller_exec().

05087 {
05088    int res;
05089 
05090    if ((res = ast_tonepair_start(chan, freq1, freq2, duration, vol)))
05091       return res;
05092 
05093    /* Give us some wiggle room */
05094    while (chan->generatordata && ast_waitfor(chan, 100) >= 0) {
05095       struct ast_frame *f = ast_read(chan);
05096       if (f)
05097          ast_frfree(f);
05098       else
05099          return -1;
05100    }
05101    return 0;
05102 }

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

Start a tone going

Definition at line 5068 of file channel.c.

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

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

05069 {
05070    struct tonepair_def d = { 0, };
05071 
05072    d.freq1 = freq1;
05073    d.freq2 = freq2;
05074    d.duration = duration;
05075    d.vol = (vol < 1) ? 8192 : vol; /* force invalid to 8192 */
05076    if (ast_activate_generator(chan, &tonepair, &d))
05077       return -1;
05078    return 0;
05079 }

void ast_tonepair_stop ( struct ast_channel chan  ) 

Stop a tone from playing

Definition at line 5081 of file channel.c.

References ast_deactivate_generator(), and chan.

Referenced by sendnoise().

05082 {
05083    ast_deactivate_generator(chan);
05084 }

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 3723 of file channel.c.

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

Referenced by transfer_exec().

03724 {
03725    int res = -1;
03726 
03727    /* Stop if we're a zombie or need a soft hangup */
03728    ast_channel_lock(chan);
03729    if (!ast_test_flag(chan, AST_FLAG_ZOMBIE) && !ast_check_hangup(chan)) {
03730       if (chan->tech->transfer) {
03731          res = chan->tech->transfer(chan, dest);
03732          if (!res)
03733             res = 1;
03734       } else
03735          res = 0;
03736    }
03737    ast_channel_unlock(chan);
03738    return res;
03739 }

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 capability

Definition at line 690 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().

00691 {
00692    switch (transfercapability) {
00693    case AST_TRANS_CAP_SPEECH:
00694       return "SPEECH";
00695    case AST_TRANS_CAP_DIGITAL:
00696       return "DIGITAL";
00697    case AST_TRANS_CAP_RESTRICTED_DIGITAL:
00698       return "RESTRICTED_DIGITAL";
00699    case AST_TRANS_CAP_3_1K_AUDIO:
00700       return "3K1AUDIO";
00701    case AST_TRANS_CAP_DIGITAL_W_TONES:
00702       return "DIGITAL_W_TONES";
00703    case AST_TRANS_CAP_VIDEO:
00704       return "VIDEO";
00705    default:
00706       return "UNKNOWN";
00707    }
00708 }

void ast_uninstall_music_functions ( void   ) 

Definition at line 5149 of file channel.c.

References ast_moh_cleanup_ptr, ast_moh_start_ptr, and ast_moh_stop_ptr.

Referenced by unload_module().

05150 {
05151    ast_moh_start_ptr = NULL;
05152    ast_moh_stop_ptr = NULL;
05153    ast_moh_cleanup_ptr = NULL;
05154 }

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 2271 of file channel.c.

References ast_waitfor_nandfds().

Referenced by __adsi_transmit_messages(), __ast_answer(), __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(), handle_speechrecognize(), ices_exec(), isAnsweringMachine(), launch_asyncagi(), measurenoise(), mp3_exec(), NBScat_exec(), receive_dtmf_digits(), recordthread(), send_tone_burst(), send_waveform_to_channel(), sendurl_exec(), speech_background(), ss_thread(), transmit_audio(), transmit_t38(), wait_for_hangup(), waitforring_exec(), and waitstream_core().

02272 {
02273    int oldms = ms;   /* -1 if no timeout */
02274 
02275    ast_waitfor_nandfds(&c, 1, NULL, 0, NULL, NULL, &ms);
02276    if ((ms < 0) && (oldms < 0))
02277       ms = 0;
02278    return ms;
02279 }

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 2266 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().

02267 {
02268    return ast_waitfor_nandfds(c, n, NULL, 0, NULL, NULL, ms);
02269 }

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 1911 of file channel.c.

References ast_waitfor_nandfds().

Referenced by dundi_lookup_internal(), and dundi_precache_internal().

01912 {
01913    int winner = -1;
01914    ast_waitfor_nandfds(NULL, 0, fds, n, exception, &winner, ms);
01915    return winner;
01916 }

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 1923 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_poll, ast_set_flag, AST_SOFTHANGUP_TIMEOUT, ast_tvcmp(), ast_tvdiff_ms(), ast_tvnow(), ast_tvsub(), ast_tvzero(), chanlist::chan, CHECK_BLOCKING, errno, and LOG_WARNING.

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

01926 {
01927    struct timeval start = { 0 , 0 };
01928    struct pollfd *pfds = NULL;
01929    int res;
01930    long rms;
01931    int x, y, max;
01932    int sz;
01933    struct timeval now = { 0, 0 };
01934    struct timeval whentohangup = { 0, 0 }, diff;
01935    struct ast_channel *winner = NULL;
01936    struct fdmap {
01937       int chan;
01938       int fdno;
01939    } *fdmap = NULL;
01940 
01941    if ((sz = n * AST_MAX_FDS + nfds)) {
01942       pfds = alloca(sizeof(*pfds) * sz);
01943       fdmap = alloca(sizeof(*fdmap) * sz);
01944    }
01945 
01946    if (outfd)
01947       *outfd = -99999;
01948    if (exception)
01949       *exception = 0;
01950    
01951    /* Perform any pending masquerades */
01952    for (x = 0; x < n; x++) {
01953       ast_channel_lock(c[x]);
01954       if (c[x]->masq && ast_do_masquerade(c[x])) {
01955          ast_log(LOG_WARNING, "Masquerade failed\n");
01956          *ms = -1;
01957          ast_channel_unlock(c[x]);
01958          return NULL;
01959       }
01960       if (!ast_tvzero(c[x]->whentohangup)) {
01961          if (ast_tvzero(whentohangup))
01962             now = ast_tvnow();
01963          diff = ast_tvsub(c[x]->whentohangup, now);
01964          if (diff.tv_sec < 0 || ast_tvzero(diff)) {
01965             /* Should already be hungup */
01966             c[x]->_softhangup |= AST_SOFTHANGUP_TIMEOUT;
01967             ast_channel_unlock(c[x]);
01968             return c[x];
01969          }
01970          if (ast_tvzero(whentohangup) || ast_tvcmp(diff, whentohangup) < 0)
01971             whentohangup = diff;
01972       }
01973       ast_channel_unlock(c[x]);
01974    }
01975    /* Wait full interval */
01976    rms = *ms;
01977    if (!ast_tvzero(whentohangup)) {
01978       rms = whentohangup.tv_sec * 1000 + whentohangup.tv_usec / 1000;              /* timeout in milliseconds */
01979       if (*ms >= 0 && *ms < rms)    /* original *ms still smaller */
01980          rms =  *ms;
01981    }
01982    /*
01983     * Build the pollfd array, putting the channels' fds first,
01984     * followed by individual fds. Order is important because
01985     * individual fd's must have priority over channel fds.
01986     */
01987    max = 0;
01988    for (x = 0; x < n; x++) {
01989       for (y = 0; y < AST_MAX_FDS; y++) {
01990          fdmap[max].fdno = y;  /* fd y is linked to this pfds */
01991          fdmap[max].chan = x;  /* channel x is linked to this pfds */
01992          max += ast_add_fd(&pfds[max], c[x]->fds[y]);
01993       }
01994       CHECK_BLOCKING(c[x]);
01995    }
01996    /* Add the individual fds */
01997    for (x = 0; x < nfds; x++) {
01998       fdmap[max].chan = -1;
01999       max += ast_add_fd(&pfds[max], fds[x]);
02000    }
02001 
02002    if (*ms > 0)
02003       start = ast_tvnow();
02004    
02005    if (sizeof(int) == 4) { /* XXX fix timeout > 600000 on linux x86-32 */
02006       do {
02007          int kbrms = rms;
02008          if (kbrms > 600000)
02009             kbrms = 600000;
02010          res = ast_poll(pfds, max, kbrms);
02011          if (!res)
02012             rms -= kbrms;
02013       } while (!res && (rms > 0));
02014    } else {
02015       res = ast_poll(pfds, max, rms);
02016    }
02017    for (x = 0; x < n; x++)
02018       ast_clear_flag(c[x], AST_FLAG_BLOCKING);
02019    if (res < 0) { /* Simulate a timeout if we were interrupted */
02020       if (errno != EINTR)
02021          *ms = -1;
02022       return NULL;
02023    }
02024    if (!ast_tvzero(whentohangup)) {   /* if we have a timeout, check who expired */
02025       now = ast_tvnow();
02026       for (x = 0; x < n; x++) {
02027          if (!ast_tvzero(c[x]->whentohangup) && ast_tvcmp(c[x]->whentohangup, now) <= 0) {
02028             c[x]->_softhangup |= AST_SOFTHANGUP_TIMEOUT;
02029             if (winner == NULL)
02030                winner = c[x];
02031          }
02032       }
02033    }
02034    if (res == 0) { /* no fd ready, reset timeout and done */
02035       *ms = 0; /* XXX use 0 since we may not have an exact timeout. */
02036       return winner;
02037    }
02038    /*
02039     * Then check if any channel or fd has a pending event.
02040     * Remember to check channels first and fds last, as they
02041     * must have priority on setting 'winner'
02042     */
02043    for (x = 0; x < max; x++) {
02044       res = pfds[x].revents;
02045       if (res == 0)
02046          continue;
02047       if (fdmap[x].chan >= 0) {  /* this is a channel */
02048          winner = c[fdmap[x].chan]; /* override previous winners */
02049          if (res & POLLPRI)
02050             ast_set_flag(winner, AST_FLAG_EXCEPTION);
02051          else
02052             ast_clear_flag(winner, AST_FLAG_EXCEPTION);
02053          winner->fdno = fdmap[x].fdno;
02054       } else {       /* this is an fd */
02055          if (outfd)
02056             *outfd = pfds[x].fd;
02057          if (exception)
02058             *exception = (res & POLLPRI) ? -1 : 0;
02059          winner = NULL;
02060       }
02061    }
02062    if (*ms > 0) {
02063       *ms -= ast_tvdiff_ms(ast_tvnow(), start);
02064       if (*ms < 0)
02065          *ms = 0;
02066    }
02067    return winner;
02068 }

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 2282 of file channel.c.

References ast_waitfordigit_full().

Referenced by _ast_adsi_get_cpeid(), _ast_adsi_get_cpeinfo(), _ast_adsi_print(), _ast_adsi_read_encoded_dtmf(), _ast_adsi_transmit_message_full(), _while_exec(), advanced_options(), ast_app_dtget(), ast_control_streamfile(), ast_record_review(), builtin_atxfer(), collect_digits(), common_exec(), cpeid_exec(), dialout(), directory_exec(), forward_message(), get_folder(), ivr_dispatch(), mgcp_ss(), my_getsigstr(), pbx_builtin_waitexten(), play_record_review(), read_exec(), read_newoption(), readexten_exec(), retrydial_exec(), select_item_menu(), select_item_seq(), sendnoise(), ss_thread(), testclient_exec(), testserver_exec(), vm_execmain(), vm_forwardoptions(), vm_instructions_en(), vm_options(), vm_tempgreeting(), wait_a_bit(), and wait_our_turn().

02283 {
02284    return ast_waitfordigit_full(c, ms, -1, -1);
02285 }

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 2320 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, f, and LOG_WARNING.

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

02321 {
02322    /* Stop if we're a zombie or need a soft hangup */
02323    if (ast_test_flag(c, AST_FLAG_ZOMBIE) || ast_check_hangup(c))
02324       return -1;
02325 
02326    /* Only look for the end of DTMF, don't bother with the beginning and don't emulate things */
02327    ast_set_flag(c, AST_FLAG_END_DTMF_ONLY);
02328 
02329    /* Wait for a digit, no more than ms milliseconds total. */
02330    
02331    while (ms) {
02332       struct ast_channel *rchan;
02333       int outfd=-1;
02334 
02335       errno = 0;
02336       rchan = ast_waitfor_nandfds(&c, 1, &cmdfd, (cmdfd > -1) ? 1 : 0, NULL, &outfd, &ms);
02337       
02338       if (!rchan && outfd < 0 && ms) {
02339          if (errno == 0 || errno == EINTR)
02340             continue;
02341          ast_log(LOG_WARNING, "Wait failed (%s)\n", strerror(errno));
02342          ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
02343          return -1;
02344       } else if (outfd > -1) {
02345          /* The FD we were watching has something waiting */
02346          ast_log(LOG_WARNING, "The FD we were waiting for has something waiting. Waitfordigit returning numeric 1\n");
02347          ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
02348          return 1;
02349       } else if (rchan) {
02350          int res;
02351          struct ast_frame *f = ast_read(c);
02352          if (!f)
02353             return -1;
02354 
02355          switch (f->frametype) {
02356          case AST_FRAME_DTMF_BEGIN:
02357             break;
02358          case AST_FRAME_DTMF_END:
02359             res = f->subclass;
02360             ast_frfree(f);
02361             ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
02362             return res;
02363          case AST_FRAME_CONTROL:
02364             switch (f->subclass) {
02365             case AST_CONTROL_HANGUP:
02366                ast_frfree(f);
02367                ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
02368                return -1;
02369             case AST_CONTROL_RINGING:
02370             case AST_CONTROL_ANSWER:
02371             case AST_CONTROL_SRCUPDATE:
02372                /* Unimportant */
02373                break;
02374             default:
02375                ast_log(LOG_WARNING, "Unexpected control subclass '%d'\n", f->subclass);
02376                break;
02377             }
02378             break;
02379          case AST_FRAME_VOICE:
02380             /* Write audio if appropriate */
02381             if (audiofd > -1) {
02382                if (write(audiofd, f->data.ptr, f->datalen) < 0) {
02383                   ast_log(LOG_WARNING, "write() failed: %s\n", strerror(errno));
02384                }
02385             }
02386          default:
02387             /* Ignore */
02388             break;
02389          }
02390          ast_frfree(f);
02391       }
02392    }
02393 
02394    ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY);
02395 
02396    return 0; /* Time is up */
02397 }

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 1243 of file channel.c.

References chanlist::chan, and channel_find_locked().

Referenced by next_channel().

01245 {
01246    return channel_find_locked(chan, NULL, 0, context, exten);
01247 }

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 or uniqueid prefix (locks channel).

Definition at line 1230 of file channel.c.

References chanlist::chan, and channel_find_locked().

Referenced by my_ast_get_channel_by_name_locked(), next_channel(), and softhangup_exec().

01232 {
01233    return channel_find_locked(chan, name, namelen, NULL, NULL);
01234 }

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 3228 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_debug, ast_do_masquerade(), AST_FLAG_BLOCKING, AST_FLAG_WRITE_INT, AST_FLAG_ZOMBIE, AST_FORMAT_T140, 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, chanlist::chan, 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_WARNING, ast_channel::masq, ast_channel::masqr, ast_channel::monitor, ast_channel::name, ast_channel::outsmpl, ast_frame::ptr, ast_channel::rawwriteformat, SEEK_FORCECUR, send_dtmf_event(), 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_text, 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(), fax_generator_generate(), function_ilink(), gen_generate(), handle_jack_audio(), 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_link_keyquery(), send_tone_burst(), send_usb_txt(), send_waveform_to_channel(), silence_generator_generate(), spy_generate(), t38_tx_packet_handler(), and wait_for_answer().

03229 {
03230    int res = -1;
03231    struct ast_frame *f = NULL, *f2 = NULL;
03232    int count = 0;
03233 
03234    /*Deadlock avoidance*/
03235    while(ast_channel_trylock(chan)) {
03236       /*cannot goto done since the channel is not locked*/
03237       if(count++ > 10) {
03238          ast_debug(1, "Deadlock avoided for write to channel '%s'\n", chan->name);
03239          return 0;
03240       }
03241       usleep(1);
03242    }
03243    /* Stop if we're a zombie or need a soft hangup */
03244    if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan))
03245       goto done;
03246 
03247    /* Handle any pending masquerades */
03248    if (chan->masq && ast_do_masquerade(chan)) {
03249       ast_log(LOG_WARNING, "Failed to perform masquerade\n");
03250       goto done;
03251    }
03252    if (chan->masqr) {
03253       res = 0; /* XXX explain, why 0 ? */
03254       goto done;
03255    }
03256    if (chan->generatordata) {
03257       if (ast_test_flag(chan, AST_FLAG_WRITE_INT))
03258          ast_deactivate_generator(chan);
03259       else {
03260          if (fr->frametype == AST_FRAME_DTMF_END) {
03261             /* There is a generator running while we're in the middle of a digit.
03262              * It's probably inband DTMF, so go ahead and pass it so it can
03263              * stop the generator */
03264             ast_clear_flag(chan, AST_FLAG_BLOCKING);
03265             ast_channel_unlock(chan);
03266             res = ast_senddigit_end(chan, fr->subclass, fr->len);
03267             ast_channel_lock(chan);
03268             CHECK_BLOCKING(chan);
03269          } else if (fr->frametype == AST_FRAME_CONTROL && fr->subclass == AST_CONTROL_UNHOLD) {
03270             /* This is a side case where Echo is basically being called and the person put themselves on hold and took themselves off hold */
03271             res = (chan->tech->indicate == NULL) ? 0 :
03272                chan->tech->indicate(chan, fr->subclass, fr->data.ptr, fr->datalen);
03273          }
03274          res = 0; /* XXX explain, why 0 ? */
03275          goto done;
03276       }
03277    }
03278    /* High bit prints debugging */
03279    if (chan->fout & DEBUGCHAN_FLAG)
03280       ast_frame_dump(chan->name, fr, ">>");
03281    CHECK_BLOCKING(chan);
03282    switch (fr->frametype) {
03283    case AST_FRAME_CONTROL:
03284       res = (chan->tech->indicate == NULL) ? 0 :
03285          chan->tech->indicate(chan, fr->subclass, fr->data.ptr, fr->datalen);
03286       break;
03287    case AST_FRAME_DTMF_BEGIN:
03288       if (chan->audiohooks) {
03289          struct ast_frame *old_frame = fr;
03290          fr = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_WRITE, fr);
03291          if (old_frame != fr)
03292             f = fr;
03293       }
03294       send_dtmf_event(chan, "Sent", fr->subclass, "Yes", "No");
03295       ast_clear_flag(chan, AST_FLAG_BLOCKING);
03296       ast_channel_unlock(chan);
03297       res = ast_senddigit_begin(chan, fr->subclass);
03298       ast_channel_lock(chan);
03299       CHECK_BLOCKING(chan);
03300       break;
03301    case AST_FRAME_DTMF_END:
03302       if (chan->audiohooks) {
03303          struct ast_frame *old_frame = fr;
03304          fr = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_WRITE, fr);
03305          if (old_frame != fr)
03306             f = fr;
03307       }
03308       send_dtmf_event(chan, "Sent", fr->subclass, "No", "Yes");
03309       ast_clear_flag(chan, AST_FLAG_BLOCKING);
03310       ast_channel_unlock(chan);
03311       res = ast_senddigit_end(chan, fr->subclass, fr->len);
03312       ast_channel_lock(chan);
03313       CHECK_BLOCKING(chan);
03314       break;
03315    case AST_FRAME_TEXT:
03316       if (fr->subclass == AST_FORMAT_T140) {
03317          res = (chan->tech->write_text == NULL) ? 0 :
03318             chan->tech->write_text(chan, fr);
03319       } else {
03320          res = (chan->tech->send_text == NULL) ? 0 :
03321             chan->tech->send_text(chan, (char *) fr->data.ptr);
03322       }
03323       break;
03324    case AST_FRAME_HTML:
03325       res = (chan->tech->send_html == NULL) ? 0 :
03326          chan->tech->send_html(chan, fr->subclass, (char *) fr->data.ptr, fr->datalen);
03327       break;
03328    case AST_FRAME_VIDEO:
03329       /* XXX Handle translation of video codecs one day XXX */
03330       res = (chan->tech->write_video == NULL) ? 0 :
03331          chan->tech->write_video(chan, fr);
03332       break;
03333    case AST_FRAME_MODEM:
03334       res = (chan->tech->write == NULL) ? 0 :
03335          chan->tech->write(chan, fr);
03336       break;
03337    case AST_FRAME_VOICE:
03338       if (chan->tech->write == NULL)
03339          break;   /*! \todo XXX should return 0 maybe ? */
03340 
03341       /* If audiohooks are present, write the frame out */
03342       if (chan->audiohooks) {
03343          struct ast_frame *old_frame = fr;
03344          fr = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_WRITE, fr);
03345          if (old_frame != fr)
03346             f2 = fr;
03347       }
03348 
03349       /* If the frame is in the raw write format, then it's easy... just use the frame - otherwise we will have to translate */
03350       if (fr->subclass == chan->rawwriteformat)
03351          f = fr;
03352       else
03353          f = (chan->writetrans) ? ast_translate(chan->writetrans, fr, 0) : fr;
03354 
03355       if (!f) {
03356          res = 0;
03357          break;
03358       }
03359 
03360       /* If Monitor is running on this channel, then we have to write frames out there too */
03361       if (chan->monitor && chan->monitor->write_stream) {
03362          /* XXX must explain this code */
03363 #ifndef MONITOR_CONSTANT_DELAY
03364          int jump = chan->insmpl - chan->outsmpl - 4 * f->samples;
03365          if (jump >= 0) {
03366             jump = chan->insmpl - chan->outsmpl;
03367             if (ast_seekstream(chan->monitor->write_stream, jump, SEEK_FORCECUR) == -1)
03368                ast_log(LOG_WARNING, "Failed to perform seek in monitoring write stream, synchronization between the files may be broken\n");
03369             chan->outsmpl += jump + f->samples;
03370          } else
03371             chan->outsmpl += f->samples;
03372 #else
03373          int jump = chan->insmpl - chan->outsmpl;
03374          if (jump - MONITOR_DELAY >= 0) {
03375             if (ast_seekstream(chan->monitor->write_stream, jump - f->samples, SEEK_FORCECUR) == -1)
03376                ast_log(LOG_WARNING, "Failed to perform seek in monitoring write stream, synchronization between the files may be broken\n");
03377             chan->outsmpl += jump;
03378          } else
03379             chan->outsmpl += f->samples;
03380 #endif
03381          if (chan->monitor->state == AST_MONITOR_RUNNING) {
03382             if (ast_writestream(chan->monitor->write_stream, f) < 0)
03383                ast_log(LOG_WARNING, "Failed to write data to channel monitor write stream\n");
03384          }
03385       }
03386 
03387       if (f) 
03388          res = chan->tech->write(chan,f);
03389       else
03390          res = 0;
03391       break;
03392    case AST_FRAME_NULL:
03393    case AST_FRAME_IAX:
03394       /* Ignore these */
03395       res = 0;
03396       break;
03397    default:
03398       /* At this point, fr is the incoming frame and f is NULL.  Channels do
03399        * not expect to get NULL as a frame pointer and will segfault.  Hence,
03400        * we output the original frame passed in. */
03401       res = chan->tech->write(chan, fr);
03402       break;
03403    }
03404 
03405    if (f && f != fr)
03406       ast_frfree(f);
03407    if (f2)
03408       ast_frfree(f2);
03409    ast_clear_flag(chan, AST_FLAG_BLOCKING);
03410    /* Consider a write failure to force a soft hangup */
03411    if (res < 0)
03412       chan->_softhangup |= AST_SOFTHANGUP_DEV;
03413    else {
03414       chan->fout = FRAMECOUNT_INC(chan->fout);
03415    }
03416 done:
03417    ast_channel_unlock(chan);
03418    return res;
03419 }

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 3217 of file channel.c.

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

03218 {
03219    int res;
03220    if (!chan->tech->write_video)
03221       return 0;
03222    res = ast_write(chan, fr);
03223    if (!res)
03224       res = 1;
03225    return res;
03226 }

static void bridge_play_sounds ( struct ast_channel c0,
struct ast_channel c1 
) [static]

Definition at line 4646 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_strdupa, bridge_playfile(), pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), and s.

Referenced by ast_channel_bridge().

04647 {
04648    const char *s, *sound;
04649 
04650    /* See if we need to play an audio file to any side of the bridge */
04651 
04652    ast_channel_lock(c0);
04653    if ((s = pbx_builtin_getvar_helper(c0, "BRIDGE_PLAY_SOUND"))) {
04654       sound = ast_strdupa(s);
04655       ast_channel_unlock(c0);
04656       bridge_playfile(c0, c1, sound, 0);
04657       pbx_builtin_setvar_helper(c0, "BRIDGE_PLAY_SOUND", NULL);
04658    } else {
04659       ast_channel_unlock(c0);
04660    }
04661 
04662    ast_channel_lock(c1);
04663    if ((s = pbx_builtin_getvar_helper(c1, "BRIDGE_PLAY_SOUND"))) {
04664       sound = ast_strdupa(s);
04665       ast_channel_unlock(c1);
04666       bridge_playfile(c1, c0, sound, 0);
04667       pbx_builtin_setvar_helper(c1, "BRIDGE_PLAY_SOUND", NULL);
04668    } else {
04669       ast_channel_unlock(c1);
04670    }
04671 }

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

Definition at line 4381 of file channel.c.

References ast_autoservice_start(), ast_autoservice_stop(), AST_DIGIT_ANY, ast_say_number(), ast_stream_and_wait(), chanlist::chan, and sec.

Referenced by ast_channel_bridge(), and bridge_play_sounds().

04382 {
04383    int min = 0, sec = 0, check;
04384 
04385    check = ast_autoservice_start(peer);
04386    if (check)
04387       return;
04388 
04389    if (remain > 0) {
04390       if (remain / 60 > 1) {
04391          min = remain / 60;
04392          sec = remain % 60;
04393       } else {
04394          sec = remain;
04395       }
04396    }
04397    
04398    if (!strcmp(sound,"timeleft")) { /* Queue support */
04399       ast_stream_and_wait(chan, "vm-youhave", "");
04400       if (min) {
04401          ast_say_number(chan, min, AST_DIGIT_ANY, chan->language, NULL);
04402          ast_stream_and_wait(chan, "queue-minutes", "");
04403       }
04404       if (sec) {
04405          ast_say_number(chan, sec, AST_DIGIT_ANY, chan->language, NULL);
04406          ast_stream_and_wait(chan, "queue-seconds", "");
04407       }
04408    } else {
04409       ast_stream_and_wait(chan, sound, "");
04410    }
04411 
04412    ast_autoservice_stop(peer);
04413 }

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 1128 of file channel.c.

References ast_channel_trylock, ast_debug, AST_RWLIST_NEXT, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_channel::context, ast_channel::exten, ast_channel::macrocontext, ast_channel::macroexten, msg, ast_channel::name, and ast_channel::uniqueid.

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().

01131 {
01132    const char *msg = prev ? "deadlock" : "initial deadlock";
01133    int retries;
01134    struct ast_channel *c;
01135    const struct ast_channel *_prev = prev;
01136 
01137    for (retries = 0; retries < 200; retries++) {
01138       int done;
01139       /* Reset prev on each retry.  See note below for the reason. */
01140       prev = _prev;
01141       AST_RWLIST_RDLOCK(&channels);
01142       AST_RWLIST_TRAVERSE(&channels, c, chan_list) {
01143          if (prev) { /* look for last item, first, before any evaluation */
01144             if (c != prev) /* not this one */
01145                continue;
01146             /* found, prepare to return c->next */
01147             if ((c = AST_RWLIST_NEXT(c, chan_list)) == NULL) break;
01148             /*!\note
01149              * We're done searching through the list for the previous item.
01150              * Any item after this point, we want to evaluate for a match.
01151              * If we didn't set prev to NULL here, then we would only
01152              * return matches for the first matching item (since the above
01153              * "if (c != prev)" would not permit any other potential
01154              * matches to reach the additional matching logic, below).
01155              * Instead, it would just iterate until it once again found the
01156              * original match, then iterate down to the end of the list and
01157              * quit.
01158              */
01159             prev = NULL;
01160          }
01161          if (name) { /* want match by name */
01162             if ((!namelen && strcasecmp(c->name, name) && strcmp(c->uniqueid, name)) ||
01163                 (namelen && strncasecmp(c->name, name, namelen)))
01164                continue;   /* name match failed */
01165          } else if (exten) {
01166             if (context && strcasecmp(c->context, context) &&
01167                 strcasecmp(c->macrocontext, context))
01168                continue;   /* context match failed */
01169             if (strcasecmp(c->exten, exten) &&
01170                 strcasecmp(c->macroexten, exten))
01171                continue;   /* exten match failed */
01172          }
01173          /* if we get here, c points to the desired record */
01174          break;
01175       }
01176       /* exit if chan not found or mutex acquired successfully */
01177       /* this is slightly unsafe, as we _should_ hold the lock to access c->name */
01178       done = c == NULL || ast_channel_trylock(c) == 0;
01179       if (!done) {
01180          ast_debug(1, "Avoiding %s for channel '%p'\n", msg, c);
01181          if (retries == 199) {
01182             /* We are about to fail due to a deadlock, so report this
01183              * while we still have the list lock.
01184              */
01185             ast_debug(1, "Failure, could not lock '%p' after %d retries!\n", c, retries);
01186             /* As we have deadlocked, we will skip this channel and
01187              * see if there is another match.
01188              * NOTE: No point doing this for a full-name match,
01189              * as there can be no more matches.
01190              */
01191             if (!(name && !namelen)) {
01192                prev = c;
01193                retries = -1;
01194             }
01195          }
01196       }
01197       AST_RWLIST_UNLOCK(&channels);
01198       if (done)
01199          return c;
01200       /* If we reach this point we basically tried to lock a channel and failed. Instead of
01201        * starting from the beginning of the list we can restore our saved pointer to the previous
01202        * channel and start from there.
01203        */
01204       prev = _prev;
01205       usleep(1);  /* give other threads a chance before retrying */
01206    }
01207 
01208    return NULL;
01209 }

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 5299 of file channel.c.

References CHANNEL_CLI_RELOAD, CHANNEL_MODULE_LOAD, and CHANNEL_MODULE_RELOAD.

05300 {
05301    switch (reason) {
05302    case CHANNEL_MODULE_LOAD:
05303       return "LOAD (Channel module load)";
05304 
05305    case CHANNEL_MODULE_RELOAD:
05306       return "RELOAD (Channel module reload)";
05307 
05308    case CHANNEL_CLI_RELOAD:
05309       return "CLIRELOAD (Channel module reload by CLI command)";
05310 
05311    default:
05312       return "MANAGERRELOAD (Channel module reload by manager)";
05313    }
05314 };

static void clone_variables ( struct ast_channel original,
struct ast_channel clonechan 
) [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 4004 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().

04005 {
04006    struct ast_var_t *current, *newvar;
04007    /* Append variables from clone channel into original channel */
04008    /* XXX Is this always correct?  We have to in order to keep MACROS working XXX */
04009    if (AST_LIST_FIRST(&clonechan->varshead))
04010       AST_LIST_APPEND_LIST(&original->varshead, &clonechan->varshead, entries);
04011 
04012    /* then, dup the varshead list into the clone */
04013    
04014    AST_LIST_TRAVERSE(&original->varshead, current, entries) {
04015       newvar = ast_var_assign(current->name, current->value);
04016       if (newvar)
04017          AST_LIST_INSERT_TAIL(&clonechan->varshead, newvar, entries);
04018    }
04019 }

static char* complete_channeltypes ( struct ast_cli_args a  )  [static]

Definition at line 245 of file channel.c.

References AST_LIST_TRAVERSE, ast_strdup, chanlist::list, ast_cli_args::n, ast_cli_args::pos, chanlist::tech, ast_channel_tech::type, and ast_cli_args::word.

Referenced by handle_cli_core_show_channeltype().

00246 {
00247    struct chanlist *cl;
00248    int which = 0;
00249    int wordlen;
00250    char *ret = NULL;
00251 
00252    if (a->pos != 3)
00253       return NULL;
00254 
00255    wordlen = strlen(a->word);
00256 
00257    AST_LIST_TRAVERSE(&backends, cl, list) {
00258       if (!strncasecmp(a->word, cl->tech->type, wordlen) && ++which > a->n) {
00259          ret = ast_strdup(cl->tech->type);
00260          break;
00261       }
00262    }
00263    
00264    return ret;
00265 }

static void free_cid ( struct ast_callerid cid  )  [static]

Definition at line 1276 of file channel.c.

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

Referenced by ast_channel_free().

01277 {
01278    if (cid->cid_dnid)
01279       ast_free(cid->cid_dnid);
01280    if (cid->cid_num)
01281       ast_free(cid->cid_num); 
01282    if (cid->cid_name)
01283       ast_free(cid->cid_name);   
01284    if (cid->cid_ani)
01285       ast_free(cid->cid_ani);
01286    if (cid->cid_rdnis)
01287       ast_free(cid->cid_rdnis);
01288    cid->cid_dnid = cid->cid_num = cid->cid_name = cid->cid_ani = cid->cid_rdnis = NULL;
01289 }

static void free_translation ( struct ast_channel clonechan  )  [static]

Definition at line 1571 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().

01572 {
01573    if (clonechan->writetrans)
01574       ast_translator_free_path(clonechan->writetrans);
01575    if (clonechan->readtrans)
01576       ast_translator_free_path(clonechan->readtrans);
01577    clonechan->writetrans = NULL;
01578    clonechan->readtrans = NULL;
01579    clonechan->rawwriteformat = clonechan->nativeformats;
01580    clonechan->rawreadformat = clonechan->nativeformats;
01581 }

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

Definition at line 1853 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_deactivate_generator(), ast_debug, AST_FORMAT_AUDIO_MASK, ast_format_rate(), and chanlist::chan.

Referenced by ast_activate_generator(), and ast_read_generator_actions().

01854 {
01855    /* Called if generator doesn't have data */
01856    void *tmp;
01857    int res;
01858    int (*generate)(struct ast_channel *chan, void *tmp, int datalen, int samples) = NULL;
01859    struct ast_channel *chan = (struct ast_channel *)data;
01860 
01861    ast_channel_lock(chan);
01862    tmp = chan->generatordata;
01863    chan->generatordata = NULL;
01864    if (chan->generator)
01865       generate = chan->generator->generate;
01866    ast_channel_unlock(chan);
01867 
01868    if (!tmp || !generate)
01869       return 0;
01870 
01871    res = generate(chan, tmp, 0, ast_format_rate(chan->writeformat & AST_FORMAT_AUDIO_MASK) / 50);
01872 
01873    chan->generatordata = tmp;
01874 
01875    if (res) {
01876       ast_debug(1, "Auto-deactivating generator\n");
01877       ast_deactivate_generator(chan);
01878    }
01879 
01880    return 0;
01881 }

static char* handle_cli_core_show_channeltype ( struct ast_cli_entry e,
int  cmd,
struct ast_cli_args a 
) [static]

Show details about a channel driver - CLI command.

Definition at line 268 of file channel.c.

References ast_cli_args::argc, ast_cli_args::argv, ast_cli(), AST_LIST_TRAVERSE, AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, ast_channel_tech::capabilities, CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, complete_channeltypes(), ast_channel_tech::devicestate, ast_cli_args::fd, ast_channel_tech::indicate, chanlist::list, 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, ast_channel_tech::type, and ast_cli_entry::usage.

00269 {
00270    struct chanlist *cl = NULL;
00271 
00272    switch (cmd) {
00273    case CLI_INIT:
00274       e->command = "core show channeltype";
00275       e->usage =
00276          "Usage: core show channeltype <name>\n"
00277          "  Show details about the specified channel type, <name>.\n";
00278       return NULL;
00279    case CLI_GENERATE:
00280       return complete_channeltypes(a);
00281    }
00282 
00283    if (a->argc != 4)
00284       return CLI_SHOWUSAGE;
00285    
00286    AST_RWLIST_RDLOCK(&channels);
00287 
00288    AST_LIST_TRAVERSE(&backends, cl, list) {
00289       if (!strncasecmp(cl->tech->type, a->argv[3], strlen(cl->tech->type)))
00290          break;
00291    }
00292 
00293 
00294    if (!cl) {
00295       ast_cli(a->fd, "\n%s is not a registered channel driver.\n", a->argv[3]);
00296       AST_RWLIST_UNLOCK(&channels);
00297       return CLI_FAILURE;
00298    }
00299 
00300    ast_cli(a->fd,
00301       "-- Info about channel driver: %s --\n"
00302       "  Device State: %s\n"
00303       "    Indication: %s\n"
00304       "     Transfer : %s\n"
00305       "  Capabilities: %d\n"
00306       "   Digit Begin: %s\n"
00307       "     Digit End: %s\n"
00308       "    Send HTML : %s\n"
00309       " Image Support: %s\n"
00310       "  Text Support: %s\n",
00311       cl->tech->type,
00312       (cl->tech->devicestate) ? "yes" : "no",
00313       (cl->tech->indicate) ? "yes" : "no",
00314       (cl->tech->transfer) ? "yes" : "no",
00315       (cl->tech->capabilities) ? cl->tech->capabilities : -1,
00316       (cl->tech->send_digit_begin) ? "yes" : "no",
00317       (cl->tech->send_digit_end) ? "yes" : "no",
00318       (cl->tech->send_html) ? "yes" : "no",
00319       (cl->tech->send_image) ? "yes" : "no",
00320       (cl->tech->send_text) ? "yes" : "no"
00321       
00322    );
00323 
00324    AST_RWLIST_UNLOCK(&channels);
00325    return CLI_SUCCESS;
00326 }

static char* handle_cli_core_show_channeltypes ( struct ast_cli_entry e,
int  cmd,
struct ast_cli_args a 
) [static]

Show channel types - CLI command.

Definition at line 202 of file channel.c.

References ast_cli_args::argc, ast_cli(), AST_LIST_TRAVERSE, AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_channel_tech::description, ast_channel_tech::devicestate, ast_cli_args::fd, FORMAT, ast_channel_tech::indicate, chanlist::list, chanlist::tech, ast_channel_tech::transfer, ast_channel_tech::type, and ast_cli_entry::usage.

00203 {
00204 #define FORMAT  "%-10.10s  %-40.40s %-12.12s %-12.12s %-12.12s\n"
00205    struct chanlist *cl;
00206    int count_chan = 0;
00207 
00208    switch (cmd) {
00209    case CLI_INIT:
00210       e->command = "core show channeltypes";
00211       e->usage =
00212          "Usage: core show channeltypes\n"
00213          "       Lists available channel types registered in your\n"
00214          "       Asterisk server.\n";
00215       return NULL;
00216    case CLI_GENERATE:
00217       return NULL;
00218    }
00219 
00220    if (a->argc != 3)
00221       return CLI_SHOWUSAGE;
00222 
00223    ast_cli(a->fd, FORMAT, "Type", "Description",       "Devicestate", "Indications", "Transfer");
00224    ast_cli(a->fd, FORMAT, "----------", "-----------", "-----------", "-----------", "--------");
00225 
00226    AST_RWLIST_RDLOCK(&channels);
00227 
00228    AST_LIST_TRAVERSE(&backends, cl, list) {
00229       ast_cli(a->fd, FORMAT, cl->tech->type, cl->tech->description,
00230          (cl->tech->devicestate) ? "yes" : "no",
00231          (cl->tech->indicate) ? "yes" : "no",
00232          (cl->tech->transfer) ? "yes" : "no");
00233       count_chan++;
00234    }
00235 
00236    AST_RWLIST_UNLOCK(&channels);
00237 
00238    ast_cli(a->fd, "----------\n%d channel drivers registered.\n", count_chan);
00239 
00240    return CLI_SUCCESS;
00241 
00242 #undef FORMAT
00243 }

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

Definition at line 2954 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_T38, AST_CONTROL_TAKEOFFHOOK, AST_CONTROL_UNHOLD, AST_CONTROL_VIDUPDATE, and AST_CONTROL_WINK.

Referenced by ast_indicate_data().

02955 {
02956    /* Don't include a default case here so that we get compiler warnings
02957     * when a new type is added. */
02958 
02959    switch (condition) {
02960    case AST_CONTROL_PROGRESS:
02961    case AST_CONTROL_PROCEEDING:
02962    case AST_CONTROL_VIDUPDATE:
02963    case AST_CONTROL_SRCUPDATE:
02964    case AST_CONTROL_RADIO_KEY:
02965    case AST_CONTROL_RADIO_UNKEY:
02966    case AST_CONTROL_OPTION:
02967    case AST_CONTROL_WINK:
02968    case AST_CONTROL_FLASH:
02969    case AST_CONTROL_OFFHOOK:
02970    case AST_CONTROL_TAKEOFFHOOK:
02971    case AST_CONTROL_ANSWER:
02972    case AST_CONTROL_HANGUP:
02973    case AST_CONTROL_T38:
02974       return 0;
02975 
02976    case AST_CONTROL_CONGESTION:
02977    case AST_CONTROL_BUSY:
02978    case AST_CONTROL_RINGING:
02979    case AST_CONTROL_RING:
02980    case AST_CONTROL_HOLD:
02981    case AST_CONTROL_UNHOLD:
02982       return 1;
02983    }
02984 
02985    return 0;
02986 }

static void manager_bridge_event ( int  onoff,
int  type,
struct ast_channel c0,
struct ast_channel c1 
) [static]

Send manager event for bridge link and unlink events.

Parameters:
onoff Link/Unlinked
type 1 for core, 2 for native
c0 first channel in bridge
c1 second channel in bridge

Definition at line 4591 of file channel.c.

References ast_channel::cid, ast_callerid::cid_num, EVENT_FLAG_CALL, manager_event, ast_channel::name, S_OR, and ast_channel::uniqueid.

Referenced by ast_channel_bridge().

04592 {
04593    manager_event(EVENT_FLAG_CALL, "Bridge",
04594          "Bridgestate: %s\r\n"
04595            "Bridgetype: %s\r\n"
04596             "Channel1: %s\r\n"
04597             "Channel2: %s\r\n"
04598             "Uniqueid1: %s\r\n"
04599             "Uniqueid2: %s\r\n"
04600             "CallerID1: %s\r\n"
04601             "CallerID2: %s\r\n",
04602          onoff ? "Link" : "Unlink",
04603          type == 1 ? "core" : "native",
04604          c0->name, c1->name, c0->uniqueid, c1->uniqueid, 
04605          S_OR(c0->cid.cid_num, ""), 
04606          S_OR(c1->cid.cid_num, ""));
04607 }

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

Definition at line 2463 of file channel.c.

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

Referenced by __ast_read().

02464 {
02465    struct ast_frame *fr = &chan->dtmff;
02466 
02467    fr->frametype = AST_FRAME_DTMF_END;
02468    fr->subclass = f->subclass;
02469    fr->len = f->len;
02470 
02471    /* The only time this function will be called is for a frame that just came
02472     * out of the channel driver.  So, we want to stick it on the tail of the
02473     * readq. */
02474 
02475    ast_queue_frame(chan, fr);
02476 }

static void send_dtmf_event ( const struct ast_channel chan,
const char *  direction,
const char  digit,
const char *  begin,
const char *  end 
) [static]

Definition at line 2399 of file channel.c.

References chanlist::chan, EVENT_FLAG_DTMF, manager_event, ast_channel::name, and ast_channel::uniqueid.

Referenced by __ast_read(), and ast_write().

02400 {
02401    manager_event(EVENT_FLAG_DTMF,
02402          "DTMF",
02403          "Channel: %s\r\n"
02404          "Uniqueid: %s\r\n"
02405          "Digit: %c\r\n"
02406          "Direction: %s\r\n"
02407          "Begin: %s\r\n"
02408          "End: %s\r\n",
02409          chan->name, chan->uniqueid, digit, direction, begin, end);
02410 }

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 3421 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_debug, AST_FORMAT_AUDIO_MASK, ast_getformatname(), ast_getformatname_multiple(), ast_log(), ast_translator_best_choice(), ast_translator_build_path(), ast_translator_free_path(), chanlist::chan, LOG_WARNING, ast_channel::name, and ast_channel::nativeformats.

Referenced by ast_set_read_format(), and ast_set_write_format().

03423 {
03424    int native;
03425    int res;
03426    char from[200], to[200];
03427    
03428    /* Make sure we only consider audio */
03429    fmt &= AST_FORMAT_AUDIO_MASK;
03430    
03431    native = chan->nativeformats;
03432 
03433    if (!fmt || !native) /* No audio requested */
03434       return 0;   /* Let's try a call without any sounds (video, text) */
03435    
03436    /* Find a translation path from the native format to one of the desired formats */
03437    if (!direction)
03438       /* reading */
03439       res = ast_translator_best_choice(&fmt, &native);
03440    else
03441       /* writing */
03442       res = ast_translator_best_choice(&native, &fmt);
03443 
03444    if (res < 0) {
03445       ast_log(LOG_WARNING, "Unable to find a codec translation path from %s to %s\n",
03446          ast_getformatname_multiple(from, sizeof(from), native),
03447          ast_getformatname_multiple(to, sizeof(to), fmt));
03448       return -1;
03449    }
03450    
03451    /* Now we have a good choice for both. */
03452    ast_channel_lock(chan);
03453 
03454    if ((*rawformat == native) && (*format == fmt) && ((*rawformat == *format) || (*trans))) {
03455       /* the channel is already in these formats, so nothing to do */
03456       ast_channel_unlock(chan);
03457       return 0;
03458    }
03459 
03460    *rawformat = native;
03461    /* User perspective is fmt */
03462    *format = fmt;
03463    /* Free any read translation we have right now */
03464    if (*trans)
03465       ast_translator_free_path(*trans);
03466    /* Build a translation path from the raw format to the desired format */
03467    if (!direction)
03468       /* reading */
03469       *trans = ast_translator_build_path(*format, *rawformat);
03470    else
03471       /* writing */
03472       *trans = ast_translator_build_path(*rawformat, *format);
03473    ast_channel_unlock(chan);
03474    ast_debug(1, "Set channel %s to %s format %s\n", chan->name,
03475       direction ? "write" : "read", ast_getformatname(fmt));
03476    return 0;
03477 }

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 2481 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(), chanlist::chan, and ast_channel::dtmf_tv.

Referenced by __ast_read().

02482 {
02483    if (ast_test_flag(chan, AST_FLAG_DEFER_DTMF | AST_FLAG_EMULATE_DTMF)) {
02484       /* We're in the middle of emulating a digit, or DTMF has been
02485        * explicitly deferred.  Skip this digit, then. */
02486       return 1;
02487    }
02488          
02489    if (!ast_tvzero(chan->dtmf_tv) && 
02490          ast_tvdiff_ms(ast_tvnow(), chan->dtmf_tv) < AST_MIN_DTMF_GAP) {
02491       /* We're not in the middle of a digit, but it hasn't been long enough
02492        * since the last digit, so we'll have to skip DTMF for now. */
02493       return 1;
02494    }
02495 
02496    return 0;
02497 }

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

Definition at line 5219 of file channel.c.

05220 {
05221    /* just store the data pointer in the channel structure */
05222    return data;
05223 }

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

Definition at line 5230 of file channel.c.

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

05231 {
05232    short buf[samples];
05233    struct ast_frame frame = {
05234       .frametype = AST_FRAME_VOICE,
05235       .subclass = AST_FORMAT_SLINEAR,
05236       .data.ptr = buf,
05237       .samples = samples,
05238       .datalen = sizeof(buf),
05239    };
05240 
05241    memset(buf, 0, sizeof(buf));
05242 
05243    if (ast_write(chan, &frame))
05244       return -1;
05245 
05246    return 0;
05247 }

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

Definition at line 5225 of file channel.c.

05226 {
05227    /* nothing to do */
05228 }

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

Definition at line 4986 of file channel.c.

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

04987 {
04988    struct tonepair_state *ts;
04989    struct tonepair_def *td = params;
04990 
04991    if (!(ts = ast_calloc(1, sizeof(*ts))))
04992       return NULL;
04993    ts->origwfmt = chan->writeformat;
04994    if (ast_set_write_format(chan, AST_FORMAT_SLINEAR)) {
04995       ast_log(LOG_WARNING, "Unable to set '%s' to signed linear format (write)\n", chan->name);
04996       tonepair_release(NULL, ts);
04997       ts = NULL;
04998    } else {
04999       ts->fac1 = 2.0 * cos(2.0 * M_PI * (td->freq1 / 8000.0)) * 32768.0;
05000       ts->v1_1 = 0;
05001       ts->v2_1 = sin(-4.0 * M_PI * (td->freq1 / 8000.0)) * td->vol;
05002       ts->v3_1 = sin(-2.0 * M_PI * (td->freq1 / 8000.0)) * td->vol;
05003       ts->v2_1 = 0;
05004       ts->fac2 = 2.0 * cos(2.0 * M_PI * (td->freq2 / 8000.0)) * 32768.0;
05005       ts->v2_2 = sin(-4.0 * M_PI * (td->freq2 / 8000.0)) * td->vol;
05006       ts->v3_2 = sin(-2.0 * M_PI * (td->freq2 / 8000.0)) * td->vol;
05007       ts->duration = td->duration;
05008       ts->modulate = 0;
05009    }
05010    /* Let interrupts interrupt :) */
05011    ast_set_flag(chan, AST_FLAG_WRITE_INT);
05012    return ts;
05013 }

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

Definition at line 5015 of file channel.c.

References ast_log(), tonepair_state::data, tonepair_state::f, tonepair_state::fac1, tonepair_state::fac2, LOG_WARNING, 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.

05016 {
05017    struct tonepair_state *ts = data;
05018    int x;
05019 
05020    /* we need to prepare a frame with 16 * timelen samples as we're
05021     * generating SLIN audio
05022     */
05023    len = samples * 2;
05024 
05025    if (len > sizeof(ts->data) / 2 - 1) {
05026       ast_log(LOG_WARNING, "Can't generate that much data!\n");
05027       return -1;
05028    }
05029    memset(&ts->f, 0, sizeof(ts->f));
05030    for (x=0;x<len/2;x++) {
05031       ts->v1_1 = ts->v2_1;
05032       ts->v2_1 = ts->v3_1;
05033       ts->v3_1 = (ts->fac1 * ts->v2_1 >> 15) - ts->v1_1;
05034       
05035       ts->v1_2 = ts->v2_2;
05036       ts->v2_2 = ts->v3_2;
05037       ts->v3_2 = (ts->fac2 * ts->v2_2 >> 15) - ts->v1_2;
05038       if (ts->modulate) {
05039          int p;
05040          p = ts->v3_2 - 32768;
05041          if (p < 0) p = -p;
05042          p = ((p * 9) / 10) + 1;
05043          ts->data[x] = (ts->v3_1 * p) >> 15;
05044       } else
05045          ts->data[x] = ts->v3_1 + ts->v3_2; 
05046    }
05047    ts->f.frametype = AST_FRAME_VOICE;
05048    ts->f.subclass = AST_FORMAT_SLINEAR;
05049    ts->f.datalen = len;
05050    ts->f.samples = samples;
05051    ts->f.offset = AST_FRIENDLY_OFFSET;
05052    ts->f.data.ptr = ts->data;
05053    ast_write(chan, &ts->f);
05054    ts->pos += x;
05055    if (ts->duration > 0) {
05056       if (ts->pos >= ts->duration * 8)
05057          return -1;
05058    }
05059    return 0;
05060 }

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

Definition at line 4977 of file channel.c.

References ast_free, ast_set_write_format(), chan, and tonepair_state::origwfmt.

Referenced by tonepair_alloc().

04978 {
04979    struct tonepair_state *ts = params;
04980 
04981    if (chan)
04982       ast_set_write_format(chan, ts->origwfmt);
04983    ast_free(ts);
04984 }

static void update_bridge_vars ( struct ast_channel c0,
struct ast_channel c1 
) [static]

Definition at line 4609 of file channel.c.

References ast_channel_lock, ast_channel_unlock, ast_strdupa, ast_strlen_zero(), ast_channel_tech::get_pvt_uniqueid, ast_channel::name, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), and ast_channel::tech.

Referenced by ast_channel_bridge().

04610 {
04611    const char *c0_name;
04612    const char *c1_name;
04613    const char *c0_pvtid = NULL;
04614    const char *c1_pvtid = NULL;
04615 
04616    ast_channel_lock(c1);
04617    c1_name = ast_strdupa(c1->name);
04618    if (c1->tech->get_pvt_uniqueid) {
04619       c1_pvtid = ast_strdupa(c1->tech->get_pvt_uniqueid(c1));
04620    }
04621    ast_channel_unlock(c1);
04622 
04623    ast_channel_lock(c0);
04624    if (!ast_strlen_zero(pbx_builtin_getvar_helper(c0, "BRIDGEPEER"))) {
04625       pbx_builtin_setvar_helper(c0, "BRIDGEPEER", c1_name);
04626    }
04627    if (c1_pvtid) {
04628       pbx_builtin_setvar_helper(c0, "BRIDGEPVTCALLID", c1_pvtid);
04629    }
04630    c0_name = ast_strdupa(c0->name);
04631    if (c0->tech->get_pvt_uniqueid) {
04632       c0_pvtid = ast_strdupa(c0->tech->get_pvt_uniqueid(c0));
04633    }
04634    ast_channel_unlock(c0);
04635 
04636    ast_channel_lock(c1);
04637    if (!ast_strlen_zero(pbx_builtin_getvar_helper(c1, "BRIDGEPEER"))) {
04638       pbx_builtin_setvar_helper(c1, "BRIDGEPEER", c0_name);
04639    }
04640    if (c0_pvtid) {
04641       pbx_builtin_setvar_helper(c1, "BRIDGEPVTCALLID", c0_pvtid);
04642    }
04643    ast_channel_unlock(c1);
04644 }


Variable Documentation

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

Definition at line 5138 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 5136 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 5137 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

causes.h

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

struct ast_cli_entry cli_channel[] [static]

Initial value:

 {
   { .handler =  handle_cli_core_show_channeltypes , .summary =  "List available channel types" ,__VA_ARGS__ },
   { .handler =  handle_cli_core_show_channeltype , .summary =  "Give more details on that channel type" ,__VA_ARGS__ }
}

Definition at line 328 of file channel.c.

Referenced by ast_channels_init().

unsigned long global_fin

The current value of the debug flags is stored in the two variables global_fin and global_fout (declared in main/channel.c)

Definition at line 85 of file channel.c.

Referenced by handle_core_set_debug_channel().

unsigned long global_fout

Definition at line 85 of file channel.c.

Referenced by handle_core_set_debug_channel().

struct ast_channel_tech null_tech [static]

Initial value:

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

Definition at line 763 of file channel.c.

Referenced by ast_channel_alloc().

int shutting_down [static]

Prevent new channel allocation if shutting down.

Definition at line 81 of file channel.c.

struct ast_generator silence_generator [static]

Initial value:

Definition at line 5249 of file channel.c.

Referenced by ast_channel_start_silence_generator().

struct ast_threadstorage state2str_threadbuf = { .once = PTHREAD_ONCE_INIT, .key_init = __init_state2str_threadbuf , .custom_init = NULL , } [static]

Definition at line 87 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 5062 of file channel.c.

Referenced by ast_tonepair_start().

int uniqueint [static]

Definition at line 83 of file channel.c.


Generated on Fri Jun 19 12:10:29 2009 for Asterisk - the Open Source PBX by  doxygen 1.4.7