channel.h File Reference

General Asterisk PBX channel definitions. More...

#include "asterisk/alertpipe.h"
#include "asterisk/abstract_jb.h"
#include "asterisk/astobj2.h"
#include "asterisk/poll-compat.h"
#include "asterisk/frame.h"
#include "asterisk/chanvars.h"
#include "asterisk/config.h"
#include "asterisk/lock.h"
#include "asterisk/cdr.h"
#include "asterisk/utils.h"
#include "asterisk/linkedlists.h"
#include "asterisk/stringfields.h"
#include "asterisk/datastore.h"
#include "asterisk/format_cap.h"
#include "asterisk/channelstate.h"
#include "asterisk/ccss.h"
#include "asterisk/framehook.h"
#include "asterisk/stasis.h"
#include "asterisk/endpoints.h"

Include dependency graph for channel.h:

Go to the source code of this file.

Data Structures
struct	ast_assigned_ids
	Structure to pass both assignedid values to channel drivers. More...
struct	ast_autochan_list
struct	ast_bridge_config
	bridge configuration More...
struct	ast_chan_write_info_t
	Structure to handle passing func_channel_write info to channels via setoption. More...
struct	ast_channel_monitor
struct	ast_channel_tech
	Structure to describe a channel "technology", ie a channel driver See for examples: More...
struct	ast_datastore_list
struct	ast_generator
struct	ast_group_info
	channel group info More...
struct	ast_hangup_handler
struct	ast_hangup_handler_list
struct	ast_party_caller
	Caller Party information. More...
struct	ast_party_connected_line
	Connected Line/Party information. More...
struct	ast_party_dialed
	Dialed/Called Party information. More...
struct	ast_party_id
	Information needed to identify an endpoint in a call. More...
struct	ast_party_name
	Information needed to specify a name in a call. More...
struct	ast_party_number
	Information needed to specify a number in a call. More...
struct	ast_party_redirecting
	Redirecting Line information. RDNIS (Redirecting Directory Number Information Service) Where a call diversion or transfer was invoked. More...
struct	ast_party_redirecting_reason
	Redirecting reason information. More...
struct	ast_party_subaddress
	Information needed to specify a subaddress in a call. More...
struct	ast_readq_list
struct	ast_set_party_caller
	Indicate what information in ast_party_caller should be set. More...
struct	ast_set_party_connected_line
	Indicate what information in ast_party_connected_line should be set. More...
struct	ast_set_party_id
	Indicate what information in ast_party_id should be set. More...
struct	ast_set_party_redirecting
	Indicate what information in ast_party_redirecting should be set. More...
struct	outgoing_helper

Macros
#define	AST_AGENT_FD   (AST_MAX_FDS-3)
#define	AST_ALERT_FD   (AST_MAX_FDS-1)
#define	AST_BRIDGE_DTMF_CHANNEL_0   (1 << 0)
	Report DTMF on channel 0. More...
#define	AST_BRIDGE_DTMF_CHANNEL_1   (1 << 1)
	Report DTMF on channel 1. More...
#define	AST_CHAN_WRITE_INFO_T_VERSION   1
	ast_chan_write_info_t version. Must be incremented if structure is changed More...
#define	ast_channel_alloc(needqueue, state, cid_num, cid_name, acctcode, exten, context, assignedids, requestor, amaflag, ...)
	Create a channel structure. More...
#define	ast_channel_alloc_with_endpoint(needqueue, state, cid_num, cid_name, acctcode, exten, context, assignedids, requestor, amaflag, endpoint, ...)
#define	ast_channel_cleanup(c)   ({ ao2_cleanup(c); (struct ast_channel *) (NULL); })
	Cleanup a channel reference. More...
#define	ast_channel_has_tech_function(chan, function)   (ast_channel_tech(chan) ? ast_channel_tech(chan)->function != NULL : 0)
	Checks if a channel's technology implements a particular callback function. More...
#define	ast_channel_lock(chan)   ao2_lock(chan)
#define	ast_channel_lock_both(chan1, chan2)
	Lock two channels. More...
#define	AST_CHANNEL_NAME   80
#define	ast_channel_ref(c)   ({ ao2_ref(c, +1); (c); })
	Increase channel reference count. More...
#define	ast_channel_trylock(chan)   ao2_trylock(chan)
#define	ast_channel_unlock(chan)   ao2_unlock(chan)
#define	ast_channel_unref(c)   ({ ao2_ref(c, -1); (struct ast_channel *) (NULL); })
	Decrease channel reference count. More...
#define	ast_dummy_channel_alloc()   __ast_dummy_channel_alloc(__FILE__, __LINE__, __PRETTY_FUNCTION__)
	Create a fake channel structure. More...
#define	AST_EXTENDED_FDS   12
#define	AST_FEATURE_DTMF_MASK
#define	AST_GENERATOR_FD   (AST_MAX_FDS-4)
#define	AST_JITTERBUFFER_FD   (AST_MAX_FDS-5)
#define	AST_MAX_ACCOUNT_CODE   80
#define	AST_MAX_CONTEXT   80
#define	AST_MAX_EXTENSION   80
#define	AST_MAX_FDS   11
#define	AST_MAX_PUBLIC_UNIQUEID   149
#define	AST_MAX_UNIQUEID   (AST_MAX_PUBLIC_UNIQUEID + 2 + 1)
#define	AST_MAX_USER_FIELD   256
#define	AST_MUTE_DIRECTION_READ   (1 << 0)
#define	AST_MUTE_DIRECTION_WRITE   (1 << 1)
#define	AST_NUM_CHANNEL_BUCKETS   1567
#define	AST_TIMING_FD   (AST_MAX_FDS-2)
#define	CHECK_BLOCKING(c)
	Set the blocking indication on the channel. More...
#define	DATASTORE_INHERIT_FOREVER   INT_MAX
#define	DEBUGCHAN_FLAG   0x80000000
#define	DECLARE_STRINGFIELD_SETTERS_FOR(field)
#define	FRAMECOUNT_INC(x)   ( ((x) & DEBUGCHAN_FLAG) | (((x)+1) & ~DEBUGCHAN_FLAG) )
#define	MAX_LANGUAGE   40
#define	MAX_MUSICCLASS   80

Typedefs
typedef int(*	ast_acf_read2_fn_t) (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **str, ssize_t len)
	Typedef for a custom read2 function. More...
typedef int(*	ast_acf_read_fn_t) (struct ast_channel *chan, const char *function, char *data, char *buf, size_t len)
	Typedef for a custom read function. More...
typedef int(*	ast_acf_write_fn_t) (struct ast_channel *chan, const char *function, char *data, const char *value)
	Typedef for a custom write function. More...
typedef unsigned long long	ast_group_t
typedef int(*	ast_timing_func_t) (const void *data)

Enumerations
enum	{ AST_CHAN_TP_WANTSJITTER = (1 << 0), AST_CHAN_TP_CREATESJITTER = (1 << 1), AST_CHAN_TP_INTERNAL = (1 << 2), AST_CHAN_TP_SEND_TEXT_DATA = (1 << 3) }
	ast_channel_tech Properties More...
enum	{   AST_FLAG_DEFER_DTMF = (1 << 1), AST_FLAG_WRITE_INT = (1 << 2), AST_FLAG_BLOCKING = (1 << 3), AST_FLAG_ZOMBIE = (1 << 4),   AST_FLAG_EXCEPTION = (1 << 5), AST_FLAG_MOH = (1 << 6), AST_FLAG_SPYING = (1 << 7), AST_FLAG_IN_AUTOLOOP = (1 << 9),   AST_FLAG_OUTGOING = (1 << 10), AST_FLAG_IN_DTMF = (1 << 12), AST_FLAG_EMULATE_DTMF = (1 << 13), AST_FLAG_END_DTMF_ONLY = (1 << 14),   AST_FLAG_MASQ_NOSTREAM = (1 << 16), AST_FLAG_BRIDGE_HANGUP_RUN = (1 << 17), AST_FLAG_DISABLE_WORKAROUNDS = (1 << 20), AST_FLAG_DISABLE_DEVSTATE_CACHE = (1 << 21),   AST_FLAG_BRIDGE_DUAL_REDIRECT_WAIT = (1 << 22), AST_FLAG_ORIGINATED = (1 << 23), AST_FLAG_DEAD = (1 << 24), AST_FLAG_SNAPSHOT_STAGE = (1 << 25),   AST_FLAG_TIMINGDATA_IS_AO2_OBJ = (1 << 26), AST_FLAG_SUBROUTINE_EXEC = (1 << 27) }
	ast_channel flags More...
enum	{   AST_FEATURE_PLAY_WARNING = (1 << 0), AST_FEATURE_REDIRECT = (1 << 1), AST_FEATURE_DISCONNECT = (1 << 2), AST_FEATURE_ATXFER = (1 << 3),   AST_FEATURE_AUTOMON = (1 << 4), AST_FEATURE_PARKCALL = (1 << 5), AST_FEATURE_AUTOMIXMON = (1 << 6) }
	ast_bridge_config flags More...
enum	{   AST_SOFTHANGUP_DEV = (1 << 0), AST_SOFTHANGUP_ASYNCGOTO = (1 << 1), AST_SOFTHANGUP_SHUTDOWN = (1 << 2), AST_SOFTHANGUP_TIMEOUT = (1 << 3),   AST_SOFTHANGUP_APPUNLOAD = (1 << 4), AST_SOFTHANGUP_EXPLICIT = (1 << 5), AST_SOFTHANGUP_HANGUP_EXEC = (1 << 7), AST_SOFTHANGUP_ALL = (0xFFFFFFFF) }
enum	ama_flags { AST_AMA_NONE = 0, AST_AMA_OMIT, AST_AMA_BILLING, AST_AMA_DOCUMENTATION }
	Channel AMA Flags. More...
enum	ast_bridge_result { AST_BRIDGE_COMPLETE = 0, AST_BRIDGE_FAILED = -1, AST_BRIDGE_FAILED_NOWARN = -2, AST_BRIDGE_RETRY = -3 }
enum	ast_channel_adsicpe { AST_ADSI_UNKNOWN, AST_ADSI_AVAILABLE, AST_ADSI_UNAVAILABLE, AST_ADSI_OFFHOOKONLY }
enum	ast_channel_error { AST_CHANNEL_ERROR_UNKNOWN, AST_CHANNEL_ERROR_ID_EXISTS }
enum	ast_channel_requestor_relationship { AST_CHANNEL_REQUESTOR_BRIDGE_PEER, AST_CHANNEL_REQUESTOR_REPLACEMENT }
enum	AST_MONITORING_STATE { AST_MONITOR_RUNNING, AST_MONITOR_PAUSED }
enum	AST_PARTY_CHAR_SET {   AST_PARTY_CHAR_SET_UNKNOWN = 0, AST_PARTY_CHAR_SET_ISO8859_1 = 1, AST_PARTY_CHAR_SET_WITHDRAWN = 2, AST_PARTY_CHAR_SET_ISO8859_2 = 3,   AST_PARTY_CHAR_SET_ISO8859_3 = 4, AST_PARTY_CHAR_SET_ISO8859_4 = 5, AST_PARTY_CHAR_SET_ISO8859_5 = 6, AST_PARTY_CHAR_SET_ISO8859_7 = 7,   AST_PARTY_CHAR_SET_ISO10646_BMPSTRING = 8, AST_PARTY_CHAR_SET_ISO10646_UTF_8STRING = 9 }
enum	ast_t38_state {   T38_STATE_UNAVAILABLE, T38_STATE_UNKNOWN, T38_STATE_NEGOTIATING, T38_STATE_REJECTED,   T38_STATE_NEGOTIATED }
	Possible T38 states on channels. More...
enum	channelreloadreason {   CHANNEL_MODULE_LOAD, CHANNEL_MODULE_RELOAD, CHANNEL_CLI_RELOAD, CHANNEL_MANAGER_RELOAD,   CHANNEL_ACL_RELOAD }
	Channel reload reasons for manager events at load or reload of configuration. More...

Functions
int	__ast_answer (struct ast_channel *chan, unsigned int delay)
	Answer a channel, with a selectable delay before returning. More...
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 struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, enum ama_flags amaflag, struct ast_endpoint *endpoint, const char *file, int line, const char *function, const char *name_fmt,...)
	Create a channel structure. More...
struct ast_channel *	__ast_dummy_channel_alloc (const char *file, int line, const char *function)
struct ast_channel *	__ast_request_and_dial (const char *type, struct ast_format_cap *cap, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *addr, int timeout, int *reason, const char *cid_num, const char *cid_name, struct outgoing_helper *oh)
	Request a channel of a given type, with data as optional information used by the low level module and attempt to place a call on it. More...
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 More...
static int	ast_add_fd (struct pollfd *pfd, int fd)
	if fd is a valid descriptor, set *pfd with the descriptor More...
int	ast_answer (struct ast_channel *chan)
	Answer a channel. More...
int	ast_auto_answer (struct ast_channel *chan)
	Answer a channel, if it's not already answered. More...
void	ast_autoservice_chan_hangup_peer (struct ast_channel *chan, struct ast_channel *peer)
	Put chan into autoservice while hanging up peer. More...
int	ast_autoservice_ignore (struct ast_channel *chan, enum ast_frame_type ftype)
	Ignore certain frame types. More...
int	ast_autoservice_start (struct ast_channel *chan)
	Automatically service a channel for us... More...
int	ast_autoservice_stop (struct ast_channel *chan)
	Stop servicing a channel for us... More...
int	ast_call (struct ast_channel *chan, const char *addr, int timeout)
	Make a call. More...
struct ast_channel *	ast_call_forward (struct ast_channel *caller, struct ast_channel *orig, int *timeout, struct ast_format_cap *cap, struct outgoing_helper *oh, int *outstate)
	Forwards a call to a new channel specified by the original channel's call_forward str. If possible, the new forwarded channel is created and returned while the original one is terminated. More...
const char *	ast_cause2str (int state) attribute_pure
	Gives the string form of a given cause code. More...
void	ast_change_name (struct ast_channel *chan, const char *newname)
	Change channel name. More...
struct ast_channel *	ast_channel__bridge (const struct ast_channel *chan)
void	ast_channel__bridge_set (struct ast_channel *chan, struct ast_channel *value)
const char *	ast_channel_accountcode (const struct ast_channel *chan)
enum ast_channel_adsicpe	ast_channel_adsicpe (const struct ast_channel *chan)
void	ast_channel_adsicpe_set (struct ast_channel *chan, enum ast_channel_adsicpe value)
int	ast_channel_alert_writable (struct ast_channel *chan)
int	ast_channel_alert_write (struct ast_channel *chan)
enum ama_flags	ast_channel_amaflags (const struct ast_channel *chan)
const char *	ast_channel_amaflags2string (enum ama_flags flags)
	Convert the enum representation of an AMA flag to a string representation. More...
void	ast_channel_amaflags_set (struct ast_channel *chan, enum ama_flags value)
struct timeval	ast_channel_answertime (struct ast_channel *chan)
void	ast_channel_answertime_set (struct ast_channel *chan, struct timeval *value)
const char *	ast_channel_appl (const struct ast_channel *chan)
void	ast_channel_appl_set (struct ast_channel *chan, const char *value)
struct ast_audiohook_list *	ast_channel_audiohooks (const struct ast_channel *chan)
void	ast_channel_audiohooks_set (struct ast_channel *chan, struct ast_audiohook_list *value)
struct ast_autochan_list *	ast_channel_autochans (struct ast_channel *chan)
pthread_t	ast_channel_blocker (const struct ast_channel *chan)
void	ast_channel_blocker_set (struct ast_channel *chan, pthread_t value)
int	ast_channel_blocker_tid (const struct ast_channel *chan)
void	ast_channel_blocker_tid_set (struct ast_channel *chan, int tid)
const char *	ast_channel_blockproc (const struct ast_channel *chan)
void	ast_channel_blockproc_set (struct ast_channel *chan, const char *value)
struct ast_channel *	ast_channel_bridge_peer (struct ast_channel *chan)
	Get the channel's bridge peer only if the bridge is two-party. More...
const char *	ast_channel_call_forward (const struct ast_channel *chan)
struct ast_channel *	ast_channel_callback (ao2_callback_data_fn *cb_fn, void *arg, void *data, int ao2_flags)
	Call a function with every active channel. More...
struct ast_party_caller *	ast_channel_caller (struct ast_channel *chan)
void	ast_channel_caller_set (struct ast_channel *chan, struct ast_party_caller *value)
ast_group_t	ast_channel_callgroup (const struct ast_channel *chan)
void	ast_channel_callgroup_set (struct ast_channel *chan, ast_group_t value)
ast_callid	ast_channel_callid (const struct ast_channel *chan)
void	ast_channel_callid_cleanup (struct ast_channel *chan)
void	ast_channel_callid_set (struct ast_channel *chan, ast_callid value)
int	ast_channel_cc_params_init (struct ast_channel *chan, const struct ast_cc_config_params *base_params)
	Set up datastore with CCSS parameters for a channel. More...
struct ast_cdr *	ast_channel_cdr (const struct ast_channel *chan)
void	ast_channel_cdr_set (struct ast_channel *chan, struct ast_cdr *value)
void	ast_channel_clear_flag (struct ast_channel *chan, unsigned int flag)
void	ast_channel_clear_softhangup (struct ast_channel *chan, int flag)
	Clear a set of softhangup flags from a channel. More...
int	ast_channel_cmpwhentohangup_tv (struct ast_channel *chan, struct timeval offset)
	Compare a offset with the settings of when to hang a channel up. More...
struct ast_party_connected_line *	ast_channel_connected (struct ast_channel *chan)
struct ast_party_id	ast_channel_connected_effective_id (struct ast_channel *chan)
struct ast_party_connected_line *	ast_channel_connected_indicated (struct ast_channel *chan)
int	ast_channel_connected_line_macro (struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const void *connected_info, int is_caller, int frame)
	Run a connected line interception macro and update a channel's connected line information. More...
int	ast_channel_connected_line_sub (struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const void *connected_info, int frame)
	Run a connected line interception subroutine and update a channel's connected line information. More...
void	ast_channel_connected_set (struct ast_channel *chan, struct ast_party_connected_line *value)
const char *	ast_channel_context (const struct ast_channel *chan)
void	ast_channel_context_set (struct ast_channel *chan, const char *value)
struct timeval	ast_channel_creationtime (struct ast_channel *chan)
void	ast_channel_creationtime_set (struct ast_channel *chan, struct timeval *value)
const char *	ast_channel_data (const struct ast_channel *chan)
void	ast_channel_data_set (struct ast_channel *chan, const char *value)
int	ast_channel_datastore_add (struct ast_channel *chan, struct ast_datastore *datastore)
	Add a datastore to a channel. More...
struct ast_datastore *	ast_channel_datastore_find (struct ast_channel *chan, const struct ast_datastore_info *info, const char *uid)
	Find a datastore on a channel. More...
int	ast_channel_datastore_inherit (struct ast_channel *from, struct ast_channel *to)
	Inherit datastores from a parent to a child. More...
int	ast_channel_datastore_remove (struct ast_channel *chan, struct ast_datastore *datastore)
	Remove a datastore from a channel. More...
struct ast_datastore_list *	ast_channel_datastores (struct ast_channel *chan)
int	ast_channel_defer_dtmf (struct ast_channel *chan)
	Defers DTMF so that you only read things like hangups and audio. More...
const char *	ast_channel_dialcontext (const struct ast_channel *chan)
struct ast_party_dialed *	ast_channel_dialed (struct ast_channel *chan)
int	ast_channel_dialed_causes_add (const struct ast_channel *chan, const struct ast_control_pvt_cause_code *cause_code, int datalen)
	Add cause code information to the channel. More...
struct ast_str *	ast_channel_dialed_causes_channels (const struct ast_channel *chan)
	Retrieve a comma-separated list of channels for which dialed cause information is available. More...
void	ast_channel_dialed_causes_clear (const struct ast_channel *chan)
	Clear all cause information from the channel. More...
struct ast_control_pvt_cause_code *	ast_channel_dialed_causes_find (const struct ast_channel *chan, const char *chan_name)
	Retrieve a ref-counted cause code information structure. More...
void	ast_channel_dialed_set (struct ast_channel *chan, struct ast_party_dialed *value)
char	ast_channel_dtmf_digit_to_emulate (const struct ast_channel *chan)
void	ast_channel_dtmf_digit_to_emulate_set (struct ast_channel *chan, char value)
struct timeval *	ast_channel_dtmf_tv (struct ast_channel *chan)
void	ast_channel_dtmf_tv_set (struct ast_channel *chan, struct timeval *value)
struct ast_frame *	ast_channel_dtmff (struct ast_channel *chan)
void	ast_channel_dtmff_set (struct ast_channel *chan, struct ast_frame *value)
int	ast_channel_early_bridge (struct ast_channel *c0, struct ast_channel *c1)
	Bridge two channels together (early) More...
unsigned int	ast_channel_emulate_dtmf_duration (const struct ast_channel *chan)
void	ast_channel_emulate_dtmf_duration_set (struct ast_channel *chan, unsigned int value)
void	ast_channel_end_dtmf (struct ast_channel *chan, char digit, struct timeval start, const char *why)
	Simulate a DTMF end on a broken bridge channel. More...
int	ast_channel_epfd (const struct ast_channel *chan)
void	ast_channel_epfd_set (struct ast_channel *chan, int value)
enum ast_channel_error	ast_channel_errno (void)
	Get error code for latest channel operation. More...
const char *	ast_channel_exten (const struct ast_channel *chan)
void	ast_channel_exten_set (struct ast_channel *chan, const char *value)
int	ast_channel_fd (const struct ast_channel *chan, int which)
int	ast_channel_fd_add (struct ast_channel *chan, int value)
	Add a file descriptor to the channel without a fixed position. More...
int	ast_channel_fd_count (const struct ast_channel *chan)
	Retrieve the number of file decriptor positions present on the channel. More...
int	ast_channel_fd_isset (const struct ast_channel *chan, int which)
int	ast_channel_fdno (const struct ast_channel *chan)
void	ast_channel_fdno_set (struct ast_channel *chan, int value)
int	ast_channel_feature_hooks_append (struct ast_channel *chan, struct ast_bridge_features *features)
	Appends to the channel-attached features a channel has access to upon being bridged. More...
struct ast_bridge_features *	ast_channel_feature_hooks_get (struct ast_channel *chan)
	Gets the channel-attached features a channel has access to upon being bridged. More...
int	ast_channel_feature_hooks_replace (struct ast_channel *chan, struct ast_bridge_features *features)
	Sets the channel-attached features a channel has access to upon being bridged. More...
