#include "asterisk.h"
#include <stdio.h>
#include <stdlib.h>
#include <stdarg.h>
#include <string.h>
#include <sys/time.h>
#include <signal.h>
#include <errno.h>
#include <unistd.h>
#include <math.h>
#include "asterisk/pbx.h"
#include "asterisk/frame.h"
#include "asterisk/sched.h"
#include "asterisk/options.h"
#include "asterisk/channel.h"
#include "asterisk/audiohook.h"
#include "asterisk/musiconhold.h"
#include "asterisk/logger.h"
#include "asterisk/say.h"
#include "asterisk/file.h"
#include "asterisk/cli.h"
#include "asterisk/translate.h"
#include "asterisk/manager.h"
#include "asterisk/chanvars.h"
#include "asterisk/linkedlists.h"
#include "asterisk/indications.h"
#include "asterisk/monitor.h"
#include "asterisk/causes.h"
#include "asterisk/callerid.h"
#include "asterisk/utils.h"
#include "asterisk/lock.h"
#include "asterisk/app.h"
#include "asterisk/transcap.h"
#include "asterisk/devicestate.h"
#include "asterisk/sha1.h"
#include "asterisk/threadstorage.h"
#include "asterisk/slinfactory.h"
Go to the source code of this file.
Data Structures | |
struct | ast_cause |
struct | ast_silence_generator |
struct | backends |
struct | chanlist |
struct | channels |
struct | tonepair_def |
struct | tonepair_state |
Defines | |
#define | AST_DEFAULT_EMULATE_DTMF_DURATION 100 |
#define | AST_MIN_DTMF_DURATION 80 |
#define | AST_MIN_DTMF_GAP 45 |
#define | FORMAT "%-10.10s %-40.40s %-12.12s %-12.12s %-12.12s\n" |
#define | MONITOR_CONSTANT_DELAY |
#define | MONITOR_DELAY 150 * 8 |
#define | STATE2STR_BUFSIZE 32 |
Functions | |
static int | __ast_queue_frame (struct ast_channel *chan, struct ast_frame *fin, int head) |
Queue an outgoing media frame. | |
static struct ast_frame * | __ast_read (struct ast_channel *chan, int dropaudio) |
ast_channel * | __ast_request_and_dial (const char *type, int format, void *data, int timeout, int *outstate, const char *cid_num, const char *cid_name, struct outgoing_helper *oh) |
int | ast_activate_generator (struct ast_channel *chan, struct ast_generator *gen, void *params) |
int | ast_active_channels (void) |
returns number of active/allocated channels | |
int | ast_answer (struct ast_channel *chan) |
Answer a ringing call. | |
void | ast_begin_shutdown (int hangup) |
Initiate system shutdown. | |
int | ast_best_codec (int fmts) |
Pick the best audio codec. | |
ast_channel * | ast_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_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. | |
enum ast_bridge_result | ast_channel_bridge (struct ast_channel *c0, struct ast_channel *c1, struct ast_bridge_config *config, struct ast_frame **fo, struct ast_channel **rc) |
Bridge two channels together. | |
int | ast_channel_cmpwhentohangup (struct ast_channel *chan, time_t offset) |
Compare a offset with the settings of when to hang a channel up. | |
int | ast_channel_datastore_add (struct ast_channel *chan, struct ast_datastore *datastore) |
Add a datastore to a channel. | |
ast_datastore * | ast_channel_datastore_alloc (const struct ast_datastore_info *info, char *uid) |
Create a channel datastore structure. | |
ast_datastore * | ast_channel_datastore_find (struct ast_channel *chan, const struct ast_datastore_info *info, char *uid) |
Find a datastore on a channel. | |
int | ast_channel_datastore_free (struct ast_datastore *datastore) |
Free a channel datastore structure. | |
int | ast_channel_datastore_inherit (struct ast_channel *from, struct ast_channel *to) |
Inherit datastores from a parent to a child. | |
int | ast_channel_datastore_remove (struct ast_channel *chan, struct ast_datastore *datastore) |
Remove a datastore from a channel. | |
int | ast_channel_defer_dtmf (struct ast_channel *chan) |
Set defer DTMF flag on channel. | |
void | ast_channel_free (struct ast_channel *chan) |
Free a channel structure. | |
void | ast_channel_inherit_variables (const struct ast_channel *parent, struct ast_channel *child) |
Inherits channel variable from parent to child channel. | |
int | ast_channel_make_compatible (struct ast_channel *chan, struct ast_channel *peer) |
Makes two channel formats compatible. | |
int | ast_channel_masquerade (struct ast_channel *original, struct ast_channel *clone) |
Weird function made for call transfers. | |
char * | ast_channel_reason2str (int reason) |
return an english explanation of the code returned thru __ast_request_and_dial's 'outstate' argument | |
int | ast_channel_register (const struct ast_channel_tech *tech) |
Register a channel technology (a new channel driver) Called by a channel module to register the kind of channels it supports. | |
int | ast_channel_sendhtml (struct ast_channel *chan, int subclass, const char *data, int datalen) |
int | ast_channel_sendurl (struct ast_channel *chan, const char *url) |
int | ast_channel_setoption (struct ast_channel *chan, int option, void *data, int datalen, int block) |
Sets an option on a channel. | |
void | ast_channel_setwhentohangup (struct ast_channel *chan, time_t offset) |
Set when to hang a channel up. | |
ast_silence_generator * | ast_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_channel * | ast_channel_walk_locked (const struct ast_channel *prev) |
Browse channels in use Browse the channels currently in use. | |
void | ast_channels_init (void) |
ast_variable * | ast_channeltype_list (void) |
return an ast_variable list of channeltypes | |
int | ast_check_hangup (struct ast_channel *chan) |
Check to see if a channel is needing hang up. | |
static int | ast_check_hangup_locked (struct ast_channel *chan) |
void | ast_deactivate_generator (struct ast_channel *chan) |
int | ast_do_masquerade (struct ast_channel *original) |
Start masquerading a channel XXX This is a seriously wacked out operation. We're essentially putting the guts of the clone channel into the original channel. Start by killing off the original channel's backend. I'm not sure we're going to keep this function, because while the features are nice, the cost is very high in terms of pure nastiness. XXX. | |
static enum ast_bridge_result | ast_generic_bridge (struct ast_channel *c0, struct ast_channel *c1, struct ast_bridge_config *config, struct ast_frame **fo, struct ast_channel **rc, struct timeval bridge_end) |
ast_channel * | ast_get_channel_by_exten_locked (const char *exten, const char *context) |
Get channel by exten (and optionally context) and lock it. | |
ast_channel * | ast_get_channel_by_name_locked (const char *name) |
Get channel by name (locks channel). | |
ast_channel * | ast_get_channel_by_name_prefix_locked (const char *name, const int namelen) |
Get channel by name prefix (locks channel). | |
ast_channel_tech * | ast_get_channel_tech (const char *name) |
Get a channel technology structure by name. | |
ast_group_t | ast_get_group (const char *s) |
int | ast_hangup (struct ast_channel *chan) |
Hang up a channel. | |
int | ast_indicate (struct ast_channel *chan, int condition) |
Indicates condition of channel. | |
int | ast_indicate_data (struct ast_channel *chan, int _condition, const void *data, size_t datalen) |
Indicates condition of channel, with payload. | |
void | ast_install_music_functions (int(*start_ptr)(struct ast_channel *, const char *, const char *), void(*stop_ptr)(struct ast_channel *), void(*cleanup_ptr)(struct ast_channel *)) |
int | ast_internal_timing_enabled (struct ast_channel *chan) |
Check if the channel can run in internal timing mode. | |
void | ast_moh_cleanup (struct ast_channel *chan) |
int | ast_moh_start (struct ast_channel *chan, const char *mclass, const char *interpclass) |
Turn on music on hold on a given channel. | |
void | ast_moh_stop (struct ast_channel *chan) |
Turn off music on hold on a given channel. | |
char * | ast_print_group (char *buf, int buflen, ast_group_t group) |
print call- and pickup groups into buffer | |
int | ast_prod (struct ast_channel *chan) |
Send empty audio to prime a channel driver. | |
int | ast_queue_control (struct ast_channel *chan, enum ast_control_frame_type control) |
Queue a control frame with payload. | |
int | ast_queue_control_data (struct ast_channel *chan, enum ast_control_frame_type control, const void *data, size_t datalen) |
Queue a control frame with payload. | |
int | ast_queue_frame (struct ast_channel *chan, struct ast_frame *fin) |
Queue an outgoing frame. | |
int | ast_queue_frame_head (struct ast_channel *chan, struct ast_frame *fin) |
Queue an outgoing frame to the head of the frame queue. | |
int | ast_queue_hangup (struct ast_channel *chan) |
Queue a hangup frame. | |
ast_frame * | ast_read (struct ast_channel *chan) |
Reads a frame. | |
static void | ast_read_generator_actions (struct ast_channel *chan, struct ast_frame *f) |
ast_frame * | ast_read_noaudio (struct ast_channel *chan) |
Reads a frame, returning AST_FRAME_NULL frame if audio. Read a frame. | |
int | ast_readstring (struct ast_channel *c, char *s, int len, int timeout, int ftimeout, char *enders) |
int | ast_readstring_full (struct ast_channel *c, char *s, int len, int timeout, int ftimeout, char *enders, int audiofd, int ctrlfd) |
int | ast_recvchar (struct ast_channel *chan, int timeout) |
Receives a text character from a channel. | |
char * | ast_recvtext (struct ast_channel *chan, int timeout) |
Receives a text string from a channel Read a string of text from a channel. | |
ast_channel * | ast_request (const char *type, int format, void *data, int *cause) |
Requests a channel. | |
ast_channel * | ast_request_and_dial (const char *type, int format, void *data, int timeout, int *outstate, const char *cidnum, const char *cidname) |
Request a channel of a given type, with data as optional information used by the low level module and attempt to place a call on it. | |
int | ast_safe_sleep (struct ast_channel *chan, int ms) |
Wait for a specied amount of time, looking for hangups. | |
int | ast_safe_sleep_conditional (struct ast_channel *chan, int ms, int(*cond)(void *), void *data) |
Wait for a specied amount of time, looking for hangups and a condition argument. | |
char * | ast_safe_string_alloc (const char *fmt,...) |
printf the string into a correctly sized mallocd buffer, and return the buffer | |
int | ast_say_character_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang) |
int | ast_say_digit_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang) |
int | ast_say_digits (struct ast_channel *chan, int num, const char *ints, const char *lang) |
int | ast_say_digits_full (struct ast_channel *chan, int num, const char *ints, const char *lang, int audiofd, int ctrlfd) |
int | ast_say_enumeration (struct ast_channel *chan, int num, const char *ints, const char *language, const char *options) |
int | ast_say_number (struct ast_channel *chan, int num, const char *ints, const char *language, const char *options) |
int | ast_say_phonetic_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang) |
int | ast_senddigit (struct ast_channel *chan, char digit) |
Send a DTMF digit to a channel Send a DTMF digit to a channel. | |
int | ast_senddigit_begin (struct ast_channel *chan, char digit) |
int | ast_senddigit_end (struct ast_channel *chan, char digit, unsigned int duration) |
int | ast_sendtext (struct ast_channel *chan, const char *text) |
Sends text to a channel Write text to a display on a channel. | |
void | ast_set_callerid (struct ast_channel *chan, const char *callerid, const char *calleridname, const char *ani) |
int | ast_set_read_format (struct ast_channel *chan, int fmt) |
Sets read format on channel chan Set read format for channel to whichever component of "format" is best. | |
void | ast_set_variables (struct ast_channel *chan, struct ast_variable *vars) |
adds a list of channel variables to a channel | |
int | ast_set_write_format (struct ast_channel *chan, int fmt) |
Sets write format on channel chan Set write format for channel to whichever compoent of "format" is best. | |
int | ast_setstate (struct ast_channel *chan, enum ast_channel_state state) |
Change the state of a channel. | |
int | ast_settimeout (struct ast_channel *c, int samples, int(*func)(const void *data), void *data) |
int | ast_shutting_down (void) |
Returns non-zero if Asterisk is being shut down. | |
int | ast_softhangup (struct ast_channel *chan, int cause) |
Softly hangup up a channel. | |
int | ast_softhangup_nolock (struct ast_channel *chan, int cause) |
Softly hangup up a channel (no channel lock). | |
char * | ast_state2str (enum ast_channel_state state) |
Gives the string form of a given channel state. | |
int | ast_str2cause (const char *name) |
Convert a symbolic hangup cause to number. | |
int | ast_tonepair (struct ast_channel *chan, int freq1, int freq2, int duration, int vol) |
int | ast_tonepair_start (struct ast_channel *chan, int freq1, int freq2, int duration, int vol) |
void | ast_tonepair_stop (struct ast_channel *chan) |
int | ast_transfer (struct ast_channel *chan, char *dest) |
Transfer a channel (if supported). Returns -1 on error, 0 if not supported and 1 if supported and requested. | |
char * | ast_transfercapability2str (int transfercapability) |
Gives the string form of a given transfer capability. | |
void | ast_uninstall_music_functions (void) |
int | ast_waitfor (struct ast_channel *c, int ms) |
Wait for input on a channel. | |
ast_channel * | ast_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_channel * | ast_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_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. | |
ast_channel * | ast_walk_channel_by_name_prefix_locked (const struct ast_channel *chan, const char *name, const int namelen) |
Get channel by name prefix (locks channel). | |
int | ast_write (struct ast_channel *chan, struct ast_frame *fr) |
Write a frame to a channel This function writes the given frame to the indicated channel. | |
int | ast_write_video (struct ast_channel *chan, struct ast_frame *fr) |
Write video frame to a channel This function writes the given frame to the indicated channel. | |
static void | bridge_playfile (struct ast_channel *chan, struct ast_channel *peer, const char *sound, int remain) |
static struct ast_channel * | channel_find_locked (const struct ast_channel *prev, const char *name, const int namelen, const char *context, const char *exten) |
Helper function to find channels. | |
const char * | channelreloadreason2txt (enum channelreloadreason reason) |
Convert enum channelreloadreason to text string for manager event. | |
static void | clone_variables (struct ast_channel *original, struct ast_channel *clone) |
Clone channel variables from 'clone' channel into 'original' channel. | |
static char * | complete_channeltypes (const char *line, const char *word, int pos, int state) |
static char * | complete_channeltypes_deprecated (const char *line, const char *word, int pos, int state) |
static void | free_cid (struct ast_callerid *cid) |
static void | free_translation (struct ast_channel *clone) |
static int | generator_force (const void *data) |
static int attribute_const | is_visible_indication (enum ast_control_frame_type condition) |
static void | queue_dtmf_readq (struct ast_channel *chan, struct ast_frame *f) |
static int | set_format (struct ast_channel *chan, int fmt, int *rawformat, int *format, struct ast_trans_pvt **trans, const int direction) |
static int | should_skip_dtmf (struct ast_channel *chan) |
Determine whether or not we should ignore DTMF in the readq. | |
static int | show_channeltype (int fd, int argc, char *argv[]) |
static int | show_channeltype_deprecated (int fd, int argc, char *argv[]) |
static int | show_channeltypes (int fd, int argc, char *argv[]) |
static void * | silence_generator_alloc (struct ast_channel *chan, void *data) |
static int | silence_generator_generate (struct ast_channel *chan, void *data, int len, int samples) |
static void | silence_generator_release (struct ast_channel *chan, void *data) |
static void | state2str_threadbuf_init (void) |
static void * | tonepair_alloc (struct ast_channel *chan, void *params) |
static int | tonepair_generator (struct ast_channel *chan, void *data, int len, int samples) |
static void | tonepair_release (struct ast_channel *chan, void *params) |
Variables | |
static void(*) | ast_moh_cleanup_ptr (struct ast_channel *) = NULL |
static int(*) | ast_moh_start_ptr (struct ast_channel *, const char *, const char *) = NULL |
static void(*) | ast_moh_stop_ptr (struct ast_channel *) = NULL |
ast_cause | causes [] |
static struct ast_cli_entry | cli_channel [] |
static struct ast_cli_entry | cli_show_channeltype_deprecated |
static struct ast_cli_entry | cli_show_channeltypes_deprecated |
unsigned long | global_fin |
unsigned long | global_fout |
static struct ast_channel_tech | null_tech |
static char | show_channeltype_usage [] |
static char | show_channeltypes_usage [] |
static int | shutting_down |
static struct ast_generator | silence_generator |
static struct ast_threadstorage | state2str_threadbuf = { .once = PTHREAD_ONCE_INIT, .key_init = state2str_threadbuf_init , } |
static struct ast_generator | tonepair |
static int | uniqueint |
Definition in file channel.c.
#define AST_DEFAULT_EMULATE_DTMF_DURATION 100 |
Default amount of time to use when emulating a digit as a begin and end 100ms
Definition at line 89 of file channel.c.
Referenced by __ast_read(), and ast_senddigit().
#define AST_MIN_DTMF_DURATION 80 |
Minimum allowed digit length - 80ms
Definition at line 92 of file channel.c.
Referenced by __ast_read().
#define AST_MIN_DTMF_GAP 45 |
Minimum amount of time between the end of the last digit and the beginning of a new one - 45ms
Definition at line 96 of file channel.c.
Referenced by __ast_read(), and should_skip_dtmf().
#define FORMAT "%-10.10s %-40.40s %-12.12s %-12.12s %-12.12s\n" |
#define MONITOR_DELAY 150 * 8 |
#define STATE2STR_BUFSIZE 32 |
static int __ast_queue_frame | ( | struct ast_channel * | chan, | |
struct ast_frame * | fin, | |||
int | head | |||
) | [static] |
Queue an outgoing media frame.
Definition at line 897 of file channel.c.
References ast_channel::alertpipe, ast_assert, ast_channel_lock, ast_channel_unlock, AST_CONTROL_HANGUP, AST_FLAG_BLOCKING, AST_FRAME_CONTROL, AST_FRAME_VOICE, ast_frdup(), ast_frfree, AST_LIST_INSERT_HEAD, AST_LIST_INSERT_TAIL, AST_LIST_LAST, AST_LIST_TRAVERSE, ast_log(), ast_test_flag, ast_channel::blocker, errno, f, ast_frame::frame_list, ast_frame::frametype, LOG_DEBUG, ast_channel::name, option_debug, ast_channel::readq, ast_frame::subclass, and ast_channel::timingfd.
Referenced by ast_queue_frame(), and ast_queue_frame_head().
00898 { 00899 struct ast_frame *f; 00900 struct ast_frame *cur; 00901 int blah = 1; 00902 int qlen = 0; 00903 00904 /* Build us a copy and free the original one */ 00905 if (!(f = ast_frdup(fin))) { 00906 return -1; 00907 } 00908 00909 ast_channel_lock(chan); 00910 00911 /* See if the last frame on the queue is a hangup, if so don't queue anything */ 00912 if ((cur = AST_LIST_LAST(&chan->readq)) && (cur->frametype == AST_FRAME_CONTROL) && (cur->subclass == AST_CONTROL_HANGUP)) { 00913 ast_frfree(f); 00914 ast_channel_unlock(chan); 00915 return 0; 00916 } 00917 00918 /* Count how many frames exist on the queue */ 00919 AST_LIST_TRAVERSE(&chan->readq, cur, frame_list) { 00920 qlen++; 00921 } 00922 00923 /* Allow up to 96 voice frames outstanding, and up to 128 total frames */ 00924 if (((fin->frametype == AST_FRAME_VOICE) && (qlen > 96)) || (qlen > 128)) { 00925 if (fin->frametype != AST_FRAME_VOICE) { 00926 ast_log(LOG_WARNING, "Exceptionally long queue length queuing to %s\n", chan->name); 00927 ast_assert(fin->frametype == AST_FRAME_VOICE); 00928 } else { 00929 if (option_debug) 00930 ast_log(LOG_DEBUG, "Dropping voice to exceptionally long queue on %s\n", chan->name); 00931 ast_frfree(f); 00932 ast_channel_unlock(chan); 00933 return 0; 00934 } 00935 } 00936 00937 if (head) { 00938 AST_LIST_INSERT_HEAD(&chan->readq, f, frame_list); 00939 } else { 00940 AST_LIST_INSERT_TAIL(&chan->readq, f, frame_list); 00941 } 00942 00943 if (chan->alertpipe[1] > -1) { 00944 if (write(chan->alertpipe[1], &blah, sizeof(blah)) != sizeof(blah)) { 00945 ast_log(LOG_WARNING, "Unable to write to alert pipe on %s, frametype/subclass %d/%d (qlen = %d): %s!\n", 00946 chan->name, f->frametype, f->subclass, qlen, strerror(errno)); 00947 } 00948 #ifdef HAVE_DAHDI 00949 } else if (chan->timingfd > -1) { 00950 ioctl(chan->timingfd, DAHDI_TIMERPING, &blah); 00951 #endif 00952 } else if (ast_test_flag(chan, AST_FLAG_BLOCKING)) { 00953 pthread_kill(chan->blocker, SIGURG); 00954 } 00955 00956 ast_channel_unlock(chan); 00957 00958 return 0; 00959 }
static struct ast_frame* __ast_read | ( | struct ast_channel * | chan, | |
int | dropaudio | |||
) | [static] |
Definition at line 2024 of file channel.c.
References ast_channel::_softhangup, ast_channel::_state, ast_channel::alertpipe, AST_AUDIOHOOK_DIRECTION_READ, ast_audiohook_write_list(), ast_channel_trylock, ast_channel_unlock, ast_check_hangup(), ast_clear_flag, AST_CONTROL_ANSWER, AST_CONTROL_HANGUP, ast_deactivate_generator(), AST_DEFAULT_EMULATE_DTMF_DURATION, ast_do_masquerade(), AST_FLAG_DEFER_DTMF, AST_FLAG_EMULATE_DTMF, AST_FLAG_END_DTMF_ONLY, AST_FLAG_EXCEPTION, AST_FLAG_IN_DTMF, AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, ast_frame_dump(), AST_FRAME_NULL, AST_FRAME_VOICE, ast_frfree, AST_GENERATOR_FD, ast_getformatname(), ast_getformatname_multiple(), AST_LIST_EMPTY, AST_LIST_FIRST, AST_LIST_HEAD_SET_NOLOCK, AST_LIST_NEXT, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_log(), AST_MIN_DTMF_DURATION, AST_MIN_DTMF_GAP, AST_MONITOR_RUNNING, ast_null_frame, ast_read_generator_actions(), ast_seekstream(), ast_set_flag, ast_setstate(), AST_SOFTHANGUP_DEV, AST_STATE_UP, ast_test_flag, AST_TIMING_FD, ast_translate(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), ast_writestream(), ast_channel::audiohooks, ast_channel::blocker, ast_frame::data, DEBUGCHAN_FLAG, ast_channel::dtmf_tv, ast_channel::dtmff, ast_channel::emulate_dtmf_digit, ast_channel::emulate_dtmf_duration, errno, ast_channel_tech::exception, f, ast_channel::fdno, ast_channel::fds, ast_channel::fin, ast_frame::flags, ast_frame::frame_list, FRAMECOUNT_INC, ast_frame::frametype, ast_generator::generate, ast_channel::generator, ast_channel::generatordata, ast_channel::insmpl, LOG_DEBUG, LOG_DTMF, LOG_ERROR, LOG_NOTICE, ast_channel::masq, ast_channel::monitor, MONITOR_DELAY, ast_channel::name, ast_channel::nativeformats, option_debug, ast_channel::outsmpl, queue_dtmf_readq(), ast_channel_tech::read, ast_channel_monitor::read_stream, ast_channel::readq, ast_channel::readtrans, SEEK_FORCECUR, should_skip_dtmf(), ast_channel_monitor::state, ast_channel::tech, ast_channel::timingdata, ast_channel::timingfd, and ast_channel::timingfunc.
Referenced by ast_read(), and ast_read_noaudio().
02025 { 02026 struct ast_frame *f = NULL; /* the return value */ 02027 int blah; 02028 int prestate; 02029 int count = 0; 02030 02031 /* this function is very long so make sure there is only one return 02032 * point at the end (there are only two exceptions to this). 02033 */ 02034 while(ast_channel_trylock(chan)) { 02035 if(count++ > 10) 02036 /*cannot goto done since the channel is not locked*/ 02037 return &ast_null_frame; 02038 usleep(1); 02039 } 02040 02041 if (chan->fdno == -1) { 02042 ast_log(LOG_ERROR, "ast_read() called with no recorded file descriptor.\n"); 02043 f = &ast_null_frame; 02044 goto done; 02045 } 02046 02047 if (chan->masq) { 02048 if (ast_do_masquerade(chan)) 02049 ast_log(LOG_WARNING, "Failed to perform masquerade\n"); 02050 else 02051 f = &ast_null_frame; 02052 goto done; 02053 } 02054 02055 /* Stop if we're a zombie or need a soft hangup */ 02056 if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) { 02057 if (chan->generator) 02058 ast_deactivate_generator(chan); 02059 goto done; 02060 } 02061 prestate = chan->_state; 02062 02063 /* Read and ignore anything on the alertpipe, but read only 02064 one sizeof(blah) per frame that we send from it */ 02065 if (chan->alertpipe[0] > -1) { 02066 int flags = fcntl(chan->alertpipe[0], F_GETFL); 02067 /* For some odd reason, the alertpipe occasionally loses nonblocking status, 02068 * which immediately causes a deadlock scenario. Detect and prevent this. */ 02069 if ((flags & O_NONBLOCK) == 0) { 02070 ast_log(LOG_ERROR, "Alertpipe on channel %s lost O_NONBLOCK?!!\n", chan->name); 02071 if (fcntl(chan->alertpipe[0], F_SETFL, flags | O_NONBLOCK) < 0) { 02072 ast_log(LOG_WARNING, "Unable to set alertpipe nonblocking! (%d: %s)\n", errno, strerror(errno)); 02073 f = &ast_null_frame; 02074 goto done; 02075 } 02076 } 02077 if (read(chan->alertpipe[0], &blah, sizeof(blah)) < 0) { 02078 if (errno != EINTR && errno != EAGAIN) 02079 ast_log(LOG_WARNING, "read() failed: %s\n", strerror(errno)); 02080 } 02081 } 02082 02083 #ifdef HAVE_DAHDI 02084 if (chan->timingfd > -1 && chan->fdno == AST_TIMING_FD && ast_test_flag(chan, AST_FLAG_EXCEPTION)) { 02085 int res; 02086 02087 ast_clear_flag(chan, AST_FLAG_EXCEPTION); 02088 blah = -1; 02089 /* IF we can't get event, assume it's an expired as-per the old interface */ 02090 res = ioctl(chan->timingfd, DAHDI_GETEVENT, &blah); 02091 if (res) 02092 blah = DAHDI_EVENT_TIMER_EXPIRED; 02093 02094 if (blah == DAHDI_EVENT_TIMER_PING) { 02095 if (AST_LIST_EMPTY(&chan->readq) || !AST_LIST_NEXT(AST_LIST_FIRST(&chan->readq), frame_list)) { 02096 /* Acknowledge PONG unless we need it again */ 02097 if (ioctl(chan->timingfd, DAHDI_TIMERPONG, &blah)) { 02098 ast_log(LOG_WARNING, "Failed to pong timer on '%s': %s\n", chan->name, strerror(errno)); 02099 } 02100 } 02101 } else if (blah == DAHDI_EVENT_TIMER_EXPIRED) { 02102 ioctl(chan->timingfd, DAHDI_TIMERACK, &blah); 02103 if (chan->timingfunc) { 02104 /* save a copy of func/data before unlocking the channel */ 02105 int (*func)(const void *) = chan->timingfunc; 02106 void *data = chan->timingdata; 02107 chan->fdno = -1; 02108 ast_channel_unlock(chan); 02109 func(data); 02110 } else { 02111 blah = 0; 02112 ioctl(chan->timingfd, DAHDI_TIMERCONFIG, &blah); 02113 chan->timingdata = NULL; 02114 chan->fdno = -1; 02115 ast_channel_unlock(chan); 02116 } 02117 /* cannot 'goto done' because the channel is already unlocked */ 02118 return &ast_null_frame; 02119 } else 02120 ast_log(LOG_NOTICE, "No/unknown event '%d' on timer for '%s'?\n", blah, chan->name); 02121 } else 02122 #endif 02123 if (chan->fds[AST_GENERATOR_FD] > -1 && chan->fdno == AST_GENERATOR_FD) { 02124 /* if the AST_GENERATOR_FD is set, call the generator with args 02125 * set to -1 so it can do whatever it needs to. 02126 */ 02127 void *tmp = chan->generatordata; 02128 chan->generatordata = NULL; /* reset to let ast_write get through */ 02129 chan->generator->generate(chan, tmp, -1, -1); 02130 chan->generatordata = tmp; 02131 f = &ast_null_frame; 02132 chan->fdno = -1; 02133 goto done; 02134 } 02135 02136 /* Check for pending read queue */ 02137 if (!AST_LIST_EMPTY(&chan->readq)) { 02138 int skip_dtmf = should_skip_dtmf(chan); 02139 02140 AST_LIST_TRAVERSE_SAFE_BEGIN(&chan->readq, f, frame_list) { 02141 /* We have to be picky about which frame we pull off of the readq because 02142 * there are cases where we want to leave DTMF frames on the queue until 02143 * some later time. */ 02144 02145 if ( (f->frametype == AST_FRAME_DTMF_BEGIN || f->frametype == AST_FRAME_DTMF_END) && skip_dtmf) { 02146 continue; 02147 } 02148 02149 AST_LIST_REMOVE_CURRENT(&chan->readq, frame_list); 02150 break; 02151 } 02152 AST_LIST_TRAVERSE_SAFE_END 02153 02154 if (!f) { 02155 /* There were no acceptable frames on the readq. */ 02156 f = &ast_null_frame; 02157 if (chan->alertpipe[0] > -1) { 02158 int poke = 0; 02159 /* Restore the state of the alertpipe since we aren't ready for any 02160 * of the frames in the readq. */ 02161 if (write(chan->alertpipe[1], &poke, sizeof(poke)) != sizeof(poke)) { 02162 ast_log(LOG_ERROR, "Failed to write to alertpipe: %s\n", strerror(errno)); 02163 } 02164 } 02165 } 02166 02167 /* Interpret hangup and return NULL */ 02168 /* XXX why not the same for frames from the channel ? */ 02169 if (f->frametype == AST_FRAME_CONTROL && f->subclass == AST_CONTROL_HANGUP) { 02170 ast_frfree(f); 02171 f = NULL; 02172 } 02173 } else { 02174 chan->blocker = pthread_self(); 02175 if (ast_test_flag(chan, AST_FLAG_EXCEPTION)) { 02176 if (chan->tech->exception) 02177 f = chan->tech->exception(chan); 02178 else { 02179 ast_log(LOG_WARNING, "Exception flag set on '%s', but no exception handler\n", chan->name); 02180 f = &ast_null_frame; 02181 } 02182 /* Clear the exception flag */ 02183 ast_clear_flag(chan, AST_FLAG_EXCEPTION); 02184 } else if (chan->tech->read) 02185 f = chan->tech->read(chan); 02186 else 02187 ast_log(LOG_WARNING, "No read routine on channel %s\n", chan->name); 02188 } 02189 02190 /* 02191 * Reset the recorded file descriptor that triggered this read so that we can 02192 * easily detect when ast_read() is called without properly using ast_waitfor(). 02193 */ 02194 chan->fdno = -1; 02195 02196 if (f) { 02197 /* if the channel driver returned more than one frame, stuff the excess 02198 into the readq for the next ast_read call (note that we can safely assume 02199 that the readq is empty, because otherwise we would not have called into 02200 the channel driver and f would be only a single frame) 02201 */ 02202 if (AST_LIST_NEXT(f, frame_list)) { 02203 AST_LIST_HEAD_SET_NOLOCK(&chan->readq, AST_LIST_NEXT(f, frame_list)); 02204 AST_LIST_NEXT(f, frame_list) = NULL; 02205 } 02206 02207 switch (f->frametype) { 02208 case AST_FRAME_CONTROL: 02209 if (f->subclass == AST_CONTROL_ANSWER) { 02210 if (!ast_test_flag(chan, AST_FLAG_OUTGOING)) { 02211 if (option_debug) 02212 ast_log(LOG_DEBUG, "Ignoring answer on an inbound call!\n"); 02213 ast_frfree(f); 02214 f = &ast_null_frame; 02215 } else if (prestate == AST_STATE_UP) { 02216 if (option_debug) 02217 ast_log(LOG_DEBUG, "Dropping duplicate answer!\n"); 02218 ast_frfree(f); 02219 f = &ast_null_frame; 02220 } else { 02221 /* Answer the CDR */ 02222 ast_setstate(chan, AST_STATE_UP); 02223 /* removed a call to ast_cdr_answer(chan->cdr) from here. */ 02224 } 02225 } 02226 break; 02227 case AST_FRAME_DTMF_END: 02228 ast_log(LOG_DTMF, "DTMF end '%c' received on %s, duration %ld ms\n", f->subclass, chan->name, f->len); 02229 /* Queue it up if DTMF is deferred, or if DTMF emulation is forced. */ 02230 if (ast_test_flag(chan, AST_FLAG_DEFER_DTMF) || ast_test_flag(chan, AST_FLAG_EMULATE_DTMF)) { 02231 queue_dtmf_readq(chan, f); 02232 ast_frfree(f); 02233 f = &ast_null_frame; 02234 } else if (!ast_test_flag(chan, AST_FLAG_IN_DTMF | AST_FLAG_END_DTMF_ONLY)) { 02235 if (!ast_tvzero(chan->dtmf_tv) && 02236 ast_tvdiff_ms(ast_tvnow(), chan->dtmf_tv) < AST_MIN_DTMF_GAP) { 02237 /* If it hasn't been long enough, defer this digit */ 02238 queue_dtmf_readq(chan, f); 02239 ast_frfree(f); 02240 f = &ast_null_frame; 02241 } else { 02242 /* There was no begin, turn this into a begin and send the end later */ 02243 f->frametype = AST_FRAME_DTMF_BEGIN; 02244 ast_set_flag(chan, AST_FLAG_EMULATE_DTMF); 02245 chan->emulate_dtmf_digit = f->subclass; 02246 chan->dtmf_tv = ast_tvnow(); 02247 if (f->len) { 02248 if (f->len > AST_MIN_DTMF_DURATION) 02249 chan->emulate_dtmf_duration = f->len; 02250 else 02251 chan->emulate_dtmf_duration = AST_MIN_DTMF_DURATION; 02252 } else 02253 chan->emulate_dtmf_duration = AST_DEFAULT_EMULATE_DTMF_DURATION; 02254 ast_log(LOG_DTMF, "DTMF begin emulation of '%c' with duration %u queued on %s\n", f->subclass, chan->emulate_dtmf_duration, chan->name); 02255 } 02256 if (chan->audiohooks) { 02257 struct ast_frame *old_frame = f; 02258 f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f); 02259 if (old_frame != f) 02260 ast_frfree(old_frame); 02261 } 02262 } else { 02263 struct timeval now = ast_tvnow(); 02264 if (ast_test_flag(chan, AST_FLAG_IN_DTMF)) { 02265 ast_log(LOG_DTMF, "DTMF end accepted with begin '%c' on %s\n", f->subclass, chan->name); 02266 ast_clear_flag(chan, AST_FLAG_IN_DTMF); 02267 if (!f->len) 02268 f->len = ast_tvdiff_ms(now, chan->dtmf_tv); 02269 } else if (!f->len) { 02270 ast_log(LOG_DTMF, "DTMF end accepted without begin '%c' on %s\n", f->subclass, chan->name); 02271 f->len = AST_MIN_DTMF_DURATION; 02272 } 02273 if (f->len < AST_MIN_DTMF_DURATION && !ast_test_flag(chan, AST_FLAG_END_DTMF_ONLY)) { 02274 ast_log(LOG_DTMF, "DTMF end '%c' has duration %ld but want minimum %d, emulating on %s\n", f->subclass, f->len, AST_MIN_DTMF_DURATION, chan->name); 02275 ast_set_flag(chan, AST_FLAG_EMULATE_DTMF); 02276 chan->emulate_dtmf_digit = f->subclass; 02277 chan->emulate_dtmf_duration = AST_MIN_DTMF_DURATION - f->len; 02278 ast_frfree(f); 02279 f = &ast_null_frame; 02280 } else { 02281 ast_log(LOG_DTMF, "DTMF end passthrough '%c' on %s\n", f->subclass, chan->name); 02282 if (f->len < AST_MIN_DTMF_DURATION) { 02283 f->len = AST_MIN_DTMF_DURATION; 02284 } 02285 chan->dtmf_tv = now; 02286 } 02287 if (chan->audiohooks) { 02288 struct ast_frame *old_frame = f; 02289 f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f); 02290 if (old_frame != f) 02291 ast_frfree(old_frame); 02292 } 02293 } 02294 break; 02295 case AST_FRAME_DTMF_BEGIN: 02296 ast_log(LOG_DTMF, "DTMF begin '%c' received on %s\n", f->subclass, chan->name); 02297 if ( ast_test_flag(chan, AST_FLAG_DEFER_DTMF | AST_FLAG_END_DTMF_ONLY | AST_FLAG_EMULATE_DTMF) || 02298 (!ast_tvzero(chan->dtmf_tv) && 02299 ast_tvdiff_ms(ast_tvnow(), chan->dtmf_tv) < AST_MIN_DTMF_GAP) ) { 02300 ast_log(LOG_DTMF, "DTMF begin ignored '%c' on %s\n", f->subclass, chan->name); 02301 ast_frfree(f); 02302 f = &ast_null_frame; 02303 } else { 02304 ast_set_flag(chan, AST_FLAG_IN_DTMF); 02305 chan->dtmf_tv = ast_tvnow(); 02306 ast_log(LOG_DTMF, "DTMF begin passthrough '%c' on %s\n", f->subclass, chan->name); 02307 } 02308 break; 02309 case AST_FRAME_NULL: 02310 /* The EMULATE_DTMF flag must be cleared here as opposed to when the duration 02311 * is reached , because we want to make sure we pass at least one 02312 * voice frame through before starting the next digit, to ensure a gap 02313 * between DTMF digits. */ 02314 if (ast_test_flag(chan, AST_FLAG_EMULATE_DTMF)) { 02315 struct timeval now = ast_tvnow(); 02316 if (!chan->emulate_dtmf_duration) { 02317 ast_clear_flag(chan, AST_FLAG_EMULATE_DTMF); 02318 chan->emulate_dtmf_digit = 0; 02319 } else if (ast_tvdiff_ms(now, chan->dtmf_tv) >= chan->emulate_dtmf_duration) { 02320 chan->emulate_dtmf_duration = 0; 02321 ast_frfree(f); 02322 f = &chan->dtmff; 02323 f->frametype = AST_FRAME_DTMF_END; 02324 f->subclass = chan->emulate_dtmf_digit; 02325 f->len = ast_tvdiff_ms(now, chan->dtmf_tv); 02326 chan->dtmf_tv = now; 02327 ast_clear_flag(chan, AST_FLAG_EMULATE_DTMF); 02328 chan->emulate_dtmf_digit = 0; 02329 ast_log(LOG_DTMF, "DTMF end emulation of '%c' queued on %s\n", f->subclass, chan->name); 02330 } 02331 } 02332 break; 02333 case AST_FRAME_VOICE: 02334 /* The EMULATE_DTMF flag must be cleared here as opposed to when the duration 02335 * is reached , because we want to make sure we pass at least one 02336 * voice frame through before starting the next digit, to ensure a gap 02337 * between DTMF digits. */ 02338 if (ast_test_flag(chan, AST_FLAG_EMULATE_DTMF) && !chan->emulate_dtmf_duration) { 02339 ast_clear_flag(chan, AST_FLAG_EMULATE_DTMF); 02340 chan->emulate_dtmf_digit = 0; 02341 } 02342 02343 if (dropaudio || ast_test_flag(chan, AST_FLAG_IN_DTMF)) { 02344 if (dropaudio) 02345 ast_read_generator_actions(chan, f); 02346 ast_frfree(f); 02347 f = &ast_null_frame; 02348 } 02349 02350 if (ast_test_flag(chan, AST_FLAG_EMULATE_DTMF) && !ast_test_flag(chan, AST_FLAG_IN_DTMF)) { 02351 struct timeval now = ast_tvnow(); 02352 if (ast_tvdiff_ms(now, chan->dtmf_tv) >= chan->emulate_dtmf_duration) { 02353 chan->emulate_dtmf_duration = 0; 02354 ast_frfree(f); 02355 f = &chan->dtmff; 02356 f->frametype = AST_FRAME_DTMF_END; 02357 f->subclass = chan->emulate_dtmf_digit; 02358 f->len = ast_tvdiff_ms(now, chan->dtmf_tv); 02359 chan->dtmf_tv = now; 02360 if (chan->audiohooks) { 02361 struct ast_frame *old_frame = f; 02362 f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f); 02363 if (old_frame != f) 02364 ast_frfree(old_frame); 02365 } 02366 ast_log(LOG_DTMF, "DTMF end emulation of '%c' queued on %s\n", f->subclass, chan->name); 02367 } else { 02368 /* Drop voice frames while we're still in the middle of the digit */ 02369 ast_frfree(f); 02370 f = &ast_null_frame; 02371 } 02372 } else if ((f->frametype == AST_FRAME_VOICE) && !(f->subclass & chan->nativeformats)) { 02373 /* This frame is not one of the current native formats -- drop it on the floor */ 02374 char to[200]; 02375 ast_log(LOG_NOTICE, "Dropping incompatible voice frame on %s of format %s since our native format has changed to %s\n", 02376 chan->name, ast_getformatname(f->subclass), ast_getformatname_multiple(to, sizeof(to), chan->nativeformats)); 02377 ast_frfree(f); 02378 f = &ast_null_frame; 02379 } else if ((f->frametype == AST_FRAME_VOICE)) { 02380 if (chan->audiohooks) { 02381 struct ast_frame *old_frame = f; 02382 f = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_READ, f); 02383 if (old_frame != f) 02384 ast_frfree(old_frame); 02385 } 02386 if (chan->monitor && chan->monitor->read_stream ) { 02387 /* XXX what does this do ? */ 02388 #ifndef MONITOR_CONSTANT_DELAY 02389 int jump = chan->outsmpl - chan->insmpl - 4 * f->samples; 02390 if (jump >= 0) { 02391 jump = chan->outsmpl - chan->insmpl; 02392 if (ast_seekstream(chan->monitor->read_stream, jump, SEEK_FORCECUR) == -1) 02393 ast_log(LOG_WARNING, "Failed to perform seek in monitoring read stream, synchronization between the files may be broken\n"); 02394 chan->insmpl += jump + f->samples; 02395 } else 02396 chan->insmpl+= f->samples; 02397 #else 02398 int jump = chan->outsmpl - chan->insmpl; 02399 if (jump - MONITOR_DELAY >= 0) { 02400 if (ast_seekstream(chan->monitor->read_stream, jump - f->samples, SEEK_FORCECUR) == -1) 02401 ast_log(LOG_WARNING, "Failed to perform seek in monitoring read stream, synchronization between the files may be broken\n"); 02402 chan->insmpl += jump; 02403 } else 02404 chan->insmpl += f->samples; 02405 #endif 02406 if (chan->monitor->state == AST_MONITOR_RUNNING) { 02407 if (ast_writestream(chan->monitor->read_stream, f) < 0) 02408 ast_log(LOG_WARNING, "Failed to write data to channel monitor read stream\n"); 02409 } 02410 } 02411 02412 if (chan->readtrans && (f = ast_translate(chan->readtrans, f, 1)) == NULL) 02413 f = &ast_null_frame; 02414 02415 /* Run generator sitting on the line if timing device not available 02416 * and synchronous generation of outgoing frames is necessary */ 02417 ast_read_generator_actions(chan, f); 02418 } 02419 default: 02420 /* Just pass it on! */ 02421 break; 02422 } 02423 } else { 02424 /* Make sure we always return NULL in the future */ 02425 chan->_softhangup |= AST_SOFTHANGUP_DEV; 02426 if (chan->generator) 02427 ast_deactivate_generator(chan); 02428 /* We no longer End the CDR here */ 02429 } 02430 02431 /* High bit prints debugging */ 02432 if (chan->fin & DEBUGCHAN_FLAG) 02433 ast_frame_dump(chan->name, f, "<<"); 02434 chan->fin = FRAMECOUNT_INC(chan->fin); 02435 02436 done: 02437 ast_channel_unlock(chan); 02438 return f; 02439 }
struct ast_channel* __ast_request_and_dial | ( | const char * | type, | |
int | format, | |||
void * | data, | |||
int | timeout, | |||
int * | outstate, | |||
const char * | cid_num, | |||
const char * | cid_name, | |||
struct outgoing_helper * | oh | |||
) |
Definition at line 3017 of file channel.c.
References ast_channel::_state, outgoing_helper::account, ast_call(), AST_CAUSE_BUSY, AST_CAUSE_CONGESTION, AST_CAUSE_NO_ANSWER, ast_cdr_alloc(), ast_cdr_disposition(), ast_cdr_end(), ast_cdr_failed(), ast_cdr_init(), ast_cdr_setaccount(), ast_cdr_setapp(), ast_cdr_start(), ast_cdr_update(), ast_channel_inherit_variables(), AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_PROCEEDING, AST_CONTROL_PROGRESS, AST_CONTROL_RINGING, AST_CONTROL_SRCUPDATE, AST_CONTROL_UNHOLD, AST_CONTROL_VIDUPDATE, ast_copy_string(), AST_FRAME_CONTROL, ast_frfree, ast_hangup(), ast_log(), ast_read(), ast_request(), ast_set_callerid(), ast_set_variables(), AST_STATE_UP, ast_strlen_zero(), ast_waitfor(), ast_channel::cdr, outgoing_helper::cid_name, outgoing_helper::cid_num, outgoing_helper::context, ast_channel::context, outgoing_helper::exten, ast_channel::exten, f, ast_channel::hangupcause, LOG_NOTICE, outgoing_helper::parent_channel, outgoing_helper::priority, ast_channel::priority, and outgoing_helper::vars.
Referenced by ast_pbx_outgoing_app(), ast_pbx_outgoing_exten(), ast_request_and_dial(), and parkandannounce_exec().
03018 { 03019 int dummy_outstate; 03020 int cause = 0; 03021 struct ast_channel *chan; 03022 int res = 0; 03023 int last_subclass = 0; 03024 03025 if (outstate) 03026 *outstate = 0; 03027 else 03028 outstate = &dummy_outstate; /* make outstate always a valid pointer */ 03029 03030 chan = ast_request(type, format, data, &cause); 03031 if (!chan) { 03032 ast_log(LOG_NOTICE, "Unable to request channel %s/%s\n", type, (char *)data); 03033 /* compute error and return */ 03034 if (cause == AST_CAUSE_BUSY) 03035 *outstate = AST_CONTROL_BUSY; 03036 else if (cause == AST_CAUSE_CONGESTION) 03037 *outstate = AST_CONTROL_CONGESTION; 03038 return NULL; 03039 } 03040 03041 if (oh) { 03042 if (oh->vars) 03043 ast_set_variables(chan, oh->vars); 03044 /* XXX why is this necessary, for the parent_channel perhaps ? */ 03045 if (!ast_strlen_zero(oh->cid_num) && !ast_strlen_zero(oh->cid_name)) 03046 ast_set_callerid(chan, oh->cid_num, oh->cid_name, oh->cid_num); 03047 if (oh->parent_channel) 03048 ast_channel_inherit_variables(oh->parent_channel, chan); 03049 if (oh->account) 03050 ast_cdr_setaccount(chan, oh->account); 03051 } 03052 ast_set_callerid(chan, cid_num, cid_name, cid_num); 03053 03054 if (ast_call(chan, data, 0)) { /* ast_call failed... */ 03055 ast_log(LOG_NOTICE, "Unable to call channel %s/%s\n", type, (char *)data); 03056 } else { 03057 res = 1; /* mark success in case chan->_state is already AST_STATE_UP */ 03058 while (timeout && chan->_state != AST_STATE_UP) { 03059 struct ast_frame *f; 03060 res = ast_waitfor(chan, timeout); 03061 if (res <= 0) /* error, timeout, or done */ 03062 break; 03063 if (timeout > -1) 03064 timeout = res; 03065 f = ast_read(chan); 03066 if (!f) { 03067 *outstate = AST_CONTROL_HANGUP; 03068 res = 0; 03069 break; 03070 } 03071 if (f->frametype == AST_FRAME_CONTROL) { 03072 switch (f->subclass) { 03073 case AST_CONTROL_RINGING: /* record but keep going */ 03074 *outstate = f->subclass; 03075 break; 03076 03077 case AST_CONTROL_BUSY: 03078 case AST_CONTROL_CONGESTION: 03079 case AST_CONTROL_ANSWER: 03080 *outstate = f->subclass; 03081 timeout = 0; /* trick to force exit from the while() */ 03082 break; 03083 03084 /* Ignore these */ 03085 case AST_CONTROL_PROGRESS: 03086 case AST_CONTROL_PROCEEDING: 03087 case AST_CONTROL_HOLD: 03088 case AST_CONTROL_UNHOLD: 03089 case AST_CONTROL_VIDUPDATE: 03090 case AST_CONTROL_SRCUPDATE: 03091 case -1: /* Ignore -- just stopping indications */ 03092 break; 03093 03094 default: 03095 ast_log(LOG_NOTICE, "Don't know what to do with control frame %d\n", f->subclass); 03096 } 03097 last_subclass = f->subclass; 03098 } 03099 ast_frfree(f); 03100 } 03101 } 03102 03103 /* Final fixups */ 03104 if (oh) { 03105 if (!ast_strlen_zero(oh->context)) 03106 ast_copy_string(chan->context, oh->context, sizeof(chan->context)); 03107 if (!ast_strlen_zero(oh->exten)) 03108 ast_copy_string(chan->exten, oh->exten, sizeof(chan->exten)); 03109 if (oh->priority) 03110 chan->priority = oh->priority; 03111 } 03112 if (chan->_state == AST_STATE_UP) 03113 *outstate = AST_CONTROL_ANSWER; 03114 03115 if (res <= 0) { 03116 if ( AST_CONTROL_RINGING == last_subclass ) 03117 chan->hangupcause = AST_CAUSE_NO_ANSWER; 03118 if (!chan->cdr && (chan->cdr = ast_cdr_alloc())) 03119 ast_cdr_init(chan->cdr, chan); 03120 if (chan->cdr) { 03121 char tmp[256]; 03122 snprintf(tmp, sizeof(tmp), "%s/%s", type, (char *)data); 03123 ast_cdr_setapp(chan->cdr,"Dial",tmp); 03124 ast_cdr_update(chan); 03125 ast_cdr_start(chan->cdr); 03126 ast_cdr_end(chan->cdr); 03127 /* If the cause wasn't handled properly */ 03128 if (ast_cdr_disposition(chan->cdr,chan->hangupcause)) 03129 ast_cdr_failed(chan->cdr); 03130 } 03131 ast_hangup(chan); 03132 chan = NULL; 03133 } 03134 return chan; 03135 }
int ast_activate_generator | ( | struct ast_channel * | chan, | |
struct ast_generator * | gen, | |||
void * | params | |||
) |
Activate a given generator
Definition at line 1632 of file channel.c.
References ast_generator::alloc, ast_channel_lock, ast_channel_unlock, ast_prod(), ast_settimeout(), gen, ast_channel::generator, generator_force(), ast_channel::generatordata, and ast_generator::release.
Referenced by app_exec(), ast_channel_start_silence_generator(), ast_linear_stream(), ast_playtones_start(), ast_tonepair_start(), channel_spy(), local_ast_moh_start(), and old_milliwatt_exec().
01633 { 01634 int res = 0; 01635 01636 ast_channel_lock(chan); 01637 01638 if (chan->generatordata) { 01639 if (chan->generator && chan->generator->release) 01640 chan->generator->release(chan, chan->generatordata); 01641 chan->generatordata = NULL; 01642 } 01643 01644 ast_prod(chan); 01645 if (gen->alloc && !(chan->generatordata = gen->alloc(chan, params))) { 01646 res = -1; 01647 } 01648 01649 if (!res) { 01650 ast_settimeout(chan, 160, generator_force, chan); 01651 chan->generator = gen; 01652 } 01653 01654 ast_channel_unlock(chan); 01655 01656 return res; 01657 }
int ast_active_channels | ( | void | ) |
returns number of active/allocated channels
Returns number of active/allocated channels
Definition at line 443 of file channel.c.
References AST_LIST_LOCK, AST_LIST_TRAVERSE, and AST_LIST_UNLOCK.
Referenced by action_corestatus(), dahdi_restart(), handle_show_settings(), and quit_handler().
00444 { 00445 struct ast_channel *c; 00446 int cnt = 0; 00447 AST_LIST_LOCK(&channels); 00448 AST_LIST_TRAVERSE(&channels, c, chan_list) 00449 cnt++; 00450 AST_LIST_UNLOCK(&channels); 00451 return cnt; 00452 }
int ast_answer | ( | struct ast_channel * | chan | ) |
Answer a ringing call.
chan | channel to answer This function answers a channel and handles all necessary call setup functions. |
Definition at line 1553 of file channel.c.
References ast_channel::_state, ast_channel_tech::answer, ast_cdr_answer(), ast_channel_lock, ast_channel_unlock, ast_check_hangup(), AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, ast_indicate(), ast_setstate(), AST_STATE_RING, AST_STATE_RINGING, AST_STATE_UP, ast_test_flag, ast_channel::cdr, ast_channel::tech, and ast_channel::visible_indication.
Referenced by __login_exec(), agi_exec_full(), alarmreceiver_exec(), answer_trunk_chan(), app_exec(), ast_bridge_call(), ast_control_streamfile(), ast_pickup_call(), auth_exec(), background_detect_exec(), builtin_parkcall(), common_exec(), conf_exec(), count_exec(), dictate_exec(), directory_exec(), disa_exec(), exec(), features_answer(), handle_answer(), ices_exec(), old_milliwatt_exec(), park_call_exec(), park_exec(), pbx_builtin_answer(), pbx_builtin_background(), pickup_do(), playback_exec(), privacy_exec(), read_exec(), sayunixtime_exec(), send_waveform_to_channel(), skel_exec(), sla_station_exec(), speech_background(), testclient_exec(), testserver_exec(), vm_exec(), vm_execmain(), waitforsilence_exec(), and zapateller_exec().
01554 { 01555 int res = 0; 01556 ast_channel_lock(chan); 01557 /* You can't answer an outbound call */ 01558 if (ast_test_flag(chan, AST_FLAG_OUTGOING)) { 01559 ast_channel_unlock(chan); 01560 return 0; 01561 } 01562 /* Stop if we're a zombie or need a soft hangup */ 01563 if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) { 01564 ast_channel_unlock(chan); 01565 return -1; 01566 } 01567 switch(chan->_state) { 01568 case AST_STATE_RINGING: 01569 case AST_STATE_RING: 01570 if (chan->tech->answer) 01571 res = chan->tech->answer(chan); 01572 ast_setstate(chan, AST_STATE_UP); 01573 ast_cdr_answer(chan->cdr); 01574 break; 01575 case AST_STATE_UP: 01576 break; 01577 default: 01578 break; 01579 } 01580 ast_indicate(chan, -1); 01581 chan->visible_indication = 0; 01582 ast_channel_unlock(chan); 01583 return res; 01584 }
void ast_begin_shutdown | ( | int | hangup | ) |
Initiate system shutdown.
Initiate system shutdown -- prevents new channels from being allocated. If "hangup" is non-zero, all existing channels will receive soft hangups
Definition at line 430 of file channel.c.
References AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_softhangup(), and AST_SOFTHANGUP_SHUTDOWN.
Referenced by quit_handler().
00431 { 00432 struct ast_channel *c; 00433 shutting_down = 1; 00434 if (hangup) { 00435 AST_LIST_LOCK(&channels); 00436 AST_LIST_TRAVERSE(&channels, c, chan_list) 00437 ast_softhangup(c, AST_SOFTHANGUP_SHUTDOWN); 00438 AST_LIST_UNLOCK(&channels); 00439 } 00440 }
int ast_best_codec | ( | int | fmts | ) |
Pick the best audio codec.
Pick the best codec
Okay, ulaw is used by all telephony equipment, so start with it
Unless of course, you're a silly European, so then prefer ALAW
G.722 is better then all below, but not as common as the above... so give ulaw and alaw priority
Okay, well, signed linear is easy to translate into other stuff
G.726 is standard ADPCM, in RFC3551 packing order
G.726 is standard ADPCM, in AAL2 packing order
ADPCM has great sound quality and is still pretty easy to translate
Okay, we're down to vocoders now, so pick GSM because it's small and easier to translate and sounds pretty good
iLBC is not too bad
Speex is free, but computationally more expensive than GSM
Ick, LPC10 sounds terrible, but at least we have code for it, if you're tacky enough to use it
G.729a is faster than 723 and slightly less expensive
Down to G.723.1 which is proprietary but at least designed for voice
Definition at line 655 of file channel.c.
References AST_FORMAT_ADPCM, AST_FORMAT_ALAW, AST_FORMAT_AUDIO_MASK, AST_FORMAT_G722, AST_FORMAT_G723_1, AST_FORMAT_G726, AST_FORMAT_G726_AAL2, AST_FORMAT_G729A, AST_FORMAT_GSM, AST_FORMAT_ILBC, AST_FORMAT_LPC10, AST_FORMAT_SLINEAR, AST_FORMAT_SPEEX, AST_FORMAT_ULAW, ast_log(), LOG_WARNING, and prefs.
Referenced by __login_exec(), __oh323_new(), agent_call(), ast_codec_choose(), ast_iax2_new(), do_atxfer(), echo_exec(), findmeexec(), gtalk_new(), handle_open_receive_channel_ack_message(), iax2_request(), local_new(), mgcp_new(), sip_new(), skinny_new(), socket_process(), and transmit_connect().
00656 { 00657 /* This just our opinion, expressed in code. We are asked to choose 00658 the best codec to use, given no information */ 00659 int x; 00660 static int prefs[] = 00661 { 00662 /*! Okay, ulaw is used by all telephony equipment, so start with it */ 00663 AST_FORMAT_ULAW, 00664 /*! Unless of course, you're a silly European, so then prefer ALAW */ 00665 AST_FORMAT_ALAW, 00666 /*! G.722 is better then all below, but not as common as the above... so give ulaw and alaw priority */ 00667 AST_FORMAT_G722, 00668 /*! Okay, well, signed linear is easy to translate into other stuff */ 00669 AST_FORMAT_SLINEAR, 00670 /*! G.726 is standard ADPCM, in RFC3551 packing order */ 00671 AST_FORMAT_G726, 00672 /*! G.726 is standard ADPCM, in AAL2 packing order */ 00673 AST_FORMAT_G726_AAL2, 00674 /*! ADPCM has great sound quality and is still pretty easy to translate */ 00675 AST_FORMAT_ADPCM, 00676 /*! Okay, we're down to vocoders now, so pick GSM because it's small and easier to 00677 translate and sounds pretty good */ 00678 AST_FORMAT_GSM, 00679 /*! iLBC is not too bad */ 00680 AST_FORMAT_ILBC, 00681 /*! Speex is free, but computationally more expensive than GSM */ 00682 AST_FORMAT_SPEEX, 00683 /*! Ick, LPC10 sounds terrible, but at least we have code for it, if you're tacky enough 00684 to use it */ 00685 AST_FORMAT_LPC10, 00686 /*! G.729a is faster than 723 and slightly less expensive */ 00687 AST_FORMAT_G729A, 00688 /*! Down to G.723.1 which is proprietary but at least designed for voice */ 00689 AST_FORMAT_G723_1, 00690 }; 00691 00692 /* Strip out video */ 00693 fmts &= AST_FORMAT_AUDIO_MASK; 00694 00695 /* Find the first preferred codec in the format given */ 00696 for (x=0; x < (sizeof(prefs) / sizeof(prefs[0]) ); x++) 00697 if (fmts & prefs[x]) 00698 return prefs[x]; 00699 ast_log(LOG_WARNING, "Don't know any of 0x%x formats\n", fmts); 00700 return 0; 00701 }
struct ast_channel* ast_bridged_channel | ( | struct ast_channel * | chan | ) |
Find bridged channel.
chan | Current channel |
Definition at line 3864 of file channel.c.
References ast_channel::_bridge, ast_channel_tech::bridged_channel, and ast_channel::tech.
Referenced by __dahdi_exception(), action_agents(), agents_show(), agents_show_online(), ast_bridge_call(), ast_channel_masquerade(), attempt_transfer(), cb_events(), check_bridge(), common_exec(), console_transfer(), console_transfer_deprecated(), create_jb(), dahdi_handle_event(), dahdi_hangup(), export_aoc_vars(), handle_chanlist(), handle_chanlist_deprecated(), handle_hd_hf(), handle_invite_replaces(), handle_request(), handle_request_bye(), handle_request_info(), handle_request_invite(), handle_request_refer(), handle_response_invite(), handle_showchan(), handle_showchan_deprecated(), local_attended_transfer(), mgcp_hangup(), mgcp_ss(), misdn_transfer_bc(), mixmonitor_thread(), park_call_full(), schedule_delivery(), sip_read(), socket_process(), ss_thread(), start_spying(), and startmon().
03865 { 03866 struct ast_channel *bridged; 03867 bridged = chan->_bridge; 03868 if (bridged && bridged->tech->bridged_channel) 03869 bridged = bridged->tech->bridged_channel(chan, bridged); 03870 return bridged; 03871 }
int ast_call | ( | struct ast_channel * | chan, | |
char * | addr, | |||
int | timeout | |||
) |
Make a call.
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. |
Definition at line 3192 of file channel.c.
References AST_CDR_FLAG_DIALED, ast_channel_lock, ast_channel_unlock, ast_check_hangup(), AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, ast_set_flag, ast_test_flag, ast_channel_tech::call, ast_channel::cdr, and ast_channel::tech.
Referenced by __ast_request_and_dial(), agent_call(), ast_feature_request_and_dial(), attempt_reconnect(), begin_dial(), connect_link(), do_idle_thread(), features_call(), findmeexec(), ring_entry(), rpt(), and wait_for_answer().
03193 { 03194 /* Place an outgoing call, but don't wait any longer than timeout ms before returning. 03195 If the remote end does not answer within the timeout, then do NOT hang up, but 03196 return anyway. */ 03197 int res = -1; 03198 /* Stop if we're a zombie or need a soft hangup */ 03199 ast_channel_lock(chan); 03200 if (!ast_test_flag(chan, AST_FLAG_ZOMBIE) && !ast_check_hangup(chan)) { 03201 if (chan->cdr) 03202 ast_set_flag(chan->cdr, AST_CDR_FLAG_DIALED); 03203 if (chan->tech->call) 03204 res = chan->tech->call(chan, addr, timeout); 03205 ast_set_flag(chan, AST_FLAG_OUTGOING); 03206 } 03207 ast_channel_unlock(chan); 03208 return res; 03209 }
void ast_cancel_shutdown | ( | void | ) |
Cancel a shutdown in progress.
Cancels an existing shutdown and returns to normal operation
Definition at line 455 of file channel.c.
Referenced by handle_abort_halt().
00456 { 00457 shutting_down = 0; 00458 }
const char* ast_cause2str | ( | int | state | ) |
Gives the string form of a given hangup cause.
state | cause to get the description of Give a name to a cause code Returns the text form of the binary cause code given |
Definition at line 575 of file channel.c.
Referenced by __transmit_response(), ast_do_masquerade(), ast_hangup(), findmeexec(), pbx_retrieve_variable(), sip_hangup(), and transmit_request_with_auth().
00576 { 00577 int x; 00578 00579 for (x=0; x < sizeof(causes) / sizeof(causes[0]); x++) { 00580 if (causes[x].cause == cause) 00581 return causes[x].desc; 00582 } 00583 00584 return "Unknown"; 00585 }
void ast_change_name | ( | struct ast_channel * | chan, | |
char * | newname | |||
) |
Change channel name.
Definition at line 3442 of file channel.c.
References ast_string_field_set, manager_event(), ast_channel::name, name, and ast_channel::uniqueid.
03443 { 03444 manager_event(EVENT_FLAG_CALL, "Rename", "Oldname: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", chan->name, newname, chan->uniqueid); 03445 ast_string_field_set(chan, name, newname); 03446 }
struct ast_channel* ast_channel_alloc | ( | int | needqueue, | |
int | state, | |||
const char * | cid_num, | |||
const char * | cid_name, | |||
const char * | acctcode, | |||
const char * | exten, | |||
const char * | context, | |||
const int | amaflag, | |||
const char * | name_fmt, | |||
... | ||||
) |
Create a channel structure.
Definition at line 709 of file channel.c.
References ast_calloc, ast_log(), AST_MAX_FDS, ast_string_field_init, DAHDI_FILE_TIMER, ast_channel::flags, free, LOG_WARNING, sched_context_create(), and sched_context_destroy().
Referenced by __oh323_new(), acf_odbc_read(), acf_odbc_write(), action_getvar(), agent_new(), alsa_new(), ast_async_goto(), ast_iax2_new(), ast_pbx_outgoing_cdr_failed(), ast_pbx_outgoing_exten(), check_goto_on_transfer(), dahdi_new(), do_atxfer(), features_new(), gtalk_new(), iax_park(), local_new(), make_email_file(), masq_park_call(), mgcp_new(), misdn_new(), nbs_new(), oss_new(), pbx_substitute_variables_helper_full(), phone_new(), sendpage(), sip_new(), sip_park(), and skinny_new().
00710 { 00711 struct ast_channel *tmp; 00712 int x; 00713 int flags; 00714 struct varshead *headp; 00715 va_list ap1, ap2; 00716 00717 /* If shutting down, don't allocate any new channels */ 00718 if (shutting_down) { 00719 ast_log(LOG_WARNING, "Channel allocation failed: Refusing due to active shutdown\n"); 00720 return NULL; 00721 } 00722 00723 if (!(tmp = ast_calloc(1, sizeof(*tmp)))) 00724 return NULL; 00725 00726 if (!(tmp->sched = sched_context_create())) { 00727 ast_log(LOG_WARNING, "Channel allocation failed: Unable to create schedule context\n"); 00728 free(tmp); 00729 return NULL; 00730 } 00731 00732 if ((ast_string_field_init(tmp, 128))) { 00733 sched_context_destroy(tmp->sched); 00734 free(tmp); 00735 return NULL; 00736 } 00737 00738 /* Don't bother initializing the last two FD here, because they 00739 will *always* be set just a few lines down (AST_TIMING_FD, 00740 AST_ALERT_FD). */ 00741 for (x = 0; x < AST_MAX_FDS - 2; x++) 00742 tmp->fds[x] = -1; 00743 00744 #ifdef HAVE_DAHDI 00745 00746 tmp->timingfd = open(DAHDI_FILE_TIMER, O_RDWR); 00747 00748 if (tmp->timingfd > -1) { 00749 /* Check if timing interface supports new 00750 ping/pong scheme */ 00751 flags = 1; 00752 if (!ioctl(tmp->timingfd, DAHDI_TIMERPONG, &flags)) 00753 needqueue = 0; 00754 } 00755 #else 00756 tmp->timingfd = -1; 00757 #endif 00758 00759 if (needqueue) { 00760 if (pipe(tmp->alertpipe)) { 00761 ast_log(LOG_WARNING, "Channel allocation failed: Can't create alert pipe!\n"); 00762 alertpipe_failed: 00763 #ifdef HAVE_DAHDI 00764 if (tmp->timingfd > -1) 00765 close(tmp->timingfd); 00766 #endif 00767 sched_context_destroy(tmp->sched); 00768 ast_string_field_free_memory(tmp); 00769 free(tmp); 00770 return NULL; 00771 } else { 00772 flags = fcntl(tmp->alertpipe[0], F_GETFL); 00773 if (fcntl(tmp->alertpipe[0], F_SETFL, flags | O_NONBLOCK) < 0) { 00774 ast_log(LOG_WARNING, "Channel allocation failed: Unable to set alertpipe nonblocking! (%d: %s)\n", errno, strerror(errno)); 00775 close(tmp->alertpipe[0]); 00776 close(tmp->alertpipe[1]); 00777 goto alertpipe_failed; 00778 } 00779 flags = fcntl(tmp->alertpipe[1], F_GETFL); 00780 if (fcntl(tmp->alertpipe[1], F_SETFL, flags | O_NONBLOCK) < 0) { 00781 ast_log(LOG_WARNING, "Channel allocation failed: Unable to set alertpipe nonblocking! (%d: %s)\n", errno, strerror(errno)); 00782 close(tmp->alertpipe[0]); 00783 close(tmp->alertpipe[1]); 00784 goto alertpipe_failed; 00785 } 00786 } 00787 } else /* Make sure we've got it done right if they don't */ 00788 tmp->alertpipe[0] = tmp->alertpipe[1] = -1; 00789 00790 /* Always watch the alertpipe */ 00791 tmp->fds[AST_ALERT_FD] = tmp->alertpipe[0]; 00792 /* And timing pipe */ 00793 tmp->fds[AST_TIMING_FD] = tmp->timingfd; 00794 ast_string_field_set(tmp, name, "**Unknown**"); 00795 00796 /* Initial state */ 00797 tmp->_state = state; 00798 00799 tmp->streamid = -1; 00800 00801 tmp->fin = global_fin; 00802 tmp->fout = global_fout; 00803 00804 if (ast_strlen_zero(ast_config_AST_SYSTEM_NAME)) { 00805 ast_string_field_build(tmp, uniqueid, "%li.%d", (long) time(NULL), 00806 ast_atomic_fetchadd_int(&uniqueint, 1)); 00807 } else { 00808 ast_string_field_build(tmp, uniqueid, "%s-%li.%d", ast_config_AST_SYSTEM_NAME, 00809 (long) time(NULL), ast_atomic_fetchadd_int(&uniqueint, 1)); 00810 } 00811 00812 tmp->cid.cid_name = ast_strdup(cid_name); 00813 tmp->cid.cid_num = ast_strdup(cid_num); 00814 00815 if (!ast_strlen_zero(name_fmt)) { 00816 /* Almost every channel is calling this function, and setting the name via the ast_string_field_build() call. 00817 * And they all use slightly different formats for their name string. 00818 * This means, to set the name here, we have to accept variable args, and call the string_field_build from here. 00819 * This means, that the stringfields must have a routine that takes the va_lists directly, and 00820 * uses them to build the string, instead of forming the va_lists internally from the vararg ... list. 00821 * This new function was written so this can be accomplished. 00822 */ 00823 va_start(ap1, name_fmt); 00824 va_start(ap2, name_fmt); 00825 ast_string_field_build_va(tmp, name, name_fmt, ap1, ap2); 00826 va_end(ap1); 00827 va_end(ap2); 00828 } 00829 00830 /* Reminder for the future: under what conditions do we NOT want to track cdrs on channels? */ 00831 00832 /* These 4 variables need to be set up for the cdr_init() to work right */ 00833 if (amaflag) 00834 tmp->amaflags = amaflag; 00835 else 00836 tmp->amaflags = ast_default_amaflags; 00837 00838 if (!ast_strlen_zero(acctcode)) 00839 ast_string_field_set(tmp, accountcode, acctcode); 00840 else 00841 ast_string_field_set(tmp, accountcode, ast_default_accountcode); 00842 00843 if (!ast_strlen_zero(context)) 00844 ast_copy_string(tmp->context, context, sizeof(tmp->context)); 00845 else 00846 strcpy(tmp->context, "default"); 00847 00848 if (!ast_strlen_zero(exten)) 00849 ast_copy_string(tmp->exten, exten, sizeof(tmp->exten)); 00850 else 00851 strcpy(tmp->exten, "s"); 00852 00853 tmp->priority = 1; 00854 00855 tmp->cdr = ast_cdr_alloc(); 00856 ast_cdr_init(tmp->cdr, tmp); 00857 ast_cdr_start(tmp->cdr); 00858 00859 headp = &tmp->varshead; 00860 AST_LIST_HEAD_INIT_NOLOCK(headp); 00861 00862 ast_mutex_init(&tmp->lock); 00863 00864 AST_LIST_HEAD_INIT_NOLOCK(&tmp->datastores); 00865 00866 ast_string_field_set(tmp, language, defaultlanguage); 00867 00868 tmp->tech = &null_tech; 00869 00870 AST_LIST_LOCK(&channels); 00871 AST_LIST_INSERT_HEAD(&channels, tmp, chan_list); 00872 AST_LIST_UNLOCK(&channels); 00873 00874 /*\!note 00875 * and now, since the channel structure is built, and has its name, let's 00876 * call the manager event generator with this Newchannel event. This is the 00877 * proper and correct place to make this call, but you sure do have to pass 00878 * a lot of data into this func to do it here! 00879 */ 00880 if (!ast_strlen_zero(name_fmt)) { 00881 manager_event(EVENT_FLAG_CALL, "Newchannel", 00882 "Channel: %s\r\n" 00883 "State: %s\r\n" 00884 "CallerIDNum: %s\r\n" 00885 "CallerIDName: %s\r\n" 00886 "Uniqueid: %s\r\n", 00887 tmp->name, ast_state2str(state), 00888 S_OR(cid_num, "<unknown>"), 00889 S_OR(cid_name, "<unknown>"), 00890 tmp->uniqueid); 00891 } 00892 00893 return tmp; 00894 }
enum ast_bridge_result ast_channel_bridge | ( | struct ast_channel * | c0, | |
struct ast_channel * | c1, | |||
struct ast_bridge_config * | config, | |||
struct ast_frame ** | fo, | |||
struct ast_channel ** | rc | |||
) |
Bridge two channels together.
Bridge two channels together
c0 | first channel to bridge | |
c1 | second channel to bridge | |
config | config for the channels | |
fo | destination frame(?) | |
rc | destination channel(?) Bridge two channels (c0 and c1) together. If an important frame occurs, we return that frame in rf (remember, it could be NULL) and which channel (0 or 1) in rc |
Definition at line 4063 of file channel.c.
References ast_channel::_bridge, ast_channel::_softhangup, AST_BRIDGE_COMPLETE, AST_BRIDGE_FAILED, AST_BRIDGE_FAILED_NOWARN, AST_BRIDGE_RETRY, ast_channel_make_compatible(), ast_check_hangup(), ast_check_hangup_locked(), ast_clear_flag, AST_CONTROL_SRCUPDATE, AST_FEATURE_PLAY_WARNING, AST_FEATURE_REDIRECT, AST_FEATURE_WARNING_ACTIVE, AST_FLAG_END_DTMF_ONLY, AST_FLAG_NBRIDGE, AST_FLAG_ZOMBIE, ast_generic_bridge(), ast_indicate(), ast_log(), ast_samp2tv(), ast_set_flag, AST_SOFTHANGUP_UNBRIDGE, ast_strlen_zero(), ast_test_flag, ast_tvadd(), ast_tvdiff_ms(), ast_tvnow(), ast_tvsub(), ast_tvzero(), ast_verbose(), ast_channel::audiohooks, ast_channel_tech::bridge, bridge_playfile(), ast_channel::cid, ast_callerid::cid_num, config, ast_channel::generator, LOG_DEBUG, manager_event(), ast_channel::masq, ast_channel::masqr, ast_channel::monitor, ast_channel::name, ast_channel::nativeformats, option_debug, option_verbose, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), ast_channel::readformat, ast_channel_tech::send_digit_begin, t, ast_channel::tech, ast_channel::uniqueid, VERBOSE_PREFIX_3, and ast_channel::writeformat.
Referenced by ast_bridge_call().
04065 { 04066 struct ast_channel *who = NULL; 04067 enum ast_bridge_result res = AST_BRIDGE_COMPLETE; 04068 int nativefailed=0; 04069 int firstpass; 04070 int o0nativeformats; 04071 int o1nativeformats; 04072 long time_left_ms=0; 04073 char caller_warning = 0; 04074 char callee_warning = 0; 04075 04076 if (c0->_bridge) { 04077 ast_log(LOG_WARNING, "%s is already in a bridge with %s\n", 04078 c0->name, c0->_bridge->name); 04079 return -1; 04080 } 04081 if (c1->_bridge) { 04082 ast_log(LOG_WARNING, "%s is already in a bridge with %s\n", 04083 c1->name, c1->_bridge->name); 04084 return -1; 04085 } 04086 04087 /* Stop if we're a zombie or need a soft hangup */ 04088 if (ast_test_flag(c0, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c0) || 04089 ast_test_flag(c1, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c1)) 04090 return -1; 04091 04092 *fo = NULL; 04093 firstpass = config->firstpass; 04094 config->firstpass = 0; 04095 04096 if (ast_tvzero(config->start_time)) 04097 config->start_time = ast_tvnow(); 04098 time_left_ms = config->timelimit; 04099 04100 caller_warning = ast_test_flag(&config->features_caller, AST_FEATURE_PLAY_WARNING); 04101 callee_warning = ast_test_flag(&config->features_callee, AST_FEATURE_PLAY_WARNING); 04102 04103 if (config->start_sound && firstpass) { 04104 if (caller_warning) 04105 bridge_playfile(c0, c1, config->start_sound, time_left_ms / 1000); 04106 if (callee_warning) 04107 bridge_playfile(c1, c0, config->start_sound, time_left_ms / 1000); 04108 } 04109 04110 /* Keep track of bridge */ 04111 c0->_bridge = c1; 04112 c1->_bridge = c0; 04113 04114 /* \todo XXX here should check that cid_num is not NULL */ 04115 manager_event(EVENT_FLAG_CALL, "Link", 04116 "Channel1: %s\r\n" 04117 "Channel2: %s\r\n" 04118 "Uniqueid1: %s\r\n" 04119 "Uniqueid2: %s\r\n" 04120 "CallerID1: %s\r\n" 04121 "CallerID2: %s\r\n", 04122 c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num); 04123 04124 o0nativeformats = c0->nativeformats; 04125 o1nativeformats = c1->nativeformats; 04126 04127 if (config->feature_timer && !ast_tvzero(config->nexteventts)) { 04128 config->nexteventts = ast_tvadd(config->start_time, ast_samp2tv(config->feature_timer, 1000)); 04129 } else if (config->timelimit && firstpass) { 04130 config->nexteventts = ast_tvadd(config->start_time, ast_samp2tv(config->timelimit, 1000)); 04131 if (caller_warning || callee_warning) 04132 config->nexteventts = ast_tvsub(config->nexteventts, ast_samp2tv(config->play_warning, 1000)); 04133 } 04134 04135 if (!c0->tech->send_digit_begin) 04136 ast_set_flag(c1, AST_FLAG_END_DTMF_ONLY); 04137 if (!c1->tech->send_digit_begin) 04138 ast_set_flag(c0, AST_FLAG_END_DTMF_ONLY); 04139 04140 /* Before we enter in and bridge these two together tell them both the source of audio has changed */ 04141 ast_indicate(c0, AST_CONTROL_SRCUPDATE); 04142 ast_indicate(c1, AST_CONTROL_SRCUPDATE); 04143 04144 for (/* ever */;;) { 04145 struct timeval now = { 0, }; 04146 int to; 04147 04148 to = -1; 04149 04150 if (!ast_tvzero(config->nexteventts)) { 04151 now = ast_tvnow(); 04152 to = ast_tvdiff_ms(config->nexteventts, now); 04153 if (to <= 0) { 04154 if (!config->timelimit) { 04155 res = AST_BRIDGE_COMPLETE; 04156 break; 04157 } 04158 to = 0; 04159 } 04160 } 04161 04162 if (config->timelimit) { 04163 time_left_ms = config->timelimit - ast_tvdiff_ms(now, config->start_time); 04164 if (time_left_ms < to) 04165 to = time_left_ms; 04166 04167 if (time_left_ms <= 0) { 04168 if (caller_warning && config->end_sound) 04169 bridge_playfile(c0, c1, config->end_sound, 0); 04170 if (callee_warning && config->end_sound) 04171 bridge_playfile(c1, c0, config->end_sound, 0); 04172 *fo = NULL; 04173 if (who) 04174 *rc = who; 04175 res = 0; 04176 break; 04177 } 04178 04179 if (!to) { 04180 if (time_left_ms >= 5000 && config->warning_sound && config->play_warning && ast_test_flag(config, AST_FEATURE_WARNING_ACTIVE)) { 04181 int t = (time_left_ms + 500) / 1000; /* round to nearest second */ 04182 if (caller_warning) 04183 bridge_playfile(c0, c1, config->warning_sound, t); 04184 if (callee_warning) 04185 bridge_playfile(c1, c0, config->warning_sound, t); 04186 } 04187 if (config->warning_freq && (time_left_ms > (config->warning_freq + 5000))) 04188 config->nexteventts = ast_tvadd(config->nexteventts, ast_samp2tv(config->warning_freq, 1000)); 04189 else 04190 config->nexteventts = ast_tvadd(config->start_time, ast_samp2tv(config->timelimit, 1000)); 04191 } 04192 ast_clear_flag(config, AST_FEATURE_WARNING_ACTIVE); 04193 } 04194 04195 if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE || c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE) { 04196 if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE) 04197 c0->_softhangup = 0; 04198 if (c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE) 04199 c1->_softhangup = 0; 04200 c0->_bridge = c1; 04201 c1->_bridge = c0; 04202 if (option_debug) 04203 ast_log(LOG_DEBUG, "Unbridge signal received. Ending native bridge.\n"); 04204 continue; 04205 } 04206 04207 /* Stop if we're a zombie or need a soft hangup */ 04208 if (ast_test_flag(c0, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c0) || 04209 ast_test_flag(c1, AST_FLAG_ZOMBIE) || ast_check_hangup_locked(c1)) { 04210 *fo = NULL; 04211 if (who) 04212 *rc = who; 04213 res = 0; 04214 if (option_debug) 04215 ast_log(LOG_DEBUG, "Bridge stops because we're zombie or need a soft hangup: c0=%s, c1=%s, flags: %s,%s,%s,%s\n", 04216 c0->name, c1->name, 04217 ast_test_flag(c0, AST_FLAG_ZOMBIE) ? "Yes" : "No", 04218 ast_check_hangup(c0) ? "Yes" : "No", 04219 ast_test_flag(c1, AST_FLAG_ZOMBIE) ? "Yes" : "No", 04220 ast_check_hangup(c1) ? "Yes" : "No"); 04221 break; 04222 } 04223 04224 /* See if the BRIDGEPEER variable needs to be updated */ 04225 if (!ast_strlen_zero(pbx_builtin_getvar_helper(c0, "BRIDGEPEER"))) 04226 pbx_builtin_setvar_helper(c0, "BRIDGEPEER", c1->name); 04227 if (!ast_strlen_zero(pbx_builtin_getvar_helper(c1, "BRIDGEPEER"))) 04228 pbx_builtin_setvar_helper(c1, "BRIDGEPEER", c0->name); 04229 04230 if (c0->tech->bridge && 04231 (config->timelimit == 0) && 04232 (c0->tech->bridge == c1->tech->bridge) && 04233 !nativefailed && !c0->monitor && !c1->monitor && 04234 !c0->audiohooks && !c1->audiohooks && !ast_test_flag(&(config->features_callee),AST_FEATURE_REDIRECT) && 04235 !ast_test_flag(&(config->features_caller),AST_FEATURE_REDIRECT) && 04236 !c0->masq && !c0->masqr && !c1->masq && !c1->masqr) { 04237 /* Looks like they share a bridge method and nothing else is in the way */ 04238 ast_set_flag(c0, AST_FLAG_NBRIDGE); 04239 ast_set_flag(c1, AST_FLAG_NBRIDGE); 04240 if ((res = c0->tech->bridge(c0, c1, config->flags, fo, rc, to)) == AST_BRIDGE_COMPLETE) { 04241 /* \todo XXX here should check that cid_num is not NULL */ 04242 manager_event(EVENT_FLAG_CALL, "Unlink", 04243 "Channel1: %s\r\n" 04244 "Channel2: %s\r\n" 04245 "Uniqueid1: %s\r\n" 04246 "Uniqueid2: %s\r\n" 04247 "CallerID1: %s\r\n" 04248 "CallerID2: %s\r\n", 04249 c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num); 04250 if (option_debug) 04251 ast_log(LOG_DEBUG, "Returning from native bridge, channels: %s, %s\n", c0->name, c1->name); 04252 04253 ast_clear_flag(c0, AST_FLAG_NBRIDGE); 04254 ast_clear_flag(c1, AST_FLAG_NBRIDGE); 04255 04256 if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE || c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE) 04257 continue; 04258 04259 c0->_bridge = NULL; 04260 c1->_bridge = NULL; 04261 04262 return res; 04263 } else { 04264 ast_clear_flag(c0, AST_FLAG_NBRIDGE); 04265 ast_clear_flag(c1, AST_FLAG_NBRIDGE); 04266 } 04267 switch (res) { 04268 case AST_BRIDGE_RETRY: 04269 continue; 04270 default: 04271 if (option_verbose > 2) 04272 ast_verbose(VERBOSE_PREFIX_3 "Native bridging %s and %s ended\n", 04273 c0->name, c1->name); 04274 /* fallthrough */ 04275 case AST_BRIDGE_FAILED_NOWARN: 04276 nativefailed++; 04277 break; 04278 } 04279 } 04280 04281 if (((c0->writeformat != c1->readformat) || (c0->readformat != c1->writeformat) || 04282 (c0->nativeformats != o0nativeformats) || (c1->nativeformats != o1nativeformats)) && 04283 !(c0->generator || c1->generator)) { 04284 if (ast_channel_make_compatible(c0, c1)) { 04285 ast_log(LOG_WARNING, "Can't make %s and %s compatible\n", c0->name, c1->name); 04286 /* \todo XXX here should check that cid_num is not NULL */ 04287 manager_event(EVENT_FLAG_CALL, "Unlink", 04288 "Channel1: %s\r\n" 04289 "Channel2: %s\r\n" 04290 "Uniqueid1: %s\r\n" 04291 "Uniqueid2: %s\r\n" 04292 "CallerID1: %s\r\n" 04293 "CallerID2: %s\r\n", 04294 c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num); 04295 return AST_BRIDGE_FAILED; 04296 } 04297 o0nativeformats = c0->nativeformats; 04298 o1nativeformats = c1->nativeformats; 04299 } 04300 04301 if (!ast_strlen_zero(pbx_builtin_getvar_helper(c0, "BRIDGEPEER"))) 04302 pbx_builtin_setvar_helper(c0, "BRIDGEPEER", c1->name); 04303 if (!ast_strlen_zero(pbx_builtin_getvar_helper(c1, "BRIDGEPEER"))) 04304 pbx_builtin_setvar_helper(c1, "BRIDGEPEER", c0->name); 04305 04306 res = ast_generic_bridge(c0, c1, config, fo, rc, config->nexteventts); 04307 if (res != AST_BRIDGE_RETRY) { 04308 break; 04309 } else if (config->feature_timer) { 04310 /* feature timer expired but has not been updated, sending to ast_bridge_call to do so */ 04311 break; 04312 } 04313 } 04314 04315 ast_clear_flag(c0, AST_FLAG_END_DTMF_ONLY); 04316 ast_clear_flag(c1, AST_FLAG_END_DTMF_ONLY); 04317 04318 /* Now that we have broken the bridge the source will change yet again */ 04319 ast_indicate(c0, AST_CONTROL_SRCUPDATE); 04320 ast_indicate(c1, AST_CONTROL_SRCUPDATE); 04321 04322 c0->_bridge = NULL; 04323 c1->_bridge = NULL; 04324 04325 /* \todo XXX here should check that cid_num is not NULL */ 04326 manager_event(EVENT_FLAG_CALL, "Unlink", 04327 "Channel1: %s\r\n" 04328 "Channel2: %s\r\n" 04329 "Uniqueid1: %s\r\n" 04330 "Uniqueid2: %s\r\n" 04331 "CallerID1: %s\r\n" 04332 "CallerID2: %s\r\n", 04333 c0->name, c1->name, c0->uniqueid, c1->uniqueid, c0->cid.cid_num, c1->cid.cid_num); 04334 if (option_debug) 04335 ast_log(LOG_DEBUG, "Bridge stops bridging channels %s and %s\n", c0->name, c1->name); 04336 04337 return res; 04338 }
int ast_channel_cmpwhentohangup | ( | struct ast_channel * | chan, | |
time_t | offset | |||
) |
Compare a offset with the settings of when to hang a channel up.
chan | channel on which to check for hang up | |
offset | offset in seconds from current time |
Definition at line 475 of file channel.c.
References ast_channel::whentohangup.
00476 { 00477 time_t whentohangup; 00478 00479 if (chan->whentohangup == 0) { 00480 return (offset == 0) ? 0 : -1; 00481 } else { 00482 if (offset == 0) /* XXX why is this special ? */ 00483 return (1); 00484 else { 00485 whentohangup = offset + time (NULL); 00486 if (chan->whentohangup < whentohangup) 00487 return (1); 00488 else if (chan->whentohangup == whentohangup) 00489 return (0); 00490 else 00491 return (-1); 00492 } 00493 } 00494 }
int ast_channel_datastore_add | ( | struct ast_channel * | chan, | |
struct ast_datastore * | datastore | |||
) |
Add a datastore to a channel.
Definition at line 1370 of file channel.c.
References AST_LIST_INSERT_HEAD, ast_channel::datastores, and ast_datastore::entry.
Referenced by _macro_exec(), add_features_datastores(), setup_chanspy_ds(), setup_inheritance_datastore(), setup_mixmonitor_ds(), setup_transfer_datastore(), smdi_msg_retrieve_read(), speech_create(), and try_calling().
01371 { 01372 int res = 0; 01373 01374 AST_LIST_INSERT_HEAD(&chan->datastores, datastore, entry); 01375 01376 return res; 01377 }
struct ast_datastore* ast_channel_datastore_alloc | ( | const struct ast_datastore_info * | info, | |
char * | uid | |||
) |
Create a channel datastore structure.
Definition at line 1309 of file channel.c.
References ast_calloc, ast_strdup, and ast_datastore::info.
Referenced by _macro_exec(), add_features_datastores(), ast_channel_datastore_inherit(), setup_chanspy_ds(), setup_inheritance_datastore(), setup_mixmonitor_ds(), setup_transfer_datastore(), smdi_msg_retrieve_read(), speech_create(), and try_calling().
01310 { 01311 struct ast_datastore *datastore = NULL; 01312 01313 /* Make sure we at least have type so we can identify this */ 01314 if (info == NULL) { 01315 return NULL; 01316 } 01317 01318 /* Allocate memory for datastore and clear it */ 01319 datastore = ast_calloc(1, sizeof(*datastore)); 01320 if (datastore == NULL) { 01321 return NULL; 01322 } 01323 01324 datastore->info = info; 01325 01326 datastore->uid = ast_strdup(uid); 01327 01328 return datastore; 01329 }
struct ast_datastore* ast_channel_datastore_find | ( | struct ast_channel * | chan, | |
const struct ast_datastore_info * | info, | |||
char * | uid | |||
) |
Find a datastore on a channel.
Definition at line 1397 of file channel.c.
References AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_channel::datastores, ast_datastore::entry, ast_datastore::info, and ast_datastore::uid.
Referenced by _macro_exec(), add_features_datastores(), attended_transfer_occurred(), chanspy_ds_free(), do_atxfer(), do_parking_thread(), find_speech(), func_inheritance_write(), park_exec(), queue_transfer_fixup(), smdi_msg_read(), speech_background(), speech_destroy(), and try_calling().
01398 { 01399 struct ast_datastore *datastore = NULL; 01400 01401 if (info == NULL) 01402 return NULL; 01403 01404 AST_LIST_TRAVERSE_SAFE_BEGIN(&chan->datastores, datastore, entry) { 01405 if (datastore->info == info) { 01406 if (uid != NULL && datastore->uid != NULL) { 01407 if (!strcasecmp(uid, datastore->uid)) { 01408 /* Matched by type AND uid */ 01409 break; 01410 } 01411 } else { 01412 /* Matched by type at least */ 01413 break; 01414 } 01415 } 01416 } 01417 AST_LIST_TRAVERSE_SAFE_END 01418 01419 return datastore; 01420 }
int ast_channel_datastore_free | ( | struct ast_datastore * | datastore | ) |
Free a channel datastore structure.
Definition at line 1331 of file channel.c.
References ast_datastore::data, ast_datastore_info::destroy, free, ast_datastore::info, and ast_datastore::uid.
Referenced by add_features_datastores(), ast_channel_free(), chanspy_ds_free(), setup_inheritance_datastore(), and try_calling().
01332 { 01333 int res = 0; 01334 01335 /* Using the destroy function (if present) destroy the data */ 01336 if (datastore->info->destroy != NULL && datastore->data != NULL) { 01337 datastore->info->destroy(datastore->data); 01338 datastore->data = NULL; 01339 } 01340 01341 /* Free allocated UID memory */ 01342 if (datastore->uid != NULL) { 01343 free(datastore->uid); 01344 datastore->uid = NULL; 01345 } 01346 01347 /* Finally free memory used by ourselves */ 01348 free(datastore); 01349 01350 return res; 01351 }
int ast_channel_datastore_inherit | ( | struct ast_channel * | from, | |
struct ast_channel * | to | |||
) |
Inherit datastores from a parent to a child.
Definition at line 1353 of file channel.c.
References ast_channel_datastore_alloc(), AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_datastore::data, DATASTORE_INHERIT_FOREVER, ast_channel::datastores, ast_datastore_info::duplicate, ast_datastore::entry, ast_datastore::info, ast_datastore::inheritance, and ast_datastore::uid.
Referenced by local_call(), and wait_for_answer().
01354 { 01355 struct ast_datastore *datastore = NULL, *datastore2; 01356 01357 AST_LIST_TRAVERSE(&from->datastores, datastore, entry) { 01358 if (datastore->inheritance > 0) { 01359 datastore2 = ast_channel_datastore_alloc(datastore->info, datastore->uid); 01360 if (datastore2) { 01361 datastore2->data = datastore->info->duplicate ? datastore->info->duplicate(datastore->data) : NULL; 01362 datastore2->inheritance = datastore->inheritance == DATASTORE_INHERIT_FOREVER ? DATASTORE_INHERIT_FOREVER : datastore->inheritance - 1; 01363 AST_LIST_INSERT_TAIL(&to->datastores, datastore2, entry); 01364 } 01365 } 01366 } 01367 return 0; 01368 }
int ast_channel_datastore_remove | ( | struct ast_channel * | chan, | |
struct ast_datastore * | datastore | |||
) |
Remove a datastore from a channel.
Definition at line 1379 of file channel.c.
References AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_channel::datastores, and ast_datastore::entry.
Referenced by chanspy_ds_free(), queue_transfer_fixup(), speech_background(), speech_destroy(), and try_calling().
01380 { 01381 struct ast_datastore *datastore2 = NULL; 01382 int res = -1; 01383 01384 /* Find our position and remove ourselves */ 01385 AST_LIST_TRAVERSE_SAFE_BEGIN(&chan->datastores, datastore2, entry) { 01386 if (datastore2 == datastore) { 01387 AST_LIST_REMOVE_CURRENT(&chan->datastores, entry); 01388 res = 0; 01389 break; 01390 } 01391 } 01392 AST_LIST_TRAVERSE_SAFE_END 01393 01394 return res; 01395 }
int ast_channel_defer_dtmf | ( | struct ast_channel * | chan | ) |
Set defer DTMF flag on channel.
Defer DTMF so that you only read things like hangups and audio. Returns non-zero if channel was already DTMF-deferred or 0 if channel is just now being DTMF-deferred
Definition at line 1007 of file channel.c.
References AST_FLAG_DEFER_DTMF, ast_set_flag, and ast_test_flag.
Referenced by __adsi_transmit_messages(), and find_cache().
01008 { 01009 int pre = 0; 01010 01011 if (chan) { 01012 pre = ast_test_flag(chan, AST_FLAG_DEFER_DTMF); 01013 ast_set_flag(chan, AST_FLAG_DEFER_DTMF); 01014 } 01015 return pre; 01016 }
void ast_channel_free | ( | struct ast_channel * | chan | ) |
Free a channel structure.
Definition at line 1214 of file channel.c.
References ast_channel::alertpipe, ast_app_group_discard(), ast_cdr_discard(), ast_channel_datastore_free(), ast_channel_lock, AST_CHANNEL_NAME, ast_channel_unlock, ast_copy_string(), ast_device_state_changed_literal(), ast_frfree, ast_jb_destroy(), AST_LIST_LOCK, AST_LIST_REMOVE, AST_LIST_REMOVE_HEAD, AST_LIST_UNLOCK, ast_log(), ast_moh_cleanup(), ast_mutex_destroy(), ast_string_field_free_memory, ast_translator_free_path(), ast_var_delete(), ast_channel::cdr, ast_channel::cid, ast_channel::datastores, ast_datastore::entry, f, free, free_cid(), ast_channel::lock, LOG_ERROR, ast_channel::monitor, ast_channel::music_state, name, ast_channel::name, ast_channel::pbx, ast_channel::readq, ast_channel::readtrans, ast_channel::sched, sched_context_destroy(), ast_channel_monitor::stop, ast_channel::tech_pvt, ast_channel::timingfd, ast_channel::varshead, and ast_channel::writetrans.
Referenced by acf_odbc_read(), acf_odbc_write(), action_getvar(), agent_cleanup(), agent_new(), ast_do_masquerade(), ast_hangup(), ast_iax2_new(), ast_pbx_outgoing_cdr_failed(), gtalk_newcall(), local_new(), make_email_file(), pbx_substitute_variables_helper_full(), and sendpage().
01215 { 01216 int fd; 01217 struct ast_var_t *vardata; 01218 struct ast_frame *f; 01219 struct varshead *headp; 01220 struct ast_datastore *datastore = NULL; 01221 char name[AST_CHANNEL_NAME], *dashptr; 01222 01223 headp=&chan->varshead; 01224 01225 AST_LIST_LOCK(&channels); 01226 if (!AST_LIST_REMOVE(&channels, chan, chan_list)) { 01227 AST_LIST_UNLOCK(&channels); 01228 ast_log(LOG_ERROR, "Unable to find channel in list to free. Assuming it has already been done.\n"); 01229 } 01230 /* Lock and unlock the channel just to be sure nobody has it locked still 01231 due to a reference retrieved from the channel list. */ 01232 ast_channel_lock(chan); 01233 ast_channel_unlock(chan); 01234 01235 /* Get rid of each of the data stores on the channel */ 01236 while ((datastore = AST_LIST_REMOVE_HEAD(&chan->datastores, entry))) 01237 /* Free the data store */ 01238 ast_channel_datastore_free(datastore); 01239 01240 /* Lock and unlock the channel just to be sure nobody has it locked still 01241 due to a reference that was stored in a datastore. (i.e. app_chanspy) */ 01242 ast_channel_lock(chan); 01243 ast_channel_unlock(chan); 01244 01245 if (chan->tech_pvt) { 01246 ast_log(LOG_WARNING, "Channel '%s' may not have been hung up properly\n", chan->name); 01247 free(chan->tech_pvt); 01248 } 01249 01250 if (chan->sched) 01251 sched_context_destroy(chan->sched); 01252 01253 ast_copy_string(name, chan->name, sizeof(name)); 01254 if ((dashptr = strrchr(name, '-'))) { 01255 *dashptr = '\0'; 01256 } 01257 01258 /* Stop monitoring */ 01259 if (chan->monitor) 01260 chan->monitor->stop( chan, 0 ); 01261 01262 /* If there is native format music-on-hold state, free it */ 01263 if (chan->music_state) 01264 ast_moh_cleanup(chan); 01265 01266 /* Free translators */ 01267 if (chan->readtrans) 01268 ast_translator_free_path(chan->readtrans); 01269 if (chan->writetrans) 01270 ast_translator_free_path(chan->writetrans); 01271 if (chan->pbx) 01272 ast_log(LOG_WARNING, "PBX may not have been terminated properly on '%s'\n", chan->name); 01273 free_cid(&chan->cid); 01274 /* Close pipes if appropriate */ 01275 if ((fd = chan->alertpipe[0]) > -1) 01276 close(fd); 01277 if ((fd = chan->alertpipe[1]) > -1) 01278 close(fd); 01279 if ((fd = chan->timingfd) > -1) 01280 close(fd); 01281 while ((f = AST_LIST_REMOVE_HEAD(&chan->readq, frame_list))) 01282 ast_frfree(f); 01283 01284 /* loop over the variables list, freeing all data and deleting list items */ 01285 /* no need to lock the list, as the channel is already locked */ 01286 01287 while ((vardata = AST_LIST_REMOVE_HEAD(headp, entries))) 01288 ast_var_delete(vardata); 01289 01290 ast_app_group_discard(chan); 01291 01292 /* Destroy the jitterbuffer */ 01293 ast_jb_destroy(chan); 01294 01295 if (chan->cdr) { 01296 ast_cdr_discard(chan->cdr); 01297 chan->cdr = NULL; 01298 } 01299 01300 ast_mutex_destroy(&chan->lock); 01301 01302 ast_string_field_free_memory(chan); 01303 free(chan); 01304 AST_LIST_UNLOCK(&channels); 01305 01306 ast_device_state_changed_literal(name); 01307 }
void ast_channel_inherit_variables | ( | const struct ast_channel * | parent, | |
struct ast_channel * | child | |||
) |
Inherits channel variable from parent to child channel.
parent | Parent channel | |
child | Child channel |
Definition at line 3448 of file channel.c.
References AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_log(), ast_var_assign(), ast_var_full_name(), ast_var_name(), ast_var_value(), ast_var_t::entries, LOG_DEBUG, option_debug, and ast_channel::varshead.
Referenced by __ast_request_and_dial(), agent_call(), ast_feature_request_and_dial(), begin_dial(), findmeexec(), ring_entry(), and wait_for_answer().
03449 { 03450 struct ast_var_t *current, *newvar; 03451 const char *varname; 03452 03453 AST_LIST_TRAVERSE(&parent->varshead, current, entries) { 03454 int vartype = 0; 03455 03456 varname = ast_var_full_name(current); 03457 if (!varname) 03458 continue; 03459 03460 if (varname[0] == '_') { 03461 vartype = 1; 03462 if (varname[1] == '_') 03463 vartype = 2; 03464 } 03465 03466 switch (vartype) { 03467 case 1: 03468 newvar = ast_var_assign(&varname[1], ast_var_value(current)); 03469 if (newvar) { 03470 AST_LIST_INSERT_TAIL(&child->varshead, newvar, entries); 03471 if (option_debug) 03472 ast_log(LOG_DEBUG, "Copying soft-transferable variable %s.\n", ast_var_name(newvar)); 03473 } 03474 break; 03475 case 2: 03476 newvar = ast_var_assign(ast_var_full_name(current), ast_var_value(current)); 03477 if (newvar) { 03478 AST_LIST_INSERT_TAIL(&child->varshead, newvar, entries); 03479 if (option_debug) 03480 ast_log(LOG_DEBUG, "Copying hard-transferable variable %s.\n", ast_var_name(newvar)); 03481 } 03482 break; 03483 default: 03484 if (option_debug) 03485 ast_log(LOG_DEBUG, "Not copying variable %s.\n", ast_var_name(current)); 03486 break; 03487 } 03488 } 03489 }
int ast_channel_make_compatible | ( | struct ast_channel * | c0, | |
struct ast_channel * | c1 | |||
) |
Makes two channel formats compatible.
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 . |
Definition at line 3301 of file channel.c.
References AST_FORMAT_SLINEAR, ast_log(), ast_opt_transcode_via_slin, ast_set_read_format(), ast_set_write_format(), ast_translate_path_steps(), ast_translator_best_choice(), ast_channel::name, ast_channel::nativeformats, ast_channel::readformat, and ast_channel::writeformat.
Referenced by app_exec(), ast_channel_bridge(), check_compat(), park_exec(), try_calling(), and wait_for_answer().
03302 { 03303 int src; 03304 int dst; 03305 03306 if (chan->readformat == peer->writeformat && chan->writeformat == peer->readformat) { 03307 /* Already compatible! Moving on ... */ 03308 return 0; 03309 } 03310 03311 /* Set up translation from the chan to the peer */ 03312 src = chan->nativeformats; 03313 dst = peer->nativeformats; 03314 if (ast_translator_best_choice(&dst, &src) < 0) { 03315 ast_log(LOG_WARNING, "No path to translate from %s(%d) to %s(%d)\n", chan->name, src, peer->name, dst); 03316 return -1; 03317 } 03318 03319 /* if the best path is not 'pass through', then 03320 transcoding is needed; if desired, force transcode path 03321 to use SLINEAR between channels, but only if there is 03322 no direct conversion available */ 03323 if ((src != dst) && ast_opt_transcode_via_slin && 03324 (ast_translate_path_steps(dst, src) != 1)) 03325 dst = AST_FORMAT_SLINEAR; 03326 if (ast_set_read_format(chan, dst) < 0) { 03327 ast_log(LOG_WARNING, "Unable to set read format on channel %s to %d\n", chan->name, dst); 03328 return -1; 03329 } 03330 if (ast_set_write_format(peer, dst) < 0) { 03331 ast_log(LOG_WARNING, "Unable to set write format on channel %s to %d\n", peer->name, dst); 03332 return -1; 03333 } 03334 03335 /* Set up translation from the peer to the chan */ 03336 src = peer->nativeformats; 03337 dst = chan->nativeformats; 03338 if (ast_translator_best_choice(&dst, &src) < 0) { 03339 ast_log(LOG_WARNING, "No path to translate from %s(%d) to %s(%d)\n", peer->name, src, chan->name, dst); 03340 return -1; 03341 } 03342 03343 /* if the best path is not 'pass through', then 03344 transcoding is needed; if desired, force transcode path 03345 to use SLINEAR between channels, but only if there is 03346 no direct conversion available */ 03347 if ((src != dst) && ast_opt_transcode_via_slin && 03348 (ast_translate_path_steps(dst, src) != 1)) 03349 dst = AST_FORMAT_SLINEAR; 03350 if (ast_set_read_format(peer, dst) < 0) { 03351 ast_log(LOG_WARNING, "Unable to set read format on channel %s to %d\n", peer->name, dst); 03352 return -1; 03353 } 03354 if (ast_set_write_format(chan, dst) < 0) { 03355 ast_log(LOG_WARNING, "Unable to set write format on channel %s to %d\n", chan->name, dst); 03356 return -1; 03357 } 03358 return 0; 03359 }
int ast_channel_masquerade | ( | struct ast_channel * | original, | |
struct ast_channel * | clone | |||
) |
Weird function made for call transfers.
original | channel to make a copy of | |
clone | copy of the original channel This is a very strange and freaky function used primarily for transfer. Suppose that "original" and "clone" are two channels in random situations. This function takes the guts out of "clone" and puts them into the "original" channel, then alerts the channel driver of the change, asking it to fixup any private information (like the p->owner pointer) that is affected by the change. The physical layer of the original channel is hung up. |
Definition at line 3361 of file channel.c.
References ast_channel::_bridge, ast_bridged_channel(), ast_channel_lock, ast_channel_trylock, ast_channel_unlock, ast_log(), ast_null_frame, ast_queue_frame(), ast_channel_tech::get_base_channel, LOG_DEBUG, ast_channel::masq, ast_channel::masqr, ast_channel::name, option_debug, and ast_channel::tech.
Referenced by ast_async_goto(), ast_pickup_call(), attempt_transfer(), check_availability(), check_bridge(), check_goto_on_transfer(), do_atxfer(), handle_invite_replaces(), iax_park(), masq_park_call(), misdn_transfer_bc(), pickup_do(), and sip_park().
03362 { 03363 int res = -1; 03364 struct ast_channel *final_orig, *final_clone, *base; 03365 03366 retrymasq: 03367 final_orig = original; 03368 final_clone = clone; 03369 03370 ast_channel_lock(original); 03371 while (ast_channel_trylock(clone)) { 03372 ast_channel_unlock(original); 03373 usleep(1); 03374 ast_channel_lock(original); 03375 } 03376 03377 /* each of these channels may be sitting behind a channel proxy (i.e. chan_agent) 03378 and if so, we don't really want to masquerade it, but its proxy */ 03379 if (original->_bridge && (original->_bridge != ast_bridged_channel(original)) && (original->_bridge->_bridge != original)) 03380 final_orig = original->_bridge; 03381 03382 if (clone->_bridge && (clone->_bridge != ast_bridged_channel(clone)) && (clone->_bridge->_bridge != clone)) 03383 final_clone = clone->_bridge; 03384 03385 if (final_clone->tech->get_base_channel && (base = final_clone->tech->get_base_channel(final_clone))) { 03386 final_clone = base; 03387 } 03388 03389 if ((final_orig != original) || (final_clone != clone)) { 03390 /* Lots and lots of deadlock avoidance. The main one we're competing with 03391 * is ast_write(), which locks channels recursively, when working with a 03392 * proxy channel. */ 03393 if (ast_channel_trylock(final_orig)) { 03394 ast_channel_unlock(clone); 03395 ast_channel_unlock(original); 03396 goto retrymasq; 03397 } 03398 if (ast_channel_trylock(final_clone)) { 03399 ast_channel_unlock(final_orig); 03400 ast_channel_unlock(clone); 03401 ast_channel_unlock(original); 03402 goto retrymasq; 03403 } 03404 ast_channel_unlock(clone); 03405 ast_channel_unlock(original); 03406 original = final_orig; 03407 clone = final_clone; 03408 } 03409 03410 if (original == clone) { 03411 ast_log(LOG_WARNING, "Can't masquerade channel '%s' into itself!\n", original->name); 03412 ast_channel_unlock(clone); 03413 ast_channel_unlock(original); 03414 return -1; 03415 } 03416 03417 if (option_debug) 03418 ast_log(LOG_DEBUG, "Planning to masquerade channel %s into the structure of %s\n", 03419 clone->name, original->name); 03420 if (original->masq) { 03421 ast_log(LOG_WARNING, "%s is already going to masquerade as %s\n", 03422 original->masq->name, original->name); 03423 } else if (clone->masqr) { 03424 ast_log(LOG_WARNING, "%s is already going to masquerade as %s\n", 03425 clone->name, clone->masqr->name); 03426 } else { 03427 original->masq = clone; 03428 clone->masqr = original; 03429 ast_queue_frame(original, &ast_null_frame); 03430 ast_queue_frame(clone, &ast_null_frame); 03431 if (option_debug) 03432 ast_log(LOG_DEBUG, "Done planning to masquerade channel %s into the structure of %s\n", clone->name, original->name); 03433 res = 0; 03434 } 03435 03436 ast_channel_unlock(clone); 03437 ast_channel_unlock(original); 03438 03439 return res; 03440 }
char* ast_channel_reason2str | ( | int | reason | ) |
return an english explanation of the code returned thru __ast_request_and_dial's 'outstate' argument
reason | The integer argument, usually taken from AST_CONTROL_ macros |
Definition at line 2994 of file channel.c.
References AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_HANGUP, AST_CONTROL_RING, and AST_CONTROL_RINGING.
Referenced by attempt_thread().
02995 { 02996 switch (reason) /* the following appear to be the only ones actually returned by request_and_dial */ 02997 { 02998 case 0: 02999 return "Call Failure (not BUSY, and not NO_ANSWER, maybe Circuit busy or down?)"; 03000 case AST_CONTROL_HANGUP: 03001 return "Hangup"; 03002 case AST_CONTROL_RING: 03003 return "Local Ring"; 03004 case AST_CONTROL_RINGING: 03005 return "Remote end Ringing"; 03006 case AST_CONTROL_ANSWER: 03007 return "Remote end has Answered"; 03008 case AST_CONTROL_BUSY: 03009 return "Remote end is Busy"; 03010 case AST_CONTROL_CONGESTION: 03011 return "Congestion (circuits busy)"; 03012 default: 03013 return "Unknown Reason!!"; 03014 } 03015 }
int ast_channel_register | ( | const struct ast_channel_tech * | tech | ) |
Register a channel technology (a new channel driver) Called by a channel module to register the kind of channels it supports.
tech | Structure defining channel technology or "type" |
Definition at line 497 of file channel.c.
References ast_calloc, AST_LIST_INSERT_HEAD, AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_verbose(), chanlist::list, LOG_DEBUG, LOG_WARNING, option_debug, option_verbose, chanlist::tech, ast_channel_tech::type, and VERBOSE_PREFIX_2.
Referenced by load_module(), and unload_module().
00498 { 00499 struct chanlist *chan; 00500 00501 AST_LIST_LOCK(&channels); 00502 00503 AST_LIST_TRAVERSE(&backends, chan, list) { 00504 if (!strcasecmp(tech->type, chan->tech->type)) { 00505 ast_log(LOG_WARNING, "Already have a handler for type '%s'\n", tech->type); 00506 AST_LIST_UNLOCK(&channels); 00507 return -1; 00508 } 00509 } 00510 00511 if (!(chan = ast_calloc(1, sizeof(*chan)))) { 00512 AST_LIST_UNLOCK(&channels); 00513 return -1; 00514 } 00515 chan->tech = tech; 00516 AST_LIST_INSERT_HEAD(&backends, chan, list); 00517 00518 if (option_debug) 00519 ast_log(LOG_DEBUG, "Registered handler for '%s' (%s)\n", chan->tech->type, chan->tech->description); 00520 00521 if (option_verbose > 1) 00522 ast_verbose(VERBOSE_PREFIX_2 "Registered channel type '%s' (%s)\n", chan->tech->type, 00523 chan->tech->description); 00524 00525 AST_LIST_UNLOCK(&channels); 00526 return 0; 00527 }
int ast_channel_sendhtml | ( | struct ast_channel * | channel, | |
int | subclass, | |||
const char * | data, | |||
int | datalen | |||
) |
Send HTML or URL on link. Returns 0 on success or -1 on failure
Definition at line 3289 of file channel.c.
References ast_channel_tech::send_html, and ast_channel::tech.
Referenced by agent_sendhtml(), ast_channel_sendurl(), and wait_for_answer().
03290 { 03291 if (chan->tech->send_html) 03292 return chan->tech->send_html(chan, subclass, data, datalen); 03293 return -1; 03294 }
int ast_channel_sendurl | ( | struct ast_channel * | channel, | |
const char * | url | |||
) |
Send URL on link. Returns 0 on success or -1 on failure
Definition at line 3296 of file channel.c.
References ast_channel_sendhtml(), and AST_HTML_URL.
Referenced by sendurl_exec(), and try_calling().
03297 { 03298 return ast_channel_sendhtml(chan, AST_HTML_URL, url, strlen(url) + 1); 03299 }
int ast_channel_setoption | ( | struct ast_channel * | channel, | |
int | option, | |||
void * | data, | |||
int | datalen, | |||
int | block | |||
) |
Sets an option on a channel.
channel | channel to set options on | |
option | option to change | |
data | data specific to option | |
datalen | length of the data | |
block | blocking or not Set an option on a channel (see frame.h), optionally blocking awaiting the reply Returns 0 on success and -1 on failure |
Definition at line 4341 of file channel.c.
References ast_log(), errno, LOG_ERROR, ast_channel_tech::setoption, and ast_channel::tech.
Referenced by ast_bridge_call(), common_exec(), conf_run(), dahdi_hangup(), func_channel_write(), handle_tddmode(), play_record_review(), reset_volumes(), rpt(), set_listen_volume(), set_talk_volume(), try_calling(), and vm_forwardoptions().
04342 { 04343 int res; 04344 04345 if (chan->tech->setoption) { 04346 res = chan->tech->setoption(chan, option, data, datalen); 04347 if (res < 0) 04348 return res; 04349 } else { 04350 errno = ENOSYS; 04351 return -1; 04352 } 04353 if (block) { 04354 /* XXX Implement blocking -- just wait for our option frame reply, discarding 04355 intermediate packets. XXX */ 04356 ast_log(LOG_ERROR, "XXX Blocking not implemented yet XXX\n"); 04357 return -1; 04358 } 04359 return 0; 04360 }
void ast_channel_setwhentohangup | ( | struct ast_channel * | chan, | |
time_t | offset | |||
) |
Set when to hang a channel up.
chan | channel on which to check for hang up | |
offset | offset in seconds from current time of when to hang up This function sets the absolute time out on a channel (when to hang up). |
Definition at line 467 of file channel.c.
References ast_null_frame, ast_queue_frame(), and ast_channel::whentohangup.
Referenced by action_timeout(), and timeout_write().
00468 { 00469 chan->whentohangup = offset ? time(NULL) + offset : 0; 00470 ast_queue_frame(chan, &ast_null_frame); 00471 return; 00472 }
struct ast_silence_generator* ast_channel_start_silence_generator | ( | struct ast_channel * | chan | ) |
Starts a silence generator on the given channel.
chan | The channel to generate silence on |
The pointer returned by this function must be preserved and passed to ast_channel_stop_silence_generator when you wish to stop the silence generation.
Definition at line 4669 of file channel.c.
References ast_activate_generator(), ast_calloc, AST_FORMAT_SLINEAR, ast_log(), ast_set_write_format(), free, LOG_DEBUG, LOG_ERROR, ast_channel::name, ast_silence_generator::old_write_format, option_debug, silence_generator, and ast_channel::writeformat.
Referenced by __ast_play_and_record(), ast_dtmf_stream(), and channel_spy().
04670 { 04671 struct ast_silence_generator *state; 04672 04673 if (!(state = ast_calloc(1, sizeof(*state)))) { 04674 return NULL; 04675 } 04676 04677 state->old_write_format = chan->writeformat; 04678 04679 if (ast_set_write_format(chan, AST_FORMAT_SLINEAR) < 0) { 04680 ast_log(LOG_ERROR, "Could not set write format to SLINEAR\n"); 04681 free(state); 04682 return NULL; 04683 } 04684 04685 ast_activate_generator(chan, &silence_generator, state); 04686 04687 if (option_debug) 04688 ast_log(LOG_DEBUG, "Started silence generator on '%s'\n", chan->name); 04689 04690 return state; 04691 }
void ast_channel_stop_silence_generator | ( | struct ast_channel * | chan, | |
struct ast_silence_generator * | state | |||
) |
Stops a previously-started silence generator on the given channel.
chan | The channel to operate on | |
state | The ast_silence_generator pointer return by a previous call to ast_channel_start_silence_generator. |
Definition at line 4693 of file channel.c.
References ast_deactivate_generator(), ast_log(), ast_set_write_format(), free, LOG_DEBUG, LOG_ERROR, ast_channel::name, ast_silence_generator::old_write_format, and option_debug.
Referenced by __ast_play_and_record(), ast_dtmf_stream(), and channel_spy().
04694 { 04695 if (!state) 04696 return; 04697 04698 ast_deactivate_generator(chan); 04699 04700 if (option_debug) 04701 ast_log(LOG_DEBUG, "Stopped silence generator on '%s'\n", chan->name); 04702 04703 if (ast_set_write_format(chan, state->old_write_format) < 0) 04704 ast_log(LOG_ERROR, "Could not return write format to its original state\n"); 04705 04706 free(state); 04707 }
int ast_channel_supports_html | ( | struct ast_channel * | channel | ) |
Returns 0 if channel does not support HTML or non-zero if it does
Definition at line 3284 of file channel.c.
References ast_channel_tech::send_html, and ast_channel::tech.
Referenced by sendurl_exec(), and try_calling().
void ast_channel_undefer_dtmf | ( | struct ast_channel * | chan | ) |
Unset defer DTMF flag on channel.
Undo defer. ast_read will return any dtmf characters that were queued
Definition at line 1019 of file channel.c.
References ast_clear_flag, and AST_FLAG_DEFER_DTMF.
Referenced by __adsi_transmit_messages(), find_cache(), and rpt_call().
01020 { 01021 if (chan) 01022 ast_clear_flag(chan, AST_FLAG_DEFER_DTMF); 01023 }
void ast_channel_unregister | ( | const struct ast_channel_tech * | tech | ) |
Unregister a channel technology.
tech | Structure defining channel technology or "type" that was previously registered |
Definition at line 529 of file channel.c.
References AST_LIST_LOCK, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, AST_LIST_UNLOCK, ast_log(), ast_verbose(), free, chanlist::list, LOG_DEBUG, option_debug, option_verbose, chanlist::tech, ast_channel_tech::type, and VERBOSE_PREFIX_2.
Referenced by __unload_module(), and unload_module().
00530 { 00531 struct chanlist *chan; 00532 00533 if (option_debug) 00534 ast_log(LOG_DEBUG, "Unregistering channel type '%s'\n", tech->type); 00535 00536 AST_LIST_LOCK(&channels); 00537 00538 AST_LIST_TRAVERSE_SAFE_BEGIN(&backends, chan, list) { 00539 if (chan->tech == tech) { 00540 AST_LIST_REMOVE_CURRENT(&backends, list); 00541 free(chan); 00542 if (option_verbose > 1) 00543 ast_verbose(VERBOSE_PREFIX_2 "Unregistered channel type '%s'\n", tech->type); 00544 break; 00545 } 00546 } 00547 AST_LIST_TRAVERSE_SAFE_END 00548 00549 AST_LIST_UNLOCK(&channels); 00550 }
struct ast_channel* ast_channel_walk_locked | ( | const struct ast_channel * | prev | ) |
Browse channels in use Browse the channels currently in use.
prev | where you want to start in the channel list |
Definition at line 1135 of file channel.c.
References channel_find_locked().
Referenced by action_status(), ast_complete_channels(), ast_pickup_call(), complete_ch_helper(), conf_exec(), handle_chanlist(), handle_chanlist_deprecated(), handle_core_set_debug_channel(), handle_debugchan_deprecated(), handle_nodebugchan_deprecated(), next_channel(), pickup_by_exten(), pickup_by_mark(), and softhangup_exec().
01136 { 01137 return channel_find_locked(prev, NULL, 0, NULL, NULL); 01138 }
void ast_channels_init | ( | void | ) |
Provided by channel.c
Definition at line 4593 of file channel.c.
References ast_cli_register_multiple(), and cli_channel.
Referenced by main().
04594 { 04595 ast_cli_register_multiple(cli_channel, sizeof(cli_channel) / sizeof(struct ast_cli_entry)); 04596 }
struct ast_variable* ast_channeltype_list | ( | void | ) |
return an ast_variable list of channeltypes
Definition at line 163 of file channel.c.
References AST_LIST_TRAVERSE, ast_variable_new(), ast_channel_tech::description, chanlist::list, chanlist::tech, ast_channel_tech::type, and var.
00164 { 00165 struct chanlist *cl; 00166 struct ast_variable *var=NULL, *prev = NULL; 00167 AST_LIST_TRAVERSE(&backends, cl, list) { 00168 if (prev) { 00169 if ((prev->next = ast_variable_new(cl->tech->type, cl->tech->description))) 00170 prev = prev->next; 00171 } else { 00172 var = ast_variable_new(cl->tech->type, cl->tech->description); 00173 prev = var; 00174 } 00175 } 00176 return var; 00177 }
int ast_check_hangup | ( | struct ast_channel * | chan | ) |
Check to see if a channel is needing hang up.
chan | channel on which to check for hang up This function determines if the channel is being requested to be hung up. |
Definition at line 385 of file channel.c.
References ast_channel::_softhangup, AST_SOFTHANGUP_TIMEOUT, ast_channel::tech_pvt, and ast_channel::whentohangup.
Referenced by __ast_read(), _macro_exec(), action_redirect(), agent_indicate(), agi_handle_command(), announce_thread(), app_exec(), ast_answer(), ast_bridge_call(), ast_call(), ast_channel_bridge(), ast_check_hangup_locked(), ast_feature_request_and_dial(), ast_indicate_data(), ast_readstring_full(), ast_recvtext(), ast_rtp_bridge(), ast_sendtext(), ast_transfer(), ast_udptl_bridge(), ast_waitfordigit_full(), ast_write(), bridge_native_loop(), channel_spy(), common_exec(), conf_run(), dahdi_sendtext(), dahdi_setoption(), deadagi_exec(), do_atxfer(), handle_request_invite(), handle_sendimage(), pbx_exec(), rpt(), and wait_for_answer().
00386 { 00387 if (chan->_softhangup) /* yes if soft hangup flag set */ 00388 return 1; 00389 if (!chan->tech_pvt) /* yes if no technology private data */ 00390 return 1; 00391 if (!chan->whentohangup) /* no if no hangup scheduled */ 00392 return 0; 00393 if (chan->whentohangup > time(NULL)) /* no if hangup time has not come yet. */ 00394 return 0; 00395 chan->_softhangup |= AST_SOFTHANGUP_TIMEOUT; /* record event */ 00396 return 1; 00397 }
static int ast_check_hangup_locked | ( | struct ast_channel * | chan | ) | [static] |
Definition at line 399 of file channel.c.
References ast_channel_lock, ast_channel_unlock, and ast_check_hangup().
Referenced by ast_channel_bridge().
00400 { 00401 int res; 00402 ast_channel_lock(chan); 00403 res = ast_check_hangup(chan); 00404 ast_channel_unlock(chan); 00405 return res; 00406 }
void ast_deactivate_generator | ( | struct ast_channel * | chan | ) |
Deactive an active generator
Definition at line 1586 of file channel.c.
References ast_channel_lock, ast_channel_unlock, ast_clear_flag, AST_FLAG_WRITE_INT, AST_GENERATOR_FD, ast_settimeout(), ast_channel::fds, ast_channel::generator, ast_channel::generatordata, and ast_generator::release.
Referenced by __ast_read(), app_exec(), ast_channel_stop_silence_generator(), ast_openstream_full(), ast_playtones_stop(), ast_quiet_chan(), ast_read_generator_actions(), ast_tonepair_stop(), ast_write(), cb_events(), channel_spy(), generator_force(), local_ast_moh_stop(), old_milliwatt_exec(), and wait_for_answer().
01587 { 01588 ast_channel_lock(chan); 01589 if (chan->generatordata) { 01590 if (chan->generator && chan->generator->release) 01591 chan->generator->release(chan, chan->generatordata); 01592 chan->generatordata = NULL; 01593 chan->generator = NULL; 01594 chan->fds[AST_GENERATOR_FD] = -1; 01595 ast_clear_flag(chan, AST_FLAG_WRITE_INT); 01596 ast_settimeout(chan, 0, NULL, NULL); 01597 } 01598 ast_channel_unlock(chan); 01599 }
int ast_do_masquerade | ( | struct ast_channel * | original | ) |
Start masquerading a channel XXX This is a seriously wacked out operation. We're essentially putting the guts of the clone channel into the original channel. Start by killing off the original channel's backend. I'm not sure we're going to keep this function, because while the features are nice, the cost is very high in terms of pure nastiness. XXX.
Definition at line 3522 of file channel.c.
References ast_channel::_softhangup, ast_channel::_state, ast_channel::adsicpe, ast_channel::alertpipe, ast_app_group_update(), ast_cause2str(), ast_channel_free(), ast_channel_lock, ast_channel_unlock, ast_copy_string(), AST_FLAG_BLOCKING, AST_FLAG_EXCEPTION, AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, AST_GENERATOR_FD, ast_indicate(), AST_LIST_APPEND_LIST, AST_LIST_FIRST, AST_LIST_HEAD_NOLOCK, AST_LIST_HEAD_SET_NOLOCK, AST_LIST_INSERT_TAIL, AST_LIST_REMOVE_HEAD, AST_LIST_TRAVERSE, ast_log(), AST_MAX_FDS, ast_null_frame, ast_queue_frame(), ast_set_flag, ast_set_read_format(), ast_set_write_format(), AST_SOFTHANGUP_DEV, ast_string_field_set, ast_test_flag, AST_TIMING_FD, ast_channel::blocker, ast_channel::cdr, ast_datastore_info::chan_fixup, ast_channel::cid, clone_variables(), ast_datastore::data, ast_channel::datastores, ast_datastore::entry, errno, ast_channel::fdno, ast_channel::fds, ast_channel_tech::fixup, free_translation(), ast_channel_tech::hangup, ast_datastore::info, language, ast_channel::language, ast_channel::lock, LOG_DEBUG, manager_event(), ast_channel::masq, ast_channel::masqr, ast_channel::monitor, musicclass, ast_channel::name, name, ast_channel::nativeformats, option_debug, ast_channel::rawreadformat, ast_channel::rawwriteformat, ast_channel::readformat, ast_channel::readq, t, ast_channel::tech, ast_channel::tech_pvt, ast_channel::timingfd, ast_channel_tech::type, ast_channel::uniqueid, ast_channel::visible_indication, and ast_channel::writeformat.
Referenced by __ast_read(), ast_async_goto(), ast_hangup(), ast_waitfor_nandfds(), ast_write(), iax_park(), sip_park(), and sip_park_thread().
03523 { 03524 int x,i; 03525 int res=0; 03526 int origstate; 03527 struct ast_frame *cur; 03528 const struct ast_channel_tech *t; 03529 void *t_pvt; 03530 struct ast_callerid tmpcid; 03531 struct ast_channel *clone = original->masq; 03532 struct ast_cdr *cdr; 03533 int rformat = original->readformat; 03534 int wformat = original->writeformat; 03535 char newn[100]; 03536 char orig[100]; 03537 char masqn[100]; 03538 char zombn[100]; 03539 03540 if (option_debug > 3) 03541 ast_log(LOG_DEBUG, "Actually Masquerading %s(%d) into the structure of %s(%d)\n", 03542 clone->name, clone->_state, original->name, original->_state); 03543 03544 /* XXX This is a seriously wacked out operation. We're essentially putting the guts of 03545 the clone channel into the original channel. Start by killing off the original 03546 channel's backend. I'm not sure we're going to keep this function, because 03547 while the features are nice, the cost is very high in terms of pure nastiness. XXX */ 03548 03549 /* We need the clone's lock, too */ 03550 ast_channel_lock(clone); 03551 03552 if (option_debug > 1) 03553 ast_log(LOG_DEBUG, "Got clone lock for masquerade on '%s' at %p\n", clone->name, &clone->lock); 03554 03555 /* Having remembered the original read/write formats, we turn off any translation on either 03556 one */ 03557 free_translation(clone); 03558 free_translation(original); 03559 03560 03561 /* Unlink the masquerade */ 03562 original->masq = NULL; 03563 clone->masqr = NULL; 03564 03565 /* Save the original name */ 03566 ast_copy_string(orig, original->name, sizeof(orig)); 03567 /* Save the new name */ 03568 ast_copy_string(newn, clone->name, sizeof(newn)); 03569 /* Create the masq name */ 03570 snprintf(masqn, sizeof(masqn), "%s<MASQ>", newn); 03571 03572 /* Copy the name from the clone channel */ 03573 ast_string_field_set(original, name, newn); 03574 03575 /* Mangle the name of the clone channel */ 03576 ast_string_field_set(clone, name, masqn); 03577 03578 /* Notify any managers of the change, first the masq then the other */ 03579 manager_event(EVENT_FLAG_CALL, "Rename", "Oldname: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", newn, masqn, clone->uniqueid); 03580 manager_event(EVENT_FLAG_CALL, "Rename", "Oldname: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", orig, newn, original->uniqueid); 03581 03582 /* Swap the technologies */ 03583 t = original->tech; 03584 original->tech = clone->tech; 03585 clone->tech = t; 03586 03587 /* Swap the cdrs */ 03588 cdr = original->cdr; 03589 original->cdr = clone->cdr; 03590 clone->cdr = cdr; 03591 03592 t_pvt = original->tech_pvt; 03593 original->tech_pvt = clone->tech_pvt; 03594 clone->tech_pvt = t_pvt; 03595 03596 /* Swap the alertpipes */ 03597 for (i = 0; i < 2; i++) { 03598 x = original->alertpipe[i]; 03599 original->alertpipe[i] = clone->alertpipe[i]; 03600 clone->alertpipe[i] = x; 03601 } 03602 03603 /* 03604 * Swap the readq's. The end result should be this: 03605 * 03606 * 1) All frames should be on the new (original) channel. 03607 * 2) Any frames that were already on the new channel before this 03608 * masquerade need to be at the end of the readq, after all of the 03609 * frames on the old (clone) channel. 03610 * 3) The alertpipe needs to get poked for every frame that was already 03611 * on the new channel, since we are now using the alert pipe from the 03612 * old (clone) channel. 03613 */ 03614 { 03615 AST_LIST_HEAD_NOLOCK(, ast_frame) tmp_readq; 03616 AST_LIST_HEAD_SET_NOLOCK(&tmp_readq, NULL); 03617 03618 AST_LIST_APPEND_LIST(&tmp_readq, &original->readq, frame_list); 03619 AST_LIST_APPEND_LIST(&original->readq, &clone->readq, frame_list); 03620 03621 while ((cur = AST_LIST_REMOVE_HEAD(&tmp_readq, frame_list))) { 03622 AST_LIST_INSERT_TAIL(&original->readq, cur, frame_list); 03623 if (original->alertpipe[1] > -1) { 03624 int poke = 0; 03625 03626 if (write(original->alertpipe[1], &poke, sizeof(poke)) < 0) { 03627 ast_log(LOG_WARNING, "write() failed: %s\n", strerror(errno)); 03628 } 03629 } 03630 } 03631 } 03632 03633 /* Swap the raw formats */ 03634 x = original->rawreadformat; 03635 original->rawreadformat = clone->rawreadformat; 03636 clone->rawreadformat = x; 03637 x = original->rawwriteformat; 03638 original->rawwriteformat = clone->rawwriteformat; 03639 clone->rawwriteformat = x; 03640 03641 clone->_softhangup = AST_SOFTHANGUP_DEV; 03642 03643 /* And of course, so does our current state. Note we need not 03644 call ast_setstate since the event manager doesn't really consider 03645 these separate. We do this early so that the clone has the proper 03646 state of the original channel. */ 03647 origstate = original->_state; 03648 original->_state = clone->_state; 03649 clone->_state = origstate; 03650 03651 if (clone->tech->fixup){ 03652 res = clone->tech->fixup(original, clone); 03653 if (res) 03654 ast_log(LOG_WARNING, "Fixup failed on channel %s, strange things may happen.\n", clone->name); 03655 } 03656 03657 /* Start by disconnecting the original's physical side */ 03658 if (clone->tech->hangup) 03659 res = clone->tech->hangup(clone); 03660 if (res) { 03661 ast_log(LOG_WARNING, "Hangup failed! Strange things may happen!\n"); 03662 ast_channel_unlock(clone); 03663 return -1; 03664 } 03665 03666 snprintf(zombn, sizeof(zombn), "%s<ZOMBIE>", orig); 03667 /* Mangle the name of the clone channel */ 03668 ast_string_field_set(clone, name, zombn); 03669 manager_event(EVENT_FLAG_CALL, "Rename", "Oldname: %s\r\nNewname: %s\r\nUniqueid: %s\r\n", masqn, zombn, clone->uniqueid); 03670 03671 /* Update the type. */ 03672 t_pvt = original->monitor; 03673 original->monitor = clone->monitor; 03674 clone->monitor = t_pvt; 03675 03676 /* Keep the same language. */ 03677 ast_string_field_set(original, language, clone->language); 03678 /* Copy the FD's other than the generator fd */ 03679 for (x = 0; x < AST_MAX_FDS; x++) { 03680 if (x != AST_GENERATOR_FD) 03681 original->fds[x] = clone->fds[x]; 03682 } 03683 03684 ast_app_group_update(clone, original); 03685 /* Move data stores over */ 03686 if (AST_LIST_FIRST(&clone->datastores)) { 03687 struct ast_datastore *ds; 03688 AST_LIST_TRAVERSE(&clone->datastores, ds, entry) { 03689 if (ds->info->chan_fixup) 03690 ds->info->chan_fixup(ds->data, clone, original); 03691 } 03692 AST_LIST_APPEND_LIST(&original->datastores, &clone->datastores, entry); 03693 } 03694 03695 clone_variables(original, clone); 03696 /* Presense of ADSI capable CPE follows clone */ 03697 original->adsicpe = clone->adsicpe; 03698 /* Bridge remains the same */ 03699 /* CDR fields remain the same */ 03700 /* XXX What about blocking, softhangup, blocker, and lock and blockproc? XXX */ 03701 /* Application and data remain the same */ 03702 /* Clone exception becomes real one, as with fdno */ 03703 ast_set_flag(original, ast_test_flag(clone, AST_FLAG_OUTGOING | AST_FLAG_EXCEPTION)); 03704 original->fdno = clone->fdno; 03705 /* Schedule context remains the same */ 03706 /* Stream stuff stays the same */ 03707 /* Keep the original state. The fixup code will need to work with it most likely */ 03708 03709 /* Just swap the whole structures, nevermind the allocations, they'll work themselves 03710 out. */ 03711 tmpcid = original->cid; 03712 original->cid = clone->cid; 03713 clone->cid = tmpcid; 03714 03715 /* Restore original timing file descriptor */ 03716 original->fds[AST_TIMING_FD] = original->timingfd; 03717 03718 /* Our native formats are different now */ 03719 original->nativeformats = clone->nativeformats; 03720 03721 /* Context, extension, priority, app data, jump table, remain the same */ 03722 /* pvt switches. pbx stays the same, as does next */ 03723 03724 /* Set the write format */ 03725 ast_set_write_format(original, wformat); 03726 03727 /* Set the read format */ 03728 ast_set_read_format(original, rformat); 03729 03730 /* Copy the music class */ 03731 ast_string_field_set(original, musicclass, clone->musicclass); 03732 03733 if (option_debug) 03734 ast_log(LOG_DEBUG, "Putting channel %s in %d/%d formats\n", original->name, wformat, rformat); 03735 03736 /* Okay. Last thing is to let the channel driver know about all this mess, so he 03737 can fix up everything as best as possible */ 03738 if (original->tech->fixup) { 03739 res = original->tech->fixup(clone, original); 03740 if (res) { 03741 ast_log(LOG_WARNING, "Channel for type '%s' could not fixup channel %s\n", 03742 original->tech->type, original->name); 03743 ast_channel_unlock(clone); 03744 return -1; 03745 } 03746 } else 03747 ast_log(LOG_WARNING, "Channel type '%s' does not have a fixup routine (for %s)! Bad things may happen.\n", 03748 original->tech->type, original->name); 03749 03750 /* 03751 * If an indication is currently playing, maintain it on the channel 03752 * that is taking the place of original 03753 * 03754 * This is needed because the masquerade is swapping out in the internals 03755 * of this channel, and the new channel private data needs to be made 03756 * aware of the current visible indication (RINGING, CONGESTION, etc.) 03757 */ 03758 if (original->visible_indication) { 03759 ast_indicate(original, original->visible_indication); 03760 } 03761 03762 /* Now, at this point, the "clone" channel is totally F'd up. We mark it as 03763 a zombie so nothing tries to touch it. If it's already been marked as a 03764 zombie, then free it now (since it already is considered invalid). */ 03765 if (ast_test_flag(clone, AST_FLAG_ZOMBIE)) { 03766 if (option_debug) 03767 ast_log(LOG_DEBUG, "Destroying channel clone '%s'\n", clone->name); 03768 ast_channel_unlock(clone); 03769 manager_event(EVENT_FLAG_CALL, "Hangup", 03770 "Channel: %s\r\n" 03771 "Uniqueid: %s\r\n" 03772 "Cause: %d\r\n" 03773 "Cause-txt: %s\r\n", 03774 clone->name, 03775 clone->uniqueid, 03776 clone->hangupcause, 03777 ast_cause2str(clone->hangupcause) 03778 ); 03779 ast_channel_free(clone); 03780 } else { 03781 if (option_debug) 03782 ast_log(LOG_DEBUG, "Released clone lock on '%s'\n", clone->name); 03783 ast_set_flag(clone, AST_FLAG_ZOMBIE); 03784 ast_queue_frame(clone, &ast_null_frame); 03785 ast_channel_unlock(clone); 03786 } 03787 03788 /* Signal any blocker */ 03789 if (ast_test_flag(original, AST_FLAG_BLOCKING)) 03790 pthread_kill(original->blocker, SIGURG); 03791 if (option_debug) 03792 ast_log(LOG_DEBUG, "Done Masquerading %s (%d)\n", original->name, original->_state); 03793 return 0; 03794 }
static enum ast_bridge_result ast_generic_bridge | ( | struct ast_channel * | c0, | |
struct ast_channel * | c1, | |||
struct ast_bridge_config * | config, | |||
struct ast_frame ** | fo, | |||
struct ast_channel ** | rc, | |||
struct timeval | bridge_end | |||
) | [static] |
Definition at line 3907 of file channel.c.
References AST_BRIDGE_COMPLETE, AST_BRIDGE_DTMF_CHANNEL_0, AST_BRIDGE_DTMF_CHANNEL_1, AST_BRIDGE_RETRY, AST_FEATURE_WARNING_ACTIVE, ast_jb_do_usecheck(), ast_jb_empty_and_reset(), ast_set_flag, ast_tvdiff_ms(), ast_tvnow(), config, f, ast_channel::nativeformats, and ast_channel::tech_pvt.
Referenced by ast_channel_bridge().
03910 { 03911 /* Copy voice back and forth between the two channels. */ 03912 struct ast_channel *cs[3]; 03913 struct ast_frame *f; 03914 enum ast_bridge_result res = AST_BRIDGE_COMPLETE; 03915 int o0nativeformats; 03916 int o1nativeformats; 03917 int watch_c0_dtmf; 03918 int watch_c1_dtmf; 03919 void *pvt0, *pvt1; 03920 /* Indicates whether a frame was queued into a jitterbuffer */ 03921 int frame_put_in_jb = 0; 03922 int jb_in_use; 03923 int to; 03924 03925 cs[0] = c0; 03926 cs[1] = c1; 03927 pvt0 = c0->tech_pvt; 03928 pvt1 = c1->tech_pvt; 03929 o0nativeformats = c0->nativeformats; 03930 o1nativeformats = c1->nativeformats; 03931 watch_c0_dtmf = config->flags & AST_BRIDGE_DTMF_CHANNEL_0; 03932 watch_c1_dtmf = config->flags & AST_BRIDGE_DTMF_CHANNEL_1; 03933 03934 /* Check the need of a jitterbuffer for each channel */ 03935 jb_in_use = ast_jb_do_usecheck(c0, c1); 03936 if (jb_in_use) 03937 ast_jb_empty_and_reset(c0, c1); 03938 03939 for (;;) { 03940 struct ast_channel *who, *other; 03941 03942 if ((c0->tech_pvt != pvt0) || (c1->tech_pvt != pvt1) || 03943 (o0nativeformats != c0->nativeformats) || 03944 (o1nativeformats != c1->nativeformats)) { 03945 /* Check for Masquerade, codec changes, etc */ 03946 res = AST_BRIDGE_RETRY; 03947 break; 03948 } 03949 if (bridge_end.tv_sec) { 03950 to = ast_tvdiff_ms(bridge_end, ast_tvnow()); 03951 if (to <= 0) { 03952 if (config->timelimit) { 03953 res = AST_BRIDGE_RETRY; 03954 /* generic bridge ending to play warning */ 03955 ast_set_flag(config, AST_FEATURE_WARNING_ACTIVE); 03956 } else { 03957 res = AST_BRIDGE_COMPLETE; 03958 } 03959 break; 03960 } 03961 } else 03962 to = -1; 03963 /* Calculate the appropriate max sleep interval - in general, this is the time, 03964 left to the closest jb delivery moment */ 03965 if (jb_in_use) 03966 to = ast_jb_get_when_to_wakeup(c0, c1, to); 03967 who = ast_waitfor_n(cs, 2, &to); 03968 if (!who) { 03969 /* No frame received within the specified timeout - check if we have to deliver now */ 03970 if (jb_in_use) 03971 ast_jb_get_and_deliver(c0, c1); 03972 if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE || c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE) { 03973 if (c0->_softhangup == AST_SOFTHANGUP_UNBRIDGE) 03974 c0->_softhangup = 0; 03975 if (c1->_softhangup == AST_SOFTHANGUP_UNBRIDGE) 03976 c1->_softhangup = 0; 03977 c0->_bridge = c1; 03978 c1->_bridge = c0; 03979 } 03980 continue; 03981 } 03982 f = ast_read(who); 03983 if (!f) { 03984 *fo = NULL; 03985 *rc = who; 03986 if (option_debug) 03987 ast_log(LOG_DEBUG, "Didn't get a frame from channel: %s\n",who->name); 03988 break; 03989 } 03990 03991 other = (who == c0) ? c1 : c0; /* the 'other' channel */ 03992 /* Try add the frame info the who's bridged channel jitterbuff */ 03993 if (jb_in_use) 03994 frame_put_in_jb = !ast_jb_put(other, f); 03995 03996 if ((f->frametype == AST_FRAME_CONTROL) && !(config->flags & AST_BRIDGE_IGNORE_SIGS)) { 03997 int bridge_exit = 0; 03998 03999 switch (f->subclass) { 04000 case AST_CONTROL_HOLD: 04001 case AST_CONTROL_UNHOLD: 04002 case AST_CONTROL_VIDUPDATE: 04003 case AST_CONTROL_SRCUPDATE: 04004 ast_indicate_data(other, f->subclass, f->data, f->datalen); 04005 if (jb_in_use) { 04006 ast_jb_empty_and_reset(c0, c1); 04007 } 04008 break; 04009 default: 04010 *fo = f; 04011 *rc = who; 04012 bridge_exit = 1; 04013 if (option_debug) 04014 ast_log(LOG_DEBUG, "Got a FRAME_CONTROL (%d) frame on channel %s\n", f->subclass, who->name); 04015 break; 04016 } 04017 if (bridge_exit) 04018 break; 04019 } 04020 if ((f->frametype == AST_FRAME_VOICE) || 04021 (f->frametype == AST_FRAME_DTMF_BEGIN) || 04022 (f->frametype == AST_FRAME_DTMF) || 04023 (f->frametype == AST_FRAME_VIDEO) || 04024 (f->frametype == AST_FRAME_IMAGE) || 04025 (f->frametype == AST_FRAME_HTML) || 04026 (f->frametype == AST_FRAME_MODEM) || 04027 (f->frametype == AST_FRAME_TEXT)) { 04028 /* monitored dtmf causes exit from bridge */ 04029 int monitored_source = (who == c0) ? watch_c0_dtmf : watch_c1_dtmf; 04030 04031 if (monitored_source && 04032 (f->frametype == AST_FRAME_DTMF_END || 04033 f->frametype == AST_FRAME_DTMF_BEGIN)) { 04034 *fo = f; 04035 *rc = who; 04036 if (option_debug) 04037 ast_log(LOG_DEBUG, "Got DTMF %s on channel (%s)\n", 04038 f->frametype == AST_FRAME_DTMF_END ? "end" : "begin", 04039 who->name); 04040 04041 break; 04042 } 04043 /* Write immediately frames, not passed through jb */ 04044 if (!frame_put_in_jb) 04045 ast_write(other, f); 04046 04047 /* Check if we have to deliver now */ 04048 if (jb_in_use) 04049 ast_jb_get_and_deliver(c0, c1); 04050 } 04051 /* XXX do we want to pass on also frames not matched above ? */ 04052 ast_frfree(f); 04053 04054 /* Swap who gets priority */ 04055 cs[2] = cs[0]; 04056 cs[0] = cs[1]; 04057 cs[1] = cs[2]; 04058 } 04059 return res; 04060 }
struct ast_channel* ast_get_channel_by_exten_locked | ( | const char * | exten, | |
const char * | context | |||
) |
Get channel by exten (and optionally context) and lock it.
Definition at line 1160 of file channel.c.
References channel_find_locked().
01161 { 01162 return channel_find_locked(NULL, NULL, 0, context, exten); 01163 }
struct ast_channel* ast_get_channel_by_name_locked | ( | const char * | name | ) |
Get channel by name (locks channel).
Definition at line 1141 of file channel.c.
References channel_find_locked().
Referenced by action_atxfer(), action_getvar(), action_hangup(), action_redirect(), action_setcdruserfield(), action_setvar(), action_status(), action_timeout(), ast_async_goto_by_name(), ast_bridge_call(), asyncgoto_exec(), change_monitor_action(), do_pause_or_unpause(), get_zap_channel_locked(), handle_channelstatus(), handle_core_set_debug_channel(), handle_debugchan_deprecated(), handle_getvariablefull(), handle_hangup(), handle_nodebugchan_deprecated(), handle_showchan(), handle_showchan_deprecated(), handle_softhangup(), manager_park(), manager_play_dtmf(), park_call_full(), pbx_builtin_importvar(), start_monitor_action(), and stop_monitor_action().
01142 { 01143 return channel_find_locked(NULL, name, 0, NULL, NULL); 01144 }
struct ast_channel* ast_get_channel_by_name_prefix_locked | ( | const char * | name, | |
const int | namelen | |||
) |
Get channel by name prefix (locks channel).
Definition at line 1147 of file channel.c.
References channel_find_locked().
Referenced by ast_parse_device_state(), common_exec(), and mixmonitor_cli().
01148 { 01149 return channel_find_locked(NULL, name, namelen, NULL, NULL); 01150 }
struct ast_channel_tech* ast_get_channel_tech | ( | const char * | name | ) |
Get a channel technology structure by name.
name | name of technology to find |
Definition at line 552 of file channel.c.
References AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), chanlist::list, LOG_WARNING, chanlist::tech, and ast_channel_tech::type.
Referenced by ast_device_state().
00553 { 00554 struct chanlist *chanls; 00555 const struct ast_channel_tech *ret = NULL; 00556 00557 if (AST_LIST_LOCK(&channels)) { 00558 ast_log(LOG_WARNING, "Unable to lock channel tech list\n"); 00559 return NULL; 00560 } 00561 00562 AST_LIST_TRAVERSE(&backends, chanls, list) { 00563 if (!strcasecmp(name, chanls->tech->type)) { 00564 ret = chanls->tech; 00565 break; 00566 } 00567 } 00568 00569 AST_LIST_UNLOCK(&channels); 00570 00571 return ret; 00572 }
ast_group_t ast_get_group | ( | const char * | s | ) |
Definition at line 4514 of file channel.c.
References ast_log(), ast_strdupa, ast_strlen_zero(), group, and LOG_ERROR.
Referenced by _parse(), build_device(), build_gateway(), build_peer(), build_user(), func_channel_write(), process_dahdi(), and read_agent_config().
04515 { 04516 char *piece; 04517 char *c; 04518 int start=0, finish=0, x; 04519 ast_group_t group = 0; 04520 04521 if (ast_strlen_zero(s)) 04522 return 0; 04523 04524 c = ast_strdupa(s); 04525 04526 while ((piece = strsep(&c, ","))) { 04527 if (sscanf(piece, "%d-%d", &start, &finish) == 2) { 04528 /* Range */ 04529 } else if (sscanf(piece, "%d", &start)) { 04530 /* Just one */ 04531 finish = start; 04532 } else { 04533 ast_log(LOG_ERROR, "Syntax error parsing group configuration '%s' at '%s'. Ignoring.\n", s, piece); 04534 continue; 04535 } 04536 for (x = start; x <= finish; x++) { 04537 if ((x > 63) || (x < 0)) { 04538 ast_log(LOG_WARNING, "Ignoring invalid group %d (maximum group is 63)\n", x); 04539 } else 04540 group |= ((ast_group_t) 1 << x); 04541 } 04542 } 04543 return group; 04544 }
int ast_hangup | ( | struct ast_channel * | chan | ) |
Hang up a channel.
chan | channel to hang up |
Definition at line 1459 of file channel.c.
References ast_assert, ast_audiohook_detach_list(), ast_autoservice_stop(), ast_cause2str(), ast_cdr_detach(), ast_cdr_end(), AST_CDR_FLAG_BRIDGED, AST_CDR_FLAG_DIALED, AST_CDR_FLAG_POST_DISABLED, AST_CDR_NULL, ast_channel_free(), ast_channel_lock, ast_channel_unlock, ast_closestream(), ast_do_masquerade(), AST_FLAG_BLOCKING, AST_FLAG_ZOMBIE, ast_log(), ast_set_flag, ast_test_flag, ast_channel::audiohooks, ast_channel::blocker, ast_channel::blockproc, ast_channel::cdr, ast_cdr::disposition, free_translation(), ast_channel::generator, ast_channel::generatordata, ast_channel_tech::hangup, ast_channel::hangupcause, LOG_DEBUG, manager_event(), ast_channel::masq, ast_channel::masqr, ast_channel::name, option_debug, ast_generator::release, ast_channel::sched, sched_context_destroy(), ast_channel::stream, ast_channel::tech, ast_channel::uniqueid, and ast_channel::vstream.
Referenced by __ast_request_and_dial(), __oh323_new(), agent_hangup(), agent_read(), alsa_new(), answer_exec_run(), app_exec(), ast_async_goto(), ast_bridge_call_thread(), ast_dial_destroy(), ast_dial_hangup(), ast_feature_request_and_dial(), ast_iax2_new(), ast_pbx_outgoing_app(), ast_pbx_outgoing_exten(), ast_pbx_run_app(), async_wait(), begin_dial(), build_conf(), chanavail_exec(), check_compat(), check_goto_on_transfer(), clear_caller(), conf_run(), connect_link(), dahdi_handle_event(), dahdi_new(), do_atxfer(), do_hang(), do_idle_thread(), do_parking_thread(), features_hangup(), findmeexec(), gtalk_new(), handle_enbloc_call_message(), handle_frame(), handle_frame_ownerless(), handle_hd_hf(), handle_init_event(), handle_invite_replaces(), handle_offhook_message(), handle_request_invite(), handle_soft_key_event_message(), handle_stimulus_message(), hangup_chan(), hangupcalls(), hanguptree(), iax2_request(), iax_park(), iax_park_thread(), local_attended_transfer(), local_hangup(), masq_park_call(), mgcp_new(), mgcp_ss(), monitor_dial(), nbs_new(), oss_new(), park_exec(), parkandannounce_exec(), phone_new(), rpt(), rpt_call(), rpt_tele_thread(), sip_new(), sip_park(), sip_park_thread(), skinny_new(), skinny_ss(), ss_thread(), try_calling(), wait_for_answer(), and wait_for_winner().
01460 { 01461 int res = 0; 01462 01463 /* Don't actually hang up a channel that will masquerade as someone else, or 01464 if someone is going to masquerade as us */ 01465 ast_channel_lock(chan); 01466 01467 if (chan->audiohooks) { 01468 ast_audiohook_detach_list(chan->audiohooks); 01469 chan->audiohooks = NULL; 01470 } 01471 01472 ast_autoservice_stop(chan); 01473 01474 if (chan->masq) { 01475 if (ast_do_masquerade(chan)) 01476 ast_log(LOG_WARNING, "Failed to perform masquerade\n"); 01477 } 01478 01479 if (chan->masq) { 01480 ast_log(LOG_WARNING, "%s getting hung up, but someone is trying to masq into us?!?\n", chan->name); 01481 ast_channel_unlock(chan); 01482 return 0; 01483 } 01484 /* If this channel is one which will be masqueraded into something, 01485 mark it as a zombie already, so we know to free it later */ 01486 if (chan->masqr) { 01487 ast_set_flag(chan, AST_FLAG_ZOMBIE); 01488 ast_channel_unlock(chan); 01489 return 0; 01490 } 01491 free_translation(chan); 01492 /* Close audio stream */ 01493 if (chan->stream) { 01494 ast_closestream(chan->stream); 01495 chan->stream = NULL; 01496 } 01497 /* Close video stream */ 01498 if (chan->vstream) { 01499 ast_closestream(chan->vstream); 01500 chan->vstream = NULL; 01501 } 01502 if (chan->sched) { 01503 sched_context_destroy(chan->sched); 01504 chan->sched = NULL; 01505 } 01506 01507 if (chan->generatordata) /* Clear any tone stuff remaining */ 01508 chan->generator->release(chan, chan->generatordata); 01509 chan->generatordata = NULL; 01510 chan->generator = NULL; 01511 if (ast_test_flag(chan, AST_FLAG_BLOCKING)) { 01512 ast_log(LOG_WARNING, "Hard hangup called by thread %ld on %s, while fd " 01513 "is blocked by thread %ld in procedure %s! Expect a failure\n", 01514 (long)pthread_self(), chan->name, (long)chan->blocker, chan->blockproc); 01515 ast_assert(ast_test_flag(chan, AST_FLAG_BLOCKING) == 0); 01516 } 01517 if (!ast_test_flag(chan, AST_FLAG_ZOMBIE)) { 01518 if (option_debug) 01519 ast_log(LOG_DEBUG, "Hanging up channel '%s'\n", chan->name); 01520 if (chan->tech->hangup) 01521 res = chan->tech->hangup(chan); 01522 } else { 01523 if (option_debug) 01524 ast_log(LOG_DEBUG, "Hanging up zombie '%s'\n", chan->name); 01525 } 01526 01527 ast_channel_unlock(chan); 01528 manager_event(EVENT_FLAG_CALL, "Hangup", 01529 "Channel: %s\r\n" 01530 "Uniqueid: %s\r\n" 01531 "Cause: %d\r\n" 01532 "Cause-txt: %s\r\n", 01533 chan->name, 01534 chan->uniqueid, 01535 chan->hangupcause, 01536 ast_cause2str(chan->hangupcause) 01537 ); 01538 01539 if (chan->cdr && !ast_test_flag(chan->cdr, AST_CDR_FLAG_BRIDGED) && 01540 !ast_test_flag(chan->cdr, AST_CDR_FLAG_POST_DISABLED) && 01541 (chan->cdr->disposition != AST_CDR_NULL || ast_test_flag(chan->cdr, AST_CDR_FLAG_DIALED))) { 01542 01543 ast_cdr_end(chan->cdr); 01544 ast_cdr_detach(chan->cdr); 01545 chan->cdr = NULL; 01546 } 01547 01548 ast_channel_free(chan); 01549 01550 return res; 01551 }
int ast_indicate | ( | struct ast_channel * | chan, | |
int | condition | |||
) |
Indicates condition of channel.
chan | channel to change the indication | |
condition | which condition to indicate on the channel |
Definition at line 2459 of file channel.c.
References ast_indicate_data().
Referenced by __ast_play_and_record(), agent_new(), answer_trunk_chan(), ast_answer(), ast_bridge_call(), ast_channel_bridge(), ast_do_masquerade(), ast_dtmf_stream(), ast_feature_request_and_dial(), attempt_transfer(), builtin_blindtransfer(), conf_run(), disa_exec(), do_atxfer(), do_parking_thread(), features_indicate(), finishup(), function_remote(), handle_frame(), handle_recordfile(), mgcp_ss(), monitor_dial(), park_exec(), pbx_builtin_busy(), pbx_builtin_congestion(), pbx_builtin_progress(), pbx_builtin_ringing(), pbx_builtin_waitexten(), queue_exec(), rpt(), send_waveform_to_channel(), skinny_ss(), sla_handle_hold_event(), sla_station_exec(), sla_trunk_exec(), and wait_for_answer().
02460 { 02461 return ast_indicate_data(chan, condition, NULL, 0); 02462 }
int ast_indicate_data | ( | struct ast_channel * | chan, | |
int | condition, | |||
const void * | data, | |||
size_t | datalen | |||
) |
Indicates condition of channel, with payload.
chan | channel to change the indication | |
condition | which condition to indicate on the channel | |
data | pointer to payload data | |
datalen | size of payload data |
Definition at line 2497 of file channel.c.
References ast_channel_lock, ast_channel_unlock, ast_check_hangup(), AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_OFFHOOK, AST_CONTROL_OPTION, AST_CONTROL_PROCEEDING, AST_CONTROL_PROGRESS, AST_CONTROL_RADIO_KEY, AST_CONTROL_RADIO_UNKEY, AST_CONTROL_RING, AST_CONTROL_RINGING, AST_CONTROL_SRCUPDATE, AST_CONTROL_TAKEOFFHOOK, AST_CONTROL_UNHOLD, AST_CONTROL_VIDUPDATE, AST_CONTROL_WINK, AST_FLAG_ZOMBIE, ast_get_indication_tone(), ast_log(), ast_playtones_start(), ast_playtones_stop(), ast_test_flag, tone_zone_sound::data, ast_channel_tech::indicate, is_visible_indication(), LOG_DEBUG, ast_channel::name, option_debug, ast_channel::tech, ast_channel::visible_indication, and ast_channel::zone.
Referenced by __login_exec(), agent_hangup(), ast_bridge_call(), ast_indicate(), bridge_native_loop(), do_parking_thread(), park_call_full(), pbx_builtin_waitexten(), and wait_for_answer().
02499 { 02500 /* By using an enum, we'll get compiler warnings for values not handled 02501 * in switch statements. */ 02502 enum ast_control_frame_type condition = _condition; 02503 const struct tone_zone_sound *ts = NULL; 02504 int res = -1; 02505 02506 ast_channel_lock(chan); 02507 02508 /* Don't bother if the channel is about to go away, anyway. */ 02509 if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) { 02510 ast_channel_unlock(chan); 02511 return -1; 02512 } 02513 02514 if (chan->tech->indicate) { 02515 /* See if the channel driver can handle this condition. */ 02516 res = chan->tech->indicate(chan, condition, data, datalen); 02517 } 02518 02519 ast_channel_unlock(chan); 02520 02521 if (chan->tech->indicate && !res) { 02522 /* The channel driver successfully handled this indication */ 02523 if (is_visible_indication(condition)) { 02524 chan->visible_indication = condition; 02525 } 02526 return 0; 02527 } 02528 02529 /* The channel driver does not support this indication, let's fake 02530 * it by doing our own tone generation if applicable. */ 02531 02532 /*!\note If we compare the enumeration type, which does not have any 02533 * negative constants, the compiler may optimize this code away. 02534 * Therefore, we must perform an integer comparison here. */ 02535 if (_condition < 0) { 02536 /* Stop any tones that are playing */ 02537 ast_playtones_stop(chan); 02538 return 0; 02539 } 02540 02541 /* Handle conditions that we have tones for. */ 02542 switch (condition) { 02543 case AST_CONTROL_RINGING: 02544 ts = ast_get_indication_tone(chan->zone, "ring"); 02545 break; 02546 case AST_CONTROL_BUSY: 02547 ts = ast_get_indication_tone(chan->zone, "busy"); 02548 break; 02549 case AST_CONTROL_CONGESTION: 02550 ts = ast_get_indication_tone(chan->zone, "congestion"); 02551 break; 02552 case AST_CONTROL_PROGRESS: 02553 case AST_CONTROL_PROCEEDING: 02554 case AST_CONTROL_VIDUPDATE: 02555 case AST_CONTROL_SRCUPDATE: 02556 case AST_CONTROL_RADIO_KEY: 02557 case AST_CONTROL_RADIO_UNKEY: 02558 case AST_CONTROL_OPTION: 02559 case AST_CONTROL_WINK: 02560 case AST_CONTROL_FLASH: 02561 case AST_CONTROL_OFFHOOK: 02562 case AST_CONTROL_TAKEOFFHOOK: 02563 case AST_CONTROL_ANSWER: 02564 case AST_CONTROL_HANGUP: 02565 case AST_CONTROL_RING: 02566 case AST_CONTROL_HOLD: 02567 case AST_CONTROL_UNHOLD: 02568 /* Nothing left to do for these. */ 02569 res = 0; 02570 break; 02571 } 02572 02573 if (ts && ts->data[0]) { 02574 /* We have a tone to play, yay. */ 02575 if (option_debug) { 02576 ast_log(LOG_DEBUG, "Driver for channel '%s' does not support indication %d, emulating it\n", chan->name, condition); 02577 } 02578 ast_playtones_start(chan, 0, ts->data, 1); 02579 res = 0; 02580 chan->visible_indication = condition; 02581 } 02582 02583 if (res) { 02584 /* not handled */ 02585 ast_log(LOG_WARNING, "Unable to handle indication %d for '%s'\n", condition, chan->name); 02586 } 02587 02588 return res; 02589 }
void ast_install_music_functions | ( | int(*)(struct ast_channel *, const char *, const char *) | start_ptr, | |
void(*)(struct ast_channel *) | stop_ptr, | |||
void(*)(struct ast_channel *) | cleanup_ptr | |||
) |
Definition at line 4550 of file channel.c.
References ast_moh_cleanup_ptr, ast_moh_start_ptr, and ast_moh_stop_ptr.
Referenced by load_module(), and reload().
04553 { 04554 ast_moh_start_ptr = start_ptr; 04555 ast_moh_stop_ptr = stop_ptr; 04556 ast_moh_cleanup_ptr = cleanup_ptr; 04557 }
int ast_internal_timing_enabled | ( | struct ast_channel * | chan | ) |
Check if the channel can run in internal timing mode.
chan | The channel to check |
Definition at line 2441 of file channel.c.
References ast_log(), ast_opt_internal_timing, LOG_DEBUG, option_debug, and ast_channel::timingfd.
Referenced by add_sdp(), and ast_read_generator_actions().
02442 { 02443 int ret = ast_opt_internal_timing && chan->timingfd > -1; 02444 if (option_debug > 4) 02445 ast_log(LOG_DEBUG, "Internal timing is %s (option_internal_timing=%d chan->timingfd=%d)\n", ret? "enabled": "disabled", ast_opt_internal_timing, chan->timingfd); 02446 return ret; 02447 }
void ast_moh_cleanup | ( | struct ast_channel * | chan | ) |
Definition at line 4587 of file channel.c.
References ast_moh_cleanup_ptr.
Referenced by ast_channel_free().
04588 { 04589 if (ast_moh_cleanup_ptr) 04590 ast_moh_cleanup_ptr(chan); 04591 }
int ast_moh_start | ( | struct ast_channel * | chan, | |
const char * | mclass, | |||
const char * | interpclass | |||
) |
Turn on music on hold on a given channel.
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. |
0 | success | |
non-zero | failure |
Definition at line 4567 of file channel.c.
References ast_moh_start_ptr, ast_verbose(), option_verbose, and VERBOSE_PREFIX_3.
Referenced by alsa_indicate(), app_exec(), cb_events(), conf_run(), dahdi_indicate(), feature_exec_app(), gtalk_indicate(), handle_setmusic(), iax2_indicate(), local_indicate(), mgcp_indicate(), misdn_indication(), moh0_exec(), moh1_exec(), moh3_exec(), oh323_indicate(), oss_indicate(), phone_indicate(), queue_exec(), retrydial_exec(), say_periodic_announcement(), say_position(), sip_indicate(), and skinny_indicate().
04568 { 04569 if (ast_moh_start_ptr) 04570 return ast_moh_start_ptr(chan, mclass, interpclass); 04571 04572 if (option_verbose > 2) { 04573 ast_verbose(VERBOSE_PREFIX_3 "Music class %s requested but no musiconhold loaded.\n", 04574 mclass ? mclass : (interpclass ? interpclass : "default")); 04575 } 04576 04577 return 0; 04578 }
void ast_moh_stop | ( | struct ast_channel * | chan | ) |
Turn off music on hold on a given channel.
Turn off music on hold on a given channel
Definition at line 4581 of file channel.c.
References ast_moh_stop_ptr.
Referenced by alsa_indicate(), app_exec(), ast_quiet_chan(), cb_events(), conf_run(), dahdi_indicate(), feature_exec_app(), gtalk_indicate(), handle_setmusic(), iax2_indicate(), local_indicate(), mgcp_indicate(), misdn_indication(), misdn_transfer_bc(), moh0_exec(), moh1_exec(), moh4_exec(), oh323_indicate(), oss_indicate(), phone_indicate(), queue_exec(), retrydial_exec(), say_periodic_announcement(), say_position(), sip_indicate(), skinny_indicate(), and try_calling().
04582 { 04583 if (ast_moh_stop_ptr) 04584 ast_moh_stop_ptr(chan); 04585 }
char* ast_print_group | ( | char * | buf, | |
int | buflen, | |||
ast_group_t | group | |||
) |
print call- and pickup groups into buffer
Definition at line 4599 of file channel.c.
References first.
Referenced by _sip_show_peer(), func_channel_read(), misdn_cfg_get_config_string(), print_group(), read_config(), and serialize_showchan().
04600 { 04601 unsigned int i; 04602 int first=1; 04603 char num[3]; 04604 04605 buf[0] = '\0'; 04606 04607 if (!group) /* Return empty string if no group */ 04608 return buf; 04609 04610 for (i = 0; i <= 63; i++) { /* Max group is 63 */ 04611 if (group & ((ast_group_t) 1 << i)) { 04612 if (!first) { 04613 strncat(buf, ", ", buflen - strlen(buf) - 1); 04614 } else { 04615 first=0; 04616 } 04617 snprintf(num, sizeof(num), "%u", i); 04618 strncat(buf, num, buflen - strlen(buf) - 1); 04619 } 04620 } 04621 return buf; 04622 }
int ast_prod | ( | struct ast_channel * | chan | ) |
Send empty audio to prime a channel driver.
Definition at line 2711 of file channel.c.
References ast_channel::_state, AST_FRAME_VOICE, AST_FRIENDLY_OFFSET, ast_log(), AST_STATE_UP, ast_write(), ast_frame::data, LOG_DEBUG, ast_channel::name, option_debug, ast_channel::rawwriteformat, ast_frame::src, and ast_frame::subclass.
Referenced by ast_activate_generator().
02712 { 02713 struct ast_frame a = { AST_FRAME_VOICE }; 02714 char nothing[128]; 02715 02716 /* Send an empty audio frame to get things moving */ 02717 if (chan->_state != AST_STATE_UP) { 02718 if (option_debug) 02719 ast_log(LOG_DEBUG, "Prodding channel '%s'\n", chan->name); 02720 a.subclass = chan->rawwriteformat; 02721 a.data = nothing + AST_FRIENDLY_OFFSET; 02722 a.src = "ast_prod"; 02723 if (ast_write(chan, &a)) 02724 ast_log(LOG_WARNING, "Prodding channel '%s' failed\n", chan->name); 02725 } 02726 return 0; 02727 }
int ast_queue_control | ( | struct ast_channel * | chan, | |
enum ast_control_frame_type | control | |||
) |
Queue a control frame with payload.
chan | channel to queue frame onto | |
control | type of control frame |
Definition at line 984 of file channel.c.
References AST_FRAME_CONTROL, ast_queue_frame(), and f.
Referenced by __dahdi_exception(), __oh323_update_info(), ast_pickup_call(), attempt_transfer(), auto_congest(), cb_events(), dahdi_handle_event(), dahdi_hangup(), gtalk_is_answered(), gtalk_ringing_ack(), handle_hd_hf(), handle_offhook_message(), handle_request(), handle_request_bye(), handle_request_info(), handle_request_invite(), handle_request_refer(), handle_response(), handle_response_invite(), handle_response_refer(), handle_soft_key_event_message(), handle_stimulus_message(), mgcp_call(), nbs_call(), phone_call(), pickup_do(), process_sdp(), receive_digit(), send_cause2ast(), setup_rtp_connection(), skinny_call(), skinny_unhold(), ss_thread(), and update_state().
00985 { 00986 struct ast_frame f = { AST_FRAME_CONTROL, }; 00987 00988 f.subclass = control; 00989 00990 return ast_queue_frame(chan, &f); 00991 }
int ast_queue_control_data | ( | struct ast_channel * | chan, | |
enum ast_control_frame_type | control, | |||
const void * | data, | |||
size_t | datalen | |||
) |
Queue a control frame with payload.
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 |
Definition at line 994 of file channel.c.
References AST_FRAME_CONTROL, ast_queue_frame(), and f.
Referenced by action_atxfer(), dahdi_handle_event(), dahdi_hangup(), iax2_queue_control_data(), process_sdp(), and skinny_hold().
00996 { 00997 struct ast_frame f = { AST_FRAME_CONTROL, }; 00998 00999 f.subclass = control; 01000 f.data = (void *) data; 01001 f.datalen = datalen; 01002 01003 return ast_queue_frame(chan, &f); 01004 }
int ast_queue_frame | ( | struct ast_channel * | chan, | |
struct ast_frame * | fin | |||
) |
Queue an outgoing frame.
Definition at line 961 of file channel.c.
References __ast_queue_frame().
Referenced by __oh323_rtp_create(), __oh323_update_info(), agent_new(), alsa_call(), ast_channel_masquerade(), ast_channel_setwhentohangup(), ast_do_masquerade(), ast_dsp_process(), ast_queue_control(), ast_queue_control_data(), ast_queue_hangup(), ast_softhangup_nolock(), cb_events(), console_answer(), console_answer_deprecated(), console_dial(), console_dial_deprecated(), console_flash(), console_flash_deprecated(), console_sendtext(), console_sendtext_deprecated(), dahdi_queue_frame(), dictate_exec(), do_immediate_setup(), gtalk_handle_dtmf(), handle_keypad_button_message(), handle_request_info(), handle_request_invite(), handle_response_invite(), iax2_queue_frame(), local_queue_frame(), mgcp_queue_frame(), oh323_simulate_dtmf_end(), oss_call(), process_sdp(), queue_dtmf_readq(), receive_digit(), receive_message(), rpt_call(), and wakeup_sub().
00962 { 00963 return __ast_queue_frame(chan, fin, 0); 00964 }
int ast_queue_frame_head | ( | struct ast_channel * | chan, | |
struct ast_frame * | f | |||
) |
Queue an outgoing frame to the head of the frame queue.
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. |
0 | success | |
non-zero | failure |
Definition at line 966 of file channel.c.
References __ast_queue_frame().
Referenced by ast_autoservice_stop().
00967 { 00968 return __ast_queue_frame(chan, fin, 1); 00969 }
int ast_queue_hangup | ( | struct ast_channel * | chan | ) |
Queue a hangup frame.
Definition at line 972 of file channel.c.
References ast_channel::_softhangup, ast_channel_trylock, ast_channel_unlock, AST_CONTROL_HANGUP, AST_FRAME_CONTROL, ast_queue_frame(), AST_SOFTHANGUP_DEV, and f.
Referenced by __oh323_update_info(), __sip_autodestruct(), cleanup_connection(), console_hangup(), console_hangup_deprecated(), dahdi_handle_event(), gtalk_hangup_farend(), gtalk_is_answered(), handle_onhook_message(), handle_request_bye(), handle_request_cancel(), handle_response(), handle_response_invite(), handle_soft_key_event_message(), hangup_chan(), hangup_connection(), iax2_destroy(), iax2_queue_hangup(), local_hangup(), mgcp_queue_hangup(), misdn_answer(), pri_hangup_all(), and retrans_pkt().
00973 { 00974 struct ast_frame f = { AST_FRAME_CONTROL, AST_CONTROL_HANGUP }; 00975 /* Yeah, let's not change a lock-critical value without locking */ 00976 if (!ast_channel_trylock(chan)) { 00977 chan->_softhangup |= AST_SOFTHANGUP_DEV; 00978 ast_channel_unlock(chan); 00979 } 00980 return ast_queue_frame(chan, &f); 00981 }
struct ast_frame* ast_read | ( | struct ast_channel * | chan | ) |
Reads a frame.
chan | channel to read a frame from Read a frame. |
Definition at line 2449 of file channel.c.
References __ast_read().
Referenced by __adsi_transmit_messages(), __ast_play_and_record(), __ast_request_and_dial(), adsi_careful_send(), agent_ack_sleep(), agent_read(), app_exec(), ast_feature_request_and_dial(), ast_recvtext(), ast_safe_sleep_conditional(), ast_tonepair(), ast_udptl_bridge(), ast_waitfordigit_full(), async_wait(), autoservice_run(), background_detect_exec(), bridge_native_loop(), bridge_p2p_loop(), channel_spy(), check_goto_on_transfer(), conf_exec(), conf_flush(), conf_run(), dahdi_bridge(), dictate_exec(), disa_exec(), do_atxfer(), do_idle_thread(), do_parking_thread(), do_waiting(), echo_exec(), features_read(), find_cache(), handle_invite_replaces(), handle_recordfile(), iax_park_thread(), ices_exec(), isAnsweringMachine(), masq_park_call(), measurenoise(), misdn_bridge(), monitor_dial(), mp3_exec(), NBScat_exec(), receive_dtmf_digits(), recordthread(), rpt(), run_agi(), send_tone_burst(), send_waveform_to_channel(), sendurl_exec(), speech_background(), ss_thread(), wait_for_answer(), wait_for_hangup(), wait_for_winner(), waitforring_exec(), and waitstream_core().
02450 { 02451 return __ast_read(chan, 0); 02452 }
static void ast_read_generator_actions | ( | struct ast_channel * | chan, | |
struct ast_frame * | f | |||
) | [static] |
Definition at line 1934 of file channel.c.
References ast_channel_lock, ast_channel_unlock, ast_deactivate_generator(), ast_format_rate(), AST_FRAME_CNG, ast_internal_timing_enabled(), ast_log(), ast_settimeout(), f, ast_generator::generate, ast_channel::generator, generator_force(), ast_channel::generatordata, LOG_DEBUG, option_debug, ast_channel::timingfd, ast_channel::timingfunc, and ast_channel::writeformat.
Referenced by __ast_read().
01935 { 01936 if (chan->generatordata && !ast_internal_timing_enabled(chan)) { 01937 void *tmp = chan->generatordata; 01938 int (*generate)(struct ast_channel *chan, void *tmp, int datalen, int samples) = NULL; 01939 int res; 01940 int samples; 01941 01942 if (chan->timingfunc) { 01943 if (option_debug > 1) 01944 ast_log(LOG_DEBUG, "Generator got voice, switching to phase locked mode\n"); 01945 ast_settimeout(chan, 0, NULL, NULL); 01946 } 01947 01948 chan->generatordata = NULL; /* reset, to let writes go through */ 01949 01950 if (f->subclass != chan->writeformat) { 01951 float factor; 01952 factor = ((float) ast_format_rate(chan->writeformat)) / ((float) ast_format_rate(f->subclass)); 01953 samples = (int) ( ((float) f->samples) * factor ); 01954 } else { 01955 samples = f->samples; 01956 } 01957 01958 if (chan->generator->generate) { 01959 generate = chan->generator->generate; 01960 } 01961 /* This unlock is here based on two assumptions that hold true at this point in the 01962 * code. 1) this function is only called from within __ast_read() and 2) all generators 01963 * call ast_write() in their generate callback. 01964 * 01965 * The reason this is added is so that when ast_write is called, the lock that occurs 01966 * there will not recursively lock the channel. Doing this will cause intended deadlock 01967 * avoidance not to work in deeper functions 01968 */ 01969 ast_channel_unlock(chan); 01970 res = generate(chan, tmp, f->datalen, samples); 01971 ast_channel_lock(chan); 01972 chan->generatordata = tmp; 01973 if (res) { 01974 if (option_debug > 1) 01975 ast_log(LOG_DEBUG, "Auto-deactivating generator\n"); 01976 ast_deactivate_generator(chan); 01977 } 01978 01979 } else if (f->frametype == AST_FRAME_CNG) { 01980 if (chan->generator && !chan->timingfunc && (chan->timingfd > -1)) { 01981 if (option_debug > 1) 01982 ast_log(LOG_DEBUG, "Generator got CNG, switching to timed mode\n"); 01983 ast_settimeout(chan, 160, generator_force, chan); 01984 } 01985 } 01986 }
struct ast_frame* ast_read_noaudio | ( | struct ast_channel * | chan | ) |
Reads a frame, returning AST_FRAME_NULL frame if audio. Read a frame.
chan | channel to read a frame from |
Definition at line 2454 of file channel.c.
References __ast_read().
Referenced by conf_run().
02455 { 02456 return __ast_read(chan, 1); 02457 }
int ast_readstring | ( | struct ast_channel * | c, | |
char * | s, | |||
int | len, | |||
int | timeout, | |||
int | rtimeout, | |||
char * | enders | |||
) |
Reads multiple digits
c | channel to read from | |
s | string to read in to. Must be at least the size of your length | |
len | how many digits to read (maximum) | |
timeout | how long to timeout between digits | |
rtimeout | timeout to wait on the first digit | |
enders | digits to end the string Read in a digit string "s", max length "len", maximum timeout between digits "timeout" (-1 for none), terminated by anything in "enders". Give them rtimeout for the first digit. Returns 0 on normal return, or 1 on a timeout. In the case of a timeout, any digits that were read before the timeout will still be available in s. RETURNS 2 in full version when ctrlfd is available, NOT 1 |
Definition at line 3236 of file channel.c.
References ast_readstring_full().
Referenced by __adsi_transmit_messages(), ast_adsi_begin_download(), ast_adsi_get_cpeinfo(), ast_adsi_load_session(), ast_app_getdata(), dialout(), do_directory(), forward_message(), privacy_exec(), vm_authenticate(), vm_newuser(), and vm_options().
03237 { 03238 return ast_readstring_full(c, s, len, timeout, ftimeout, enders, -1, -1); 03239 }
int ast_readstring_full | ( | struct ast_channel * | c, | |
char * | s, | |||
int | len, | |||
int | timeout, | |||
int | ftimeout, | |||
char * | enders, | |||
int | audiofd, | |||
int | ctrlfd | |||
) |
Definition at line 3241 of file channel.c.
References ast_check_hangup(), AST_DIGIT_ANY, AST_FLAG_ZOMBIE, ast_stopstream(), ast_test_flag, ast_waitfordigit_full(), ast_waitstream_full(), and ast_channel::stream.
Referenced by ast_app_getdata_full(), and ast_readstring().
03242 { 03243 int pos = 0; /* index in the buffer where we accumulate digits */ 03244 int to = ftimeout; 03245 03246 /* Stop if we're a zombie or need a soft hangup */ 03247 if (ast_test_flag(c, AST_FLAG_ZOMBIE) || ast_check_hangup(c)) 03248 return -1; 03249 if (!len) 03250 return -1; 03251 for (;;) { 03252 int d; 03253 if (c->stream) { 03254 d = ast_waitstream_full(c, AST_DIGIT_ANY, audiofd, ctrlfd); 03255 ast_stopstream(c); 03256 usleep(1000); 03257 if (!d) 03258 d = ast_waitfordigit_full(c, to, audiofd, ctrlfd); 03259 } else { 03260 d = ast_waitfordigit_full(c, to, audiofd, ctrlfd); 03261 } 03262 if (d < 0) 03263 return -1; 03264 if (d == 0) { 03265 s[pos]='\0'; 03266 return 1; 03267 } 03268 if (d == 1) { 03269 s[pos]='\0'; 03270 return 2; 03271 } 03272 if (!strchr(enders, d)) 03273 s[pos++] = d; 03274 if (strchr(enders, d) || (pos >= len)) { 03275 s[pos]='\0'; 03276 return 0; 03277 } 03278 to = timeout; 03279 } 03280 /* Never reached */ 03281 return 0; 03282 }
int ast_recvchar | ( | struct ast_channel * | chan, | |
int | timeout | |||
) |
Receives a text character from a channel.
chan | channel to act upon | |
timeout | timeout in milliseconds (0 for infinite wait) Read a char of text from a channel Returns 0 on success, -1 on failure |
Definition at line 2591 of file channel.c.
References ast_recvtext(), and free.
Referenced by handle_recvchar().
02592 { 02593 int c; 02594 char *buf = ast_recvtext(chan, timeout); 02595 if (buf == NULL) 02596 return -1; /* error or timeout */ 02597 c = *(unsigned char *)buf; 02598 free(buf); 02599 return c; 02600 }
char* ast_recvtext | ( | struct ast_channel * | chan, | |
int | timeout | |||
) |
Receives a text string from a channel Read a string of text from a channel.
chan | channel to act upon | |
timeout | timeout in milliseconds (0 for infinite wait) |
Definition at line 2602 of file channel.c.
References ast_check_hangup(), AST_CONTROL_HANGUP, AST_FRAME_CONTROL, AST_FRAME_TEXT, ast_frfree, ast_read(), ast_strndup, ast_waitfor(), and f.
Referenced by ast_recvchar(), and handle_recvtext().
02603 { 02604 int res, done = 0; 02605 char *buf = NULL; 02606 02607 while (!done) { 02608 struct ast_frame *f; 02609 if (ast_check_hangup(chan)) 02610 break; 02611 res = ast_waitfor(chan, timeout); 02612 if (res <= 0) /* timeout or error */ 02613 break; 02614 timeout = res; /* update timeout */ 02615 f = ast_read(chan); 02616 if (f == NULL) 02617 break; /* no frame */ 02618 if (f->frametype == AST_FRAME_CONTROL && f->subclass == AST_CONTROL_HANGUP) 02619 done = 1; /* force a break */ 02620 else if (f->frametype == AST_FRAME_TEXT) { /* what we want */ 02621 buf = ast_strndup((char *) f->data, f->datalen); /* dup and break */ 02622 done = 1; 02623 } 02624 ast_frfree(f); 02625 } 02626 return buf; 02627 }
struct ast_channel* ast_request | ( | const char * | type, | |
int | format, | |||
void * | data, | |||
int * | status | |||
) |
Requests a channel.
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 |
Definition at line 3142 of file channel.c.
References AST_CAUSE_BEARERCAPABILITY_NOTAVAIL, AST_CAUSE_NOSUCHDRIVER, AST_CAUSE_NOTDEFINED, AST_FORMAT_AUDIO_MASK, AST_FORMAT_VIDEO_MASK, AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_translator_best_choice(), capabilities, ast_channel_tech::capabilities, ast_channel_tech::requester, chanlist::tech, and ast_channel_tech::type.
Referenced by __ast_request_and_dial(), agent_request(), ast_feature_request_and_dial(), attempt_reconnect(), begin_dial(), build_conf(), chanavail_exec(), conf_run(), connect_link(), features_alloc(), findmeexec(), ring_entry(), rpt(), rpt_call(), rpt_tele_thread(), and wait_for_answer().
03143 { 03144 struct chanlist *chan; 03145 struct ast_channel *c; 03146 int capabilities; 03147 int fmt; 03148 int res; 03149 int foo; 03150 int videoformat = format & AST_FORMAT_VIDEO_MASK; 03151 03152 if (!cause) 03153 cause = &foo; 03154 *cause = AST_CAUSE_NOTDEFINED; 03155 03156 if (AST_LIST_LOCK(&channels)) { 03157 ast_log(LOG_WARNING, "Unable to lock channel list\n"); 03158 return NULL; 03159 } 03160 03161 AST_LIST_TRAVERSE(&backends, chan, list) { 03162 if (strcasecmp(type, chan->tech->type)) 03163 continue; 03164 03165 capabilities = chan->tech->capabilities; 03166 fmt = format & AST_FORMAT_AUDIO_MASK; 03167 res = ast_translator_best_choice(&fmt, &capabilities); 03168 if (res < 0) { 03169 ast_log(LOG_WARNING, "No translator path exists for channel type %s (native %d) to %d\n", type, chan->tech->capabilities, format); 03170 *cause = AST_CAUSE_BEARERCAPABILITY_NOTAVAIL; 03171 AST_LIST_UNLOCK(&channels); 03172 return NULL; 03173 } 03174 AST_LIST_UNLOCK(&channels); 03175 if (!chan->tech->requester) 03176 return NULL; 03177 03178 if (!(c = chan->tech->requester(type, capabilities | videoformat, data, cause))) 03179 return NULL; 03180 03181 /* no need to generate a Newchannel event here; it is done in the channel_alloc call */ 03182 return c; 03183 } 03184 03185 ast_log(LOG_WARNING, "No channel type registered for '%s'\n", type); 03186 *cause = AST_CAUSE_NOSUCHDRIVER; 03187 AST_LIST_UNLOCK(&channels); 03188 03189 return NULL; 03190 }
struct ast_channel* ast_request_and_dial | ( | const char * | type, | |
int | format, | |||
void * | data, | |||
int | timeout, | |||
int * | reason, | |||
const char * | cidnum, | |||
const char * | cidname | |||
) |
Request a channel of a given type, with data as optional information used by the low level module and attempt to place a call on it.
type | type of channel to request | |
format | requested channel format | |
data | data to pass to the channel requester | |
timeout | maximum amount of time to wait for an answer | |
reason | why unsuccessful (if unsuceessful) | |
cidnum | Caller-ID Number | |
cidname | Caller-ID Name |
Definition at line 3137 of file channel.c.
References __ast_request_and_dial().
Referenced by ast_pbx_outgoing_exten().
03138 { 03139 return __ast_request_and_dial(type, format, data, timeout, outstate, cidnum, cidname, NULL); 03140 }
int ast_safe_sleep | ( | struct ast_channel * | chan, | |
int | ms | |||
) |
Wait for a specied amount of time, looking for hangups.
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. |
Definition at line 1194 of file channel.c.
References ast_safe_sleep_conditional().
Referenced by __login_exec(), alarmreceiver_exec(), ast_adsi_transmit_message_full(), ast_dtmf_stream(), ast_senddigit(), builtin_parkcall(), conf_run(), dictate_exec(), flash_exec(), function_ilink(), mgcp_ss(), milliwatt_exec(), moh0_exec(), moh1_exec(), old_milliwatt_exec(), park_call_exec(), pbx_builtin_answer(), pbx_builtin_wait(), play_tone_pair(), playtone(), privacy_exec(), receive_ademco_contact_id(), rpt_call(), rpt_exec(), rpt_tele_thread(), send_morse(), send_tone_telemetry(), skinny_ss(), ss_thread(), testclient_exec(), testserver_exec(), try_calling(), wait_for_hangup(), wait_interval(), and zapateller_exec().
01195 { 01196 return ast_safe_sleep_conditional(chan, ms, NULL, NULL); 01197 }
int ast_safe_sleep_conditional | ( | struct ast_channel * | chan, | |
int | ms, | |||
int(*)(void *) | cond, | |||
void * | data | |||
) |
Wait for a specied amount of time, looking for hangups and a condition argument.
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 |
Definition at line 1173 of file channel.c.
References ast_frfree, ast_read(), ast_waitfor(), and f.
Referenced by __login_exec(), and ast_safe_sleep().
01174 { 01175 struct ast_frame *f; 01176 01177 while (ms > 0) { 01178 if (cond && ((*cond)(data) == 0)) 01179 return 0; 01180 ms = ast_waitfor(chan, ms); 01181 if (ms < 0) 01182 return -1; 01183 if (ms > 0) { 01184 f = ast_read(chan); 01185 if (!f) 01186 return -1; 01187 ast_frfree(f); 01188 } 01189 } 01190 return 0; 01191 }
char* ast_safe_string_alloc | ( | const char * | fmt, | |
... | ||||
) |
printf the string into a correctly sized mallocd buffer, and return the buffer
return a mallocd string with the result of sprintf of the fmt and following args
Definition at line 409 of file channel.c.
References ast_malloc, and len().
Referenced by dahdi_new(), and features_new().
00410 { 00411 char *b2, buf[1]; 00412 int len; 00413 va_list args; 00414 00415 va_start(args, fmt); 00416 len = vsnprintf(buf, 1, fmt, args); 00417 va_end(args); 00418 00419 if (!(b2 = ast_malloc(len + 1))) 00420 return NULL; 00421 00422 va_start(args, fmt); 00423 vsnprintf(b2, len + 1, fmt, args); 00424 va_end(args); 00425 00426 return b2; 00427 }
int ast_say_character_str | ( | struct ast_channel * | chan, | |
const char * | str, | |||
const char * | ints, | |||
const char * | lang | |||
) |
Definition at line 4881 of file channel.c.
References ast_say_character_str_full.
Referenced by common_exec(), pbx_builtin_saycharacters(), play_mailbox_owner(), rpt_tele_thread(), and saycharstr().
04883 { 04884 return ast_say_character_str_full(chan, str, ints, lang, -1, -1); 04885 }
int ast_say_digit_str | ( | struct ast_channel * | chan, | |
const char * | str, | |||
const char * | ints, | |||
const char * | lang | |||
) |
Definition at line 4875 of file channel.c.
References ast_say_digit_str_full.
Referenced by invent_message(), mgcp_ss(), pbx_builtin_saydigits(), play_message_callerid(), and ss_thread().
04877 { 04878 return ast_say_digit_str_full(chan, str, ints, lang, -1, -1); 04879 }
int ast_say_digits | ( | struct ast_channel * | chan, | |
int | num, | |||
const char * | ints, | |||
const char * | lang | |||
) |
Definition at line 4869 of file channel.c.
References ast_say_digits_full().
Referenced by common_exec(), conf_exec(), park_call_full(), parkandannounce_exec(), and rpt_tele_thread().
04871 { 04872 return ast_say_digits_full(chan, num, ints, lang, -1, -1); 04873 }
int ast_say_digits_full | ( | struct ast_channel * | chan, | |
int | num, | |||
const char * | ints, | |||
const char * | lang, | |||
int | audiofd, | |||
int | ctrlfd | |||
) |
Definition at line 4893 of file channel.c.
References ast_say_digit_str_full.
Referenced by __say_init(), ast_say_digits(), ast_say_enumeration_full_da(), ast_say_enumeration_full_de(), ast_say_number_full_cz(), ast_say_number_full_da(), ast_say_number_full_de(), ast_say_number_full_en(), ast_say_number_full_en_GB(), ast_say_number_full_es(), ast_say_number_full_fr(), ast_say_number_full_ge(), ast_say_number_full_he(), ast_say_number_full_it(), ast_say_number_full_nl(), ast_say_number_full_no(), ast_say_number_full_pt(), ast_say_number_full_ru(), ast_say_number_full_se(), and ast_say_number_full_tw().
04895 { 04896 char buf[256]; 04897 04898 snprintf(buf, sizeof(buf), "%d", num); 04899 return ast_say_digit_str_full(chan, buf, ints, lang, audiofd, ctrlfd); 04900 }
int ast_say_enumeration | ( | struct ast_channel * | chan, | |
int | num, | |||
const char * | ints, | |||
const char * | language, | |||
const char * | options | |||
) |
Definition at line 4863 of file channel.c.
References ast_say_enumeration_full.
Referenced by ast_say_date_da(), ast_say_date_de(), ast_say_date_with_format_da(), ast_say_date_with_format_de(), ast_say_date_with_format_en(), and ast_say_date_with_format_pl().
04865 { 04866 return ast_say_enumeration_full(chan, num, ints, language, options, -1, -1); 04867 }
int ast_say_number | ( | struct ast_channel * | chan, | |
int | num, | |||
const char * | ints, | |||
const char * | language, | |||
const char * | options | |||
) |
Definition at line 4857 of file channel.c.
References ast_say_number_full.
Referenced by ast_say_date_da(), ast_say_date_de(), ast_say_date_en(), ast_say_date_es(), ast_say_date_fr(), ast_say_date_ge(), ast_say_date_gr(), ast_say_date_he(), ast_say_date_nl(), ast_say_date_pt(), ast_say_date_with_format_da(), ast_say_date_with_format_de(), ast_say_date_with_format_en(), ast_say_date_with_format_es(), ast_say_date_with_format_fr(), ast_say_date_with_format_it(), ast_say_date_with_format_nl(), ast_say_date_with_format_pl(), ast_say_date_with_format_pt(), ast_say_datetime_en(), ast_say_datetime_fr(), ast_say_datetime_from_now_en(), ast_say_datetime_from_now_fr(), ast_say_datetime_from_now_ge(), ast_say_datetime_from_now_he(), ast_say_datetime_from_now_pt(), ast_say_datetime_he(), ast_say_datetime_pt(), ast_say_datetime_tw(), ast_say_time_de(), ast_say_time_en(), ast_say_time_es(), ast_say_time_fr(), ast_say_time_ge(), ast_say_time_gr(), ast_say_time_nl(), ast_say_time_pt(), ast_say_time_pt_BR(), ast_say_time_tw(), bridge_playfile(), conf_exec(), conf_run(), count_exec(), dictate_exec(), get_folder(), gr_say_number_female(), pbx_builtin_saynumber(), play_message(), play_message_duration(), rpt_tele_thread(), say_and_wait(), say_position(), saynum(), try_calling(), vm_intro_gr(), vm_intro_he(), vm_intro_multilang(), vm_intro_pt(), and vm_intro_pt_BR().
04859 { 04860 return ast_say_number_full(chan, num, ints, language, options, -1, -1); 04861 }
int ast_say_phonetic_str | ( | struct ast_channel * | chan, | |
const char * | str, | |||
const char * | ints, | |||
const char * | lang | |||
) |
Definition at line 4887 of file channel.c.
References ast_say_phonetic_str_full.
Referenced by pbx_builtin_sayphonetic().
04889 { 04890 return ast_say_phonetic_str_full(chan, str, ints, lang, -1, -1); 04891 }
int ast_senddigit | ( | struct ast_channel * | chan, | |
char | digit | |||
) |
Send a DTMF digit to a channel Send a DTMF digit to a channel.
chan | channel to act upon | |
digit | the DTMF digit to send, encoded in ASCII |
Definition at line 2701 of file channel.c.
References AST_DEFAULT_EMULATE_DTMF_DURATION, ast_safe_sleep(), ast_senddigit_begin(), ast_senddigit_end(), ast_channel_tech::send_digit_begin, and ast_channel::tech.
Referenced by ast_dtmf_stream(), do_dtmf_phone(), manager_play_dtmf(), and rpt_call().
02702 { 02703 if (chan->tech->send_digit_begin) { 02704 ast_senddigit_begin(chan, digit); 02705 ast_safe_sleep(chan, AST_DEFAULT_EMULATE_DTMF_DURATION); 02706 } 02707 02708 return ast_senddigit_end(chan, digit, AST_DEFAULT_EMULATE_DTMF_DURATION); 02709 }
int ast_senddigit_begin | ( | struct ast_channel * | chan, | |
char | digit | |||
) |
Definition at line 2642 of file channel.c.
References ast_log(), ast_playtones_start(), LOG_DEBUG, ast_channel::name, option_debug, ast_channel_tech::send_digit_begin, and ast_channel::tech.
Referenced by agent_digit_begin(), ast_senddigit(), ast_write(), and features_digit_begin().
02643 { 02644 /* Device does not support DTMF tones, lets fake 02645 * it by doing our own generation. */ 02646 static const char* dtmf_tones[] = { 02647 "941+1336", /* 0 */ 02648 "697+1209", /* 1 */ 02649 "697+1336", /* 2 */ 02650 "697+1477", /* 3 */ 02651 "770+1209", /* 4 */ 02652 "770+1336", /* 5 */ 02653 "770+1477", /* 6 */ 02654 "852+1209", /* 7 */ 02655 "852+1336", /* 8 */ 02656 "852+1477", /* 9 */ 02657 "697+1633", /* A */ 02658 "770+1633", /* B */ 02659 "852+1633", /* C */ 02660 "941+1633", /* D */ 02661 "941+1209", /* * */ 02662 "941+1477" /* # */ 02663 }; 02664 02665 if (!chan->tech->send_digit_begin) 02666 return 0; 02667 02668 if (!chan->tech->send_digit_begin(chan, digit)) 02669 return 0; 02670 02671 if (digit >= '0' && digit <='9') 02672 ast_playtones_start(chan, 0, dtmf_tones[digit-'0'], 0); 02673 else if (digit >= 'A' && digit <= 'D') 02674 ast_playtones_start(chan, 0, dtmf_tones[digit-'A'+10], 0); 02675 else if (digit == '*') 02676 ast_playtones_start(chan, 0, dtmf_tones[14], 0); 02677 else if (digit == '#') 02678 ast_playtones_start(chan, 0, dtmf_tones[15], 0); 02679 else { 02680 /* not handled */ 02681 if (option_debug) 02682 ast_log(LOG_DEBUG, "Unable to generate DTMF tone '%c' for '%s'\n", digit, chan->name); 02683 } 02684 02685 return 0; 02686 }
int ast_senddigit_end | ( | struct ast_channel * | chan, | |
char | digit, | |||
unsigned int | duration | |||
) |
Definition at line 2688 of file channel.c.
References ast_playtones_stop(), ast_channel::generator, ast_channel_tech::send_digit_end, and ast_channel::tech.
Referenced by agent_digit_end(), ast_senddigit(), ast_write(), and features_digit_end().
02689 { 02690 int res = -1; 02691 02692 if (chan->tech->send_digit_end) 02693 res = chan->tech->send_digit_end(chan, digit, duration); 02694 02695 if (res && chan->generator) 02696 ast_playtones_stop(chan); 02697 02698 return 0; 02699 }
int ast_sendtext | ( | struct ast_channel * | chan, | |
const char * | text | |||
) |
Sends text to a channel Write text to a display on a channel.
chan | channel to act upon | |
text | string of text to send on the channel |
Definition at line 2629 of file channel.c.
References ast_check_hangup(), ast_clear_flag, AST_FLAG_BLOCKING, AST_FLAG_ZOMBIE, ast_test_flag, CHECK_BLOCKING, ast_channel_tech::send_text, and ast_channel::tech.
Referenced by agent_sendtext(), handle_sendtext(), and sendtext_exec().
02630 { 02631 int res = 0; 02632 /* Stop if we're a zombie or need a soft hangup */ 02633 if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) 02634 return -1; 02635 CHECK_BLOCKING(chan); 02636 if (chan->tech->send_text) 02637 res = chan->tech->send_text(chan, text); 02638 ast_clear_flag(chan, AST_FLAG_BLOCKING); 02639 return res; 02640 }
void ast_set_callerid | ( | struct ast_channel * | chan, | |
const char * | cidnum, | |||
const char * | cidname, | |||
const char * | ani | |||
) |
Definition at line 3796 of file channel.c.
References ast_channel_lock, ast_channel_unlock, ast_describe_caller_presentation(), ast_strdup, ast_channel::cid, ast_callerid::cid_ani, ast_callerid::cid_name, ast_callerid::cid_num, ast_callerid::cid_pres, free, manager_event(), ast_channel::name, S_OR, and ast_channel::uniqueid.
Referenced by __ast_request_and_dial(), agent_call(), ast_feature_request_and_dial(), callerid_write(), dahdi_read(), disa_exec(), findmeexec(), handle_setcallerid(), lookupcidname_exec(), mgcp_ss(), privacy_exec(), read_config(), setcallerid_exec(), skinny_newcall(), ss_thread(), and wait_for_answer().
03797 { 03798 ast_channel_lock(chan); 03799 03800 if (callerid) { 03801 if (chan->cid.cid_num) 03802 free(chan->cid.cid_num); 03803 chan->cid.cid_num = ast_strdup(callerid); 03804 } 03805 if (calleridname) { 03806 if (chan->cid.cid_name) 03807 free(chan->cid.cid_name); 03808 chan->cid.cid_name = ast_strdup(calleridname); 03809 } 03810 if (ani) { 03811 if (chan->cid.cid_ani) 03812 free(chan->cid.cid_ani); 03813 chan->cid.cid_ani = ast_strdup(ani); 03814 } 03815 manager_event(EVENT_FLAG_CALL, "Newcallerid", 03816 "Channel: %s\r\n" 03817 "CallerID: %s\r\n" 03818 "CallerIDName: %s\r\n" 03819 "Uniqueid: %s\r\n" 03820 "CID-CallingPres: %d (%s)\r\n", 03821 chan->name, 03822 S_OR(chan->cid.cid_num, "<Unknown>"), 03823 S_OR(chan->cid.cid_name, "<Unknown>"), 03824 chan->uniqueid, 03825 chan->cid.cid_pres, 03826 ast_describe_caller_presentation(chan->cid.cid_pres) 03827 ); 03828 03829 ast_channel_unlock(chan); 03830 }
int ast_set_read_format | ( | struct ast_channel * | chan, | |
int | format | |||
) |
Sets read format on channel chan Set read format for channel to whichever component of "format" is best.
chan | channel to change | |
format | format to change to |
Definition at line 2982 of file channel.c.
References ast_channel::rawreadformat, ast_channel::readformat, ast_channel::readtrans, and set_format().
Referenced by __ast_play_and_record(), __login_exec(), __oh323_update_info(), agent_call(), alarmreceiver_exec(), ast_adsi_transmit_message_full(), ast_channel_make_compatible(), ast_do_masquerade(), attempt_reconnect(), background_detect_exec(), build_conf(), conf_run(), connect_link(), dictate_exec(), disa_exec(), do_waiting(), eagi_exec(), echo_exec(), gtalk_rtp_read(), handle_recordfile(), ices_exec(), isAnsweringMachine(), measurenoise(), mgcp_rtp_read(), oh323_rtp_read(), old_milliwatt_exec(), process_sdp(), rpt(), setup_rtp_connection(), sip_rtp_read(), skinny_rtp_read(), socket_process(), speech_background(), and update_features().
02983 { 02984 return set_format(chan, fmt, &chan->rawreadformat, &chan->readformat, 02985 &chan->readtrans, 0); 02986 }
void ast_set_variables | ( | struct ast_channel * | chan, | |
struct ast_variable * | vars | |||
) |
adds a list of channel variables to a channel
chan | the channel | |
vars | a linked list of variables |
Definition at line 4624 of file channel.c.
References ast_variable::name, ast_variable::next, pbx_builtin_setvar_helper(), and ast_variable::value.
Referenced by __ast_request_and_dial(), ast_pbx_outgoing_app(), and ast_pbx_outgoing_exten().
04625 { 04626 struct ast_variable *cur; 04627 04628 for (cur = vars; cur; cur = cur->next) 04629 pbx_builtin_setvar_helper(chan, cur->name, cur->value); 04630 }
int ast_set_write_format | ( | struct ast_channel * | chan, | |
int | format | |||
) |
Sets write format on channel chan Set write format for channel to whichever compoent of "format" is best.
chan | channel to change | |
format | new format for writing |
Definition at line 2988 of file channel.c.
References ast_channel::rawwriteformat, set_format(), ast_channel::writeformat, and ast_channel::writetrans.
Referenced by __login_exec(), __oh323_update_info(), agent_call(), alarmreceiver_exec(), ast_adsi_transmit_message_full(), ast_channel_make_compatible(), ast_channel_start_silence_generator(), ast_channel_stop_silence_generator(), ast_do_masquerade(), ast_openstream_full(), ast_stopstream(), attempt_reconnect(), build_conf(), chanspy_exec(), conf_run(), connect_link(), disa_exec(), echo_exec(), extenspy_exec(), gtalk_rtp_read(), linear_alloc(), linear_release(), mgcp_rtp_read(), moh_alloc(), moh_files_release(), moh_release(), mp3_exec(), NBScat_exec(), oh323_rtp_read(), old_milliwatt_exec(), playtones_alloc(), playtones_release(), process_sdp(), rpt(), send_waveform_to_channel(), setup_rtp_connection(), sip_rtp_read(), skinny_rtp_read(), socket_process(), tonepair_alloc(), tonepair_release(), and update_features().
02989 { 02990 return set_format(chan, fmt, &chan->rawwriteformat, &chan->writeformat, 02991 &chan->writetrans, 1); 02992 }
int ast_setstate | ( | struct ast_channel * | chan, | |
enum ast_channel_state | state | |||
) |
Change the state of a channel.
Definition at line 3832 of file channel.c.
References ast_channel::_state, AST_CHANNEL_NAME, ast_copy_string(), ast_device_state_changed_literal(), ast_state2str(), ast_channel::cid, ast_callerid::cid_name, ast_callerid::cid_num, manager_event(), name, ast_channel::name, S_OR, and ast_channel::uniqueid.
Referenced by __ast_read(), __dahdi_exception(), __oh323_update_info(), agent_call(), alsa_answer(), ast_answer(), cb_events(), check_availability(), dahdi_answer(), dahdi_call(), dahdi_handle_event(), dahdi_indicate(), dahdi_read(), gtalk_call(), gtalk_newcall(), handle_invite_replaces(), handle_offhook_message(), handle_request_invite(), handle_response_invite(), handle_soft_key_event_message(), handle_stimulus_message(), iax2_call(), mgcp_answer(), mgcp_call(), mgcp_ss(), misdn_call(), misdn_indication(), nbs_call(), nbs_hangup(), oh323_answer(), oss_answer(), pbx_builtin_busy(), pbx_builtin_congestion(), phone_answer(), phone_call(), phone_exception(), phone_hangup(), phone_write(), release_chan(), sip_answer(), skinny_answer(), skinny_call(), skinny_newcall(), ss_thread(), and update_state().
03833 { 03834 char name[AST_CHANNEL_NAME], *dashptr; 03835 int oldstate = chan->_state; 03836 03837 if (oldstate == state) 03838 return 0; 03839 03840 ast_copy_string(name, chan->name, sizeof(name)); 03841 if ((dashptr = strrchr(name, '-'))) { 03842 *dashptr = '\0'; 03843 } 03844 03845 chan->_state = state; 03846 ast_device_state_changed_literal(name); 03847 /* setstate used to conditionally report Newchannel; this is no more */ 03848 manager_event(EVENT_FLAG_CALL, 03849 "Newstate", 03850 "Channel: %s\r\n" 03851 "State: %s\r\n" 03852 "CallerID: %s\r\n" 03853 "CallerIDName: %s\r\n" 03854 "Uniqueid: %s\r\n", 03855 chan->name, ast_state2str(chan->_state), 03856 S_OR(chan->cid.cid_num, "<unknown>"), 03857 S_OR(chan->cid.cid_name, "<unknown>"), 03858 chan->uniqueid); 03859 03860 return 0; 03861 }
int ast_settimeout | ( | struct ast_channel * | c, | |
int | samples, | |||
int(*)(const void *data) | func, | |||
void * | data | |||
) |
Definition at line 1837 of file channel.c.
References ast_channel_lock, ast_channel_unlock, ast_log(), LOG_DEBUG, option_debug, ast_channel::timingdata, ast_channel::timingfd, and ast_channel::timingfunc.
Referenced by ast_activate_generator(), ast_deactivate_generator(), ast_read_generator_actions(), ast_readaudio_callback(), and filestream_destructor().
01838 { 01839 int res = -1; 01840 #ifdef HAVE_DAHDI 01841 ast_channel_lock(c); 01842 if (c->timingfd > -1) { 01843 if (!func) { 01844 samples = 0; 01845 data = 0; 01846 } 01847 if (option_debug) 01848 ast_log(LOG_DEBUG, "Scheduling timer at %d sample intervals\n", samples); 01849 res = ioctl(c->timingfd, DAHDI_TIMERCONFIG, &samples); 01850 c->timingfunc = func; 01851 c->timingdata = data; 01852 } 01853 ast_channel_unlock(c); 01854 #endif 01855 return res; 01856 }
int ast_shutting_down | ( | void | ) |
Returns non-zero if Asterisk is being shut down.
Returns non-zero if Asterisk is being shut down
Definition at line 461 of file channel.c.
Referenced by handle_request_options().
00462 { 00463 return shutting_down; 00464 }
int ast_softhangup | ( | struct ast_channel * | chan, | |
int | cause | |||
) |
Softly hangup up a channel.
chan | channel to be soft-hung-up Call the protocol layer, but don't destroy the channel structure (use this if you are trying to safely hangup a channel managed by another thread. | |
cause | Ast hangupcause for hangup |
Definition at line 1437 of file channel.c.
References ast_channel_lock, ast_channel_unlock, and ast_softhangup_nolock().
Referenced by __ast_module_user_hangup_all(), __login_exec(), __unload_module(), action_hangup(), agent_hangup(), agent_logoff(), ast_begin_shutdown(), ast_dial_join(), conf_free(), connect_link(), dahdi_handle_event(), function_ilink(), handle_hangup(), handle_link_data(), handle_softhangup(), manager_park(), read_agent_config(), rpt(), rpt_call(), rpt_do_restart(), sla_handle_hold_event(), softhangup_exec(), start_spying(), startmon(), and unload_module().
01438 { 01439 int res; 01440 ast_channel_lock(chan); 01441 res = ast_softhangup_nolock(chan, cause); 01442 ast_channel_unlock(chan); 01443 return res; 01444 }
int ast_softhangup_nolock | ( | struct ast_channel * | chan, | |
int | cause | |||
) |
Softly hangup up a channel (no channel lock).
chan | channel to be soft-hung-up | |
cause | Ast hangupcause for hangup (see cause.h) |
Definition at line 1423 of file channel.c.
References ast_channel::_softhangup, AST_FLAG_BLOCKING, ast_log(), ast_null_frame, ast_queue_frame(), ast_test_flag, ast_channel::blocker, LOG_DEBUG, ast_channel::name, and option_debug.
Referenced by ast_async_goto(), ast_softhangup(), attempt_transfer(), dahdi_softhangup_all(), do_monitor(), oh323_indicate(), sip_indicate(), and skinny_indicate().
01424 { 01425 if (option_debug) 01426 ast_log(LOG_DEBUG, "Soft-Hanging up channel '%s'\n", chan->name); 01427 /* Inform channel driver that we need to be hung up, if it cares */ 01428 chan->_softhangup |= cause; 01429 ast_queue_frame(chan, &ast_null_frame); 01430 /* Interrupt any poll call or such */ 01431 if (ast_test_flag(chan, AST_FLAG_BLOCKING)) 01432 pthread_kill(chan->blocker, SIGURG); 01433 return 0; 01434 }
char* ast_state2str | ( | enum | ast_channel_state | ) |
Gives the string form of a given channel state.
ast_channel_state | state to get the name of Give a name to a state Returns the text form of the binary state given |
Definition at line 600 of file channel.c.
References AST_STATE_BUSY, AST_STATE_DIALING, AST_STATE_DIALING_OFFHOOK, AST_STATE_DOWN, AST_STATE_OFFHOOK, AST_STATE_PRERING, AST_STATE_RESERVED, AST_STATE_RING, AST_STATE_RINGING, AST_STATE_UP, ast_threadstorage_get(), STATE2STR_BUFSIZE, and state2str_threadbuf.
Referenced by action_status(), agent_hangup(), ast_setstate(), attempt_transfer(), func_channel_read(), handle_chanlist(), handle_chanlist_deprecated(), handle_invite_replaces(), handle_showchan(), handle_showchan_deprecated(), local_attended_transfer(), mgcp_new(), serialize_showchan(), and sip_hangup().
00601 { 00602 char *buf; 00603 00604 switch(state) { 00605 case AST_STATE_DOWN: 00606 return "Down"; 00607 case AST_STATE_RESERVED: 00608 return "Rsrvd"; 00609 case AST_STATE_OFFHOOK: 00610 return "OffHook"; 00611 case AST_STATE_DIALING: 00612 return "Dialing"; 00613 case AST_STATE_RING: 00614 return "Ring"; 00615 case AST_STATE_RINGING: 00616 return "Ringing"; 00617 case AST_STATE_UP: 00618 return "Up"; 00619 case AST_STATE_BUSY: 00620 return "Busy"; 00621 case AST_STATE_DIALING_OFFHOOK: 00622 return "Dialing Offhook"; 00623 case AST_STATE_PRERING: 00624 return "Pre-ring"; 00625 default: 00626 if (!(buf = ast_threadstorage_get(&state2str_threadbuf, STATE2STR_BUFSIZE))) 00627 return "Unknown"; 00628 snprintf(buf, STATE2STR_BUFSIZE, "Unknown (%d)", state); 00629 return buf; 00630 } 00631 }
int ast_str2cause | ( | const char * | name | ) |
Convert a symbolic hangup cause to number.
name | string form of the cause Returns the cause code |
Definition at line 588 of file channel.c.
References causes.
Referenced by pbx_builtin_hangup().
00589 { 00590 int x; 00591 00592 for (x = 0; x < sizeof(causes) / sizeof(causes[0]); x++) 00593 if (strncasecmp(causes[x].name, name, strlen(causes[x].name)) == 0) 00594 return causes[x].cause; 00595 00596 return -1; 00597 }
int ast_tonepair | ( | struct ast_channel * | chan, | |
int | freq1, | |||
int | freq2, | |||
int | duration, | |||
int | vol | |||
) |
Play a tone pair for a given amount of time
Definition at line 4496 of file channel.c.
References ast_frfree, ast_read(), ast_tonepair_start(), ast_waitfor(), f, and ast_channel::generatordata.
Referenced by zapateller_exec().
04497 { 04498 int res; 04499 04500 if ((res = ast_tonepair_start(chan, freq1, freq2, duration, vol))) 04501 return res; 04502 04503 /* Give us some wiggle room */ 04504 while (chan->generatordata && ast_waitfor(chan, 100) >= 0) { 04505 struct ast_frame *f = ast_read(chan); 04506 if (f) 04507 ast_frfree(f); 04508 else 04509 return -1; 04510 } 04511 return 0; 04512 }
int ast_tonepair_start | ( | struct ast_channel * | chan, | |
int | freq1, | |||
int | freq2, | |||
int | duration, | |||
int | vol | |||
) |
Start a tone going
Definition at line 4478 of file channel.c.
References ast_activate_generator(), tonepair_def::duration, tonepair_def::freq1, tonepair_def::freq2, tonepair, and tonepair_def::vol.
Referenced by ast_tonepair(), play_dialtone(), play_tone_pair(), rpt_tele_thread(), and sendnoise().
04479 { 04480 struct tonepair_def d = { 0, }; 04481 04482 d.freq1 = freq1; 04483 d.freq2 = freq2; 04484 d.duration = duration; 04485 d.vol = (vol < 1) ? 8192 : vol; /* force invalid to 8192 */ 04486 if (ast_activate_generator(chan, &tonepair, &d)) 04487 return -1; 04488 return 0; 04489 }
void ast_tonepair_stop | ( | struct ast_channel * | chan | ) |
Stop a tone from playing
Definition at line 4491 of file channel.c.
References ast_deactivate_generator().
Referenced by sendnoise().
04492 { 04493 ast_deactivate_generator(chan); 04494 }
int ast_transfer | ( | struct ast_channel * | chan, | |
char * | dest | |||
) |
Transfer a channel (if supported). Returns -1 on error, 0 if not supported and 1 if supported and requested.
Called by:
Definition at line 3218 of file channel.c.
References ast_channel_lock, ast_channel_unlock, ast_check_hangup(), AST_FLAG_ZOMBIE, ast_test_flag, ast_channel::tech, and ast_channel_tech::transfer.
Referenced by transfer_exec().
03219 { 03220 int res = -1; 03221 03222 /* Stop if we're a zombie or need a soft hangup */ 03223 ast_channel_lock(chan); 03224 if (!ast_test_flag(chan, AST_FLAG_ZOMBIE) && !ast_check_hangup(chan)) { 03225 if (chan->tech->transfer) { 03226 res = chan->tech->transfer(chan, dest); 03227 if (!res) 03228 res = 1; 03229 } else 03230 res = 0; 03231 } 03232 ast_channel_unlock(chan); 03233 return res; 03234 }
char* ast_transfercapability2str | ( | int | transfercapability | ) | const |
Gives the string form of a given transfer capability.
transfercapability | transfercapabilty to get the name of Give a name to a transfercapbility See above Returns the text form of the binary transfer capbility |
Definition at line 634 of file channel.c.
References AST_TRANS_CAP_3_1K_AUDIO, AST_TRANS_CAP_DIGITAL, AST_TRANS_CAP_DIGITAL_W_TONES, AST_TRANS_CAP_RESTRICTED_DIGITAL, AST_TRANS_CAP_SPEECH, and AST_TRANS_CAP_VIDEO.
Referenced by cb_events(), dahdi_call(), dahdi_new(), misdn_call(), and oh323_call().
00635 { 00636 switch(transfercapability) { 00637 case AST_TRANS_CAP_SPEECH: 00638 return "SPEECH"; 00639 case AST_TRANS_CAP_DIGITAL: 00640 return "DIGITAL"; 00641 case AST_TRANS_CAP_RESTRICTED_DIGITAL: 00642 return "RESTRICTED_DIGITAL"; 00643 case AST_TRANS_CAP_3_1K_AUDIO: 00644 return "3K1AUDIO"; 00645 case AST_TRANS_CAP_DIGITAL_W_TONES: 00646 return "DIGITAL_W_TONES"; 00647 case AST_TRANS_CAP_VIDEO: 00648 return "VIDEO"; 00649 default: 00650 return "UNKNOWN"; 00651 } 00652 }
void ast_uninstall_music_functions | ( | void | ) |
Definition at line 4559 of file channel.c.
References ast_moh_cleanup_ptr, ast_moh_start_ptr, and ast_moh_stop_ptr.
Referenced by unload_module().
04560 { 04561 ast_moh_start_ptr = NULL; 04562 ast_moh_stop_ptr = NULL; 04563 ast_moh_cleanup_ptr = NULL; 04564 }
int ast_waitfor | ( | struct ast_channel * | chan, | |
int | ms | |||
) |
Wait for input on a channel.
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). |
Definition at line 1821 of file channel.c.
References ast_waitfor_nandfds().
Referenced by __adsi_transmit_messages(), __ast_play_and_record(), __ast_request_and_dial(), adsi_careful_send(), agent_ack_sleep(), ast_dtmf_stream(), ast_recvtext(), ast_safe_sleep_conditional(), ast_tonepair(), async_wait(), background_detect_exec(), channel_spy(), conf_exec(), conf_flush(), dictate_exec(), disa_exec(), do_idle_thread(), do_waiting(), echo_exec(), handle_recordfile(), ices_exec(), isAnsweringMachine(), measurenoise(), mp3_exec(), NBScat_exec(), receive_dtmf_digits(), recordthread(), send_tone_burst(), send_waveform_to_channel(), sendurl_exec(), speech_background(), ss_thread(), wait_for_hangup(), waitforring_exec(), and waitstream_core().
01822 { 01823 int oldms = ms; /* -1 if no timeout */ 01824 01825 ast_waitfor_nandfds(&c, 1, NULL, 0, NULL, NULL, &ms); 01826 if ((ms < 0) && (oldms < 0)) 01827 ms = 0; 01828 return ms; 01829 }
struct ast_channel* ast_waitfor_n | ( | struct ast_channel ** | chan, | |
int | n, | |||
int * | ms | |||
) |
Waits for input on a group of channels Wait for input on an array of channels for a given # of milliseconds.
chan | an array of pointers to channels | |
n | number of channels that are to be waited upon | |
ms | time "ms" is modified in-place, if applicable |
Definition at line 1816 of file channel.c.
References ast_waitfor_nandfds().
Referenced by ast_feature_request_and_dial(), ast_udptl_bridge(), autoservice_run(), bridge_native_loop(), dahdi_bridge(), misdn_bridge(), monitor_dial(), rpt(), wait_for_answer(), and wait_for_winner().
01817 { 01818 return ast_waitfor_nandfds(c, n, NULL, 0, NULL, NULL, ms); 01819 }
int ast_waitfor_n_fd | ( | int * | fds, | |
int | n, | |||
int * | ms, | |||
int * | exception | |||
) |
Waits for input on an fd This version works on fd's only. Be careful with it.
Definition at line 1660 of file channel.c.
References ast_waitfor_nandfds().
Referenced by dundi_lookup_internal(), and dundi_precache_internal().
01661 { 01662 int winner = -1; 01663 ast_waitfor_nandfds(NULL, 0, fds, n, exception, &winner, ms); 01664 return winner; 01665 }
struct ast_channel* ast_waitfor_nandfds | ( | struct ast_channel ** | chan, | |
int | n, | |||
int * | fds, | |||
int | nfds, | |||
int * | exception, | |||
int * | outfd, | |||
int * | ms | |||
) |
Waits for activity on a group of channels.
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. |
Definition at line 1668 of file channel.c.
References ast_channel::_softhangup, ast_add_fd(), ast_channel_lock, ast_channel_unlock, ast_clear_flag, ast_do_masquerade(), AST_FLAG_BLOCKING, AST_FLAG_EXCEPTION, ast_log(), AST_MAX_FDS, ast_set_flag, AST_SOFTHANGUP_TIMEOUT, ast_tvdiff_ms(), ast_tvnow(), CHECK_BLOCKING, errno, pollfd::fd, poll(), POLLPRI, and ast_channel::whentohangup.
Referenced by app_exec(), ast_waitfor(), ast_waitfor_n(), ast_waitfor_n_fd(), ast_waitfordigit_full(), conf_run(), find_cache(), run_agi(), and waitstream_core().
01670 { 01671 struct timeval start = { 0 , 0 }; 01672 struct pollfd *pfds = NULL; 01673 int res; 01674 long rms; 01675 int x, y, max; 01676 int sz; 01677 time_t now = 0; 01678 long whentohangup = 0, diff; 01679 struct ast_channel *winner = NULL; 01680 struct fdmap { 01681 int chan; 01682 int fdno; 01683 } *fdmap = NULL; 01684 01685 if ((sz = n * AST_MAX_FDS + nfds)) { 01686 pfds = alloca(sizeof(*pfds) * sz); 01687 fdmap = alloca(sizeof(*fdmap) * sz); 01688 } 01689 01690 if (outfd) 01691 *outfd = -99999; 01692 if (exception) 01693 *exception = 0; 01694 01695 /* Perform any pending masquerades */ 01696 for (x=0; x < n; x++) { 01697 ast_channel_lock(c[x]); 01698 if (c[x]->masq) { 01699 if (ast_do_masquerade(c[x])) { 01700 ast_log(LOG_WARNING, "Masquerade failed\n"); 01701 *ms = -1; 01702 ast_channel_unlock(c[x]); 01703 return NULL; 01704 } 01705 } 01706 if (c[x]->whentohangup) { 01707 if (!whentohangup) 01708 time(&now); 01709 diff = c[x]->whentohangup - now; 01710 if (diff < 1) { 01711 /* Should already be hungup */ 01712 c[x]->_softhangup |= AST_SOFTHANGUP_TIMEOUT; 01713 ast_channel_unlock(c[x]); 01714 return c[x]; 01715 } 01716 if (!whentohangup || (diff < whentohangup)) 01717 whentohangup = diff; 01718 } 01719 ast_channel_unlock(c[x]); 01720 } 01721 /* Wait full interval */ 01722 rms = *ms; 01723 if (whentohangup) { 01724 rms = whentohangup * 1000; /* timeout in milliseconds */ 01725 if (*ms >= 0 && *ms < rms) /* original *ms still smaller */ 01726 rms = *ms; 01727 } 01728 /* 01729 * Build the pollfd array, putting the channels' fds first, 01730 * followed by individual fds. Order is important because 01731 * individual fd's must have priority over channel fds. 01732 */ 01733 max = 0; 01734 for (x=0; x<n; x++) { 01735 for (y=0; y<AST_MAX_FDS; y++) { 01736 fdmap[max].fdno = y; /* fd y is linked to this pfds */ 01737 fdmap[max].chan = x; /* channel x is linked to this pfds */ 01738 max += ast_add_fd(&pfds[max], c[x]->fds[y]); 01739 } 01740 CHECK_BLOCKING(c[x]); 01741 } 01742 /* Add the individual fds */ 01743 for (x=0; x<nfds; x++) { 01744 fdmap[max].chan = -1; 01745 max += ast_add_fd(&pfds[max], fds[x]); 01746 } 01747 01748 if (*ms > 0) 01749 start = ast_tvnow(); 01750 01751 if (sizeof(int) == 4) { /* XXX fix timeout > 600000 on linux x86-32 */ 01752 do { 01753 int kbrms = rms; 01754 if (kbrms > 600000) 01755 kbrms = 600000; 01756 res = poll(pfds, max, kbrms); 01757 if (!res) 01758 rms -= kbrms; 01759 } while (!res && (rms > 0)); 01760 } else { 01761 res = poll(pfds, max, rms); 01762 } 01763 for (x=0; x<n; x++) 01764 ast_clear_flag(c[x], AST_FLAG_BLOCKING); 01765 if (res < 0) { /* Simulate a timeout if we were interrupted */ 01766 if (errno != EINTR) 01767 *ms = -1; 01768 return NULL; 01769 } 01770 if (whentohangup) { /* if we have a timeout, check who expired */ 01771 time(&now); 01772 for (x=0; x<n; x++) { 01773 if (c[x]->whentohangup && now >= c[x]->whentohangup) { 01774 c[x]->_softhangup |= AST_SOFTHANGUP_TIMEOUT; 01775 if (winner == NULL) 01776 winner = c[x]; 01777 } 01778 } 01779 } 01780 if (res == 0) { /* no fd ready, reset timeout and done */ 01781 *ms = 0; /* XXX use 0 since we may not have an exact timeout. */ 01782 return winner; 01783 } 01784 /* 01785 * Then check if any channel or fd has a pending event. 01786 * Remember to check channels first and fds last, as they 01787 * must have priority on setting 'winner' 01788 */ 01789 for (x = 0; x < max; x++) { 01790 res = pfds[x].revents; 01791 if (res == 0) 01792 continue; 01793 if (fdmap[x].chan >= 0) { /* this is a channel */ 01794 winner = c[fdmap[x].chan]; /* override previous winners */ 01795 if (res & POLLPRI) 01796 ast_set_flag(winner, AST_FLAG_EXCEPTION); 01797 else 01798 ast_clear_flag(winner, AST_FLAG_EXCEPTION); 01799 winner->fdno = fdmap[x].fdno; 01800 } else { /* this is an fd */ 01801 if (outfd) 01802 *outfd = pfds[x].fd; 01803 if (exception) 01804 *exception = (res & POLLPRI) ? -1 : 0; 01805 winner = NULL; 01806 } 01807 } 01808 if (*ms > 0) { 01809 *ms -= ast_tvdiff_ms(ast_tvnow(), start); 01810 if (*ms < 0) 01811 *ms = 0; 01812 } 01813 return winner; 01814 }
int ast_waitfordigit | ( | struct ast_channel * | c, | |
int | ms | |||
) |
Waits for a digit.
!
c | channel to wait for a digit on | |
ms | how many milliseconds to wait |
Definition at line 1832 of file channel.c.
References ast_waitfordigit_full().
Referenced by _while_exec(), advanced_options(), ast_adsi_get_cpeid(), ast_adsi_get_cpeinfo(), ast_adsi_print(), ast_adsi_read_encoded_dtmf(), ast_adsi_transmit_message_full(), ast_app_dtget(), ast_control_streamfile(), ast_record_review(), collect_digits(), common_exec(), cpeid_exec(), dialout(), directory_exec(), do_atxfer(), forward_message(), get_folder(), ivr_dispatch(), mgcp_ss(), my_getsigstr(), pbx_builtin_waitexten(), play_mailbox_owner(), play_record_review(), read_exec(), read_newoption(), retrydial_exec(), sendnoise(), ss_thread(), testclient_exec(), testserver_exec(), vm_execmain(), vm_forwardoptions(), vm_instructions(), vm_options(), vm_tempgreeting(), wait_a_bit(), and wait_our_turn().
01833 { 01834 return ast_waitfordigit_full(c, ms, -1, -1); 01835 }
int ast_waitfordigit_full | ( | struct ast_channel * | c, | |
int | ms, | |||
int | audiofd, | |||
int | ctrlfd | |||
) |
Wait for a digit Same as ast_waitfordigit() with audio fd for outputting read audio and ctrlfd to monitor for reading.
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 |
Definition at line 1858 of file channel.c.
References ast_check_hangup(), ast_clear_flag, AST_CONTROL_ANSWER, AST_CONTROL_HANGUP, AST_CONTROL_RINGING, AST_CONTROL_SRCUPDATE, AST_FLAG_END_DTMF_ONLY, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, AST_FRAME_VOICE, ast_frfree, ast_log(), ast_read(), ast_set_flag, ast_test_flag, ast_waitfor_nandfds(), errno, and f.
Referenced by ast_readstring_full(), ast_waitfordigit(), handle_getoption(), and handle_waitfordigit().
01859 { 01860 /* Stop if we're a zombie or need a soft hangup */ 01861 if (ast_test_flag(c, AST_FLAG_ZOMBIE) || ast_check_hangup(c)) 01862 return -1; 01863 01864 /* Only look for the end of DTMF, don't bother with the beginning and don't emulate things */ 01865 ast_set_flag(c, AST_FLAG_END_DTMF_ONLY); 01866 01867 /* Wait for a digit, no more than ms milliseconds total. */ 01868 while (ms) { 01869 struct ast_channel *rchan; 01870 int outfd; 01871 01872 errno = 0; 01873 rchan = ast_waitfor_nandfds(&c, 1, &cmdfd, (cmdfd > -1) ? 1 : 0, NULL, &outfd, &ms); 01874 if (!rchan && outfd < 0 && ms) { 01875 if (errno == 0 || errno == EINTR) 01876 continue; 01877 ast_log(LOG_WARNING, "Wait failed (%s)\n", strerror(errno)); 01878 ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY); 01879 return -1; 01880 } else if (outfd > -1) { 01881 /* The FD we were watching has something waiting */ 01882 ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY); 01883 return 1; 01884 } else if (rchan) { 01885 int res; 01886 struct ast_frame *f = ast_read(c); 01887 if (!f) 01888 return -1; 01889 01890 switch(f->frametype) { 01891 case AST_FRAME_DTMF_BEGIN: 01892 break; 01893 case AST_FRAME_DTMF_END: 01894 res = f->subclass; 01895 ast_frfree(f); 01896 ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY); 01897 return res; 01898 case AST_FRAME_CONTROL: 01899 switch(f->subclass) { 01900 case AST_CONTROL_HANGUP: 01901 ast_frfree(f); 01902 ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY); 01903 return -1; 01904 case AST_CONTROL_RINGING: 01905 case AST_CONTROL_ANSWER: 01906 case AST_CONTROL_SRCUPDATE: 01907 /* Unimportant */ 01908 break; 01909 default: 01910 ast_log(LOG_WARNING, "Unexpected control subclass '%d'\n", f->subclass); 01911 break; 01912 } 01913 break; 01914 case AST_FRAME_VOICE: 01915 /* Write audio if appropriate */ 01916 if (audiofd > -1) { 01917 if (write(audiofd, f->data, f->datalen) < 0) { 01918 ast_log(LOG_WARNING, "write() failed: %s\n", strerror(errno)); 01919 } 01920 } 01921 default: 01922 /* Ignore */ 01923 break; 01924 } 01925 ast_frfree(f); 01926 } 01927 } 01928 01929 ast_clear_flag(c, AST_FLAG_END_DTMF_ONLY); 01930 01931 return 0; /* Time is up */ 01932 }
struct ast_channel* ast_walk_channel_by_exten_locked | ( | const struct ast_channel * | chan, | |
const char * | exten, | |||
const char * | context | |||
) |
Get next channel by exten (and optionally context) and lock it.
Definition at line 1166 of file channel.c.
References channel_find_locked().
Referenced by next_channel().
01168 { 01169 return channel_find_locked(chan, NULL, 0, context, exten); 01170 }
struct ast_channel* ast_walk_channel_by_name_prefix_locked | ( | const struct ast_channel * | chan, | |
const char * | name, | |||
const int | namelen | |||
) |
Get channel by name prefix (locks channel).
Definition at line 1153 of file channel.c.
References channel_find_locked().
Referenced by next_channel().
01155 { 01156 return channel_find_locked(chan, name, namelen, NULL, NULL); 01157 }
int ast_write | ( | struct ast_channel * | chan, | |
struct ast_frame * | frame | |||
) |
Write a frame to a channel This function writes the given frame to the indicated channel.
chan | destination channel of the frame | |
frame | frame that will be written |
Definition at line 2740 of file channel.c.
References ast_channel::_softhangup, AST_AUDIOHOOK_DIRECTION_WRITE, ast_audiohook_write_list(), ast_channel_lock, ast_channel_trylock, ast_channel_unlock, ast_check_hangup(), ast_clear_flag, AST_CONTROL_UNHOLD, ast_deactivate_generator(), ast_do_masquerade(), AST_FLAG_BLOCKING, AST_FLAG_WRITE_INT, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, ast_frame_dump(), AST_FRAME_HTML, AST_FRAME_IAX, AST_FRAME_MODEM, AST_FRAME_NULL, AST_FRAME_TEXT, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_frfree, ast_log(), AST_MONITOR_RUNNING, ast_seekstream(), ast_senddigit_begin(), ast_senddigit_end(), AST_SOFTHANGUP_DEV, ast_test_flag, ast_translate(), ast_writestream(), ast_channel::audiohooks, CHECK_BLOCKING, ast_frame::data, ast_frame::datalen, DEBUGCHAN_FLAG, f, ast_channel::fout, FRAMECOUNT_INC, ast_frame::frametype, ast_channel::generatordata, ast_channel_tech::indicate, ast_channel::insmpl, ast_frame::len, LOG_DEBUG, ast_channel::masq, ast_channel::masqr, ast_channel::monitor, MONITOR_DELAY, ast_channel::name, option_debug, ast_channel::outsmpl, ast_channel::rawwriteformat, SEEK_FORCECUR, ast_channel_tech::send_html, ast_channel_tech::send_text, ast_channel_monitor::state, ast_frame::subclass, ast_channel::tech, ast_channel_tech::write, ast_channel_monitor::write_stream, ast_channel_tech::write_video, and ast_channel::writetrans.
Referenced by adsi_careful_send(), agent_write(), ast_prod(), ast_readaudio_callback(), ast_readvideo_callback(), ast_udptl_bridge(), ast_write_video(), bridge_native_loop(), conf_queue_dtmf(), conf_run(), dahdi_bridge(), dictate_exec(), echo_exec(), features_write(), function_ilink(), gen_generate(), handle_link_data(), jb_get_and_deliver(), linear_generator(), milliwatt_generate(), misdn_bridge(), moh_files_generator(), moh_generate(), mp3_exec(), NBScat_exec(), rpt(), send_link_dtmf(), send_tone_burst(), send_waveform_to_channel(), silence_generator_generate(), spy_generate(), and wait_for_answer().
02741 { 02742 int res = -1; 02743 int count = 0; 02744 struct ast_frame *f = NULL, *f2 = NULL; 02745 02746 /*Deadlock avoidance*/ 02747 while(ast_channel_trylock(chan)) { 02748 /*cannot goto done since the channel is not locked*/ 02749 if(count++ > 10) { 02750 if(option_debug) 02751 ast_log(LOG_DEBUG, "Deadlock avoided for write to channel '%s'\n", chan->name); 02752 return 0; 02753 } 02754 usleep(1); 02755 } 02756 /* Stop if we're a zombie or need a soft hangup */ 02757 if (ast_test_flag(chan, AST_FLAG_ZOMBIE) || ast_check_hangup(chan)) 02758 goto done; 02759 02760 /* Handle any pending masquerades */ 02761 if (chan->masq && ast_do_masquerade(chan)) { 02762 ast_log(LOG_WARNING, "Failed to perform masquerade\n"); 02763 goto done; 02764 } 02765 if (chan->masqr) { 02766 res = 0; /* XXX explain, why 0 ? */ 02767 goto done; 02768 } 02769 if (chan->generatordata) { 02770 if (ast_test_flag(chan, AST_FLAG_WRITE_INT)) 02771 ast_deactivate_generator(chan); 02772 else { 02773 if (fr->frametype == AST_FRAME_DTMF_END) { 02774 /* There is a generator running while we're in the middle of a digit. 02775 * It's probably inband DTMF, so go ahead and pass it so it can 02776 * stop the generator */ 02777 ast_clear_flag(chan, AST_FLAG_BLOCKING); 02778 ast_channel_unlock(chan); 02779 res = ast_senddigit_end(chan, fr->subclass, fr->len); 02780 ast_channel_lock(chan); 02781 CHECK_BLOCKING(chan); 02782 } else if (fr->frametype == AST_FRAME_CONTROL && fr->subclass == AST_CONTROL_UNHOLD) { 02783 /* This is a side case where Echo is basically being called and the person put themselves on hold and took themselves off hold */ 02784 res = (chan->tech->indicate == NULL) ? 0 : 02785 chan->tech->indicate(chan, fr->subclass, fr->data, fr->datalen); 02786 } 02787 res = 0; /* XXX explain, why 0 ? */ 02788 goto done; 02789 } 02790 } 02791 /* High bit prints debugging */ 02792 if (chan->fout & DEBUGCHAN_FLAG) 02793 ast_frame_dump(chan->name, fr, ">>"); 02794 CHECK_BLOCKING(chan); 02795 switch(fr->frametype) { 02796 case AST_FRAME_CONTROL: 02797 res = (chan->tech->indicate == NULL) ? 0 : 02798 chan->tech->indicate(chan, fr->subclass, fr->data, fr->datalen); 02799 break; 02800 case AST_FRAME_DTMF_BEGIN: 02801 if (chan->audiohooks) { 02802 struct ast_frame *old_frame = fr; 02803 fr = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_WRITE, fr); 02804 if (old_frame != fr) 02805 f = fr; 02806 } 02807 ast_clear_flag(chan, AST_FLAG_BLOCKING); 02808 ast_channel_unlock(chan); 02809 res = ast_senddigit_begin(chan, fr->subclass); 02810 ast_channel_lock(chan); 02811 CHECK_BLOCKING(chan); 02812 break; 02813 case AST_FRAME_DTMF_END: 02814 if (chan->audiohooks) { 02815 struct ast_frame *old_frame = fr; 02816 fr = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_WRITE, fr); 02817 if (old_frame != fr) 02818 f = fr; 02819 } 02820 ast_clear_flag(chan, AST_FLAG_BLOCKING); 02821 ast_channel_unlock(chan); 02822 res = ast_senddigit_end(chan, fr->subclass, fr->len); 02823 ast_channel_lock(chan); 02824 CHECK_BLOCKING(chan); 02825 break; 02826 case AST_FRAME_TEXT: 02827 res = (chan->tech->send_text == NULL) ? 0 : 02828 chan->tech->send_text(chan, (char *) fr->data); 02829 break; 02830 case AST_FRAME_HTML: 02831 res = (chan->tech->send_html == NULL) ? 0 : 02832 chan->tech->send_html(chan, fr->subclass, (char *) fr->data, fr->datalen); 02833 break; 02834 case AST_FRAME_VIDEO: 02835 /* XXX Handle translation of video codecs one day XXX */ 02836 res = (chan->tech->write_video == NULL) ? 0 : 02837 chan->tech->write_video(chan, fr); 02838 break; 02839 case AST_FRAME_MODEM: 02840 res = (chan->tech->write == NULL) ? 0 : 02841 chan->tech->write(chan, fr); 02842 break; 02843 case AST_FRAME_VOICE: 02844 if (chan->tech->write == NULL) 02845 break; /*! \todo XXX should return 0 maybe ? */ 02846 02847 if (chan->audiohooks) { 02848 struct ast_frame *old_frame = fr; 02849 fr = ast_audiohook_write_list(chan, chan->audiohooks, AST_AUDIOHOOK_DIRECTION_WRITE, fr); 02850 if (old_frame != fr) 02851 f2 = fr; 02852 } 02853 02854 /* If the frame is in the raw write format, then it's easy... just use the frame - otherwise we will have to translate */ 02855 if (fr->subclass == chan->rawwriteformat) 02856 f = fr; 02857 else 02858 f = (chan->writetrans) ? ast_translate(chan->writetrans, fr, 0) : fr; 02859 02860 /* If we have no frame of audio, then we have to bail out */ 02861 if (!f) { 02862 res = 0; 02863 break; 02864 } 02865 02866 /* If Monitor is running on this channel, then we have to write frames out there too */ 02867 if (chan->monitor && chan->monitor->write_stream) { 02868 /* XXX must explain this code */ 02869 #ifndef MONITOR_CONSTANT_DELAY 02870 int jump = chan->insmpl - chan->outsmpl - 4 * f->samples; 02871 if (jump >= 0) { 02872 jump = chan->insmpl - chan->outsmpl; 02873 if (ast_seekstream(chan->monitor->write_stream, jump, SEEK_FORCECUR) == -1) 02874 ast_log(LOG_WARNING, "Failed to perform seek in monitoring write stream, synchronization between the files may be broken\n"); 02875 chan->outsmpl += jump + f->samples; 02876 } else 02877 chan->outsmpl += f->samples; 02878 #else 02879 int jump = chan->insmpl - chan->outsmpl; 02880 if (jump - MONITOR_DELAY >= 0) { 02881 if (ast_seekstream(chan->monitor->write_stream, jump - f->samples, SEEK_FORCECUR) == -1) 02882 ast_log(LOG_WARNING, "Failed to perform seek in monitoring write stream, synchronization between the files may be broken\n"); 02883 chan->outsmpl += jump; 02884 } else 02885 chan->outsmpl += f->samples; 02886 #endif 02887 if (chan->monitor->state == AST_MONITOR_RUNNING) { 02888 if (ast_writestream(chan->monitor->write_stream, f) < 0) 02889 ast_log(LOG_WARNING, "Failed to write data to channel monitor write stream\n"); 02890 } 02891 } 02892 02893 if (f) 02894 res = chan->tech->write(chan,f); 02895 else 02896 res = 0; 02897 break; 02898 case AST_FRAME_NULL: 02899 case AST_FRAME_IAX: 02900 /* Ignore these */ 02901 res = 0; 02902 break; 02903 default: 02904 /* At this point, fr is the incoming frame and f is NULL. Channels do 02905 * not expect to get NULL as a frame pointer and will segfault. Hence, 02906 * we output the original frame passed in. */ 02907 res = chan->tech->write(chan, fr); 02908 break; 02909 } 02910 02911 if (f && f != fr) 02912 ast_frfree(f); 02913 if (f2) 02914 ast_frfree(f2); 02915 ast_clear_flag(chan, AST_FLAG_BLOCKING); 02916 /* Consider a write failure to force a soft hangup */ 02917 if (res < 0) 02918 chan->_softhangup |= AST_SOFTHANGUP_DEV; 02919 else { 02920 chan->fout = FRAMECOUNT_INC(chan->fout); 02921 } 02922 done: 02923 ast_channel_unlock(chan); 02924 return res; 02925 }
int ast_write_video | ( | struct ast_channel * | chan, | |
struct ast_frame * | frame | |||
) |
Write video frame to a channel This function writes the given frame to the indicated channel.
chan | destination channel of the frame | |
frame | frame that will be written |
Definition at line 2729 of file channel.c.
References ast_write(), ast_channel::tech, and ast_channel_tech::write_video.
02730 { 02731 int res; 02732 if (!chan->tech->write_video) 02733 return 0; 02734 res = ast_write(chan, fr); 02735 if (!res) 02736 res = 1; 02737 return res; 02738 }
static void bridge_playfile | ( | struct ast_channel * | chan, | |
struct ast_channel * | peer, | |||
const char * | sound, | |||
int | remain | |||
) | [static] |
Definition at line 3873 of file channel.c.
References ast_autoservice_start(), ast_autoservice_stop(), AST_DIGIT_ANY, ast_say_number(), ast_stream_and_wait(), and ast_channel::language.
Referenced by ast_channel_bridge().
03874 { 03875 int min = 0, sec = 0, check; 03876 03877 check = ast_autoservice_start(peer); 03878 if (check) 03879 return; 03880 03881 if (remain > 0) { 03882 if (remain / 60 > 1) { 03883 min = remain / 60; 03884 sec = remain % 60; 03885 } else { 03886 sec = remain; 03887 } 03888 } 03889 03890 if (!strcmp(sound,"timeleft")) { /* Queue support */ 03891 ast_stream_and_wait(chan, "vm-youhave", chan->language, ""); 03892 if (min) { 03893 ast_say_number(chan, min, AST_DIGIT_ANY, chan->language, NULL); 03894 ast_stream_and_wait(chan, "queue-minutes", chan->language, ""); 03895 } 03896 if (sec) { 03897 ast_say_number(chan, sec, AST_DIGIT_ANY, chan->language, NULL); 03898 ast_stream_and_wait(chan, "queue-seconds", chan->language, ""); 03899 } 03900 } else { 03901 ast_stream_and_wait(chan, sound, chan->language, ""); 03902 } 03903 03904 ast_autoservice_stop(peer); 03905 }
static struct ast_channel* channel_find_locked | ( | const struct ast_channel * | prev, | |
const char * | name, | |||
const int | namelen, | |||
const char * | context, | |||
const char * | exten | |||
) | [static] |
Helper function to find channels.
It supports these modes:
prev != NULL : get channel next in list after prev name != NULL : get channel with matching name name != NULL && namelen != 0 : get channel whose name starts with prefix exten != NULL : get channel whose exten or macroexten matches context != NULL && exten != NULL : get channel whose context or macrocontext
It returns with the channel's lock held. If getting the individual lock fails, unlock and retry quickly up to 10 times, then give up.
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.
Definition at line 1049 of file channel.c.
References ast_channel_trylock, AST_LIST_LOCK, AST_LIST_NEXT, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_channel::context, ast_channel::exten, LOG_DEBUG, ast_channel::macrocontext, ast_channel::macroexten, ast_channel::name, and option_debug.
Referenced by ast_channel_walk_locked(), ast_get_channel_by_exten_locked(), ast_get_channel_by_name_locked(), ast_get_channel_by_name_prefix_locked(), ast_walk_channel_by_exten_locked(), and ast_walk_channel_by_name_prefix_locked().
01052 { 01053 const char *msg = prev ? "deadlock" : "initial deadlock"; 01054 int retries; 01055 struct ast_channel *c; 01056 const struct ast_channel *_prev = prev; 01057 01058 for (retries = 0; retries < 200; retries++) { 01059 int done; 01060 /* Reset prev on each retry. See note below for the reason. */ 01061 prev = _prev; 01062 AST_LIST_LOCK(&channels); 01063 AST_LIST_TRAVERSE(&channels, c, chan_list) { 01064 if (prev) { /* look for last item, first, before any evaluation */ 01065 if (c != prev) /* not this one */ 01066 continue; 01067 /* found, prepare to return c->next */ 01068 if ((c = AST_LIST_NEXT(c, chan_list)) == NULL) break; 01069 /*!\note 01070 * We're done searching through the list for the previous item. 01071 * Any item after this point, we want to evaluate for a match. 01072 * If we didn't set prev to NULL here, then we would only 01073 * return matches for the first matching item (since the above 01074 * "if (c != prev)" would not permit any other potential 01075 * matches to reach the additional matching logic, below). 01076 * Instead, it would just iterate until it once again found the 01077 * original match, then iterate down to the end of the list and 01078 * quit. 01079 */ 01080 prev = NULL; 01081 } 01082 if (name) { /* want match by name */ 01083 if ((!namelen && strcasecmp(c->name, name)) || 01084 (namelen && strncasecmp(c->name, name, namelen))) 01085 continue; /* name match failed */ 01086 } else if (exten) { 01087 if (context && strcasecmp(c->context, context) && 01088 strcasecmp(c->macrocontext, context)) 01089 continue; /* context match failed */ 01090 if (strcasecmp(c->exten, exten) && 01091 strcasecmp(c->macroexten, exten)) 01092 continue; /* exten match failed */ 01093 } 01094 /* if we get here, c points to the desired record */ 01095 break; 01096 } 01097 /* exit if chan not found or mutex acquired successfully */ 01098 /* this is slightly unsafe, as we _should_ hold the lock to access c->name */ 01099 done = c == NULL || ast_channel_trylock(c) == 0; 01100 if (!done) { 01101 if (option_debug) 01102 ast_log(LOG_DEBUG, "Avoiding %s for channel '%p'\n", msg, c); 01103 if (retries == 199) { 01104 /* We are about to fail due to a deadlock, so report this 01105 * while we still have the list lock. 01106 */ 01107 if (option_debug) 01108 ast_log(LOG_DEBUG, "Failure, could not lock '%p' after %d retries!\n", c, retries); 01109 /* As we have deadlocked, we will skip this channel and 01110 * see if there is another match. 01111 * NOTE: No point doing this for a full-name match, 01112 * as there can be no more matches. 01113 */ 01114 if (!(name && !namelen)) { 01115 prev = c; 01116 retries = -1; 01117 } 01118 } 01119 } 01120 AST_LIST_UNLOCK(&channels); 01121 if (done) 01122 return c; 01123 /* If we reach this point we basically tried to lock a channel and failed. Instead of 01124 * starting from the beginning of the list we can restore our saved pointer to the previous 01125 * channel and start from there. 01126 */ 01127 prev = _prev; 01128 usleep(1); /* give other threads a chance before retrying */ 01129 } 01130 01131 return NULL; 01132 }
const char* channelreloadreason2txt | ( | enum channelreloadreason | reason | ) |
Convert enum channelreloadreason to text string for manager event.
\ brief Convert channel reloadreason (ENUM) to text string for manager event
Definition at line 4711 of file channel.c.
References CHANNEL_CLI_RELOAD, CHANNEL_MODULE_LOAD, and CHANNEL_MODULE_RELOAD.
04712 { 04713 switch (reason) { 04714 case CHANNEL_MODULE_LOAD: 04715 return "LOAD (Channel module load)"; 04716 04717 case CHANNEL_MODULE_RELOAD: 04718 return "RELOAD (Channel module reload)"; 04719 04720 case CHANNEL_CLI_RELOAD: 04721 return "CLIRELOAD (Channel module reload by CLI command)"; 04722 04723 default: 04724 return "MANAGERRELOAD (Channel module reload by manager)"; 04725 } 04726 };
static void clone_variables | ( | struct ast_channel * | original, | |
struct ast_channel * | clone | |||
) | [static] |
Clone channel variables from 'clone' channel into 'original' channel.
All variables except those related to app_groupcount are cloned. Variables are actually _removed_ from 'clone' channel, presumably because it will subsequently be destroyed.
Definition at line 3500 of file channel.c.
References AST_LIST_APPEND_LIST, AST_LIST_FIRST, AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_var_assign(), ast_var_t::entries, ast_var_t::name, ast_var_t::value, and ast_channel::varshead.
Referenced by ast_do_masquerade().
03501 { 03502 struct ast_var_t *current, *newvar; 03503 /* Append variables from clone channel into original channel */ 03504 /* XXX Is this always correct? We have to in order to keep MACROS working XXX */ 03505 if (AST_LIST_FIRST(&clone->varshead)) 03506 AST_LIST_APPEND_LIST(&original->varshead, &clone->varshead, entries); 03507 03508 /* then, dup the varshead list into the clone */ 03509 03510 AST_LIST_TRAVERSE(&original->varshead, current, entries) { 03511 newvar = ast_var_assign(current->name, current->value); 03512 if (newvar) 03513 AST_LIST_INSERT_TAIL(&clone->varshead, newvar, entries); 03514 } 03515 }
static char* complete_channeltypes | ( | const char * | line, | |
const char * | word, | |||
int | pos, | |||
int | state | |||
) | [static] |
Definition at line 334 of file channel.c.
References AST_LIST_TRAVERSE, chanlist::list, strdup, chanlist::tech, and ast_channel_tech::type.
00335 { 00336 struct chanlist *cl; 00337 int which = 0; 00338 int wordlen; 00339 char *ret = NULL; 00340 00341 if (pos != 3) 00342 return NULL; 00343 00344 wordlen = strlen(word); 00345 00346 AST_LIST_TRAVERSE(&backends, cl, list) { 00347 if (!strncasecmp(word, cl->tech->type, wordlen) && ++which > state) { 00348 ret = strdup(cl->tech->type); 00349 break; 00350 } 00351 } 00352 00353 return ret; 00354 }
static char* complete_channeltypes_deprecated | ( | const char * | line, | |
const char * | word, | |||
int | pos, | |||
int | state | |||
) | [static] |
Definition at line 312 of file channel.c.
References AST_LIST_TRAVERSE, chanlist::list, strdup, chanlist::tech, and ast_channel_tech::type.
00313 { 00314 struct chanlist *cl; 00315 int which = 0; 00316 int wordlen; 00317 char *ret = NULL; 00318 00319 if (pos != 2) 00320 return NULL; 00321 00322 wordlen = strlen(word); 00323 00324 AST_LIST_TRAVERSE(&backends, cl, list) { 00325 if (!strncasecmp(word, cl->tech->type, wordlen) && ++which > state) { 00326 ret = strdup(cl->tech->type); 00327 break; 00328 } 00329 } 00330 00331 return ret; 00332 }
static void free_cid | ( | struct ast_callerid * | cid | ) | [static] |
Definition at line 1199 of file channel.c.
References ast_callerid::cid_ani, ast_callerid::cid_dnid, ast_callerid::cid_name, ast_callerid::cid_num, ast_callerid::cid_rdnis, and free.
Referenced by ast_channel_free().
01200 { 01201 if (cid->cid_dnid) 01202 free(cid->cid_dnid); 01203 if (cid->cid_num) 01204 free(cid->cid_num); 01205 if (cid->cid_name) 01206 free(cid->cid_name); 01207 if (cid->cid_ani) 01208 free(cid->cid_ani); 01209 if (cid->cid_rdnis) 01210 free(cid->cid_rdnis); 01211 }
static void free_translation | ( | struct ast_channel * | clone | ) | [static] |
Definition at line 1446 of file channel.c.
References ast_translator_free_path(), ast_channel::nativeformats, ast_channel::rawreadformat, ast_channel::rawwriteformat, ast_channel::readtrans, and ast_channel::writetrans.
Referenced by ast_do_masquerade(), and ast_hangup().
01447 { 01448 if (clone->writetrans) 01449 ast_translator_free_path(clone->writetrans); 01450 if (clone->readtrans) 01451 ast_translator_free_path(clone->readtrans); 01452 clone->writetrans = NULL; 01453 clone->readtrans = NULL; 01454 clone->rawwriteformat = clone->nativeformats; 01455 clone->rawreadformat = clone->nativeformats; 01456 }
static int generator_force | ( | const void * | data | ) | [static] |
Definition at line 1601 of file channel.c.
References ast_channel_lock, ast_channel_unlock, ast_deactivate_generator(), AST_FORMAT_AUDIO_MASK, ast_format_rate(), ast_log(), LOG_DEBUG, and option_debug.
Referenced by ast_activate_generator(), and ast_read_generator_actions().
01602 { 01603 /* Called if generator doesn't have data */ 01604 void *tmp; 01605 int res; 01606 int (*generate)(struct ast_channel *chan, void *tmp, int datalen, int samples) = NULL; 01607 struct ast_channel *chan = (struct ast_channel *)data; 01608 01609 ast_channel_lock(chan); 01610 tmp = chan->generatordata; 01611 chan->generatordata = NULL; 01612 if (chan->generator) 01613 generate = chan->generator->generate; 01614 ast_channel_unlock(chan); 01615 01616 if (!tmp || !generate) 01617 return 0; 01618 01619 res = generate(chan, tmp, 0, ast_format_rate(chan->writeformat & AST_FORMAT_AUDIO_MASK) / 50); 01620 01621 chan->generatordata = tmp; 01622 01623 if (res) { 01624 if (option_debug) 01625 ast_log(LOG_DEBUG, "Auto-deactivating generator\n"); 01626 ast_deactivate_generator(chan); 01627 } 01628 01629 return 0; 01630 }
static int attribute_const is_visible_indication | ( | enum ast_control_frame_type | condition | ) | [static] |
Definition at line 2464 of file channel.c.
References AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_OFFHOOK, AST_CONTROL_OPTION, AST_CONTROL_PROCEEDING, AST_CONTROL_PROGRESS, AST_CONTROL_RADIO_KEY, AST_CONTROL_RADIO_UNKEY, AST_CONTROL_RING, AST_CONTROL_RINGING, AST_CONTROL_SRCUPDATE, AST_CONTROL_TAKEOFFHOOK, AST_CONTROL_UNHOLD, AST_CONTROL_VIDUPDATE, and AST_CONTROL_WINK.
Referenced by ast_indicate_data().
02465 { 02466 /* Don't include a default case here so that we get compiler warnings 02467 * when a new type is added. */ 02468 02469 switch (condition) { 02470 case AST_CONTROL_PROGRESS: 02471 case AST_CONTROL_PROCEEDING: 02472 case AST_CONTROL_VIDUPDATE: 02473 case AST_CONTROL_SRCUPDATE: 02474 case AST_CONTROL_RADIO_KEY: 02475 case AST_CONTROL_RADIO_UNKEY: 02476 case AST_CONTROL_OPTION: 02477 case AST_CONTROL_WINK: 02478 case AST_CONTROL_FLASH: 02479 case AST_CONTROL_OFFHOOK: 02480 case AST_CONTROL_TAKEOFFHOOK: 02481 case AST_CONTROL_ANSWER: 02482 case AST_CONTROL_HANGUP: 02483 return 0; 02484 02485 case AST_CONTROL_CONGESTION: 02486 case AST_CONTROL_BUSY: 02487 case AST_CONTROL_RINGING: 02488 case AST_CONTROL_RING: 02489 case AST_CONTROL_HOLD: 02490 case AST_CONTROL_UNHOLD: 02491 return 1; 02492 } 02493 02494 return 0; 02495 }
static void queue_dtmf_readq | ( | struct ast_channel * | chan, | |
struct ast_frame * | f | |||
) | [inline, static] |
Definition at line 1988 of file channel.c.
References AST_FRAME_DTMF_END, ast_queue_frame(), ast_channel::dtmff, f, ast_frame::frametype, ast_frame::len, and ast_frame::subclass.
Referenced by __ast_read().
01989 { 01990 struct ast_frame *fr = &chan->dtmff; 01991 01992 fr->frametype = AST_FRAME_DTMF_END; 01993 fr->subclass = f->subclass; 01994 fr->len = f->len; 01995 01996 /* The only time this function will be called is for a frame that just came 01997 * out of the channel driver. So, we want to stick it on the tail of the 01998 * readq. */ 01999 02000 ast_queue_frame(chan, fr); 02001 }
static int set_format | ( | struct ast_channel * | chan, | |
int | fmt, | |||
int * | rawformat, | |||
int * | format, | |||
struct ast_trans_pvt ** | trans, | |||
const int | direction | |||
) | [static] |
Definition at line 2927 of file channel.c.
References ast_channel_lock, ast_channel_unlock, AST_FORMAT_AUDIO_MASK, ast_getformatname(), ast_getformatname_multiple(), ast_log(), ast_translator_best_choice(), ast_translator_build_path(), ast_translator_free_path(), LOG_DEBUG, ast_channel::name, ast_channel::nativeformats, and option_debug.
Referenced by ast_set_read_format(), and ast_set_write_format().
02929 { 02930 int native; 02931 int res; 02932 char from[200], to[200]; 02933 02934 /* Make sure we only consider audio */ 02935 fmt &= AST_FORMAT_AUDIO_MASK; 02936 02937 native = chan->nativeformats; 02938 /* Find a translation path from the native format to one of the desired formats */ 02939 if (!direction) 02940 /* reading */ 02941 res = ast_translator_best_choice(&fmt, &native); 02942 else 02943 /* writing */ 02944 res = ast_translator_best_choice(&native, &fmt); 02945 02946 if (res < 0) { 02947 ast_log(LOG_WARNING, "Unable to find a codec translation path from %s to %s\n", 02948 ast_getformatname_multiple(from, sizeof(from), native), 02949 ast_getformatname_multiple(to, sizeof(to), fmt)); 02950 return -1; 02951 } 02952 02953 /* Now we have a good choice for both. */ 02954 ast_channel_lock(chan); 02955 02956 if ((*rawformat == native) && (*format == fmt) && ((*rawformat == *format) || (*trans))) { 02957 /* the channel is already in these formats, so nothing to do */ 02958 ast_channel_unlock(chan); 02959 return 0; 02960 } 02961 02962 *rawformat = native; 02963 /* User perspective is fmt */ 02964 *format = fmt; 02965 /* Free any read translation we have right now */ 02966 if (*trans) 02967 ast_translator_free_path(*trans); 02968 /* Build a translation path from the raw format to the desired format */ 02969 if (!direction) 02970 /* reading */ 02971 *trans = ast_translator_build_path(*format, *rawformat); 02972 else 02973 /* writing */ 02974 *trans = ast_translator_build_path(*rawformat, *format); 02975 ast_channel_unlock(chan); 02976 if (option_debug) 02977 ast_log(LOG_DEBUG, "Set channel %s to %s format %s\n", chan->name, 02978 direction ? "write" : "read", ast_getformatname(fmt)); 02979 return 0; 02980 }
static int should_skip_dtmf | ( | struct ast_channel * | chan | ) | [inline, static] |
Determine whether or not we should ignore DTMF in the readq.
Definition at line 2006 of file channel.c.
References AST_FLAG_DEFER_DTMF, AST_FLAG_EMULATE_DTMF, AST_MIN_DTMF_GAP, ast_test_flag, ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), and ast_channel::dtmf_tv.
Referenced by __ast_read().
02007 { 02008 if (ast_test_flag(chan, AST_FLAG_DEFER_DTMF | AST_FLAG_EMULATE_DTMF)) { 02009 /* We're in the middle of emulating a digit, or DTMF has been 02010 * explicitly deferred. Skip this digit, then. */ 02011 return 1; 02012 } 02013 02014 if (!ast_tvzero(chan->dtmf_tv) && 02015 ast_tvdiff_ms(ast_tvnow(), chan->dtmf_tv) < AST_MIN_DTMF_GAP) { 02016 /* We're not in the middle of a digit, but it hasn't been long enough 02017 * since the last digit, so we'll have to skip DTMF for now. */ 02018 return 1; 02019 } 02020 02021 return 0; 02022 }
static int show_channeltype | ( | int | fd, | |
int | argc, | |||
char * | argv[] | |||
) | [static] |
Definition at line 259 of file channel.c.
References ast_cli(), AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_channel_tech::capabilities, ast_channel_tech::devicestate, ast_channel_tech::indicate, chanlist::list, LOG_WARNING, RESULT_FAILURE, RESULT_SHOWUSAGE, RESULT_SUCCESS, ast_channel_tech::send_digit_begin, ast_channel_tech::send_digit_end, ast_channel_tech::send_html, ast_channel_tech::send_image, ast_channel_tech::send_text, chanlist::tech, ast_channel_tech::transfer, and ast_channel_tech::type.
00260 { 00261 struct chanlist *cl = NULL; 00262 00263 if (argc != 4) 00264 return RESULT_SHOWUSAGE; 00265 00266 if (AST_LIST_LOCK(&channels)) { 00267 ast_log(LOG_WARNING, "Unable to lock channel list\n"); 00268 return RESULT_FAILURE; 00269 } 00270 00271 AST_LIST_TRAVERSE(&backends, cl, list) { 00272 if (!strncasecmp(cl->tech->type, argv[3], strlen(cl->tech->type))) { 00273 break; 00274 } 00275 } 00276 00277 00278 if (!cl) { 00279 ast_cli(fd, "\n%s is not a registered channel driver.\n", argv[3]); 00280 AST_LIST_UNLOCK(&channels); 00281 return RESULT_FAILURE; 00282 } 00283 00284 ast_cli(fd, 00285 "-- Info about channel driver: %s --\n" 00286 " Device State: %s\n" 00287 " Indication: %s\n" 00288 " Transfer : %s\n" 00289 " Capabilities: %d\n" 00290 " Digit Begin: %s\n" 00291 " Digit End: %s\n" 00292 " Send HTML : %s\n" 00293 " Image Support: %s\n" 00294 " Text Support: %s\n", 00295 cl->tech->type, 00296 (cl->tech->devicestate) ? "yes" : "no", 00297 (cl->tech->indicate) ? "yes" : "no", 00298 (cl->tech->transfer) ? "yes" : "no", 00299 (cl->tech->capabilities) ? cl->tech->capabilities : -1, 00300 (cl->tech->send_digit_begin) ? "yes" : "no", 00301 (cl->tech->send_digit_end) ? "yes" : "no", 00302 (cl->tech->send_html) ? "yes" : "no", 00303 (cl->tech->send_image) ? "yes" : "no", 00304 (cl->tech->send_text) ? "yes" : "no" 00305 00306 ); 00307 00308 AST_LIST_UNLOCK(&channels); 00309 return RESULT_SUCCESS; 00310 }
static int show_channeltype_deprecated | ( | int | fd, | |
int | argc, | |||
char * | argv[] | |||
) | [static] |
Definition at line 206 of file channel.c.
References ast_cli(), AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_channel_tech::capabilities, ast_channel_tech::devicestate, ast_channel_tech::indicate, chanlist::list, LOG_WARNING, RESULT_FAILURE, RESULT_SHOWUSAGE, RESULT_SUCCESS, ast_channel_tech::send_digit_begin, ast_channel_tech::send_digit_end, ast_channel_tech::send_html, ast_channel_tech::send_image, ast_channel_tech::send_text, chanlist::tech, ast_channel_tech::transfer, and ast_channel_tech::type.
00207 { 00208 struct chanlist *cl = NULL; 00209 00210 if (argc != 3) 00211 return RESULT_SHOWUSAGE; 00212 00213 if (AST_LIST_LOCK(&channels)) { 00214 ast_log(LOG_WARNING, "Unable to lock channel list\n"); 00215 return RESULT_FAILURE; 00216 } 00217 00218 AST_LIST_TRAVERSE(&backends, cl, list) { 00219 if (!strncasecmp(cl->tech->type, argv[2], strlen(cl->tech->type))) { 00220 break; 00221 } 00222 } 00223 00224 00225 if (!cl) { 00226 ast_cli(fd, "\n%s is not a registered channel driver.\n", argv[2]); 00227 AST_LIST_UNLOCK(&channels); 00228 return RESULT_FAILURE; 00229 } 00230 00231 ast_cli(fd, 00232 "-- Info about channel driver: %s --\n" 00233 " Device State: %s\n" 00234 " Indication: %s\n" 00235 " Transfer : %s\n" 00236 " Capabilities: %d\n" 00237 " Digit Begin: %s\n" 00238 " Digit End: %s\n" 00239 " Send HTML : %s\n" 00240 " Image Support: %s\n" 00241 " Text Support: %s\n", 00242 cl->tech->type, 00243 (cl->tech->devicestate) ? "yes" : "no", 00244 (cl->tech->indicate) ? "yes" : "no", 00245 (cl->tech->transfer) ? "yes" : "no", 00246 (cl->tech->capabilities) ? cl->tech->capabilities : -1, 00247 (cl->tech->send_digit_begin) ? "yes" : "no", 00248 (cl->tech->send_digit_end) ? "yes" : "no", 00249 (cl->tech->send_html) ? "yes" : "no", 00250 (cl->tech->send_image) ? "yes" : "no", 00251 (cl->tech->send_text) ? "yes" : "no" 00252 00253 ); 00254 00255 AST_LIST_UNLOCK(&channels); 00256 return RESULT_SUCCESS; 00257 }
static int show_channeltypes | ( | int | fd, | |
int | argc, | |||
char * | argv[] | |||
) | [static] |
Definition at line 179 of file channel.c.
References ast_cli(), AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), ast_channel_tech::description, ast_channel_tech::devicestate, FORMAT, ast_channel_tech::indicate, chanlist::list, LOG_WARNING, RESULT_SUCCESS, chanlist::tech, ast_channel_tech::transfer, and ast_channel_tech::type.
00180 { 00181 #define FORMAT "%-10.10s %-40.40s %-12.12s %-12.12s %-12.12s\n" 00182 struct chanlist *cl; 00183 int count_chan = 0; 00184 00185 ast_cli(fd, FORMAT, "Type", "Description", "Devicestate", "Indications", "Transfer"); 00186 ast_cli(fd, FORMAT, "----------", "-----------", "-----------", "-----------", "--------"); 00187 if (AST_LIST_LOCK(&channels)) { 00188 ast_log(LOG_WARNING, "Unable to lock channel list\n"); 00189 return -1; 00190 } 00191 AST_LIST_TRAVERSE(&backends, cl, list) { 00192 ast_cli(fd, FORMAT, cl->tech->type, cl->tech->description, 00193 (cl->tech->devicestate) ? "yes" : "no", 00194 (cl->tech->indicate) ? "yes" : "no", 00195 (cl->tech->transfer) ? "yes" : "no"); 00196 count_chan++; 00197 } 00198 AST_LIST_UNLOCK(&channels); 00199 ast_cli(fd, "----------\n%d channel drivers registered.\n", count_chan); 00200 return RESULT_SUCCESS; 00201 00202 #undef FORMAT 00203 00204 }
static void* silence_generator_alloc | ( | struct ast_channel * | chan, | |
void * | data | |||
) | [static] |
static int silence_generator_generate | ( | struct ast_channel * | chan, | |
void * | data, | |||
int | len, | |||
int | samples | |||
) | [static] |
Definition at line 4643 of file channel.c.
References AST_FORMAT_SLINEAR, AST_FRAME_VOICE, ast_write(), and ast_frame::frametype.
04644 { 04645 short buf[samples]; 04646 struct ast_frame frame = { 04647 .frametype = AST_FRAME_VOICE, 04648 .subclass = AST_FORMAT_SLINEAR, 04649 .data = buf, 04650 .samples = samples, 04651 .datalen = sizeof(buf), 04652 }; 04653 memset(buf, 0, sizeof(buf)); 04654 if (ast_write(chan, &frame)) 04655 return -1; 04656 return 0; 04657 }
static void silence_generator_release | ( | struct ast_channel * | chan, | |
void * | data | |||
) | [static] |
static void state2str_threadbuf_init | ( | void | ) | [static] |
static void* tonepair_alloc | ( | struct ast_channel * | chan, | |
void * | params | |||
) | [static] |
Definition at line 4396 of file channel.c.
References ast_calloc, AST_FLAG_WRITE_INT, AST_FORMAT_SLINEAR, ast_log(), ast_set_flag, ast_set_write_format(), tonepair_def::duration, tonepair_def::freq1, tonepair_def::freq2, ast_channel::name, tonepair_release(), tonepair_def::vol, and ast_channel::writeformat.
04397 { 04398 struct tonepair_state *ts; 04399 struct tonepair_def *td = params; 04400 04401 if (!(ts = ast_calloc(1, sizeof(*ts)))) 04402 return NULL; 04403 ts->origwfmt = chan->writeformat; 04404 if (ast_set_write_format(chan, AST_FORMAT_SLINEAR)) { 04405 ast_log(LOG_WARNING, "Unable to set '%s' to signed linear format (write)\n", chan->name); 04406 tonepair_release(NULL, ts); 04407 ts = NULL; 04408 } else { 04409 ts->fac1 = 2.0 * cos(2.0 * M_PI * (td->freq1 / 8000.0)) * 32768.0; 04410 ts->v1_1 = 0; 04411 ts->v2_1 = sin(-4.0 * M_PI * (td->freq1 / 8000.0)) * td->vol; 04412 ts->v3_1 = sin(-2.0 * M_PI * (td->freq1 / 8000.0)) * td->vol; 04413 ts->v2_1 = 0; 04414 ts->fac2 = 2.0 * cos(2.0 * M_PI * (td->freq2 / 8000.0)) * 32768.0; 04415 ts->v2_2 = sin(-4.0 * M_PI * (td->freq2 / 8000.0)) * td->vol; 04416 ts->v3_2 = sin(-2.0 * M_PI * (td->freq2 / 8000.0)) * td->vol; 04417 ts->duration = td->duration; 04418 ts->modulate = 0; 04419 } 04420 /* Let interrupts interrupt :) */ 04421 ast_set_flag(chan, AST_FLAG_WRITE_INT); 04422 return ts; 04423 }
static int tonepair_generator | ( | struct ast_channel * | chan, | |
void * | data, | |||
int | len, | |||
int | samples | |||
) | [static] |
Definition at line 4425 of file channel.c.
References ast_log(), tonepair_state::data, tonepair_state::f, tonepair_state::fac1, tonepair_state::fac2, tonepair_state::modulate, tonepair_state::v1_1, tonepair_state::v1_2, tonepair_state::v2_1, tonepair_state::v2_2, tonepair_state::v3_1, and tonepair_state::v3_2.
04426 { 04427 struct tonepair_state *ts = data; 04428 int x; 04429 04430 /* we need to prepare a frame with 16 * timelen samples as we're 04431 * generating SLIN audio 04432 */ 04433 len = samples * 2; 04434 04435 if (len > sizeof(ts->data) / 2 - 1) { 04436 ast_log(LOG_WARNING, "Can't generate that much data!\n"); 04437 return -1; 04438 } 04439 memset(&ts->f, 0, sizeof(ts->f)); 04440 for (x=0;x<len/2;x++) { 04441 ts->v1_1 = ts->v2_1; 04442 ts->v2_1 = ts->v3_1; 04443 ts->v3_1 = (ts->fac1 * ts->v2_1 >> 15) - ts->v1_1; 04444 04445 ts->v1_2 = ts->v2_2; 04446 ts->v2_2 = ts->v3_2; 04447 ts->v3_2 = (ts->fac2 * ts->v2_2 >> 15) - ts->v1_2; 04448 if (ts->modulate) { 04449 int p; 04450 p = ts->v3_2 - 32768; 04451 if (p < 0) p = -p; 04452 p = ((p * 9) / 10) + 1; 04453 ts->data[x] = (ts->v3_1 * p) >> 15; 04454 } else 04455 ts->data[x] = ts->v3_1 + ts->v3_2; 04456 } 04457 ts->f.frametype = AST_FRAME_VOICE; 04458 ts->f.subclass = AST_FORMAT_SLINEAR; 04459 ts->f.datalen = len; 04460 ts->f.samples = samples; 04461 ts->f.offset = AST_FRIENDLY_OFFSET; 04462 ts->f.data = ts->data; 04463 ast_write(chan, &ts->f); 04464 ts->pos += x; 04465 if (ts->duration > 0) { 04466 if (ts->pos >= ts->duration * 8) 04467 return -1; 04468 } 04469 return 0; 04470 }
static void tonepair_release | ( | struct ast_channel * | chan, | |
void * | params | |||
) | [static] |
Definition at line 4387 of file channel.c.
References ast_set_write_format(), free, and tonepair_state::origwfmt.
Referenced by tonepair_alloc().
04388 { 04389 struct tonepair_state *ts = params; 04390 04391 if (chan) 04392 ast_set_write_format(chan, ts->origwfmt); 04393 free(ts); 04394 }
void(*) ast_moh_cleanup_ptr(struct ast_channel *) = NULL [static] |
Definition at line 4548 of file channel.c.
Referenced by ast_install_music_functions(), ast_moh_cleanup(), and ast_uninstall_music_functions().
int(*) ast_moh_start_ptr(struct ast_channel *, const char *, const char *) = NULL [static] |
Definition at line 4546 of file channel.c.
Referenced by ast_install_music_functions(), ast_moh_start(), and ast_uninstall_music_functions().
void(*) ast_moh_stop_ptr(struct ast_channel *) = NULL [static] |
Definition at line 4547 of file channel.c.
Referenced by ast_install_music_functions(), ast_moh_stop(), and ast_uninstall_music_functions().
map AST_CAUSE's to readable string representations
Referenced by ast_cause2str(), ast_str2cause(), and dump_cause().
struct ast_cli_entry cli_channel[] [static] |
struct ast_cli_entry cli_show_channeltype_deprecated [static] |
Initial value:
{ { "show", "channeltype", NULL }, show_channeltype_deprecated, NULL, NULL, complete_channeltypes_deprecated }
struct ast_cli_entry cli_show_channeltypes_deprecated [static] |
Initial value:
{ { "show", "channeltypes", NULL }, show_channeltypes, NULL, NULL }
unsigned long global_fin |
unsigned long global_fout |
struct ast_channel_tech null_tech [static] |
char show_channeltype_usage[] [static] |
char show_channeltypes_usage[] [static] |
int shutting_down [static] |
struct ast_generator silence_generator [static] |
Initial value:
{ .alloc = silence_generator_alloc, .release = silence_generator_release, .generate = silence_generator_generate, }
Definition at line 4659 of file channel.c.
Referenced by ast_channel_start_silence_generator().
struct ast_threadstorage state2str_threadbuf = { .once = PTHREAD_ONCE_INIT, .key_init = state2str_threadbuf_init , } [static] |
struct ast_generator tonepair [static] |
Initial value:
{ alloc: tonepair_alloc, release: tonepair_release, generate: tonepair_generator, }
Definition at line 4472 of file channel.c.
Referenced by ast_tonepair_start().