unsigned int	ast_channel_fin (const struct ast_channel *chan)
void	ast_channel_fin_set (struct ast_channel *chan, unsigned int value)
struct ast_flags *	ast_channel_flags (struct ast_channel *chan)
int	ast_channel_forward_endpoint (struct ast_channel *chan, struct ast_endpoint *endpoint)
	Forward channel stasis messages to the given endpoint. More...
unsigned int	ast_channel_fout (const struct ast_channel *chan)
void	ast_channel_fout_set (struct ast_channel *chan, unsigned int value)
struct ast_framehook_list *	ast_channel_framehooks (const struct ast_channel *chan)
void	ast_channel_framehooks_set (struct ast_channel *chan, struct ast_framehook_list *value)
struct ast_generator *	ast_channel_generator (const struct ast_channel *chan)
void	ast_channel_generator_set (struct ast_channel *chan, struct ast_generator *value)
void *	ast_channel_generatordata (const struct ast_channel *chan)
void	ast_channel_generatordata_set (struct ast_channel *chan, void *value)
struct varshead *	ast_channel_get_ari_vars (struct ast_channel *chan)
	Gets the variables for a given channel, as specified by ast_channel_set_ari_vars(). More...
struct ast_bridge *	ast_channel_get_bridge (const struct ast_channel *chan)
	Get the bridge associated with a channel. More...
struct ast_bridge_channel *	ast_channel_get_bridge_channel (struct ast_channel *chan)
	Get a reference to the channel's bridge pointer. More...
int	ast_channel_get_cc_agent_type (struct ast_channel *chan, char *agent_type, size_t size)
	Find the appropriate CC agent type to use given a channel. More...
struct ast_cc_config_params *	ast_channel_get_cc_config_params (struct ast_channel *chan)
	Get the CCSS parameters from a channel. More...
struct ast_stream *	ast_channel_get_default_stream (struct ast_channel *chan, enum ast_media_type type)
	Retrieve the default stream of a specific media type on a channel. More...
int	ast_channel_get_device_name (struct ast_channel *chan, char *device_name, size_t name_buffer_length)
	Get a device name given its channel structure. More...
int	ast_channel_get_duration (struct ast_channel *chan)
	Obtain how long the channel since the channel was created. More...
int64_t	ast_channel_get_duration_ms (struct ast_channel *chan)
	Obtain how long it's been, in milliseconds, since the channel was created. More...
int	ast_channel_get_intercept_mode (void)
	Am I currently running an intercept dialplan routine. More...
struct varshead *	ast_channel_get_manager_vars (struct ast_channel *chan)
	Gets the variables for a given channel, as specified by ast_channel_set_manager_vars(). More...
struct ast_stream_topology *	ast_channel_get_stream_topology (const struct ast_channel *chan)
	Retrieve the topology of streams on a channel. More...
void *	ast_channel_get_stream_topology_change_source (struct ast_channel *chan)
	Retrieve the source that initiated the last stream topology change. More...
static enum ast_t38_state	ast_channel_get_t38_state (struct ast_channel *chan)
	Retrieves the current T38 state of a channel. More...
int	ast_channel_get_up_time (struct ast_channel *chan)
	Obtain how long it has been since the channel was answered. More...
int64_t	ast_channel_get_up_time_ms (struct ast_channel *chan)
	Obtain how long it has been since the channel was answered in ms. More...
struct varshead *	ast_channel_get_vars (struct ast_channel *chan)
	Gets the variables for a given channel, as set using pbx_builtin_setvar_helper(). More...
struct ast_hangup_handler_list *	ast_channel_hangup_handlers (struct ast_channel *chan)
int	ast_channel_hangupcause (const struct ast_channel *chan)
void	ast_channel_hangupcause_hash_set (struct ast_channel *chan, const struct ast_control_pvt_cause_code *cause_code, int datalen)
	Sets the HANGUPCAUSE hash and optionally the SIP_CAUSE hash on the given channel. More...
void	ast_channel_hangupcause_set (struct ast_channel *chan, int value)
const char *	ast_channel_hangupsource (const struct ast_channel *chan)
int	ast_channel_has_ari_vars (void)
	Return whether or not any ARI variables have been set. More...
int	ast_channel_has_audio_frame_or_monitor (struct ast_channel *chan)
	Check if the channel has active audiohooks, active framehooks, or a monitor. More...
int	ast_channel_has_hook_requiring_audio (struct ast_channel *chan)
	Check if the channel has any active hooks that require audio. More...
int	ast_channel_has_manager_vars (void)
	Return whether or not any manager variables have been set. More...
int	ast_channel_hold_state (const struct ast_channel *chan)
void	ast_channel_hold_state_set (struct ast_channel *chan, int value)
void	ast_channel_inherit_variables (const struct ast_channel *parent, struct ast_channel *child)
	Inherits channel variable from parent to child channel. More...
unsigned long	ast_channel_insmpl (const struct ast_channel *chan)
void	ast_channel_insmpl_set (struct ast_channel *chan, unsigned long value)
ast_alert_status_t	ast_channel_internal_alert_flush (struct ast_channel *chan)
ast_alert_status_t	ast_channel_internal_alert_read (struct ast_channel *chan)
int	ast_channel_internal_alert_readable (struct ast_channel *chan)
int	ast_channel_internal_alert_readfd (struct ast_channel *chan)
void	ast_channel_internal_alertpipe_clear (struct ast_channel *chan)
void	ast_channel_internal_alertpipe_close (struct ast_channel *chan)
int	ast_channel_internal_alertpipe_init (struct ast_channel *chan)
void	ast_channel_internal_alertpipe_swap (struct ast_channel *chan1, struct ast_channel *chan2)
	Swap the interal alertpipe between two channels. More...
struct ast_bridge *	ast_channel_internal_bridge (const struct ast_channel *chan)
struct ast_bridge_channel *	ast_channel_internal_bridge_channel (const struct ast_channel *chan)
void	ast_channel_internal_bridge_channel_set (struct ast_channel *chan, struct ast_bridge_channel *value)
void	ast_channel_internal_bridge_set (struct ast_channel *chan, struct ast_bridge *value)
struct ast_channel *	ast_channel_internal_bridged_channel (const struct ast_channel *chan)
void	ast_channel_internal_bridged_channel_set (struct ast_channel *chan, struct ast_channel *value)
void	ast_channel_internal_copy_linkedid (struct ast_channel *dest, struct ast_channel *source)
	Copy the full linkedid channel id structure from one channel to another. More...
void	ast_channel_internal_fd_clear (struct ast_channel *chan, int which)
void	ast_channel_internal_fd_clear_all (struct ast_channel *chan)
void	ast_channel_internal_fd_set (struct ast_channel *chan, int which, int value)
struct ast_channel *	ast_channel_internal_oldest_linkedid (struct ast_channel *a, struct ast_channel *b)
	Determine which channel has an older linkedid. More...
void	ast_channel_internal_set_fake_ids (struct ast_channel *chan, const char *uniqueid, const char *linkedid)
	Set uniqueid and linkedid string value only (not time) More...
void	ast_channel_internal_swap_endpoint_forward (struct ast_channel *a, struct ast_channel *b)
	Swap endpoint_forward between two channels. More...
void	ast_channel_internal_swap_snapshots (struct ast_channel *a, struct ast_channel *b)
	Swap snapshots beteween two channels. More...
void	ast_channel_internal_swap_topics (struct ast_channel *a, struct ast_channel *b)
	Swap topics beteween two channels. More...
void	ast_channel_internal_swap_uniqueid_and_linkedid (struct ast_channel *a, struct ast_channel *b)
	Swap uniqueid and linkedid beteween two channels. More...
int	ast_channel_is_bridged (const struct ast_channel *chan)
	Determine if a channel is in a bridge. More...
int	ast_channel_is_leaving_bridge (struct ast_channel *chan)
	Determine if a channel is leaving a bridge, but not hung up. More...
int	ast_channel_is_multistream (struct ast_channel *chan)
	Determine if a channel is multi-stream capable. More...
int	ast_channel_is_t38_active (struct ast_channel *chan)
	This function will check if T.38 is active on the channel. More...
int	ast_channel_is_t38_active_nolock (struct ast_channel *chan)
	ast_channel_is_t38_active variant. Use this if the channel is already locked prior to calling. More...
struct ast_jb *	ast_channel_jb (struct ast_channel *chan)
void	ast_channel_jb_set (struct ast_channel *chan, struct ast_jb *value)
const char *	ast_channel_language (const struct ast_channel *chan)
const char *	ast_channel_latest_musicclass (const struct ast_channel *chan)
const char *	ast_channel_linkedid (const struct ast_channel *chan)
const char *	ast_channel_macrocontext (const struct ast_channel *chan)
void	ast_channel_macrocontext_set (struct ast_channel *chan, const char *value)
const char *	ast_channel_macroexten (const struct ast_channel *chan)
void	ast_channel_macroexten_set (struct ast_channel *chan, const char *value)
int	ast_channel_macropriority (const struct ast_channel *chan)
void	ast_channel_macropriority_set (struct ast_channel *chan, int value)
int	ast_channel_make_compatible (struct ast_channel *chan, struct ast_channel *peer)
	Make the frame formats of two channels compatible. More...
struct ast_channel *	ast_channel_masq (const struct ast_channel *chan)
void	ast_channel_masq_set (struct ast_channel *chan, struct ast_channel *value)
struct ast_channel *	ast_channel_masqr (const struct ast_channel *chan)
void	ast_channel_masqr_set (struct ast_channel *chan, struct ast_channel *value)
struct ast_channel_monitor *	ast_channel_monitor (const struct ast_channel *chan)
void	ast_channel_monitor_set (struct ast_channel *chan, struct ast_channel_monitor *value)
int	ast_channel_move (struct ast_channel *dest, struct ast_channel *source)
	Move a channel from its current location to a new location. More...
void *	ast_channel_music_state (const struct ast_channel *chan)
void	ast_channel_music_state_set (struct ast_channel *chan, void *value)
const char *	ast_channel_musicclass (const struct ast_channel *chan)
const char *	ast_channel_name (const struct ast_channel *chan)
void	ast_channel_name_set (struct ast_channel *chan, const char *name)
	Set the channel name. More...
void	ast_channel_name_to_dial_string (char *channel_name)
	Removes the trailing identifiers from a channel name string. More...
struct ast_namedgroups *	ast_channel_named_callgroups (const struct ast_channel *chan)
void	ast_channel_named_callgroups_set (struct ast_channel *chan, struct ast_namedgroups *value)
struct ast_namedgroups *	ast_channel_named_pickupgroups (const struct ast_channel *chan)
void	ast_channel_named_pickupgroups_set (struct ast_channel *chan, struct ast_namedgroups *value)
struct ast_format_cap *	ast_channel_nativeformats (const struct ast_channel *chan)
void	ast_channel_nativeformats_set (struct ast_channel *chan, struct ast_format_cap *value)
const char *	ast_channel_oldest_linkedid (const char *a, const char *b)
	Return the oldest linkedid between two channels. More...
struct ast_format *	ast_channel_oldwriteformat (struct ast_channel *chan)
unsigned long	ast_channel_outsmpl (const struct ast_channel *chan)
void	ast_channel_outsmpl_set (struct ast_channel *chan, unsigned long value)
const char *	ast_channel_parkinglot (const struct ast_channel *chan)
struct ast_pbx *	ast_channel_pbx (const struct ast_channel *chan)
void	ast_channel_pbx_set (struct ast_channel *chan, struct ast_pbx *value)
const char *	ast_channel_peeraccount (const struct ast_channel *chan)
ast_group_t	ast_channel_pickupgroup (const struct ast_channel *chan)
void	ast_channel_pickupgroup_set (struct ast_channel *chan, ast_group_t value)
int	ast_channel_priority (const struct ast_channel *chan)
void	ast_channel_priority_set (struct ast_channel *chan, int value)
int	ast_channel_queryoption (struct ast_channel *channel, int option, void *data, int *datalen, int block)
	Checks the value of an option. More...
void	ast_channel_queue_connected_line_update (struct ast_channel *chan, const struct ast_party_connected_line *connected, const struct ast_set_party_connected_line *update)
	Queue a connected line update frame on a channel. More...
void	ast_channel_queue_redirecting_update (struct ast_channel *chan, const struct ast_party_redirecting *redirecting, const struct ast_set_party_redirecting *update)
	Queue a redirecting update frame on a channel. More...
struct ast_format *	ast_channel_rawreadformat (struct ast_channel *chan)
struct ast_format *	ast_channel_rawwriteformat (struct ast_channel *chan)
struct ast_format *	ast_channel_readformat (struct ast_channel *chan)
struct ast_readq_list *	ast_channel_readq (struct ast_channel *chan)
struct ast_trans_pvt *	ast_channel_readtrans (const struct ast_channel *chan)
void	ast_channel_readtrans_set (struct ast_channel *chan, struct ast_trans_pvt *value)
const char *	ast_channel_reason2str (int reason)
	return an english explanation of the code returned thru __ast_request_and_dial's 'outstate' argument More...
struct ast_party_redirecting *	ast_channel_redirecting (struct ast_channel *chan)
struct ast_party_id	ast_channel_redirecting_effective_from (struct ast_channel *chan)
struct ast_party_id	ast_channel_redirecting_effective_orig (struct ast_channel *chan)
struct ast_party_id	ast_channel_redirecting_effective_to (struct ast_channel *chan)
int	ast_channel_redirecting_macro (struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const void *redirecting_info, int is_caller, int is_frame)
	Run a redirecting interception macro and update a channel's redirecting information. More...
void	ast_channel_redirecting_set (struct ast_channel *chan, struct ast_party_redirecting *value)
int	ast_channel_redirecting_sub (struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const void *redirecting_info, int is_frame)
	Run a redirecting interception subroutine and update a channel's redirecting information. More...
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. More...
struct ast_channel *	ast_channel_release (struct ast_channel *chan)
	Unlink and release reference to a channel. More...
void	ast_channel_req_accountcodes (struct ast_channel *chan, const struct ast_channel *requestor, enum ast_channel_requestor_relationship relationship)
	Setup new channel accountcodes from the requestor channel after ast_request(). More...
void	ast_channel_req_accountcodes_precious (struct ast_channel *chan, const struct ast_channel *requestor, enum ast_channel_requestor_relationship relationship)
	Setup new channel accountcodes from the requestor channel after ast_request(). More...
int	ast_channel_request_stream_topology_change (struct ast_channel *chan, struct ast_stream_topology *topology, void *change_source)
	Request that the stream topology of a channel change. More...
int	ast_channel_rings (const struct ast_channel *chan)
void	ast_channel_rings_set (struct ast_channel *chan, int value)
struct ast_sched_context *	ast_channel_sched (const struct ast_channel *chan)
void	ast_channel_sched_set (struct ast_channel *chan, struct ast_sched_context *value)
int	ast_channel_sendhtml (struct ast_channel *channel, int subclass, const char *data, int datalen)
	Sends HTML on given channel Send HTML or URL on link. More...
char	ast_channel_sending_dtmf_digit (const struct ast_channel *chan)
void	ast_channel_sending_dtmf_digit_set (struct ast_channel *chan, char value)
struct timeval	ast_channel_sending_dtmf_tv (const struct ast_channel *chan)
void	ast_channel_sending_dtmf_tv_set (struct ast_channel *chan, struct timeval value)
int	ast_channel_sendurl (struct ast_channel *channel, const char *url)
	Sends a URL on a given link Send URL on link. More...
void	ast_channel_set_ari_vars (size_t varc, char **vars)
	Sets the variables to be stored in the ari_vars field of all snapshots. More...
void	ast_channel_set_caller (struct ast_channel *chan, const struct ast_party_caller *caller, const struct ast_set_party_caller *update)
	Set the caller id information in the Asterisk channel. More...
void	ast_channel_set_caller_event (struct ast_channel *chan, const struct ast_party_caller *caller, const struct ast_set_party_caller *update)
	Set the caller id information in the Asterisk channel and generate an AMI event if the caller id name or number changed. More...
void	ast_channel_set_connected_line (struct ast_channel *chan, const struct ast_party_connected_line *connected, const struct ast_set_party_connected_line *update)
	Set the connected line information in the Asterisk channel. More...
void	ast_channel_set_fd (struct ast_channel *chan, int which, int fd)
void	ast_channel_set_flag (struct ast_channel *chan, unsigned int flag)
	Set a flag on a channel. More...
void	ast_channel_set_is_t38_active (struct ast_channel *chan, int is_t38_active)
	Sets the is_t38_active flag. More...
void	ast_channel_set_is_t38_active_nolock (struct ast_channel *chan, int is_t38_active)
	Variant of ast_channel_set_is_t38_active. Use this if the channel is already locked prior to calling. More...
void	ast_channel_set_manager_vars (size_t varc, char **vars)
	Sets the variables to be stored in the manager_vars field of all snapshots. More...
void	ast_channel_set_oldwriteformat (struct ast_channel *chan, struct ast_format *format)
void	ast_channel_set_rawreadformat (struct ast_channel *chan, struct ast_format *format)
void	ast_channel_set_rawwriteformat (struct ast_channel *chan, struct ast_format *format)
void	ast_channel_set_readformat (struct ast_channel *chan, struct ast_format *format)
void	ast_channel_set_redirecting (struct ast_channel *chan, const struct ast_party_redirecting *redirecting, const struct ast_set_party_redirecting *update)
	Set the redirecting id information in the Asterisk channel. More...
struct ast_stream_topology *	ast_channel_set_stream_topology (struct ast_channel *chan, struct ast_stream_topology *topology)
	Set the topology of streams on a channel. More...
void	ast_channel_set_unbridged (struct ast_channel *chan, int value)
	Sets the unbridged flag and queues a NULL frame on the channel to trigger a check by bridge_channel_wait. More...
void	ast_channel_set_unbridged_nolock (struct ast_channel *chan, int value)
	Variant of ast_channel_set_unbridged. Use this if the channel is already locked prior to calling. More...
void	ast_channel_set_writeformat (struct ast_channel *chan, struct ast_format *format)
int	ast_channel_setoption (struct ast_channel *channel, int option, void *data, int datalen, int block)
	Sets an option on a channel. More...
void	ast_channel_setwhentohangup_tv (struct ast_channel *chan, struct timeval offset)
	Set when to hang a channel up. More...
struct ast_channel_snapshot *	ast_channel_snapshot (const struct ast_channel *chan)
struct ast_flags *	ast_channel_snapshot_segment_flags (struct ast_channel *chan)
void	ast_channel_snapshot_set (struct ast_channel *chan, struct ast_channel_snapshot *snapshot)
int	ast_channel_softhangup_internal_flag (struct ast_channel *chan)
void	ast_channel_softhangup_internal_flag_add (struct ast_channel *chan, int value)
void	ast_channel_softhangup_internal_flag_clear (struct ast_channel *chan, int value)
void	ast_channel_softhangup_internal_flag_set (struct ast_channel *chan, int value)
void	ast_channel_softhangup_withcause_locked (struct ast_channel *chan, int causecode)
	Lock the given channel, then request softhangup on the channel with the given causecode. More...
struct ast_silence_generator *	ast_channel_start_silence_generator (struct ast_channel *chan)
	Starts a silence generator on the given channel. More...
enum ast_channel_state	ast_channel_state (const struct ast_channel *chan)
void	ast_channel_state_set (struct ast_channel *chan, enum ast_channel_state)
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. More...
struct ast_filestream *	ast_channel_stream (const struct ast_channel *chan)
void	ast_channel_stream_set (struct ast_channel *chan, struct ast_filestream *value)
int	ast_channel_stream_topology_changed (struct ast_channel *chan, struct ast_stream_topology *topology)
	Provide notice to a channel that the stream topology has changed. More...
int	ast_channel_stream_topology_changed_externally (struct ast_channel *chan)
	Provide notice from a channel that the topology has changed on it as a result of the remote party renegotiating. More...
int	ast_channel_streamid (const struct ast_channel *chan)
void	ast_channel_streamid_set (struct ast_channel *chan, int value)
enum ama_flags	ast_channel_string2amaflag (const char *flag)
	Convert a string to a detail record AMA flag. More...
int	ast_channel_supports_html (struct ast_channel *channel)
	Checks for HTML support on a channel. More...
int	ast_channel_suppress (struct ast_channel *chan, unsigned int direction, enum ast_frame_type frametype)
	Suppress passing of a frame type on a channel. More...
const struct ast_channel_tech *	ast_channel_tech (const struct ast_channel *chan)
void *	ast_channel_tech_pvt (const struct ast_channel *chan)
void	ast_channel_tech_pvt_set (struct ast_channel *chan, void *value)
void	ast_channel_tech_set (struct ast_channel *chan, const struct ast_channel_tech *value)
struct ast_timer *	ast_channel_timer (const struct ast_channel *chan)
void	ast_channel_timer_set (struct ast_channel *chan, struct ast_timer *value)
void *	ast_channel_timingdata (const struct ast_channel *chan)
void	ast_channel_timingdata_set (struct ast_channel *chan, void *value)
int	ast_channel_timingfd (const struct ast_channel *chan)
void	ast_channel_timingfd_set (struct ast_channel *chan, int value)
ast_timing_func_t	ast_channel_timingfunc (const struct ast_channel *chan)
void	ast_channel_timingfunc_set (struct ast_channel *chan, ast_timing_func_t value)
struct stasis_topic *	ast_channel_topic (struct ast_channel *chan)
	A topic which publishes the events for a particular channel. More...
unsigned short	ast_channel_transfercapability (const struct ast_channel *chan)
void	ast_channel_transfercapability_set (struct ast_channel *chan, unsigned short value)
int	ast_channel_unbridged (struct ast_channel *chan)
	This function will check if the bridge needs to be re-evaluated due to external changes. More...
int	ast_channel_unbridged_nolock (struct ast_channel *chan)
	ast_channel_unbridged variant. Use this if the channel is already locked prior to calling. More...
void	ast_channel_undefer_dtmf (struct ast_channel *chan)
	Unset defer DTMF flag on channel. More...
const char *	ast_channel_uniqueid (const struct ast_channel *chan)
void	ast_channel_unlink (struct ast_channel *chan)
	Remove a channel from the global channels container. More...
void	ast_channel_unregister (const struct ast_channel_tech *tech)
	Unregister a channel technology. More...
int	ast_channel_unsuppress (struct ast_channel *chan, unsigned int direction, enum ast_frame_type frametype)
	Stop suppressing of a frame type on a channel. More...
void	ast_channel_update_connected_line (struct ast_channel *chan, const struct ast_party_connected_line *connected, const struct ast_set_party_connected_line *update)
	Indicate that the connected line information has changed. More...
void	ast_channel_update_redirecting (struct ast_channel *chan, const struct ast_party_redirecting *redirecting, const struct ast_set_party_redirecting *update)
	Indicate that the redirecting id has changed. More...
const char *	ast_channel_userfield (const struct ast_channel *chan)
struct varshead *	ast_channel_varshead (struct ast_channel *chan)
void	ast_channel_varshead_set (struct ast_channel *chan, struct varshead *value)
int	ast_channel_visible_indication (const struct ast_channel *chan)
void	ast_channel_visible_indication_set (struct ast_channel *chan, int value)
struct ast_filestream *	ast_channel_vstream (const struct ast_channel *chan)
void	ast_channel_vstream_set (struct ast_channel *chan, struct ast_filestream *value)
int	ast_channel_vstreamid (const struct ast_channel *chan)
void	ast_channel_vstreamid_set (struct ast_channel *chan, int value)
struct timeval *	ast_channel_whentohangup (struct ast_channel *chan)
void	ast_channel_whentohangup_set (struct ast_channel *chan, struct timeval *value)
struct ast_format *	ast_channel_writeformat (struct ast_channel *chan)
struct ast_trans_pvt *	ast_channel_writetrans (const struct ast_channel *chan)
void	ast_channel_writetrans_set (struct ast_channel *chan, struct ast_trans_pvt *value)
struct ast_channel *	ast_channel_yank (struct ast_channel *yankee)
	Gain control of a channel in the system. More...
struct ast_tone_zone *	ast_channel_zone (const struct ast_channel *chan)
void	ast_channel_zone_set (struct ast_channel *chan, struct ast_tone_zone *value)
struct ast_variable *	ast_channeltype_list (void)
	return an ast_variable list of channeltypes More...
int	ast_check_hangup (struct ast_channel *chan)
	Check to see if a channel is needing hang up. More...
int	ast_check_hangup_locked (struct ast_channel *chan)
int	ast_connected_line_build_data (unsigned char *data, size_t datalen, const struct ast_party_connected_line *connected, const struct ast_set_party_connected_line *update)
	Build the connected line information data frame. More...
void	ast_connected_line_copy_from_caller (struct ast_party_connected_line *dest, const struct ast_party_caller *src)
	Copy the caller information to the connected line information. More...
void	ast_connected_line_copy_to_caller (struct ast_party_caller *dest, const struct ast_party_connected_line *src)
	Copy the connected line information to the caller information. More...
int	ast_connected_line_parse_data (const unsigned char *data, size_t datalen, struct ast_party_connected_line *connected)
	Parse connected line indication frame data. More...
void	ast_deactivate_generator (struct ast_channel *chan)
static int	ast_fdisset (struct pollfd *pfds, int fd, int maximum, int *start)
	Helper function for migrating select to poll. More...
const struct ast_channel_tech *	ast_get_channel_tech (const char *name)
	Get a channel technology structure by name. More...
ast_group_t	ast_get_group (const char *s)
struct ast_namedgroups *	ast_get_namedgroups (const char *s)
	Create an ast_namedgroups set with group names from comma separated string. More...
void	ast_hangup (struct ast_channel *chan)
	Hang up a channel. More...
int	ast_indicate (struct ast_channel *chan, int condition)
	Indicates condition of channel. More...
int	ast_indicate_data (struct ast_channel *chan, int condition, const void *data, size_t datalen)
	Indicates condition of channel, with payload. More...
int	ast_is_deferrable_frame (const struct ast_frame *frame)
	Should we keep this frame for later? More...
int	ast_namedgroups_intersect (struct ast_namedgroups *a, struct ast_namedgroups *b)
	Return TRUE if group a and b contain at least one common groupname. More...
void	ast_party_caller_copy (struct ast_party_caller *dest, const struct ast_party_caller *src)
	Copy the source caller information to the destination caller. More...
void	ast_party_caller_free (struct ast_party_caller *doomed)
	Destroy the caller party contents. More...
void	ast_party_caller_init (struct ast_party_caller *init)
	Initialize the given caller structure. More...
void	ast_party_caller_set (struct ast_party_caller *dest, const struct ast_party_caller *src, const struct ast_set_party_caller *update)
	Set the caller information based on another caller source. More...
void	ast_party_caller_set_init (struct ast_party_caller *init, const struct ast_party_caller *guide)
	Initialize the given caller structure using the given guide for a set update operation. More...
void	ast_party_connected_line_collect_caller (struct ast_party_connected_line *connected, struct ast_party_caller *caller)
	Collect the caller party information into a connected line structure. More...
void	ast_party_connected_line_copy (struct ast_party_connected_line *dest, const struct ast_party_connected_line *src)
	Copy the source connected line information to the destination connected line. More...
void	ast_party_connected_line_free (struct ast_party_connected_line *doomed)
	Destroy the connected line information contents. More...
void	ast_party_connected_line_init (struct ast_party_connected_line *init)
	Initialize the given connected line structure. More...
void	ast_party_connected_line_set (struct ast_party_connected_line *dest, const struct ast_party_connected_line *src, const struct ast_set_party_connected_line *update)
	Set the connected line information based on another connected line source. More...
void	ast_party_connected_line_set_init (struct ast_party_connected_line *init, const struct ast_party_connected_line *guide)
	Initialize the given connected line structure using the given guide for a set update operation. More...
void	ast_party_dialed_copy (struct ast_party_dialed *dest, const struct ast_party_dialed *src)
	Copy the source dialed party information to the destination dialed party. More...
void	ast_party_dialed_free (struct ast_party_dialed *doomed)
	Destroy the dialed party contents. More...
void	ast_party_dialed_init (struct ast_party_dialed *init)
	Initialize the given dialed structure. More...
void	ast_party_dialed_set (struct ast_party_dialed *dest, const struct ast_party_dialed *src)
	Set the dialed information based on another dialed source. More...
void	ast_party_dialed_set_init (struct ast_party_dialed *init, const struct ast_party_dialed *guide)
	Initialize the given dialed structure using the given guide for a set update operation. More...
void	ast_party_id_copy (struct ast_party_id *dest, const struct ast_party_id *src)
	Copy the source party id information to the destination party id. More...
void	ast_party_id_free (struct ast_party_id *doomed)
	Destroy the party id contents. More...
void	ast_party_id_init (struct ast_party_id *init)
	Initialize the given party id structure. More...
void	ast_party_id_invalidate (struct ast_party_id *id)
	Invalidate all components of the given party id. More...
struct ast_party_id	ast_party_id_merge (struct ast_party_id *base, struct ast_party_id *overlay)
	Merge a given party id into another given party id. More...
void	ast_party_id_merge_copy (struct ast_party_id *dest, struct ast_party_id *base, struct ast_party_id *overlay)
	Copy a merge of a given party id into another given party id to a given destination party id. More...
int	ast_party_id_presentation (const struct ast_party_id *id)
	Determine the overall presentation value for the given party. More...
void	ast_party_id_reset (struct ast_party_id *id)
	Destroy and initialize the given party id structure. More...
void	ast_party_id_set (struct ast_party_id *dest, const struct ast_party_id *src, const struct ast_set_party_id *update)
	Set the source party id information into the destination party id. More...
void	ast_party_id_set_init (struct ast_party_id *init, const struct ast_party_id *guide)
	Initialize the given party id structure using the given guide for a set update operation. More...
void	ast_party_name_copy (struct ast_party_name *dest, const struct ast_party_name *src)
	Copy the source party name information to the destination party name. More...
void	ast_party_name_free (struct ast_party_name *doomed)
	Destroy the party name contents. More...
void	ast_party_name_init (struct ast_party_name *init)
	Initialize the given name structure. More...
void	ast_party_name_set (struct ast_party_name *dest, const struct ast_party_name *src)
	Set the source party name information into the destination party name. More...
void	ast_party_name_set_init (struct ast_party_name *init, const struct ast_party_name *guide)
	Initialize the given party name structure using the given guide for a set update operation. More...
void	ast_party_number_copy (struct ast_party_number *dest, const struct ast_party_number *src)
	Copy the source party number information to the destination party number. More...
void	ast_party_number_free (struct ast_party_number *doomed)
	Destroy the party number contents. More...
void	ast_party_number_init (struct ast_party_number *init)
	Initialize the given number structure. More...
void	ast_party_number_set (struct ast_party_number *dest, const struct ast_party_number *src)
	Set the source party number information into the destination party number. More...
void	ast_party_number_set_init (struct ast_party_number *init, const struct ast_party_number *guide)
	Initialize the given party number structure using the given guide for a set update operation. More...
void	ast_party_redirecting_copy (struct ast_party_redirecting *dest, const struct ast_party_redirecting *src)
	Copy the source redirecting information to the destination redirecting. More...
void	ast_party_redirecting_free (struct ast_party_redirecting *doomed)
	Destroy the redirecting information contents. More...
void	ast_party_redirecting_init (struct ast_party_redirecting *init)
	Initialize the given redirecting structure. More...
void	ast_party_redirecting_reason_copy (struct ast_party_redirecting_reason *dest, const struct ast_party_redirecting_reason *src)
	Copy the source redirecting reason information to the destination redirecting reason. More...
void	ast_party_redirecting_reason_free (struct ast_party_redirecting_reason *doomed)
	Destroy the redirecting reason contents. More...
void	ast_party_redirecting_reason_init (struct ast_party_redirecting_reason *init)
	Initialize the given redirecting reason structure. More...
void	ast_party_redirecting_reason_set (struct ast_party_redirecting_reason *dest, const struct ast_party_redirecting_reason *src)
	Set the redirecting reason information based on another redirecting reason source. More...
void	ast_party_redirecting_reason_set_init (struct ast_party_redirecting_reason *init, const struct ast_party_redirecting_reason *guide)
	Initialize the given redirecting reason structure using the given guide for a set update operation. More...
void	ast_party_redirecting_set (struct ast_party_redirecting *dest, const struct ast_party_redirecting *src, const struct ast_set_party_redirecting *update)
	Set the redirecting information based on another redirecting source. More...
void	ast_party_redirecting_set_init (struct ast_party_redirecting *init, const struct ast_party_redirecting *guide)
	Initialize the given redirecting id structure using the given guide for a set update operation. More...
void	ast_party_subaddress_copy (struct ast_party_subaddress *dest, const struct ast_party_subaddress *src)
	Copy the source party subaddress information to the destination party subaddress. More...
void	ast_party_subaddress_free (struct ast_party_subaddress *doomed)
	Destroy the party subaddress contents. More...
void	ast_party_subaddress_init (struct ast_party_subaddress *init)
	Initialize the given subaddress structure. More...
void	ast_party_subaddress_set (struct ast_party_subaddress *dest, const struct ast_party_subaddress *src)
	Set the source party subaddress information into the destination party subaddress. More...
void	ast_party_subaddress_set_init (struct ast_party_subaddress *init, const struct ast_party_subaddress *guide)
	Initialize the given party subaddress structure using the given guide for a set update operation. More...
int	ast_pre_call (struct ast_channel *chan, const char *sub_args)
	Execute a Gosub call on the channel before a call is placed. More...
char *	ast_print_group (char *buf, int buflen, ast_group_t group)
	Print call and pickup groups into buffer. More...
char *	ast_print_namedgroups (struct ast_str **buf, struct ast_namedgroups *groups)
	Print named call groups and named pickup groups. More...
int	ast_prod (struct ast_channel *chan)
	Send empty audio to prime a channel driver. More...
int	ast_queue_answer (struct ast_channel *chan, const struct ast_stream_topology *topology)
	Queue an ANSWER control frame with topology. More...
int	ast_queue_control (struct ast_channel *chan, enum ast_control_frame_type control)
	Queue a control frame without payload. More...
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. More...
int	ast_queue_frame (struct ast_channel *chan, struct ast_frame *f)
	Queue one or more frames to a channel's frame queue. More...
int	ast_queue_frame_head (struct ast_channel *chan, struct ast_frame *f)
	Queue one or more frames to the head of a channel's frame queue. More...
int	ast_queue_hangup (struct ast_channel *chan)
	Queue a hangup frame. More...
int	ast_queue_hangup_with_cause (struct ast_channel *chan, int cause)
	Queue a hangup frame with hangupcause set. More...
int	ast_queue_hold (struct ast_channel *chan, const char *musicclass)
	Queue a hold frame. More...
int	ast_queue_unhold (struct ast_channel *chan)
	Queue an unhold frame. More...
int	ast_raw_answer (struct ast_channel *chan)
	Answer a channel. More...
int	ast_raw_answer_with_stream_topology (struct ast_channel *chan, struct ast_stream_topology *topology)
	Answer a channel passing in a stream topology. More...
struct ast_frame *	ast_read (struct ast_channel *chan)
	Reads a frame. More...
struct ast_frame *	ast_read_noaudio (struct ast_channel *chan)
	Reads a frame, returning AST_FRAME_NULL frame if audio. More...
struct ast_frame *	ast_read_stream (struct ast_channel *chan)
	Reads a frame, but does not filter to just the default streams. More...
struct ast_frame *	ast_read_stream_noaudio (struct ast_channel *chan)
	Reads a frame, but does not filter to just the default streams, returning AST_FRAME_NULL frame if audio. More...
int	ast_readstring (struct ast_channel *c, char *s, int len, int timeout, int rtimeout, char *enders)
	Reads multiple digits. More...
int	ast_readstring_full (struct ast_channel *c, char *s, int len, int timeout, int rtimeout, char *enders, int audiofd, int ctrlfd)
int	ast_recvchar (struct ast_channel *chan, int timeout)
	Receives a text character from a channel. More...
char *	ast_recvtext (struct ast_channel *chan, int timeout)
	Receives a text string from a channel Read a string of text from a channel. More...
int	ast_redirecting_build_data (unsigned char *data, size_t datalen, const struct ast_party_redirecting *redirecting, const struct ast_set_party_redirecting *update)
	Build the redirecting id data frame. More...
int	ast_redirecting_parse_data (const unsigned char *data, size_t datalen, struct ast_party_redirecting *redirecting)
	Parse redirecting indication frame data. More...
struct ast_namedgroups *	ast_ref_namedgroups (struct ast_namedgroups *groups)
struct ast_channel *	ast_request (const char *type, struct ast_format_cap *request_cap, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *addr, int *cause)
	Requests a channel. More...
struct ast_channel *	ast_request_and_dial (const char *type, struct ast_format_cap *cap, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *addr, int timeout, int *reason, const char *cid_num, const char *cid_name)
	Request a channel of a given type, with data as optional information used by the low level module and attempt to place a call on it. More...
struct ast_channel *	ast_request_with_stream_topology (const char *type, struct ast_stream_topology *topology, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *addr, int *cause)
	Requests a channel (specifying stream topology) More...
int	ast_safe_sleep (struct ast_channel *chan, int ms)
	Wait for a specified amount of time, looking for hangups. More...
int	ast_safe_sleep_conditional (struct ast_channel *chan, int ms, int(*cond)(void *), void *data)
	Wait for a specified amount of time, looking for hangups and a condition argument. More...
int	ast_safe_sleep_without_silence (struct ast_channel *chan, int ms)
	Wait for a specified amount of time, looking for hangups, and do not generate silence. More...
int	ast_senddigit (struct ast_channel *chan, char digit, unsigned int duration)
	Send a DTMF digit to a channel. More...
int	ast_senddigit_begin (struct ast_channel *chan, char digit)
	Send a DTMF digit to a channel. More...
int	ast_senddigit_end (struct ast_channel *chan, char digit, unsigned int duration)
	Send a DTMF digit to a channel. More...
int	ast_senddigit_external (struct ast_channel *chan, char digit, unsigned int duration)
	Send a DTMF digit to a channel from an external thread. More...
int	ast_senddigit_mf (struct ast_channel *chan, char digit, unsigned int duration, unsigned int durationkp, unsigned int durationst, int is_external)
	Send an MF digit to a channel. More...
int	ast_senddigit_mf_begin (struct ast_channel *chan, char digit)
	Send an MF digit to a channel. More...
int	ast_senddigit_mf_end (struct ast_channel *chan)
	End sending an MF digit to a channel. More...
int	ast_sendtext (struct ast_channel *chan, const char *text)
	Sends text to a channel. More...
int	ast_sendtext_data (struct ast_channel *chan, struct ast_msg_data *msg)
	Sends text to a channel in an ast_msg_data structure wrapper with ast_sendtext as fallback. More...
void	ast_set_callerid (struct ast_channel *chan, const char *cid_num, const char *cid_name, const char *cid_ani)
	Set caller ID number, name and ANI and generate AMI event. More...
void	ast_set_hangupsource (struct ast_channel *chan, const char *source, int force)
	Set the source of the hangup in this channel and it's bridge. More...
void	ast_set_party_id_all (struct ast_set_party_id *update_id)
	Set the update marker to update all information of a corresponding party id. More...
int	ast_set_read_format (struct ast_channel *chan, struct ast_format *format)
	Sets read format on channel chan. More...
int	ast_set_read_format_from_cap (struct ast_channel *chan, struct ast_format_cap *formats)
	Sets read format on channel chan from capabilities Set read format for channel to whichever component of "format" is best. More...
int	ast_set_read_format_path (struct ast_channel *chan, struct ast_format *raw_format, struct ast_format *core_format)
	Set specific read path on channel. More...
void	ast_set_variables (struct ast_channel *chan, struct ast_variable *vars)
	adds a list of channel variables to a channel More...
int	ast_set_write_format (struct ast_channel *chan, struct ast_format *format)
	Sets write format on channel chan. More...
int	ast_set_write_format_from_cap (struct ast_channel *chan, struct ast_format_cap *formats)
	Sets write format on channel chan Set write format for channel to whichever component of "format" is best. More...
int	ast_set_write_format_interleaved_stereo (struct ast_channel *chan, struct ast_format *format)
	Sets write format for a channel. All internal data will than be handled in an interleaved format. (needed by binaural opus) More...
int	ast_set_write_format_path (struct ast_channel *chan, struct ast_format *core_format, struct ast_format *raw_format)
	Set specific write path on channel. More...
int	ast_settimeout (struct ast_channel *c, unsigned int rate, int(*func)(const void *data), void *data)
	Enable or disable timer ticks for a channel. More...
int	ast_settimeout_full (struct ast_channel *c, unsigned int rate, int(*func)(const void *data), void *data, unsigned int is_ao2_obj)
int	ast_softhangup (struct ast_channel *chan, int reason)
	Softly hangup up a channel. More...
void	ast_softhangup_all (void)
	Soft hangup all active channels. More...
int	ast_softhangup_nolock (struct ast_channel *chan, int reason)
	Softly hangup up a channel (no channel lock) More...
const char *	ast_state2str (enum ast_channel_state)
	Gives the string form of a given channel state. More...
int	ast_str2cause (const char *name) attribute_pure
	Convert the string form of a cause code to a number. More...
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). More...
int	ast_transfer_protocol (struct ast_channel *chan, char *dest, int *protocol)
	Transfer a channel (if supported) receieve protocol result. More...
char *	ast_transfercapability2str (int transfercapability) attribute_const
	Gives the string form of a given transfer capability. More...
int	ast_undestroyed_channels (void)
struct ast_namedgroups *	ast_unref_namedgroups (struct ast_namedgroups *groups)
int	ast_waitfor (struct ast_channel *chan, int ms)
	Wait for input on a channel. More...
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. More...
int	ast_waitfor_n_fd (int *fds, int n, int *ms, int *exception)
	Waits for input on an fd. More...
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. More...
int	ast_waitfordigit (struct ast_channel *c, int ms)
	Waits for a digit. More...
int	ast_waitfordigit_full (struct ast_channel *c, int ms, const char *breakon, 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. More...
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. More...
int	ast_write_stream (struct ast_channel *chan, int stream_num, struct ast_frame *frame)
	Write a frame to a stream This function writes the given frame to the indicated stream on the channel. More...
int	ast_write_text (struct ast_channel *chan, struct ast_frame *frame)
	Write text frame to a channel This function writes the given frame to the indicated channel. More...
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. More...
	DECLARE_STRINGFIELD_SETTERS_FOR (name)
	DECLARE_STRINGFIELD_SETTERS_FOR (language)
	DECLARE_STRINGFIELD_SETTERS_FOR (musicclass)
	DECLARE_STRINGFIELD_SETTERS_FOR (latest_musicclass)
	DECLARE_STRINGFIELD_SETTERS_FOR (accountcode)
	DECLARE_STRINGFIELD_SETTERS_FOR (peeraccount)
	DECLARE_STRINGFIELD_SETTERS_FOR (userfield)
	DECLARE_STRINGFIELD_SETTERS_FOR (call_forward)
	DECLARE_STRINGFIELD_SETTERS_FOR (uniqueid)
	DECLARE_STRINGFIELD_SETTERS_FOR (linkedid)
	DECLARE_STRINGFIELD_SETTERS_FOR (parkinglot)
	DECLARE_STRINGFIELD_SETTERS_FOR (hangupsource)
	DECLARE_STRINGFIELD_SETTERS_FOR (dialcontext)
struct ast_channel_iterator *	ast_channel_iterator_destroy (struct ast_channel_iterator *i)
	Destroy a channel iterator. More...
struct ast_channel_iterator *	ast_channel_iterator_by_exten_new (const char *exten, const char *context)
	Create a new channel iterator based on extension. More...
struct ast_channel_iterator *	ast_channel_iterator_by_name_new (const char *name, size_t name_len)
	Create a new channel iterator based on name. More...
struct ast_channel_iterator *	ast_channel_iterator_all_new (void)
	Create a new channel iterator. More...
struct ast_channel *	ast_channel_iterator_next (struct ast_channel_iterator *i)
	Get the next channel for a channel iterator. More...
struct ast_channel *	ast_channel_get_by_name (const char *name)
	Find a channel by name. More...
struct ast_channel *	ast_channel_get_by_name_prefix (const char *name, size_t name_len)
	Find a channel by a name prefix. More...
struct ast_channel *	ast_channel_get_by_exten (const char *exten, const char *context)
	Find a channel by extension and context. More...

Variables
const struct ast_channel_tech	ast_kill_tech
	Kill the channel channel driver technology descriptor. More...
static const char	ast_stream_topology_changed_external [] = "external"
	Set as the change source reason when a channel stream topology has been changed externally as a result of the remote side renegotiating. More...
unsigned long	global_fin
unsigned long	global_fout

Detailed Description

General Asterisk PBX channel definitions.

See also:

• Asterisk Channels
• Module: Asterisk Channel Drivers

Definition in file channel.h.

Macro Definition Documentation

AST_AGENT_FD

#define AST_AGENT_FD   (AST_MAX_FDS-3)

used by agents for pass through

Definition at line 203 of file channel.h.

AST_ALERT_FD

#define AST_ALERT_FD   (AST_MAX_FDS-1)

used for alertpipe

Definition at line 201 of file channel.h.

Referenced by __ast_channel_alloc_ap().

AST_BRIDGE_DTMF_CHANNEL_0

#define AST_BRIDGE_DTMF_CHANNEL_0   (1 << 0)

Report DTMF on channel 0.

Definition at line 2382 of file channel.h.

Referenced by iax2_key_rotate(), misdn_write(), and set_config_flags().

AST_BRIDGE_DTMF_CHANNEL_1

#define AST_BRIDGE_DTMF_CHANNEL_1   (1 << 1)

Report DTMF on channel 1.

Definition at line 2384 of file channel.h.

Referenced by iax2_key_rotate(), misdn_write(), and set_config_flags().

AST_CHAN_WRITE_INFO_T_VERSION

#define AST_CHAN_WRITE_INFO_T_VERSION   1

ast_chan_write_info_t version. Must be incremented if structure is changed

Definition at line 592 of file channel.h.

Referenced by ast_unreal_setoption(), and func_channel_write().

ast_channel_alloc

#define ast_channel_alloc	(		needqueue,
			state,
			cid_num,
			cid_name,
			acctcode,
			exten,
			context,
			assignedids,
			requestor,
			amaflag,
			...
	)

Value:

__ast_channel_alloc(needqueue, state, cid_num, cid_name, acctcode, exten, context, assignedids, requestor, amaflag, NULL, \
 __FILE__, __LINE__, __FUNCTION__, __VA_ARGS__)

Create a channel structure.

Return values

NULL	failure
non-NULL	successfully allocated channel

Note

Absolutely NO channel locks should be held before calling this function.

By default, new channels are set to the "s" extension and "default" context.

Since 12.0.0 this function returns with the newly created channel locked.

Definition at line 1259 of file channel.h.

Referenced by alsa_new(), ast_channel_yank(), ast_iax2_new(), ast_pbx_outgoing_exten_predial(), AST_TEST_DEFINE(), ast_unreal_new_channels(), audiosocket_request(), console_new(), create_alice_channel(), create_msg_q_chan(), dahdi_new(), do_notify(), make_channel(), mbl_new(), mgcp_new(), misdn_new(), multicast_rtp_request(), nbs_new(), ooh323_new(), oss_new(), phone_new(), rec_request(), sip_new(), skinny_new(), stasis_app_control_snoop(), test_vm_api_create_mock_channel(), unicast_rtp_request(), unistim_new(), and wait_for_digits().

ast_channel_alloc_with_endpoint

#define ast_channel_alloc_with_endpoint	(		needqueue,
			state,
			cid_num,
			cid_name,
			acctcode,
			exten,
			context,
			assignedids,
			requestor,
			amaflag,
			endpoint,
			...
	)

Value:

__ast_channel_alloc((needqueue), (state), (cid_num), (cid_name), (acctcode), (exten), (context), (assignedids), (requestor), (amaflag), (endpoint), \
 __FILE__, __LINE__, __FUNCTION__, __VA_ARGS__)

Definition at line 1263 of file channel.h.

Referenced by ast_iax2_new(), chan_pjsip_new(), jingle_new(), and sip_new().

ast_channel_cleanup

#define ast_channel_cleanup

(

c

)

({ ao2_cleanup(c); (struct ast_channel *) (NULL); })

Cleanup a channel reference.

Parameters

c	the channel (NULL tolerant)

Return values

NULL

always

Since

12.0.0

Definition at line 2992 of file channel.h.

Referenced by analog_ss_thread(), ari_channels_handle_originate_with_id(), ari_channels_handle_snoop_channel(), assign_uuid(), ast_ari_bridges_start_moh(), ast_ari_channels_create(), ast_ari_channels_dial(), ast_ari_channels_get_channel_var(), ast_ari_channels_originate(), ast_ari_channels_originate_with_id(), ast_ari_channels_rtpstatistics(), ast_bridge_transfer_blind(), ast_set_hangupsource(), async_playback_task_data_destroy(), attach_barge(), attended_transfer_properties_destructor(), blond_enter(), bridge_exec(), cb_events(), channel_cleanup_wrapper(), complete_enter(), control_dtor(), create_jb(), defer_bridge_add_dtor(), destroy_conference_bridge(), dial_target_free(), export_aoc_vars(), feature_automixmonitor(), feature_automonitor(), get_refer_info(), handle_request_bye(), handle_request_refer(), inherit_channel_vars_from_id(), manager_park(), mgcp_hangup(), my_get_sigpvt_bridged_channel(), parker_parked_call_message_response(), parking_blind_transfer_park(), prepare_bridge_media_channel(), refer_attended_destroy(), snoop_destroy(), and threeway_enter().

ast_channel_has_tech_function

#define ast_channel_has_tech_function	(		chan,
			function
	)		(ast_channel_tech(chan) ? ast_channel_tech(chan)->function != NULL : 0)

Checks if a channel's technology implements a particular callback function.

Since

18.0.0

Parameters

chan	The channel
function	The function to look for

Return values

1	if the channel has a technology set and it implements the function
0	if the channel doesn't have a technology set or it doesn't implement the function

Definition at line 5175 of file channel.h.

ast_channel_lock

#define ast_channel_lock

(

chan

)

ao2_lock(chan)

Definition at line 2945 of file channel.h.

Referenced by __after_bridge_set_goto(), __analog_handle_event(), __analog_ss_thread(), __ast_answer(), __ast_channel_alloc_ap(), __ast_pbx_run(), __ast_queue_frame(), __ast_read(), __ast_request_and_dial(), __dahdi_exception(), _if_exec(), _macro_exec(), _while_exec(), acf_cc_read(), acf_cc_write(), acf_curl_helper(), acf_faxopt_write(), acf_fetch(), acf_odbc_read(), action_add_agi_cmd(), action_atxfer(), action_bridge(), action_cancel_atxfer(), action_dialplan_exec(), action_redirect(), action_status(), action_timeout(), add_features_datastore(), add_to_agi(), after_bridge_goto_remove(), after_bridge_move_channel(), agent_bridge_channel_get_lock(), agent_lock_logged(), agent_login_channel_config(), agent_login_exec(), agent_logout(), agent_request_exec(), alloc_playback_chan(), analog_attempt_transfer(), analog_exception(), analog_ss_thread(), aoc_publish_blob(), app_control_dial(), app_control_mute(), app_control_unmute(), app_exec(), append_expected_event(), apply_negotiated_sdp_stream(), ari_channels_handle_originate_with_id(), ast_activate_generator(), ast_ari_channels_dial(), ast_ari_channels_rtpstatistics(), ast_async_goto(), ast_atomic_dec_and_test(), ast_audiohook_attach(), ast_audiohook_detach_source(), ast_audiohook_remove(), ast_audiohook_set_mute(), ast_autochan_setup(), ast_autoservice_start(), ast_autoservice_stop(), ast_bridge_add_channel(), ast_bridge_call_with_flags(), ast_bridge_channel_leave_bridge_nolock(), ast_bridge_channel_playfile(), ast_bridge_channel_restore_formats(), ast_bridge_channel_stream_map(), ast_bridge_channel_update_linkedids(), ast_bridge_depart(), ast_bridge_features_ds_get_string(), ast_bridge_features_ds_set_string(), ast_bridge_join(), ast_bridge_notify_masquerade(), ast_bridge_timelimit(), ast_bridge_transfer_acquire_bridge(), ast_bridge_transfer_attended(), ast_bridge_transfer_blind(), ast_call(), ast_call_forward(), ast_cc_agent_set_interfaces_chanvar(), ast_cc_call_init(), ast_cc_completed(), ast_cc_extension_monitor_add_dialstring(), ast_cc_get_current_core_id(), ast_cc_is_recall(), ast_cc_offer(), ast_change_name(), ast_channel_bridge_peer(), ast_channel_by_exten_cb(), ast_channel_by_name_cb(), ast_channel_by_uniqueid_cb(), ast_channel_clear_flag(), ast_channel_clear_softhangup(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_channel_defer_dtmf(), ast_channel_destructor(), ast_channel_end_dtmf(), ast_channel_is_t38_active(), ast_channel_publish_dial_forward(), ast_channel_publish_dial_internal(), ast_channel_queryoption(), ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), ast_channel_request_stream_topology_change(), ast_channel_set_caller(), ast_channel_set_caller_event(), ast_channel_set_connected_line(), ast_channel_set_flag(), ast_channel_set_is_t38_active(), ast_channel_set_redirecting(), ast_channel_set_unbridged(), ast_channel_setoption(), ast_channel_softhangup_withcause_locked(), ast_channel_stream_topology_changed_externally(), ast_channel_unbridged(), ast_channel_yank(), ast_check_hangup_locked(), ast_deactivate_generator(), ast_dial_join(), ast_do_pickup(), ast_eivr_getvariable(), ast_explicit_goto(), ast_handle_cc_control_frame(), ast_hangup(), ast_ignore_cc(), ast_indicate_data(), ast_jb_create_framehook(), ast_local_setup_bridge(), ast_local_setup_masquerade(), ast_odbc_retrieve_transaction_obj(), ast_openstream_full(), ast_openvstream(), ast_pbx_h_exten_run(), ast_pbx_hangup_handler_destroy(), ast_pbx_hangup_handler_pop(), ast_pbx_hangup_handler_push(), ast_pbx_hangup_handler_run(), ast_pbx_hangup_handler_show(), ast_pickup_call(), ast_pickup_find_by_group(), ast_pre_call(), ast_queue_hangup(), ast_queue_hangup_with_cause(), ast_queue_hold(), ast_queue_unhold(), ast_raw_answer_with_stream_topology(), ast_read_generator_actions(), ast_rtp_instance_make_compatible(), ast_rtp_instance_set_stats_vars(), ast_senddigit_begin(), ast_senddigit_end(), ast_sendtext_data(), ast_set_callerid(), ast_set_cc_interfaces_chanvar(), ast_set_hangupsource(), ast_settimeout_full(), ast_setup_cc_recall_datastore(), ast_softhangup(), ast_stir_shaken_add_verification(), ast_stopstream(), ast_str_retrieve_variable(), ast_streamfile(), AST_TEST_DEFINE(), ast_transfer_protocol(), ast_unreal_channel_push_to_bridge(), ast_unreal_hangup(), ast_unreal_indicate(), ast_unreal_lock_all(), ast_unreal_queryoption(), ast_unreal_setoption(), ast_var_channel_bridge(), ast_var_channels_table(), ast_waitfor_nandfds(), ast_write_stream(), async_play_sound_ready(), async_playback_task_data_alloc(), attach_framehook(), attempt_transfer(), attended_transfer_exec(), attended_transfer_monitor_thread(), attended_transfer_properties_alloc(), auth_exec(), begin_dial_channel(), begin_dial_prerun(), bridge_channel_change_bridge(), bridge_channel_depart(), bridge_channel_feature_digit_timeout(), bridge_channel_impart_add(), bridge_channel_impart_signal(), bridge_channel_ind_thread(), bridge_channel_internal_join(), bridge_channel_internal_queue_attended_transfer(), bridge_channel_internal_queue_blind_transfer(), bridge_channel_queue_deferred_frames(), bridge_check_monitor(), bridge_exec(), bridge_impart_internal(), bridge_move(), bridge_parking_push(), bridge_reconfigured_connected_line_update(), bridge_stasis_push_peek(), bridge_stasis_queue_join_action(), bridge_timeout(), bridgeadd_exec(), calendar_event_read(), calendar_query_exec(), calendar_query_result_exec(), call_forward_inherit(), caller_id_outgoing_request(), caller_id_outgoing_response(), callerid_read(), callerid_write(), cb_events(), cc_build_payload(), cc_interfaces_datastore_init(), cdr_write(), chan_cleanup(), chan_pjsip_answer(), chan_pjsip_cng_tone_detected(), chan_pjsip_incoming_response(), chan_pjsip_indicate(), channel_do_masquerade(), channel_set_cause(), channel_set_debug(), channel_spy(), check_bridge_play_sound(), cli_channelstats_print_body(), common_exec(), conf_find_bridge_profile(), conf_find_user_profile(), conf_run(), conf_set_menu_to_user(), conf_start_moh(), connectedline_read(), connectedline_write(), control_prestart_dispatch_all(), control_swap_channel_in_bridge(), create_dynamic_lot_full(), create_msg_q_chan(), create_parked_subscription_full(), create_transaction(), crement_function_read(), dahdi_handle_dtmf(), dahdi_handle_event(), deactivate_silence_generator(), detect_read(), detect_write(), dial_bridge_after_cb(), dial_exec_full(), dialog_info_generate_body_content(), dialplan_handle_msg_cb(), disa_exec(), disable_jack_hook(), do_forward(), do_notify(), dundi_query_read(), dundi_result_read(), dynamic_dtmf_hook_trip(), enable_jack_hook(), end_bridge_callback(), enum_query_read(), enum_result_read(), eval_exten_read(), exec_odbcfinish(), expand_gosub_args(), external_media_audiosocket_tcp(), external_media_rtp_udp(), fax_detect_attach(), fax_detect_framehook(), fax_gateway_attach(), fax_gateway_detect_t38(), fax_gateway_detect_v21(), fax_gateway_framehook(), fax_gateway_indicate_t38(), fax_gateway_start(), feature_automixmonitor(), feature_automonitor(), feature_blind_transfer(), fetch_bridge_roles_datastore(), fetch_or_create_bridge_roles_datastore(), find_by_mark(), find_by_name(), find_by_uniqueid(), find_channel_by_group(), find_conf_realtime(), find_details(), find_or_create_details(), find_ringing_channel(), find_speech(), find_transaction(), frame_drop_helper(), frame_trace_helper(), func_channel_read(), func_channel_write_real(), func_channels_read(), func_confbridge_helper(), func_header_read(), func_headers_read2(), func_mixmonitor_read(), function_ooh323_read(), function_ooh323_write(), gather_softmix_stats(), generate_parked_user(), generator_force(), generator_write_format_change(), generic_fax_exec(), get_agi_cmd(), get_chan_by_ast_name(), get_cid_name(), get_device_state_causing_channels(), get_refer_info(), get_replace_channel_store(), get_transfer_parties(), gosub_exec(), gosub_run(), goto_parser(), grab_transfer(), handle_autohangup(), handle_call_forward(), handle_call_outgoing(), handle_cli_agi_add_cmd(), handle_cli_mixmonitor(), handle_exec(), handle_gosub(), handle_incoming_request(), handle_invite_replaces(), handle_negotiated_sdp(), handle_remb_set(), handle_request_bye(), handle_show_chanvar(), handle_showchan(), handle_soft_key_event_message(), handle_softhangup(), handle_stimulus_message(), hangupcause_clear_exec(), hangupcause_keys_read(), hangupcause_read(), hold(), hook_callback(), hook_off(), hook_re_enable(), hook_thread_arg_alloc(), iax2_request(), import_ch(), import_helper(), indicate_busy(), indicate_congestion(), inherit_channel_vars_from_id(), init_hook(), init_jack_data(), internal_bridge_after_cb(), is_colp_update_allowed(), jack_hook_callback(), jingle_action_session_initiate(), jingle_session_lock_full(), launch_monitor_thread(), leave_voicemail(), limits_interval_playback(), listfilter(), local_ast_moh_start(), local_ast_moh_stop(), local_call(), local_read(), local_write(), lua_get_state(), manager_bridge_kick(), manager_mixmonitor(), manager_park(), manager_park_bridged(), map_source_to_destinations(), mark_transaction_active(), meetme_menu_admin_extended(), meetme_stasis_generate_msg(), mgcp_ss(), minivm_delete_exec(), minivm_notify_exec(), misdn_answer(), misdn_update_caller_id(), mixmonitor_ds_remove_and_free(), moh_files_generator(), morsecode_exec(), msg_data_func_read(), msg_data_func_write(), msg_func_read(), msg_func_write(), msg_send_exec(), mute_channel(), my_handle_dtmf(), MYSQL_exec(), native_bridge_is_capable(), native_chan_changed(), native_rtp_bridge_framehook_attach(), native_rtp_bridge_framehook_detach(), native_rtp_bridge_stop(), native_rtp_framehook(), native_start(), notify_new_message(), ooh323_answer(), park_and_announce_app_exec(), park_app_exec(), park_common_setup(), parked_call_app_exec(), parked_call_payload_from_failure(), parked_call_payload_from_parked_user(), parked_call_retrieve_enable_features(), parker_parked_call_message_response(), parking_duration_callback(), parking_park_call(), pbx_builtin_background(), pbx_builtin_getvar_helper(), pbx_builtin_gotoiftime(), pbx_builtin_hangup(), pbx_builtin_pushvar_helper(), pbx_builtin_saycharacters(), pbx_builtin_saycharacters_case(), pbx_builtin_saydigits(), pbx_builtin_saymoney(), pbx_builtin_saynumber(), pbx_builtin_sayphonetic(), pbx_builtin_serialize_variables(), pbx_builtin_setamaflags(), pbx_builtin_setvar_helper(), pbx_exec(), pbx_outgoing_attempt(), peek_read(), phone_new(), pickup_by_exten(), pitchshift_helper(), pjsip_acf_channel_read(), pjsip_acf_dtmf_mode_read(), pjsip_acf_dtmf_mode_write(), pjsip_acf_moh_passthrough_read(), pjsip_acf_moh_passthrough_write(), play_failsound(), play_sound(), pop_exec(), pre_bridge_setup(), process_sdp(), publish_dahdichannel(), push_notify_channel(), queue_exec(), queue_publish_multi_channel_blob(), read_config(), realtime_exec(), recall_pull(), receive_ademco_event(), redirecting_read(), redirecting_write(), refer_blind_callback(), refer_incoming_invite_request(), refer_outgoing_request(), refer_progress_bridge(), reload(), remove_stasis_end_published(), retrydial_exec(), return_exec(), ring_entry(), ringing(), rtp_check_timeout(), run_agi(), safe_sleep_conditional(), save_dialstring(), sayunixtime_exec(), scramble_write(), send_direct_media_request(), send_start_msg(), sendtext_exec(), serialize_showchan(), set_bridge_peer_vars_2party(), set_bridge_peer_vars_holding(), set_bridge_peer_vars_multiparty(), set_caps(), set_config_flags(), set_ext_pri(), set_format(), set_from_header(), set_security_requirements(), set_softmix_bridge_data(), set_timeout(), set_transfer_variables_all(), setup_bridge_features_builtin(), setup_bridge_features_dynamic(), setup_mixmonitor(), setup_mixmonitor_ds(), setup_park_common_datastore(), setup_peer_after_bridge_goto(), sfu_topologies_on_join(), sfu_topologies_on_source_change(), shared_read(), shared_write(), sip_addheader(), sip_dtmfmode(), sip_hangup(), sip_new(), sip_pvt_dtor(), sip_pvt_lock_full(), sip_read(), sip_removeheader(), sipinfo_send(), skinny_locksub(), skinny_newcall(), smdi_msg_read(), smdi_msg_retrieve_read(), softhangup_exec(), softmix_bridge_stream_topology_changed(), softmix_bridge_write_voice(), speech_background(), speech_create(), speech_datastore_destroy(), speex_read(), speex_write(), srv_datastore_setup(), srv_query_read(), srv_result_read(), stackpeek_read(), start_monitor_action(), start_monitor_exec(), stasis_app_channel_is_internal(), stasis_app_channel_is_stasis_end_published(), stasis_app_channel_set_internal(), stasis_app_channel_set_stasis_end_published(), stasis_app_exec(), state_notify_build_xml(), stir_shaken_read(), stop_automonitor(), stop_mixmonitor_full(), stream_failsound(), t38_attach_framehook(), testsuite_notify_feature_success(), timeout_write(), transfer_pull(), transmit_invite(), try_calling(), try_parking(), unhold(), unistim_ss(), unreal_colp_redirect_indicate(), unreal_colp_stream_topology_request_change(), unreal_queue_frame(), update_connected_line_from_peer(), update_initial_connected_line(), userevent_exec(), vm_execmain(), volume_read(), volume_write(), wait_for_answer(), wait_for_bridged(), wait_for_empty_queue(), wait_for_initiator(), wait_for_unbridged(), wipe_park_common_datastore(), and wipe_subscription_datastore().

ast_channel_lock_both

#define ast_channel_lock_both	(		chan1,
			chan2
	)

Lock two channels.

Definition at line 2952 of file channel.h.

Referenced by __ast_request_and_dial(), ast_ari_channels_dial(), ast_call_forward(), ast_channel_make_compatible_helper(), ast_channel_move(), ast_rtp_instance_early_bridge(), ast_rtp_instance_early_bridge_make_compatible(), ast_rtp_instance_set_stats_vars(), ast_unreal_lock_all(), attended_transfer_bridge(), begin_dial_prerun(), blind_transfer_bridge(), bridge_channel_update_accountcodes_joining(), bridge_channel_update_accountcodes_leaving(), call_forward_inherit(), channel_do_masquerade(), copy_caller_data(), dial_exec_full(), dial_transfer(), do_forward(), fax_gateway_framehook(), findmeexec(), misdn_attempt_transfer(), native_rtp_bridge_compatible(), native_rtp_bridge_join(), native_rtp_bridge_start(), native_rtp_bridge_stop(), native_rtp_stream_topology_changed(), park_local_transfer(), recalling_enter(), request_channel(), retransfer_enter(), ring_entry(), simple_bridge_join(), simple_bridge_stream_topology_changed(), and wait_for_answer().

AST_CHANNEL_NAME

#define AST_CHANNEL_NAME   80

Max length of an ast_channel name

Definition at line 172 of file channel.h.

Referenced by __analog_handle_event(), ast_call_forward(), ast_cc_call_failed(), ast_cc_is_recall(), ast_channel_destructor(), ast_parse_device_state(), ast_queue_cc_frame(), ast_setstate(), begin_dial_channel(), bridge_channel_internal_queue_attended_transfer(), bridge_moh_create(), cc_core_init_instance(), cc_unique_append(), cccancel_exec(), ccreq_exec(), chan_pjsip_incoming_response_update_cause(), channel_do_masquerade(), common_exec(), create_jb(), dahdi_cc_callback(), dahdi_new(), dial_exec_full(), do_forward(), fast_originate(), get_device_state_causing_channels(), handle_clear_alarms(), handle_incoming(), jingle_action_session_terminate(), page_exec(), set_id_from_hdr(), sip_call(), sip_handle_cc(), socket_process_helper(), softhangup_exec(), and wait_for_answer().

ast_channel_ref

#define ast_channel_ref

(

c

)

({ ao2_ref(c, +1); (c); })

Increase channel reference count.

Parameters

c	the channel

Return values

c

always

Since

1.8

Definition at line 2970 of file channel.h.

Referenced by agent_bridge_channel_get_lock(), agent_lock_logged(), agent_login_exec(), agents_sweep(), analog_attempt_transfer(), ari_channels_handle_originate_with_id(), ast_autochan_new_channel(), ast_autochan_setup(), ast_bridge_add_channel(), ast_bridge_peer_nolock(), ast_bridge_set_single_src_video_mode(), ast_bridge_update_talker_src_video_mode(), ast_local_get_peer(), ast_local_setup_bridge(), ast_local_setup_masquerade(), ast_unreal_channel_push_to_bridge(), ast_unreal_lock_all(), ast_unreal_queryoption(), ast_unreal_setoption(), async_playback_task_data_alloc(), attach_barge(), attempt_transfer(), attended_transfer_properties_alloc(), blond_nonfinal_enter(), bridge_agent_hold_push(), bridge_channel_attended_transfer(), bridge_stasis_queue_join_action(), call_pickup_incoming_request(), channel_do_masquerade(), conf_start_record(), control_create(), export_aoc_vars(), feature_attended_transfer(), find_ringing_channel(), get_device_state_causing_channels(), get_refer_info(), get_sip_pvt_from_replaces(), get_transfer_party_non_transferer_bridge(), handle_getvariablefull(), handle_invite_replaces(), handle_request_bye(), handle_request_refer(), handle_soft_key_event_message(), hangup_data_alloc(), invite_replaces(), jingle_session_lock_full(), misdn_attempt_transfer(), parking_blind_transfer_park(), pbx_outgoing_attempt(), recalling_exit(), refer_attended_alloc(), retransfer_enter(), set_dial_masquerade(), set_hangup_source_and_cause(), sip_pickup(), sip_pvt_lock_full(), sip_queue_hangup_cause(), snoop_fixup(), socket_process_helper(), stasis_app_control_snoop(), and unreal_queue_frame().

ast_channel_trylock

#define ast_channel_trylock

(

chan

)

ao2_trylock(chan)

Definition at line 2947 of file channel.h.

Referenced by analog_lock_sub_owner(), ast_atomic_dec_and_test(), ast_channel_publish_dial_forward(), ast_write_stream(), auto_congest(), check_rtp_timeout(), close_udptl_connection(), configure_local_rtp(), dahdi_handle_event(), dahdi_lock_sub_owner(), dahdi_queue_frame(), dahdi_softhangup_all(), do_monitor(), find_channel_by_group(), get_chan_by_ast_name(), grab_owner(), iax2_destroy(), iax2_lock_owner(), mbl_queue_control(), mbl_queue_hangup(), mgcp_queue_frame(), mgcp_queue_hangup(), native_start(), onAlerting(), onCallCleared(), onCallEstablished(), onModeChanged(), onProgress(), ooh323_destroy(), ooh323_onReceivedDigit(), ooh323_set_read_format(), ooh323_set_write_format(), optimize_lock_peer_stack(), release_chan(), release_chan_early(), setup_udptl_connection(), and try_swap_optimize_out().

ast_channel_unlock

#define ast_channel_unlock

(

chan

)

ao2_unlock(chan)

Definition at line 2946 of file channel.h.

Referenced by __after_bridge_set_goto(), __analog_handle_event(), __analog_ss_thread(), __ast_answer(), __ast_channel_alloc_ap(), __ast_pbx_run(), __ast_queue_frame(), __ast_read(), __ast_request_and_dial(), __dahdi_exception(), __sched_check_pendings(), __sip_autodestruct(), _if_exec(), _macro_exec(), _while_exec(), acf_cc_read(), acf_cc_write(), acf_curl_helper(), acf_faxopt_write(), acf_fetch(), acf_odbc_read(), action_add_agi_cmd(), action_agents(), action_atxfer(), action_bridge(), action_cancel_atxfer(), action_dialplan_exec(), action_redirect(), action_status(), action_timeout(), add_features_datastore(), add_to_agi(), after_bridge_goto_remove(), after_bridge_move_channel(), agent_bridge_channel_get_lock(), agent_function_read(), agent_handle_show_specific(), agent_lock_logged(), agent_login_channel_config(), agent_login_exec(), agent_logoff_request(), agent_logout(), agent_request_exec(), agent_show_requested(), alloc_playback_chan(), alsa_call(), alsa_new(), analog_attempt_transfer(), analog_exception(), analog_hangup(), analog_ss_thread(), aoc_publish_blob(), app_control_dial(), app_control_mute(), app_control_unmute(), app_exec(), append_expected_event(), apply_negotiated_sdp_stream(), ari_channels_handle_originate_with_id(), ast_activate_generator(), ast_ari_channels_dial(), ast_ari_channels_rtpstatistics(), ast_async_goto(), ast_atomic_dec_and_test(), ast_audiohook_attach(), ast_audiohook_detach_source(), ast_audiohook_remove(), ast_audiohook_set_mute(), ast_autochan_setup(), ast_autoservice_start(), ast_autoservice_stop(), ast_bridge_add_channel(), ast_bridge_call_with_flags(), ast_bridge_channel_leave_bridge_nolock(), ast_bridge_channel_playfile(), ast_bridge_channel_restore_formats(), ast_bridge_channel_stream_map(), ast_bridge_channel_update_linkedids(), ast_bridge_depart(), ast_bridge_features_ds_get_string(), ast_bridge_features_ds_set_string(), ast_bridge_join(), ast_bridge_notify_masquerade(), ast_bridge_timelimit(), ast_bridge_transfer_acquire_bridge(), ast_bridge_transfer_attended(), ast_bridge_transfer_blind(), ast_bridge_unreal_optimize_out(), ast_call(), ast_call_forward(), ast_cc_agent_set_interfaces_chanvar(), ast_cc_call_init(), ast_cc_completed(), ast_cc_extension_monitor_add_dialstring(), ast_cc_get_current_core_id(), ast_cc_is_recall(), ast_cc_offer(), ast_change_name(), ast_channel_bridge_peer(), ast_channel_by_exten_cb(), ast_channel_by_name_cb(), ast_channel_by_uniqueid_cb(), ast_channel_clear_flag(), ast_channel_clear_softhangup(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_channel_defer_dtmf(), ast_channel_destructor(), ast_channel_end_dtmf(), ast_channel_is_t38_active(), ast_channel_make_compatible_helper(), ast_channel_move(), ast_channel_publish_dial_forward(), ast_channel_publish_dial_internal(), ast_channel_queryoption(), ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), ast_channel_request_stream_topology_change(), ast_channel_set_caller(), ast_channel_set_caller_event(), ast_channel_set_connected_line(), ast_channel_set_flag(), ast_channel_set_is_t38_active(), ast_channel_set_redirecting(), ast_channel_set_unbridged(), ast_channel_setoption(), ast_channel_softhangup_withcause_locked(), ast_channel_stream_topology_changed_externally(), ast_channel_unbridged(), ast_channel_yank(), ast_check_hangup_locked(), ast_deactivate_generator(), ast_dial_join(), ast_do_pickup(), ast_eivr_getvariable(), ast_explicit_goto(), ast_handle_cc_control_frame(), ast_hangup(), ast_iax2_new(), ast_ignore_cc(), ast_indicate_data(), ast_jb_create_framehook(), ast_local_setup_bridge(), ast_local_setup_masquerade(), ast_local_unlock_all(), ast_odbc_retrieve_transaction_obj(), ast_openstream_full(), ast_openvstream(), ast_pbx_h_exten_run(), ast_pbx_hangup_handler_destroy(), ast_pbx_hangup_handler_pop(), ast_pbx_hangup_handler_push(), ast_pbx_hangup_handler_run(), ast_pbx_hangup_handler_show(), ast_pbx_outgoing_exten_predial(), ast_pickup_call(), ast_pickup_find_by_group(), ast_pre_call(), ast_queue_hangup(), ast_queue_hangup_with_cause(), ast_queue_hold(), ast_queue_unhold(), ast_raw_answer_with_stream_topology(), ast_read_generator_actions(), ast_rtp_instance_early_bridge(), ast_rtp_instance_early_bridge_make_compatible(), ast_rtp_instance_make_compatible(), ast_rtp_instance_set_stats_vars(), ast_senddigit_begin(), ast_senddigit_end(), ast_sendtext_data(), ast_set_callerid(), ast_set_cc_interfaces_chanvar(), ast_set_hangupsource(), ast_settimeout_full(), ast_setup_cc_recall_datastore(), ast_softhangup(), ast_stir_shaken_add_verification(), ast_stopstream(), ast_str_retrieve_variable(), ast_streamfile(), AST_TEST_DEFINE(), ast_transfer_protocol(), ast_unreal_channel_push_to_bridge(), ast_unreal_hangup(), ast_unreal_indicate(), ast_unreal_lock_all(), ast_unreal_new_channels(), ast_unreal_queryoption(), ast_unreal_setoption(), ast_var_channel_bridge(), ast_var_channels_table(), ast_waitfor_nandfds(), ast_write_stream(), async_play_sound_ready(), async_playback_task_data_alloc(), attach_framehook(), attempt_transfer(), attended_transfer_bridge(), attended_transfer_exec(), attended_transfer_monitor_thread(), attended_transfer_properties_alloc(), audiosocket_request(), auth_exec(), auto_congest(), begin_dial_channel(), begin_dial_prerun(), blind_transfer_bridge(), bridge_channel_change_bridge(), bridge_channel_depart(), bridge_channel_feature_digit_timeout(), bridge_channel_impart_add(), bridge_channel_impart_signal(), bridge_channel_ind_thread(), bridge_channel_internal_join(), bridge_channel_internal_queue_attended_transfer(), bridge_channel_internal_queue_blind_transfer(), bridge_channel_queue_deferred_frames(), bridge_channel_update_accountcodes_joining(), bridge_channel_update_accountcodes_leaving(), bridge_check_monitor(), bridge_exec(), bridge_impart_internal(), bridge_move(), bridge_parking_push(), bridge_reconfigured_connected_line_update(), bridge_stasis_push_peek(), bridge_stasis_queue_join_action(), bridge_timeout(), bridgeadd_exec(), calendar_event_read(), calendar_query_exec(), calendar_query_result_exec(), call_forward_inherit(), caller_id_outgoing_request(), caller_id_outgoing_response(), callerid_read(), callerid_write(), cb_events(), cc_build_payload(), cc_interfaces_datastore_init(), cdr_write(), chan_cleanup(), chan_pjsip_answer(), chan_pjsip_cng_tone_detected(), chan_pjsip_incoming_response(), chan_pjsip_indicate(), chan_pjsip_new(), channel_do_masquerade(), channel_set_cause(), channel_set_debug(), channel_spy(), check_bridge_play_sound(), check_rtp_timeout(), cli_channelstats_print_body(), close_udptl_connection(), common_exec(), conf_find_bridge_profile(), conf_find_user_profile(), conf_run(), conf_set_menu_to_user(), conf_start_moh(), configure_local_rtp(), connectedline_read(), connectedline_write(), console_answer(), console_hangup(), console_new(), console_sendtext(), control_prestart_dispatch_all(), control_swap_channel_in_bridge(), copy_caller_data(), create_alice_channel(), create_dynamic_lot_full(), create_msg_q_chan(), create_parked_subscription_full(), create_transaction(), crement_function_read(), dahdi_handle_dtmf(), dahdi_handle_event(), dahdi_new(), dahdi_queue_frame(), dahdi_softhangup_all(), deactivate_silence_generator(), detect_read(), detect_write(), dial_bridge_after_cb(), dial_exec_full(), dial_transfer(), dialog_info_generate_body_content(), dialog_unlink_all(), dialplan_handle_msg_cb(), disa_exec(), disable_jack_hook(), do_forward(), do_monitor(), do_notify(), dundi_query_read(), dundi_result_read(), dynamic_dtmf_hook_trip(), enable_jack_hook(), end_bridge_callback(), enum_query_read(), enum_result_read(), eval_exten_read(), exec_odbcfinish(), expand_gosub_args(), external_media_audiosocket_tcp(), external_media_rtp_udp(), fast_originate(), fax_detect_attach(), fax_detect_framehook(), fax_gateway_attach(), fax_gateway_detect_t38(), fax_gateway_detect_v21(), fax_gateway_framehook(), fax_gateway_indicate_t38(), fax_gateway_start(), feature_automixmonitor(), feature_automonitor(), feature_blind_transfer(), fetch_bridge_roles_datastore(), fetch_or_create_bridge_roles_datastore(), find_by_mark(), find_by_name(), find_by_uniqueid(), find_channel_by_group(), find_conf_realtime(), find_details(), find_or_create_details(), find_ringing_channel(), find_speech(), find_transaction(), findmeexec(), frame_drop_helper(), frame_trace_helper(), func_channel_read(), func_channel_write_real(), func_channels_read(), func_confbridge_helper(), func_header_read(), func_headers_read2(), func_mixmonitor_read(), function_ooh323_read(), function_ooh323_write(), gather_softmix_stats(), generate_parked_user(), generator_force(), generator_write_format_change(), generic_fax_exec(), get_agi_cmd(), get_chan_by_ast_name(), get_cid_name(), get_device_state_causing_channels(), get_refer_info(), get_replace_channel_store(), get_transfer_parties(), gosub_exec(), gosub_run(), goto_parser(), grab_transfer(), handle_autohangup(), handle_call_forward(), handle_call_outgoing(), handle_cli_agi_add_cmd(), handle_cli_mixmonitor(), handle_exec(), handle_gosub(), handle_incoming_request(), handle_invite_replaces(), handle_negotiated_sdp(), handle_remb_set(), handle_request_bye(), handle_request_do(), handle_request_invite(), handle_request_refer(), handle_show_chanvar(), handle_showchan(), handle_soft_key_event_message(), handle_softhangup(), handle_stimulus_message(), hangupcause_clear_exec(), hangupcause_keys_read(), hangupcause_read(), hold(), hook_callback(), hook_off(), hook_re_enable(), hook_thread_arg_alloc(), iax2_destroy(), iax2_queue_frame(), iax2_queue_hangup(), iax2_queue_hold(), iax2_queue_unhold(), iax2_request(), import_ch(), import_helper(), indicate_busy(), indicate_congestion(), inherit_channel_vars_from_id(), init_hook(), init_jack_data(), internal_bridge_after_cb(), is_colp_update_allowed(), jack_hook_callback(), jingle_action_session_accept(), jingle_action_session_info(), jingle_action_session_initiate(), jingle_action_session_terminate(), jingle_interpret_content(), jingle_new(), jingle_outgoing_hook(), jingle_queue_hangup_with_cause(), jingle_session_lock_full(), launch_monitor_thread(), leave_voicemail(), limits_interval_playback(), listfilter(), local_ast_moh_start(), local_ast_moh_stop(), local_attended_transfer(), local_call(), local_read(), local_write(), lua_get_state(), make_channel(), manager_bridge_kick(), manager_mixmonitor(), manager_park(), manager_park_bridged(), map_source_to_destinations(), mark_transaction_active(), mbl_new(), mbl_queue_control(), mbl_queue_hangup(), meetme_menu_admin_extended(), meetme_stasis_generate_msg(), mgcp_new(), mgcp_pktcgate_remove(), mgcp_queue_frame(), mgcp_queue_hangup(), mgcp_ss(), minivm_delete_exec(), minivm_notify_exec(), misdn_answer(), misdn_attempt_transfer(), misdn_new(), misdn_update_caller_id(), mixmonitor_ds_remove_and_free(), moh_files_generator(), morsecode_exec(), msg_data_func_read(), msg_data_func_write(), msg_func_read(), msg_func_write(), msg_send_exec(), multicast_rtp_request(), mute_channel(), my_handle_dtmf(), MYSQL_exec(), native_bridge_is_capable(), native_chan_changed(), native_rtp_bridge_compatible(), native_rtp_bridge_framehook_attach(), native_rtp_bridge_framehook_detach(), native_rtp_bridge_join(), native_rtp_bridge_start(), native_rtp_bridge_stop(), native_rtp_framehook(), native_rtp_stream_topology_changed(), native_start(), nbs_new(), notify_new_message(), onAlerting(), onCallCleared(), onCallEstablished(), onModeChanged(), onProgress(), ooh323_answer(), ooh323_destroy(), ooh323_new(), ooh323_onReceivedDigit(), ooh323_set_read_format(), ooh323_set_write_format(), optimize_lock_peer_stack(), oss_new(), park_and_announce_app_exec(), park_app_exec(), park_common_setup(), park_local_transfer(), parked_call_app_exec(), parked_call_payload_from_failure(), parked_call_payload_from_parked_user(), parked_call_retrieve_enable_features(), parker_parked_call_message_response(), parking_duration_callback(), parking_park_call(), pbx_builtin_background(), pbx_builtin_getvar_helper(), pbx_builtin_gotoiftime(), pbx_builtin_hangup(), pbx_builtin_pushvar_helper(), pbx_builtin_saycharacters(), pbx_builtin_saycharacters_case(), pbx_builtin_saydigits(), pbx_builtin_saymoney(), pbx_builtin_saynumber(), pbx_builtin_sayphonetic(), pbx_builtin_serialize_variables(), pbx_builtin_setamaflags(), pbx_builtin_setvar_helper(), pbx_exec(), pbx_outgoing_attempt(), peek_read(), phone_new(), pickup_by_channel(), pickup_by_exten(), pickup_by_group(), pickup_by_mark(), pickup_by_part(), pitchshift_helper(), pjsip_acf_channel_read(), pjsip_acf_dtmf_mode_read(), pjsip_acf_dtmf_mode_write(), pjsip_acf_moh_passthrough_read(), pjsip_acf_moh_passthrough_write(), play_failsound(), play_sound(), pop_exec(), pre_bridge_setup(), proc_session_timer(), process_sdp(), publish_dahdichannel(), publish_local_bridge_message(), push_notify_channel(), queue_exec(), queue_publish_multi_channel_blob(), read_config(), realtime_exec(), rec_request(), recall_pull(), recalling_enter(), receive_ademco_event(), redirecting_read(), redirecting_write(), refer_blind_callback(), refer_incoming_invite_request(), refer_outgoing_request(), refer_progress_bridge(), reinvite_timeout(), release_chan(), release_chan_early(), reload(), remove_stasis_end_published(), request_channel(), retrans_pkt(), retransfer_enter(), retrydial_exec(), return_exec(), ring_entry(), ringing(), rtp_check_timeout(), run_agi(), safe_sleep_conditional(), save_dialstring(), sayunixtime_exec(), scramble_write(), send_direct_media_request(), send_provisional_keepalive_full(), send_start_msg(), sendtext_exec(), serialize_showchan(), set_bridge_peer_vars_2party(), set_bridge_peer_vars_holding(), set_bridge_peer_vars_multiparty(), set_caps(), set_config_flags(), set_ext_pri(), set_format(), set_from_header(), set_hangup_source_and_cause(), set_security_requirements(), set_softmix_bridge_data(), set_timeout(), set_transfer_variables_all(), setup_bridge_features_builtin(), setup_bridge_features_dynamic(), setup_mixmonitor(), setup_mixmonitor_ds(), setup_park_common_datastore(), setup_peer_after_bridge_goto(), setup_udptl_connection(), sfu_topologies_on_join(), sfu_topologies_on_source_change(), shared_read(), shared_write(), simple_bridge_join(), simple_bridge_stream_topology_changed(), sip_addheader(), sip_dtmfmode(), sip_hangup(), sip_new(), sip_pvt_dtor(), sip_pvt_lock_full(), sip_queue_hangup_cause(), sip_read(), sip_reinvite_retry(), sip_removeheader(), sip_request_call(), sip_t38_abort(), sipinfo_send(), skinny_new(), skinny_newcall(), skinny_unlocksub(), smdi_msg_read(), smdi_msg_retrieve_read(), socket_process_helper(), softhangup_exec(), softmix_bridge_stream_topology_changed(), softmix_bridge_write_voice(), speech_background(), speech_create(), speech_datastore_destroy(), speex_read(), speex_write(), srv_datastore_setup(), srv_query_read(), srv_result_read(), stackpeek_read(), start_monitor_action(), start_monitor_exec(), stasis_app_channel_is_internal(), stasis_app_channel_is_stasis_end_published(), stasis_app_channel_set_internal(), stasis_app_channel_set_stasis_end_published(), stasis_app_channel_unreal_set_internal(), stasis_app_control_snoop(), stasis_app_exec(), state_notify_build_xml(), stir_shaken_read(), stop_automonitor(), stop_mixmonitor_full(), stream_failsound(), t38_attach_framehook(), test_vm_api_create_mock_channel(), testsuite_notify_feature_success(), timeout_write(), transfer_pull(), transmit_invite(), try_calling(), try_parking(), try_swap_optimize_out(), unhold(), unicast_rtp_request(), unistim_new(), unistim_ss(), unreal_colp_redirect_indicate(), unreal_colp_stream_topology_request_change(), unreal_queue_frame(), update_connected_line_from_peer(), update_initial_connected_line(), userevent_exec(), vm_execmain(), volume_read(), volume_write(), wait_for_answer(), wait_for_bridged(), wait_for_digits(), wait_for_empty_queue(), wait_for_initiator(), wait_for_unbridged(), wakeup_sub(), wipe_park_common_datastore(), and wipe_subscription_datastore().

ast_channel_unref

#define ast_channel_unref

(

c

)

({ ao2_ref(c, -1); (struct ast_channel *) (NULL); })

Decrease channel reference count.

Parameters

c	the channel

Return values

NULL

always

Since

1.8

Definition at line 2981 of file channel.h.

Referenced by __ast_channel_alloc_ap(), __ast_channel_internal_alloc(), __sched_check_pendings(), __sip_autodestruct(), acf_odbc_read(), acf_odbc_write(), action_add_agi_cmd(), action_agents(), action_aocmessage(), action_atxfer(), action_blind_transfer(), action_cancel_atxfer(), action_getvar(), action_hangup(), action_redirect(), action_sendtext(), action_setvar(), action_status(), action_timeout(), agent_bridge_channel_get_lock(), agent_function_read(), agent_handle_show_specific(), agent_lock_logged(), agent_logoff_request(), agent_logout(), agent_pvt_destructor(), agent_show_requested(), agents_sweep(), analog_attempt_transfer(), ari_channels_handle_originate_with_id(), ast_add_extension2_lockopt(), ast_async_goto_by_name(), ast_autochan_destroy(), ast_autochan_new_channel(), ast_bridge_add_channel(), ast_bridge_remove_video_src(), ast_bridge_update_talker_src_video_mode(), ast_cel_fabricate_channel_from_event(), ast_channel_release(), ast_hangup(), ast_local_unlock_all(), ast_parse_device_state(), ast_pickup_call(), ast_pickup_find_by_group(), ast_rtp_instance_set_stats_vars(), ast_str_substitute_variables_full(), AST_TEST_DEFINE(), ast_unreal_channel_push_to_bridge(), ast_unreal_hangup(), ast_unreal_indicate(), ast_unreal_lock_all(), ast_unreal_queryoption(), ast_unreal_setoption(), ast_var_channel_bridge(), ast_var_channel_types_table(), ast_var_channels_table(), asyncgoto_exec(), attach_barge(), attempt_transfer(), blond_nonfinal_enter(), blond_nonfinal_exit(), bridge_agent_hold_push(), bridge_channel_attended_transfer(), bridge_exec(), bridgeadd_exec(), call_forwarded_handler(), call_pickup_incoming_request(), change_monitor_action(), channel_do_masquerade(), cleanup_video_mode(), cli_odbc_read(), cli_odbc_write(), common_exec(), conf_start_record(), conf_stop_record(), controlplayback_manager(), custom_log(), dialog_info_generate_body_content(), dialog_unlink_all(), do_pause_or_unpause(), does_id_conflict(), external_media_audiosocket_tcp(), external_media_rtp_udp(), fast_originate(), func_channel_read(), func_channels_read(), func_mchan_read(), func_mchan_write(), get_device_state_causing_channels(), handle_bridge_kick_channel(), handle_cli_agi_add_cmd(), handle_cli_mixmonitor(), handle_core_set_debug_channel(), handle_getvariablefull(), handle_hangup(), handle_incoming_request(), handle_invite_replaces(), handle_redirect(), handle_remb_set(), handle_request_do(), handle_set_chanvar(), handle_show_chanvar(), handle_show_hangup_all(), handle_show_hangup_channel(), handle_showchan(), handle_soft_key_event_message(), handle_softhangup(), hangup_data_destroy(), import_helper(), jingle_action_session_accept(), jingle_action_session_info(), jingle_action_session_terminate(), jingle_interpret_content(), jingle_outgoing_hook(), jingle_queue_hangup_with_cause(), jingle_session_lock_full(), load_values_config(), local_call(), make_email_file(), manager_log(), manager_mixmonitor(), manager_mute_mixmonitor(), manager_mutestream(), manager_optimize_away(), manager_play_dtmf(), manager_play_mf(), manager_stop_mixmonitor(), misdn_attempt_transfer(), next_channel(), park_local_transfer(), parking_blind_transfer_park(), pbx_builtin_importvar(), pbx_outgoing_attempt(), pbx_substitute_variables_helper_full(), pickup_by_channel(), pickup_by_exten(), pickup_by_group(), pickup_by_mark(), pickup_by_part(), proc_session_timer(), publish_local_bridge_message(), push_notify_channel(), recalling_exit(), refer_incoming_invite_request(), refer_progress_bridge(), reinvite_timeout(), retrans_pkt(), retransfer_enter(), retransfer_exit(), rotate_file(), rtp_check_timeout(), send_provisional_keepalive_full(), senddtmf_exec(), sendmail(), sendmf_exec(), sendpage(), set_hangup_source_and_cause(), shared_read(), shared_write(), sip_pickup(), sip_pickup_thread(), sip_pvt_lock_full(), sip_queue_hangup_cause(), sip_reinvite_retry(), sip_t38_abort(), skinny_new(), snoop_fixup(), socket_process_helper(), softhangup_exec(), start_monitor_action(), stasis_app_channel_unreal_set_internal(), state_notify_build_xml(), stop_monitor_action(), syslog_log(), unreal_colp_redirect_indicate(), unreal_colp_stream_topology_request_change(), unreal_queue_frame(), vm_allocate_dh(), and write_cel().

ast_dummy_channel_alloc

#define ast_dummy_channel_alloc

(

)

__ast_dummy_channel_alloc(__FILE__, __LINE__, __PRETTY_FUNCTION__)

Create a fake channel structure.

Return values

NULL	failure
non-NULL	successfully allocated channel

Note

This function should ONLY be used to create a fake channel that can then be populated with data for use in variable substitution when a real channel does not exist.

The created dummy channel should be destroyed by ast_channel_unref(). Using ast_channel_release() needlessly grabs the channel container lock and can cause a deadlock as a result. Also grabbing the channel container lock reduces system performance.

Definition at line 1283 of file channel.h.

Referenced by acf_odbc_read(), acf_odbc_write(), action_getvar(), ast_add_extension2_lockopt(), ast_cel_fabricate_channel_from_event(), ast_str_substitute_variables_full(), AST_TEST_DEFINE(), cli_odbc_read(), cli_odbc_write(), custom_log(), load_values_config(), make_email_file(), manager_log(), pbx_substitute_variables_helper_full(), rotate_file(), sendmail(), sendpage(), syslog_log(), and vm_allocate_dh().

AST_EXTENDED_FDS

#define AST_EXTENDED_FDS   12

the start of extended file descriptor positions

Definition at line 196 of file channel.h.

Referenced by ast_channel_fd_add(), AST_TEST_DEFINE(), chan_pjsip_read_stream(), check_for_rtp_changes(), and handle_negotiated_sdp().

AST_FEATURE_DTMF_MASK

#define AST_FEATURE_DTMF_MASK

Value:

(AST_FEATURE_REDIRECT | AST_FEATURE_DISCONNECT |\
 AST_FEATURE_ATXFER | AST_FEATURE_AUTOMON | AST_FEATURE_PARKCALL | AST_FEATURE_AUTOMIXMON)

Definition at line 1073 of file channel.h.

Referenced by set_config_flags().

AST_GENERATOR_FD

#define AST_GENERATOR_FD   (AST_MAX_FDS-4)

used by generator

Definition at line 204 of file channel.h.

Referenced by __ast_read(), channel_do_masquerade(), and deactivate_generator_nolock().

AST_JITTERBUFFER_FD

#define AST_JITTERBUFFER_FD   (AST_MAX_FDS-5)

used by generator

Definition at line 205 of file channel.h.

Referenced by __ast_read(), ast_jb_create_framehook(), and hook_event_cb().

AST_MAX_ACCOUNT_CODE

#define AST_MAX_ACCOUNT_CODE   80

Max length of an account code

Definition at line 171 of file channel.h.

AST_MAX_CONTEXT

#define AST_MAX_CONTEXT   80

Max length of a context

Definition at line 136 of file channel.h.

Referenced by _macro_exec(), ast_beep_start(), blind_transfer_bridge(), cleanup_stale_contexts(), common_exec(), conf_run(), config_parse_variables(), device_state_notify_callbacks(), do_magic_pickup(), feature_attended_transfer(), handle_call_forward(), handle_request_invite(), handle_show_hint(), handle_show_hints(), iax2_exec(), park_local_transfer(), presence_state_notify_callbacks(), reload_config(), retransfer_enter(), run_externnotify(), test_vm_api_create_mock_snapshot(), and try_calling().

AST_MAX_EXTENSION

#define AST_MAX_EXTENSION   80

Max length of an extension

Examples:

/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 135 of file channel.h.

Referenced by __analog_ss_thread(), __ast_context_destroy(), add_extensions(), advanced_options(), analog_ss_thread(), ast_beep_start(), ast_devstate_changed(), ast_ivr_menu_run_internal(), ast_presence_state_changed(), blind_transfer_bridge(), build_device(), cc_extension_monitor_init(), conf_run(), device_state_notify_callbacks(), dial_exec_full(), disa_exec(), do_magic_pickup(), dundi_lookup_local(), feature_attended_transfer(), feature_blind_transfer(), find_conf_realtime(), forward_message(), function_enum(), get_destination(), handle_call_forward(), handle_request_invite(), handle_show_hint(), handle_show_hints(), handle_soft_key_event_message(), handle_stimulus_message(), iax2_exec(), load_module(), log_exec(), manager_show_dialplan_helper(), mgcp_ss(), ooh323_call(), ooh323_request(), options_on_rx_request(), park_local_transfer(), parking_duration_callback(), parking_lot_cfg_create_extensions(), pbx_substitute_variables_helper(), phone_check_exception(), presence_state_notify_callbacks(), process_dahdi(), realtime_common(), realtime_switch_common(), refer_incoming_blind_request(), retransfer_enter(), rx_data_to_ast_msg(), session_inv_on_redirected(), show_dialplan_helper(), skinny_extensionstate_cb(), sla_build_station(), sla_station_destructor(), speech_background(), state_notify_build_xml(), test_vm_api_create_mock_snapshot(), try_calling(), vm_authenticate(), and vmauthenticate().

AST_MAX_FDS

#define AST_MAX_FDS   11

original maximum number of file descriptors

Definition at line 195 of file channel.h.

Referenced by __ast_channel_internal_alloc().

AST_MAX_PUBLIC_UNIQUEID

#define AST_MAX_PUBLIC_UNIQUEID   149

Max length of a channel uniqueid reported to the outside world.

149 = 127 (max systemname) + "-" + 10 (epoch timestamp)

• "." + 10 (monotonically incrementing integer).

Note

If this value is ever changed, MAX_CHANNEL_ID should be updated in rtp_engine.h.

Definition at line 148 of file channel.h.

Referenced by action_originate(), and ari_channels_handle_originate_with_id().

AST_MAX_UNIQUEID

#define AST_MAX_UNIQUEID   (AST_MAX_PUBLIC_UNIQUEID + 2 + 1)

Maximum size of an internal Asterisk channel unique ID.

Add two for the Local;2 channel to append a ';2' if needed plus nul terminator.

Note

If this value is ever changed, MAX_CHANNEL_ID should be updated in rtp_engine.h.

Definition at line 169 of file channel.h.

AST_MAX_USER_FIELD

#define AST_MAX_USER_FIELD   256

Max length of the channel user field

Definition at line 175 of file channel.h.

Referenced by ast_rtp_instance_set_stats_vars(), handle_request_bye(), sip_acf_channel_read(), sip_hangup(), and tds_log().

AST_MUTE_DIRECTION_READ

#define AST_MUTE_DIRECTION_READ   (1 << 0)

Definition at line 4937 of file channel.h.

Referenced by ast_ari_channels_mute(), ast_ari_channels_unmute(), mute_channel(), and suppress_framehook_event_cb().

AST_MUTE_DIRECTION_WRITE

#define AST_MUTE_DIRECTION_WRITE   (1 << 1)

Definition at line 4938 of file channel.h.

Referenced by ast_ari_channels_mute(), ast_ari_channels_unmute(), mute_channel(), and suppress_framehook_event_cb().

AST_NUM_CHANNEL_BUCKETS

#define AST_NUM_CHANNEL_BUCKETS   1567

The number of buckets to store channels or channel information

Definition at line 156 of file channel.h.

Referenced by ast_channels_init(), ast_stasis_channels_init(), and load_module().

AST_TIMING_FD

#define AST_TIMING_FD   (AST_MAX_FDS-2)

used for timingfd

Definition at line 202 of file channel.h.

Referenced by __ast_channel_alloc_ap(), __ast_read(), ast_settimeout_full(), and channel_do_masquerade().

CHECK_BLOCKING

#define CHECK_BLOCKING

(

c

)

Set the blocking indication on the channel.

Indicate that the thread handling the channel is about to do a blocking operation to wait for media on the channel. (poll, read, or write)

Masquerading and ast_queue_frame() use this indication to wake up the thread.

Precondition

The channel needs to be locked

Definition at line 2894 of file channel.h.

Referenced by ast_sendtext_data(), ast_waitfor_nandfds(), ast_write_stream(), dahdi_read(), and phone_read().

DATASTORE_INHERIT_FOREVER

#define DATASTORE_INHERIT_FOREVER   INT_MAX

Definition at line 193 of file channel.h.

Referenced by _macro_exec(), acf_iaxvar_write(), add_features_datastore(), ast_channel_datastore_inherit(), ast_iax2_new(), ast_setup_cc_recall_datastore(), authenticate_reply(), calendar_query_exec(), cc_interfaces_datastore_init(), do_notify(), internal_feature_write(), max_forwards_datastore_alloc(), reload(), and socket_process_helper().

DEBUGCHAN_FLAG

#define DEBUGCHAN_FLAG   0x80000000

The high bit of the frame count is used as a debug marker, so increments of the counters must be done with care. Please use c->fin = FRAMECOUNT_INC(c->fin) and the same for c->fout.

Definition at line 858 of file channel.h.

Referenced by __ast_read(), ast_write_stream(), channel_set_debug(), handle_core_set_debug_channel(), and serialize_showchan().

DECLARE_STRINGFIELD_SETTERS_FOR

#define DECLARE_STRINGFIELD_SETTERS_FOR

(

field

)

Value:

void ast_channel_##field##_set(struct ast_channel *chan, const char *field); \
 void ast_channel_##field##_build_va(struct ast_channel *chan, const char *fmt, va_list ap) __attribute__((format(printf, 2, 0))); \
 void ast_channel_##field##_build(struct ast_channel *chan, const char *fmt, ...) __attribute__((format(printf, 2, 3)))

Definition at line 4257 of file channel.h.

FRAMECOUNT_INC

#define FRAMECOUNT_INC

(

x

)

( ((x) & DEBUGCHAN_FLAG) | (((x)+1) & ~DEBUGCHAN_FLAG) )

Definition at line 861 of file channel.h.

Referenced by __ast_read(), and ast_write_stream().

MAX_LANGUAGE

#define MAX_LANGUAGE   40

Max length of the language setting

Definition at line 173 of file channel.h.

Referenced by load_asterisk_conf().

MAX_MUSICCLASS

#define MAX_MUSICCLASS   80

Max length of the music class setting

Definition at line 174 of file channel.h.

Typedef Documentation

ast_acf_read2_fn_t

typedef int(* ast_acf_read2_fn_t) (struct ast_channel *chan, const char *cmd, char *data, struct ast_str **str, ssize_t len)

Typedef for a custom read2 function.

Note

data should be treated as const char *.

Definition at line 581 of file channel.h.

ast_acf_read_fn_t

typedef int(* ast_acf_read_fn_t) (struct ast_channel *chan, const char *function, char *data, char *buf, size_t len)

Typedef for a custom read function.

Note

data should be treated as const char *.

Definition at line 575 of file channel.h.

ast_acf_write_fn_t

typedef int(* ast_acf_write_fn_t) (struct ast_channel *chan, const char *function, char *data, const char *value)

Typedef for a custom write function.

Note

data should be treated as const char *.

Definition at line 587 of file channel.h.

ast_group_t

typedef unsigned long long ast_group_t

Definition at line 214 of file channel.h.

ast_timing_func_t

typedef int(* ast_timing_func_t) (const void *data)

Definition at line 900 of file channel.h.

Enumeration Type Documentation

anonymous enum

anonymous enum

ast_channel_tech Properties

Enumerator
AST_CHAN_TP_WANTSJITTER	Channels have this property if they can accept input with jitter; i.e. most VoIP channels.
AST_CHAN_TP_CREATESJITTER	Channels have this property if they can create jitter; i.e. most VoIP channels.
AST_CHAN_TP_INTERNAL	Channels with this particular technology are an implementation detail of Asterisk and should generally not be exposed or manipulated by the outside world.
AST_CHAN_TP_SEND_TEXT_DATA	Channels have this property if they implement send_text_data.

Definition at line 956 of file channel.h.

 {
 /*!
 * \brief Channels have this property if they can accept input with jitter;
 * i.e. most VoIP channels
 */
 AST_CHAN_TP_WANTSJITTER = (1 << 0),
 /*!
 * \brief Channels have this property if they can create jitter;
 * i.e. most VoIP channels
 */
 AST_CHAN_TP_CREATESJITTER = (1 << 1),
 /*!
 * \brief Channels with this particular technology are an implementation detail of
 * Asterisk and should generally not be exposed or manipulated by the outside
 * world
 */
 AST_CHAN_TP_INTERNAL = (1 << 2),
 /*!
 * \brief Channels have this property if they implement send_text_data
 */
 AST_CHAN_TP_SEND_TEXT_DATA = (1 << 3),
};

anonymous enum

anonymous enum

ast_channel flags

Enumerator
AST_FLAG_DEFER_DTMF	Queue incoming DTMF, to be released when this flag is turned off
AST_FLAG_WRITE_INT	write should be interrupt generator
AST_FLAG_BLOCKING	a thread is blocking on this channel
AST_FLAG_ZOMBIE	This is a zombie channel
AST_FLAG_EXCEPTION	There is an exception pending
AST_FLAG_MOH	Listening to moh XXX anthm promises me this will disappear XXX
AST_FLAG_SPYING	This channel is spying on another channel
AST_FLAG_IN_AUTOLOOP	the channel is in an auto-incrementing dialplan processor, so when ->priority is set, it will get incremented before finding the next priority to run
AST_FLAG_OUTGOING	This is an outgoing call
AST_FLAG_IN_DTMF	A DTMF_BEGIN frame has been read from this channel, but not yet an END
AST_FLAG_EMULATE_DTMF	A DTMF_END was received when not IN_DTMF, so the length of the digit is currently being emulated
AST_FLAG_END_DTMF_ONLY	This is set to tell the channel not to generate DTMF begin frames, and to instead only generate END frames.
AST_FLAG_MASQ_NOSTREAM	This flag indicates that on a masquerade, an active stream should not be carried over
AST_FLAG_BRIDGE_HANGUP_RUN	This flag indicates that the hangup exten was run when the bridge terminated, a message aimed at preventing a subsequent hangup exten being run at the pbx_run level
AST_FLAG_DISABLE_WORKAROUNDS	Disable certain workarounds. This reintroduces certain bugs, but allows some non-traditional dialplans (like AGI) to continue to function.
AST_FLAG_DISABLE_DEVSTATE_CACHE	Disable device state event caching. This allows channel drivers to selectively prevent device state events from being cached by certain channels such as anonymous calls which have no persistent represenatation that can be tracked.
AST_FLAG_BRIDGE_DUAL_REDIRECT_WAIT	This flag indicates that a dual channel redirect is in progress. The bridge needs to wait until the flag is cleared to continue.
AST_FLAG_ORIGINATED	This flag indicates that the channel was originated.
AST_FLAG_DEAD	The channel is well and truly dead. Once this is set and published, no further actions should be taken upon the channel, and no further publications should occur.
AST_FLAG_SNAPSHOT_STAGE	Channel snapshot should not be published, it is being staged for an explicit publish.
AST_FLAG_TIMINGDATA_IS_AO2_OBJ	The data on chan->timingdata is an astobj2 object.
AST_FLAG_SUBROUTINE_EXEC	The channel is executing a subroutine or macro

Definition at line 980 of file channel.h.

 {
 /*! Queue incoming DTMF, to be released when this flag is turned off */
 AST_FLAG_DEFER_DTMF = (1 << 1),
 /*! write should be interrupt generator */
 AST_FLAG_WRITE_INT = (1 << 2),
 /*! a thread is blocking on this channel */
 AST_FLAG_BLOCKING = (1 << 3),
 /*! This is a zombie channel */
 AST_FLAG_ZOMBIE = (1 << 4),
 /*! There is an exception pending */
 AST_FLAG_EXCEPTION = (1 << 5),
 /*! Listening to moh XXX anthm promises me this will disappear XXX */
 AST_FLAG_MOH = (1 << 6),
 /*! This channel is spying on another channel */
 AST_FLAG_SPYING = (1 << 7),
 /*! the channel is in an auto-incrementing dialplan processor,
 * so when ->priority is set, it will get incremented before
 * finding the next priority to run */
 AST_FLAG_IN_AUTOLOOP = (1 << 9),
 /*! This is an outgoing call */
 AST_FLAG_OUTGOING = (1 << 10),
 /*! A DTMF_BEGIN frame has been read from this channel, but not yet an END */
 AST_FLAG_IN_DTMF = (1 << 12),
 /*! A DTMF_END was received when not IN_DTMF, so the length of the digit is
 * currently being emulated */
 AST_FLAG_EMULATE_DTMF = (1 << 13),
 /*! This is set to tell the channel not to generate DTMF begin frames, and
 * to instead only generate END frames. */
 AST_FLAG_END_DTMF_ONLY = (1 << 14),
 /* OBSOLETED in favor of AST_CAUSE_ANSWERED_ELSEWHERE
 * Flag to show channels that this call is hangup due to the fact that the call
 * was indeed answered, but in another channel */
 /* AST_FLAG_ANSWERED_ELSEWHERE = (1 << 15), */
 /*! This flag indicates that on a masquerade, an active stream should not
 * be carried over */
 AST_FLAG_MASQ_NOSTREAM = (1 << 16),
 /*! This flag indicates that the hangup exten was run when the bridge terminated,
 * a message aimed at preventing a subsequent hangup exten being run at the pbx_run
 * level */
 AST_FLAG_BRIDGE_HANGUP_RUN = (1 << 17),
 /*! Disable certain workarounds. This reintroduces certain bugs, but allows
 * some non-traditional dialplans (like AGI) to continue to function.
 */
 AST_FLAG_DISABLE_WORKAROUNDS = (1 << 20),
 /*!
 * Disable device state event caching. This allows channel
 * drivers to selectively prevent device state events from being
 * cached by certain channels such as anonymous calls which have
 * no persistent represenatation that can be tracked.
 */
 AST_FLAG_DISABLE_DEVSTATE_CACHE = (1 << 21),
 /*!
 * This flag indicates that a dual channel redirect is in
 * progress. The bridge needs to wait until the flag is cleared
 * to continue.
 */
 AST_FLAG_BRIDGE_DUAL_REDIRECT_WAIT = (1 << 22),
 /*!
 * This flag indicates that the channel was originated.
 */
 AST_FLAG_ORIGINATED = (1 << 23),
 /*!
 * The channel is well and truly dead. Once this is set and published, no further
 * actions should be taken upon the channel, and no further publications should
 * occur.
 */
 AST_FLAG_DEAD = (1 << 24),
 /*!
 * Channel snapshot should not be published, it is being staged for an explicit
 * publish.
 */
 AST_FLAG_SNAPSHOT_STAGE = (1 << 25),
 /*!
 * The data on chan->timingdata is an astobj2 object.
 */
 AST_FLAG_TIMINGDATA_IS_AO2_OBJ = (1 << 26),
 /*!
 * The channel is executing a subroutine or macro
 */
 AST_FLAG_SUBROUTINE_EXEC = (1 << 27),
};

anonymous enum

anonymous enum

ast_bridge_config flags

Enumerator
AST_FEATURE_PLAY_WARNING
AST_FEATURE_REDIRECT
AST_FEATURE_DISCONNECT
AST_FEATURE_ATXFER
AST_FEATURE_AUTOMON
AST_FEATURE_PARKCALL
AST_FEATURE_AUTOMIXMON

Definition at line 1063 of file channel.h.

 {
 AST_FEATURE_PLAY_WARNING = (1 << 0),
 AST_FEATURE_REDIRECT = (1 << 1),
 AST_FEATURE_DISCONNECT = (1 << 2),
 AST_FEATURE_ATXFER = (1 << 3),
 AST_FEATURE_AUTOMON = (1 << 4),
 AST_FEATURE_PARKCALL = (1 << 5),
 AST_FEATURE_AUTOMIXMON = (1 << 6),
};

anonymous enum

anonymous enum

Enumerator
AST_SOFTHANGUP_DEV	Soft hangup requested by device or other internal reason. Actual hangup needed.
AST_SOFTHANGUP_ASYNCGOTO	Used to break the normal frame flow so an async goto can be done instead of actually hanging up.
AST_SOFTHANGUP_SHUTDOWN	Soft hangup requested by system shutdown. Actual hangup needed.
AST_SOFTHANGUP_TIMEOUT	Used to break the normal frame flow after a timeout so an implicit async goto can be done to the 'T' exten if it exists instead of actually hanging up. If the exten does not exist then actually hangup.
AST_SOFTHANGUP_APPUNLOAD	Soft hangup requested by application/channel-driver being unloaded. Actual hangup needed.
AST_SOFTHANGUP_EXPLICIT	Soft hangup requested by non-associated party. Actual hangup needed.
AST_SOFTHANGUP_HANGUP_EXEC	Used to indicate that the channel is currently executing hangup logic in the dialplan. The channel has been hungup when this is set.
AST_SOFTHANGUP_ALL	All softhangup flags. This can be used as an argument to ast_channel_clear_softhangup() to clear all softhangup flags from a channel.

Definition at line 1117 of file channel.h.

 {
 /*!
 * Soft hangup requested by device or other internal reason.
 * Actual hangup needed.
 */
 AST_SOFTHANGUP_DEV = (1 << 0),
 /*!
 * Used to break the normal frame flow so an async goto can be
 * done instead of actually hanging up.
 */
 AST_SOFTHANGUP_ASYNCGOTO = (1 << 1),
 /*!
 * Soft hangup requested by system shutdown. Actual hangup
 * needed.
 */
 AST_SOFTHANGUP_SHUTDOWN = (1 << 2),
 /*!
 * Used to break the normal frame flow after a timeout so an
 * implicit async goto can be done to the 'T' exten if it exists
 * instead of actually hanging up. If the exten does not exist
 * then actually hangup.
 */
 AST_SOFTHANGUP_TIMEOUT = (1 << 3),
 /*!
 * Soft hangup requested by application/channel-driver being
 * unloaded. Actual hangup needed.
 */
 AST_SOFTHANGUP_APPUNLOAD = (1 << 4),
 /*!
 * Soft hangup requested by non-associated party. Actual hangup
 * needed.
 */
 AST_SOFTHANGUP_EXPLICIT = (1 << 5),
 /*!
 * Used to indicate that the channel is currently executing hangup
 * logic in the dialplan. The channel has been hungup when this is
 * set.
 */
 AST_SOFTHANGUP_HANGUP_EXEC = (1 << 7),
 /*!
 * \brief All softhangup flags.
 *
 * This can be used as an argument to ast_channel_clear_softhangup()
 * to clear all softhangup flags from a channel.
 */
 AST_SOFTHANGUP_ALL = (0xFFFFFFFF)
};

ama_flags

enum ama_flags

Channel AMA Flags.

Enumerator
AST_AMA_NONE
AST_AMA_OMIT
AST_AMA_BILLING
AST_AMA_DOCUMENTATION

Definition at line 1178 of file channel.h.

 {
 AST_AMA_NONE = 0,
 AST_AMA_OMIT,
 AST_AMA_BILLING,
 AST_AMA_DOCUMENTATION,
};

ast_bridge_result

enum ast_bridge_result

Enumerator
AST_BRIDGE_COMPLETE
AST_BRIDGE_FAILED
AST_BRIDGE_FAILED_NOWARN
AST_BRIDGE_RETRY

Definition at line 207 of file channel.h.

 {
 AST_BRIDGE_COMPLETE = 0,
 AST_BRIDGE_FAILED = -1,
 AST_BRIDGE_FAILED_NOWARN = -2,
 AST_BRIDGE_RETRY = -3,
};

ast_channel_adsicpe

enum ast_channel_adsicpe

Enumerator
AST_ADSI_UNKNOWN
AST_ADSI_AVAILABLE
AST_ADSI_UNAVAILABLE
AST_ADSI_OFFHOOKONLY

Definition at line 869 of file channel.h.

 {
 AST_ADSI_UNKNOWN,
 AST_ADSI_AVAILABLE,
 AST_ADSI_UNAVAILABLE,
 AST_ADSI_OFFHOOKONLY,
};

ast_channel_error

enum ast_channel_error

Enumerator
AST_CHANNEL_ERROR_UNKNOWN
AST_CHANNEL_ERROR_ID_EXISTS

Definition at line 5020 of file channel.h.

 {
 /* Unable to determine what error occurred. */
 AST_CHANNEL_ERROR_UNKNOWN,
 /* Channel with this ID already exists */
 AST_CHANNEL_ERROR_ID_EXISTS,
};

ast_channel_requestor_relationship

enum ast_channel_requestor_relationship

Enumerator
AST_CHANNEL_REQUESTOR_BRIDGE_PEER	The requestor is the future bridge peer of the channel.
AST_CHANNEL_REQUESTOR_REPLACEMENT	The requestor is to be replaced by the channel.

Definition at line 1477 of file channel.h.

 {
 /*! The requestor is the future bridge peer of the channel. */
 AST_CHANNEL_REQUESTOR_BRIDGE_PEER,
 /*! The requestor is to be replaced by the channel. */
 AST_CHANNEL_REQUESTOR_REPLACEMENT,
};

AST_MONITORING_STATE

enum AST_MONITORING_STATE

Enumerator
AST_MONITOR_RUNNING
AST_MONITOR_PAUSED

Definition at line 4233 of file channel.h.

 {
 AST_MONITOR_RUNNING,
 AST_MONITOR_PAUSED
};

AST_PARTY_CHAR_SET

enum AST_PARTY_CHAR_SET

Party name character set enumeration values (values from Q.SIG)

Enumerator
AST_PARTY_CHAR_SET_UNKNOWN
AST_PARTY_CHAR_SET_ISO8859_1
AST_PARTY_CHAR_SET_WITHDRAWN
AST_PARTY_CHAR_SET_ISO8859_2
AST_PARTY_CHAR_SET_ISO8859_3
AST_PARTY_CHAR_SET_ISO8859_4
AST_PARTY_CHAR_SET_ISO8859_5
AST_PARTY_CHAR_SET_ISO8859_7
AST_PARTY_CHAR_SET_ISO10646_BMPSTRING
AST_PARTY_CHAR_SET_ISO10646_UTF_8STRING

Definition at line 243 of file channel.h.

 {
 AST_PARTY_CHAR_SET_UNKNOWN = 0,
 AST_PARTY_CHAR_SET_ISO8859_1 = 1,
 AST_PARTY_CHAR_SET_WITHDRAWN = 2,/* ITU withdrew this enum value. */
 AST_PARTY_CHAR_SET_ISO8859_2 = 3,
 AST_PARTY_CHAR_SET_ISO8859_3 = 4,
 AST_PARTY_CHAR_SET_ISO8859_4 = 5,
 AST_PARTY_CHAR_SET_ISO8859_5 = 6,
 AST_PARTY_CHAR_SET_ISO8859_7 = 7,
 AST_PARTY_CHAR_SET_ISO10646_BMPSTRING = 8,
 AST_PARTY_CHAR_SET_ISO10646_UTF_8STRING = 9,
};

ast_t38_state

enum ast_t38_state

Possible T38 states on channels.

Enumerator
T38_STATE_UNAVAILABLE	T38 is unavailable on this channel or disabled by configuration
T38_STATE_UNKNOWN	The channel supports T38 but the current status is unknown
T38_STATE_NEGOTIATING	T38 is being negotiated
T38_STATE_REJECTED	Remote side has rejected our offer
T38_STATE_NEGOTIATED	T38 established

Definition at line 879 of file channel.h.

 {
 T38_STATE_UNAVAILABLE, /*!< T38 is unavailable on this channel or disabled by configuration */
 T38_STATE_UNKNOWN, /*!< The channel supports T38 but the current status is unknown */
 T38_STATE_NEGOTIATING, /*!< T38 is being negotiated */
 T38_STATE_REJECTED, /*!< Remote side has rejected our offer */
 T38_STATE_NEGOTIATED, /*!< T38 established */
};

channelreloadreason

enum channelreloadreason

Channel reload reasons for manager events at load or reload of configuration.

Enumerator
CHANNEL_MODULE_LOAD
CHANNEL_MODULE_RELOAD
CHANNEL_CLI_RELOAD
CHANNEL_MANAGER_RELOAD
CHANNEL_ACL_RELOAD

Definition at line 1167 of file channel.h.

 {
 CHANNEL_MODULE_LOAD,
 CHANNEL_MODULE_RELOAD,
 CHANNEL_CLI_RELOAD,
 CHANNEL_MANAGER_RELOAD,
 CHANNEL_ACL_RELOAD,
};

Function Documentation

__ast_answer()

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

Answer a channel, with a selectable delay before returning.

Parameters

chan	channel to answer
delay	maximum amount of time to wait for incoming media

This function answers a channel and handles all necessary call setup functions.

Note

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

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

Return values

0	on success
non-zero	on failure

Definition at line 2704 of file channel.c.

References ast_channel_lock, ast_channel_name(), ast_channel_unlock, AST_CONTROL_HANGUP, ast_debug, AST_FRAME_BRIDGE_ACTION, AST_FRAME_BRIDGE_ACTION_SYNC, AST_FRAME_CNG, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, AST_FRAME_HTML, AST_FRAME_IAX, AST_FRAME_IMAGE, AST_FRAME_MODEM, AST_FRAME_NULL, AST_FRAME_RTCP, AST_FRAME_TEXT, AST_FRAME_TEXT_DATA, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_frfree, ast_frisolate, AST_LIST_HEAD_INIT_NOLOCK, AST_LIST_HEAD_NOLOCK(), AST_LIST_INSERT_HEAD, AST_LIST_REMOVE_HEAD, ast_log, ast_queue_frame_head(), ast_raw_answer(), ast_read(), ast_remaining_ms(), AST_STATE_RING, AST_STATE_RINGING, ast_tvnow(), ast_waitfor(), done, errno, frames, ast_frame::frametype, ast_frame_subclass::integer, LOG_WARNING, MAX, SCOPE_TRACE, and ast_frame::subclass.

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

{
 int res = 0;
 enum ast_channel_state old_state;
 SCOPE_TRACE(1, "%s\n", ast_channel_name(chan));

 old_state = ast_channel_state(chan);
 if ((res = ast_raw_answer(chan))) {
 return res;
 }

 switch (old_state) {
 case AST_STATE_RINGING:
 case AST_STATE_RING:
 /* wait for media to start flowing, but don't wait any longer
 * than 'delay' or 500 milliseconds, whichever is longer
 */
 do {
 AST_LIST_HEAD_NOLOCK(, ast_frame) frames;
 struct ast_frame *cur;
 struct ast_frame *new_frame;
 int timeout_ms = MAX(delay, 500);
 unsigned int done = 0;
 struct timeval start;

 AST_LIST_HEAD_INIT_NOLOCK(&frames);

 start = ast_tvnow();
 for (;;) {
 int ms = ast_remaining_ms(start, timeout_ms);
 ms = ast_waitfor(chan, ms);
 if (ms < 0) {
 ast_log(LOG_WARNING, "Error condition occurred when polling channel %s for a voice frame: %s\n", ast_channel_name(chan), strerror(errno));
 res = -1;
 break;
 }
 if (ms == 0) {
 ast_debug(2, "Didn't receive a media frame from %s within %u ms of answering. Continuing anyway\n", ast_channel_name(chan), MAX(delay, 500));
 break;
 }
 cur = ast_read(chan);
 if (!cur || ((cur->frametype == AST_FRAME_CONTROL) &&
 (cur->subclass.integer == AST_CONTROL_HANGUP))) {
 if (cur) {
 ast_frfree(cur);
 }
 res = -1;
 ast_debug(2, "Hangup of channel %s detected in answer routine\n", ast_channel_name(chan));
 break;
 }

 if ((new_frame = ast_frisolate(cur)) != cur) {
 ast_frfree(cur);
 }

 AST_LIST_INSERT_HEAD(&frames, new_frame, frame_list);

 /* if a specific delay period was requested, continue
 * until that delay has passed. don't stop just because
 * incoming media has arrived.
 */
 if (delay) {
 continue;
 }

 switch (new_frame->frametype) {
 /* all of these frametypes qualify as 'media' */
 case AST_FRAME_VOICE:
 case AST_FRAME_VIDEO:
 case AST_FRAME_TEXT:
 case AST_FRAME_TEXT_DATA:
 case AST_FRAME_DTMF_BEGIN:
 case AST_FRAME_DTMF_END:
 case AST_FRAME_IMAGE:
 case AST_FRAME_HTML:
 case AST_FRAME_MODEM:
 case AST_FRAME_RTCP:
 done = 1;
 break;
 case AST_FRAME_CONTROL:
 case AST_FRAME_IAX:
 case AST_FRAME_BRIDGE_ACTION:
 case AST_FRAME_BRIDGE_ACTION_SYNC:
 case AST_FRAME_NULL:
 case AST_FRAME_CNG:
 break;
 }

 if (done) {
 break;
 }
 }

 ast_channel_lock(chan);
 while ((cur = AST_LIST_REMOVE_HEAD(&frames, frame_list))) {
 if (res == 0) {
 ast_queue_frame_head(chan, cur);
 }
 ast_frfree(cur);
 }
 ast_channel_unlock(chan);
 } while (0);
 break;
 default:
 break;
 }

 return res;
}

__ast_channel_alloc()

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 struct ast_assigned_ids *	assignedids,
		const struct ast_channel *	requestor,
		enum ama_flags	amaflag,
		struct ast_endpoint *	endpoint,
		const char *	file,
		int	line,
		const char *	function,
		const char *	name_fmt,
			...
	)

Create a channel structure.

Since

1.8

Return values

NULL	failure
non-NULL	successfully allocated channel

Note

Absolutely NO channel locks should be held before calling this function.

By default, new channels are set to the "s" extension and "default" context.

Since 12.0.0 this function returns with the newly created channel locked.

Definition at line 960 of file channel.c.

References __ast_channel_alloc_ap(), and result.

{
 va_list ap;
 struct ast_channel *result;

 va_start(ap, name_fmt);
 result = __ast_channel_alloc_ap(needqueue, state, cid_num, cid_name, acctcode, exten, context,
 assignedids, requestor, amaflag, endpoint, file, line, function, name_fmt, ap);
 va_end(ap);

 return result;
}

__ast_dummy_channel_alloc()

struct ast_channel* __ast_dummy_channel_alloc	(	const char *	file,
		int	line,
		const char *	function
	)

Definition at line 981 of file channel.c.

References __ast_channel_internal_alloc(), ast_channel_datastores(), ast_channel_hold_state_set(), ast_channel_internal_alertpipe_clear(), ast_channel_internal_fd_clear_all(), ast_channel_internal_setup_topics(), ast_channel_timingfd_set(), ast_channel_varshead(), AST_CONTROL_UNHOLD, ast_dummy_channel_destructor(), AST_LIST_HEAD_INIT_NOLOCK, ast_pbx_hangup_handler_init(), NULL, and tmp().

{
 struct ast_channel *tmp;
 struct varshead *headp;

 tmp = __ast_channel_internal_alloc(ast_dummy_channel_destructor, NULL, NULL,
 file, line, function);
 if (!tmp) {
 /* Dummy channel structure allocation failure. */
 return NULL;
 }

 ast_pbx_hangup_handler_init(tmp);
 AST_LIST_HEAD_INIT_NOLOCK(ast_channel_datastores(tmp));

 /*
 * Init file descriptors to unopened state just in case
 * autoservice is called on the channel or something tries to
 * read a frame from it.
 */
 ast_channel_timingfd_set(tmp, -1);
 ast_channel_internal_alertpipe_clear(tmp);
 ast_channel_internal_fd_clear_all(tmp);

 ast_channel_hold_state_set(tmp, AST_CONTROL_UNHOLD);

 ast_channel_internal_setup_topics(tmp);

 headp = ast_channel_varshead(tmp);
 AST_LIST_HEAD_INIT_NOLOCK(headp);

 return tmp;
}

__ast_request_and_dial()

struct ast_channel* __ast_request_and_dial	(	const char *	type,
		struct ast_format_cap *	cap,
		const struct ast_assigned_ids *	assignedids,
		const struct ast_channel *	requestor,
		const char *	addr,
		int	timeout,
		int *	reason,
		const char *	cid_num,
		const char *	cid_name,
		struct outgoing_helper *	oh
	)

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

Parameters

type	type of channel to request
cap	format capabilities for requested channel
assignedids	Unique Id to assign to channel
requestor	channel requesting data
addr	destination of the call
timeout	maximum amount of time to wait for an answer
reason	why unsuccessful (if unsuccessful)
cid_num	Caller-ID Number
cid_name	Caller-ID Name (ascii)
oh	Outgoing helper

Returns

Returns an ast_channel on success or no answer, NULL on failure. Check the value of chan->_state to know if the call was answered or not.

Definition at line 6066 of file channel.c.

References outgoing_helper::account, ast_call(), ast_call_forward(), AST_CAUSE_NO_ANSWER, ast_channel_call_forward(), ast_channel_connected(), ast_channel_context_set(), ast_channel_datastore_inherit(), ast_channel_exten_set(), ast_channel_flags(), ast_channel_hangupcause_hash_set(), ast_channel_hangupcause_set(), ast_channel_inherit_variables(), ast_channel_lock, ast_channel_lock_both, ast_channel_priority_set(), ast_channel_req_accountcodes(), AST_CHANNEL_REQUESTOR_BRIDGE_PEER, ast_channel_set_connected_line(), ast_channel_stage_snapshot(), ast_channel_stage_snapshot_done(), ast_channel_unlock, AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CC, AST_CONTROL_CONGESTION, AST_CONTROL_CONNECTED_LINE, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_INCOMPLETE, AST_CONTROL_PROCEEDING, AST_CONTROL_PROGRESS, AST_CONTROL_PVT_CAUSE_CODE, AST_CONTROL_REDIRECTING, AST_CONTROL_RINGING, AST_CONTROL_SRCCHANGE, AST_CONTROL_SRCUPDATE, AST_CONTROL_UNHOLD, AST_CONTROL_VIDUPDATE, AST_FLAG_ORIGINATED, AST_FRAME_CONTROL, ast_frfree, ast_hangup(), ast_log, ast_max_forwards_decrement(), ast_party_connected_line_set_init(), AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED, ast_read(), ast_remaining_ms(), ast_request(), ast_set_callerid(), ast_set_flag, ast_set_variables(), AST_STATE_UP, ast_strlen_zero, ast_tvnow(), ast_waitfor(), chanlist::chan, outgoing_helper::cid_name, outgoing_helper::cid_num, outgoing_helper::connect_on_early_media, outgoing_helper::context, ast_frame::data, ast_frame::datalen, outgoing_helper::exten, ast_frame::frametype, handle_cause(), ast_party_connected_line::id, ast_frame_subclass::integer, LOG_NOTICE, ast_party_id::name, NULL, ast_party_id::number, outgoing_helper::parent_channel, ast_party_name::presentation, ast_party_number::presentation, outgoing_helper::priority, ast_frame::ptr, ast_party_name::str, ast_party_number::str, ast_frame::subclass, ast_party_name::valid, ast_party_number::valid, and outgoing_helper::vars.

Referenced by announce_to_dial(), and ast_request_and_dial().

{
 int dummy_outstate;
 int cause = 0;
 struct ast_channel *chan;
 int res = 0;
 int last_subclass = 0;
 struct ast_party_connected_line connected;

 if (outstate)
 *outstate = 0;
 else
 outstate = &dummy_outstate; /* make outstate always a valid pointer */

 chan = ast_request(type, cap, assignedids, requestor, addr, &cause);
 if (!chan) {
 ast_log(LOG_NOTICE, "Unable to request channel %s/%s\n", type, addr);
 handle_cause(cause, outstate);
 return NULL;
 }

 if (oh) {
 if (oh->vars) {
 ast_channel_lock(chan);
 ast_set_variables(chan, oh->vars);
 ast_channel_unlock(chan);
 }
 if (!ast_strlen_zero(oh->cid_num) && !ast_strlen_zero(oh->cid_name)) {
 /*
 * Use the oh values instead of the function parameters for the
 * outgoing CallerID.
 */
 cid_num = oh->cid_num;
 cid_name = oh->cid_name;
 }
 if (oh->parent_channel) {
 /* Safely inherit variables and datastores from the parent channel. */
 ast_channel_lock_both(oh->parent_channel, chan);
 ast_channel_inherit_variables(oh->parent_channel, chan);
 ast_channel_datastore_inherit(oh->parent_channel, chan);
 ast_max_forwards_decrement(chan);
 ast_channel_unlock(oh->parent_channel);
 ast_channel_unlock(chan);
 }
 if (!ast_strlen_zero(oh->account)) {
 ast_channel_lock(chan);
 ast_channel_stage_snapshot(chan);
 ast_channel_accountcode_set(chan, oh->account);
 ast_channel_peeraccount_set(chan, oh->account);
 ast_channel_stage_snapshot_done(chan);
 ast_channel_unlock(chan);
 }
 }

 /*
 * I seems strange to set the CallerID on an outgoing call leg
 * to whom we are calling, but this function's callers are doing
 * various Originate methods. This call leg goes to the local
 * user. Once the local user answers, the dialplan needs to be
 * able to access the CallerID from the CALLERID function as if
 * the local user had placed this call.
 */
 ast_set_callerid(chan, cid_num, cid_name, cid_num);

 ast_channel_lock(chan);
 ast_set_flag(ast_channel_flags(chan), AST_FLAG_ORIGINATED);
 ast_channel_unlock(chan);
 ast_party_connected_line_set_init(&connected, ast_channel_connected(chan));
 if (cid_num) {
 connected.id.number.valid = 1;
 connected.id.number.str = (char *) cid_num;
 connected.id.number.presentation = AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED;
 }
 if (cid_name) {
 connected.id.name.valid = 1;
 connected.id.name.str = (char *) cid_name;
 connected.id.name.presentation = AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED;
 }
 ast_channel_set_connected_line(chan, &connected, NULL);
 if (requestor) {
 ast_channel_lock_both(chan, (struct ast_channel *) requestor);
 ast_channel_req_accountcodes(chan, requestor, AST_CHANNEL_REQUESTOR_BRIDGE_PEER);
 ast_channel_unlock(chan);
 ast_channel_unlock((struct ast_channel *) requestor);
 }

 if (ast_call(chan, addr, 0)) { /* ast_call failed... */
 ast_log(LOG_NOTICE, "Unable to call channel %s/%s\n", type, addr);
 } else {
 struct timeval start = ast_tvnow();
 res = 1; /* mark success in case chan->_state is already AST_STATE_UP */
 while (timeout && ast_channel_state(chan) != AST_STATE_UP) {
 struct ast_frame *f;
 int ms = ast_remaining_ms(start, timeout);

 res = ast_waitfor(chan, ms);
 if (res == 0) { /* timeout, treat it like ringing */
 *outstate = AST_CONTROL_RINGING;
 break;
 }
 if (res < 0) /* error or done */
 break;
 if (!ast_strlen_zero(ast_channel_call_forward(chan))) {
 if (!(chan = ast_call_forward(NULL, chan, NULL, cap, oh, outstate))) {
 return NULL;
 }
 continue;
 }

 f = ast_read(chan);
 if (!f) {
 *outstate = AST_CONTROL_HANGUP;
 res = 0;
 break;
 }
 if (f->frametype == AST_FRAME_CONTROL) {
 switch (f->subclass.integer) {
 case AST_CONTROL_RINGING: /* record but keep going */
 *outstate = f->subclass.integer;
 break;

 case AST_CONTROL_BUSY:
 *outstate = f->subclass.integer;
 timeout = 0;
 break;

 case AST_CONTROL_INCOMPLETE:
 *outstate = AST_CONTROL_CONGESTION;
 timeout = 0;
 break;

 case AST_CONTROL_CONGESTION:
 *outstate = f->subclass.integer;
 timeout = 0;
 break;

 case AST_CONTROL_ANSWER:
 *outstate = f->subclass.integer;
 timeout = 0; /* trick to force exit from the while() */
 break;

 case AST_CONTROL_PVT_CAUSE_CODE:
 ast_channel_hangupcause_hash_set(chan, f->data.ptr, f->datalen);
 break;

 case AST_CONTROL_PROGRESS:
 if (oh && oh->connect_on_early_media) {
 *outstate = f->subclass.integer;
 timeout = 0; /* trick to force exit from the while() */
 break;
 }
 /* Fallthrough */
 /* Ignore these */
 case AST_CONTROL_PROCEEDING:
 case AST_CONTROL_HOLD:
 case AST_CONTROL_UNHOLD:
 case AST_CONTROL_VIDUPDATE:
 case AST_CONTROL_SRCUPDATE:
 case AST_CONTROL_SRCCHANGE:
 case AST_CONTROL_CONNECTED_LINE:
 case AST_CONTROL_REDIRECTING:
 case AST_CONTROL_CC:
 case -1: /* Ignore -- just stopping indications */
 break;

 default:
 ast_log(LOG_NOTICE, "Don't know what to do with control frame %d\n", f->subclass.integer);
 }
 last_subclass = f->subclass.integer;
 }
 ast_frfree(f);
 }
 }

 /* Final fixups */
 if (oh) {
 if (!ast_strlen_zero(oh->context))
 ast_channel_context_set(chan, oh->context);
 if (!ast_strlen_zero(oh->exten))
 ast_channel_exten_set(chan, oh->exten);
 if (oh->priority)
 ast_channel_priority_set(chan, oh->priority);
 }
 if (ast_channel_state(chan) == AST_STATE_UP)
 *outstate = AST_CONTROL_ANSWER;

 if (res <= 0) {
 ast_channel_lock(chan);
 if (AST_CONTROL_RINGING == last_subclass) {
 ast_channel_hangupcause_set(chan, AST_CAUSE_NO_ANSWER);
 }
 ast_channel_unlock(chan);
 ast_hangup(chan);
 chan = NULL;
 }
 return chan;
}

ast_activate_generator()

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

Activate a given generator

Examples:

/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 2960 of file channel.c.

References ast_generator::alloc, ast_channel_generator(), ast_channel_generator_set(), ast_channel_generatordata(), ast_channel_generatordata_set(), ast_channel_lock, ast_channel_unlock, ast_prod(), ast_settimeout(), generator_force(), ast_channel::generatordata, NULL, and ast_generator::release.

Referenced by app_exec(), ast_channel_start_silence_generator(), ast_linear_stream(), ast_playtones_start(), ast_tonepair_start(), channel_spy(), eivr_comm(), local_ast_moh_start(), old_milliwatt_exec(), sms_exec(), spandsp_fax_gateway_start(), and transmit_audio().

{
 int res = 0;
 void *generatordata = NULL;

 ast_channel_lock(chan);
 if (ast_channel_generatordata(chan)) {
 struct ast_generator *generator_old = ast_channel_generator(chan);

 if (generator_old && generator_old->release) {
 generator_old->release(chan, ast_channel_generatordata(chan));
 }
 }
 if (gen->alloc && !(generatordata = gen->alloc(chan, params))) {
 res = -1;
 }
 ast_channel_generatordata_set(chan, generatordata);
 if (!res) {
 ast_settimeout(chan, 50, generator_force, chan);
 ast_channel_generator_set(chan, gen);
 }
 ast_channel_unlock(chan);

 ast_prod(chan);

 return res;
}

ast_active_channels()

int ast_active_channels

(

void

)

returns number of active/allocated channels

Returns

number of channels available for lookup

Definition at line 499 of file channel.c.

References ao2_container_count().

Referenced by action_corestatus(), ast_var_channels(), ast_var_channels_table(), dahdi_restart(), handle_chanlist(), handle_show_settings(), and really_quit().

{
 return channels ? ao2_container_count(channels) : 0;
}

ast_add_fd()

static int ast_add_fd ( struct pollfd *  pfd, int  fd  )

inlinestatic

if fd is a valid descriptor, set *pfd with the descriptor

Returns

Return 1 (not -1!) if added, 0 otherwise (so we can add the return value to the index into the array)

Definition at line 2842 of file channel.h.

Referenced by ast_waitfor_nandfds().

{
 pfd->fd = fd;
 pfd->events = POLLIN | POLLPRI;
 return fd >= 0;
}

ast_answer()

int ast_answer

(

struct ast_channel *

chan

)

Answer a channel.

Parameters

chan	channel to answer

This function answers a channel and handles all necessary call setup functions.

Note

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

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

Return values

0	on success
non-zero	on failure

Definition at line 2814 of file channel.c.

References __ast_answer(), ast_channel_name(), and SCOPE_TRACE.

Referenced by agent_login_exec(), agi_exec_full(), alarmreceiver_exec(), announce_request(), answer_trunk_chan(), app_exec(), ast_auto_answer(), ast_bridge_add_channel(), ast_do_pickup(), ast_pickup_call(), auth_exec(), background_detect_exec(), bridge_channel_handle_control(), bridge_parking_push(), bridgeadd_exec(), bridgewait_exec(), common_exec(), conf_exec(), conf_start_record(), confbridge_exec(), count_exec(), dahdiras_exec(), dial_exec_full(), dictate_exec(), directory_exec(), disa_exec(), eivr_comm(), handle_answer(), ices_exec(), leave_voicemail(), local_call(), media_request_helper(), minivm_accmess_exec(), minivm_greet_exec(), minivm_record_exec(), old_milliwatt_exec(), park_app_exec(), parked_call_app_exec(), pbx_builtin_background(), playback_exec(), privacy_exec(), read_exec(), readexten_exec(), receivefax_exec(), record_exec(), sayunixtime_exec(), send_waveform_to_channel(), sendfax_exec(), setup_privacy_args(), skel_exec(), sla_station_exec(), sms_exec(), speech_background(), testclient_exec(), testserver_exec(), transmit(), vm_exec(), vm_execmain(), vm_playmsgexec(), waitfor_exec(), and zapateller_exec().

{
 SCOPE_TRACE(1, "%s\n", ast_channel_name(chan));
 return __ast_answer(chan, 0);
}

ast_auto_answer()

int ast_auto_answer ( struct ast_channel *  chan )

inline

Answer a channel, if it's not already answered.

Parameters

chan	channel to answer

See ast_answer()

Return values

0	on success
non-zero	on failure

Definition at line 2820 of file channel.c.

References ast_answer(), and AST_STATE_UP.

Referenced by record_file().

{
 if (ast_channel_state(chan) == AST_STATE_UP) {
 /* Already answered */
 return 0;
 }
 return ast_answer(chan);
}

ast_autoservice_chan_hangup_peer()

void ast_autoservice_chan_hangup_peer	(	struct ast_channel *	chan,
		struct ast_channel *	peer
	)

Put chan into autoservice while hanging up peer.

Since

11.0

Parameters

chan	Chan to put into autoservice.
peer	Chan to run hangup handlers and hangup.

Returns

Nothing

Definition at line 342 of file autoservice.c.

References ast_autoservice_start(), ast_autoservice_stop(), and ast_hangup().

Referenced by app_exec(), bridge_failed_peer_goto(), dial_exec_full(), and try_calling().

{
 if (chan && !ast_autoservice_start(chan)) {
 ast_hangup(peer);
 ast_autoservice_stop(chan);
 } else {
 ast_hangup(peer);
 }
}

ast_autoservice_ignore()

int ast_autoservice_ignore	(	struct ast_channel *	chan,
		enum ast_frame_type	ftype
	)

Ignore certain frame types.

Note

Normally, we cache DTMF, IMAGE, HTML, TEXT, and CONTROL frames while a channel is in autoservice and queue them up when taken out of autoservice. When this is not desireable, this API may be used to cause the channel to ignore those frametypes after the channel is put into autoservice, but before autoservice is stopped.

Return values

0	success
-1	channel is not in autoservice

Definition at line 352 of file autoservice.c.

References AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, asent::chan, asent::ignore_frame_types, and asent::list.

{
 struct asent *as;
 int res = -1;

 AST_LIST_LOCK(&aslist);
 AST_LIST_TRAVERSE(&aslist, as, list) {
 if (as->chan == chan) {
 res = 0;
 as->ignore_frame_types |= (1 << ftype);
 break;
 }
 }
 AST_LIST_UNLOCK(&aslist);
 return res;
}

ast_autoservice_start()

int ast_autoservice_start

(

struct ast_channel *

chan

)

Automatically service a channel for us...

Return values

0	success
-1	failure, or the channel is already being autoserviced

Examples:

/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 200 of file autoservice.c.

References as_cond, ast_calloc, ast_channel_flags(), ast_channel_lock, ast_channel_name(), ast_channel_unlock, ast_cond_signal, ast_debug, AST_FLAG_END_DTMF_ONLY, ast_free, AST_LIST_EMPTY, AST_LIST_INSERT_HEAD, AST_LIST_LOCK, AST_LIST_REMOVE, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log, ast_pthread_create_background, AST_PTHREADT_NULL, ast_set_flag, ast_test_flag, ast_thread_is_user_interface(), asthread, autoservice_run(), asent::chan, asent::list, LOG_WARNING, NULL, asent::orig_end_dtmf_flag, and asent::use_count.

Referenced by _macro_exec(), acf_curl_helper(), acf_jabberreceive_read(), acf_odbc_read(), acf_odbc_write(), action_toggle_mute_participants(), app_exec(), ast_app_exec_macro(), ast_app_exec_sub(), ast_audiosocket_connect(), ast_autoservice_chan_hangup_peer(), ast_dtmf_stream(), ast_get_enum(), ast_get_srv(), ast_get_txt(), ast_mf_stream(), begin_dial_prerun(), conf_play(), confbridge_exec(), dial_exec_full(), exec(), findmeexec(), function_realtime_read(), function_realtime_readdestroy(), function_realtime_store(), function_realtime_write(), join_conference_bridge(), lock_read(), lua_autoservice_start(), lua_get_variable_value(), lua_pbx_exec(), lua_set_variable(), lua_set_variable_value(), originate_exec(), osplookup_exec(), pbx_find_extension(), playback_common(), post_join_play_begin(), push_announcer(), realtimefield_read(), ring_one(), shell_helper(), sla_station_exec(), smdi_msg_retrieve_read(), srv_datastore_setup(), system_exec_helper(), try_calling(), trylock_read(), and valid_priv_reply().

{
 int res = 0;
 struct asent *as;

 if (ast_thread_is_user_interface()) {
 /* User interface threads do not handle channel media. */
 ast_debug(1, "Thread is a user interface, not putting channel %s into autoservice\n",
 ast_channel_name(chan));
 return 0;
 }

 AST_LIST_LOCK(&aslist);
 AST_LIST_TRAVERSE(&aslist, as, list) {
 if (as->chan == chan) {
 as->use_count++;
 break;
 }
 }
 AST_LIST_UNLOCK(&aslist);

 if (as) {
 /* Entry exists, autoservice is already handling this channel */
 return 0;
 }

 if (!(as = ast_calloc(1, sizeof(*as))))
 return -1;

 /* New entry created */
 as->chan = chan;
 as->use_count = 1;

 ast_channel_lock(chan);
 as->orig_end_dtmf_flag = ast_test_flag(ast_channel_flags(chan), AST_FLAG_END_DTMF_ONLY) ? 1 : 0;
 if (!as->orig_end_dtmf_flag)
 ast_set_flag(ast_channel_flags(chan), AST_FLAG_END_DTMF_ONLY);
 ast_channel_unlock(chan);

 AST_LIST_LOCK(&aslist);

 if (AST_LIST_EMPTY(&aslist) && asthread != AST_PTHREADT_NULL) {
 ast_cond_signal(&as_cond);
 }

 AST_LIST_INSERT_HEAD(&aslist, as, list);

 if (asthread == AST_PTHREADT_NULL) { /* need start the thread */
 if (ast_pthread_create_background(&asthread, NULL, autoservice_run, NULL)) {
 ast_log(LOG_WARNING, "Unable to create autoservice thread :(\n");
 /* There will only be a single member in the list at this point,
 the one we just added. */
 AST_LIST_REMOVE(&aslist, as, list);
 ast_free(as);
 asthread = AST_PTHREADT_NULL;
 res = -1;
 } else {
 pthread_kill(asthread, SIGURG);
 }
 }

 AST_LIST_UNLOCK(&aslist);

 return res;
}

ast_autoservice_stop()

int ast_autoservice_stop

(

struct ast_channel *

chan

)

Stop servicing a channel for us...

Note

if chan is locked prior to calling ast_autoservice_stop, it is likely that there will be a deadlock between the thread that calls ast_autoservice_stop and the autoservice thread. It is important that chan is not locked prior to this call

Parameters

chan

Return values

0	success
-1	error, or the channel has been hungup

Examples:

/usr/src/asterisk-18.5.0/main/app.c.

Definition at line 266 of file autoservice.c.

References as_chan_list_state, ast_channel_flags(), ast_channel_lock, ast_channel_name(), ast_channel_softhangup_internal_flag(), ast_channel_unlock, ast_clear_flag, ast_debug, AST_FLAG_END_DTMF_ONLY, ast_free, ast_frfree, AST_LIST_LOCK, AST_LIST_REMOVE_CURRENT, AST_LIST_REMOVE_HEAD, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, AST_LIST_UNLOCK, AST_PTHREADT_NULL, ast_queue_frame_head(), ast_thread_is_user_interface(), asthread, asent::chan, asent::deferred_frames, ast_frame::frametype, asent::ignore_frame_types, asent::list, NULL, asent::orig_end_dtmf_flag, and asent::use_count.

Referenced by _macro_exec(), acf_curl_helper(), acf_jabberreceive_read(), acf_odbc_read(), acf_odbc_write(), action_toggle_mute_participants(), app_exec(), array(), ast_app_exec_macro(), ast_app_exec_sub(), ast_audiosocket_connect(), ast_autoservice_chan_hangup_peer(), ast_dtmf_stream(), ast_get_enum(), ast_get_srv(), ast_get_txt(), ast_hangup(), ast_mf_stream(), begin_dial_prerun(), conf_play(), confbridge_exec(), dial_exec_full(), exec(), findmeexec(), function_realtime_read(), function_realtime_readdestroy(), function_realtime_store(), function_realtime_write(), hangup_playback(), join_conference_bridge(), lock_read(), lua_autoservice_stop(), lua_get_variable_value(), lua_pbx_exec(), lua_set_variable(), lua_set_variable_value(), originate_exec(), osplookup_exec(), pbx_find_extension(), playback_common(), post_join_play_begin(), realtimefield_read(), ring_one(), shell_helper(), sla_station_exec(), smdi_msg_retrieve_read(), srv_datastore_setup(), system_exec_helper(), try_calling(), trylock_read(), and valid_priv_reply().

{
 int res = -1;
 struct asent *as, *removed = NULL;
 struct ast_frame *f;
 int chan_list_state;

 if (ast_thread_is_user_interface()) {
 /* User interface threads do not handle channel media. */
 ast_debug(1, "Thread is a user interface, not removing channel %s from autoservice\n",
 ast_channel_name(chan));
 return 0;
 }

 AST_LIST_LOCK(&aslist);

 /* Save the autoservice channel list state. We _must_ verify that the channel
 * list has been rebuilt before we return. Because, after we return, the channel
 * could get destroyed and we don't want our poor autoservice thread to step on
 * it after its gone! */
 chan_list_state = as_chan_list_state;

 /* Find the entry, but do not free it because it still can be in the
 autoservice thread array */
 AST_LIST_TRAVERSE_SAFE_BEGIN(&aslist, as, list) {
 if (as->chan == chan) {
 as->use_count--;
 if (as->use_count < 1) {
 AST_LIST_REMOVE_CURRENT(list);
 removed = as;
 }
 break;
 }
 }
 AST_LIST_TRAVERSE_SAFE_END;

 if (removed && asthread != AST_PTHREADT_NULL) {
 pthread_kill(asthread, SIGURG);
 }

 AST_LIST_UNLOCK(&aslist);

 if (!removed) {
 return 0;
 }

 /* Wait while autoservice thread rebuilds its list. */
 while (chan_list_state == as_chan_list_state) {
 usleep(1000);
 }

 /* Now autoservice thread should have no references to our entry
 and we can safely destroy it */

 if (!ast_channel_softhangup_internal_flag(chan)) {
 res = 0;
 }

 ast_channel_lock(chan);
 if (!as->orig_end_dtmf_flag) {
 ast_clear_flag(ast_channel_flags(chan), AST_FLAG_END_DTMF_ONLY);
 }

 while ((f = AST_LIST_REMOVE_HEAD(&as->deferred_frames, frame_list))) {
 if (!((1 << f->frametype) & as->ignore_frame_types)) {
 ast_queue_frame_head(chan, f);
 }
 ast_frfree(f);
 }
 ast_channel_unlock(chan);

 ast_free(as);

 return res;
}

ast_call()

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

Make a call.

Note

Absolutely NO channel locks should be held before calling this function.

Parameters

chan	which channel to make the call on
addr	destination of the call
timeout	time to wait on for connect (Doesn't seem to be used.)

Place a call, take no longer than timeout ms.

Return values

0	on success
-1	on failure

Definition at line 6553 of file channel.c.

References ast_channel_flags(), ast_channel_lock, ast_channel_tech(), ast_channel_unlock, ast_check_hangup(), AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, ast_set_flag, ast_test_flag, ast_channel_tech::call, and call().

Referenced by __ast_request_and_dial(), app_control_dial(), ast_call_forward(), attended_transfer_bridge(), begin_dial_channel(), blind_transfer_bridge(), dial_exec_full(), do_forward(), feature_attended_transfer(), findmeexec(), park_local_transfer(), retransfer_enter(), ring_entry(), and wait_for_answer().

{
 /* Place an outgoing call, but don't wait any longer than timeout ms before returning.
 If the remote end does not answer within the timeout, then do NOT hang up, but
 return anyway. */
 int res = -1;
 /* Stop if we're a zombie or need a soft hangup */
 ast_channel_lock(chan);
 if (!ast_test_flag(ast_channel_flags(chan), AST_FLAG_ZOMBIE) && !ast_check_hangup(chan)) {
 if (ast_channel_tech(chan)->call)
 res = ast_channel_tech(chan)->call(chan, addr, timeout);
 ast_set_flag(ast_channel_flags(chan), AST_FLAG_OUTGOING);
 }
 ast_channel_unlock(chan);
 return res;
}

ast_call_forward()

struct ast_channel* ast_call_forward	(	struct ast_channel *	caller,
		struct ast_channel *	orig,
		int *	timeout,
		struct ast_format_cap *	cap,
		struct outgoing_helper *	oh,
		int *	outstate
	)

Forwards a call to a new channel specified by the original channel's call_forward str. If possible, the new forwarded channel is created and returned while the original one is terminated.

Parameters

caller	in channel that requested orig
orig	channel being replaced by the call forward channel
timeout	maximum amount of time to wait for setup of new forward channel
cap	format capabilities for requested channel
oh	outgoing helper used with original channel
outstate	reason why unsuccessful (if uncuccessful)

Returns

Returns the forwarded call's ast_channel on success or NULL on failure

Definition at line 5988 of file channel.c.

References outgoing_helper::account, ast_call(), ast_channel_call_forward(), ast_channel_connected(), ast_channel_context(), ast_channel_lock, ast_channel_lock_both, AST_CHANNEL_NAME, ast_channel_name(), ast_channel_redirecting(), ast_channel_req_accountcodes(), AST_CHANNEL_REQUESTOR_REPLACEMENT, ast_channel_set_flag(), ast_channel_stage_snapshot(), ast_channel_stage_snapshot_done(), ast_channel_unlock,