int errno
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) |
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.
Definition in file channel.h.
Macro Definition Documentation
◆ AST_AGENT_FD
| #define AST_AGENT_FD (AST_MAX_FDS-3) |
◆ 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__)
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.
Definition: channel.c:960
Definition: localtime.c:158
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__)
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.
Definition: channel.c:960
Definition: localtime.c:158
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
◆ 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
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:
Definition: channel.h:1066
Definition: channel.h:1068
Definition: channel.h:1065
Definition: channel.h:1070
Definition: channel.h:1069
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 |
◆ 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.
◆ 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##_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)))
◆ 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 |
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) |
◆ 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) |
◆ ast_acf_write_fn_t
| typedef int(* ast_acf_write_fn_t) (struct ast_channel *chan, const char *function, char *data, const char *value) |
◆ ast_group_t
| typedef unsigned long long ast_group_t |
◆ ast_timing_func_t
Enumeration Type Documentation
◆ anonymous enum
| anonymous enum |
ast_channel_tech Properties
Definition at line 956 of file channel.h.
Channels have this property if they implement send_text_data.
Definition: channel.h:976
Channels have this property if they can accept input with jitter; i.e. most VoIP channels.
Definition: channel.h:961
Channels with this particular technology are an implementation detail of Asterisk and should generall...
Definition: channel.h:972
Channels have this property if they can create jitter; i.e. most VoIP channels.
Definition: channel.h:966
◆ 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.
Definition: channel.h:1008
Definition: channel.h:1059
Definition: channel.h:992
Definition: channel.h:1019
Definition: channel.h:1055
Definition: channel.h:986
Definition: channel.h:1023
Definition: channel.h:1051
Definition: channel.h:1036
Definition: channel.h:982
Definition: channel.h:1015
Definition: channel.h:1046
Definition: channel.h:1002
Definition: channel.h:1005
Definition: channel.h:994
Definition: channel.h:998
Definition: channel.h:984
Definition: channel.h:988
Definition: channel.h:1030
Definition: channel.h:1000
Definition: channel.h:1040
Definition: channel.h:990
◆ 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.
Definition: channel.h:1066
Definition: channel.h:1064
Definition: channel.h:1068
Definition: channel.h:1065
Definition: channel.h:1070
Definition: channel.h:1067
Definition: channel.h:1069
◆ 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.
Definition: channel.h:1132
Definition: channel.h:1149
Definition: channel.h:1122
Definition: channel.h:1139
Definition: channel.h:1127
Definition: channel.h:1144
Definition: channel.h:1155
◆ 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.
Definition: channel.h:1179
Definition: channel.h:1182
Definition: channel.h:1180
Definition: channel.h:1181
◆ 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.
Definition: channel.h:208
Definition: channel.h:209
Definition: channel.h:210
Definition: channel.h:211
◆ 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.
Definition: channel.h:871
Definition: channel.h:870
Definition: channel.h:873
Definition: channel.h:872
◆ 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.
Definition: channel.h:5022
Definition: channel.h:5024
◆ 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.
Definition: channel.h:1479
Definition: channel.h:1481
◆ AST_MONITORING_STATE
| enum AST_MONITORING_STATE |
| Enumerator | |
|---|---|
| AST_MONITOR_RUNNING | |
| AST_MONITOR_PAUSED | |
Definition at line 4233 of file channel.h.
Definition: channel.h:4234
Definition: channel.h:4235
◆ AST_PARTY_CHAR_SET
| enum AST_PARTY_CHAR_SET |
Party name character set enumeration values (values from Q.SIG)
Definition at line 243 of file channel.h.
Definition: channel.h:246
Definition: channel.h:251
Definition: channel.h:250
Definition: channel.h:248
Definition: channel.h:249
Definition: channel.h:244
Definition: channel.h:247
Definition: channel.h:245
◆ ast_t38_state
| enum ast_t38_state |
Possible T38 states on channels.
Definition at line 879 of file channel.h.
Definition: channel.h:881
Definition: channel.h:883
Definition: channel.h:880
Definition: channel.h:882
Definition: channel.h:884
◆ 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.
Definition: channel.h:1171
Definition: channel.h:1168
Definition: channel.h:1169
Definition: channel.h:1172
Definition: channel.h:1170
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().
2736 ast_log(LOG_WARNING, "Error condition occurred when polling channel %s for a voice frame: %s\n", ast_channel_name(chan), strerror(errno));
2741 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));
Definition: include/asterisk/frame.h:137
Definition: include/asterisk/frame.h:114
Definition: channelstate.h:40
Definition: include/asterisk/frame.h:101
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
Definition: include/asterisk/frame.h:118
Definition: include/asterisk/frame.h:116
#define AST_LIST_REMOVE_HEAD(head, field)
Removes and returns the head entry from a list.
Definition: linkedlists.h:832
AST_LIST_HEAD_NOLOCK(contactliststruct, contact)
Definition: include/asterisk/frame.h:135
Definition: include/asterisk/frame.h:107
Definition: include/asterisk/frame.h:105
Definition: res_rtp_asterisk.c:590
Definition: include/asterisk/frame.h:123
Definition: include/asterisk/frame.h:99
Definition: include/asterisk/frame.h:278
int ast_remaining_ms(struct timeval start, int max_ms)
Calculate remaining milliseconds given a starting timestamp and upper bound.
Definition: main/utils.c:2033
Definition: channelstate.h:41
#define AST_LIST_INSERT_HEAD(head, elm, field)
Inserts a list entry at the head of a list.
Definition: linkedlists.h:710
Definition: include/asterisk/frame.h:121
#define ast_frisolate(fr)
Makes a frame independent of any static storage.
Definition: include/asterisk/frame.h:577
#define AST_LIST_HEAD_INIT_NOLOCK(head)
Initializes a list head structure.
Definition: linkedlists.h:680
#define SCOPE_TRACE(level,...)
Print a trace message with details when a scope is entered or existed.
Definition: logger.h:749
const char * ast_channel_name(const struct ast_channel *chan)
int ast_waitfor(struct ast_channel *c, int ms)
Wait for input on a channel.
Definition: channel.c:3171
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
Definition: include/asterisk/frame.h:125
Definition: include/asterisk/frame.h:103
Definition: include/asterisk/frame.h:109
int ast_queue_frame_head(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to the head of a channel's frame queue.
Definition: channel.c:1144
◆ __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.
static struct ast_channel * __ast_channel_alloc_ap(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, va_list ap)
Create a new channel structure.
Definition: channel.c:739
Definition: localtime.c:158
◆ __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().
void ast_channel_internal_alertpipe_clear(struct ast_channel *chan)
Definition: channel_internal_api.c:1135
static void ast_dummy_channel_destructor(void *obj)
Free a dummy channel structure.
Definition: channel.c:2338
void ast_pbx_hangup_handler_init(struct ast_channel *chan)
Init the hangup handler container on a channel.
Definition: pbx_hangup_handler.c:95
struct varshead * ast_channel_varshead(struct ast_channel *chan)
Definition: channel_internal_api.c:932
void ast_channel_internal_fd_clear_all(struct ast_channel *chan)
Definition: channel_internal_api.c:1182
struct ast_datastore_list * ast_channel_datastores(struct ast_channel *chan)
Definition: channel_internal_api.c:868
Definition: chanvars.h:34
void ast_channel_timingfd_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:473
#define AST_LIST_HEAD_INIT_NOLOCK(head)
Initializes a list head structure.
Definition: linkedlists.h:680
Definition: include/asterisk/frame.h:294
void ast_channel_hold_state_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:489
struct ast_channel * __ast_channel_internal_alloc(void(*destructor)(void *obj), const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *file, int line, const char *function)
Definition: channel_internal_api.c:1331
int ast_channel_internal_setup_topics(struct ast_channel *chan)
Definition: channel_internal_api.c:1527
◆ __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().
Definition: include/asterisk/frame.h:293
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...
Definition: channel.c:2045
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.
Definition: channel.c:8404
void ast_channel_hangupcause_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:431
Definition: include/asterisk/frame.h:281
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
void ast_channel_inherit_variables(const struct ast_channel *parent, struct ast_channel *child)
Inherits channel variable from parent to child channel.
Definition: channel.c:6866
Definition: include/asterisk/frame.h:282
Definition: channelstate.h:42
#define AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED
Definition: callerid.h:329
const char * ast_channel_call_forward(const struct ast_channel *chan)
Definition: channel.h:1479
int ast_channel_datastore_inherit(struct ast_channel *from, struct ast_channel *to)
Inherit datastores from a parent to a child.
Definition: channel.c:2373
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...
Definition: channel.c:5988
Definition: include/asterisk/frame.h:302
int ast_call(struct ast_channel *chan, const char *addr, int timeout)
Make a call.
Definition: channel.c:6553
void ast_channel_stage_snapshot_done(struct ast_channel *chan)
Clear flag to indicate channel snapshot is being staged, and publish snapshot.
Definition: stasis_channels.c:1043
struct ast_party_connected_line * ast_channel_connected(struct ast_channel *chan)
Definition: channel_internal_api.c:892
Definition: include/asterisk/frame.h:105
void ast_channel_stage_snapshot(struct ast_channel *chan)
Set flag to indicate channel snapshot is being staged.
Definition: stasis_channels.c:1038
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().
Definition: channel.c:6526
Definition: include/asterisk/frame.h:278
int ast_remaining_ms(struct timeval start, int max_ms)
Calculate remaining milliseconds given a starting timestamp and upper bound.
Definition: main/utils.c:2033
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.
Definition: channel.c:7434
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. ...
Definition: channel.c:4391
Definition: include/asterisk/frame.h:291
void ast_channel_exten_set(struct ast_channel *chan, const char *value)
Definition: channel_internal_api.c:357
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.
Definition: channel.c:6444
Definition: include/asterisk/frame.h:294
int ast_max_forwards_decrement(struct ast_channel *chan)
Decrement the max forwards count for a particular channel.
Definition: max_forwards.c:135
void ast_channel_context_set(struct ast_channel *chan, const char *value)
Definition: channel_internal_api.c:348
int ast_waitfor(struct ast_channel *c, int ms)
Wait for input on a channel.
Definition: channel.c:3171
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
Definition: include/asterisk/frame.h:280
union ast_frame::@263 data
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
void ast_channel_priority_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:448
Definition: channel.h:1040
void ast_set_variables(struct ast_channel *chan, struct ast_variable *vars)
adds a list of channel variables to a channel
Definition: channel.c:8217
◆ 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().
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
void *(* alloc)(struct ast_channel *chan, void *params)
Definition: channel.h:227
Definition: channel.h:226
void ast_channel_generator_set(struct ast_channel *chan, struct ast_generator *value)
Definition: channel_internal_api.c:717
void ast_channel_generatordata_set(struct ast_channel *chan, void *value)
Definition: channel_internal_api.c:553
void(* release)(struct ast_channel *chan, void *data)
Definition: channel.h:229
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.
Definition: channel.c:3189
struct ast_generator * ast_channel_generator(const struct ast_channel *chan)
Definition: channel_internal_api.c:713
int ast_prod(struct ast_channel *chan)
Send empty audio to prime a channel driver.
Definition: channel.c:5045
◆ 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().
int ao2_container_count(struct ao2_container *c)
Returns the number of elements in a container.
Definition: astobj2_container.c:34
◆ ast_add_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().
◆ 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().
int __ast_answer(struct ast_channel *chan, unsigned int delay)
Answer a channel, with a selectable delay before returning.
Definition: channel.c:2704
#define SCOPE_TRACE(level,...)
Print a trace message with details when a scope is entered or existed.
Definition: logger.h:749
const char * ast_channel_name(const struct ast_channel *chan)
◆ ast_auto_answer()
|
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().
Definition: channelstate.h:42
◆ 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().
int ast_autoservice_start(struct ast_channel *chan)
Automatically service a channel for us...
Definition: autoservice.c:200
int ast_autoservice_stop(struct ast_channel *chan)
Stop servicing a channel for us...
Definition: autoservice.c:266
◆ 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.
#define AST_LIST_TRAVERSE(head, var, field)
Loops over (traverses) the entries in a list.
Definition: linkedlists.h:490
Definition: autoservice.c:54
Definition: autoservice.c:70
struct asent::@346 list
◆ 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().
234 as->orig_end_dtmf_flag = ast_test_flag(ast_channel_flags(chan), AST_FLAG_END_DTMF_ONLY) ? 1 : 0;
Definition: channel.h:1008
#define AST_LIST_EMPTY(head)
Checks whether the specified list contains any entries.
Definition: linkedlists.h:449
#define AST_LIST_REMOVE(head, elm, field)
Removes a specific entry from a list.
Definition: linkedlists.h:855
#define ast_pthread_create_background(a, b, c, d)
Definition: utils.h:567
int ast_thread_is_user_interface(void)
Indicates whether the current thread is a user interface.
Definition: main/utils.c:2996
#define AST_LIST_TRAVERSE(head, var, field)
Loops over (traverses) the entries in a list.
Definition: linkedlists.h:490
#define AST_LIST_INSERT_HEAD(head, elm, field)
Inserts a list entry at the head of a list.
Definition: linkedlists.h:710
Definition: autoservice.c:54
const char * ast_channel_name(const struct ast_channel *chan)
Definition: autoservice.c:70
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
struct asent::@346 list
◆ 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().
Definition: channel.h:1008
int ast_thread_is_user_interface(void)
Indicates whether the current thread is a user interface.
Definition: main/utils.c:2996
#define AST_LIST_REMOVE_CURRENT(field)
Removes the current entry from a list during a traversal.
Definition: linkedlists.h:556
#define AST_LIST_REMOVE_HEAD(head, field)
Removes and returns the head entry from a list.
Definition: linkedlists.h:832
Definition: res_rtp_asterisk.c:590
Definition: autoservice.c:54
int ast_channel_softhangup_internal_flag(struct ast_channel *chan)
Definition: channel_internal_api.c:997
const char * ast_channel_name(const struct ast_channel *chan)
struct asent::@345 deferred_frames
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
Definition: autoservice.c:70
#define AST_LIST_TRAVERSE_SAFE_BEGIN(head, var, field)
Loops safely over (traverses) the entries in a list.
Definition: linkedlists.h:528
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
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.
Definition: channel.c:1144
◆ 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().
int(*const call)(struct ast_channel *chan, const char *addr, int timeout)
Make a call.
Definition: channel.h:702
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
Definition: channel.h:988
Definition: channel.h:1000
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ 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, ast_copy_string(), AST_FLAG_ORIGINATED, ast_hangup(), ast_log, ast_party_connected_line_copy(), ast_party_redirecting_copy(), ast_request(), ast_set_variables(), ast_strlen_zero, call_forward_inherit(), ast_channel::data, handle_cause(), LOG_NOTICE, NULL, outgoing_helper::parent_channel, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), S_OR, type, and outgoing_helper::vars.
Referenced by __ast_request_and_dial().
6007 snprintf(tmpchan, sizeof(tmpchan), "%s@%s", ast_channel_call_forward(orig), S_OR(forward_context, ast_channel_context(orig)));
6013 ast_log(LOG_NOTICE, "Unable to create channel for call forward to '%s/%s' (cause = %d)\n", type, data, cause);
const char * ast_channel_call_forward(const struct ast_channel *chan)
const char * pbx_builtin_getvar_helper(struct ast_channel *chan, const char *name)
Return a pointer to the value of the corresponding channel variable.
Definition: pbx_variables.c:1000
int ast_call(struct ast_channel *chan, const char *addr, int timeout)
Make a call.
Definition: channel.c:6553
void ast_channel_stage_snapshot_done(struct ast_channel *chan)
Clear flag to indicate channel snapshot is being staged, and publish snapshot.
Definition: stasis_channels.c:1043
struct ast_party_connected_line * ast_channel_connected(struct ast_channel *chan)
Definition: channel_internal_api.c:892
void ast_channel_set_flag(struct ast_channel *chan, unsigned int flag)
Set a flag on a channel.
Definition: channel.c:11228
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.
Definition: channel.c:2031
void ast_channel_stage_snapshot(struct ast_channel *chan)
Set flag to indicate channel snapshot is being staged.
Definition: stasis_channels.c:1038
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().
Definition: channel.c:6526
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.
Definition: channel.c:2135
struct ast_party_redirecting * ast_channel_redirecting(struct ast_channel *chan)
Definition: channel_internal_api.c:908
int pbx_builtin_setvar_helper(struct ast_channel *chan, const char *name, const char *value)
Add a variable to the channel variable stack, removing the most recently set value for the same name...
Definition: pbx_variables.c:1071
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.
Definition: channel.c:6444
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401
#define S_OR(a, b)
returns the equivalent of logic or for strings: first one if not empty, otherwise second one...
Definition: strings.h:79
const char * ast_channel_name(const struct ast_channel *chan)
static void call_forward_inherit(struct ast_channel *new_chan, struct ast_channel *parent, struct ast_channel *orig)
Definition: channel.c:5959
const char * ast_channel_context(const struct ast_channel *chan)
Definition: channel_internal_api.c:344
Definition: channel.h:1040
void ast_set_variables(struct ast_channel *chan, struct ast_variable *vars)
adds a list of channel variables to a channel
Definition: channel.c:8217
Definition: channel.h:1481
◆ ast_cause2str()
| const char* ast_cause2str | ( | int | cause | ) |
Gives the string form of a given cause code.
- Parameters
-
state cause to get the description of
- Returns
- the text form of the binary cause code given
Gives the string form of a given cause code.
Definition at line 612 of file channel.c.
References ARRAY_LEN, and causes_map::desc.
Referenced by __transmit_response(), bridge_dissolve(), channel_destroyed_event(), channel_state_change(), dial_exec_full(), findmeexec(), hangupcause_read(), rfc3326_add_reason_header(), sip_hangup(), and transmit_request_with_auth().
◆ ast_change_name()
| void ast_change_name | ( | struct ast_channel * | chan, |
| const char * | newname | ||
| ) |
Change channel name.
- Precondition
- Absolutely all channels MUST be unlocked before calling this function.
- Parameters
-
chan the channel to change the name of newname the name to change to
- Returns
- nothing
- Note
- this function must NEVER be used when any channels are locked regardless if it is the channel who's name is being changed or not because it invalidates our channel container locking order... lock container first, then the individual channels, never the other way around.
Definition at line 6854 of file channel.c.
References __ast_change_name_nolink(), ao2_link, ao2_lock, ao2_unlink, ao2_unlock, ast_channel_lock, and ast_channel_unlock.
Referenced by update_name().
static void __ast_change_name_nolink(struct ast_channel *chan, const char *newname)
this function simply changes the name of the channel and issues a manager_event with out unlinking an...
Definition: channel.c:6839
◆ ast_channel__bridge()
| struct ast_channel* ast_channel__bridge | ( | const struct ast_channel * | chan | ) |
◆ ast_channel__bridge_set()
| void ast_channel__bridge_set | ( | struct ast_channel * | chan, |
| struct ast_channel * | value | ||
| ) |
◆ ast_channel_accountcode()
| const char* ast_channel_accountcode | ( | const struct ast_channel * | chan | ) |
Referenced by action_dahdishowchannels(), ast_channel_log(), ast_channel_yank(), ast_unreal_call_setup(), ast_var_channels_table(), channel_do_masquerade(), channel_fill_empty_accountcode(), channel_fill_empty_peeraccount(), channel_req_accountcodes(), channel_snapshot_base_create(), channel_update_peeraccount(), func_channel_read(), and setup_env().
◆ ast_channel_adsicpe()
| enum ast_channel_adsicpe ast_channel_adsicpe | ( | const struct ast_channel * | chan | ) |
Definition at line 781 of file channel_internal_api.c.
◆ ast_channel_adsicpe_set()
| void ast_channel_adsicpe_set | ( | struct ast_channel * | chan, |
| enum ast_channel_adsicpe | value | ||
| ) |
Definition at line 785 of file channel_internal_api.c.
References value.
Referenced by __adsi_transmit_messages(), adsi_transmit_message_full(), ast_ari_channels_dial(), ast_iax2_new(), AST_TEST_DEFINE(), begin_dial_prerun(), chan_pjsip_new(), channel_do_masquerade(), dahdi_new(), dial_exec_full(), jingle_new(), mgcp_new(), ooh323_new(), ring_entry(), sip_new(), skinny_new(), and unistim_new().
◆ ast_channel_alert_writable()
| int ast_channel_alert_writable | ( | struct ast_channel * | chan | ) |
Definition at line 1125 of file channel_internal_api.c.
References ast_alertpipe_writable().
Referenced by __ast_queue_frame().
int ast_alertpipe_writable(int alert_pipe[2])
Determine if the alert pipe is writable.
Definition: alertpipe.h:127
◆ ast_channel_alert_write()
| int ast_channel_alert_write | ( | struct ast_channel * | chan | ) |
Definition at line 1110 of file channel_internal_api.c.
References ast_alertpipe_write().
Referenced by __ast_queue_frame(), __ast_read(), and channel_do_masquerade().
ssize_t ast_alertpipe_write(int alert_pipe[2])
Write an event to an alert pipe.
Definition: alertpipe.c:120
◆ ast_channel_amaflags()
| enum ama_flags ast_channel_amaflags | ( | const struct ast_channel * | chan | ) |
Definition at line 406 of file channel_internal_api.c.
Referenced by ast_channel_log(), ast_channel_snapshot_create(), ast_channel_yank(), ast_var_channels_table(), and func_channel_read().
◆ ast_channel_amaflags2string()
| const char* ast_channel_amaflags2string | ( | enum ama_flags | flags | ) |
Convert the enum representation of an AMA flag to a string representation.
- Since
- 12
- Parameters
-
flags integer flag
- Return values
-
A string representation of the flag
Definition at line 4418 of file channel.c.
References AST_AMA_BILLING, AST_AMA_DOCUMENTATION, and AST_AMA_OMIT.
Referenced by _sip_show_peer(), _skinny_show_line(), ast_cdr_format_var(), beanstalk_put(), build_csv_record(), build_radius_record(), cdr_read_callback(), cel_bs_put(), handle_cli_ooh323_show_config(), handle_cli_ooh323_show_peer(), handle_cli_ooh323_show_user(), manager_log(), sip_show_user(), and tds_log().
◆ ast_channel_amaflags_set()
| void ast_channel_amaflags_set | ( | struct ast_channel * | chan, |
| enum ama_flags | value | ||
| ) |
- Precondition
- chan is locked
Definition at line 411 of file channel_internal_api.c.
References ast_channel_publish_snapshot(), and value.
Referenced by __ast_channel_alloc_ap(), ast_cel_fabricate_channel_from_event(), ast_iax2_new(), AST_TEST_DEFINE(), cdr_write(), dahdi_new(), func_channel_write_real(), mgcp_new(), ooh323_new(), pbx_builtin_setamaflags(), sip_new(), and skinny_new().
void ast_channel_publish_snapshot(struct ast_channel *chan)
Publish a ast_channel_snapshot for a channel.
Definition: stasis_channels.c:1055
◆ ast_channel_answertime()
| struct timeval ast_channel_answertime | ( | struct ast_channel * | chan | ) |
Definition at line 986 of file channel_internal_api.c.
Referenced by ast_channel_get_up_time_ms(), ospfinished_exec(), and set_channel_answer_time().
◆ ast_channel_answertime_set()
| void ast_channel_answertime_set | ( | struct ast_channel * | chan, |
| struct timeval * | value | ||
| ) |
Definition at line 991 of file channel_internal_api.c.
References ast_channel::answertime, and value.
Referenced by set_channel_answer_time().
◆ ast_channel_appl()
| const char* ast_channel_appl | ( | const struct ast_channel * | chan | ) |
Definition at line 317 of file channel_internal_api.c.
References ast_channel::appl.
Referenced by ast_bridge_transfer_attended(), ast_channel_log(), ast_var_channels_table(), attended_transfer_bridge(), channel_snapshot_dialplan_create(), func_channel_read(), generate_status(), handle_showchan(), pbx_exec(), realtime_exec(), and serialize_showchan().
◆ ast_channel_appl_set()
| void ast_channel_appl_set | ( | struct ast_channel * | chan, |
| const char * | value | ||
| ) |
Definition at line 321 of file channel_internal_api.c.
References ast_channel::appl, AST_CHANNEL_SNAPSHOT_INVALIDATE_DIALPLAN, ast_channel_snapshot_invalidate_segment(), and value.
Referenced by ast_cel_fabricate_channel_from_event(), AST_TEST_DEFINE(), begin_dial_prerun(), dial_exec_full(), do_forward(), pbx_exec(), realtime_exec(), and ring_entry().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
◆ ast_channel_audiohooks()
| struct ast_audiohook_list* ast_channel_audiohooks | ( | const struct ast_channel * | chan | ) |
Definition at line 581 of file channel_internal_api.c.
References ast_channel::audiohooks.
Referenced by __ast_read(), ast_audiohook_attach(), ast_audiohook_detach_source(), ast_audiohook_move_all(), ast_audiohook_move_by_source(), ast_audiohook_remove(), ast_audiohook_set_mute(), ast_channel_audiohook_count_by_source(), ast_channel_audiohook_count_by_source_running(), ast_channel_has_audio_frame_or_monitor(), ast_channel_has_hook_requiring_audio(), ast_write_stream(), conf_run(), and destroy_hooks().
◆ ast_channel_audiohooks_set()
| void ast_channel_audiohooks_set | ( | struct ast_channel * | chan, |
| struct ast_audiohook_list * | value | ||
| ) |
Definition at line 585 of file channel_internal_api.c.
References ast_channel::audiohooks, and value.
Referenced by __ast_read(), ast_audiohook_attach(), ast_write_stream(), and destroy_hooks().
◆ ast_channel_autochans()
| struct ast_autochan_list* ast_channel_autochans | ( | struct ast_channel * | chan | ) |
Definition at line 872 of file channel_internal_api.c.
References ast_channel::autochans.
Referenced by __ast_channel_alloc_ap(), ast_autochan_destroy(), ast_autochan_new_channel(), and ast_autochan_setup().
◆ ast_channel_blocker()
| pthread_t ast_channel_blocker | ( | const struct ast_channel * | chan | ) |
Definition at line 1213 of file channel_internal_api.c.
References ast_channel::blocker.
Referenced by __ast_queue_frame(), ast_softhangup_nolock(), and channel_do_masquerade().
◆ ast_channel_blocker_set()
| void ast_channel_blocker_set | ( | struct ast_channel * | chan, |
| pthread_t | value | ||
| ) |
◆ ast_channel_blocker_tid()
| int ast_channel_blocker_tid | ( | const struct ast_channel * | chan | ) |
Definition at line 1222 of file channel_internal_api.c.
References ast_channel::blocker_tid.
Referenced by ast_hangup().
◆ ast_channel_blocker_tid_set()
| void ast_channel_blocker_tid_set | ( | struct ast_channel * | chan, |
| int | tid | ||
| ) |
Definition at line 1226 of file channel_internal_api.c.
References ast_channel::blocker_tid, and value.
◆ ast_channel_blockproc()
| const char* ast_channel_blockproc | ( | const struct ast_channel * | chan | ) |
Definition at line 326 of file channel_internal_api.c.
References ast_channel::blockproc.
Referenced by ast_hangup(), and serialize_showchan().
◆ ast_channel_blockproc_set()
| void ast_channel_blockproc_set | ( | struct ast_channel * | chan, |
| const char * | value | ||
| ) |
Definition at line 330 of file channel_internal_api.c.
References ast_channel::blockproc, and value.
◆ ast_channel_bridge_peer()
| struct ast_channel* ast_channel_bridge_peer | ( | struct ast_channel * | chan | ) |
Get the channel's bridge peer only if the bridge is two-party.
- Since
- 12.0.0
- Parameters
-
chan Channel desiring the bridge peer channel.
- Note
- The returned peer channel is the current peer in the bridge when called.
- Absolutely NO channel locks should be held when calling this function.
- Return values
-
NULL Channel not in a bridge or the bridge is not two-party. non-NULL Reffed peer channel at time of calling.
Definition at line 10765 of file channel.c.
References ao2_ref, ast_bridge_peer(), ast_channel_get_bridge(), ast_channel_lock, ast_channel_unlock, and NULL.
Referenced by _skinny_show_lines(), analog_ss_thread(), ast_rtp_instance_set_stats_vars(), ast_set_hangupsource(), ast_unreal_queryoption(), ast_var_channels_table(), attach_barge(), cb_events(), channel_do_masquerade(), create_jb(), export_aoc_vars(), fax_detect_framehook(), fax_gateway_framehook(), func_channel_read(), get_refer_info(), handle_incoming_request(), handle_request_bye(), manager_park(), mgcp_hangup(), my_get_sigpvt_bridged_channel(), and spandsp_fax_gateway_start().
struct ast_channel * ast_bridge_peer(struct ast_bridge *bridge, struct ast_channel *chan)
Get the channel's bridge peer only if the bridge is two-party.
Definition: bridge.c:4142
struct ast_bridge * ast_channel_get_bridge(const struct ast_channel *chan)
Get the bridge associated with a channel.
Definition: channel.c:10735
◆ ast_channel_call_forward()
| const char* ast_channel_call_forward | ( | const struct ast_channel * | chan | ) |
◆ ast_channel_callback()
| 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.
This function executes a callback one time for each active channel on the system. The channel is provided as an argument to the function.
- Note
- Absolutely NO channel locks should be held before calling this function.
- Since
- 1.8
Definition at line 1278 of file channel.c.
References ao2_callback_data.
Referenced by ast_channel_get_by_exten(), ast_channel_get_by_name_prefix(), ast_channel_iterator_by_exten_new(), ast_channel_iterator_by_name_new(), ast_pickup_find_by_group(), does_id_conflict(), find_by_channel(), find_by_part(), handle_core_set_debug_channel(), and pickup_by_mark().
#define ao2_callback_data(container, flags, cb_fn, arg, data)
Definition: astobj2.h:1743
◆ ast_channel_caller()
| struct ast_party_caller* ast_channel_caller | ( | struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 888 of file channel_internal_api.c.
References ast_channel::caller.
Referenced by __analog_handle_event(), __analog_ss_thread(), __ast_channel_alloc_ap(), __ast_goto_if_exists(), __ast_pbx_run(), _macro_exec(), acf_isexten_exec(), action_meetmelist(), after_bridge_move_channel(), agent_request_exec(), analog_ss_thread(), app_exec(), ast_app_dtget(), ast_ari_channels_dial(), ast_bridge_setup_after_goto(), ast_cel_fabricate_channel_from_event(), ast_channel_destructor(), ast_channel_set_caller(), ast_channel_set_caller_event(), ast_do_pickup(), ast_dummy_channel_destructor(), ast_iax2_new(), ast_pbx_h_exten_run(), ast_set_callerid(), ast_str_retrieve_variable(), AST_TEST_DEFINE(), ast_unreal_call_setup(), ast_var_channels_table(), background_detect_exec(), begin_dial_prerun(), blacklist_read(), bridge_reconfigured_connected_line_update(), callerid_read(), callerid_write(), cb_events(), cc_generic_agent_init(), chan_pjsip_cng_tone_detected(), chan_pjsip_new(), channel_do_masquerade(), channel_snapshot_caller_create(), collect_digits(), console_call(), copy_caller_data(), copy_message(), dahdi_handle_dtmf(), dahdi_handle_event(), dahdi_new(), dial_exec_full(), dial_trunk(), dialog_info_generate_body_content(), disa_exec(), do_forward(), do_immediate_setup(), eval_exten_read(), fax_detect_framehook(), find_matching_endif(), find_matching_endwhile(), findmeexec(), forward_message(), get_pai(), get_rpid(), gosub_exec(), gosub_run(), handle_cli_confbridge_list_item(), handle_cli_misdn_show_channels(), handle_gosub(), handle_setpriority(), handle_showchan(), incoming_in_dialog_request(), isAnsweringMachine(), isexten_function_read(), leave_voicemail(), local_call(), manager_queues_status(), meetme_show_cmd(), mgcp_hangup(), mgcp_new(), mgcp_ss(), minivm_greet_exec(), minivm_notify_exec(), misdn_call(), misdn_hangup(), misdn_new(), misdn_update_caller_id(), misdn_write(), my_handle_dtmf(), onModeChanged(), ooh323_rtp_read(), originate_exec(), ospauth_exec(), osplookup_exec(), oss_call(), oss_new(), park_local_transfer(), parse_oli(), pbx_builtin_background(), pbx_builtin_waitexten(), pbx_outgoing_attempt(), pbx_parseable_goto(), phone_new(), print_bc_info(), privacy_exec(), process_ast_dsp(), process_sdp(), push_callinfo(), queue_connected_line_update(), queue_exec(), readexten_exec(), recalling_enter(), release_chan(), ring_entry(), run_externnotify(), send_callinfo(), serialize_showchan(), setup_env(), setup_privacy_args(), sip_call(), sip_new(), sip_read(), skinny_new(), skinny_newcall(), sla_ring_station(), sms_exec(), socket_process_helper(), start_automixmonitor(), start_automonitor(), state_notify_build_xml(), try_calling(), unistim_new(), unreal_colp_redirect_indicate(), update_connected_line_from_peer(), update_connectedline(), update_initial_connected_line(), valid_exit(), vm_allocate_dh(), vm_authenticate(), wait_for_answer(), waitstream_core(), write_metadata(), and zapateller_exec().
◆ ast_channel_caller_set()
| void ast_channel_caller_set | ( | struct ast_channel * | chan, |
| struct ast_party_caller * | value | ||
| ) |
Definition at line 944 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_CALLER, ast_channel_snapshot_invalidate_segment(), ast_channel::caller, and value.
Referenced by channel_do_masquerade(), dial_trunk(), and sla_ring_station().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
◆ ast_channel_callgroup()
| ast_group_t ast_channel_callgroup | ( | const struct ast_channel * | chan | ) |
Definition at line 1074 of file channel_internal_api.c.
References ast_channel::callgroup.
Referenced by ast_var_channels_table(), find_channel_by_group(), func_channel_read(), generate_status(), handle_showchan(), and serialize_showchan().
◆ ast_channel_callgroup_set()
| void ast_channel_callgroup_set | ( | struct ast_channel * | chan, |
| ast_group_t | value | ||
| ) |
- Precondition
- chan is locked
Definition at line 1078 of file channel_internal_api.c.
References ast_channel::callgroup, and value.
Referenced by chan_pjsip_new(), dahdi_new(), func_channel_write_real(), jingle_new(), mgcp_new(), read_config(), sip_new(), skinny_new(), and unistim_new().
◆ ast_channel_callid()
| ast_callid ast_channel_callid | ( | const struct ast_channel * | chan | ) |
Definition at line 793 of file channel_internal_api.c.
References ast_channel::callid.
Referenced by __analog_ss_thread(), __ast_pbx_run(), ast_channel_destructor(), ast_unreal_channel_push_to_bridge(), attended_transfer_monitor_thread(), autoservice_run(), bridge_channel_control_thread(), func_channel_read(), handle_showchan(), and request_channel().
◆ ast_channel_callid_cleanup()
| void ast_channel_callid_cleanup | ( | struct ast_channel * | chan | ) |
Definition at line 1068 of file channel_internal_api.c.
References ast_channel::callid.
Referenced by ast_channel_destructor().
◆ ast_channel_callid_set()
| void ast_channel_callid_set | ( | struct ast_channel * | chan, |
| ast_callid | value | ||
| ) |
- Precondition
- chan is locked
Definition at line 797 of file channel_internal_api.c.
References AST_CALLID_BUFFER_LENGTH, ast_callid_strnprint(), ast_channel_name(), ast_debug, ast_test_suite_event_notify, and ast_channel::callid.
Referenced by __ast_pbx_run(), ast_iax2_new(), ast_unreal_channel_push_to_bridge(), ast_unreal_new_channels(), common_recall_channel_setup(), dahdi_new(), iax2_request(), jingle_new(), request_channel(), and sip_new().
805 ast_debug(3, "Channel Call ID changing from %s to %s\n", call_identifier_from, call_identifier_to);
void ast_callid_strnprint(char *buffer, size_t buffer_size, ast_callid callid)
copy a string representation of the callid into a target string
Definition: logger.c:1952
const char * ast_channel_name(const struct ast_channel *chan)
◆ ast_channel_cc_params_init()
| 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.
- Since
- 1.8
- Note
- If base_params is NULL, the channel will get the default values for all CCSS parameters.
This function makes use of datastore operations on the channel, so it is important to lock the channel before calling this function.
- Parameters
-
chan The channel to create the datastore on base_params CCSS parameters we wish to copy into the channel
- Return values
-
0 Success -1 Failure
Definition at line 10652 of file channel.c.
References ast_cc_config_params_destroy(), ast_cc_config_params_init, ast_cc_copy_config_params(), ast_channel_datastore_add(), ast_datastore_alloc, ast_datastore::data, and NULL.
Referenced by ast_channel_get_cc_config_params(), ast_unreal_call_setup(), ast_unreal_new_channels(), dahdi_new(), and sip_new().
static const struct ast_datastore_info cc_channel_datastore_info
Definition: channel.c:10646
void ast_cc_config_params_destroy(struct ast_cc_config_params *params)
Free memory from CCSS configuration params.
Definition: ccss.c:693
#define ast_cc_config_params_init()
Allocate and initialize an ast_cc_config_params structure.
Definition: ccss.h:135
Definition: ccss.c:161
void ast_cc_copy_config_params(struct ast_cc_config_params *dest, const struct ast_cc_config_params *src)
copy CCSS configuration parameters from one structure to another
Definition: ccss.c:861
int ast_channel_datastore_add(struct ast_channel *chan, struct ast_datastore *datastore)
Add a datastore to a channel.
Definition: channel.c:2390
◆ ast_channel_cdr()
| struct ast_cdr* ast_channel_cdr | ( | const struct ast_channel * | chan | ) |
Definition at line 589 of file channel_internal_api.c.
References ast_channel::cdr.
Referenced by ast_channel_destructor(), ast_channel_log(), ast_dummy_channel_destructor(), cdr_read_callback(), and cdr_retrieve_time().
◆ ast_channel_cdr_set()
| void ast_channel_cdr_set | ( | struct ast_channel * | chan, |
| struct ast_cdr * | value | ||
| ) |
Definition at line 593 of file channel_internal_api.c.
References ast_channel::cdr, and value.
Referenced by ast_channel_destructor(), ast_dummy_channel_destructor(), custom_log(), load_values_config(), manager_log(), and syslog_log().
◆ ast_channel_clear_flag()
| void ast_channel_clear_flag | ( | struct ast_channel * | chan, |
| unsigned int | flag | ||
| ) |
- Since
- 13.17.0
- Parameters
-
Clear a flag on a channel chan The channel to clear the flag from flag The flag to clear
- Note
- This will lock the channel internally. If the channel is already locked it is still safe to call.
Definition at line 11235 of file channel.c.
References ast_channel_flags(), ast_channel_lock, ast_channel_unlock, and ast_clear_flag.
Referenced by action_redirect(), ast_bridge_setup_after_goto(), ast_channel_undefer_dtmf(), ast_waitfordigit_full(), bridge_channel_internal_pull(), channel_spy(), common_exec(), dial_exec_full(), disa_exec(), handle_exec(), and waitstream_core().
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ ast_channel_clear_softhangup()
| void ast_channel_clear_softhangup | ( | struct ast_channel * | chan, |
| int | flag | ||
| ) |
Clear a set of softhangup flags from a channel.
Never clear a softhangup flag from a channel directly. Instead, use this function. This ensures that all aspects of the softhangup process are aborted.
- Parameters
-
chan the channel to clear the flag on flag the flag or flags to clear
- Returns
- Nothing.
Definition at line 2437 of file channel.c.
References ast_channel_lock, ast_channel_readq(), ast_channel_softhangup_internal_flag(), ast_channel_softhangup_internal_flag_clear(), ast_channel_unlock, AST_CONTROL_END_OF_Q, AST_FRAME_CONTROL, ast_frfree, AST_LIST_LAST, AST_LIST_REMOVE, ast_frame::frametype, ast_frame_subclass::integer, and ast_frame::subclass.
Referenced by __ast_pbx_run(), ast_bridge_setup_after_goto(), chan_cleanup(), collect_digits(), gosub_run(), and stasis_app_exec().
#define AST_LIST_REMOVE(head, elm, field)
Removes a specific entry from a list.
Definition: linkedlists.h:855
Definition: include/asterisk/frame.h:306
struct ast_readq_list * ast_channel_readq(struct ast_channel *chan)
Definition: channel_internal_api.c:876
Definition: include/asterisk/frame.h:105
Definition: res_rtp_asterisk.c:590
#define AST_LIST_LAST(head)
Returns the last entry contained in a list.
Definition: linkedlists.h:428
int ast_channel_softhangup_internal_flag(struct ast_channel *chan)
Definition: channel_internal_api.c:997
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
void ast_channel_softhangup_internal_flag_clear(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:1009
◆ ast_channel_cmpwhentohangup_tv()
| int ast_channel_cmpwhentohangup_tv | ( | struct ast_channel * | chan, |
| struct timeval | offset | ||
| ) |
Compare a offset with the settings of when to hang a channel up.
- Parameters
-
chan channel on which to check for hangup offset offset in seconds and microseconds from current time
- Returns
- 1, 0, or -1 This function compares a offset from current time with the absolute time out on a channel (when to hang up). If the absolute time out on a channel is earlier than current time plus the offset, it returns 1, if the two time values are equal, it return 0, otherwise, it return -1.
- Since
- 1.6.1
Compare a offset with the settings of when to hang a channel up.
Definition at line 523 of file channel.c.
References ast_channel_whentohangup(), ast_tvadd(), ast_tvdiff_ms(), ast_tvnow(), and ast_tvzero().
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
int64_t ast_tvdiff_ms(struct timeval end, struct timeval start)
Computes the difference (in milliseconds) between two struct timeval instances.
Definition: time.h:98
struct timeval * ast_channel_whentohangup(struct ast_channel *chan)
Definition: channel_internal_api.c:928
struct timeval ast_tvadd(struct timeval a, struct timeval b)
Returns the sum of two timevals a + b.
Definition: extconf.c:2283
◆ ast_channel_connected()
| struct ast_party_connected_line* ast_channel_connected | ( | struct ast_channel * | chan | ) |
Definition at line 892 of file channel_internal_api.c.
References ast_channel::connected.
Referenced by __ast_channel_alloc_ap(), __ast_read(), __ast_request_and_dial(), action_meetmelist(), after_bridge_move_channel(), agent_login_channel_config(), analog_call(), ari_channels_handle_originate_with_id(), ast_ari_channels_dial(), ast_call_forward(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_channel_destructor(), ast_channel_set_connected_line(), ast_do_pickup(), ast_dummy_channel_destructor(), ast_unreal_call_setup(), attended_transfer_properties_alloc(), begin_dial_prerun(), channel_do_masquerade(), channel_snapshot_connected_create(), connectedline_read(), connectedline_write(), copy_caller_data(), dahdi_call(), dial_exec_full(), dialog_info_generate_body_content(), do_forward(), findmeexec(), handle_showchan(), iax2_call(), indicate_connected_line(), launch_monitor_thread(), manager_queues_status(), mgcp_call(), ooh323_call(), ooh323_indicate(), park_local_transfer(), pbx_outgoing_attempt(), phone_call(), push_callinfo(), recalling_enter(), retransfer_enter(), ring_entry(), send_callerid_screen(), send_callinfo(), serialize_showchan(), skinny_newcall(), state_notify_build_xml(), try_calling(), unistim_indicate(), unreal_colp_redirect_indicate(), update_config(), update_connectedline(), and wait_for_answer().
struct ast_party_connected_line connected
Channel Connected Line ID information.
Definition: channel_internal_api.c:140
◆ ast_channel_connected_effective_id()
| struct ast_party_id ast_channel_connected_effective_id | ( | struct ast_channel * | chan | ) |
Definition at line 900 of file channel_internal_api.c.
References ast_party_id_merge().
Referenced by add_rpid(), caller_id_outgoing_request(), caller_id_outgoing_response(), generate_status(), handle_showchan(), initreqprep(), is_colp_update_allowed(), misdn_call(), misdn_get_connected_line(), push_callinfo(), send_callinfo(), set_from_header(), setsubstate(), and update_connectedline().
struct ast_party_connected_line connected
Channel Connected Line ID information.
Definition: channel_internal_api.c:140
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.
Definition: channel.c:1902
◆ ast_channel_connected_indicated()
| struct ast_party_connected_line* ast_channel_connected_indicated | ( | struct ast_channel * | chan | ) |
Definition at line 896 of file channel_internal_api.c.
References ast_channel::connected_indicated.
Referenced by __ast_channel_alloc_ap(), after_bridge_move_channel(), ast_channel_destructor(), ast_dummy_channel_destructor(), and indicate_connected_line().
struct ast_party_connected_line connected_indicated
Channel Connected Line ID information that was last indicated.
Definition: channel_internal_api.c:145
◆ ast_channel_connected_line_macro()
| 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.
- Since
- 1.8
- Deprecated:
- You should use the ast_channel_connected_line_sub() function instead.
Whenever we want to update a channel's connected line information, we may need to run a macro so that an administrator can manipulate the information before sending it out. This function both runs the macro and sends the update to the channel.
- Parameters
-
autoservice_chan Channel to place into autoservice while the macro is running. It is perfectly safe for this to be NULL macro_chan The channel to run the macro on. Also the channel from which we determine which macro we need to run. connected_info Either an ast_party_connected_line or ast_frame pointer of type AST_CONTROL_CONNECTED_LINE is_caller If true, then run CONNECTED_LINE_CALLER_SEND_MACRO with arguments from CONNECTED_LINE_CALLER_SEND_MACRO_ARGS, otherwise run CONNECTED_LINE_CALLEE_SEND_MACRO with arguments from CONNECTED_LINE_CALLEE_SEND_MACRO_ARGS frame If true, then connected_info is an ast_frame pointer, otherwise it is an ast_party_connected_line pointer.
- Return values
-
0 Success -1 Either the macro does not exist, or there was an error while attempting to run the macro
- Todo:
Have multiple return codes based on the MACRO_RESULT
Make constants so that caller and frame can be more expressive than just '1' and '0'
Definition at line 10435 of file channel.c.
References ast_app_run_macro(), ast_channel_connected(), ast_channel_lock, ast_channel_unlock, ast_channel_update_connected_line(), ast_connected_line_parse_data(), ast_log, ast_party_connected_line_copy(), ast_party_connected_line_free(), ast_party_connected_line_init(), ast_strdupa, ast_strlen_zero, channel_set_intercept_mode(), chanlist::connected, ast_frame::data, ast_frame::datalen, LOG_WARNING, NULL, pbx_builtin_getvar_helper(), ast_frame::ptr, retval, and S_OR.
Referenced by __ast_read(), app_exec(), ast_do_pickup(), bridge_channel_handle_control(), dial_exec_full(), handle_frame(), update_connected_line_from_peer(), and wait_for_answer().
10457 ast_log(LOG_WARNING, "Usage of CONNECTED_LINE_CALLE[ER]_SEND_MACRO is deprecated. Please use CONNECTED_LINE_SEND_SUB instead.\n");
10462 ast_connected_line_parse_data(frame->data.ptr, frame->datalen, ast_channel_connected(macro_chan));
int ast_app_run_macro(struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const char *macro_name, const char *macro_args)
Run a macro on a channel, placing an optional second channel into autoservice.
Definition: main/app.c:320
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.
Definition: channel.c:8881
void ast_party_connected_line_init(struct ast_party_connected_line *init)
Initialize the given connected line structure.
Definition: channel.c:2022
static void channel_set_intercept_mode(int in_intercept_mode)
Definition: channel.c:10419
const char * pbx_builtin_getvar_helper(struct ast_channel *chan, const char *name)
Return a pointer to the value of the corresponding channel variable.
Definition: pbx_variables.c:1000
void ast_party_connected_line_free(struct ast_party_connected_line *doomed)
Destroy the connected line information contents.
Definition: channel.c:2072
struct ast_party_connected_line * ast_channel_connected(struct ast_channel *chan)
Definition: channel_internal_api.c:892
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.
Definition: channel.c:2031
#define S_OR(a, b)
returns the equivalent of logic or for strings: first one if not empty, otherwise second one...
Definition: strings.h:79
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
union ast_frame::@263 data
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.
Definition: channel.c:9189
◆ ast_channel_connected_line_sub()
| 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.
- Since
- 11 Whenever we want to update a channel's connected line information, we may need to run a subroutine so that an administrator can manipulate the information before sending it out. This function both runs the subroutine specified by CONNECTED_LINE_SEND_SUB and sends the update to the channel.
- Parameters
-
autoservice_chan Channel to place into autoservice while the sub is running. It is perfectly safe for this to be NULL sub_chan The channel to run the subroutine on. Also the channel from which we determine which subroutine we need to run. connected_info Either an ast_party_connected_line or ast_frame pointer of type AST_CONTROL_CONNECTED_LINE frame If true, then connected_info is an ast_frame pointer, otherwise it is an ast_party_connected_line pointer.
- Return values
-
0 Success -1 Either the subroutine does not exist, or there was an error while attempting to run the subroutine
Definition at line 10539 of file channel.c.
References ast_app_run_sub(), ast_channel_connected(), ast_channel_lock, ast_channel_unlock, ast_channel_update_connected_line(), ast_connected_line_parse_data(), ast_party_connected_line_copy(), ast_party_connected_line_free(), ast_party_connected_line_init(), ast_strdupa, ast_strlen_zero, channel_set_intercept_mode(), chanlist::connected, ast_frame::data, ast_frame::datalen, NULL, pbx_builtin_getvar_helper(), ast_frame::ptr, retval, S_OR, and sub.
Referenced by __ast_read(), app_exec(), ast_do_pickup(), bridge_channel_handle_control(), dial_exec_full(), handle_frame(), update_connected_line_from_peer(), and wait_for_answer().
10559 ast_connected_line_parse_data(frame->data.ptr, frame->datalen, ast_channel_connected(sub_chan));
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.
Definition: channel.c:8881
void ast_party_connected_line_init(struct ast_party_connected_line *init)
Initialize the given connected line structure.
Definition: channel.c:2022
static void channel_set_intercept_mode(int in_intercept_mode)
Definition: channel.c:10419
const char * pbx_builtin_getvar_helper(struct ast_channel *chan, const char *name)
Return a pointer to the value of the corresponding channel variable.
Definition: pbx_variables.c:1000
void ast_party_connected_line_free(struct ast_party_connected_line *doomed)
Destroy the connected line information contents.
Definition: channel.c:2072
struct ast_party_connected_line * ast_channel_connected(struct ast_channel *chan)
Definition: channel_internal_api.c:892
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.
Definition: channel.c:2031
int ast_app_run_sub(struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const char *sub_location, const char *sub_args, int ignore_hangup)
Run a subroutine on a channel, placing an optional second channel into autoservice.
Definition: main/app.c:401
#define S_OR(a, b)
returns the equivalent of logic or for strings: first one if not empty, otherwise second one...
Definition: strings.h:79
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
union ast_frame::@263 data
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.
Definition: channel.c:9189
◆ ast_channel_connected_set()
| void ast_channel_connected_set | ( | struct ast_channel * | chan, |
| struct ast_party_connected_line * | value | ||
| ) |
Definition at line 949 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_CONNECTED, ast_channel_snapshot_invalidate_segment(), ast_channel::connected, and value.
Referenced by channel_do_masquerade().
struct ast_party_connected_line connected
Channel Connected Line ID information.
Definition: channel_internal_api.c:140
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
◆ ast_channel_context()
| const char* ast_channel_context | ( | const struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 344 of file channel_internal_api.c.
Referenced by __analog_ss_thread(), __ast_goto_if_exists(), __ast_pbx_run(), _if_exec(), _macro_exec(), _while_exec(), acf_isexten_exec(), action_blind_transfer(), action_bridge(), action_dialplan_exec(), analog_ss_thread(), ast_app_exec_macro(), ast_bridge_setup_after_goto(), ast_call_forward(), ast_cc_call_init(), ast_channel_by_exten_cb(), ast_channel_log(), ast_channel_yank(), ast_pbx_h_exten_run(), ast_str_retrieve_variable(), AST_TEST_DEFINE(), ast_var_channels_table(), ast_waitstream_exten(), background_detect_exec(), blind_transfer_exec(), bridge_exec(), cc_generic_agent_init(), cc_interfaces_datastore_init(), chan_pjsip_cng_tone_detected(), channel_snapshot_dialplan_create(), collect_digits(), common_exec(), conf_run(), console_transfer(), dahdi_handle_dtmf(), dial_exec_full(), dialout(), do_forward(), do_immediate_setup(), eval_exten_read(), expand_gosub_args(), extenspy_exec(), fax_detect_framehook(), feature_blind_transfer(), find_matching_endif(), find_matching_endwhile(), forward_message(), func_channel_read(), func_channel_write_real(), get_cid_name(), get_transfer_context(), gosub_exec(), gosub_run(), goto_exten(), goto_parser(), handle_call_forward(), handle_gosub(), handle_setpriority(), handle_showchan(), iax2_call(), launch_monitor_thread(), leave_voicemail(), log_exec(), lua_pbx_exec(), mgcp_ss(), minivm_greet_exec(), misdn_call(), misdn_hangup(), my_handle_dtmf(), onedigit_goto(), onModeChanged(), ooh323_rtp_read(), pbx_builtin_background(), pbx_builtin_goto(), pbx_builtin_setvar_multiple(), pbx_builtin_waitexten(), pbx_extension_helper(), pbx_parseable_goto(), pickup_exec(), print_bc_info(), process_ast_dsp(), process_sdp(), raise_exception(), readexten_exec(), realtime_exec(), release_chan(), ring_entry(), serialize_showchan(), setsubstate(), setup_env(), setup_peer_after_bridge_goto(), sip_read(), skinny_dialer(), skinny_newcall(), try_calling(), vm_authenticate(), vm_execmain(), vmauthenticate(), and wait_for_answer().
◆ ast_channel_context_set()
| void ast_channel_context_set | ( | struct ast_channel * | chan, |
| const char * | value | ||
| ) |
Definition at line 348 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_DIALPLAN, ast_channel_snapshot_invalidate_segment(), and ast_copy_string().
Referenced by __ast_channel_alloc_ap(), __ast_request_and_dial(), _macro_exec(), action_dialplan_exec(), alsa_new(), analog_ss_thread(), ari_originate_dial(), ast_add_extension2_lockopt(), ast_bridge_setup_after_goto(), ast_cel_fabricate_channel_from_event(), ast_explicit_goto(), ast_iax2_new(), ast_pbx_h_exten_run(), AST_TEST_DEFINE(), dahdi_new(), dial_exec_full(), dialout(), do_notify(), eval_exten_read(), forward_message(), generic_recall(), gosub_exec(), gosub_run(), handle_gosub(), handle_setcontext(), iax2_call(), jingle_new(), leave_voicemail(), mgcp_new(), minivm_greet_exec(), my_distinctive_ring(), nbs_new(), ooh323_new(), pbx_builtin_background(), pbx_extension_helper(), pbx_outgoing_exec(), phone_new(), read_config(), return_exec(), setsubstate(), sip_new(), and skinny_new().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401
◆ ast_channel_creationtime()
| struct timeval ast_channel_creationtime | ( | struct ast_channel * | chan | ) |
Definition at line 976 of file channel_internal_api.c.
Referenced by ast_channel_get_duration_ms(), ast_pickup_find_by_group(), AST_TEST_DEFINE(), channel_snapshot_base_create(), extensionstate_update(), find_ringing_channel(), generate_status(), get_device_state_causing_channels(), handle_request_subscribe(), handle_showchan(), ospfinished_exec(), and wait_for_answer().
◆ ast_channel_creationtime_set()
| void ast_channel_creationtime_set | ( | struct ast_channel * | chan, |
| struct timeval * | value | ||
| ) |
Definition at line 980 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_BASE, ast_channel_snapshot_invalidate_segment(), ast_channel::creationtime, and value.
Referenced by __ast_channel_alloc_ap().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
◆ ast_channel_data()
| const char* ast_channel_data | ( | const struct ast_channel * | chan | ) |
Definition at line 334 of file channel_internal_api.c.
References ast_channel::data.
Referenced by ast_channel_log(), ast_var_channels_table(), channel_snapshot_dialplan_create(), func_channel_read(), generate_status(), handle_showchan(), handle_verbose(), pbx_exec(), realtime_exec(), and serialize_showchan().
◆ ast_channel_data_set()
| void ast_channel_data_set | ( | struct ast_channel * | chan, |
| const char * | value | ||
| ) |
Definition at line 338 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_DIALPLAN, ast_channel_snapshot_invalidate_segment(), ast_channel::data, and value.
Referenced by ast_cel_fabricate_channel_from_event(), AST_TEST_DEFINE(), begin_dial_prerun(), dial_exec_full(), do_forward(), pbx_exec(), realtime_exec(), retrydial_exec(), and ring_entry().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
◆ ast_channel_datastore_add()
| int ast_channel_datastore_add | ( | struct ast_channel * | chan, |
| struct ast_datastore * | datastore | ||
| ) |
Add a datastore to a channel.
- Note
- The channel should be locked before calling this function.
- Return values
-
0 success non-zero failure
Definition at line 2390 of file channel.c.
References ast_channel_datastores(), and AST_LIST_INSERT_HEAD.
Referenced by __after_bridge_set_goto(), _macro_exec(), acf_curlopt_write(), acf_iaxvar_write(), acf_odbc_read(), add_features_datastore(), add_masquerade_store(), add_to_agi(), after_bridge_cb_setup(), apply_plc(), ast_cel_fabricate_channel_from_event(), ast_channel_cc_params_init(), ast_channel_suppress(), ast_do_pickup(), ast_iax2_new(), ast_jb_create_framehook(), ast_setup_cc_recall_datastore(), ast_stir_shaken_add_verification(), audiohook_volume_get(), authenticate_reply(), bridge_channel_impart_add(), bridge_features_ds_set_full(), calendar_query_exec(), cc_interfaces_datastore_init(), chan_cleanup(), channel_feature_hooks_set_full(), command_prestart_queue_command(), create_msg_q_chan(), create_parked_subscription_full(), create_transaction(), detect_write(), dial_masquerade_datastore_add(), do_notify(), dtmfstore_exec(), dundi_query_read(), enable_jack_hook(), enum_query_read(), find_or_create_details(), frame_drop_helper(), frame_trace_helper(), func_channel_write_real(), func_confbridge_helper(), get_feature_ds(), get_lock(), get_replace_channel_store(), gosub_exec(), handle_remb_set(), init_hook(), lua_get_state(), max_forwards_datastore_alloc(), msg_datastore_find_or_create(), MYSQL_exec(), pitchshift_helper(), raise_exception(), reload(), save_dialstring(), scramble_write(), set_hold_intercept(), set_internal_datastore(), set_talk_detect(), set_timeout(), setup_async_playback_datastore(), setup_bridge_roles_datastore(), setup_mixmonitor_ds(), setup_park_common_datastore(), shared_write(), smdi_msg_retrieve_read(), socket_process_helper(), speech_create(), speex_write(), srv_datastore_setup(), stasis_app_channel_set_stasis_end_published(), t38_attach_framehook(), and volume_write().
struct ast_datastore_list * ast_channel_datastores(struct ast_channel *chan)
Definition: channel_internal_api.c:868
#define AST_LIST_INSERT_HEAD(head, elm, field)
Inserts a list entry at the head of a list.
Definition: linkedlists.h:710
Definition: search.h:40
◆ ast_channel_datastore_find()
| struct ast_datastore* ast_channel_datastore_find | ( | struct ast_channel * | chan, |
| const struct ast_datastore_info * | info, | ||
| const char * | uid | ||
| ) |
Find a datastore on a channel.
- Note
- The channel should be locked before calling this function.
- The datastore returned from this function must not be used if the reference to the channel is released.
- Return values
-
pointer to the datastore if found NULL if not found
Definition at line 2404 of file channel.c.
References ast_channel_datastores(), AST_LIST_TRAVERSE, ast_datastore::info, NULL, and ast_datastore::uid.
Referenced by _macro_exec(), acf_curl_helper(), acf_curlopt_helper(), acf_curlopt_write(), acf_exception_read(), acf_fetch(), acf_iaxvar_read(), acf_iaxvar_write(), acf_odbc_read(), add_agi_cmd(), add_features_datastore(), add_masquerade_store(), add_to_agi(), after_bridge_cb_find(), after_bridge_cb_setup(), after_bridge_goto_remove(), apply_plc(), ast_bridge_features_ds_get(), ast_bridge_read_after_goto(), ast_can_pickup(), 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_channel_feature_hooks_get(), ast_channel_get_cc_config_params(), ast_channel_suppress(), ast_channel_unsuppress(), ast_handle_cc_control_frame(), ast_ignore_cc(), ast_jb_create_framehook(), ast_odbc_retrieve_transaction_obj(), ast_set_cc_interfaces_chanvar(), async_play_sound_ready(), audiohook_volume_callback(), audiohook_volume_get(), balance_stack(), bridge_channel_impart_add(), bridge_channel_impart_signal(), bridge_features_ds_set_full(), bridge_timeout(), calendar_event_read(), calendar_query_exec(), calendar_query_result_exec(), cc_build_payload(), chan_cleanup(), channel_feature_hooks_set_full(), command_prestart_get_container(), command_prestart_queue_command(), conf_find_bridge_profile(), conf_find_user_profile(), conf_set_menu_to_user(), create_transaction(), detect_callback(), detect_read(), detect_write(), dial_masquerade_datastore_find(), dialplan_handle_msg_cb(), disable_jack_hook(), dtmfstore_exec(), dundi_result_read(), enable_jack_hook(), enum_result_read(), exec_odbcfinish(), fetch_bridge_roles_datastore(), find_details(), find_speech(), find_transaction(), fixup_callback(), frame_drop_helper(), frame_trace_helper(), func_channel_read(), func_channel_write_real(), func_confbridge_helper(), func_mixmonitor_read(), get_agi_cmd(), get_chan_by_ast_name(), get_feature_chan_ds(), get_feature_ds(), get_lock(), get_park_common_datastore_copy(), get_replace_channel_store(), gosub_exec(), gosub_run(), handle_gosub(), handle_remb_set(), has_masquerade_store(), hook_off(), hook_re_enable(), iax2_call(), jack_hook_callback(), local_read(), local_write(), lock_fixup(), lua_get_state(), mark_transaction_active(), max_forwards_datastore_find_or_alloc(), mixmonitor_ds_remove_and_free(), msg_data_func_read(), msg_datastore_find_or_create(), msg_func_read(), msg_send_exec(), MYSQL_exec(), pitchshift_cb(), pitchshift_helper(), pop_exec(), raise_exception(), remb_hook_event_cb(), remove_detect(), remove_dtmf_store(), remove_hold_intercept(), remove_masquerade_store(), remove_scrambler(), remove_stasis_end_published(), remove_talk_detect(), restore_dialstring(), return_exec(), scramble_callback(), scramble_write(), set_hold_intercept(), set_internal_datastore(), set_interval_hook(), set_security_requirements(), set_talk_detect(), setup_async_playback_datastore(), shared_read(), shared_write(), smdi_msg_read(), speech_datastore_destroy(), speex_callback(), speex_read(), speex_write(), srv_query_read(), srv_result_read(), stackpeek_read(), stasis_app_channel_is_internal(), stasis_app_channel_is_stasis_end_published(), stop_mixmonitor_full(), t38_attach_framehook(), talk_detect_audiohook_cb(), unlock_read(), volume_callback(), volume_read(), volume_write(), wait_for_initiator(), wipe_park_common_datastore(), and wipe_subscription_datastore().
struct ast_datastore_list * ast_channel_datastores(struct ast_channel *chan)
Definition: channel_internal_api.c:868
#define AST_LIST_TRAVERSE(head, var, field)
Loops over (traverses) the entries in a list.
Definition: linkedlists.h:490
Definition: search.h:40
◆ ast_channel_datastore_inherit()
| int ast_channel_datastore_inherit | ( | struct ast_channel * | from, |
| struct ast_channel * | to | ||
| ) |
Inherit datastores from a parent to a child.
- Note
- None of the datastore API calls lock the ast_channel they are using. So, the channel should be locked before calling the functions that take a channel argument.
Definition at line 2373 of file channel.c.
References ast_channel_datastores(), ast_datastore_alloc, AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_datastore::data, DATASTORE_INHERIT_FOREVER, ast_datastore_info::duplicate, ast_datastore::info, ast_datastore::inheritance, NULL, and ast_datastore::uid.
Referenced by __ast_request_and_dial(), ast_ari_channels_dial(), ast_unreal_call_setup(), begin_dial_prerun(), call_forward_inherit(), common_recall_channel_setup(), copy_caller_data(), dial_exec_full(), do_forward(), findmeexec(), park_local_transfer(), ring_entry(), and wait_for_answer().
2381 datastore2->data = datastore->info->duplicate ? datastore->info->duplicate(datastore->data) : NULL;
2382 datastore2->inheritance = datastore->inheritance == DATASTORE_INHERIT_FOREVER ? DATASTORE_INHERIT_FOREVER : datastore->inheritance - 1;
struct ast_datastore_list * ast_channel_datastores(struct ast_channel *chan)
Definition: channel_internal_api.c:868
#define AST_LIST_INSERT_TAIL(head, elm, field)
Appends a list entry to the tail of a list.
Definition: linkedlists.h:730
#define AST_LIST_TRAVERSE(head, var, field)
Loops over (traverses) the entries in a list.
Definition: linkedlists.h:490
Definition: search.h:40
◆ ast_channel_datastore_remove()
| int ast_channel_datastore_remove | ( | struct ast_channel * | chan, |
| struct ast_datastore * | datastore | ||
| ) |
Remove a datastore from a channel.
- Note
- The channel should be locked before calling this function.
- Return values
-
0 success non-zero failure
Definition at line 2399 of file channel.c.
References ast_channel_datastores(), and AST_LIST_REMOVE.
Referenced by acf_fetch(), acf_odbc_read(), adjust_frame_for_plc(), after_bridge_goto_remove(), ast_channel_unsuppress(), ast_do_pickup(), ast_jb_create_framehook(), bridge_timeout(), chan_cleanup(), dial_masquerade_fixup(), disable_jack_hook(), exec_odbcfinish(), fixup_callback(), frame_drop_helper(), frame_trace_helper(), func_confbridge_helper(), lua_get_state(), mixmonitor_ds_remove_and_free(), remove_detect(), remove_dial_masquerade(), remove_dial_masquerade_caller(), remove_dtmf_store(), remove_hold_intercept(), remove_masquerade_store(), remove_scrambler(), remove_stasis_end_published(), remove_talk_detect(), set_dial_masquerade(), speech_datastore_destroy(), speex_write(), srv_query_read(), stop_mixmonitor_full(), wipe_park_common_datastore(), and wipe_subscription_datastore().
#define AST_LIST_REMOVE(head, elm, field)
Removes a specific entry from a list.
Definition: linkedlists.h:855
struct ast_datastore_list * ast_channel_datastores(struct ast_channel *chan)
Definition: channel_internal_api.c:868
Definition: search.h:40
◆ ast_channel_datastores()
| struct ast_datastore_list* ast_channel_datastores | ( | struct ast_channel * | chan | ) |
Definition at line 868 of file channel_internal_api.c.
References ast_channel::datastores.
Referenced by __ast_channel_alloc_ap(), __ast_dummy_channel_alloc(), ast_channel_datastore_add(), ast_channel_datastore_find(), ast_channel_datastore_inherit(), ast_channel_datastore_remove(), ast_channel_destructor(), ast_dummy_channel_destructor(), chan_cleanup(), channel_do_masquerade(), handle_cli_mixmonitor(), and stir_shaken_read().
◆ ast_channel_defer_dtmf()
| int ast_channel_defer_dtmf | ( | struct ast_channel * | chan | ) |
Defers DTMF so that you only read things like hangups and audio.
- Returns
- non-zero if channel was already DTMF-deferred or 0 if channel is just now being DTMF-deferred
Defers DTMF so that you only read things like hangups and audio.
Definition at line 1257 of file channel.c.
References ast_channel_flags(), ast_channel_lock, ast_channel_unlock, AST_FLAG_DEFER_DTMF, ast_set_flag, and ast_test_flag.
Referenced by __adsi_transmit_messages(), and find_cache().
Definition: channel.h:982
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ ast_channel_dialcontext()
| const char* ast_channel_dialcontext | ( | const struct ast_channel * | chan | ) |
Referenced by ast_channel_log().
◆ ast_channel_dialed()
| struct ast_party_dialed* ast_channel_dialed | ( | struct ast_channel * | chan | ) |
Definition at line 904 of file channel_internal_api.c.
References ast_channel::dialed.
Referenced by __ast_channel_alloc_ap(), ast_ari_channels_dial(), ast_cel_fabricate_channel_from_event(), ast_channel_destructor(), ast_dummy_channel_destructor(), ast_iax2_new(), ast_str_retrieve_variable(), AST_TEST_DEFINE(), ast_unreal_call_setup(), ast_var_channels_table(), begin_dial_prerun(), callerid_read(), callerid_write(), chan_pjsip_new(), channel_do_masquerade(), channel_snapshot_caller_create(), dahdi_new(), dial_exec_full(), do_forward(), generate_status(), handle_showchan(), iax2_call(), mgcp_ss(), oss_call(), oss_new(), ring_entry(), serialize_showchan(), setup_env(), sip_new(), wait_for_answer(), and wait_for_digits().
◆ ast_channel_dialed_causes_add()
| 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.
- Since
- 11
This function makes use of datastore operations on the channel, so it is important to lock the channel before calling this function. The passed in data is copied and so is still owned by the caller.
- Parameters
-
chan The channel on which to add information cause_code The cause information to be added to the channel datalen The total length of the structure since its length is variable
- Return values
-
0 on success -1 on error
Definition at line 1292 of file channel_internal_api.c.
References ao2_alloc, ao2_find, ao2_link, ao2_ref, ast_control_pvt_cause_code::chan_name, ast_channel::dialed_causes, NULL, OBJ_KEY, OBJ_NODATA, and OBJ_UNLINK.
Referenced by ast_channel_hangupcause_hash_set().
char chan_name[AST_CHANNEL_NAME]
Definition: include/asterisk/frame.h:414
Definition: astobj2.h:1048
Definition: astobj2.h:1043
◆ ast_channel_dialed_causes_channels()
| 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.
- Since
- 11
This function makes use of datastore operations on the channel, so it is important to lock the channel before calling this function.
- Parameters
-
chan The channel from which to retrieve information
- Return values
-
NULL on allocation failure Pointer to an ast_str object containing the desired information which must be freed
Definition at line 1274 of file channel_internal_api.c.
References ao2_callback, ast_str_create, collect_names_cb(), ast_channel::dialed_causes, and NULL.
Referenced by hangupcause_keys_read().
static int collect_names_cb(void *obj, void *arg, int flags)
Definition: channel_internal_api.c:1265
The descriptor of a dynamic string XXX storage will be optimized later if needed We use the ts field ...
Definition: strings.h:584
#define ast_str_create(init_len)
Create a malloc'ed dynamic length string.
Definition: strings.h:620
◆ ast_channel_dialed_causes_clear()
| void ast_channel_dialed_causes_clear | ( | const struct ast_channel * | chan | ) |
Clear all cause information from the channel.
- Since
- 11
This function makes use of datastore operations on the channel, so it is important to lock the channel before calling this function.
- Parameters
-
chan The channel from which to clear information
Definition at line 1308 of file channel_internal_api.c.
References ao2_callback, ast_channel::dialed_causes, NULL, OBJ_MULTIPLE, OBJ_NODATA, and OBJ_UNLINK.
Referenced by hangupcause_clear_exec().
◆ ast_channel_dialed_causes_find()
| 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.
- Since
- 11
This function makes use of datastore operations on the channel, so it is important to lock the channel before calling this function. This function increases the ref count of the returned object, so the calling function must decrease the reference count when it is finished with the object.
- Parameters
-
chan The channel from which to retrieve information chan_name The name of the channel about which to retrieve information
- Return values
-
NULL on search failure Pointer to a ref-counted ast_control_pvt_cause_code object containing the desired information
Definition at line 1287 of file channel_internal_api.c.
References ao2_find, ast_channel::dialed_causes, and OBJ_KEY.
Referenced by hangupcause_read().
◆ ast_channel_dialed_set()
| void ast_channel_dialed_set | ( | struct ast_channel * | chan, |
| struct ast_party_dialed * | value | ||
| ) |
Definition at line 954 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_CALLER, ast_channel_snapshot_invalidate_segment(), ast_channel::dialed, and value.
Referenced by channel_do_masquerade().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
◆ ast_channel_dtmf_digit_to_emulate()
| char ast_channel_dtmf_digit_to_emulate | ( | const struct ast_channel * | chan | ) |
Definition at line 379 of file channel_internal_api.c.
Referenced by __ast_read().
◆ ast_channel_dtmf_digit_to_emulate_set()
| void ast_channel_dtmf_digit_to_emulate_set | ( | struct ast_channel * | chan, |
| char | value | ||
| ) |
Definition at line 383 of file channel_internal_api.c.
References value.
Referenced by __ast_read().
◆ ast_channel_dtmf_tv()
| struct timeval* ast_channel_dtmf_tv | ( | struct ast_channel * | chan | ) |
Definition at line 924 of file channel_internal_api.c.
References ast_channel::dtmf_tv.
Referenced by __ast_read(), should_skip_dtmf(), and should_trigger_dtmf_emulating().
◆ ast_channel_dtmf_tv_set()
| void ast_channel_dtmf_tv_set | ( | struct ast_channel * | chan, |
| struct timeval * | value | ||
| ) |
Definition at line 964 of file channel_internal_api.c.
References ast_channel::dtmf_tv, and value.
Referenced by __ast_read().
◆ ast_channel_dtmff()
| struct ast_frame* ast_channel_dtmff | ( | struct ast_channel * | chan | ) |
Definition at line 880 of file channel_internal_api.c.
References ast_channel::dtmff.
Referenced by __ast_read(), and queue_dtmf_readq().
◆ ast_channel_dtmff_set()
| void ast_channel_dtmff_set | ( | struct ast_channel * | chan, |
| struct ast_frame * | value | ||
| ) |
◆ ast_channel_early_bridge()
| int ast_channel_early_bridge | ( | struct ast_channel * | c0, |
| struct ast_channel * | c1 | ||
| ) |
Bridge two channels together (early)
- Parameters
-
c0 first channel to bridge c1 second channel to bridge
Bridge two channels (c0 and c1) together early. This implies either side may not be answered yet.
- Returns
- Returns 0 on success and -1 if it could not be done
Definition at line 7512 of file channel.c.
References ast_channel_tech(), and ast_channel_tech::early_bridge.
Referenced by dial_exec_full(), and wait_for_answer().
7515 if (!ast_channel_tech(c0)->early_bridge || (c1 && (!ast_channel_tech(c1)->early_bridge || ast_channel_tech(c0)->early_bridge != ast_channel_tech(c1)->early_bridge)))
enum ast_bridge_result(*const early_bridge)(struct ast_channel *c0, struct ast_channel *c1)
Bridge two channels of the same type together (early)
Definition: channel.h:769
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_channel_emulate_dtmf_duration()
| unsigned int ast_channel_emulate_dtmf_duration | ( | const struct ast_channel * | chan | ) |
Definition at line 509 of file channel_internal_api.c.
Referenced by __ast_read().
◆ ast_channel_emulate_dtmf_duration_set()
| void ast_channel_emulate_dtmf_duration_set | ( | struct ast_channel * | chan, |
| unsigned int | value | ||
| ) |
Definition at line 513 of file channel_internal_api.c.
References value.
Referenced by __ast_read().
◆ ast_channel_end_dtmf()
| 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.
- Parameters
-
chan Channel sending DTMF that has not ended. digit DTMF digit to stop. start DTMF digit start time. why Reason bridge broken.
- Returns
- Nothing
Definition at line 11070 of file channel.c.
References ast_channel_flags(), ast_channel_lock, ast_channel_name(), ast_channel_softhangup_internal_flag(), ast_channel_unlock, AST_FLAG_ZOMBIE, ast_log, ast_senddigit_end(), AST_SOFTHANGUP_ASYNCGOTO, ast_test_flag, ast_tvdiff_ms(), ast_tvnow(), LOG_DTMF, and option_dtmfminduration.
Referenced by bridge_channel_internal_join(), and channel_do_masquerade().
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
int64_t ast_tvdiff_ms(struct timeval end, struct timeval start)
Computes the difference (in milliseconds) between two struct timeval instances.
Definition: time.h:98
int ast_senddigit_end(struct ast_channel *chan, char digit, unsigned int duration)
Send a DTMF digit to a channel.
Definition: channel.c:4969
Definition: channel.h:988
Definition: channel.h:1127
int ast_channel_softhangup_internal_flag(struct ast_channel *chan)
Definition: channel_internal_api.c:997
const char * ast_channel_name(const struct ast_channel *chan)
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ ast_channel_epfd()
| int ast_channel_epfd | ( | const struct ast_channel * | chan | ) |
◆ ast_channel_epfd_set()
| void ast_channel_epfd_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
◆ ast_channel_errno()
| enum ast_channel_error ast_channel_errno | ( | void | ) |
Get error code for latest channel operation.
Definition at line 11162 of file channel.c.
References ast_channel_internal_errno().
Referenced by ari_channels_handle_originate_with_id(), and ast_ari_channels_create().
enum ast_channel_error ast_channel_internal_errno(void)
Definition: channel_internal_api.c:1573
◆ ast_channel_exten()
| const char* ast_channel_exten | ( | const struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 353 of file channel_internal_api.c.
Referenced by __ast_goto_if_exists(), __ast_pbx_run(), _if_exec(), _macro_exec(), _while_exec(), action_bridge(), action_dialplan_exec(), ast_app_exec_macro(), ast_bridge_setup_after_goto(), ast_cc_call_init(), ast_channel_by_exten_cb(), ast_channel_log(), ast_channel_yank(), ast_pbx_h_exten_run(), ast_str_retrieve_variable(), AST_TEST_DEFINE(), ast_var_channels_table(), bridge_exec(), cb_events(), cc_generic_agent_init(), cc_interfaces_datastore_init(), chan_pjsip_cng_tone_detected(), channel_snapshot_dialplan_create(), dahdi_handle_dtmf(), dial_exec_full(), do_forward(), do_immediate_setup(), dundi_exec(), dundi_helper(), eval_exten_read(), expand_gosub_args(), fax_detect_framehook(), feature_blind_transfer(), find_matching_endif(), find_matching_endwhile(), forward_message(), func_channel_read(), func_channel_write_real(), get_cid_name(), gosub_exec(), gosub_run(), goto_parser(), handle_cli_misdn_show_channels(), handle_frame(), handle_gosub(), handle_setpriority(), handle_showchan(), launch_monitor_thread(), leave_voicemail(), log_exec(), lua_pbx_exec(), misdn_hangup(), misdn_update_redirecting(), misdn_write(), my_handle_dtmf(), onModeChanged(), ooh323_rtp_read(), ospauth_exec(), pbx_builtin_goto(), pbx_builtin_setvar_multiple(), pbx_builtin_waitexten(), pbx_extension_helper(), pbx_parseable_goto(), print_bc_info(), process_ast_dsp(), process_sdp(), raise_exception(), realtime_exec(), release_chan(), ring_entry(), serialize_showchan(), setup_env(), setup_peer_after_bridge_goto(), setup_privacy_args(), sip_read(), skinny_newcall(), try_calling(), and wait_for_answer().
◆ ast_channel_exten_set()
| void ast_channel_exten_set | ( | struct ast_channel * | chan, |
| const char * | value | ||
| ) |
Definition at line 357 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_DIALPLAN, ast_channel_snapshot_invalidate_segment(), and ast_copy_string().
Referenced by __analog_ss_thread(), __ast_channel_alloc_ap(), __ast_request_and_dial(), _macro_exec(), action_dialplan_exec(), alsa_new(), analog_ss_thread(), ari_originate_dial(), ast_add_extension2_lockopt(), ast_bridge_setup_after_goto(), ast_cel_fabricate_channel_from_event(), ast_explicit_goto(), ast_iax2_new(), ast_pbx_h_exten_run(), AST_TEST_DEFINE(), cb_events(), dahdi_new(), dial_exec_full(), dialout(), do_immediate_setup(), do_monitor_headset(), do_notify(), eval_exten_read(), forward_message(), generic_recall(), gosub_exec(), gosub_run(), handle_gosub(), handle_response_cmgr(), handle_setextension(), jingle_new(), leave_voicemail(), mgcp_new(), mgcp_ss(), minivm_greet_exec(), misdn_call(), misdn_digit_end(), misdn_new(), misdn_overlap_dial_task(), nbs_new(), ooh323_new(), pbx_builtin_background(), pbx_extension_helper(), pbx_outgoing_exec(), phone_new(), read_config(), return_exec(), ring_entry(), select_entry(), set_ext_pri(), setsubstate(), sip_new(), skinny_new(), unistim_ss(), and wait_for_answer().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401
◆ ast_channel_fd()
| int ast_channel_fd | ( | const struct ast_channel * | chan, |
| int | which | ||
| ) |
Definition at line 1186 of file channel_internal_api.c.
References AST_VECTOR_GET, and AST_VECTOR_SIZE.
Referenced by __dahdi_exception(), analog_exception(), ast_channel_fd_isset(), AST_TEST_DEFINE(), ast_waitfor_nandfds(), build_conf(), channel_do_masquerade(), conf_run(), dahdiras_exec(), flash_exec(), meetme_menu_admin_extended(), native_chan_changed(), native_start(), phone_call(), phone_new(), run_ras(), serialize_showchan(), spawn_ras(), and swap_subs().
◆ ast_channel_fd_add()
| int ast_channel_fd_add | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Add a file descriptor to the channel without a fixed position.
- Since
- 15
- Parameters
-
chan The channel to add the file descriptor to value The file descriptor
- Precondition
- chan is locked
- Returns
- The position of the file descriptor
Definition at line 1200 of file channel_internal_api.c.
References ast_channel_fd_isset(), AST_EXTENDED_FDS, and AST_VECTOR_REPLACE.
Referenced by AST_TEST_DEFINE().
#define AST_VECTOR_REPLACE(vec, idx, elem)
Replace an element at a specific position in a vector, growing the vector if needed.
Definition: vector.h:284
int ast_channel_fd_isset(const struct ast_channel *chan, int which)
Definition: channel_internal_api.c:1190
◆ ast_channel_fd_count()
| int ast_channel_fd_count | ( | const struct ast_channel * | chan | ) |
Retrieve the number of file decriptor positions present on the channel.
- Since
- 15
- Parameters
-
chan The channel to get the count of
- Precondition
- chan is locked
- Returns
- The number of file descriptor positions
Definition at line 1195 of file channel_internal_api.c.
References AST_VECTOR_SIZE.
Referenced by AST_TEST_DEFINE(), ast_waitfor_nandfds(), and channel_do_masquerade().
◆ ast_channel_fd_isset()
| int ast_channel_fd_isset | ( | const struct ast_channel * | chan, |
| int | which | ||
| ) |
Definition at line 1190 of file channel_internal_api.c.
References ast_channel_fd().
Referenced by __ast_read(), and ast_channel_fd_add().
int ast_channel_fd(const struct ast_channel *chan, int which)
Definition: channel_internal_api.c:1186
◆ ast_channel_fdno()
| int ast_channel_fdno | ( | const struct ast_channel * | chan | ) |
Definition at line 419 of file channel_internal_api.c.
Referenced by __ast_read(), ast_settimeout_full(), chan_pjsip_read_stream(), channel_do_masquerade(), hook_event_cb(), jingle_read(), ooh323_rtp_read(), rtp_read(), sip_rtp_read(), skinny_rtp_read(), stasis_app_control_execute_until_exhausted(), stasis_app_exec(), and unistim_rtp_read().
◆ ast_channel_fdno_set()
| void ast_channel_fdno_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 423 of file channel_internal_api.c.
References value.
Referenced by __ast_read(), ast_settimeout_full(), ast_waitfor_nandfds(), channel_do_masquerade(), and read_test().
◆ ast_channel_feature_hooks_append()
| 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.
- Note
- The channel must be locked when calling this function.
- Parameters
-
chan Which channel to set features for features The feature set to append to the channel's features
- Return values
-
0 on success -1 on failure
Definition at line 11152 of file channel.c.
References channel_feature_hooks_set_full().
Referenced by AST_TEST_DEFINE().
static int channel_feature_hooks_set_full(struct ast_channel *chan, struct ast_bridge_features *features, int replace)
Definition: channel.c:11115
◆ ast_channel_feature_hooks_get()
| 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.
- Note
- The channel must be locked when calling this function.
- Parameters
-
chan Which channel to get features for
- Return values
-
non-NULL The features currently set for this channel NULL if the features have not been set
Definition at line 11104 of file channel.c.
References ast_channel_datastore_find(), ast_datastore::data, and NULL.
Referenced by bridge_channel_internal_join().
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.
Definition: channel.c:2404
static const struct ast_datastore_info bridge_features_info
Definition: channel.c:11099
◆ ast_channel_feature_hooks_replace()
| 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.
- Note
- The channel must be locked when calling this function.
- Parameters
-
chan Which channel to set features for features The feature set with which to replace the channel's features
- Return values
-
0 on success -1 on failure
Definition at line 11157 of file channel.c.
References channel_feature_hooks_set_full().
static int channel_feature_hooks_set_full(struct ast_channel *chan, struct ast_bridge_features *features, int replace)
Definition: channel.c:11115
◆ ast_channel_fin()
| unsigned int ast_channel_fin | ( | const struct ast_channel * | chan | ) |
Definition at line 517 of file channel_internal_api.c.
Referenced by __ast_read(), channel_set_debug(), and serialize_showchan().
◆ ast_channel_fin_set()
| void ast_channel_fin_set | ( | struct ast_channel * | chan, |
| unsigned int | value | ||
| ) |
Definition at line 521 of file channel_internal_api.c.
References value.
Referenced by __ast_channel_alloc_ap(), __ast_read(), and channel_set_debug().
◆ ast_channel_flags()
| struct ast_flags* ast_channel_flags | ( | struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 1260 of file channel_internal_api.c.
Referenced by __analog_ss_thread(), __ast_pbx_run(), __ast_queue_frame(), __ast_read(), __ast_request_and_dial(), _macro_exec(), action_bridge(), action_redirect(), agent_request_exec(), analog_ss_thread(), ari_channels_handle_originate_with_id(), ast_async_goto(), ast_audiohook_attach(), ast_autoservice_start(), ast_autoservice_stop(), ast_bridge_channel_playfile(), ast_bridge_join(), ast_bridge_setup_after_goto(), ast_call(), ast_can_pickup(), ast_channel_clear_flag(), ast_channel_defer_dtmf(), ast_channel_destructor(), ast_channel_end_dtmf(), ast_channel_move(), ast_channel_publish_snapshot(), ast_channel_set_flag(), ast_channel_snapshot_create(), ast_channel_stage_snapshot(), ast_channel_stage_snapshot_done(), ast_channel_yank(), ast_explicit_goto(), ast_hangup(), ast_iax2_new(), ast_indicate_data(), ast_pbx_h_exten_run(), ast_raw_answer_with_stream_topology(), ast_readstring_full(), ast_sendtext_data(), ast_setstate(), ast_settimeout_full(), ast_softhangup_nolock(), ast_streamfile(), AST_TEST_DEFINE(), ast_transfer_protocol(), ast_unreal_new_channels(), ast_var_channels_table(), ast_waitfor_nandfds(), ast_waitfordigit_full(), ast_write_stream(), bridge_channel_handle_control(), bridge_channel_internal_join(), bridge_channel_internal_pull(), bridge_impart_internal(), bridge_reconfigured_connected_line_update(), call_forward_inherit(), channel_do_masquerade(), channel_spy(), common_exec(), dahdi_new(), dahdi_read(), deactivate_generator_nolock(), dial_exec_full(), eivr_comm(), gosub_exec(), gosub_run(), handle_exec(), handle_gosub(), limits_interval_playback(), linear_alloc(), local_ast_moh_start(), local_ast_moh_stop(), optimize_lock_chan_stack(), optimize_lock_peer_stack(), pbx_builtin_background(), pbx_outgoing_attempt(), phone_read(), playtones_alloc(), retrydial_exec(), return_exec(), serialize_showchan(), should_skip_dtmf(), should_trigger_dtmf_emulating(), sip_fixup(), sip_new(), sip_peer_hold(), tonepair_alloc(), and waitstream_core().
◆ ast_channel_forward_endpoint()
| int ast_channel_forward_endpoint | ( | struct ast_channel * | chan, |
| struct ast_endpoint * | endpoint | ||
| ) |
Forward channel stasis messages to the given endpoint.
- Since
- 12
- Parameters
-
chan The channel to forward from endpoint The endpoint to forward to
- Return values
-
0 Success non-zero Failure
Definition at line 1511 of file channel_internal_api.c.
References ast_assert, ast_channel_topic(), ast_endpoint_topic(), NULL, and stasis_forward_all().
Referenced by ast_endpoint_add_channel().
struct stasis_topic * ast_endpoint_topic(struct ast_endpoint *endpoint)
Returns the topic for a specific endpoint.
Definition: main/endpoints.c:93
struct stasis_topic * ast_channel_topic(struct ast_channel *chan)
A topic which publishes the events for a particular channel.
Definition: channel_internal_api.c:1502
struct stasis_forward * stasis_forward_all(struct stasis_topic *from_topic, struct stasis_topic *to_topic)
Create a subscription which forwards all messages from one topic to another.
Definition: stasis.c:1578
◆ ast_channel_fout()
| unsigned int ast_channel_fout | ( | const struct ast_channel * | chan | ) |
Definition at line 525 of file channel_internal_api.c.
Referenced by ast_write_stream(), channel_set_debug(), and serialize_showchan().
◆ ast_channel_fout_set()
| void ast_channel_fout_set | ( | struct ast_channel * | chan, |
| unsigned int | value | ||
| ) |
Definition at line 529 of file channel_internal_api.c.
References value.
Referenced by __ast_channel_alloc_ap(), ast_write_stream(), and channel_set_debug().
◆ ast_channel_framehooks()
| struct ast_framehook_list* ast_channel_framehooks | ( | const struct ast_channel * | chan | ) |
Definition at line 705 of file channel_internal_api.c.
References ast_channel::framehooks.
Referenced by __ast_read(), ast_channel_has_audio_frame_or_monitor(), ast_channel_has_hook_requiring_audio(), ast_framehook_attach(), ast_framehook_detach(), ast_framehook_list_destroy(), ast_framehook_list_fixup(), ast_indicate_data(), and ast_write_stream().
◆ ast_channel_framehooks_set()
| void ast_channel_framehooks_set | ( | struct ast_channel * | chan, |
| struct ast_framehook_list * | value | ||
| ) |
Definition at line 709 of file channel_internal_api.c.
References ast_channel::framehooks, and value.
Referenced by ast_framehook_attach(), and ast_framehook_list_destroy().
◆ ast_channel_generator()
| struct ast_generator* ast_channel_generator | ( | const struct ast_channel * | chan | ) |
Definition at line 713 of file channel_internal_api.c.
References ast_channel::generator.
Referenced by __ast_read(), ast_activate_generator(), ast_hangup(), ast_openstream_full(), ast_read_generator_actions(), ast_senddigit_end(), ast_senddigit_mf_end(), cb_events(), deactivate_generator_nolock(), deactivate_silence_generator(), generator_force(), generator_write_format_change(), and unreal_queue_frame().
◆ ast_channel_generator_set()
| void ast_channel_generator_set | ( | struct ast_channel * | chan, |
| struct ast_generator * | value | ||
| ) |
Definition at line 717 of file channel_internal_api.c.
References ast_channel::generator, and value.
Referenced by ast_activate_generator(), ast_hangup(), and deactivate_generator_nolock().
◆ ast_channel_generatordata()
| void* ast_channel_generatordata | ( | const struct ast_channel * | chan | ) |
Definition at line 549 of file channel_internal_api.c.
References ast_channel::generatordata.
Referenced by __ast_read(), ast_activate_generator(), ast_hangup(), ast_read_generator_actions(), ast_tonepair(), ast_write_stream(), cb_events(), deactivate_generator_nolock(), deactivate_silence_generator(), generator_force(), generator_write_format_change(), safe_sleep_conditional(), and set_format().
◆ ast_channel_generatordata_set()
| void ast_channel_generatordata_set | ( | struct ast_channel * | chan, |
| void * | value | ||
| ) |
Definition at line 553 of file channel_internal_api.c.
References ast_channel::generatordata, and value.
Referenced by __ast_read(), ast_activate_generator(), ast_hangup(), ast_read_generator_actions(), cb_events(), deactivate_generator_nolock(), and generator_force().
◆ ast_channel_get_ari_vars()
| 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().
- Since
- 14.2.0 The returned variable list is an AO2 object, so ao2_cleanup() to free it.
- Parameters
-
chan Channel to get variables for.
- Returns
- List of channel variables.
-
NULLon error
Definition at line 8090 of file channel.c.
References ari_vars, and channel_get_external_vars().
Referenced by ast_channel_snapshot_create().
static struct varshead * channel_get_external_vars(struct external_vars *channelvars, struct ast_channel *chan)
Definition: channel.c:8038
◆ ast_channel_get_bridge()
| struct ast_bridge* ast_channel_get_bridge | ( | const struct ast_channel * | chan | ) |
Get the bridge associated with a channel.
- Since
- 12.0.0
- Parameters
-
chan The channel whose bridge we want
The bridge returned has its reference count incremented. Use ao2_cleanup() or ao2_ref() in order to decrement the reference count when you are finished with the bridge.
- Note
- This function expects the channel to be locked prior to being called and will not grab the channel lock.
- Return values
-
NULL No bridge present on the channel non-NULL The bridge the channel is in
Definition at line 10735 of file channel.c.
References ao2_ref, and ast_channel_internal_bridge().
Referenced by ast_bridge_add_channel(), ast_bridge_transfer_acquire_bridge(), ast_channel_bridge_peer(), bridgeadd_exec(), channel_snapshot_bridge_create(), generate_status(), get_transfer_parties(), handle_showchan(), manager_bridge_kick(), native_rtp_framehook(), and serialize_showchan().
struct ast_bridge * ast_channel_internal_bridge(const struct ast_channel *chan)
Definition: channel_internal_api.c:1240
◆ ast_channel_get_bridge_channel()
| struct ast_bridge_channel* ast_channel_get_bridge_channel | ( | struct ast_channel * | chan | ) |
Get a reference to the channel's bridge pointer.
- Since
- 12.0.0
- Parameters
-
chan The channel whose bridge channel is desired
- Note
- This increases the reference count of the bridge_channel. Use ao2_ref() or ao2_cleanup() to decrement the refcount when you are finished with it.
- It is expected that the channel is locked prior to placing this call.
- Return values
-
NULL The channel has no bridge_channel non-NULL A reference to the bridge_channel
Definition at line 10783 of file channel.c.
References ao2_ref, and ast_channel_internal_bridge_channel().
Referenced by __analog_ss_thread(), agent_bridge_channel_get_lock(), analog_ss_thread(), ast_bridge_add_channel(), ast_bridge_notify_masquerade(), ast_bridge_transfer_attended(), ast_bridge_transfer_blind(), bridge_channel_internal_queue_attended_transfer(), bridge_channel_internal_queue_blind_transfer(), bridge_move(), dial_bridge_after_cb(), handle_soft_key_event_message(), handle_stimulus_message(), hold(), internal_bridge_after_cb(), manager_park_bridged(), mgcp_ss(), parker_parked_call_message_response(), play_sound(), recall_pull(), ringing(), send_message(), set_interval_hook(), transfer_pull(), try_parking(), and unhold().
struct ast_bridge_channel * ast_channel_internal_bridge_channel(const struct ast_channel *chan)
Definition: channel_internal_api.c:1251
Structure that contains information regarding a channel in a bridge.
Definition: bridge_channel.h:84
◆ ast_channel_get_by_exten()
| struct ast_channel* ast_channel_get_by_exten | ( | const char * | exten, |
| const char * | context | ||
| ) |
Find a channel by extension and context.
- Parameters
-
exten the extension to search for context the context to search for
Return a channel that is currently at the specified extension and context.
- Return values
-
a channel that is at the specified extension and context NULL if no channel was found
- Since
- 1.8
Definition at line 1459 of file channel.c.
References ast_channel_by_exten_cb(), and ast_channel_callback().
static int ast_channel_by_exten_cb(void *obj, void *arg, void *data, int flags)
Definition: channel.c:1306
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.
Definition: channel.c:1278
◆ ast_channel_get_by_name()
| struct ast_channel* ast_channel_get_by_name | ( | const char * | name | ) |
Find a channel by name.
Channel search functions
- Parameters
-
name the name or uniqueid of the channel to search for
Find a channel that has the same name as the provided argument.
- Return values
-
a channel with the name specified by the argument NULL if no channel was found
- Since
- 1.8
Definition at line 1454 of file channel.c.
References ast_channel_get_by_name_prefix().
Referenced by action_add_agi_cmd(), action_aocmessage(), action_atxfer(), action_blind_transfer(), action_cancel_atxfer(), action_getvar(), action_hangup(), action_redirect(), action_sendtext(), action_setvar(), action_status(), action_timeout(), ari_channels_handle_originate_with_id(), ari_channels_handle_snoop_channel(), assign_uuid(), ast_ari_channels_create(), ast_ari_channels_dial(), ast_ari_channels_get_channel_var(), ast_ari_channels_hangup(), ast_ari_channels_rtpstatistics(), ast_async_goto_by_name(), asyncgoto_exec(), bridge_channel_attended_transfer(), call_forwarded_handler(), change_monitor_action(), channel_find(), cli_channelstats_print_body(), common_exec(), controlplayback_manager(), do_pause_or_unpause(), find_control(), func_mchan_read(), func_mchan_write(), handle_cli_agi_add_cmd(), handle_core_set_debug_channel(), handle_getvariablefull(), handle_hangup(), handle_redirect(), handle_remb_set(), handle_set_chanvar(), handle_show_chanvar(), handle_show_hangup_channel(), handle_showchan(), handle_softhangup(), import_helper(), inherit_channel_vars_from_id(), manager_bridge_kick(), manager_mixmonitor(), manager_mute_mixmonitor(), manager_mutestream(), manager_optimize_away(), manager_park(), manager_play_dtmf(), manager_play_mf(), manager_stop_mixmonitor(), moh_channel_thread(), parker_parked_call_message_response(), parking_park_bridge_channel(), pbx_builtin_importvar(), push_notify_channel(), refer_progress_bridge(), rtp_check_timeout(), senddtmf_exec(), sendmf_exec(), shared_read(), shared_write(), start_monitor_action(), stasis_app_bridge_moh_channel(), stasis_app_bridge_moh_stop(), stasis_app_bridge_playback_channel_find(), and stop_monitor_action().
struct ast_channel * ast_channel_get_by_name_prefix(const char *name, size_t name_len)
Find a channel by a name prefix.
Definition: channel.c:1434
◆ ast_channel_get_by_name_prefix()
| struct ast_channel* ast_channel_get_by_name_prefix | ( | const char * | name, |
| size_t | name_len | ||
| ) |
Find a channel by a name prefix.
- Parameters
-
name The channel name or uniqueid prefix to search for name_len Only search for up to this many characters from the name
Find a channel that has the same name prefix as specified by the arguments.
- Return values
-
a channel with the name prefix specified by the arguments NULL if no channel was found
- Since
- 1.8
Definition at line 1434 of file channel.c.
References ast_channel_by_name_cb(), ast_channel_by_uniqueid_cb(), ast_channel_callback(), ast_strlen_zero, chanlist::chan, NULL, and OBJ_KEY.
Referenced by action_aocmessage(), action_bridge(), ast_channel_get_by_name(), ast_parse_device_state(), bridge_exec(), bridgeadd_exec(), cc_generic_agent_stop_ringing(), common_exec(), handle_bridge_kick_channel(), handle_cli_mixmonitor(), shared_read(), and shared_write().
static int ast_channel_by_uniqueid_cb(void *obj, void *arg, void *data, int flags)
Definition: channel.c:1329
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.
Definition: channel.c:1278
static int ast_channel_by_name_cb(void *obj, void *arg, void *data, int flags)
Definition: channel.c:1284
◆ ast_channel_get_cc_agent_type()
| 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.
- Since
- 1.8
During call completion, we will need to create a call completion agent structure. To figure out the type of agent to construct, we need to ask the channel driver for the appropriate type.
Prior to adding this function, the call completion core attempted to figure this out for itself by stripping the technology off the channel's name. However, in the case of chan_dahdi, there are multiple agent types registered, and so simply searching for an agent type called "DAHDI" is not possible. In a case where multiple agent types are defined, the channel driver must have a queryoption callback defined in its channel_tech, and the queryoption callback must handle AST_OPTION_CC_AGENT_TYPE
If a channel driver does not have a queryoption callback or if the queryoption callback does not handle AST_OPTION_CC_AGENT_TYPE, then the old behavior of using the technology portion of the channel name is used instead. This is perfectly suitable for channel drivers whose channel technologies are a one-to-one match with the agent types defined within.
Note that this function is only called when the agent policy on a given channel is set to "native." Generic agents' type can be determined automatically by the core.
- Parameters
-
chan The channel for which we wish to retrieve the agent type [out] agent_type The type of agent the channel driver wants us to use size The size of the buffer to write to
Definition at line 10714 of file channel.c.
References ast_channel_name(), ast_channel_queryoption(), ast_copy_string(), AST_OPTION_CC_AGENT_TYPE, and len().
Referenced by find_agent_callbacks().
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
Definition: func_strings.c:1344
int ast_channel_queryoption(struct ast_channel *chan, int option, void *data, int *datalen, int block)
Checks the value of an option.
Definition: channel.c:7542
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401
const char * ast_channel_name(const struct ast_channel *chan)
◆ ast_channel_get_cc_config_params()
| struct ast_cc_config_params* ast_channel_get_cc_config_params | ( | struct ast_channel * | chan | ) |
Get the CCSS parameters from a channel.
- Since
- 1.8
This function makes use of datastore operations on the channel, so it is important to lock the channel before calling this function.
- Parameters
-
chan Channel to retrieve parameters from
- Return values
-
NULL Failure non-NULL The parameters desired
Definition at line 10675 of file channel.c.
References ast_assert, ast_channel_cc_params_init(), ast_channel_datastore_find(), ast_datastore::data, and NULL.
Referenced by acf_cc_read(), acf_cc_write(), analog_call(), ast_cc_call_failed(), ast_cc_call_init(), ast_queue_cc_frame(), ast_unreal_call_setup(), ast_unreal_new_channels(), cc_agent_init(), cc_core_init_instance(), and find_agent_callbacks().
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.
Definition: channel.c:2404
static const struct ast_datastore_info cc_channel_datastore_info
Definition: channel.c:10646
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.
Definition: channel.c:10652
◆ ast_channel_get_default_stream()
| 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.
- Parameters
-
channel The channel to get the stream from type The media type of the default stream
- Precondition
- chan is locked
- Return values
-
non-NULL success NULL failure
Definition at line 1619 of file channel_internal_api.c.
References ast_assert, AST_MEDIA_TYPE_END, NULL, and type.
Referenced by __ast_read(), ast_unreal_write_stream(), ast_write_stream(), and stream_echo_write_error().
Definition: codec.h:36
◆ ast_channel_get_device_name()
| 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.
- Since
- 1.8
A common practice in Asterisk is to determine the device being talked to by dissecting the channel name. For certain channel types, this is not accurate. For instance, an ISDN channel is named based on what B channel is used, not the device being communicated with.
This function interfaces with a channel tech's queryoption callback to retrieve the name of the device being communicated with. If the channel does not implement this specific option, then the traditional method of using the channel name is used instead.
- Parameters
-
chan The channel to retrieve the information from [out] device_name The buffer to place the device's name into name_buffer_length The allocated space for the device_name
- Returns
- 0 always
Definition at line 10697 of file channel.c.
References ast_channel_name(), ast_channel_queryoption(), ast_copy_string(), AST_OPTION_DEVICE_NAME, and len().
Referenced by ast_cc_call_failed(), ast_cc_is_recall(), ast_queue_cc_frame(), cc_core_init_instance(), cccancel_exec(), ccreq_exec(), chan_pjsip_indicate(), dial_exec_full(), sip_call(), and sip_handle_cc().
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
Definition: func_strings.c:1344
int ast_channel_queryoption(struct ast_channel *chan, int option, void *data, int *datalen, int block)
Checks the value of an option.
Definition: channel.c:7542
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401
const char * ast_channel_name(const struct ast_channel *chan)
◆ ast_channel_get_duration()
| int ast_channel_get_duration | ( | struct ast_channel * | chan | ) |
Obtain how long the channel since the channel was created.
- Since
- 12
- Parameters
-
chan The channel object
- Return values
-
0 if the time value cannot be computed (or you called this really fast) The number of seconds the channel has been up
Definition at line 2839 of file channel.c.
References ast_channel_get_duration_ms().
Referenced by end_bridge_callback(), serialize_showchan(), and show_chanstats_cb().
int64_t ast_channel_get_duration_ms(struct ast_channel *chan)
Obtain how long it's been, in milliseconds, since the channel was created.
Definition: channel.c:2829
◆ ast_channel_get_duration_ms()
| int64_t ast_channel_get_duration_ms | ( | struct ast_channel * | chan | ) |
Obtain how long it's been, in milliseconds, since the channel was created.
- Since
- 13.27.0
- 16.4.0
- Parameters
-
chan The channel object
- Return values
-
0 if the time value cannot be computed (or you called this really fast) The number of milliseconds since channel creation
Definition at line 2829 of file channel.c.
References ast_assert, ast_channel_creationtime(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), and NULL.
Referenced by ast_channel_get_duration(), and end_bridge_callback().
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
int64_t ast_tvdiff_ms(struct timeval end, struct timeval start)
Computes the difference (in milliseconds) between two struct timeval instances.
Definition: time.h:98
struct timeval ast_channel_creationtime(struct ast_channel *chan)
Definition: channel_internal_api.c:976
◆ ast_channel_get_intercept_mode()
| int ast_channel_get_intercept_mode | ( | void | ) |
Am I currently running an intercept dialplan routine.
- Since
- 13.14.0
A dialplan intercept routine is equivalent to an interrupt routine. As such, the routine must be done quickly and you do not have access to the media stream. These restrictions are necessary because the media stream is the responsibility of some other code and interfering with or delaying that processing is bad.
- Return values
-
0 Not in an intercept routine. 1 In an intercept routine.
Definition at line 10430 of file channel.c.
References ast_threadstorage_get_ptr().
Referenced by run_agi().
void * ast_threadstorage_get_ptr(struct ast_threadstorage *ts)
Retrieve a raw pointer from threadstorage.
Definition: threadstorage.h:241
◆ ast_channel_get_manager_vars()
| 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().
- Since
- 12 The returned variable list is an AO2 object, so ao2_cleanup() to free it.
- Parameters
-
chan Channel to get variables for.
- Returns
- List of channel variables.
-
NULLon error
Definition at line 8085 of file channel.c.
References ami_vars, and channel_get_external_vars().
Referenced by append_channel_vars(), and ast_channel_snapshot_create().
static struct varshead * channel_get_external_vars(struct external_vars *channelvars, struct ast_channel *chan)
Definition: channel.c:8038
◆ ast_channel_get_stream_topology()
| struct ast_stream_topology* ast_channel_get_stream_topology | ( | const struct ast_channel * | chan | ) |
Retrieve the topology of streams on a channel.
- Parameters
-
chan The channel to get the stream topology of
- Precondition
- chan is locked
- Return values
-
non-NULL success NULL failure
Definition at line 1583 of file channel_internal_api.c.
References ast_assert, and NULL.
Referenced by __ast_read(), ast_bridge_channel_stream_map(), ast_channel_request_stream_topology_change(), AST_TEST_DEFINE(), ast_unreal_indicate(), ast_write_stream(), dial_exec_full(), do_forward(), handle_showchan(), map_source_to_destinations(), native_rtp_bridge_join(), native_rtp_stream_topology_changed(), sfu_topologies_on_join(), sfu_topologies_on_source_change(), simple_bridge_join(), simple_bridge_stream_topology_changed(), softmix_bridge_stream_sources_update(), softmix_bridge_stream_topology_changed(), stream_echo_exec(), stream_echo_write(), and stream_echo_write_error().
◆ ast_channel_get_stream_topology_change_source()
| void* ast_channel_get_stream_topology_change_source | ( | struct ast_channel * | chan | ) |
Retrieve the source that initiated the last stream topology change.
- Parameters
-
chan The channel
- Return values
-
The channel's stream topology change source
Definition at line 672 of file channel_internal_api.c.
Referenced by native_rtp_stream_topology_changed(), and simple_bridge_stream_topology_changed().
◆ ast_channel_get_t38_state()
|
inlinestatic |
Retrieves the current T38 state of a channel.
- Note
- Absolutely NO channel locks should be held before calling this function.
Definition at line 2873 of file channel.h.
References ast_channel_queryoption(), AST_OPTION_T38_STATE, state, and T38_STATE_UNAVAILABLE.
Referenced by fax_gateway_detect_t38(), fax_gateway_detect_v21(), fax_gateway_framehook(), generic_fax_exec(), receivefax_exec(), receivefax_t38_init(), sendfax_exec(), sendfax_t38_init(), set_fax_t38_caps(), spandsp_fax_gateway_start(), transmit(), transmit_audio(), and transmit_t38().
int ast_channel_queryoption(struct ast_channel *channel, int option, void *data, int *datalen, int block)
Checks the value of an option.
Definition: channel.c:7542
Definition: channel.h:880
Definition: localtime.c:158
◆ ast_channel_get_up_time()
| int ast_channel_get_up_time | ( | struct ast_channel * | chan | ) |
Obtain how long it has been since the channel was answered.
- Since
- 12
- Parameters
-
chan The channel object
- Return values
-
0 if the channel isn't answered (or you called this really fast) The number of seconds the channel has been up
Definition at line 2854 of file channel.c.
References ast_channel_get_up_time_ms().
Referenced by action_confbridgelist_item(), chan_pjsip_read_stream(), dahdi_read(), and end_bridge_callback().
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.
Definition: channel.c:2844
◆ ast_channel_get_up_time_ms()
| 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.
- Since
- 13.27.0
- 16.4.0
- Parameters
-
chan The channel object
- Return values
-
0 if the channel isn't answered (or you called this really fast) The number of milliseconds the channel has been up
Definition at line 2844 of file channel.c.
References ast_assert, ast_channel_answertime(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), and NULL.
Referenced by ast_channel_get_up_time(), and end_bridge_callback().
struct timeval ast_channel_answertime(struct ast_channel *chan)
Definition: channel_internal_api.c:986
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
int64_t ast_tvdiff_ms(struct timeval end, struct timeval start)
Computes the difference (in milliseconds) between two struct timeval instances.
Definition: time.h:98
◆ ast_channel_get_vars()
| struct varshead* ast_channel_get_vars | ( | struct ast_channel * | chan | ) |
Gets the variables for a given channel, as set using pbx_builtin_setvar_helper().
- Since
- 12 The returned variable list is an AO2 object, so ao2_cleanup() to free it.
- Parameters
-
chan Channel to get variables for
- Returns
- List of channel variables.
-
NULLon error
Definition at line 8013 of file channel.c.
References ao2_alloc, ao2_cleanup, ao2_ref, ast_channel_varshead(), AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_var_assign, ast_var_name(), ast_var_value(), ast_var_t::entries, NULL, RAII_VAR, var, and varshead_dtor().
struct varshead * ast_channel_varshead(struct ast_channel *chan)
Definition: channel_internal_api.c:932
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:911
#define AST_LIST_INSERT_TAIL(head, elm, field)
Appends a list entry to the tail of a list.
Definition: linkedlists.h:730
Definition: chanvars.h:28
Definition: chanvars.h:34
#define AST_LIST_TRAVERSE(head, var, field)
Loops over (traverses) the entries in a list.
Definition: linkedlists.h:490
struct ast_var_t::@249 entries
◆ ast_channel_hangup_handlers()
| struct ast_hangup_handler_list* ast_channel_hangup_handlers | ( | struct ast_channel * | chan | ) |
Definition at line 864 of file channel_internal_api.c.
References ast_channel::hangup_handlers.
Referenced by ast_pbx_hangup_handler_destroy(), ast_pbx_hangup_handler_init(), ast_pbx_hangup_handler_pop(), ast_pbx_hangup_handler_push(), ast_pbx_hangup_handler_run(), ast_pbx_hangup_handler_show(), and channel_do_masquerade().
struct ast_hangup_handler_list hangup_handlers
Definition: channel_internal_api.c:161
◆ ast_channel_hangupcause()
| int ast_channel_hangupcause | ( | const struct ast_channel * | chan | ) |
Definition at line 427 of file channel_internal_api.c.
Referenced by __transmit_response(), ast_cc_call_failed(), ast_channel_softhangup_withcause_locked(), ast_queue_hangup_with_cause(), ast_str_retrieve_variable(), ast_unreal_call_setup(), ast_unreal_hangup(), ast_var_channels_table(), bridge_channel_dissolve_check(), chan_pjsip_hangup(), chan_pjsip_session_end(), channel_set_cause(), channel_snapshot_hangup_create(), dahdi_hangup(), dahdi_indicate(), dial_bridge_after_cb(), dial_exec_full(), handle_request_bye(), handle_request_cancel(), iax2_hangup(), jingle_hangup(), misdn_hangup(), monitor_dial(), ooh323_hangup(), pbx_builtin_hangup(), retrans_pkt(), rfc3326_add_reason_header(), session_inv_on_tsx_state_changed(), setsubstate(), sip_hangup(), try_calling(), unistim_hangup(), use_reason_header(), and wait_for_answer().
◆ ast_channel_hangupcause_hash_set()
| 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.
- Parameters
-
chan channel on which to set the cause information cause_code ast_control_pvt_cause_code structure containing cause information datalen total length of the structure since it may vary
Definition at line 4391 of file channel.c.
References ast_channel_dialed_causes_add(), ast_channel_name(), ast_func_write(), ast_log, ast_control_pvt_cause_code::chan_name, ast_control_pvt_cause_code::code, ast_control_pvt_cause_code::emulate_sip_cause, and LOG_WARNING.
Referenced by __analog_handle_event(), __ast_request_and_dial(), chan_pjsip_incoming_response_update_cause(), handle_clear_alarms(), handle_incoming(), iax2_key_rotate(), indicate_data_internal(), jingle_action_session_terminate(), misdn_write(), and socket_process_helper().
4396 ast_log(LOG_WARNING, "Unable to store hangup cause for %s on %s\n", cause_code->chan_name, ast_channel_name(chan));
char chan_name[AST_CHANNEL_NAME]
Definition: include/asterisk/frame.h:414
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.
Definition: channel_internal_api.c:1292
unsigned int emulate_sip_cause
Definition: include/asterisk/frame.h:415
const char * ast_channel_name(const struct ast_channel *chan)
int ast_func_write(struct ast_channel *chan, const char *function, const char *value)
executes a write operation on a function
Definition: pbx_functions.c:692
◆ ast_channel_hangupcause_set()
| void ast_channel_hangupcause_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 431 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_HANGUP, ast_channel_snapshot_invalidate_segment(), and value.
Referenced by __ast_read(), __ast_request_and_dial(), __attempt_transmit(), agent_run(), ast_ari_channels_hangup(), ast_channel_softhangup_withcause_locked(), ast_do_pickup(), AST_TEST_DEFINE(), ast_unreal_call_setup(), ast_unreal_hangup(), call_pickup_incoming_request(), cb_events(), channel_set_cause(), check_rtp_timeout(), console_new(), dahdi_indicate(), dial_exec_full(), disa_exec(), eivr_comm(), handle_call_outgoing(), handle_clear_alarms(), handle_request_invite(), handle_response(), handle_response_invite(), hangup_channel(), hangupcalls(), hanguptree(), iax2_call(), indicate_busy(), indicate_congestion(), jingle_indicate(), mbl_queue_hangup(), misdn_call(), onCallCleared(), pbx_builtin_hangup(), pbx_start_incoming_request(), receive_dtmf_digits(), refer_incoming_invite_request(), retrans_pkt(), rfc3326_use_reason_header(), ring_entry(), rtp_check_timeout(), send_cause2ast(), session_inv_on_media_update(), set_hangup_source_and_cause(), sip_call(), sip_pickup_thread(), socket_process_helper(), use_reason_header(), wait_for_answer(), and wait_for_winner().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
◆ ast_channel_hangupsource()
| const char* ast_channel_hangupsource | ( | const struct ast_channel * | chan | ) |
Referenced by ast_set_hangupsource(), channel_snapshot_hangup_create(), and func_channel_read().
◆ ast_channel_has_ari_vars()
| int ast_channel_has_ari_vars | ( | void | ) |
Return whether or not any ARI variables have been set.
- Since
- 14.2.0
- Return values
-
0 if no ARI variables are expected 1 if ARI variables are expected
Definition at line 7962 of file channel.c.
References ari_vars, and channel_has_external_vars().
static int channel_has_external_vars(struct external_vars *channelvars)
Definition: channel.c:7946
◆ ast_channel_has_audio_frame_or_monitor()
| int ast_channel_has_audio_frame_or_monitor | ( | struct ast_channel * | chan | ) |
Check if the channel has active audiohooks, active framehooks, or a monitor.
- Since
- 12.0.0
- Parameters
-
chan The channel to check.
- Return values
-
non-zero if channel has active audiohooks, framehooks, or monitor.
Definition at line 2523 of file channel.c.
References ast_audiohook_write_list_empty(), ast_channel_audiohooks(), ast_channel_framehooks(), ast_channel_monitor(), and ast_framehook_list_contains_no_active().
Referenced by native_bridge_is_capable(), optimize_lock_chan_stack(), and optimize_lock_peer_stack().
int ast_audiohook_write_list_empty(struct ast_audiohook_list *audiohook_list)
Determine if a audiohook_list is empty or not.
Definition: audiohook.c:1112
struct ast_framehook_list * ast_channel_framehooks(const struct ast_channel *chan)
Definition: channel_internal_api.c:705
int ast_framehook_list_contains_no_active(struct ast_framehook_list *framehooks)
Determine if a framehook list is free of active framehooks or not.
Definition: framehook.c:282
struct ast_audiohook_list * ast_channel_audiohooks(const struct ast_channel *chan)
Definition: channel_internal_api.c:581
struct ast_channel_monitor * ast_channel_monitor(const struct ast_channel *chan)
Definition: channel_internal_api.c:613
◆ ast_channel_has_hook_requiring_audio()
| int ast_channel_has_hook_requiring_audio | ( | struct ast_channel * | chan | ) |
Check if the channel has any active hooks that require audio.
- Since
- 12.3.0
- Parameters
-
chan The channel to check.
- Return values
-
non-zero if channel has active audiohooks, audio framehooks, or monitor.
Definition at line 2530 of file channel.c.
References ast_audiohook_write_list_empty(), ast_channel_audiohooks(), ast_channel_framehooks(), ast_channel_monitor(), AST_FRAME_VOICE, and ast_framehook_list_contains_no_active_of_type().
Referenced by native_rtp_bridge_capable().
2534 || !ast_framehook_list_contains_no_active_of_type(ast_channel_framehooks(chan), AST_FRAME_VOICE);
int ast_audiohook_write_list_empty(struct ast_audiohook_list *audiohook_list)
Determine if a audiohook_list is empty or not.
Definition: audiohook.c:1112
struct ast_framehook_list * ast_channel_framehooks(const struct ast_channel *chan)
Definition: channel_internal_api.c:705
Definition: include/asterisk/frame.h:101
int ast_framehook_list_contains_no_active_of_type(struct ast_framehook_list *framehooks, enum ast_frame_type type)
Determine if a framehook list is free of active framehooks consuming a specific type of frame...
Definition: framehook.c:287
struct ast_audiohook_list * ast_channel_audiohooks(const struct ast_channel *chan)
Definition: channel_internal_api.c:581
struct ast_channel_monitor * ast_channel_monitor(const struct ast_channel *chan)
Definition: channel_internal_api.c:613
◆ ast_channel_has_manager_vars()
| int ast_channel_has_manager_vars | ( | void | ) |
Return whether or not any manager variables have been set.
- Since
- 12.4.0
- Return values
-
0 if no manager variables are expected 1 if manager variables are expected
Definition at line 7957 of file channel.c.
References ami_vars, and channel_has_external_vars().
Referenced by ast_channel_publish_varset().
static int channel_has_external_vars(struct external_vars *channelvars)
Definition: channel.c:7946
◆ ast_channel_hold_state()
| int ast_channel_hold_state | ( | const struct ast_channel * | chan | ) |
Definition at line 485 of file channel_internal_api.c.
Referenced by ast_parse_device_state(), bridge_channel_internal_join(), channel_do_masquerade(), func_channel_read(), and softmix_bridge_join().
◆ ast_channel_hold_state_set()
| void ast_channel_hold_state_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 489 of file channel_internal_api.c.
References value.
Referenced by __ast_channel_alloc_ap(), __ast_dummy_channel_alloc(), and indicate_data_internal().
◆ ast_channel_inherit_variables()
| void ast_channel_inherit_variables | ( | const struct ast_channel * | parent, |
| struct ast_channel * | child | ||
| ) |
Inherits channel variable from parent to child channel.
- Parameters
-
parent Parent channel child Child channel
Scans all channel variables in the parent channel, looking for those that should be copied into the child channel. Variables whose names begin with a single '_' are copied into the child channel with the prefix removed. Variables whose names begin with '__' are copied into the child channel with their names unchanged.
Definition at line 6866 of file channel.c.
References ast_channel_name(), ast_channel_publish_varset(), ast_channel_varshead(), ast_debug, AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_var_assign, ast_var_full_name(), ast_var_value(), and ast_var_t::entries.
Referenced by __ast_request_and_dial(), ast_ari_channels_dial(), begin_dial_prerun(), call_forward_inherit(), common_recall_channel_setup(), copy_caller_data(), dial_exec_full(), do_forward(), findmeexec(), park_local_transfer(), ring_entry(), and wait_for_answer().
struct varshead * ast_channel_varshead(struct ast_channel *chan)
Definition: channel_internal_api.c:932
#define AST_LIST_INSERT_TAIL(head, elm, field)
Appends a list entry to the tail of a list.
Definition: linkedlists.h:730
Definition: chanvars.h:28
void ast_channel_publish_varset(struct ast_channel *chan, const char *variable, const char *value)
Publish a ast_channel_varset for a channel.
Definition: stasis_channels.c:1150
const char * ast_var_full_name(const struct ast_var_t *var)
Definition: chanvars.c:75
#define AST_LIST_TRAVERSE(head, var, field)
Loops over (traverses) the entries in a list.
Definition: linkedlists.h:490
struct ast_var_t::@249 entries
const char * ast_channel_name(const struct ast_channel *chan)
◆ ast_channel_insmpl()
| unsigned long ast_channel_insmpl | ( | const struct ast_channel * | chan | ) |
Definition at line 533 of file channel_internal_api.c.
References ast_channel::insmpl.
Referenced by __ast_read(), and ast_write_stream().
◆ ast_channel_insmpl_set()
| void ast_channel_insmpl_set | ( | struct ast_channel * | chan, |
| unsigned long | value | ||
| ) |
Definition at line 537 of file channel_internal_api.c.
References ast_channel::insmpl, and value.
Referenced by __ast_read(), and ast_monitor_start().
◆ ast_channel_internal_alert_flush()
| ast_alert_status_t ast_channel_internal_alert_flush | ( | struct ast_channel * | chan | ) |
Definition at line 1115 of file channel_internal_api.c.
References ast_alertpipe_flush().
Referenced by chan_cleanup().
ast_alert_status_t ast_alertpipe_flush(int alert_pipe[2])
Consume all alerts written to the alert pipe.
Definition: alertpipe.c:134
◆ ast_channel_internal_alert_read()
| ast_alert_status_t ast_channel_internal_alert_read | ( | struct ast_channel * | chan | ) |
Definition at line 1120 of file channel_internal_api.c.
References ast_alertpipe_read().
Referenced by __ast_queue_frame(), and __ast_read().
ast_alert_status_t ast_alertpipe_read(int alert_pipe[2])
Read an event from an alert pipe.
Definition: alertpipe.c:102
◆ ast_channel_internal_alert_readable()
| int ast_channel_internal_alert_readable | ( | struct ast_channel * | chan | ) |
Definition at line 1130 of file channel_internal_api.c.
References ast_alertpipe_readable().
int ast_alertpipe_readable(int alert_pipe[2])
Determine if the alert pipe is readable.
Definition: alertpipe.h:112
◆ ast_channel_internal_alert_readfd()
| int ast_channel_internal_alert_readfd | ( | struct ast_channel * | chan | ) |
Definition at line 1150 of file channel_internal_api.c.
References ast_alertpipe_readfd().
Referenced by __ast_channel_alloc_ap().
int ast_alertpipe_readfd(int alert_pipe[2])
Get the alert pipe's read file descriptor.
Definition: alertpipe.h:143
◆ ast_channel_internal_alertpipe_clear()
| void ast_channel_internal_alertpipe_clear | ( | struct ast_channel * | chan | ) |
Definition at line 1135 of file channel_internal_api.c.
References ast_alertpipe_clear().
Referenced by __ast_channel_alloc_ap(), and __ast_dummy_channel_alloc().
void ast_alertpipe_clear(int alert_pipe[2])
Sets the alert pipe file descriptors to default values.
Definition: alertpipe.h:97
◆ ast_channel_internal_alertpipe_close()
| void ast_channel_internal_alertpipe_close | ( | struct ast_channel * | chan | ) |
Definition at line 1140 of file channel_internal_api.c.
References ast_alertpipe_close().
Referenced by ast_channel_destructor().
◆ ast_channel_internal_alertpipe_init()
| int ast_channel_internal_alertpipe_init | ( | struct ast_channel * | chan | ) |
Definition at line 1145 of file channel_internal_api.c.
References ast_alertpipe_init().
Referenced by __ast_channel_alloc_ap().
◆ ast_channel_internal_alertpipe_swap()
| void ast_channel_internal_alertpipe_swap | ( | struct ast_channel * | chan1, |
| struct ast_channel * | chan2 | ||
| ) |
Swap the interal alertpipe between two channels.
- Note
- Handle all of the necessary locking before calling this
Definition at line 1155 of file channel_internal_api.c.
References ast_alertpipe_swap().
Referenced by channel_do_masquerade().
void ast_alertpipe_swap(int alert_pipe_1[2], int alert_pipe_2[2])
Swap the file descriptors from two alert pipes.
Definition: alertpipe.h:158
◆ ast_channel_internal_bridge()
| struct ast_bridge* ast_channel_internal_bridge | ( | const struct ast_channel * | chan | ) |
Definition at line 1240 of file channel_internal_api.c.
Referenced by ast_channel_get_bridge(), ast_channel_is_bridged(), ast_unreal_fixup(), bridge_channel_internal_join(), and try_merge_optimize_out().
◆ ast_channel_internal_bridge_channel()
| struct ast_bridge_channel* ast_channel_internal_bridge_channel | ( | const struct ast_channel * | chan | ) |
Definition at line 1251 of file channel_internal_api.c.
Referenced by ast_bridge_depart(), ast_bridge_unreal_optimize_out(), ast_channel_get_bridge_channel(), bridge_channel_depart(), optimize_lock_chan_stack(), optimize_lock_peer_stack(), and stasis_app_exec().
◆ ast_channel_internal_bridge_channel_set()
| void ast_channel_internal_bridge_channel_set | ( | struct ast_channel * | chan, |
| struct ast_bridge_channel * | value | ||
| ) |
Definition at line 1255 of file channel_internal_api.c.
References value.
Referenced by ast_bridge_depart(), ast_bridge_join(), bridge_channel_ind_thread(), and bridge_impart_internal().
◆ ast_channel_internal_bridge_set()
| void ast_channel_internal_bridge_set | ( | struct ast_channel * | chan, |
| struct ast_bridge * | value | ||
| ) |
- Precondition
- chan is locked
Definition at line 1244 of file channel_internal_api.c.
References ast_channel_publish_snapshot(), AST_CHANNEL_SNAPSHOT_INVALIDATE_BRIDGE, ast_channel_snapshot_invalidate_segment(), and value.
Referenced by bridge_channel_change_bridge(), and bridge_channel_internal_join().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
void ast_channel_publish_snapshot(struct ast_channel *chan)
Publish a ast_channel_snapshot for a channel.
Definition: stasis_channels.c:1055
◆ ast_channel_internal_bridged_channel()
| struct ast_channel* ast_channel_internal_bridged_channel | ( | const struct ast_channel * | chan | ) |
◆ ast_channel_internal_bridged_channel_set()
| void ast_channel_internal_bridged_channel_set | ( | struct ast_channel * | chan, |
| struct ast_channel * | value | ||
| ) |
◆ ast_channel_internal_copy_linkedid()
| 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.
- Parameters
-
dest Destination to copy linkedid to source Source channel to copy linkedid from
- Returns
- void
Definition at line 1404 of file channel_internal_api.c.
References ast_channel_publish_snapshot(), AST_CHANNEL_SNAPSHOT_INVALIDATE_PEER, ast_channel_snapshot_invalidate_segment(), ast_channel_id::creation_time, ast_channel_id::creation_unique, ast_channel::linkedid, and ast_channel_id::unique_id.
Referenced by ast_bridge_channel_update_linkedids().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
void ast_channel_publish_snapshot(struct ast_channel *chan)
Publish a ast_channel_snapshot for a channel.
Definition: stasis_channels.c:1055
◆ ast_channel_internal_fd_clear()
| void ast_channel_internal_fd_clear | ( | struct ast_channel * | chan, |
| int | which | ||
| ) |
Definition at line 1174 of file channel_internal_api.c.
References AST_VECTOR_REPLACE, and AST_VECTOR_SIZE.
Referenced by handle_negotiated_sdp().
#define AST_VECTOR_REPLACE(vec, idx, elem)
Replace an element at a specific position in a vector, growing the vector if needed.
Definition: vector.h:284
◆ ast_channel_internal_fd_clear_all()
| void ast_channel_internal_fd_clear_all | ( | struct ast_channel * | chan | ) |
Definition at line 1182 of file channel_internal_api.c.
References AST_VECTOR_ELEM_CLEANUP_NOOP, and AST_VECTOR_RESET.
Referenced by __ast_channel_alloc_ap(), __ast_dummy_channel_alloc(), and channel_do_masquerade().
#define AST_VECTOR_ELEM_CLEANUP_NOOP(elem)
Vector element cleanup that does nothing.
Definition: vector.h:573
◆ ast_channel_internal_fd_set()
| void ast_channel_internal_fd_set | ( | struct ast_channel * | chan, |
| int | which, | ||
| int | value | ||
| ) |
Definition at line 1161 of file channel_internal_api.c.
References AST_VECTOR_REPLACE, and AST_VECTOR_SIZE.
Referenced by ast_channel_set_fd(), handle_negotiated_sdp(), my_on_hook(), start_rtp(), swap_subs(), and unistim_new().
#define AST_VECTOR_REPLACE(vec, idx, elem)
Replace an element at a specific position in a vector, growing the vector if needed.
Definition: vector.h:284
◆ ast_channel_internal_oldest_linkedid()
| struct ast_channel* ast_channel_internal_oldest_linkedid | ( | struct ast_channel * | a, |
| struct ast_channel * | b | ||
| ) |
Determine which channel has an older linkedid.
- Parameters
-
a First channel b Second channel
- Returns
- Returns an ast_channel structure that has oldest linkedid
Definition at line 1387 of file channel_internal_api.c.
References a, ast_assert, b, ast_channel_id::creation_time, ast_channel_id::creation_unique, and ast_channel::linkedid.
Referenced by ast_bridge_channel_update_linkedids().
◆ ast_channel_internal_set_fake_ids()
| 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)
- Parameters
-
chan The channel to set the uniqueid to uniqueid The uniqueid to set linkedid The linkedid to set
- Returns
- void
- Note
- This is used only by ast_cel_fabricate_channel_from_event() to create a temporary fake channel - time values are invalid
Definition at line 1465 of file channel_internal_api.c.
References ast_copy_string(), ast_channel::linkedid, ast_channel_id::unique_id, and ast_channel::uniqueid.
Referenced by ast_cel_fabricate_channel_from_event().
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401
◆ ast_channel_internal_swap_endpoint_forward()
| void ast_channel_internal_swap_endpoint_forward | ( | struct ast_channel * | a, |
| struct ast_channel * | b | ||
| ) |
Swap endpoint_forward between two channels.
- Parameters
-
a First channel b Second channel
- Returns
- void
- Note
- This is used in masquerade to exchange endpoint details if one of the two or both the channels were created with endpoint
Definition at line 1447 of file channel_internal_api.c.
Referenced by channel_do_masquerade().
◆ ast_channel_internal_swap_snapshots()
| void ast_channel_internal_swap_snapshots | ( | struct ast_channel * | a, |
| struct ast_channel * | b | ||
| ) |
Swap snapshots beteween two channels.
- Parameters
-
a First channel b Second channel
- Returns
- void
- Note
- This is used in masquerade to exchange snapshots
Definition at line 1456 of file channel_internal_api.c.
Referenced by channel_do_masquerade().
Structure representing a snapshot of channel state.
Definition: stasis_channels.h:145
◆ ast_channel_internal_swap_topics()
| void ast_channel_internal_swap_topics | ( | struct ast_channel * | a, |
| struct ast_channel * | b | ||
| ) |
Swap topics beteween two channels.
- Parameters
-
a First channel b Second channel
- Returns
- void
- Note
- This is used in masquerade to exchange topics for message routing
Definition at line 1433 of file channel_internal_api.c.
Referenced by channel_do_masquerade().
Definition: stasis.c:372
◆ ast_channel_internal_swap_uniqueid_and_linkedid()
| void ast_channel_internal_swap_uniqueid_and_linkedid | ( | struct ast_channel * | a, |
| struct ast_channel * | b | ||
| ) |
Swap uniqueid and linkedid beteween two channels.
- Parameters
-
a First channel b Second channel
- Returns
- void
- Note
- This is used in masquerade to exchange identities
Definition at line 1416 of file channel_internal_api.c.
References ast_channel::linkedid, and ast_channel::uniqueid.
Referenced by channel_do_masquerade().
◆ ast_channel_is_bridged()
| int ast_channel_is_bridged | ( | const struct ast_channel * | chan | ) |
Determine if a channel is in a bridge.
- Since
- 12.0.0
- Parameters
-
chan The channel to test
- Note
- This function expects the channel to be locked prior to being called and will not grab the channel lock.
- Return values
-
0 The channel is not bridged non-zero The channel is bridged
Definition at line 10746 of file channel.c.
References ast_channel_internal_bridge(), and NULL.
Referenced by __ast_read(), action_redirect(), app_control_dial(), ast_async_goto(), ast_audiohook_attach(), ast_audiohook_remove(), ast_framehook_attach(), ast_framehook_detach(), ast_framehook_list_fixup(), ast_var_channel_bridge(), audio_audiohook_write_list(), chan_pjsip_read_stream(), chan_pjsip_set_rtp_peer(), common_exec(), console_transfer(), dtmf_audiohook_write_list(), mixmonitor_autochan_is_bridged(), set_caps(), set_timeout(), sip_set_rtp_peer(), wait_for_bridged(), and wait_for_unbridged().
struct ast_bridge * ast_channel_internal_bridge(const struct ast_channel *chan)
Definition: channel_internal_api.c:1240
◆ ast_channel_is_leaving_bridge()
| int ast_channel_is_leaving_bridge | ( | struct ast_channel * | chan | ) |
Determine if a channel is leaving a bridge, but not hung up.
- Since
- 12.4.0
- Parameters
-
chan The channel to test
- Note
- If a channel is hung up, it is implicitly leaving any bridge it may be in. This function is used to test if a channel is leaving a bridge but may survive the experience, if it has a place to go to (dialplan or otherwise)
- Return values
-
0 The channel is not leaving the bridge or is hung up non-zero The channel is leaving the bridge
Definition at line 10751 of file channel.c.
References ast_channel_softhangup_internal_flag(), ast_channel_unbridged(), and AST_SOFTHANGUP_ASYNCGOTO.
Referenced by ast_indicate_data(), and bridge_channel_internal_pull().
Definition: channel.h:1127
int ast_channel_softhangup_internal_flag(struct ast_channel *chan)
Definition: channel_internal_api.c:997
int ast_channel_unbridged(struct ast_channel *chan)
This function will check if the bridge needs to be re-evaluated due to external changes.
Definition: channel_internal_api.c:1019
◆ ast_channel_is_multistream()
| int ast_channel_is_multistream | ( | struct ast_channel * | chan | ) |
Determine if a channel is multi-stream capable.
- Parameters
-
channel The channel to test
- Precondition
- chan is locked
- Returns
- Returns true if the channel is multi-stream capable.
Definition at line 1643 of file channel_internal_api.c.
References ast_channel_tech::read_stream, ast_channel::tech, and ast_channel_tech::write_stream.
Referenced by ast_channel_nativeformats_set(), ast_channel_request_stream_topology_change(), ast_channel_set_stream_topology(), ast_channel_stream_topology_changed(), ast_channel_stream_topology_changed_externally(), ast_unreal_indicate(), ast_unreal_new_channels(), bridge_channel_write_frame(), bridge_handle_trip(), and stream_echo_write().
struct ast_frame *(*const read_stream)(struct ast_channel *chan)
Read a frame (or chain of frames from the same stream), in standard format (see frame.h), with stream num.
Definition: channel.h:748
int(*const write_stream)(struct ast_channel *chan, int stream_num, struct ast_frame *frame)
Write a frame on a specific stream, in standard format (see frame.h)
Definition: channel.h:754
◆ ast_channel_is_t38_active()
| int ast_channel_is_t38_active | ( | struct ast_channel * | chan | ) |
This function will check if T.38 is active on the channel.
- Parameters
-
chan Channel on which to check the unbridge_eval flag
- Returns
- Returns 0 if the flag is down or 1 if the flag is up.
Definition at line 1046 of file channel_internal_api.c.
References ast_channel_is_t38_active_nolock(), ast_channel_lock, and ast_channel_unlock.
Referenced by bridge_channel_internal_join().
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...
Definition: channel_internal_api.c:1041
◆ ast_channel_is_t38_active_nolock()
| 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.
- Parameters
-
chan Channel on which to check the is_t38_active flag
- Returns
- Returns 0 if the flag is down or 1 if the flag is up.
Definition at line 1041 of file channel_internal_api.c.
Referenced by ast_channel_is_t38_active().
◆ ast_channel_iterator_all_new()
| struct ast_channel_iterator* ast_channel_iterator_all_new | ( | void | ) |
Create a new channel iterator.
After creating an iterator using this function, the ast_channel_iterator_next() function can be used to iterate through all channels that exist.
- Note
- You must call ast_channel_iterator_destroy() when done.
- Return values
-
NULL on failure a new channel iterator
- Since
- 1.8
Definition at line 1408 of file channel.c.
References ast_channel_iterator::active_iterator, ao2_iterator_init(), ast_calloc, NULL, and ast_channel_iterator::simple_iterator.
Referenced by action_hangup(), action_status(), ast_var_channel_bridge(), ast_var_channel_types_table(), ast_var_channels_table(), common_exec(), func_channels_read(), handle_show_hangup_all(), and handle_softhangup().
Definition: channel.c:1351
struct ao2_iterator * active_iterator
Definition: channel.c:1357
struct ao2_iterator ao2_iterator_init(struct ao2_container *c, int flags) attribute_warn_unused_result
Create an iterator for a container.
Definition: astobj2_container.c:485
◆ ast_channel_iterator_by_exten_new()
| struct ast_channel_iterator* ast_channel_iterator_by_exten_new | ( | const char * | exten, |
| const char * | context | ||
| ) |
Create a new channel iterator based on extension.
- Parameters
-
exten The extension that channels must be in context The context that channels must be in
After creating an iterator using this function, the ast_channel_iterator_next() function can be used to iterate through all channels that are currently in the specified context and extension.
- Note
- You must call ast_channel_iterator_destroy() when done.
- Return values
-
NULL on failure a new channel iterator based on the specified parameters
- Since
- 1.8
Definition at line 1368 of file channel.c.
References ast_channel_iterator::active_iterator, ast_calloc, ast_channel_by_exten_cb(), ast_channel_callback(), ast_free, NULL, and OBJ_MULTIPLE.
Referenced by common_exec(), and pickup_by_exten().
static int ast_channel_by_exten_cb(void *obj, void *arg, void *data, int flags)
Definition: channel.c:1306
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.
Definition: channel.c:1278
Definition: channel.c:1351
struct ao2_iterator * active_iterator
Definition: channel.c:1357
Definition: astobj2.h:1053
◆ ast_channel_iterator_by_name_new()
| 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.
- Parameters
-
name channel name or channel uniqueid to match name_len number of characters in the channel name to match on. This would be used to match based on name prefix. If matching on the full channel name is desired, then this parameter should be 0.
After creating an iterator using this function, the ast_channel_iterator_next() function can be used to iterate through all channels that exist that have the specified name or name prefix.
- Note
- You must call ast_channel_iterator_destroy() when done.
- Return values
-
NULL on failure a new channel iterator based on the specified parameters
- Since
- 1.8
Definition at line 1388 of file channel.c.
References ast_channel_iterator::active_iterator, ast_calloc, ast_channel_by_name_cb(), ast_channel_callback(), ast_free, NULL, OBJ_KEY, and OBJ_MULTIPLE.
Referenced by common_exec(), get_device_state_causing_channels(), and softhangup_exec().
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.
Definition: channel.c:1278
static int ast_channel_by_name_cb(void *obj, void *arg, void *data, int flags)
Definition: channel.c:1284
Definition: channel.c:1351
struct ao2_iterator * active_iterator
Definition: channel.c:1357
Definition: astobj2.h:1053
◆ ast_channel_iterator_destroy()
| struct ast_channel_iterator* ast_channel_iterator_destroy | ( | struct ast_channel_iterator * | i | ) |
Destroy a channel iterator.
- Parameters
-
i the itereator to destroy
This function is used to destroy a channel iterator that was retrieved by using one of the channel_iterator_xxx_new() functions.
- Returns
- NULL, for convenience to clear out the pointer to the iterator that was just destroyed.
- Since
- 1.8
Definition at line 1360 of file channel.c.
References ast_channel_iterator::active_iterator, ao2_iterator_destroy(), ast_free, and NULL.
Referenced by action_hangup(), action_status(), ast_var_channel_bridge(), ast_var_channel_types_table(), ast_var_channels_table(), common_exec(), func_channels_read(), get_device_state_causing_channels(), handle_show_hangup_all(), handle_softhangup(), pickup_by_exten(), and softhangup_exec().
void ao2_iterator_destroy(struct ao2_iterator *iter)
Destroy a container iterator.
Definition: astobj2_container.c:534
struct ao2_iterator * active_iterator
Definition: channel.c:1357
◆ ast_channel_iterator_next()
| struct ast_channel* ast_channel_iterator_next | ( | struct ast_channel_iterator * | i | ) |
Get the next channel for a channel iterator.
- Parameters
-
i the channel iterator that was created using one of the channel_iterator_xxx_new() functions.
This function should be used to iterate through all channels that match a specified set of parameters that were provided when the iterator was created.
- Return values
-
the next channel that matches the parameters used when the iterator was created. NULL,if no more channels match the iterator parameters.
- Since
- 1.8
Definition at line 1422 of file channel.c.
References ast_channel_iterator::active_iterator, and ao2_iterator_next.
Referenced by action_hangup(), action_status(), ast_var_channel_bridge(), ast_var_channel_types_table(), ast_var_channels_table(), func_channels_read(), get_device_state_causing_channels(), handle_show_hangup_all(), handle_softhangup(), next_channel(), pickup_by_exten(), and softhangup_exec().
struct ao2_iterator * active_iterator
Definition: channel.c:1357
◆ ast_channel_jb()
| struct ast_jb* ast_channel_jb | ( | struct ast_channel * | chan | ) |
Definition at line 884 of file channel_internal_api.c.
References ast_channel::jb.
Referenced by ast_jb_configure(), ast_jb_destroy(), ast_jb_do_usecheck(), ast_jb_empty_and_reset(), ast_jb_enable_for_channel(), ast_jb_get_and_deliver(), ast_jb_get_config(), ast_jb_get_when_to_wakeup(), ast_jb_put(), create_jb(), jb_choose_impl(), and jb_get_and_deliver().
◆ ast_channel_jb_set()
| void ast_channel_jb_set | ( | struct ast_channel * | chan, |
| struct ast_jb * | value | ||
| ) |
◆ ast_channel_language()
| const char* ast_channel_language | ( | const struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Referenced by __analog_ss_thread(), acf_vm_info(), action_playback_and_continue(), action_toggle_mute_participants(), analog_ss_thread(), announce_to_dial(), announce_user_count(), app_exec(), ast_app_getdata(), ast_app_getdata_full(), ast_ari_channels_dial(), ast_moh_files_next(), ast_play_and_wait(), ast_say_counted_adjective(), ast_say_counted_noun(), ast_say_date_with_format_gr(), ast_say_number_full_gr(), ast_send_image(), ast_stream_and_wait(), ast_unreal_call_setup(), ast_var_channels_table(), auth_exec(), background_detect_exec(), begin_dial_prerun(), channel_do_masquerade(), channel_snapshot_base_create(), common_exec(), conf_exec(), conf_get_pin(), conf_run(), confbridge_exec(), control_streamfile(), copy_message(), count_exec(), dial_exec_full(), dictate_exec(), do_directory(), eivr_comm(), find_conf_realtime(), findmeexec(), forward_message(), func_channel_read(), gen_nextfile(), get_folder(), get_folder2(), get_folder_ja(), handle_getoption(), handle_recordfile(), handle_sayalpha(), handle_saydate(), handle_saydatetime(), handle_saydigits(), handle_saynumber(), handle_sayphonetic(), handle_saytime(), handle_showchan(), handle_speechrecognize(), handle_streamfile(), iax2_call(), invent_message(), leave_voicemail(), limits_interval_playback(), meetme_menu_admin(), meetme_menu_admin_extended(), meetme_menu_normal(), mgcp_ss(), minivm_greet_exec(), page_exec(), pbx_builtin_background(), pbx_builtin_saycharacters(), pbx_builtin_saycharacters_case(), pbx_builtin_saydigits(), pbx_builtin_saymoney(), pbx_builtin_saynumber(), pbx_builtin_sayphonetic(), play_and_wait(), play_file(), play_mailbox_owner(), play_message(), play_message_callerid(), play_message_datetime(), play_message_duration(), play_record_review(), playback_common(), playback_exec(), privacy_exec(), readexten_exec(), record_exec(), retrydial_exec(), say_parking_space(), say_position(), sayfile_exec(), sayunixtime_exec(), select_item_menu(), serialize_showchan(), setup_env(), setup_privacy_args(), speech_background(), try_calling(), vm_authenticate(), vm_browse_messages(), vm_execmain(), vm_instructions(), vm_intro(), vm_intro_cs(), vm_intro_de(), vm_intro_en(), vm_intro_es(), vm_intro_fr(), vm_intro_gr(), vm_intro_he(), vm_intro_is(), vm_intro_it(), vm_intro_ja(), vm_intro_multilang(), vm_intro_nl(), vm_intro_no(), vm_intro_pl(), vm_intro_pt(), vm_intro_pt_BR(), vm_intro_se(), vm_intro_vi(), vm_intro_zh(), vm_play_folder_name(), vmsayname_exec(), and wait_for_winner().
◆ ast_channel_latest_musicclass()
| const char* ast_channel_latest_musicclass | ( | const struct ast_channel * | chan | ) |
Referenced by ast_bridge_channel_playfile(), channel_do_masquerade(), and limits_interval_playback().
◆ ast_channel_linkedid()
| const char* ast_channel_linkedid | ( | const struct ast_channel * | chan | ) |
Definition at line 311 of file channel_internal_api.c.
References ast_assert, ast_channel::linkedid, and ast_channel_id::unique_id.
Referenced by ast_channel_log(), AST_TEST_DEFINE(), channel_snapshot_peer_create(), func_channel_read(), func_mchan_read(), func_mchan_write(), handle_showchan(), and serialize_showchan().
◆ ast_channel_macrocontext()
| const char* ast_channel_macrocontext | ( | const struct ast_channel * | chan | ) |
Definition at line 362 of file channel_internal_api.c.
Referenced by _macro_exec(), ast_cc_call_init(), ast_channel_by_exten_cb(), ast_channel_log(), ast_var_channels_table(), cc_generic_agent_init(), cc_interfaces_datastore_init(), chan_pjsip_cng_tone_detected(), common_exec(), conf_run(), dahdi_handle_dtmf(), dial_exec_full(), fax_detect_framehook(), get_also_info(), get_cid_name(), get_refer_info(), get_transfer_context(), goto_exten(), launch_monitor_thread(), leave_voicemail(), minivm_greet_exec(), my_handle_dtmf(), onedigit_goto(), onModeChanged(), ooh323_rtp_read(), process_ast_dsp(), process_sdp(), and sip_read().
◆ ast_channel_macrocontext_set()
| void ast_channel_macrocontext_set | ( | struct ast_channel * | chan, |
| const char * | value | ||
| ) |
Definition at line 366 of file channel_internal_api.c.
References ast_copy_string().
Referenced by _macro_exec().
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401
◆ ast_channel_macroexten()
| const char* ast_channel_macroexten | ( | const struct ast_channel * | chan | ) |
Definition at line 370 of file channel_internal_api.c.
Referenced by _macro_exec(), ast_cc_call_init(), ast_channel_by_exten_cb(), ast_channel_log(), ast_var_channels_table(), cc_generic_agent_init(), cc_interfaces_datastore_init(), dial_exec_full(), do_forward(), dundi_exec(), dundi_helper(), get_cid_name(), ring_entry(), and wait_for_answer().
◆ ast_channel_macroexten_set()
| void ast_channel_macroexten_set | ( | struct ast_channel * | chan, |
| const char * | value | ||
| ) |
Definition at line 374 of file channel_internal_api.c.
References ast_copy_string().
Referenced by _macro_exec().
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:401
◆ ast_channel_macropriority()
| int ast_channel_macropriority | ( | const struct ast_channel * | chan | ) |
Definition at line 436 of file channel_internal_api.c.
Referenced by ast_channel_log(), and ast_var_channels_table().
◆ ast_channel_macropriority_set()
| void ast_channel_macropriority_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 440 of file channel_internal_api.c.
References value.
Referenced by _macro_exec().
◆ ast_channel_make_compatible()
| int ast_channel_make_compatible | ( | struct ast_channel * | chan, |
| struct ast_channel * | peer | ||
| ) |
Make the frame formats of two channels compatible.
- Parameters
-
chan First channel to make compatible. Should be the calling party. peer Other channel to make compatible. Should be the called party.
- Note
- Absolutely NO channel locks should be held before calling this function.
Set two channels to compatible frame formats in both directions. The path from peer to chan is made compatible first to allow for in-band audio in case the other direction cannot be made compatible.
- Return values
-
0 on success. -1 on error.
Definition at line 6817 of file channel.c.
References ast_channel_make_compatible_helper().
Referenced by app_exec(), dial_exec_full(), do_forward(), fax_detect_framehook(), fax_gateway_framehook(), native_bridge_join(), simple_bridge_join(), try_calling(), and wait_for_answer().
static int ast_channel_make_compatible_helper(struct ast_channel *from, struct ast_channel *to)
Set up translation from one channel to another.
Definition: channel.c:6738
◆ ast_channel_masq()
| struct ast_channel* ast_channel_masq | ( | const struct ast_channel * | chan | ) |
Definition at line 597 of file channel_internal_api.c.
References ast_channel::masq.
Referenced by ast_can_pickup(), ast_channel_log(), ast_hangup(), and ast_var_channels_table().
◆ ast_channel_masq_set()
| void ast_channel_masq_set | ( | struct ast_channel * | chan, |
| struct ast_channel * | value | ||
| ) |
Definition at line 601 of file channel_internal_api.c.
References ast_channel::masq, and value.
Referenced by ast_channel_move(), and channel_do_masquerade().
◆ ast_channel_masqr()
| struct ast_channel* ast_channel_masqr | ( | const struct ast_channel * | chan | ) |
Definition at line 605 of file channel_internal_api.c.
References ast_channel::masqr.
Referenced by ast_channel_log(), ast_hangup(), and ast_var_channels_table().
◆ ast_channel_masqr_set()
| void ast_channel_masqr_set | ( | struct ast_channel * | chan, |
| struct ast_channel * | value | ||
| ) |
Definition at line 609 of file channel_internal_api.c.
References ast_channel::masqr, and value.
Referenced by ast_channel_move(), and channel_do_masquerade().
◆ ast_channel_monitor()
| struct ast_channel_monitor* ast_channel_monitor | ( | const struct ast_channel * | chan | ) |
Definition at line 613 of file channel_internal_api.c.
References ast_channel::monitor.
Referenced by __ast_read(), ast_channel_destructor(), ast_channel_has_audio_frame_or_monitor(), ast_channel_has_hook_requiring_audio(), ast_monitor_change_fname(), ast_monitor_set_state(), ast_monitor_setjoinfiles(), ast_monitor_start(), ast_monitor_stop(), ast_write_stream(), channel_do_masquerade(), conf_run(), feature_automonitor(), and stop_automonitor().
◆ ast_channel_monitor_set()
| void ast_channel_monitor_set | ( | struct ast_channel * | chan, |
| struct ast_channel_monitor * | value | ||
| ) |
Definition at line 617 of file channel_internal_api.c.
References ast_channel::monitor, and value.
Referenced by ast_monitor_start(), ast_monitor_stop(), and channel_do_masquerade().
◆ ast_channel_move()
| int ast_channel_move | ( | struct ast_channel * | dest, |
| struct ast_channel * | source | ||
| ) |
Move a channel from its current location to a new location.
- Since
- 12 The intention of this function is to have the destination channel take on the identity of the source channel.
- Note
- This function is NOT intended to be used on bridged channels. If you wish to move an unbridged channel into the place of a bridged channel, then use ast_bridge_join() or ast_bridge_impart(). If you wish to move a bridged channel into the place of another bridged channel, then use ast_bridge_move().
- When this function returns succesfully, the source channel is in a state where its continued use is unreliable.
- absolutely NO channel locks should be held before calling this function.
- Parameters
-
dest The place to move the source channel source The channel to move
- Return values
-
0 Success non-zero Failure
Definition at line 10867 of file channel.c.
References ast_channel_flags(), ast_channel_lock_both, ast_channel_masq_set(), ast_channel_masqr_set(), ast_channel_masquerade_type(), ast_channel_name(), ast_channel_publish_blob(), ast_channel_uniqueid(), ast_channel_unlock, AST_FLAG_ZOMBIE, ast_json_pack(), ast_json_unref(), ast_log, ast_test_flag, channel_do_masquerade(), channel_move_lock, lock, LOG_WARNING, NULL, RAII_VAR, and SCOPED_MUTEX.
Referenced by after_bridge_move_channel(), ast_channel_yank(), ast_do_pickup(), handle_invite_replaces(), local_call(), and refer_incoming_invite_request().
struct ast_json * ast_json_pack(char const *format,...)
Helper for creating complex JSON values.
Definition: json.c:591
void ast_json_unref(struct ast_json *value)
Decrease refcount on value. If refcount reaches zero, value is freed.
Definition: json.c:73
void ast_channel_masq_set(struct ast_channel *chan, struct ast_channel *value)
Definition: channel_internal_api.c:601
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:911
void ast_channel_masqr_set(struct ast_channel *chan, struct ast_channel *value)
Definition: channel_internal_api.c:609
const char * ast_channel_uniqueid(const struct ast_channel *chan)
Definition: channel_internal_api.c:305
static void channel_do_masquerade(struct ast_channel *original, struct ast_channel *clonechan)
Masquerade a channel.
Definition: channel.c:6952
Definition: channel.h:988
const char * ast_channel_name(const struct ast_channel *chan)
Abstract JSON element (object, array, string, int, ...).
void ast_channel_publish_blob(struct ast_channel *chan, struct stasis_message_type *type, struct ast_json *blob)
Publish a channel blob message.
Definition: stasis_channels.c:1135
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
struct stasis_message_type * ast_channel_masquerade_type(void)
Message type for when a channel is being masqueraded.
◆ ast_channel_music_state()
| void* ast_channel_music_state | ( | const struct ast_channel * | chan | ) |
Definition at line 557 of file channel_internal_api.c.
References ast_channel::music_state.
Referenced by __ast_read(), ast_channel_destructor(), ast_moh_files_next(), local_ast_moh_cleanup(), local_ast_moh_start(), local_ast_moh_stop(), moh_alloc(), moh_files_alloc(), moh_files_generator(), moh_files_release(), moh_files_write_format_change(), and moh_release().
◆ ast_channel_music_state_set()
| void ast_channel_music_state_set | ( | struct ast_channel * | chan, |
| void * | value | ||
| ) |
Definition at line 561 of file channel_internal_api.c.
References ast_channel::music_state, and value.
Referenced by local_ast_moh_cleanup(), moh_alloc(), and moh_files_alloc().
◆ ast_channel_musicclass()
| const char* ast_channel_musicclass | ( | const struct ast_channel * | chan | ) |
◆ ast_channel_name()
| const char* ast_channel_name | ( | const struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Referenced by __adsi_transmit_messages(), __analog_handle_event(), __analog_ss_thread(), __ast_answer(), __ast_change_name_nolink(), __ast_channel_alloc_ap(), __ast_pbx_run(), __ast_play_and_record(), __ast_queue_frame(), __ast_read(), __attempt_transmit(), __dahdi_exception(), __print_debug_details(), __sip_autodestruct(), _analog_get_index(), _dahdi_get_index(), _macro_exec(), _skinny_show_lines(), acf_curl_helper(), acf_faxopt_read(), acf_faxopt_write(), acf_jabberreceive_read(), action_add_agi_cmd(), action_bridge(), action_confbridgesetsinglevideosrc(), action_dahdishowchannels(), action_hangup(), action_kick_last(), action_meetmelist(), add_agi_cmd(), adsi_prog(), agent_after_bridge_cb(), agent_after_bridge_cb_failed(), agent_function_read(), agent_handle_show_specific(), agent_request_exec(), agent_run(), agent_show_requested(), agents_sweep(), alarmreceiver_exec(), alloc_playback_chan(), alsa_indicate(), alsa_new(), analog_answer(), analog_attempt_transfer(), analog_call(), analog_exception(), analog_fixup(), analog_handle_dtmf(), analog_hangup(), analog_ss_thread(), announce_to_dial(), answer(), aoc_display_decoded_debug(), app_control_redirect(), app_exec(), append_channel_vars(), aqm_exec(), ari_bridges_play_new(), ari_originate_dial(), assign_uuid(), ast_agi_send(), ast_answer(), ast_app_exec_macro(), ast_async_goto(), ast_audiosocket_connect(), ast_autochan_new_channel(), ast_autochan_setup(), ast_autoservice_start(), ast_autoservice_stop(), ast_bridge_add_channel(), ast_bridge_call_with_flags(), ast_bridge_channel_feature_digit(), ast_bridge_channel_kick(), ast_bridge_channel_leave_bridge_nolock(), ast_bridge_channel_queue_frame(), ast_bridge_channel_restore_formats(), ast_bridge_depart(), ast_bridge_features_ds_set_string(), ast_bridge_impart(), ast_bridge_join(), ast_bridge_remove(), ast_bridge_set_single_src_video_mode(), ast_bridge_transfer_attended(), ast_bridge_transfer_blind(), ast_bridge_update_talker_src_video_mode(), ast_call_forward(), ast_cc_call_init(), ast_cc_offer(), ast_channel_add_bridge_role(), ast_channel_by_name_cb(), ast_channel_callid_set(), ast_channel_clear_bridge_roles(), ast_channel_destructor(), ast_channel_end_dtmf(), ast_channel_get_cc_agent_type(), ast_channel_get_device_name(), ast_channel_hangupcause_hash_set(), ast_channel_hash_cb(), ast_channel_inherit_variables(), ast_channel_log(), ast_channel_make_compatible_helper(), ast_channel_move(), ast_channel_nativeformats_set(), ast_channel_remove_bridge_role(), ast_channel_request_stream_topology_change(), ast_channel_set_stream_topology(), ast_channel_softhangup_withcause_locked(), ast_channel_start_silence_generator(), ast_channel_stop_silence_generator(), ast_channel_yank(), ast_check_hangup(), ast_cli_netstats(), ast_dial_append_channel(), ast_do_pickup(), ast_dsp_process(), ast_get_chan_applicationmap(), ast_hangup(), ast_iax2_new(), ast_jb_destroy(), ast_jb_put(), ast_moh_files_next(), ast_monitor_change_fname(), ast_monitor_start(), ast_pbx_h_exten_run(), ast_pbx_hangup_handler_show(), ast_pbx_outgoing_exten_predial(), ast_pickup_call(), ast_prod(), ast_raw_answer_with_stream_topology(), ast_readaudio_callback(), ast_rtp_instance_early_bridge(), ast_rtp_instance_early_bridge_make_compatible(), ast_senddigit_begin(), ast_senddigit_mf_begin(), ast_sendtext_data(), ast_set_read_format_path(), ast_set_write_format_path(), ast_setstate(), ast_sip_session_get_name(), ast_sip_session_is_pending_stream_default(), ast_sip_session_regenerate_answer(), ast_softhangup_nolock(), ast_stir_shaken_add_verification(), ast_str_retrieve_variable(), ast_streamfile(), AST_TEST_DEFINE(), ast_unreal_answer(), ast_unreal_fixup(), ast_unreal_hangup(), ast_var_channels_table(), ast_waitfor_nandfds(), ast_write_stream(), async_agi_read_frame(), attempt_transfer(), attended_transfer_bridge(), attended_transfer_properties_alloc(), audiosocket_exec(), audiosocket_run(), background_detect_exec(), begin_dial_channel(), begin_dial_prerun(), blind_transfer_bridge(), bridge_channel_complete_join(), bridge_channel_dtmf_stream(), bridge_channel_feature_digit_add(), bridge_channel_handle_interval(), bridge_channel_handle_write(), bridge_channel_internal_join(), bridge_channel_internal_pull(), bridge_channel_internal_push_full(), bridge_channel_internal_queue_attended_transfer(), bridge_channel_moving(), bridge_channel_park(), bridge_channel_settle_owed_events(), bridge_channel_talking(), bridge_channel_wait(), bridge_do_move(), bridge_exec(), bridge_features_duration_callback(), bridge_impart_internal(), bridge_move_locked(), bridge_parking_push(), bridge_stasis_push(), bridge_stasis_push_peek(), bridge_stasis_run_cb(), bridgeadd_exec(), bridgewait_exec(), bridgewait_timeout_callback(), builtin_features_helper(), calendar_event_read(), calendar_query_result_exec(), call(), cdr_prop_write(), cdr_prop_write_callback(), cdr_read(), cdr_read_callback(), cdr_retrieve_time(), cdr_write(), cdr_write_callback(), chan_pjsip_answer(), chan_pjsip_cng_tone_detected(), chan_pjsip_digit_end(), chan_pjsip_get_codec(), chan_pjsip_hangup(), chan_pjsip_incoming_response_update_cause(), chan_pjsip_indicate(), chan_pjsip_read_stream(), chan_pjsip_request_with_stream_topology(), chan_pjsip_sendtext_data(), chan_pjsip_session_end(), chan_pjsip_set_rtp_peer(), chan_pjsip_write_stream(), chanavail_exec(), change_priority_caller_on_queue(), change_t38_state(), channel_cmp(), channel_do_masquerade(), channel_fill_empty_accountcode(), channel_fill_empty_peeraccount(), channel_hash(), channel_read_pjsip(), channel_read_rtcp(), channel_read_rtp(), channel_set_debug(), channel_snapshot_base_create(), channel_spy(), channel_update_peeraccount(), check_rtp_timeout(), comeback_goto(), common_exec(), complete_bridge_participant(), complete_confbridge_participant(), conf_exec(), conf_play(), conf_queue_dtmf(), conf_run(), conf_send_event_to_participants(), conf_update_user_mute(), confbridge_exec(), confbridge_handle_atxfer(), console_indicate(), console_transfer(), control_streamfile(), cpeid_exec(), create_channel_name(), create_jb(), dahdi_call(), dahdi_digit_begin(), dahdi_digit_end(), dahdi_fake_event(), dahdi_fixup(), dahdi_handle_dtmf(), dahdi_handle_event(), dahdi_hangup(), dahdi_indicate(), dahdi_new(), dahdi_queryoption(), dahdi_read(), dahdi_setoption(), dahdi_show_channel(), dahdi_softhangup_all(), dahdi_write(), dahdiras_exec(), deactivate_silence_generator(), defer_action(), defer_incoming_sdp_stream(), destroy_all_channels(), dial_bridge_after_cb(), dial_bridge_after_cb_failed(), dial_exec_full(), dial_masquerade_breakdown(), dial_masquerade_fixup(), dial_transfer(), dial_trunk(), dialog_unlink_all(), disa_exec(), disable_t38(), display_parked_call(), do_forward(), do_monitor(), do_waiting(), does_id_conflict(), dtmf_mode_refresh_cb(), dtmfstore_exec(), dumpchan_exec(), dundi_lookup_internal(), dynamic_dtmf_hook_trip(), eagi_exec(), enable_jack_hook(), execute_menu_entry(), fast_originate(), fax_detect_framehook(), fax_gateway_detect_t38(), fax_gateway_detect_v21(), fax_gateway_framehook(), fax_gateway_new(), fax_gateway_request_t38(), fax_generator_generate(), fax_session_new(), feature_attended_transfer(), feature_automixmonitor(), feature_automonitor(), feature_blind_transfer(), find_by_name(), find_details(), find_or_create_details(), flash_exec(), forkcdr_exec(), func_channel_read(), func_channels_read(), func_get_parkingslot_channel(), func_read_header(), func_write_header(), generic_fax_exec(), generic_mute_unmute_helper(), generic_mute_unmute_user(), get_agi_cmd(), get_chan_by_ast_name(), gosub_exec(), gosub_run(), grab_transfer(), group_count_function_read(), group_show_channels(), handle_bridge_kick_channel(), handle_call_outgoing(), handle_clear_alarms(), handle_cli_agi_add_cmd(), handle_cli_confbridge_list_item(), handle_cli_iax2_show_channels(), handle_cli_locks_show(), handle_cli_misdn_show_channel(), handle_frame(), handle_gosub(), handle_incoming(), handle_incoming_request(), handle_invite_replaces(), handle_offhook_message(), handle_participant_join(), handle_recordfile(), handle_request_info(), handle_request_invite(), handle_request_refer(), handle_response(), handle_response_notify(), handle_showchan(), handle_softhangup(), handle_stimulus_message(), handle_streamfile(), hangup(), holding_bridge_join(), hook_callback(), hook_event_cb(), hook_off(), hook_on(), hook_re_enable(), hook_thread_arg_alloc(), iax2_call(), iax2_hangup(), iax2_request(), iax2_transfer(), incoming_in_dialog_request(), increase_call_count(), indicate_connected_line(), indicate_data_internal(), inherit_channel_vars_from_id(), init_jack_data(), is_our_turn(), isAnsweringMachine(), jack_hook_callback(), jingle_action_session_terminate(), jingle_queue_hangup_with_cause(), jingle_read(), join_queue(), kick_conference_participant(), launch_asyncagi(), launch_monitor_thread(), leave_queue(), leave_voicemail(), linear_alloc(), linear_release(), locals_show(), log_caps(), log_jitterstats(), lua_get_state(), lua_pbx_exec(), manager_park(), manager_queues_status(), map_source_to_destinations(), mbl_call(), meetme_menu_admin(), meetme_show_cmd(), meetmemute(), mgcp_answer(), mgcp_call(), mgcp_fixup(), mgcp_hangup(), mgcp_indicate(), mgcp_new(), mgcp_ss(), milliwatt_generate(), misdn_attempt_transfer(), misdn_call(), misdn_hangup(), misdn_indication(), misdn_write(), moh_alloc(), moh_files_generator(), moh_files_release(), moh_generate(), moh_post_start(), moh_post_stop(), moh_release(), my_handle_dtmf(), my_set_cadence(), native_bridge_changed(), native_bridge_compatible(), native_bridge_is_capable(), native_rtp_bridge_compatible_check(), native_rtp_bridge_framehook_attach(), native_rtp_bridge_framehook_detach(), native_rtp_bridge_join(), native_rtp_bridge_leave(), native_rtp_bridge_start(), native_rtp_bridge_stop(), native_rtp_bridge_suspend(), native_rtp_bridge_unsuspend(), native_start(), native_stop(), nbs_call(), nbs_hangup(), nbs_new(), nbs_xread(), next_channel(), nocdr_exec(), notify_channel(), old_milliwatt_exec(), on_personality_change_normal(), onModeChanged(), ooh323_answer(), ooh323_call(), ooh323_destroy(), ooh323_get_codec(), ooh323_get_rtp_peer(), ooh323_new(), ooh323_queryoption(), ooh323_rtp_read(), ooh323_set_rtp_peer(), ooh323_write(), oss_indicate(), oss_new(), page_exec(), park_local_transfer(), parking_park_bridge_channel(), parking_park_call(), participant_idle_mode_setup(), participant_reaction_announcer_join(), pbx_builtin_background(), pbx_builtin_setamaflags(), pbx_builtin_waitexten(), pbx_extension_helper(), pbx_outgoing_exec(), pbx_outgoing_state_callback(), pbx_start_incoming_request(), phone_answer(), phone_call(), phone_hangup(), phone_indicate(), phone_new(), pickup_by_exten(), pickup_by_group(), pjsip_acf_channel_read(), pjsip_acf_dtmf_mode_read(), pjsip_acf_dtmf_mode_write(), pjsip_acf_session_refresh_write(), play_moh_exec(), play_on_channel(), playback_exec(), playtones_alloc(), pre_bridge_setup(), print_bc_info(), print_escaped_uri(), print_queue(), prnt_channel_key(), process_ast_dsp(), process_sdp(), publish_app_cdr_message(), publish_transfer_fail(), publish_transfer_success(), publish_transfer_threeway(), queue_exec(), queue_function_queuegetchannel(), read_mf_digits(), read_pjsip(), read_sf_digits(), readexten_exec(), realtime_exec(), receive_dtmf_digits(), receivefax_exec(), receivefax_t38_init(), record_exec(), refer_attended_task(), refer_blind_callback(), refer_incoming_attended_request(), refer_incoming_blind_request(), refer_incoming_invite_request(), refer_incoming_refer_request(), refer_progress_alloc(), refer_progress_bridge(), refer_progress_framehook(), reload(), remove_detect(), remove_dtmf_store(), remove_hold_intercept(), remove_scrambler(), remove_talk_detect(), resetcdr_exec(), revert_fax_buffers(), ring_entry(), rqm_exec(), rtp_check_timeout(), run_agi(), run_ras(), say_number_full(), say_position(), send_digit_to_chan(), send_direct_media_request(), send_message(), send_start_msg_snapshots(), sendfax_exec(), sendfax_t38_init(), serialize_showchan(), session_inv_on_media_update(), session_inv_on_tsx_state_changed(), set_bridge_peer_vars_multiparty(), set_fax_t38_caps(), set_format(), set_hangup_source_and_cause(), set_hold_intercept(), set_transfer_variables_all(), setup_env(), setup_privacy_args(), setup_udptl_connection(), sfu_topologies_on_join(), sfu_topologies_on_leave(), sfu_topologies_on_source_change(), sip_answer(), sip_call(), sip_fixup(), sip_hangup(), sip_indicate(), sip_new(), sip_pickup(), sip_pvt_dtor(), sip_queryoption(), sip_queue_hangup_cause(), sip_read(), sip_rtp_read(), sip_senddigit_begin(), sip_senddigit_end(), sip_sendtext(), sip_set_rtp_peer(), sip_setoption(), sip_show_channel(), sip_transfer(), sipinfo_send(), skinny_answer(), skinny_call(), skinny_fixup(), skinny_get_rtp_peer(), skinny_indicate(), skinny_new(), smart_bridge_operation(), sms_exec(), sms_generate(), socket_process_helper(), softhangup_exec(), softmix_bridge_join(), softmix_bridge_stream_sources_update(), softmix_bridge_stream_topology_changed(), softmix_bridge_write_text(), softmix_bridge_write_voice(), softmix_mixing_loop(), start_automixmonitor(), start_automonitor(), start_moh_exec(), start_monitor_action(), start_monitor_exec(), start_spying(), stasis_app_exec(), stop_automixmonitor(), stop_automonitor(), stream_echo_perform(), stream_echo_write_error(), t38_attach_framehook(), t38_automatic_reject(), t38_change_state(), t38_framehook(), t38_initialize_session(), t38_interpret_parameters(), t38_reinvite_response_cb(), talk_detect_audiohook_cb(), testclient_exec(), testserver_exec(), tonepair_alloc(), transfer_exec(), transfer_redirect(), transmit(), transmit_audio(), transmit_invite(), transmit_t38(), try_calling(), try_merge_optimize_out(), try_swap_optimize_out(), unistim_answer(), unistim_call(), unistim_fixup(), unistim_hangup(), unistim_indicate(), unistim_new(), update_connectedline(), update_name(), update_qe_rule(), user_chan_cb(), wait_exec(), wait_for_answer(), wait_for_digits(), wait_for_winner(), waitstream_control(), waitstream_core(), and xfer_client_on_evsub_state().
◆ ast_channel_name_set()
| void ast_channel_name_set | ( | struct ast_channel * | chan, |
| const char * | name | ||
| ) |
Set the channel name.
Referenced by __ast_change_name_nolink(), __ast_channel_alloc_ap(), ast_cel_fabricate_channel_from_event(), and channel_do_masquerade().
◆ ast_channel_name_to_dial_string()
| void ast_channel_name_to_dial_string | ( | char * | channel_name | ) |
Removes the trailing identifiers from a channel name string.
- Since
- 12.0.0
- Parameters
-
channel_name string that you wish to turn into a dial string. This string will be edited in place.
Definition at line 6934 of file channel.c.
Referenced by parked_user_set_parker_dial_string(), and setup_park_common_datastore().
◆ ast_channel_named_callgroups()
| struct ast_namedgroups* ast_channel_named_callgroups | ( | const struct ast_channel * | chan | ) |
Definition at line 1090 of file channel_internal_api.c.
References ast_channel::named_callgroups.
Referenced by find_channel_by_group(), and func_channel_read().
struct ast_namedgroups * named_callgroups
Definition: channel_internal_api.c:154
◆ ast_channel_named_callgroups_set()
| void ast_channel_named_callgroups_set | ( | struct ast_channel * | chan, |
| struct ast_namedgroups * | value | ||
| ) |
Definition at line 1094 of file channel_internal_api.c.
References ast_ref_namedgroups(), ast_unref_namedgroups(), and ast_channel::named_callgroups.
Referenced by ast_channel_destructor(), chan_pjsip_new(), dahdi_new(), func_channel_write_real(), read_config(), sip_new(), and skinny_new().
struct ast_namedgroups * ast_ref_namedgroups(struct ast_namedgroups *groups)
Definition: channel.c:7838
struct ast_namedgroups * named_callgroups
Definition: channel_internal_api.c:154
struct ast_namedgroups * ast_unref_namedgroups(struct ast_namedgroups *groups)
Definition: channel.c:7832
◆ ast_channel_named_pickupgroups()
| struct ast_namedgroups* ast_channel_named_pickupgroups | ( | const struct ast_channel * | chan | ) |
Definition at line 1099 of file channel_internal_api.c.
References ast_channel::named_pickupgroups.
Referenced by find_channel_by_group(), and func_channel_read().
struct ast_namedgroups * named_pickupgroups
Definition: channel_internal_api.c:155
◆ ast_channel_named_pickupgroups_set()
| void ast_channel_named_pickupgroups_set | ( | struct ast_channel * | chan, |
| struct ast_namedgroups * | value | ||
| ) |
Definition at line 1103 of file channel_internal_api.c.
References ast_ref_namedgroups(), ast_unref_namedgroups(), and ast_channel::named_pickupgroups.
Referenced by ast_channel_destructor(), chan_pjsip_new(), dahdi_new(), func_channel_write_real(), read_config(), sip_new(), and skinny_new().
struct ast_namedgroups * named_pickupgroups
Definition: channel_internal_api.c:155
struct ast_namedgroups * ast_ref_namedgroups(struct ast_namedgroups *groups)
Definition: channel.c:7838
struct ast_namedgroups * ast_unref_namedgroups(struct ast_namedgroups *groups)
Definition: channel.c:7832
◆ ast_channel_nativeformats()
| struct ast_format_cap* ast_channel_nativeformats | ( | const struct ast_channel * | chan | ) |
Definition at line 637 of file channel_internal_api.c.
Referenced by ast_ari_channels_create(), ast_bridge_update_talker_src_video_mode(), ast_channel_make_compatible_helper(), ast_openvstream(), ast_sendtext_data(), ast_streamfile(), ast_write_stream(), attended_transfer_bridge(), begin_dial_prerun(), blind_transfer_bridge(), chan_pjsip_get_codec(), chan_pjsip_indicate(), chan_pjsip_read_stream(), chan_pjsip_write_stream(), chanavail_exec(), channel_do_masquerade(), create_addr(), dial_transfer(), findmeexec(), func_channel_read(), generate_status(), handle_showchan(), iax2_call(), iax2_key_rotate(), iax2_request(), jingle_read(), jingle_write(), mgcp_new(), mgcp_rtp_read(), mgcp_write(), mp3_exec(), ooh323_get_codec(), ooh323_rtp_read(), ooh323_set_write_format(), ooh323_write(), park_local_transfer(), process_sdp(), ring_entry(), serialize_showchan(), set_caps(), set_format(), show_channels_cb(), sip_get_codec(), sip_indicate(), sip_new(), sip_rtp_read(), sip_session_response_cb(), sip_show_channel(), sip_write(), skinny_new(), skinny_rtp_read(), skinny_write(), socket_process_helper(), speech_create(), start_rtp(), test_vm_api_create_mock_channel(), unistim_new(), unistim_rtp_read(), unistim_write(), and wait_for_answer().
◆ ast_channel_nativeformats_set()
| void ast_channel_nativeformats_set | ( | struct ast_channel * | chan, |
| struct ast_format_cap * | value | ||
| ) |
Definition at line 677 of file channel_internal_api.c.
References ao2_replace, ast_assert, ast_channel_internal_set_stream_topology(), ast_channel_is_multistream(), ast_channel_name(), ast_format_cap_get_names(), ast_str_tmp, ast_stream_topology_create_from_format_cap(), NULL, S_COR, S_OR, SCOPE_ENTER, and SCOPE_EXIT_RTN.
Referenced by __ast_channel_alloc_ap(), alsa_new(), ast_channel_destructor(), ast_iax2_new(), AST_TEST_DEFINE(), ast_unreal_new_channels(), audiosocket_request(), chan_pjsip_new(), chan_pjsip_read_stream(), channel_do_masquerade(), console_new(), dahdi_new(), do_notify(), iax2_request(), jingle_interpret_content(), jingle_new(), jingle_read(), make_channel(), mbl_new(), mgcp_new(), mgcp_rtp_read(), misdn_new(), multicast_rtp_request(), nbs_new(), ooh323_new(), ooh323_rtp_read(), ooh323_set_read_format(), ooh323_set_write_format(), oss_new(), phone_new(), process_sdp(), rec_request(), set_caps(), set_format(), set_test_formats(), sip_new(), sip_rtp_read(), skinny_new(), skinny_rtp_read(), socket_process_helper(), stasis_app_control_snoop(), unicast_rtp_request(), unistim_new(), and unistim_rtp_read().
struct ast_stream_topology * ast_stream_topology_create_from_format_cap(struct ast_format_cap *cap)
A helper function that, given a format capabilities structure, creates a topology and separates the m...
Definition: stream.c:848
int ast_channel_is_multistream(struct ast_channel *chan)
Determine if a channel is multi-stream capable.
Definition: channel_internal_api.c:1643
#define S_COR(a, b, c)
returns the equivalent of logic or for strings, with an additional boolean check: second one if not e...
Definition: strings.h:85
Definition: stream.c:123
const char * ast_format_cap_get_names(const struct ast_format_cap *cap, struct ast_str **buf)
Get the names of codecs of a set of formats.
Definition: format_cap.c:736
#define SCOPE_ENTER(level,...)
Non RAII_VAR Scope Trace macros The advantage of these macros is that the EXITs will have the actual ...
Definition: logger.h:780
#define S_OR(a, b)
returns the equivalent of logic or for strings: first one if not empty, otherwise second one...
Definition: strings.h:79
const char * ast_channel_name(const struct ast_channel *chan)
void ast_channel_internal_set_stream_topology(struct ast_channel *chan, struct ast_stream_topology *topology)
Definition: channel_internal_api.c:658
◆ ast_channel_oldest_linkedid()
| const char* ast_channel_oldest_linkedid | ( | const char * | a, |
| const char * | b | ||
| ) |
Return the oldest linkedid between two channels.
A channel linkedid is derived from the channel uniqueid which is formed like this: [systemname-]ctime.seq
The systemname, and the dash are optional, followed by the epoch time followed by an integer sequence. Note that this is not a decimal number, since 1.2 is less than 1.11 in uniqueid land.
To compare two uniqueids, we parse out the integer values of the time and the sequence numbers and compare them, with time trumping sequence.
- Parameters
-
a The linkedid value of the first channel to compare b The linkedid value of the second channel to compare
- Return values
-
NULL on failure The oldest linkedid value
- Since
- 12.0.0
◆ ast_channel_oldwriteformat()
| struct ast_format* ast_channel_oldwriteformat | ( | struct ast_channel * | chan | ) |
Definition at line 844 of file channel_internal_api.c.
Referenced by ast_stopstream().
◆ ast_channel_outsmpl()
| unsigned long ast_channel_outsmpl | ( | const struct ast_channel * | chan | ) |
Definition at line 541 of file channel_internal_api.c.
References ast_channel::outsmpl.
Referenced by __ast_read(), and ast_write_stream().
◆ ast_channel_outsmpl_set()
| void ast_channel_outsmpl_set | ( | struct ast_channel * | chan, |
| unsigned long | value | ||
| ) |
Definition at line 545 of file channel_internal_api.c.
References ast_channel::outsmpl, and value.
Referenced by ast_monitor_start(), and ast_write_stream().
◆ ast_channel_parkinglot()
| const char* ast_channel_parkinglot | ( | const struct ast_channel * | chan | ) |
◆ ast_channel_pbx()
| struct ast_pbx* ast_channel_pbx | ( | const struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 721 of file channel_internal_api.c.
References ast_channel::pbx.
Referenced by __analog_handle_event(), __ast_pbx_run(), action_dialplan_exec(), ast_app_dtget(), ast_app_getdata(), ast_async_goto(), ast_bridge_add_channel(), ast_can_pickup(), ast_channel_destructor(), bridge_impart_internal(), collect_digits(), control_swap_channel_in_bridge(), dahdi_handle_event(), depart_channel(), disa_exec(), handle_getoption(), handle_gosub(), ivr_dispatch(), pbx_builtin_waitexten(), read_exec(), read_newoption(), readexten_exec(), speech_background(), stasis_app_exec(), timeout_read(), and timeout_write().
◆ ast_channel_pbx_set()
| void ast_channel_pbx_set | ( | struct ast_channel * | chan, |
| struct ast_pbx * | value | ||
| ) |
Definition at line 725 of file channel_internal_api.c.
References ast_channel::pbx, and value.
Referenced by __ast_pbx_run(), action_dialplan_exec(), control_swap_channel_in_bridge(), handle_gosub(), and internal_bridge_after_cb().
◆ ast_channel_peeraccount()
| const char* ast_channel_peeraccount | ( | const struct ast_channel * | chan | ) |
◆ ast_channel_pickupgroup()
| ast_group_t ast_channel_pickupgroup | ( | const struct ast_channel * | chan | ) |
Definition at line 1082 of file channel_internal_api.c.
References ast_channel::pickupgroup.
Referenced by ast_var_channels_table(), find_channel_by_group(), func_channel_read(), generate_status(), handle_showchan(), and serialize_showchan().
◆ ast_channel_pickupgroup_set()
| void ast_channel_pickupgroup_set | ( | struct ast_channel * | chan, |
| ast_group_t | value | ||
| ) |
- Precondition
- chan is locked
Definition at line 1086 of file channel_internal_api.c.
References ast_channel::pickupgroup, and value.
Referenced by chan_pjsip_new(), dahdi_new(), func_channel_write_real(), jingle_new(), mgcp_new(), read_config(), sip_new(), skinny_new(), and unistim_new().
◆ ast_channel_priority()
| int ast_channel_priority | ( | const struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 444 of file channel_internal_api.c.
Referenced by __ast_pbx_run(), _if_exec(), _macro_exec(), _while_exec(), action_bridge(), action_dialplan_exec(), ast_app_exec_macro(), ast_bridge_setup_after_goto(), ast_channel_log(), ast_channel_yank(), ast_pbx_h_exten_run(), ast_str_retrieve_variable(), ast_var_channels_table(), bridge_exec(), channel_snapshot_dialplan_create(), dial_exec_full(), eval_exten_read(), feature_blind_transfer(), find_matching_endif(), find_matching_endwhile(), forward_message(), func_channel_write_real(), gosub_exec(), gosub_run(), handle_gosub(), handle_showchan(), launch_monitor_thread(), leave_voicemail(), log_exec(), lua_pbx_exec(), make_email_file(), pbx_builtin_goto(), pbx_builtin_setvar_multiple(), pbx_builtin_waitexten(), pbx_parseable_goto(), raise_exception(), realtime_exec(), serialize_showchan(), setup_env(), and setup_peer_after_bridge_goto().
◆ ast_channel_priority_set()
| void ast_channel_priority_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 448 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_DIALPLAN, ast_channel_snapshot_invalidate_segment(), and value.
Referenced by __ast_channel_alloc_ap(), __ast_pbx_run(), __ast_request_and_dial(), _if_exec(), _macro_exec(), _while_exec(), action_dialplan_exec(), ari_originate_dial(), ast_bridge_setup_after_goto(), ast_channel_yank(), ast_explicit_goto(), ast_pbx_h_exten_run(), AST_TEST_DEFINE(), chan_pjsip_new(), dial_exec_full(), dialout(), do_notify(), eval_exten_read(), forward_message(), generic_recall(), gosub_exec(), gosub_run(), handle_gosub(), jingle_new(), leave_voicemail(), mgcp_new(), minivm_greet_exec(), misdn_new(), ooh323_new(), pbx_builtin_background(), pbx_extension_helper(), pbx_outgoing_exec(), return_exec(), set_ext_pri(), sip_new(), skinny_new(), unistim_new(), and wait_for_digits().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
◆ ast_channel_queryoption()
| int ast_channel_queryoption | ( | struct ast_channel * | channel, |
| int | option, | ||
| void * | data, | ||
| int * | datalen, | ||
| int | block | ||
| ) |
Checks the value of an option.
Query the value of an option Works similarly to setoption except only reads the options.
Definition at line 7542 of file channel.c.
References ast_channel_lock, ast_channel_tech(), ast_channel_unlock, ast_log, errno, LOG_ERROR, and ast_channel_tech::queryoption.
Referenced by ast_channel_get_cc_agent_type(), ast_channel_get_device_name(), ast_channel_get_t38_state(), ast_unreal_queryoption(), rcvfax_exec(), and sndfax_exec().
int errno
int(*const queryoption)(struct ast_channel *chan, int option, void *data, int *datalen)
Query a given option. Called with chan locked.
Definition: channel.h:781
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_channel_queue_connected_line_update()
| 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.
- Since
- 1.8
- Parameters
-
chan Asterisk channel to indicate connected line information connected Connected line information update What connected line information to update. NULL if all.
- Returns
- Nothing
Definition at line 9202 of file channel.c.
References ast_connected_line_build_data(), AST_CONTROL_CONNECTED_LINE, and ast_queue_control_data().
Referenced by after_bridge_move_channel(), ast_do_pickup(), handle_request_invite(), handle_request_update(), handle_response_invite(), misdn_queue_connected_line_update(), onAlerting(), onCallEstablished(), onProgress(), queue_connected_line_update(), sip_call(), and update_initial_connected_line().
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.
Definition: channel.c:8793
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.
Definition: channel.c:1238
◆ ast_channel_queue_redirecting_update()
| 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.
- Since
- 1.8
- Parameters
-
chan Asterisk channel to indicate redirecting id information redirecting Redirecting id information update What redirecting information to update. NULL if all.
- Returns
- Nothing
Definition at line 10392 of file channel.c.
References AST_CONTROL_REDIRECTING, ast_queue_control_data(), ast_redirecting_build_data(), and AST_THREADSTORAGE_RAW().
Referenced by cb_events(), handle_response_invite(), misdn_facility_ie_handler(), and set_redirecting().
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.
Definition: channel.c:9363
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.
Definition: channel.c:1238
◆ ast_channel_rawreadformat()
| struct ast_format* ast_channel_rawreadformat | ( | struct ast_channel * | chan | ) |
Definition at line 848 of file channel_internal_api.c.
Referenced by __ast_read(), ast_set_read_format_path(), chan_pjsip_write_stream(), channel_do_masquerade(), cli_channelstats_print_body(), dahdi_read(), gather_softmix_stats(), native_rtp_bridge_compatible_check(), phone_setup(), serialize_showchan(), set_softmix_bridge_data(), set_talk_detect(), and snoop_determine_format().
◆ ast_channel_rawwriteformat()
| struct ast_format* ast_channel_rawwriteformat | ( | struct ast_channel * | chan | ) |
Definition at line 852 of file channel_internal_api.c.
Referenced by ast_prod(), ast_set_write_format_path(), ast_write_stream(), chan_pjsip_read_stream(), chan_pjsip_write_stream(), channel_do_masquerade(), conf_run(), native_rtp_bridge_compatible_check(), serialize_showchan(), snoop_determine_format(), and softmix_mixing_loop().
◆ ast_channel_readformat()
| struct ast_format* ast_channel_readformat | ( | struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 856 of file channel_internal_api.c.
Referenced by __ast_read(), adsi_transmit_message_full(), agent_login_exec(), alarmreceiver_exec(), ast_bridge_channel_restore_formats(), ast_channel_yank(), ast_set_read_format_path(), audiosocket_exec(), background_detect_exec(), bridge_channel_internal_join(), chan_pjsip_read_stream(), chan_pjsip_write_stream(), channel_do_masquerade(), dictate_exec(), do_waiting(), eagi_exec(), fax_detect_framehook(), fax_gateway_framehook(), func_channel_read(), generate_status(), generic_fax_exec(), handle_recordfile(), handle_showchan(), ices_exec(), init_jack_data(), isAnsweringMachine(), jingle_read(), jingle_write(), measurenoise(), mgcp_rtp_read(), mgcp_write(), ooh323_rtp_read(), ooh323_set_read_format(), ooh323_set_write_format(), ooh323_write(), process_sdp(), record_exec(), send_start_rtp(), serialize_showchan(), set_caps(), set_read_to_slin(), sip_rtp_read(), sip_write(), skinny_rtp_read(), skinny_write(), socket_process_helper(), speech_background(), start_rtp(), transmit_audio(), unistim_rtp_read(), and unistim_write().
◆ ast_channel_readq()
| struct ast_readq_list* ast_channel_readq | ( | struct ast_channel * | chan | ) |
Definition at line 876 of file channel_internal_api.c.
References ast_channel::readq.
Referenced by __ast_queue_frame(), __ast_read(), ast_channel_clear_softhangup(), ast_channel_destructor(), chan_cleanup(), channel_do_masquerade(), load_stream_readqueue(), optimize_lock_chan_stack(), optimize_lock_peer_stack(), and wait_for_empty_queue().
◆ ast_channel_readtrans()
| struct ast_trans_pvt* ast_channel_readtrans | ( | const struct ast_channel * | chan | ) |
Definition at line 753 of file channel_internal_api.c.
References ast_channel::readtrans.
Referenced by __ast_read(), ast_channel_destructor(), ast_set_read_format_path(), chan_pjsip_write_stream(), fax_gateway_framehook(), free_translation(), generate_status(), handle_showchan(), and serialize_showchan().
◆ ast_channel_readtrans_set()
| void ast_channel_readtrans_set | ( | struct ast_channel * | chan, |
| struct ast_trans_pvt * | value | ||
| ) |
Definition at line 757 of file channel_internal_api.c.
References ast_channel::readtrans, and value.
Referenced by ast_set_read_format_path(), and free_translation().
◆ ast_channel_reason2str()
| const char* ast_channel_reason2str | ( | int | reason | ) |
return an english explanation of the code returned thru __ast_request_and_dial's 'outstate' argument
- Parameters
-
reason The integer argument, usually taken from AST_CONTROL_ macros
- Returns
- char pointer explaining the code
Definition at line 5913 of file channel.c.
References AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_HANGUP, AST_CONTROL_RING, and AST_CONTROL_RINGING.
Referenced by attempt_thread().
5915 switch (reason) /* the following appear to be the only ones actually returned by request_and_dial */
Definition: include/asterisk/frame.h:281
Definition: include/asterisk/frame.h:279
Definition: include/asterisk/frame.h:282
Definition: include/asterisk/frame.h:278
Definition: include/asterisk/frame.h:280
◆ ast_channel_redirecting()
| struct ast_party_redirecting* ast_channel_redirecting | ( | struct ast_channel * | chan | ) |
Definition at line 908 of file channel_internal_api.c.
References ast_channel::redirecting.
Referenced by __ast_channel_alloc_ap(), add_diversion(), ast_ari_channels_dial(), ast_call_forward(), ast_cel_fabricate_channel_from_event(), ast_channel_destructor(), ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), ast_channel_set_redirecting(), ast_dummy_channel_destructor(), ast_iax2_new(), ast_unreal_call_setup(), ast_var_channels_table(), begin_dial_prerun(), call_forward_inherit(), callerid_read(), callerid_write(), cb_events(), channel_do_masquerade(), channel_snapshot_caller_create(), dahdi_new(), dial_exec_full(), do_forward(), get_redirecting_add_diversion(), handle_response_invite(), iax2_call(), indicate_redirecting(), isAnsweringMachine(), leave_voicemail(), misdn_copy_redirecting_from_ast(), misdn_copy_redirecting_to_ast(), misdn_facility_ie_handler(), oss_call(), redirecting_read(), redirecting_write(), ring_entry(), serialize_showchan(), setup_env(), sip_new(), unreal_colp_redirect_indicate(), and wait_for_answer().
struct ast_party_redirecting redirecting
Redirecting/Diversion information.
Definition: channel_internal_api.c:148
◆ ast_channel_redirecting_effective_from()
| struct ast_party_id ast_channel_redirecting_effective_from | ( | struct ast_channel * | chan | ) |
Definition at line 916 of file channel_internal_api.c.
References ast_party_id_merge().
Referenced by add_diversion(), and misdn_copy_redirecting_from_ast().
struct ast_party_id from
Who is redirecting the call (Sent to the party the call is redirected toward)
Definition: channel.h:528
struct ast_party_id priv_from
Who is redirecting the call (Sent to the party the call is redirected toward) - private representatio...
Definition: channel.h:537
struct ast_party_redirecting redirecting
Redirecting/Diversion information.
Definition: channel_internal_api.c:148
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.
Definition: channel.c:1902
◆ ast_channel_redirecting_effective_orig()
| struct ast_party_id ast_channel_redirecting_effective_orig | ( | struct ast_channel * | chan | ) |
Definition at line 912 of file channel_internal_api.c.
References ast_party_id_merge().
struct ast_party_id priv_orig
Who originally redirected the call (Sent to the party the call is redirected toward) - private repres...
Definition: channel.h:534
struct ast_party_redirecting redirecting
Redirecting/Diversion information.
Definition: channel_internal_api.c:148
struct ast_party_id orig
Who originally redirected the call (Sent to the party the call is redirected toward) ...
Definition: channel.h:525
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.
Definition: channel.c:1902
◆ ast_channel_redirecting_effective_to()
| struct ast_party_id ast_channel_redirecting_effective_to | ( | struct ast_channel * | chan | ) |
Definition at line 920 of file channel_internal_api.c.
References ast_party_id_merge().
Referenced by misdn_copy_redirecting_from_ast().
struct ast_party_id priv_to
Call is redirecting to a new party (Sent to the caller) - private representation. ...
Definition: channel.h:540
struct ast_party_redirecting redirecting
Redirecting/Diversion information.
Definition: channel_internal_api.c:148
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.
Definition: channel.c:1902
struct ast_party_id to
Call is redirecting to a new party (Sent to the caller)
Definition: channel.h:531
◆ ast_channel_redirecting_macro()
| 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.
- Since
- 1.8
- Deprecated:
- You should use the ast_channel_redirecting_sub() function instead.
Whenever we want to update a channel's redirecting information, we may need to run a macro so that an administrator can manipulate the information before sending it out. This function both runs the macro and sends the update to the channel.
- Parameters
-
autoservice_chan Channel to place into autoservice while the macro is running. It is perfectly safe for this to be NULL macro_chan The channel to run the macro on. Also the channel from which we determine which macro we need to run. redirecting_info Either an ast_party_redirecting or ast_frame pointer of type AST_CONTROL_REDIRECTING is_caller If true, then run REDIRECTING_CALLER_SEND_MACRO with arguments from REDIRECTING_CALLER_SEND_MACRO_ARGS, otherwise run REDIRECTING_CALLEE_SEND_MACRO with arguments from REDIRECTING_CALLEE_SEND_MACRO_ARGS is_frame If true, then redirecting_info is an ast_frame pointer, otherwise it is an ast_party_redirecting pointer.
- Return values
-
0 Success -1 Either the macro does not exist, or there was an error while attempting to run the macro
- Todo:
Have multiple return codes based on the MACRO_RESULT
Make constants so that caller and frame can be more expressive than just '1' and '0'
Definition at line 10487 of file channel.c.
References ast_app_run_macro(), ast_channel_lock, ast_channel_redirecting(), ast_channel_unlock, ast_channel_update_redirecting(), ast_log, ast_party_redirecting_copy(), ast_party_redirecting_free(), ast_party_redirecting_init(), ast_redirecting_parse_data(), ast_strdupa, ast_strlen_zero, channel_set_intercept_mode(), ast_frame::data, ast_frame::datalen, LOG_WARNING, NULL, pbx_builtin_getvar_helper(), ast_frame::ptr, retval, and S_OR.
Referenced by bridge_channel_handle_control(), call_forward_inherit(), do_forward(), handle_frame(), and wait_for_answer().
10509 ast_log(LOG_WARNING, "Usage of REDIRECTING_CALLE[ER]_SEND_MACRO is deprecated. Please use REDIRECTING_SEND_SUB instead.\n");
10514 ast_redirecting_parse_data(frame->data.ptr, frame->datalen, ast_channel_redirecting(macro_chan));
int ast_app_run_macro(struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const char *macro_name, const char *macro_args)
Run a macro on a channel, placing an optional second channel into autoservice.
Definition: main/app.c:320
static void channel_set_intercept_mode(int in_intercept_mode)
Definition: channel.c:10419
const char * pbx_builtin_getvar_helper(struct ast_channel *chan, const char *name)
Return a pointer to the value of the corresponding channel variable.
Definition: pbx_variables.c:1000
int ast_redirecting_parse_data(const unsigned char *data, size_t datalen, struct ast_party_redirecting *redirecting)
Parse redirecting indication frame data.
Definition: channel.c:9574
void ast_party_redirecting_free(struct ast_party_redirecting *doomed)
Destroy the redirecting information contents.
Definition: channel.c:2179
void ast_party_redirecting_init(struct ast_party_redirecting *init)
Initialize the given redirecting structure.
Definition: channel.c:2122
Redirecting Line information. RDNIS (Redirecting Directory Number Information Service) Where a call d...
Definition: channel.h:523
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.
Definition: channel.c:2135
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.
Definition: channel.c:10379
struct ast_party_redirecting * ast_channel_redirecting(struct ast_channel *chan)
Definition: channel_internal_api.c:908
#define S_OR(a, b)
returns the equivalent of logic or for strings: first one if not empty, otherwise second one...
Definition: strings.h:79
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
union ast_frame::@263 data
◆ ast_channel_redirecting_set()
| void ast_channel_redirecting_set | ( | struct ast_channel * | chan, |
| struct ast_party_redirecting * | value | ||
| ) |
Definition at line 959 of file channel_internal_api.c.
References AST_CHANNEL_SNAPSHOT_INVALIDATE_CALLER, ast_channel_snapshot_invalidate_segment(), ast_channel::redirecting, and value.
Referenced by channel_do_masquerade().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
struct ast_party_redirecting redirecting
Redirecting/Diversion information.
Definition: channel_internal_api.c:148
◆ ast_channel_redirecting_sub()
| 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.
- Since
- 11
Whenever we want to update a channel's redirecting information, we may need to run a subroutine so that an administrator can manipulate the information before sending it out. This function both runs the subroutine specified by REDIRECTING_SEND_SUB and sends the update to the channel.
- Parameters
-
autoservice_chan Channel to place into autoservice while the subroutine is running. It is perfectly safe for this to be NULL sub_chan The channel to run the subroutine on. Also the channel from which we determine which subroutine we need to run. redirecting_info Either an ast_party_redirecting or ast_frame pointer of type AST_CONTROL_REDIRECTING is_frame If true, then redirecting_info is an ast_frame pointer, otherwise it is an ast_party_redirecting pointer.
- Return values
-
0 Success -1 Either the subroutine does not exist, or there was an error while attempting to run the subroutine
Definition at line 10584 of file channel.c.
References ast_app_run_sub(), ast_channel_lock, ast_channel_redirecting(), ast_channel_unlock, ast_channel_update_redirecting(), ast_party_redirecting_copy(), ast_party_redirecting_free(), ast_party_redirecting_init(), ast_redirecting_parse_data(), ast_strdupa, ast_strlen_zero, channel_set_intercept_mode(), ast_frame::data, ast_frame::datalen, NULL, pbx_builtin_getvar_helper(), ast_frame::ptr, retval, S_OR, and sub.
Referenced by bridge_channel_handle_control(), call_forward_inherit(), do_forward(), handle_frame(), and wait_for_answer().
10604 ast_redirecting_parse_data(frame->data.ptr, frame->datalen, ast_channel_redirecting(sub_chan));
static void channel_set_intercept_mode(int in_intercept_mode)
Definition: channel.c:10419
const char * pbx_builtin_getvar_helper(struct ast_channel *chan, const char *name)
Return a pointer to the value of the corresponding channel variable.
Definition: pbx_variables.c:1000
int ast_redirecting_parse_data(const unsigned char *data, size_t datalen, struct ast_party_redirecting *redirecting)
Parse redirecting indication frame data.
Definition: channel.c:9574
void ast_party_redirecting_free(struct ast_party_redirecting *doomed)
Destroy the redirecting information contents.
Definition: channel.c:2179
void ast_party_redirecting_init(struct ast_party_redirecting *init)
Initialize the given redirecting structure.
Definition: channel.c:2122
Redirecting Line information. RDNIS (Redirecting Directory Number Information Service) Where a call d...
Definition: channel.h:523
int ast_app_run_sub(struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const char *sub_location, const char *sub_args, int ignore_hangup)
Run a subroutine on a channel, placing an optional second channel into autoservice.
Definition: main/app.c:401
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.
Definition: channel.c:2135
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.
Definition: channel.c:10379
struct ast_party_redirecting * ast_channel_redirecting(struct ast_channel *chan)
Definition: channel_internal_api.c:908
#define S_OR(a, b)
returns the equivalent of logic or for strings: first one if not empty, otherwise second one...
Definition: strings.h:79
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
union ast_frame::@263 data
◆ ast_channel_register()
| int ast_channel_register | ( | const struct ast_channel_tech * | tech | ) |
Register a channel technology (a new channel driver) Called by a channel module to register the kind of channels it supports.
- Parameters
-
tech Structure defining channel technology or "type"
- Returns
- Returns 0 on success, -1 on failure.
Register a channel technology (a new channel driver) Called by a channel module to register the kind of channels it supports.
Definition at line 539 of file channel.c.
References ast_calloc, ast_debug, ast_log, AST_RWLIST_INSERT_HEAD, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verb, chanlist::chan, chanlist::list, LOG_WARNING, chanlist::tech, and ast_channel_tech::type.
Referenced by ast_channels_init(), ast_local_init(), AST_TEST_DEFINE(), load_module(), register_channel_tech(), and unload_module().
struct chanlist::@369 list
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
◆ ast_channel_release()
| struct ast_channel* ast_channel_release | ( | struct ast_channel * | chan | ) |
Unlink and release reference to a channel.
This function will unlink the channel from the global channels container if it is still there and also release the current reference to the channel.
- Returns
- NULL, convenient for clearing invalid pointers
- Note
- Absolutely NO channel locks should be held before calling this function.
- Since
- 1.8
Definition at line 1584 of file channel.c.
References ao2_unlink, and ast_channel_unref.
Referenced by ast_iax2_new(), AST_TEST_DEFINE(), ast_unreal_new_channels(), create_alice_channel(), destroy_msg_q_chan(), do_notify(), rec_request(), safe_channel_release(), and wait_for_digits().
◆ ast_channel_req_accountcodes()
| 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().
- Since
- 13.0.0
- Parameters
-
chan New channel to get accountcodes setup. requestor Requesting channel to get accountcodes from. relationship What the new channel was created for.
- Precondition
- The chan and requestor channels are already locked.
- Note
- Pre-existing accountcodes on chan will be overwritten.
- Returns
- Nothing
Definition at line 6526 of file channel.c.
References channel_req_accountcodes().
Referenced by __ast_request_and_dial(), ast_ari_channels_dial(), ast_call_forward(), attended_transfer_bridge(), begin_dial_prerun(), blind_transfer_bridge(), common_recall_channel_setup(), dial_exec_full(), dial_transfer(), do_forward(), findmeexec(), park_local_transfer(), and wait_for_answer().
static void channel_req_accountcodes(struct ast_channel *chan, const struct ast_channel *requestor, enum ast_channel_requestor_relationship relationship, int precious)
Definition: channel.c:6468
◆ ast_channel_req_accountcodes_precious()
| 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().
- Since
- 13.0.0
- Parameters
-
chan New channel to get accountcodes setup. requestor Requesting channel to get accountcodes from. relationship What the new channel was created for.
- Precondition
- The chan and requestor channels are already locked.
- Note
- Pre-existing accountcodes on chan will not be overwritten.
- Returns
- Nothing
Definition at line 6531 of file channel.c.
References channel_req_accountcodes().
Referenced by ring_entry().
static void channel_req_accountcodes(struct ast_channel *chan, const struct ast_channel *requestor, enum ast_channel_requestor_relationship relationship, int precious)
Definition: channel.c:6468
◆ ast_channel_request_stream_topology_change()
| 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.
- Parameters
-
chan The channel to change topology The new stream topology change_source The source that initiated the change
- Note
- Absolutely NO channel locks should be held before calling this function.
- Return values
-
0 request has been accepted to be attempted -1 request could not be attempted
- Note
- This function initiates an asynchronous request to change the stream topology. It is not guaranteed that the topology will change and until an AST_CONTROL_STREAM_TOPOLOGY_CHANGED frame is received from the channel the current handler of the channel must tolerate the stream topology as it currently exists.
- This interface is provided for applications and resources to request that the topology change. It is not for use by the channel driver itself.
Definition at line 11167 of file channel.c.
References ast_assert, ast_channel_get_stream_topology(), ast_channel_internal_set_stream_topology_change_source(), ast_channel_is_multistream(), ast_channel_lock, ast_channel_name(), ast_channel_tech(), ast_channel_unlock, AST_CONTROL_STREAM_TOPOLOGY_REQUEST_CHANGE, ast_debug, ast_str_tmp, ast_stream_topology_equal(), ast_stream_topology_to_str(), ast_channel_tech::indicate, indicate(), and NULL.
Referenced by AST_TEST_DEFINE(), native_rtp_bridge_join(), native_rtp_stream_topology_changed(), sfu_topologies_on_join(), sfu_topologies_on_leave(), sfu_topologies_on_source_change(), simple_bridge_join(), simple_bridge_stream_topology_changed(), softmix_bridge_stream_sources_update(), and stream_echo_perform().
11184 ast_str_tmp(256, ast_stream_topology_to_str(ast_channel_get_stream_topology(chan), &STR_TMP)),
11192 res = ast_channel_tech(chan)->indicate(chan, AST_CONTROL_STREAM_TOPOLOGY_REQUEST_CHANGE, topology, sizeof(topology));
int ast_channel_is_multistream(struct ast_channel *chan)
Determine if a channel is multi-stream capable.
Definition: channel_internal_api.c:1643
struct ast_stream_topology * ast_channel_get_stream_topology(const struct ast_channel *chan)
Retrieve the topology of streams on a channel.
Definition: channel_internal_api.c:1583
void ast_channel_internal_set_stream_topology_change_source(struct ast_channel *chan, void *change_source)
Definition: channel_internal_api.c:666
const char * ast_stream_topology_to_str(const struct ast_stream_topology *topology, struct ast_str **buf)
Get a string representing the topology for debugging/display purposes.
Definition: stream.c:936
int ast_stream_topology_equal(const struct ast_stream_topology *left, const struct ast_stream_topology *right)
Compare two stream topologies to see if they are equal.
Definition: stream.c:696
const char * ast_channel_name(const struct ast_channel *chan)
int(*const indicate)(struct ast_channel *c, int condition, const void *data, size_t datalen)
Indicate a particular condition (e.g. AST_CONTROL_BUSY or AST_CONTROL_RINGING or AST_CONTROL_CONGESTI...
Definition: channel.h:772
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_channel_rings()
| int ast_channel_rings | ( | const struct ast_channel * | chan | ) |
Definition at line 453 of file channel_internal_api.c.
Referenced by __analog_handle_event(), ast_var_channels_table(), and serialize_showchan().
◆ ast_channel_rings_set()
| void ast_channel_rings_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 457 of file channel_internal_api.c.
References value.
Referenced by __analog_handle_event(), __analog_ss_thread(), analog_ss_thread(), cb_events(), chan_pjsip_new(), dahdi_handle_event(), dahdi_new(), jingle_new(), mbl_new(), mgcp_new(), misdn_new(), nbs_new(), ooh323_new(), phone_answer(), phone_new(), sip_new(), skinny_new(), and unistim_new().
◆ ast_channel_sched()
| struct ast_sched_context* ast_channel_sched | ( | const struct ast_channel * | chan | ) |
Definition at line 729 of file channel_internal_api.c.
References ast_channel::sched.
Referenced by ast_channel_destructor(), ast_hangup(), ast_readaudio_callback(), ast_readvideo_callback(), background_detect_exec(), dial_exec_full(), filestream_close(), handle_speechrecognize(), speech_background(), wait_for_winner(), and waitstream_core().
◆ ast_channel_sched_set()
| void ast_channel_sched_set | ( | struct ast_channel * | chan, |
| struct ast_sched_context * | value | ||
| ) |
Definition at line 733 of file channel_internal_api.c.
References ast_channel::sched, and value.
Referenced by __ast_channel_alloc_ap(), and ast_hangup().
◆ ast_channel_sendhtml()
| 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.
- Returns
- 0 on success or -1 on failure
Definition at line 6725 of file channel.c.
References ast_channel_tech(), and ast_channel_tech::send_html.
Referenced by ast_channel_sendurl(), and wait_for_answer().
int(*const send_html)(struct ast_channel *chan, int subclass, const char *data, int len)
Send HTML data.
Definition: channel.h:763
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_channel_sending_dtmf_digit()
| char ast_channel_sending_dtmf_digit | ( | const struct ast_channel * | chan | ) |
Definition at line 388 of file channel_internal_api.c.
Referenced by ast_senddigit_end(), bridge_channel_internal_join(), and channel_do_masquerade().
◆ ast_channel_sending_dtmf_digit_set()
| void ast_channel_sending_dtmf_digit_set | ( | struct ast_channel * | chan, |
| char | value | ||
| ) |
Definition at line 392 of file channel_internal_api.c.
References value.
Referenced by ast_senddigit_begin(), and ast_senddigit_end().
◆ ast_channel_sending_dtmf_tv()
| struct timeval ast_channel_sending_dtmf_tv | ( | const struct ast_channel * | chan | ) |
Definition at line 397 of file channel_internal_api.c.
Referenced by bridge_channel_internal_join(), and channel_do_masquerade().
◆ ast_channel_sending_dtmf_tv_set()
| void ast_channel_sending_dtmf_tv_set | ( | struct ast_channel * | chan, |
| struct timeval | value | ||
| ) |
Definition at line 401 of file channel_internal_api.c.
References value.
Referenced by ast_senddigit_begin().
◆ ast_channel_sendurl()
| int ast_channel_sendurl | ( | struct ast_channel * | channel, |
| const char * | url | ||
| ) |
Sends a URL on a given link Send URL on link.
- Returns
- 0 on success or -1 on failure
Definition at line 6732 of file channel.c.
References ast_channel_sendhtml(), and AST_HTML_URL.
Referenced by dial_exec_full(), sendurl_exec(), and try_calling().
int ast_channel_sendhtml(struct ast_channel *chan, int subclass, const char *data, int datalen)
Sends HTML on given channel Send HTML or URL on link.
Definition: channel.c:6725
◆ ast_channel_set_ari_vars()
| 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.
- Since
- 14.2.0
- Parameters
-
varc Number of variable names. vars Array of variable names.
Definition at line 7994 of file channel.c.
References ari_vars, and channel_set_external_vars().
Referenced by channelvars_handler().
static void channel_set_external_vars(struct external_vars *channelvars, size_t varc, char **vars)
Definition: channel.c:7967
◆ ast_channel_set_caller()
| 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.
- Since
- 1.8
- Parameters
-
chan Asterisk channel to set caller id information caller Caller id information update What caller information to update. NULL if all.
- Returns
- Nothing
- Note
- The channel does not need to be locked before calling this function.
Definition at line 7459 of file channel.c.
References ast_channel_caller(), ast_channel_lock, AST_CHANNEL_SNAPSHOT_INVALIDATE_CALLER, ast_channel_snapshot_invalidate_segment(), ast_channel_unlock, and ast_party_caller_set().
Referenced by create_alice_channel().
struct ast_party_caller * ast_channel_caller(struct ast_channel *chan)
Definition: channel_internal_api.c:888
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.
Definition: channel.c:2007
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
◆ ast_channel_set_caller_event()
| 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.
- Since
- 1.8
- Parameters
-
chan Asterisk channel to set caller id information caller Caller id information update What caller information to update. NULL if all.
- Returns
- Nothing
- Note
- The channel does not need to be locked before calling this function.
Definition at line 7472 of file channel.c.
References ast_channel_caller(), ast_channel_lock, ast_channel_publish_snapshot(), AST_CHANNEL_SNAPSHOT_INVALIDATE_CALLER, ast_channel_snapshot_invalidate_segment(), ast_channel_unlock, and ast_party_caller_set().
Referenced by callerid_write(), dial_exec_full(), do_forward(), misdn_update_caller_id(), queue_connected_line_update(), and ring_entry().
struct ast_party_caller * ast_channel_caller(struct ast_channel *chan)
Definition: channel_internal_api.c:888
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.
Definition: channel.c:2007
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
void ast_channel_publish_snapshot(struct ast_channel *chan)
Publish a ast_channel_snapshot for a channel.
Definition: stasis_channels.c:1055
◆ ast_channel_set_connected_line()
| 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.
- Since
- 1.8
- Parameters
-
chan Asterisk channel to set connected line information connected Connected line information update What connected line information to update. NULL if all.
- Returns
- Nothing
- Note
- The channel does not need to be locked before calling this function.
Definition at line 8404 of file channel.c.
References ast_channel_connected(), ast_channel_lock, ast_channel_publish_snapshot(), AST_CHANNEL_SNAPSHOT_INVALIDATE_CONNECTED, ast_channel_snapshot_invalidate_segment(), ast_channel_unlock, and ast_party_connected_line_set().
Referenced by __ast_request_and_dial(), ari_channels_handle_originate_with_id(), connectedline_write(), dial_exec_full(), indicate_connected_line(), and pbx_outgoing_attempt().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
struct ast_party_connected_line * ast_channel_connected(struct ast_channel *chan)
Definition: channel_internal_api.c:892
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.
Definition: channel.c:2054
void ast_channel_publish_snapshot(struct ast_channel *chan)
Publish a ast_channel_snapshot for a channel.
Definition: stasis_channels.c:1055
◆ ast_channel_set_fd()
| void ast_channel_set_fd | ( | struct ast_channel * | chan, |
| int | which, | ||
| int | fd | ||
| ) |
Set the file descriptor on the channel
Definition at line 2431 of file channel.c.
References ast_channel_internal_fd_set().
Referenced by __ast_channel_alloc_ap(), alsa_new(), ast_jb_create_framehook(), AST_TEST_DEFINE(), audiosocket_request(), channel_do_masquerade(), check_for_rtp_changes(), configure_local_rtp(), configure_rtcp(), dahdi_new(), deactivate_generator_nolock(), do_monitor_headset(), initialize_udptl(), jingle_enable_video(), jingle_new(), mbl_hangup(), mbl_new(), mbl_read(), mgcp_new(), misdn_new(), my_swap_subchannels(), nbs_new(), oss_new(), phone_new(), process_sdp(), sco_accept(), setformat(), sip_new(), sip_set_rtp_peer(), skinny_new(), start_rtp(), stasis_app_control_snoop(), swap_subs(), transmit_reinvite_with_sdp(), and unicast_rtp_request().
void ast_channel_internal_fd_set(struct ast_channel *chan, int which, int value)
Definition: channel_internal_api.c:1161
◆ ast_channel_set_flag()
| void ast_channel_set_flag | ( | struct ast_channel * | chan, |
| unsigned int | flag | ||
| ) |
Set a flag on a channel.
- Since
- 13.17.0
- Parameters
-
chan The channel to set the flag on flag The flag to set
- Note
- This will lock the channel internally. If the channel is already locked it is still safe to call.
Definition at line 11228 of file channel.c.
References ast_channel_flags(), ast_channel_lock, ast_channel_unlock, and ast_set_flag.
Referenced by ast_call_forward(), ast_waitfordigit_full(), channel_spy(), common_exec(), dial_exec_full(), disa_exec(), and waitstream_core().
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ ast_channel_set_is_t38_active()
| void ast_channel_set_is_t38_active | ( | struct ast_channel * | chan, |
| int | is_t38_active | ||
| ) |
Sets the is_t38_active flag.
- Parameters
-
chan Which channel is having its is_t38_active value set is_t38_active Non-zero if T.38 is active
Definition at line 1061 of file channel_internal_api.c.
References ast_channel_lock, ast_channel_set_is_t38_active_nolock(), and ast_channel_unlock.
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...
Definition: channel_internal_api.c:1056
◆ ast_channel_set_is_t38_active_nolock()
| 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.
- Parameters
-
chan Which channel is having its is_t38_active value set is_t38_active Non-zero if T.38 is active
Definition at line 1056 of file channel_internal_api.c.
Referenced by ast_channel_set_is_t38_active(), and indicate_data_internal().
◆ ast_channel_set_manager_vars()
| 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.
- Since
- 12
- Parameters
-
varc Number of variable names. vars Array of variable names.
Definition at line 7989 of file channel.c.
References ami_vars, and channel_set_external_vars().
Referenced by load_channelvars().
static void channel_set_external_vars(struct external_vars *channelvars, size_t varc, char **vars)
Definition: channel.c:7967
◆ ast_channel_set_oldwriteformat()
| void ast_channel_set_oldwriteformat | ( | struct ast_channel * | chan, |
| struct ast_format * | format | ||
| ) |
Definition at line 824 of file channel_internal_api.c.
References ao2_replace.
Referenced by ast_channel_destructor(), and ast_openstream_full().
◆ ast_channel_set_rawreadformat()
| void ast_channel_set_rawreadformat | ( | struct ast_channel * | chan, |
| struct ast_format * | format | ||
| ) |
Definition at line 828 of file channel_internal_api.c.
References ao2_replace.
Referenced by __ast_channel_alloc_ap(), ast_channel_destructor(), ast_iax2_new(), ast_set_read_format_path(), AST_TEST_DEFINE(), ast_unreal_new_channels(), audiosocket_request(), chan_pjsip_new(), channel_do_masquerade(), dahdi_new(), do_notify(), jingle_new(), mbl_new(), mgcp_new(), misdn_new(), multicast_rtp_request(), nbs_new(), ooh323_new(), phone_new(), rec_request(), set_test_formats(), sip_new(), sip_session_response_cb(), skinny_new(), stasis_app_control_snoop(), test_vm_api_create_mock_channel(), unicast_rtp_request(), and unistim_new().
◆ ast_channel_set_rawwriteformat()
| void ast_channel_set_rawwriteformat | ( | struct ast_channel * | chan, |
| struct ast_format * | format | ||
| ) |
Definition at line 832 of file channel_internal_api.c.
References ao2_replace.
Referenced by __ast_channel_alloc_ap(), ast_channel_destructor(), ast_iax2_new(), ast_set_write_format_path(), AST_TEST_DEFINE(), ast_unreal_new_channels(), audiosocket_request(), chan_pjsip_new(), channel_do_masquerade(), dahdi_new(), do_notify(), jingle_new(), mbl_new(), mgcp_new(), misdn_new(), multicast_rtp_request(), nbs_new(), ooh323_new(), phone_new(), rec_request(), set_test_formats(), sip_new(), sip_session_response_cb(), skinny_new(), stasis_app_control_snoop(), test_vm_api_create_mock_channel(), unicast_rtp_request(), and unistim_new().
◆ ast_channel_set_readformat()
| void ast_channel_set_readformat | ( | struct ast_channel * | chan, |
| struct ast_format * | format | ||
| ) |
Definition at line 836 of file channel_internal_api.c.
References ao2_replace.
Referenced by __ast_channel_alloc_ap(), alsa_new(), ast_channel_destructor(), ast_channel_yank(), ast_iax2_new(), ast_set_read_format_path(), AST_TEST_DEFINE(), ast_unreal_new_channels(), audiosocket_request(), chan_pjsip_new(), console_new(), dahdi_new(), do_notify(), iax2_request(), jingle_new(), mbl_new(), mgcp_new(), misdn_new(), multicast_rtp_request(), nbs_new(), oss_new(), rec_request(), set_test_formats(), sip_new(), sip_session_response_cb(), skinny_new(), start_rtp(), stasis_app_control_snoop(), test_vm_api_create_mock_channel(), unicast_rtp_request(), and unistim_new().
◆ ast_channel_set_redirecting()
| 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.
- Since
- 1.8
- Parameters
-
chan Asterisk channel to set redirecting id information redirecting Redirecting id information update What redirecting information to update. NULL if all.
- Returns
- Nothing
- Note
- The channel does not need to be locked before calling this function.
Definition at line 9215 of file channel.c.
References ast_channel_lock, ast_channel_redirecting(), AST_CHANNEL_SNAPSHOT_INVALIDATE_CALLER, ast_channel_snapshot_invalidate_segment(), ast_channel_unlock, and ast_party_redirecting_set().
Referenced by handle_request_invite(), handle_response(), indicate_redirecting(), misdn_copy_redirecting_to_ast(), redirecting_write(), and set_redirecting().
void ast_channel_snapshot_invalidate_segment(struct ast_channel *chan, enum ast_channel_snapshot_segment_invalidation segment)
Invalidate a channel snapshot segment from being reused.
Definition: stasis_channels.c:1049
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.
Definition: channel.c:2166
struct ast_party_redirecting * ast_channel_redirecting(struct ast_channel *chan)
Definition: channel_internal_api.c:908
◆ ast_channel_set_stream_topology()
| 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.
- Parameters
-
chan The channel to set the stream topology on topology The stream topology to set
- Precondition
- chan is locked
- Note
- If topology is NULL a new empty topology will be created and returned.
- Return values
-
non-NULL Success NULL failure
Definition at line 1591 of file channel_internal_api.c.
References ast_assert, ast_channel_internal_set_stream_topology(), ast_channel_is_multistream(), ast_channel_name(), ast_str_tmp, ast_stream_topology_alloc(), ast_stream_topology_to_str(), NULL, SCOPE_ENTER, and SCOPE_EXIT_RTN_VALUE.
Referenced by AST_TEST_DEFINE(), ast_unreal_indicate(), ast_unreal_new_channels(), chan_pjsip_new(), handle_negotiated_sdp(), make_channel(), and unreal_colp_stream_topology_request_change().
int ast_channel_is_multistream(struct ast_channel *chan)
Determine if a channel is multi-stream capable.
Definition: channel_internal_api.c:1643
const char * ast_stream_topology_to_str(const struct ast_stream_topology *topology, struct ast_str **buf)
Get a string representing the topology for debugging/display purposes.
Definition: stream.c:936
Definition: stream.c:123
struct ast_stream_topology * ast_stream_topology_alloc(void)
Create a stream topology.
Definition: stream.c:650
#define SCOPE_ENTER(level,...)
Non RAII_VAR Scope Trace macros The advantage of these macros is that the EXITs will have the actual ...
Definition: logger.h:780
#define SCOPE_EXIT_RTN_VALUE(__return_value,...)
Scope Exit with return value.
Definition: logger.h:875
const char * ast_channel_name(const struct ast_channel *chan)
void ast_channel_internal_set_stream_topology(struct ast_channel *chan, struct ast_stream_topology *topology)
Definition: channel_internal_api.c:658
◆ ast_channel_set_unbridged()
| 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.
- Parameters
-
chan Which channel is having its unbridged value set value What the unbridge value is being set to
Definition at line 1034 of file channel_internal_api.c.
References ast_channel_lock, ast_channel_set_unbridged_nolock(), and ast_channel_unlock.
Referenced by ast_bridge_setup_after_goto(), bridge_channel_wait(), and t38_change_state().
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...
Definition: channel_internal_api.c:1028
◆ ast_channel_set_unbridged_nolock()
| 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.
- Parameters
-
chan Which channel is having its unbridged value set value What the unbridge value is being set to
Definition at line 1028 of file channel_internal_api.c.
References ast_null_frame, ast_queue_frame(), and value.
Referenced by ast_audiohook_attach(), ast_audiohook_remove(), ast_channel_set_unbridged(), ast_framehook_attach(), ast_framehook_detach(), ast_framehook_list_fixup(), audio_audiohook_write_list(), chan_pjsip_read_stream(), dtmf_audiohook_write_list(), and set_caps().
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *f)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
◆ ast_channel_set_writeformat()
| void ast_channel_set_writeformat | ( | struct ast_channel * | chan, |
| struct ast_format * | format | ||
| ) |
Definition at line 840 of file channel_internal_api.c.
References ao2_replace.
Referenced by __ast_channel_alloc_ap(), alsa_new(), ast_channel_destructor(), ast_channel_yank(), ast_iax2_new(), ast_set_write_format_path(), AST_TEST_DEFINE(), ast_unreal_new_channels(), audiosocket_request(), chan_pjsip_new(), console_new(), dahdi_new(), do_notify(), iax2_request(), jingle_new(), mbl_new(), mgcp_new(), misdn_new(), multicast_rtp_request(), nbs_new(), oss_new(), rec_request(), set_test_formats(), sip_new(), sip_session_response_cb(), skinny_new(), start_rtp(), stasis_app_control_snoop(), test_vm_api_create_mock_channel(), unicast_rtp_request(), and unistim_new().
◆ ast_channel_setoption()
| int ast_channel_setoption | ( | struct ast_channel * | channel, |
| int | option, | ||
| void * | data, | ||
| int | datalen, | ||
| int | block | ||
| ) |
Sets an option on a channel.
- Parameters
-
channel channel to set options on option option to change data data specific to option datalen length of the data block blocking or not
Set an option on a channel (see frame.h), optionally blocking awaiting the reply
- Returns
- 0 on success and -1 on failure
Definition at line 7522 of file channel.c.
References ast_channel_lock, ast_channel_tech(), ast_channel_unlock, ast_log, errno, LOG_ERROR, and ast_channel_tech::setoption.
Referenced by analog_hangup(), bridge_channel_handle_control(), common_exec(), conf_run(), dahdi_hangup(), dial_exec_full(), func_channel_write(), func_channel_write_real(), handle_tddmode(), play_record_review(), rcvfax_exec(), reset_volumes(), set_format(), set_listen_volume(), set_security_requirements(), set_talk_volume(), sndfax_exec(), try_calling(), and vm_forwardoptions().
int(*const setoption)(struct ast_channel *chan, int option, void *data, int datalen)
Set a given option. Called with chan locked.
Definition: channel.h:778
int errno
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_channel_setwhentohangup_tv()
| void ast_channel_setwhentohangup_tv | ( | struct ast_channel * | chan, |
| struct timeval | offset | ||
| ) |
Set when to hang a channel up.
- Parameters
-
chan channel on which to check for hang up offset offset in seconds and useconds relative to the current time of when to hang up
This function sets the absolute time out on a channel (when to hang up).
- Precondition
- chan is locked
- Returns
- Nothing
- Since
- 1.6.1
Set when to hang a channel up.
Definition at line 510 of file channel.c.
References ast_channel_whentohangup_set(), ast_null_frame, ast_queue_frame(), ast_tvadd(), ast_tvnow(), and ast_tvzero().
Referenced by action_timeout(), handle_autohangup(), and timeout_write().
void ast_channel_whentohangup_set(struct ast_channel *chan, struct timeval *value)
Definition: channel_internal_api.c:968
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
struct timeval ast_tvadd(struct timeval a, struct timeval b)
Returns the sum of two timevals a + b.
Definition: extconf.c:2283
◆ ast_channel_snapshot()
| struct ast_channel_snapshot* ast_channel_snapshot | ( | const struct ast_channel * | chan | ) |
Definition at line 1648 of file channel_internal_api.c.
Referenced by aoc_publish_blob(), ast_channel_blob_create(), ast_channel_snapshot_create(), and channel_snapshot_update_create().
◆ ast_channel_snapshot_segment_flags()
| struct ast_flags* ast_channel_snapshot_segment_flags | ( | struct ast_channel * | chan | ) |
Definition at line 1659 of file channel_internal_api.c.
Referenced by ast_channel_publish_snapshot(), ast_channel_snapshot_create(), ast_channel_snapshot_invalidate_segment(), and channel_do_masquerade().
◆ ast_channel_snapshot_set()
| void ast_channel_snapshot_set | ( | struct ast_channel * | chan, |
| struct ast_channel_snapshot * | snapshot | ||
| ) |
Definition at line 1653 of file channel_internal_api.c.
References ao2_bump, and ao2_cleanup.
Referenced by ast_channel_publish_final_snapshot(), and ast_channel_publish_snapshot().
◆ ast_channel_softhangup_internal_flag()
| int ast_channel_softhangup_internal_flag | ( | struct ast_channel * | chan | ) |
Definition at line 997 of file channel_internal_api.c.
Referenced by __ast_pbx_run(), __ast_read(), _macro_exec(), agent_request_exec(), ast_autoservice_stop(), ast_bridge_call_with_flags(), ast_bridge_join(), ast_bridge_setup_after_goto(), ast_channel_clear_softhangup(), ast_channel_end_dtmf(), ast_channel_is_leaving_bridge(), ast_channel_snapshot_create(), ast_check_hangup(), collect_digits(), gosub_run(), park_and_announce_app_exec(), park_app_exec(), and waitstream_core().
◆ ast_channel_softhangup_internal_flag_add()
| void ast_channel_softhangup_internal_flag_add | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 1005 of file channel_internal_api.c.
References value.
Referenced by __ast_read(), ast_check_hangup(), ast_dsp_process(), ast_queue_hangup(), ast_queue_hangup_with_cause(), ast_softhangup_nolock(), ast_waitfor_nandfds(), ast_write_stream(), attempt_transfer(), dahdi_handle_event(), handle_clear_alarms(), iax2_key_rotate(), onCallCleared(), and sip_pvt_dtor().
◆ ast_channel_softhangup_internal_flag_clear()
| void ast_channel_softhangup_internal_flag_clear | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 1009 of file channel_internal_api.c.
Referenced by ast_channel_clear_softhangup().
◆ ast_channel_softhangup_internal_flag_set()
| void ast_channel_softhangup_internal_flag_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 1001 of file channel_internal_api.c.
References value.
Referenced by channel_do_masquerade().
◆ ast_channel_softhangup_withcause_locked()
| 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.
- Parameters
-
chan channel on which to hang up causecode cause code to use (Zero if don't use cause code)
- Returns
- Nothing
Definition at line 468 of file channel.c.
References ast_channel_hangupcause(), ast_channel_hangupcause_set(), ast_channel_lock, ast_channel_name(), ast_channel_unlock, ast_debug, AST_SOFTHANGUP_EXPLICIT, and ast_softhangup_nolock().
Referenced by action_hangup().
int ast_softhangup_nolock(struct ast_channel *chan, int cause)
Softly hangup a channel, don't lock.
Definition: channel.c:2463
void ast_channel_hangupcause_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:431
Definition: channel.h:1149
int ast_channel_hangupcause(const struct ast_channel *chan)
Definition: channel_internal_api.c:427
const char * ast_channel_name(const struct ast_channel *chan)
◆ ast_channel_start_silence_generator()
| struct ast_silence_generator* ast_channel_start_silence_generator | ( | struct ast_channel * | chan | ) |
Starts a silence generator on the given channel.
- Parameters
-
chan The channel to generate silence on
- Returns
- An ast_silence_generator pointer, or NULL if an error occurs
This function will cause SLINEAR silence to be generated on the supplied channel until it is disabled; if the channel cannot be put into SLINEAR mode then the function will fail.
- Note
- The pointer returned by this function must be preserved and passed to ast_channel_stop_silence_generator when you wish to stop the silence generation.
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 8266 of file channel.c.
References ao2_bump, ast_activate_generator(), ast_calloc, ast_channel_name(), ast_channel_writeformat(), ast_debug, ast_format_slin, ast_free, ast_log, ast_set_write_format(), LOG_ERROR, NULL, ast_silence_generator::old_write_format, and state.
Referenced by __ast_play_and_record(), app_control_silence_start(), ast_readstring_full(), channel_spy(), control_streamfile(), dtmf_stream(), mf_stream(), participant_entertainment_start(), record_exec(), safe_sleep_conditional(), sub_start_silence(), waitfor_exec(), and waitforring_exec().
Definition: channel.c:8262
const char * ast_channel_name(const struct ast_channel *chan)
struct ast_format * old_write_format
Definition: channel.c:8263
struct ast_format * ast_format_slin
Built-in cached signed linear 8kHz format.
Definition: format_cache.c:41
int ast_set_write_format(struct ast_channel *chan, struct ast_format *format)
Sets write format on channel chan.
Definition: channel.c:5890
struct ast_format * ast_channel_writeformat(struct ast_channel *chan)
Definition: channel_internal_api.c:860
int ast_activate_generator(struct ast_channel *chan, struct ast_generator *gen, void *params)
Definition: channel.c:2960
◆ ast_channel_state()
| enum ast_channel_state ast_channel_state | ( | const struct ast_channel * | chan | ) |
Definition at line 789 of file channel_internal_api.c.
◆ ast_channel_state_set()
| void ast_channel_state_set | ( | struct ast_channel * | chan, |
| enum | ast_channel_state | ||
| ) |
Definition at line 820 of file channel_internal_api.c.
References value.
Referenced by __ast_channel_alloc_ap(), ast_setstate(), AST_TEST_DEFINE(), and channel_do_masquerade().
◆ ast_channel_stop_silence_generator()
| void ast_channel_stop_silence_generator | ( | struct ast_channel * | chan, |
| struct ast_silence_generator * | state | ||
| ) |
Stops a previously-started silence generator on the given channel.
- Parameters
-
chan The channel to operate on state The ast_silence_generator pointer return by a previous call to ast_channel_start_silence_generator.
- Returns
- nothing
This function will stop the operating silence generator and return the channel to its previous write format.
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 8312 of file channel.c.
References ao2_cleanup, ast_channel_name(), ast_debug, ast_free, ast_log, ast_set_write_format(), deactivate_silence_generator(), LOG_ERROR, and ast_silence_generator::old_write_format.
Referenced by __ast_play_and_record(), app_control_silence_start(), ast_readstring_full(), channel_spy(), control_silence_stop_now(), control_streamfile(), dtmf_stream(), mf_stream(), participant_entertainment_stop(), record_exec(), safe_sleep_conditional(), sub_stop_silence(), waitfor_exec(), and waitforring_exec().
static int deactivate_silence_generator(struct ast_channel *chan)
Definition: channel.c:8289
const char * ast_channel_name(const struct ast_channel *chan)
struct ast_format * old_write_format
Definition: channel.c:8263
int ast_set_write_format(struct ast_channel *chan, struct ast_format *format)
Sets write format on channel chan.
Definition: channel.c:5890
◆ ast_channel_stream()
| struct ast_filestream* ast_channel_stream | ( | const struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 621 of file channel_internal_api.c.
References ast_channel::stream.
Referenced by ast_hangup(), ast_moh_files_next(), ast_openstream_full(), ast_readstring_full(), ast_stopstream(), background_detect_exec(), control_streamfile(), dial_exec_full(), filehelper(), handle_getoption(), handle_speechrecognize(), handle_streamfile(), local_ast_moh_stop(), moh_files_readframe(), moh_files_release(), speech_background(), wait_for_winner(), waitstream_control(), and waitstream_core().
◆ ast_channel_stream_set()
| void ast_channel_stream_set | ( | struct ast_channel * | chan, |
| struct ast_filestream * | value | ||
| ) |
Definition at line 625 of file channel_internal_api.c.
References ast_channel::stream, and value.
Referenced by ast_hangup(), ast_moh_files_next(), ast_stopstream(), dictate_exec(), filehelper(), filestream_close(), gen_closestream(), handle_recordfile(), local_ast_moh_stop(), and moh_files_release().
◆ ast_channel_stream_topology_changed()
| 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.
- Parameters
-
chan The channel to provide notice to topology The new stream topology
- Precondition
- chan is locked Absolutely NO other channels can be locked.
- Return values
-
0 success -1 failure
- Note
- This interface is provided for applications and resources to accept a topology change. It is not for use by the channel driver itself.
Definition at line 11197 of file channel.c.
References ast_assert, ast_channel_is_multistream(), ast_channel_tech(), AST_CONTROL_STREAM_TOPOLOGY_CHANGED, ast_channel_tech::indicate, indicate(), and NULL.
Referenced by __ast_read(), and AST_TEST_DEFINE().
11206 return ast_channel_tech(chan)->indicate(chan, AST_CONTROL_STREAM_TOPOLOGY_CHANGED, topology, sizeof(topology));
int ast_channel_is_multistream(struct ast_channel *chan)
Determine if a channel is multi-stream capable.
Definition: channel_internal_api.c:1643
int(*const indicate)(struct ast_channel *c, int condition, const void *data, size_t datalen)
Indicate a particular condition (e.g. AST_CONTROL_BUSY or AST_CONTROL_RINGING or AST_CONTROL_CONGESTI...
Definition: channel.h:772
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_channel_stream_topology_changed_externally()
| 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.
- Parameters
-
chan The channel to provide notice from
- Return values
-
0 success -1 failure
- Note
- This interface is provided for channels to provide notice that a topology change has occurred as a result of a remote party renegotiating the stream topology.
Definition at line 11209 of file channel.c.
References ast_assert, ast_channel_internal_set_stream_topology_change_source(), ast_channel_is_multistream(), ast_channel_lock, ast_channel_unlock, AST_CONTROL_STREAM_TOPOLOGY_CHANGED, AST_FRAME_CONTROL, ast_queue_frame(), ast_stream_topology_changed_external, and NULL.
Referenced by handle_negotiated_sdp(), and unreal_colp_stream_topology_request_change().
11212 struct ast_frame f = { AST_FRAME_CONTROL, .subclass.integer = AST_CONTROL_STREAM_TOPOLOGY_CHANGED };
11221 ast_channel_internal_set_stream_topology_change_source(chan, (void *)&ast_stream_topology_changed_external);
int ast_channel_is_multistream(struct ast_channel *chan)
Determine if a channel is multi-stream capable.
Definition: channel_internal_api.c:1643
void ast_channel_internal_set_stream_topology_change_source(struct ast_channel *chan, void *change_source)
Definition: channel_internal_api.c:666
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
static const char ast_stream_topology_changed_external[]
Set as the change source reason when a channel stream topology has been changed externally as a resul...
Definition: channel.h:222
Definition: include/asterisk/frame.h:105
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
◆ ast_channel_streamid()
| int ast_channel_streamid | ( | const struct ast_channel * | chan | ) |
Definition at line 461 of file channel_internal_api.c.
Referenced by filestream_close(), handle_speechrecognize(), and speech_background().
◆ ast_channel_streamid_set()
| void ast_channel_streamid_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 465 of file channel_internal_api.c.
References value.
Referenced by __ast_channel_alloc_ap(), ast_readaudio_callback(), and filestream_close().
◆ ast_channel_string2amaflag()
| enum ama_flags ast_channel_string2amaflag | ( | const char * | flag | ) |
Convert a string to a detail record AMA flag.
- Since
- 12
- Parameters
-
flag string form of flag
- Return values
-
the enum (integer) form of the flag
Definition at line 4405 of file channel.c.
References AST_AMA_BILLING, AST_AMA_DOCUMENTATION, AST_AMA_NONE, AST_AMA_OMIT, and DEFAULT_AMA_FLAGS.
Referenced by build_device(), build_gateway(), build_peer(), build_user(), cdr_write(), config_parse_variables(), func_channel_write_real(), pbx_builtin_setamaflags(), process_dahdi(), reload_config(), and set_config().
Definition: channel.h:1179
Definition: channel.h:1182
Definition: channel.h:1180
Definition: channel.h:1181
◆ ast_channel_supports_html()
| int ast_channel_supports_html | ( | struct ast_channel * | channel | ) |
Checks for HTML support on a channel.
- Returns
- 0 if channel does not support HTML or non-zero if it does
Definition at line 6720 of file channel.c.
References ast_channel_tech().
Referenced by dial_exec_full(), sendurl_exec(), and try_calling().
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_channel_suppress()
| 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.
- Note
- The channel should be locked before calling this function.
- Parameters
-
chan The channel to suppress direction The direction in which to suppress frametype The type of frame (AST_FRAME_VOICE, etc) to suppress
- Return values
-
0 Success -1 Failure
Definition at line 10978 of file channel.c.
References ao2_alloc, ao2_ref, ast_channel_datastore_add(), ast_channel_datastore_find(), ast_datastore_alloc, ast_framehook_attach(), ast_framehook_detach(), AST_FRAMEHOOK_INTERFACE_VERSION, ast_log, ast_datastore::data, ast_framehook_interface::data, suppress_data::direction, suppress_data::framehook_id, suppress_data::frametype, LOG_WARNING, NULL, suppress_framehook_destroy_cb(), suppress_framehook_event_cb(), suppress_framehook_fixup_cb(), suppress_get_datastore_information(), and ast_framehook_interface::version.
Referenced by app_control_mute(), and mute_channel().
11026 ast_log(LOG_WARNING, "Failed to allocate datastore while attempting to suppress a stream.\n");
Definition: framehook.h:229
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.
Definition: channel.c:2404
static void suppress_framehook_destroy_cb(void *data)
Definition: channel.c:10915
int ast_framehook_detach(struct ast_channel *chan, int framehook_id)
Detach an framehook from a channel.
Definition: framehook.c:177
static const struct ast_datastore_info * suppress_get_datastore_information(enum ast_frame_type frametype)
Definition: channel.c:10968
Definition: channel.c:10920
int ast_framehook_attach(struct ast_channel *chan, struct ast_framehook_interface *i)
Attach an framehook onto a channel for frame interception.
Definition: framehook.c:132
static void suppress_framehook_fixup_cb(void *data, int framehook_id, struct ast_channel *old_chan, struct ast_channel *new_chan)
Definition: channel.c:10926
static struct ast_frame * suppress_framehook_event_cb(struct ast_channel *chan, struct ast_frame *frame, enum ast_framehook_event event, void *data)
Definition: channel.c:10933
int ast_channel_datastore_add(struct ast_channel *chan, struct ast_datastore *datastore)
Add a datastore to a channel.
Definition: channel.c:2390
◆ ast_channel_tech()
| const struct ast_channel_tech* ast_channel_tech | ( | const struct ast_channel * | chan | ) |
Definition at line 769 of file channel_internal_api.c.
References ast_channel::tech.
Referenced by __ast_read(), acf_channel_read(), action_dahdishowchannels(), analog_ss_thread(), ast_ari_channels_rtpstatistics(), ast_call(), ast_channel_early_bridge(), ast_channel_queryoption(), ast_channel_request_stream_topology_change(), ast_channel_sendhtml(), ast_channel_setoption(), ast_channel_snapshot_create(), ast_channel_stream_topology_changed(), ast_channel_supports_html(), ast_hangup(), ast_jb_do_usecheck(), ast_pre_call(), ast_raw_answer_with_stream_topology(), ast_rtp_dtmf_compatible(), ast_rtp_instance_early_bridge(), ast_rtp_instance_early_bridge_make_compatible(), ast_rtp_instance_make_compatible(), ast_send_image(), ast_senddigit(), ast_senddigit_begin(), ast_senddigit_end(), ast_senddigit_external(), ast_senddigit_mf(), ast_sendtext_data(), ast_supports_images(), ast_transfer_protocol(), ast_var_channel_types_table(), ast_var_channels_table(), ast_write_stream(), ast_write_video(), channel_do_masquerade(), channel_sanitizer(), channel_snapshot_base_create(), conf_run(), dahdi_setoption(), dahdiras_exec(), destroy_all_channels(), flash_exec(), func_channel_read(), func_channel_write_real(), func_header_read(), func_headers_read2(), function_iaxpeer(), function_ooh323_read(), function_ooh323_write(), generate_status(), handle_request_bye(), handle_showchan(), iax2_key_rotate(), iax2_prov_app(), indicate_data_internal(), misdn_facility_exec(), misdn_set_opt_exec(), my_get_sigpvt_bridged_channel(), native_bridge_is_capable(), pjsip_acf_channel_read(), pjsip_acf_dtmf_mode_read(), pjsip_acf_dtmf_mode_write(), pjsip_acf_media_offer_read(), pjsip_acf_media_offer_write(), pjsip_acf_moh_passthrough_read(), pjsip_acf_moh_passthrough_write(), pjsip_acf_session_refresh_write(), push_notify_channel(), reload(), rtp_glue_data_get(), sendtext_exec(), serialize_showchan(), setup_env(), sip_acf_channel_read(), sip_cc_agent_init(), sip_dtmfmode(), sipinfo_send(), softhangup_exec(), t38_masq(), tech_write(), transfer_exec(), and try_calling().
◆ ast_channel_tech_pvt()
| void* ast_channel_tech_pvt | ( | const struct ast_channel * | chan | ) |
Definition at line 565 of file channel_internal_api.c.
References ast_channel::tech_pvt.
Referenced by __analog_ss_thread(), __dahdi_exception(), acf_channel_read(), action_dahdishowchannels(), alsa_fixup(), analog_hangup(), analog_ss_thread(), announce_hangup(), ast_channel_destructor(), ast_local_get_peer(), ast_local_lock_all(), ast_local_setup_bridge(), ast_local_setup_masquerade(), AST_TEST_DEFINE(), ast_unreal_answer(), ast_unreal_channel_push_to_bridge(), ast_unreal_digit_begin(), ast_unreal_digit_end(), ast_unreal_fixup(), ast_unreal_indicate(), ast_unreal_queryoption(), ast_unreal_sendhtml(), ast_unreal_sendtext(), ast_unreal_setoption(), ast_unreal_write_stream(), audiosocket_call(), audiosocket_hangup(), audiosocket_read(), audiosocket_write(), chan_pjsip_answer(), chan_pjsip_call(), chan_pjsip_digit_begin(), chan_pjsip_digit_end(), chan_pjsip_fixup(), chan_pjsip_get_rtp_peer(), chan_pjsip_get_uniqueid(), chan_pjsip_get_vrtp_peer(), chan_pjsip_hangup(), chan_pjsip_indicate(), chan_pjsip_queryoption(), chan_pjsip_read_stream(), chan_pjsip_sendtext_data(), chan_pjsip_set_rtp_peer(), chan_pjsip_transfer(), chan_pjsip_write_stream(), channel_do_masquerade(), channel_read_pjsip(), channel_read_rtcp(), channel_read_rtp(), channel_to_session(), cli_channelstats_print_body(), conf_announce_channel_push(), console_answer(), console_call(), console_fixup(), console_hangup(), console_indicate(), console_write(), dahdi_answer(), dahdi_call(), dahdi_callwait(), dahdi_digit_begin(), dahdi_digit_end(), dahdi_exception(), dahdi_fixup(), dahdi_func_read(), dahdi_func_write(), dahdi_handle_dtmf(), dahdi_handle_event(), dahdi_hangup(), dahdi_indicate(), dahdi_queryoption(), dahdi_read(), dahdi_sendtext(), dahdi_setoption(), dahdi_write(), destroy_all_channels(), dialog_unlink_all(), func_header_read(), func_headers_read2(), func_read_header(), func_write_header(), function_iaxpeer(), function_ooh323_read(), function_ooh323_write(), get_video_desc(), handle_callforward_button(), handle_clear_alarms(), handle_enbloc_call_message(), handle_offhook_message(), handle_request_bye(), handle_soft_key_event_message(), handle_stimulus_message(), handle_transfer_button(), hangup(), iax2_answer(), iax2_call(), iax2_digit_begin(), iax2_digit_end(), iax2_fixup(), iax2_hangup(), iax2_indicate(), iax2_key_rotate(), iax2_prov_app(), iax2_queryoption(), iax2_sendhtml(), iax2_sendimage(), iax2_sendtext(), iax2_setoption(), iax2_transfer(), iax2_write(), jingle_answer(), jingle_call(), jingle_digit_begin(), jingle_digit_end(), jingle_fixup(), jingle_get_rtp_peer(), jingle_hangup(), jingle_indicate(), jingle_read(), jingle_sendtext(), jingle_write(), load_stream_readqueue(), local_call(), local_hangup(), manager_optimize_away(), mbl_answer(), mbl_call(), mbl_digit_end(), mbl_fixup(), mbl_hangup(), mbl_read(), mbl_write(), media_hangup(), mgcp_answer(), mgcp_call(), mgcp_fixup(), mgcp_get_codec(), mgcp_get_rtp_peer(), mgcp_hangup(), mgcp_indicate(), mgcp_read(), mgcp_senddigit_begin(), mgcp_senddigit_end(), mgcp_set_rtp_peer(), mgcp_ss(), mgcp_write(), mock_channel_hangup(), mock_channel_indicate(), mock_channel_read(), mock_channel_write(), mock_channel_write_stream(), my_get_sigpvt_bridged_channel(), native_bridge_is_capable(), native_chan_changed(), native_start(), native_stop(), nbs_call(), nbs_hangup(), nbs_xwrite(), ooh323_answer(), ooh323_call(), ooh323_digit_begin(), ooh323_digit_end(), ooh323_fixup(), ooh323_get_codec(), ooh323_get_rtp_peer(), ooh323_get_vrtp_peer(), ooh323_hangup(), ooh323_indicate(), ooh323_queryoption(), ooh323_read(), ooh323_set_rtp_peer(), ooh323_write(), oss_answer(), oss_call(), oss_fixup(), oss_hangup(), oss_indicate(), oss_read(), oss_write(), phone_answer(), phone_call(), phone_digit_end(), phone_exception(), phone_fixup(), phone_hangup(), phone_indicate(), phone_read(), phone_send_text(), phone_setup(), phone_write(), pjsip_acf_channel_read(), pjsip_acf_dtmf_mode_read(), pjsip_acf_dtmf_mode_write(), pjsip_acf_media_offer_read(), pjsip_acf_media_offer_write(), pjsip_acf_moh_passthrough_read(), pjsip_acf_moh_passthrough_write(), pjsip_acf_session_refresh_write(), push_notify_channel(), read_test(), rtp_call(), rtp_hangup(), rtp_read(), rtp_write(), send_direct_media_request(), sendtext_data_create(), sip_acf_channel_read(), sip_allow_anyrtp_remote(), sip_answer(), sip_call(), sip_cc_agent_init(), sip_dtmfmode(), sip_fixup(), sip_get_callid(), sip_get_rtp_peer(), sip_get_trtp_peer(), sip_get_vrtp_peer(), sip_hangup(), sip_indicate(), sip_queryoption(), sip_read(), sip_senddigit_begin(), sip_senddigit_end(), sip_sendhtml(), sip_sendtext(), sip_set_rtp_peer(), sip_setoption(), sip_transfer(), sip_write(), sipinfo_send(), skinny_answer(), skinny_call(), skinny_fixup(), skinny_get_rtp_peer(), skinny_get_vrtp_peer(), skinny_hangup(), skinny_indicate(), skinny_newcall(), skinny_read(), skinny_request(), skinny_set_rtp_peer(), skinny_write(), snoop_fixup(), snoop_hangup(), snoop_read(), snoop_write(), stasis_app_channel_unreal_set_internal(), t38_framehook(), test_bridging_chan_hangup(), test_bridging_chan_indicate(), unistim_answer(), unistim_call(), unistim_fixup(), unistim_get_rtp_peer(), unistim_hangup(), unistim_indicate(), unistim_read(), unistim_set_rtp_peer(), unistim_ss(), and unistim_write().
◆ ast_channel_tech_pvt_set()
| void ast_channel_tech_pvt_set | ( | struct ast_channel * | chan, |
| void * | value | ||
| ) |
Definition at line 569 of file channel_internal_api.c.
References ast_channel::tech_pvt, and value.
Referenced by alsa_hangup(), alsa_new(), ast_iax2_new(), AST_TEST_DEFINE(), ast_unreal_hangup(), ast_unreal_new_channels(), audiosocket_hangup(), audiosocket_request(), chan_pjsip_new(), channel_do_masquerade(), clear_session_and_channel(), console_hangup(), console_new(), dahdi_hangup(), dahdi_new(), destroy_dahdi_pvt(), dialog_unlink_all(), iax2_hangup(), iax2_predestroy(), jingle_hangup(), jingle_new(), kill_hangup(), make_channel(), mbl_hangup(), mbl_new(), mgcp_hangup(), mgcp_new(), mock_channel_hangup(), multicast_rtp_request(), my_on_hook(), nbs_hangup(), nbs_new(), onCallCleared(), ooh323_destroy(), ooh323_hangup(), ooh323_new(), oss_hangup(), oss_new(), phone_hangup(), phone_new(), rtp_hangup(), sip_hangup(), sip_new(), sip_pvt_dtor(), skinny_hangup(), skinny_new(), snoop_hangup(), stasis_app_control_snoop(), test_bridging_chan_hangup(), unicast_rtp_request(), unistim_hangup_clean(), and unistim_new().
◆ ast_channel_tech_set()
| void ast_channel_tech_set | ( | struct ast_channel * | chan, |
| const struct ast_channel_tech * | value | ||
| ) |
Definition at line 773 of file channel_internal_api.c.
References ast_assert, ast_channel_tech::read_stream, ast_channel::tech, value, and ast_channel_tech::write_stream.
Referenced by __ast_channel_alloc_ap(), alsa_new(), ast_iax2_new(), AST_TEST_DEFINE(), ast_unreal_new_channels(), audiosocket_request(), chan_pjsip_new(), channel_do_masquerade(), console_new(), create_alice_channel(), create_msg_q_chan(), dahdi_new(), do_notify(), jingle_new(), 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(), and unistim_new().
struct ast_frame *(*const read_stream)(struct ast_channel *chan)
Read a frame (or chain of frames from the same stream), in standard format (see frame.h), with stream num.
Definition: channel.h:748
int(*const write_stream)(struct ast_channel *chan, int stream_num, struct ast_frame *frame)
Write a frame on a specific stream, in standard format (see frame.h)
Definition: channel.h:754
◆ ast_channel_timer()
| struct ast_timer* ast_channel_timer | ( | const struct ast_channel * | chan | ) |
Definition at line 737 of file channel_internal_api.c.
Referenced by __ast_channel_alloc_ap(), __ast_queue_frame(), __ast_read(), ast_channel_destructor(), ast_deactivate_generator(), and ast_settimeout_full().
◆ ast_channel_timer_set()
| void ast_channel_timer_set | ( | struct ast_channel * | chan, |
| struct ast_timer * | value | ||
| ) |
Definition at line 741 of file channel_internal_api.c.
References value.
Referenced by __ast_channel_alloc_ap(), and ast_channel_destructor().
◆ ast_channel_timingdata()
| void* ast_channel_timingdata | ( | const struct ast_channel * | chan | ) |
Definition at line 573 of file channel_internal_api.c.
References ast_channel::timingdata.
Referenced by __ast_read(), and ast_settimeout_full().
◆ ast_channel_timingdata_set()
| void ast_channel_timingdata_set | ( | struct ast_channel * | chan, |
| void * | value | ||
| ) |
Definition at line 577 of file channel_internal_api.c.
References ast_channel::timingdata, and value.
Referenced by ast_settimeout_full().
◆ ast_channel_timingfd()
| int ast_channel_timingfd | ( | const struct ast_channel * | chan | ) |
Definition at line 469 of file channel_internal_api.c.
Referenced by __ast_channel_alloc_ap(), __ast_queue_frame(), __ast_read(), add_sdp(), ast_readaudio_callback(), ast_settimeout_full(), and channel_do_masquerade().
◆ ast_channel_timingfd_set()
| void ast_channel_timingfd_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 473 of file channel_internal_api.c.
References value.
Referenced by __ast_channel_alloc_ap(), and __ast_dummy_channel_alloc().
◆ ast_channel_timingfunc()
| ast_timing_func_t ast_channel_timingfunc | ( | const struct ast_channel * | chan | ) |
Definition at line 1231 of file channel_internal_api.c.
References ast_channel::timingfunc.
Referenced by __ast_read(), ast_read_generator_actions(), background_detect_exec(), dial_exec_full(), handle_speechrecognize(), speech_background(), wait_for_winner(), and waitstream_core().
◆ ast_channel_timingfunc_set()
| void ast_channel_timingfunc_set | ( | struct ast_channel * | chan, |
| ast_timing_func_t | value | ||
| ) |
Definition at line 1235 of file channel_internal_api.c.
References ast_channel::timingfunc, and value.
Referenced by ast_settimeout_full().
◆ ast_channel_topic()
| struct stasis_topic* ast_channel_topic | ( | struct ast_channel * | chan | ) |
A topic which publishes the events for a particular channel.
- Since
- 12 If the given chan is
NULL, ast_channel_topic_all() is returned.
- Parameters
-
chan Channel, or NULL.
- Return values
-
Topic for channel's events. ast_channel_topic_all() if chan is NULL.
Definition at line 1502 of file channel_internal_api.c.
References ast_channel_topic_all().
Referenced by ari_bridges_play_new(), ast_ari_bridges_record(), ast_channel_forward_endpoint(), ast_channel_internal_setup_topics(), ast_channel_publish_blob(), ast_channel_publish_cached_blob(), ast_channel_publish_final_snapshot(), ast_channel_publish_snapshot(), ast_monitor_start(), ast_monitor_stop(), ast_multi_object_blob_single_channel_publish(), AST_TEST_DEFINE(), forwards_create_channel(), local_optimization_finished_cb(), local_optimization_started_cb(), manager_mute_mixmonitor(), meetme_stasis_generate_msg(), mixmonitor_exec(), moh_post_start(), moh_post_stop(), phase_e_handler(), publish_chanspy_message(), publish_local_bridge_message(), publish_message_for_channel_topics(), queue_publish_multi_channel_blob(), report_fax_status(), report_receive_fax_status(), report_send_fax_status(), send_call_pickup_stasis_message(), send_conf_stasis(), stasis_app_control_publish(), stop_mixmonitor_full(), and talk_detect_audiohook_cb().
struct stasis_topic * ast_channel_topic_all(void)
A topic which publishes the events for all channels.
Definition: stasis_channels.c:128
◆ ast_channel_transfercapability()
| unsigned short ast_channel_transfercapability | ( | const struct ast_channel * | chan | ) |
Definition at line 501 of file channel_internal_api.c.
Referenced by ast_ari_channels_dial(), ast_var_channels_table(), begin_dial_prerun(), dahdi_call(), dial_exec_full(), func_channel_read(), misdn_call(), and ooh323_call().
◆ ast_channel_transfercapability_set()
| void ast_channel_transfercapability_set | ( | struct ast_channel * | chan, |
| unsigned short | value | ||
| ) |
Definition at line 505 of file channel_internal_api.c.
References value.
Referenced by ast_ari_channels_dial(), begin_dial_prerun(), cb_events(), dial_exec_full(), and func_channel_write_real().
◆ ast_channel_unbridged()
| int ast_channel_unbridged | ( | struct ast_channel * | chan | ) |
This function will check if the bridge needs to be re-evaluated due to external changes.
- Parameters
-
chan Channel on which to check the unbridge_eval flag
- Returns
- Returns 0 if the flag is down or 1 if the flag is up.
Definition at line 1019 of file channel_internal_api.c.
References ast_channel_lock, ast_channel_unbridged_nolock(), and ast_channel_unlock.
Referenced by ast_channel_is_leaving_bridge(), and bridge_channel_wait().
int ast_channel_unbridged_nolock(struct ast_channel *chan)
ast_channel_unbridged variant. Use this if the channel is already locked prior to calling...
Definition: channel_internal_api.c:1014
◆ ast_channel_unbridged_nolock()
| int ast_channel_unbridged_nolock | ( | struct ast_channel * | chan | ) |
ast_channel_unbridged variant. Use this if the channel is already locked prior to calling.
- Parameters
-
chan Channel on which to check the unbridge flag
- Returns
- Returns 0 if the flag is down or 1 if the flag is up.
Definition at line 1014 of file channel_internal_api.c.
Referenced by ast_channel_unbridged().
◆ ast_channel_undefer_dtmf()
| void ast_channel_undefer_dtmf | ( | struct ast_channel * | chan | ) |
Unset defer DTMF flag on channel.
Undo defer. ast_read will return any DTMF characters that were queued
Definition at line 1271 of file channel.c.
References ast_channel_clear_flag(), and AST_FLAG_DEFER_DTMF.
Referenced by __adsi_transmit_messages(), and find_cache().
void ast_channel_clear_flag(struct ast_channel *chan, unsigned int flag)
Definition: channel.c:11235
Definition: channel.h:982
◆ ast_channel_uniqueid()
| const char* ast_channel_uniqueid | ( | const struct ast_channel * | chan | ) |
Definition at line 305 of file channel_internal_api.c.
References ast_assert, ast_channel_id::unique_id, and ast_channel::uniqueid.
Referenced by __ast_change_name_nolink(), action_confbridgelist_item(), action_dahdishowchannels(), app_exec(), app_subscribe_channel(), app_unsubscribe_channel(), apply_negotiated_sdp_stream(), aqm_exec(), ari_channels_handle_originate_with_id(), ari_channels_handle_snoop_channel(), ast_ari_channels_create(), ast_attended_transfer_message_add_app(), ast_attended_transfer_message_add_link(), ast_attended_transfer_message_add_threeway(), ast_attended_transfer_message_create(), ast_blind_transfer_message_create(), ast_bridge_blob_create(), ast_bridge_publish_enter(), ast_bridge_set_single_src_video_mode(), ast_bridge_snapshot_create(), ast_bridge_transfer_blind(), ast_bridge_update_talker_src_video_mode(), ast_cel_publish_event(), ast_channel_by_uniqueid_cb(), ast_channel_log(), ast_channel_move(), ast_channel_publish_cached_blob(), ast_channel_publish_dial_internal(), ast_do_pickup(), ast_endpoint_add_channel(), ast_monitor_start(), ast_monitor_stop(), ast_str_retrieve_variable(), AST_TEST_DEFINE(), ast_var_channels_table(), blind_transfer_bridge(), bridge_channel_depart(), bridge_channel_snapshot_pair_init(), bridge_moh_create(), bridge_stasis_push_peek(), build_conf(), call(), chan_pjsip_fixup(), chan_pjsip_indicate(), chan_pjsip_new(), chan_pjsip_session_end(), channel_replaced_cb(), channel_snapshot_base_create(), conf_rec_name(), conf_run(), conf_send_event_to_participants(), create_parked_subscription_full(), fast_originate(), fax_session_new(), find_by_uniqueid(), find_conf_realtime(), forwards_create_channel(), func_channel_read(), generate_status(), handle_showchan(), internal_bridge_after_cb(), jingle_enable_video(), jingle_set_owner(), local_channel_optimization_blob(), local_optimization_started_cb(), manager_mute_mixmonitor(), manager_park(), manager_park_bridged(), manager_queues_status(), masq_match_cb(), meetme_menu_admin_extended(), meetmemute(), mgcp_set_owner(), minivm_mwi_exec(), mixmonitor_exec(), moh_post_start(), moh_post_stop(), multicast_rtp_request(), notify_new_message(), pack_channel_into_message(), park_and_announce_app_exec(), park_common_setup(), park_local_transfer(), parking_blind_transfer_park(), parking_park_bridge_channel(), phase_e_handler(), play_on_channel(), publish_chanspy_message(), publish_local_bridge_message(), queue_exec(), queue_stasis_data_alloc(), record_file(), refer_blind_callback(), report_fax_status(), report_receive_fax_status(), report_send_fax_status(), rna(), rqm_exec(), serialize_showchan(), setup_env(), setup_mixmonitor(), sfu_topologies_on_join(), sfu_topologies_on_source_change(), sip_set_owner(), skinny_set_owner(), softmix_bridge_stream_sources_update(), start_rtp(), stasis_app_bridge_playback_channel_add(), stasis_app_control_find_by_channel(), stasis_app_control_get_channel_id(), stasis_app_control_snoop(), stasis_app_exec(), stasis_app_subscribe_channel(), stop_mixmonitor_full(), talk_detect_audiohook_cb(), test_cel_generate_peer_str(), try_calling(), unicast_rtp_request(), unistim_set_owner(), vm_execmain(), wait_for_answer(), and wait_our_turn().
◆ ast_channel_unlink()
| void ast_channel_unlink | ( | struct ast_channel * | chan | ) |
Remove a channel from the global channels container.
- Parameters
-
chan channel to remove
In a case where it is desired that a channel not be available in any lookups in the global channels conatiner, use this function.
Definition at line 10730 of file channel.c.
References ao2_unlink.
Referenced by create_msg_q_chan().
◆ ast_channel_unregister()
| void ast_channel_unregister | ( | const struct ast_channel_tech * | tech | ) |
Unregister a channel technology.
- Parameters
-
tech Structure defining channel technology or "type" that was previously registered
- Returns
- No return value.
Unregister a channel technology.
Definition at line 570 of file channel.c.
References ast_debug, ast_free, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_END, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verb, chanlist::chan, chanlist::list, chanlist::tech, and ast_channel_tech::type.
Referenced by __unload_module(), AST_TEST_DEFINE(), channels_shutdown(), load_module(), local_shutdown(), unload_module(), and unregister_channel_tech().
struct chanlist::@369 list
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
#define AST_LIST_REMOVE_CURRENT(field)
Removes the current entry from a list during a traversal.
Definition: linkedlists.h:556
◆ ast_channel_unsuppress()
| 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.
- Note
- The channel should be locked before calling this function.
- Parameters
-
chan The channel to stop suppressing direction The direction in which to stop suppressing frametype The type of frame (AST_FRAME_VOICE, etc) to stop suppressing
- Return values
-
0 Success -1 Failure
Definition at line 11040 of file channel.c.
References ast_channel_datastore_find(), ast_channel_datastore_remove(), ast_datastore_free(), ast_framehook_detach(), ast_log, ast_datastore::data, suppress_data::direction, suppress_data::framehook_id, LOG_WARNING, NULL, and suppress_get_datastore_information().
Referenced by app_control_unmute(), and mute_channel().
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.
Definition: channel.c:2404
int ast_framehook_detach(struct ast_channel *chan, int framehook_id)
Detach an framehook from a channel.
Definition: framehook.c:177
static const struct ast_datastore_info * suppress_get_datastore_information(enum ast_frame_type frametype)
Definition: channel.c:10968
Definition: channel.c:10920
int ast_datastore_free(struct ast_datastore *datastore)
Free a data store object.
Definition: datastore.c:68
int ast_channel_datastore_remove(struct ast_channel *chan, struct ast_datastore *datastore)
Remove a datastore from a channel.
Definition: channel.c:2399
◆ ast_channel_update_connected_line()
| 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.
- Since
- 1.8
- Parameters
-
chan Asterisk channel to indicate connected line information connected Connected line information update What connected line information to update. NULL if all.
- Returns
- Nothing
Definition at line 9189 of file channel.c.
References ast_connected_line_build_data(), AST_CONTROL_CONNECTED_LINE, and ast_indicate_data().
Referenced by agent_run(), app_exec(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_do_pickup(), connectedline_write(), update_connected_line_from_peer(), and wait_for_answer().
int ast_indicate_data(struct ast_channel *chan, int _condition, const void *data, size_t datalen)
Indicates condition of channel, with payload.
Definition: channel.c:4698
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.
Definition: channel.c:8793
◆ ast_channel_update_redirecting()
| 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.
- Since
- 1.8
- Parameters
-
chan Asterisk channel to indicate redirecting id information redirecting Redirecting id information update What redirecting information to update. NULL if all.
- Returns
- Nothing
Definition at line 10379 of file channel.c.
References AST_CONTROL_REDIRECTING, ast_indicate_data(), and ast_redirecting_build_data().
Referenced by ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), blind_transfer_cb(), call_forward_inherit(), do_forward(), redirecting_write(), and wait_for_answer().
int ast_indicate_data(struct ast_channel *chan, int _condition, const void *data, size_t datalen)
Indicates condition of channel, with payload.
Definition: channel.c:4698
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.
Definition: channel.c:9363
◆ ast_channel_userfield()
| const char* ast_channel_userfield | ( | const struct ast_channel * | chan | ) |
Referenced by channel_snapshot_base_create(), and func_channel_read().
◆ ast_channel_varshead()
| struct varshead* ast_channel_varshead | ( | struct ast_channel * | chan | ) |
Definition at line 932 of file channel_internal_api.c.
References ast_channel::varshead.
Referenced by __ast_channel_alloc_ap(), __ast_dummy_channel_alloc(), ast_cel_fabricate_channel_from_event(), ast_channel_destructor(), ast_channel_get_vars(), ast_channel_inherit_variables(), ast_dummy_channel_destructor(), ast_str_retrieve_variable(), ast_str_substitute_variables_full(), AST_TEST_DEFINE(), ast_unreal_call_setup(), chan_cleanup(), clearvar_prefix(), clone_variables(), external_media_audiosocket_tcp(), external_media_rtp_udp(), generate_status(), handle_show_chanvar(), handle_showchan(), hashkeys_read(), hashkeys_read2(), inherit_channel_vars_from_id(), lua_get_variable(), lua_get_variable_value(), ospauth_exec(), ospfinished_exec(), osplookup_exec(), ospnext_exec(), pbx_builtin_getvar_helper(), pbx_builtin_pushvar_helper(), pbx_builtin_serialize_variables(), pbx_builtin_setvar_helper(), pbx_substitute_variables_helper(), pbx_substitute_variables_helper_full(), peek_read(), sip_call(), sip_removeheader(), skinny_call(), and transmit_invite().
◆ ast_channel_varshead_set()
| void ast_channel_varshead_set | ( | struct ast_channel * | chan, |
| struct varshead * | value | ||
| ) |
◆ ast_channel_visible_indication()
| int ast_channel_visible_indication | ( | const struct ast_channel * | chan | ) |
Definition at line 477 of file channel_internal_api.c.
Referenced by channel_do_masquerade(), and pre_bridge_setup().
◆ ast_channel_visible_indication_set()
| void ast_channel_visible_indication_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 481 of file channel_internal_api.c.
References value.
Referenced by dial_exec_full(), and indicate_data_internal().
◆ ast_channel_vstream()
| struct ast_filestream* ast_channel_vstream | ( | const struct ast_channel * | chan | ) |
Definition at line 629 of file channel_internal_api.c.
References ast_channel::vstream.
Referenced by ast_hangup(), ast_openvstream(), ast_stopstream(), and filehelper().
◆ ast_channel_vstream_set()
| void ast_channel_vstream_set | ( | struct ast_channel * | chan, |
| struct ast_filestream * | value | ||
| ) |
Definition at line 633 of file channel_internal_api.c.
References value, and ast_channel::vstream.
Referenced by ast_hangup(), ast_stopstream(), filehelper(), and filestream_close().
◆ ast_channel_vstreamid()
| int ast_channel_vstreamid | ( | const struct ast_channel * | chan | ) |
Definition at line 493 of file channel_internal_api.c.
Referenced by filestream_close().
◆ ast_channel_vstreamid_set()
| void ast_channel_vstreamid_set | ( | struct ast_channel * | chan, |
| int | value | ||
| ) |
Definition at line 497 of file channel_internal_api.c.
References value.
Referenced by __ast_channel_alloc_ap(), ast_readvideo_callback(), and filestream_close().
◆ ast_channel_whentohangup()
| struct timeval* ast_channel_whentohangup | ( | struct ast_channel * | chan | ) |
Definition at line 928 of file channel_internal_api.c.
References ast_channel::whentohangup.
Referenced by __ast_pbx_run(), ast_channel_cmpwhentohangup_tv(), ast_check_hangup(), ast_var_channels_table(), ast_waitfor_nandfds(), begin_dial_prerun(), dial_exec_full(), generate_status(), handle_showchan(), ring_entry(), serialize_showchan(), timeout_read(), and timeout_write().
◆ ast_channel_whentohangup_set()
| void ast_channel_whentohangup_set | ( | struct ast_channel * | chan, |
| struct timeval * | value | ||
| ) |
- Precondition
- chan is locked
Definition at line 968 of file channel_internal_api.c.
References value, and ast_channel::whentohangup.
Referenced by ast_channel_setwhentohangup_tv(), and dial_exec_full().
◆ ast_channel_writeformat()
| struct ast_format* ast_channel_writeformat | ( | struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 860 of file channel_internal_api.c.
Referenced by adsi_transmit_message_full(), agent_login_exec(), alarmreceiver_exec(), ast_bridge_channel_restore_formats(), ast_channel_start_silence_generator(), ast_channel_yank(), ast_openstream_full(), ast_read_generator_actions(), ast_set_write_format_path(), ast_streamfile(), ast_write_stream(), audiosocket_exec(), bridge_channel_internal_join(), chan_pjsip_read_stream(), chan_pjsip_write_stream(), channel_do_masquerade(), chanspy_exec(), dahdiscan_exec(), extenspy_exec(), fax_gateway_framehook(), filehelper(), func_channel_read(), generate_status(), generator_force(), generic_fax_exec(), handle_showchan(), handle_streamfile(), jingle_read(), jingle_write(), linear_alloc(), mgcp_rtp_read(), mgcp_write(), moh_alloc(), moh_files_alloc(), moh_files_write_format_change(), mp3_exec(), NBScat_exec(), ooh323_rtp_read(), ooh323_set_rtp_peer(), ooh323_set_write_format(), ooh323_write(), playtones_alloc(), process_sdp(), send_waveform_to_channel(), serialize_showchan(), set_caps(), sip_rtp_read(), sip_write(), skinny_rtp_read(), skinny_write(), socket_process_helper(), test_vm_api_create_mock_channel(), tonepair_alloc(), transmit_audio(), unistim_rtp_read(), and unistim_write().
◆ ast_channel_writetrans()
| struct ast_trans_pvt* ast_channel_writetrans | ( | const struct ast_channel * | chan | ) |
Definition at line 761 of file channel_internal_api.c.
References ast_channel::writetrans.
Referenced by __ast_read(), ast_channel_destructor(), ast_set_write_format_path(), ast_write_stream(), chan_pjsip_write_stream(), free_translation(), generate_status(), handle_showchan(), and serialize_showchan().
◆ ast_channel_writetrans_set()
| void ast_channel_writetrans_set | ( | struct ast_channel * | chan, |
| struct ast_trans_pvt * | value | ||
| ) |
Definition at line 765 of file channel_internal_api.c.
References value, and ast_channel::writetrans.
Referenced by ast_set_write_format_path(), and free_translation().
◆ ast_channel_yank()
| struct ast_channel* ast_channel_yank | ( | struct ast_channel * | yankee | ) |
Gain control of a channel in the system.
- Since
- 12 The intention of this function is to take a channel that currently is running in one thread and gain control of it in the current thread. This can be used to redirect a channel to a different place in the dialplan, for instance.
- Note
- This function is NOT intended to be used on bridged channels. If you need to control a bridged channel, you can set a callback to be called once the channel exits the bridge, and run your controlling logic in that callback
XXX Put name of callback-setting function in above paragraph once it is written
- Note
- When this function returns successfully, the yankee channel is in a state where it cannot be used any further. Always use the returned channel instead.
- absolutely NO channel locks should be held before calling this function.
- The dialplan location on the returned channel is where the channel should be started in the dialplan if it is returned to it.
- Parameters
-
yankee The channel to gain control of
- Return values
-
NULL Could not gain control of the channel non-NULL The channel
Definition at line 10794 of file channel.c.
References accountcode, amaflags, ao2_bump, ao2_cleanup, ast_channel_accountcode(), ast_channel_alloc, ast_channel_amaflags(), ast_channel_context(), ast_channel_exten(), ast_channel_flags(), ast_channel_lock, ast_channel_move(), ast_channel_name(), ast_channel_priority(), ast_channel_priority_set(), ast_channel_readformat(), ast_channel_set_readformat(), ast_channel_set_writeformat(), ast_channel_unlock, ast_channel_writeformat(), AST_FLAG_IN_AUTOLOOP, ast_hangup(), AST_STATE_DOWN, ast_strdupa, ast_test_flag, context, exten, name, ast_channel::name, NULL, and priority.
Referenced by ast_async_goto(), and ast_bridge_add_channel().
Definition: channelstate.h:36
void ast_channel_set_writeformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:840
int ast_channel_priority(const struct ast_channel *chan)
Definition: channel_internal_api.c:444
struct ast_format * ast_channel_readformat(struct ast_channel *chan)
Definition: channel_internal_api.c:856
const char * ast_channel_accountcode(const struct ast_channel *chan)
void ast_channel_set_readformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:836
const char * ast_channel_exten(const struct ast_channel *chan)
Definition: channel_internal_api.c:353
Definition: channel.h:998
const char * ast_channel_name(const struct ast_channel *chan)
const char * ast_channel_context(const struct ast_channel *chan)
Definition: channel_internal_api.c:344
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
int ast_channel_move(struct ast_channel *dest, struct ast_channel *source)
Move a channel from its current location to a new location.
Definition: channel.c:10867
void ast_channel_priority_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:448
#define ast_channel_alloc(needqueue, state, cid_num, cid_name, acctcode, exten, context, assignedids, requestor, amaflag,...)
Create a channel structure.
Definition: channel.h:1259
struct ast_format * ast_channel_writeformat(struct ast_channel *chan)
Definition: channel_internal_api.c:860
enum ama_flags ast_channel_amaflags(const struct ast_channel *chan)
Definition: channel_internal_api.c:406
◆ ast_channel_zone()
| struct ast_tone_zone* ast_channel_zone | ( | const struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 745 of file channel_internal_api.c.
References ast_channel::zone.
Referenced by ast_app_dtget(), ast_channel_destructor(), ast_control_tone(), ast_var_channels_table(), dial_handle_playtones(), dialtone_indicate(), func_channel_read(), func_channel_write_real(), handle_playtones(), indicate_data_internal(), pbx_builtin_waitexten(), play_dialtone(), read_exec(), and readexten_exec().
◆ ast_channel_zone_set()
| void ast_channel_zone_set | ( | struct ast_channel * | chan, |
| struct ast_tone_zone * | value | ||
| ) |
Definition at line 749 of file channel_internal_api.c.
References value, and ast_channel::zone.
Referenced by ast_channel_destructor(), chan_pjsip_new(), func_channel_write_real(), and sip_new().
◆ ast_channeltype_list()
| struct ast_variable* ast_channeltype_list | ( | void | ) |
return an ast_variable list of channeltypes
Definition at line 188 of file channel.c.
References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_variable_new, chanlist::list, NULL, chanlist::tech, and var.
Referenced by ast_var_channel_types(), and ast_var_channel_types_table().
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
Structure for variables, used for configurations and for channel variables.
Definition: include/asterisk/config.h:83
#define ast_variable_new(name, value, filename)
Definition: include/asterisk/config.h:914
◆ ast_check_hangup()
| int ast_check_hangup | ( | struct ast_channel * | chan | ) |
Check to see if a channel is needing hang up.
- Parameters
-
chan channel on which to check for hang up This function determines if the channel is being requested to be hung up.
- Returns
- Returns 0 if not, or 1 if hang up is requested (including time-out).
Check to see if a channel is needing hang up.
Definition at line 445 of file channel.c.
References ast_channel_name(), ast_channel_softhangup_internal_flag(), ast_channel_softhangup_internal_flag_add(), ast_channel_whentohangup(), ast_debug, AST_SOFTHANGUP_TIMEOUT, ast_test_suite_event_notify, ast_tvdiff_ms(), ast_tvnow(), and ast_tvzero().
Referenced by __ast_pbx_run(), __ast_read(), _macro_exec(), agent_request_exec(), agi_exec(), announce_thread(), app_exec(), ast_bridge_setup_after_goto(), ast_call(), ast_check_hangup_locked(), ast_indicate_data(), ast_raw_answer_with_stream_topology(), ast_readstring_full(), ast_recvtext(), ast_sendtext_data(), ast_transfer_protocol(), ast_unreal_fixup(), ast_waitfordigit_full(), ast_write_stream(), autoservice_run(), call_forward_inherit(), channel_spy(), common_exec(), conf_play(), conf_run(), confbridge_exec(), dahdi_sendtext(), dahdi_setoption(), depart_channel(), destroy_all_channels(), dial_exec_full(), directory_exec(), dundi_lookup_internal(), eagi_exec(), eivr_comm(), fax_gateway_framehook(), findmeexec(), func_channel_read(), gosub_run(), handle_sendimage(), iax2_key_rotate(), join_conference_bridge(), launch_asyncagi(), lua_check_hangup(), ospfinished_exec(), pbx_builtin_incomplete(), pbx_builtin_waitexten(), playback_exec(), read_exec(), readexten_exec(), run_agi(), run_ras(), stasis_app_exec(), transfer_target_framehook_cb(), try_calling(), and wait_for_answer().
451 if (ast_tvdiff_ms(*ast_channel_whentohangup(chan), ast_tvnow()) > 0) /* no if hangup time has not come yet. */
453 ast_debug(4, "Hangup time has come: %" PRIi64 "\n", ast_tvdiff_ms(*ast_channel_whentohangup(chan), ast_tvnow()));
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
int64_t ast_tvdiff_ms(struct timeval end, struct timeval start)
Computes the difference (in milliseconds) between two struct timeval instances.
Definition: time.h:98
struct timeval * ast_channel_whentohangup(struct ast_channel *chan)
Definition: channel_internal_api.c:928
Definition: channel.h:1139
int ast_channel_softhangup_internal_flag(struct ast_channel *chan)
Definition: channel_internal_api.c:997
const char * ast_channel_name(const struct ast_channel *chan)
void ast_channel_softhangup_internal_flag_add(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:1005
◆ ast_check_hangup_locked()
| int ast_check_hangup_locked | ( | struct ast_channel * | chan | ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 459 of file channel.c.
References ast_channel_lock, ast_channel_unlock, and ast_check_hangup().
Referenced by action_redirect(), agent_run(), ast_app_exec_macro(), ast_app_exec_sub(), ast_bridge_channel_feature_digit(), bridge_channel_handle_action(), bridge_reconfigured_connected_line_update(), bridge_stasis_run_cb(), bridgewait_exec(), dial_exec_full(), launch_asyncagi(), pbx_builtin_saynumber(), stasis_app_exec(), and wait_for_answer().
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
◆ ast_connected_line_build_data()
| 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.
- Since
- 1.8
- Parameters
-
data Buffer to fill with the frame data datalen Size of the buffer to fill connected Connected line information update What connected line information to build. NULL if all.
- Return values
-
-1 if error Amount of data buffer used
Definition at line 8793 of file channel.c.
References AST_CONNECTED_LINE_ID_PRESENTATION, AST_CONNECTED_LINE_NAME, AST_CONNECTED_LINE_NAME_CHAR_SET, AST_CONNECTED_LINE_NAME_PRESENTATION, AST_CONNECTED_LINE_NAME_VALID, AST_CONNECTED_LINE_NUMBER, AST_CONNECTED_LINE_NUMBER_PLAN, AST_CONNECTED_LINE_NUMBER_PRESENTATION, AST_CONNECTED_LINE_NUMBER_VALID, AST_CONNECTED_LINE_PRIV_NAME, AST_CONNECTED_LINE_PRIV_NAME_CHAR_SET, AST_CONNECTED_LINE_PRIV_NAME_PRESENTATION, AST_CONNECTED_LINE_PRIV_NAME_VALID, AST_CONNECTED_LINE_PRIV_NUMBER, AST_CONNECTED_LINE_PRIV_NUMBER_PLAN, AST_CONNECTED_LINE_PRIV_NUMBER_PRESENTATION, AST_CONNECTED_LINE_PRIV_NUMBER_VALID, AST_CONNECTED_LINE_PRIV_SUBADDRESS, AST_CONNECTED_LINE_PRIV_SUBADDRESS_ODD_EVEN, AST_CONNECTED_LINE_PRIV_SUBADDRESS_TYPE, AST_CONNECTED_LINE_PRIV_SUBADDRESS_VALID, AST_CONNECTED_LINE_PRIV_TAG, AST_CONNECTED_LINE_SOURCE, AST_CONNECTED_LINE_SUBADDRESS, AST_CONNECTED_LINE_SUBADDRESS_ODD_EVEN, AST_CONNECTED_LINE_SUBADDRESS_TYPE, AST_CONNECTED_LINE_SUBADDRESS_VALID, AST_CONNECTED_LINE_TAG, AST_CONNECTED_LINE_VERSION, ast_log, ast_party_connected_line::id, ast_set_party_connected_line::id, LOG_WARNING, ast_party_id_ies::name, NULL, party_id_build_data(), ast_party_connected_line::priv, ast_set_party_connected_line::priv, ast_party_connected_line::source, ast_party_name_ies::str, and value.
Referenced by after_bridge_move_channel(), ast_channel_queue_connected_line_update(), ast_channel_update_connected_line(), bridge_reconfigured_connected_line_update(), indicate_connected_line(), send_colp_to_agent(), and unreal_colp_redirect_indicate().
Definition: channel.c:8768
Definition: channel.c:8760
Definition: channel.c:8774
Definition: channel.c:8767
Definition: channel.c:8782
Definition: channel.c:8776
Definition: channel.c:8761
Definition: channel.c:8773
Definition: channel.c:8642
Definition: channel.c:8762
Definition: channel.c:8778
Definition: channel.c:8764
Definition: channel.c:8759
Definition: channel.c:8786
static int party_id_build_data(unsigned char *data, size_t datalen, const struct ast_party_id *id, const char *label, const struct ast_party_id_ies *ies, const struct ast_set_party_id *update)
Definition: channel.c:8673
Definition: channel.c:8783
Definition: channel.c:8758
Definition: channel.c:8763
Definition: channel.c:8790
◆ ast_connected_line_copy_from_caller()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination connected line information src Source caller information
- Returns
- Nothing
- Note
- Assumes locks are already acquired
Definition at line 8389 of file channel.c.
References ast_party_caller::ani, ast_party_connected_line::ani, ast_party_caller::ani2, ast_party_connected_line::ani2, ast_party_id_copy(), ast_party_caller::id, and ast_party_connected_line::id.
Referenced by after_bridge_move_channel(), agent_request_exec(), app_exec(), ast_ari_channels_dial(), ast_do_pickup(), ast_unreal_call_setup(), begin_dial_prerun(), bridge_reconfigured_connected_line_update(), copy_caller_data(), dial_exec_full(), do_forward(), findmeexec(), park_local_transfer(), ring_entry(), update_connected_line_from_peer(), and wait_for_answer().
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.
Definition: channel.c:1765
◆ ast_connected_line_copy_to_caller()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination caller information src Source connected line information
- Returns
- Nothing
- Note
- Assumes locks are already acquired
Definition at line 8396 of file channel.c.
References ast_party_caller::ani, ast_party_connected_line::ani, ast_party_caller::ani2, ast_party_connected_line::ani2, ast_party_id_copy(), ast_party_caller::id, and ast_party_connected_line::id.
Referenced by ast_unreal_call_setup(), and unreal_colp_redirect_indicate().
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.
Definition: channel.c:1765
◆ ast_connected_line_parse_data()
| 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.
- Since
- 1.8
- Parameters
-
data Buffer with the frame data to parse datalen Size of the buffer connected Extracted connected line information
- Return values
-
0 on success. -1 on error.
- Note
- The filled in connected line structure needs to be initialized by ast_party_connected_line_set_init() before calling. If defaults are not required use ast_party_connected_line_init().
- The filled in connected line structure needs to be destroyed by ast_party_connected_line_free() when it is no longer needed.
Definition at line 8881 of file channel.c.
References AST_CONNECTED_LINE_ID_PRESENTATION, AST_CONNECTED_LINE_NAME, AST_CONNECTED_LINE_NAME_CHAR_SET, AST_CONNECTED_LINE_NAME_PRESENTATION, AST_CONNECTED_LINE_NAME_VALID, AST_CONNECTED_LINE_NUMBER, AST_CONNECTED_LINE_NUMBER_PLAN, AST_CONNECTED_LINE_NUMBER_PRESENTATION, AST_CONNECTED_LINE_NUMBER_VALID, AST_CONNECTED_LINE_PRIV_NAME, AST_CONNECTED_LINE_PRIV_NAME_CHAR_SET, AST_CONNECTED_LINE_PRIV_NAME_PRESENTATION, AST_CONNECTED_LINE_PRIV_NAME_VALID, AST_CONNECTED_LINE_PRIV_NUMBER, AST_CONNECTED_LINE_PRIV_NUMBER_PLAN, AST_CONNECTED_LINE_PRIV_NUMBER_PRESENTATION, AST_CONNECTED_LINE_PRIV_NUMBER_VALID, AST_CONNECTED_LINE_PRIV_SUBADDRESS, AST_CONNECTED_LINE_PRIV_SUBADDRESS_ODD_EVEN, AST_CONNECTED_LINE_PRIV_SUBADDRESS_TYPE, AST_CONNECTED_LINE_PRIV_SUBADDRESS_VALID, AST_CONNECTED_LINE_PRIV_TAG, AST_CONNECTED_LINE_SOURCE, AST_CONNECTED_LINE_SUBADDRESS, AST_CONNECTED_LINE_SUBADDRESS_ODD_EVEN, AST_CONNECTED_LINE_SUBADDRESS_TYPE, AST_CONNECTED_LINE_SUBADDRESS_VALID, AST_CONNECTED_LINE_TAG, AST_CONNECTED_LINE_VERSION, ast_debug, ast_free, ast_log, ast_malloc, AST_PARTY_CHAR_SET_ISO8859_1, ast_party_name::char_set, ast_party_id_ies::combined_presentation, ast_party_connected_line::id, LOG_WARNING, ast_party_id::name, ast_party_id::number, ast_party_subaddress::odd_even_indicator, ast_party_number::plan, ast_party_name::presentation, ast_party_number::presentation, ast_party_connected_line::priv, ast_party_connected_line::source, ast_party_name::str, ast_party_number::str, ast_party_subaddress::str, ast_party_id::subaddress, ast_party_id::tag, ast_party_subaddress::type, ast_party_name::valid, ast_party_number::valid, ast_party_subaddress::valid, and value.
Referenced by __ast_read(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), indicate_connected_line(), socket_process_helper(), wait_for_answer(), and wait_for_winner().
8889 int got_combined_presentation = 0;/* TRUE if got a combined name and number presentation value. */
Definition: channel.c:8768
Definition: channel.c:8760
int presentation
Q.931 presentation-indicator and screening-indicator encoded fields.
Definition: channel.h:296
Definition: channel.c:8774
Definition: channel.c:8767
Definition: channel.c:8782
Definition: channel.c:8776
Definition: channel.c:8761
Definition: channel.c:8773
Definition: channel.c:8762
Definition: channel.c:8778
Definition: channel.c:8764
Definition: channel.c:8759
Definition: channel.c:8786
Definition: channel.c:8783
Definition: channel.c:8758
Definition: channel.c:8763
Definition: channel.c:8790
Definition: channel.h:245
◆ ast_deactivate_generator()
| void ast_deactivate_generator | ( | struct ast_channel * | chan | ) |
Deactivate an active generator
Definition at line 2902 of file channel.c.
References ast_channel_lock, ast_channel_timer(), ast_channel_unlock, ast_timer_set_rate(), deactivate_generator_nolock(), and should_trigger_dtmf_emulating().
Referenced by __ast_read(), app_exec(), ast_openstream_full(), ast_playtones_stop(), ast_read_generator_actions(), ast_tonepair_stop(), ast_write_stream(), cb_events(), channel_spy(), dial_exec_full(), generator_force(), local_ast_moh_stop(), old_milliwatt_exec(), sms_exec(), transmit_audio(), and wait_for_answer().
static int should_trigger_dtmf_emulating(struct ast_channel *chan)
Determine whether or not we have to trigger dtmf emulating using 50 fps timer events especially when ...
Definition: channel.c:2864
int ast_timer_set_rate(const struct ast_timer *handle, unsigned int rate)
Set the timing tick rate.
Definition: timing.c:166
static void deactivate_generator_nolock(struct ast_channel *chan)
Definition: channel.c:2886
struct ast_timer * ast_channel_timer(const struct ast_channel *chan)
Definition: channel_internal_api.c:737
◆ ast_fdisset()
|
inlinestatic |
Helper function for migrating select to poll.
Definition at line 2850 of file channel.h.
References dummy(), and ast_channel::x.
Referenced by do_monitor().
◆ ast_get_channel_tech()
| const struct ast_channel_tech* ast_get_channel_tech | ( | const char * | name | ) |
Get a channel technology structure by name.
- Parameters
-
name name of technology to find
- Returns
- a pointer to the structure, or NULL if no matching technology found
Get a channel technology structure by name.
Definition at line 592 of file channel.c.
References AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, chanlist::list, NULL, and chanlist::tech.
Referenced by __ast_channel_alloc_ap(), _ast_device_state(), ast_cc_callback(), ast_presence_state_helper(), and ast_var_channel_types_table().
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
Structure to describe a channel "technology", ie a channel driver See for examples: ...
Definition: channel.h:629
◆ ast_get_group()
| ast_group_t ast_get_group | ( | const char * | s | ) |
Definition at line 7718 of file channel.c.
References ast_log, ast_strdupa, ast_strlen_zero, c, LOG_ERROR, LOG_WARNING, and strsep().
Referenced by _parse(), build_device(), build_gateway(), build_peer(), config_parse_variables(), custom_group_handler(), func_channel_write_real(), group_handler(), and process_dahdi().
7737 ast_log(LOG_ERROR, "Syntax error parsing group configuration '%s' at '%s'. Ignoring.\n", s, piece);
Definition: func_dialgroup.c:84
char * strsep(char **str, const char *delims)
◆ ast_get_namedgroups()
| struct ast_namedgroups* ast_get_namedgroups | ( | const char * | s | ) |
Create an ast_namedgroups set with group names from comma separated string.
Remove leading and trailing whitespace
Definition at line 7775 of file channel.c.
References AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_alloc_options, ao2_container_alloc_hash, ao2_container_count(), ao2_find, ao2_link, ao2_ref, ast_skip_blanks(), ast_str_hash(), ast_strdupa, ast_strip(), ast_strlen_zero, ast_trim_blanks(), c, namedgroup_member::hash, len(), namedgroup_member::name, namedgroup_cmp_cb(), namedgroup_hash_cb(), NULL, OBJ_NODATA, OBJ_POINTER, OBJ_UNLINK, and strsep().
Referenced by _parse(), build_peer(), config_parse_variables(), func_channel_write_real(), named_groups_handler(), and process_dahdi().
int ao2_container_count(struct ao2_container *c)
Returns the number of elements in a container.
Definition: astobj2_container.c:34
Definition: astobj2.h:369
Definition: astobj2.h:1048
#define ao2_alloc_options(data_size, destructor_fn, options)
Definition: astobj2.h:406
Definition: astobj2.h:1043
Definition: app_queue.c:1592
static int namedgroup_hash_cb(const void *obj, const int flags)
Hashing function used for named group container.
Definition: channel.c:7768
#define ao2_container_alloc_hash(ao2_options, container_options, n_buckets, hash_fn, sort_fn, cmp_fn)
Definition: astobj2.h:1310
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
Definition: func_strings.c:1344
char * ast_skip_blanks(const char *str)
Gets a pointer to the first non-whitespace character in a string.
Definition: strings.h:157
char * ast_trim_blanks(char *str)
Trims trailing whitespace characters from a string.
Definition: strings.h:182
static int namedgroup_cmp_cb(void *obj, void *arg, int flags)
Comparison function used for named group container.
Definition: channel.c:7759
char * strsep(char **str, const char *delims)
static force_inline int attribute_pure ast_str_hash(const char *str)
Compute a hash value on a string.
Definition: strings.h:1206
◆ ast_hangup()
| void ast_hangup | ( | struct ast_channel * | chan | ) |
Hang up a channel.
- Note
- Absolutely NO channel locks should be held before calling this function.
- This function performs a hard hangup on a channel. Unlike the soft-hangup, this function performs all stream stopping, etc, on the channel that needs to end. chan is no longer valid after this call.
- Parameters
-
chan channel to hang up (NULL tolerant)
- Returns
- Nothing
Hang up a channel.
Definition at line 2548 of file channel.c.
References ao2_ref, ao2_unlink, ast_assert, ast_autoservice_stop(), ast_cc_offer(), ast_channel_blocker_tid(), ast_channel_blockproc(), ast_channel_flags(), ast_channel_generator(), ast_channel_generator_set(), ast_channel_generatordata(), ast_channel_generatordata_set(), ast_channel_lock, ast_channel_masq(), ast_channel_masqr(), ast_channel_name(), ast_channel_sched(), ast_channel_sched_set(), ast_channel_stream(), ast_channel_stream_set(), ast_channel_tech(), ast_channel_unlock, ast_channel_unref, ast_channel_vstream(), ast_channel_vstream_set(), ast_closestream(), ast_debug, AST_FLAG_BLOCKING, AST_FLAG_ZOMBIE, ast_get_tid(), ast_log, ast_pbx_hangup_handler_run(), ast_sched_context_destroy(), ast_set_flag, ast_test_flag, CHANNEL_DEADLOCK_AVOIDANCE, destroy_hooks(), free_translation(), ast_channel_tech::hangup, hangup(), LOG_WARNING, NULL, and ast_generator::release.
Referenced by __analog_handle_event(), __analog_ss_thread(), __ast_pbx_run(), __ast_request_and_dial(), alloc_playback_chan(), alsa_new(), analog_handle_init_event(), analog_ss_thread(), announce_request(), announce_to_dial(), answer_exec_run(), ari_bridges_play_new(), ast_ari_bridges_record(), ast_async_goto(), ast_autoservice_chan_hangup_peer(), ast_bridge_add_channel(), ast_bridge_run_after_goto(), ast_call_forward(), ast_channel_yank(), ast_dial_destroy(), ast_dial_hangup(), ast_iax2_new(), ast_pbx_outgoing_exten_predial(), AST_TEST_DEFINE(), ast_unreal_hangup(), attended_transfer_bridge(), begin_dial_channel(), blind_transfer_bridge(), bridge_channel_control_thread(), bridge_moh_create(), build_conf(), call_pickup_incoming_request(), chan_data_destroy(), chan_pjsip_new(), chanavail_exec(), clear_caller(), conf_free(), conf_run(), conf_start_record(), console_new(), create_msg_q_chan(), dahdi_handle_event(), dahdi_new(), destroy_conference_bridge(), dial_exec_full(), do_forward(), do_hang(), do_monitor(), do_monitor_headset(), feature_attended_transfer(), generic_recall(), handle_call_forward(), handle_call_outgoing(), handle_frame(), handle_hd_hf(), handle_init_event(), handle_invite_replaces(), handle_request_invite(), handle_soft_key_event_message(), handle_timeout_trip(), hangup_chan(), hangup_channel(), hangup_playback(), hangupcalls(), hanguptree(), iax2_request(), jingle_action_session_initiate(), local_call(), make_channel(), mbl_ast_hangup(), media_request_helper(), meetme_menu_admin_extended(), mgcp_new(), mgcp_ss(), moh_channel_thread(), monitor_dial(), mwi_thread(), my_distinctive_ring(), my_handle_notify_message(), nbs_new(), ooh323_new(), oss_new(), park_local_transfer(), parking_blind_transfer_park(), pbx_outgoing_exec(), pbx_start_incoming_request(), phone_new(), push_announcer(), read_test(), recalling_exit(), refer_incoming_invite_request(), request_channel(), retransfer_enter(), safe_hangup(), setsubstate(), sip_new(), sip_pickup_thread(), skinny_new(), snoop_stasis_thread(), stasis_app_control_snoop(), unistim_new(), and wait_for_answer().
2611 ast_log(LOG_WARNING, "Hard hangup called by thread LWP %d on %s, while blocked by thread LWP %d in procedure %s! Expect a failure\n",
const char * ast_channel_blockproc(const struct ast_channel *chan)
Definition: channel_internal_api.c:326
struct ast_filestream * ast_channel_vstream(const struct ast_channel *chan)
Definition: channel_internal_api.c:629
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
static void free_translation(struct ast_channel *clonechan)
Definition: channel.c:2492
void ast_channel_generator_set(struct ast_channel *chan, struct ast_generator *value)
Definition: channel_internal_api.c:717
void ast_channel_vstream_set(struct ast_channel *chan, struct ast_filestream *value)
Definition: channel_internal_api.c:633
int(*const hangup)(struct ast_channel *chan)
Hangup (and possibly destroy) the channel.
Definition: channel.h:705
int ast_channel_blocker_tid(const struct ast_channel *chan)
Definition: channel_internal_api.c:1222
Definition: channel.h:986
void ast_channel_stream_set(struct ast_channel *chan, struct ast_filestream *value)
Definition: channel_internal_api.c:625
void ast_channel_generatordata_set(struct ast_channel *chan, void *value)
Definition: channel_internal_api.c:553
void(* release)(struct ast_channel *chan, void *data)
Definition: channel.h:229
int ast_autoservice_stop(struct ast_channel *chan)
Stop servicing a channel for us...
Definition: autoservice.c:266
struct ast_sched_context * ast_channel_sched(const struct ast_channel *chan)
Definition: channel_internal_api.c:729
struct ast_generator * ast_channel_generator(const struct ast_channel *chan)
Definition: channel_internal_api.c:713
struct ast_channel * ast_channel_masq(const struct ast_channel *chan)
Definition: channel_internal_api.c:597
Definition: channel.h:988
struct ast_filestream * ast_channel_stream(const struct ast_channel *chan)
Definition: channel_internal_api.c:621
int ast_pbx_hangup_handler_run(struct ast_channel *chan)
Run all hangup handlers on the channel.
Definition: pbx_hangup_handler.c:58
const char * ast_channel_name(const struct ast_channel *chan)
void ast_channel_sched_set(struct ast_channel *chan, struct ast_sched_context *value)
Definition: channel_internal_api.c:733
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
struct ast_channel * ast_channel_masqr(const struct ast_channel *chan)
Definition: channel_internal_api.c:605
void ast_sched_context_destroy(struct ast_sched_context *c)
destroys a schedule context
Definition: sched.c:269
◆ ast_indicate()
| int ast_indicate | ( | struct ast_channel * | chan, |
| int | condition | ||
| ) |
Indicates condition of channel.
- Note
- Absolutely NO channel locks should be held before calling this function.
- Indicate a condition such as AST_CONTROL_BUSY, AST_CONTROL_RINGING, or AST_CONTROL_CONGESTION on a channel
- Parameters
-
chan channel to change the indication condition which condition to indicate on the channel
- Returns
- Returns 0 on success, -1 on failure
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 4322 of file channel.c.
References ast_indicate_data(), and NULL.
Referenced by __ast_play_and_record(), alsa_call(), answer_trunk_chan(), app_control_dtmf(), app_control_hold(), app_control_moh_start(), app_control_ring(), app_control_ring_stop(), app_control_silence_start(), app_control_unhold(), app_exec(), ast_bridge_channel_feature_digit(), ast_bridge_set_single_src_video_mode(), ast_bridge_update_talker_src_video_mode(), ast_raw_answer_with_stream_topology(), bridge_channel_do_callback(), bridge_channel_event_join_leave(), bridge_channel_handle_action(), bridge_channel_handle_control(), bridge_channel_handle_interval(), bridge_channel_internal_join(), caller_joined_bridge(), channel_do_masquerade(), cli_console_answer(), conf_run(), console_call(), dial_exec_full(), dial_trunk(), disa_exec(), do_forward(), dtmf_stream(), handle_frame(), handle_recordfile(), indicate_busy(), indicate_congestion(), mf_stream(), mgcp_ss(), monitor_dial(), oss_call(), participant_entertainment_start(), participant_entertainment_stop(), pbx_builtin_incomplete(), pbx_builtin_proceeding(), pbx_builtin_progress(), pbx_builtin_ringing(), pbx_builtin_waitexten(), play_on_channel(), pre_bridge_setup(), queue_exec(), record_exec(), rna(), say_periodic_announcement(), say_position(), send_waveform_to_channel(), sla_handle_hold_event(), sla_station_exec(), sla_trunk_exec(), softmix_bridge_join(), try_calling(), valid_priv_reply(), vm_exec(), and wait_for_answer().
int ast_indicate_data(struct ast_channel *chan, int _condition, const void *data, size_t datalen)
Indicates condition of channel, with payload.
Definition: channel.c:4698
◆ ast_indicate_data()
| int ast_indicate_data | ( | struct ast_channel * | chan, |
| int | condition, | ||
| const void * | data, | ||
| size_t | datalen | ||
| ) |
Indicates condition of channel, with payload.
- Note
- Absolutely NO channel locks should be held before calling this function.
- Indicate a condition such as AST_CONTROL_HOLD with payload being music on hold class
- Parameters
-
chan channel to change the indication condition which condition to indicate on the channel data pointer to payload data datalen size of payload data
- Returns
- Returns 0 on success, -1 on failure
Definition at line 4698 of file channel.c.
References ast_channel_flags(), ast_channel_framehooks(), ast_channel_is_leaving_bridge(), ast_channel_lock, ast_channel_unlock, ast_check_hangup(), AST_CONTROL_MASQUERADE_NOTIFY, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, ast_framehook_list_is_empty(), ast_framehook_list_write_event(), ast_frdup, ast_frfree, ast_test_flag, ast_frame::data, ast_frame::datalen, ast_frame::frametype, indicate_data_internal(), ast_frame_subclass::integer, NULL, ast_frame::ptr, and ast_frame::subclass.
Referenced by __ast_read(), action_aocmessage(), app_exec(), ast_channel_update_connected_line(), ast_channel_update_redirecting(), ast_handle_cc_control_frame(), ast_indicate(), bridge_channel_handle_control(), bridge_channel_internal_join(), channel_do_masquerade(), dial_exec_full(), disable_t38(), fax_gateway_indicate_t38(), generic_fax_exec(), handle_frame(), participant_entertainment_start(), pbx_builtin_waitexten(), receivefax_t38_init(), sendfax_t38_init(), set_fax_t38_caps(), transmit_audio(), transmit_t38(), wait_for_answer(), and wait_for_winner().
4701 /* this frame is used by framehooks. if it is set, we must free it at the end of this function */
4719 .data.ptr = (void *) data, /* this cast from const is only okay because we do the ast_frdup below */
struct ast_framehook_list * ast_channel_framehooks(const struct ast_channel *chan)
Definition: channel_internal_api.c:705
int ast_framehook_list_is_empty(struct ast_framehook_list *framehooks)
Determine if an framehook list is empty or not.
Definition: framehook.c:274
static int indicate_data_internal(struct ast_channel *chan, int _condition, const void *data, size_t datalen)
Definition: channel.c:4515
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
Definition: include/asterisk/frame.h:105
struct ast_frame * ast_framehook_list_write_event(struct ast_framehook_list *framehooks, struct ast_frame *frame)
This is used by the channel API push a frame write event to a channel's framehook list...
Definition: framehook.c:313
Definition: channel.h:988
int ast_channel_is_leaving_bridge(struct ast_channel *chan)
Determine if a channel is leaving a bridge, but not hung up.
Definition: channel.c:10751
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
union ast_frame::@263 data
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ ast_is_deferrable_frame()
| int ast_is_deferrable_frame | ( | const struct ast_frame * | frame | ) |
Should we keep this frame for later?
There are functions such as ast_safe_sleep which will service a channel to ensure that it does not have a large backlog of queued frames. When this happens, we want to hold on to specific frame types and just drop others. This function will tell if the frame we just read should be held onto.
- Parameters
-
frame The frame we just read
- Return values
-
1 frame should be kept 0 frame should be dropped
Definition at line 1467 of file channel.c.
References 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, and ast_frame::frametype.
Referenced by ast_bridge_channel_queue_frame(), autoservice_run(), and safe_sleep_conditional().
Definition: include/asterisk/frame.h:137
Definition: include/asterisk/frame.h:114
Definition: include/asterisk/frame.h:101
Definition: include/asterisk/frame.h:118
Definition: include/asterisk/frame.h:116
Definition: include/asterisk/frame.h:135
Definition: include/asterisk/frame.h:107
Definition: include/asterisk/frame.h:105
Definition: include/asterisk/frame.h:123
Definition: include/asterisk/frame.h:99
Definition: include/asterisk/frame.h:121
Definition: include/asterisk/frame.h:125
Definition: include/asterisk/frame.h:103
Definition: include/asterisk/frame.h:109
◆ ast_namedgroups_intersect()
| 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.
Definition at line 8192 of file channel.c.
References ao2_callback, ao2_cleanup, ao2_container_count(), match(), namedgroup_match(), NULL, and SWAP.
Referenced by find_channel_by_group().
int ao2_container_count(struct ao2_container *c)
Returns the number of elements in a container.
Definition: astobj2_container.c:34
static int match(struct ast_sockaddr *addr, unsigned short callno, unsigned short dcallno, const struct chan_iax2_pvt *cur, int check_dcallno)
Definition: chan_iax2.c:2315
static int namedgroup_match(void *obj, void *arg, int flags)
Definition: channel.c:8182
◆ ast_party_caller_copy()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination caller src Source caller
- Returns
- Nothing
Definition at line 1986 of file channel.c.
References ast_party_caller::ani, ast_party_caller::ani2, ast_party_id_copy(), ast_party_caller::id, and ast_party_caller::priv.
Referenced by recalling_enter().
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.
Definition: channel.c:1765
◆ ast_party_caller_free()
| void ast_party_caller_free | ( | struct ast_party_caller * | doomed | ) |
Destroy the caller party contents.
- Since
- 1.8
- Parameters
-
doomed The caller party to destroy.
- Returns
- Nothing
Definition at line 2015 of file channel.c.
References ast_party_caller::ani, ast_party_id_free(), ast_party_caller::id, and ast_party_caller::priv.
Referenced by ast_channel_destructor(), ast_dummy_channel_destructor(), callerid_write(), dial_trunk(), and sla_ring_station().
void ast_party_id_free(struct ast_party_id *doomed)
Destroy the party id contents.
Definition: channel.c:1811
◆ ast_party_caller_init()
| void ast_party_caller_init | ( | struct ast_party_caller * | init | ) |
Initialize the given caller structure.
- Since
- 1.8
- Parameters
-
init Caller structure to initialize.
- Returns
- Nothing
Definition at line 1978 of file channel.c.
References ast_party_caller::ani, ast_party_caller::ani2, ast_party_id_init(), ast_party_caller::id, and ast_party_caller::priv.
Referenced by __ast_channel_alloc_ap(), dial_trunk(), queue_connected_line_update(), sla_ring_station(), and vm_allocate_dh().
void ast_party_id_init(struct ast_party_id *init)
Initialize the given party id structure.
Definition: channel.c:1757
◆ ast_party_caller_set()
| 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.
- Since
- 1.8
This is similar to ast_party_caller_copy, except that NULL values for strings in the src parameter indicate not to update the corresponding dest values.
- Parameters
-
dest The caller one wishes to update src The new caller values to update the dest update What caller information to update. NULL if all.
- Returns
- Nada
Definition at line 2007 of file channel.c.
References ast_party_caller::ani, ast_set_party_caller::ani, ast_party_caller::ani2, ast_party_id_set(), ast_party_caller::id, ast_set_party_caller::id, NULL, ast_party_caller::priv, and ast_set_party_caller::priv.
Referenced by ast_channel_set_caller(), ast_channel_set_caller_event(), and callerid_write().
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.
Definition: channel.c:1788
◆ ast_party_caller_set_init()
| 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.
- Since
- 1.8
The initialization is needed to allow a set operation to know if a value needs to be updated. Simple integers need the guide's original value in case the set operation is not trying to set a new value. String values are simply set to NULL pointers if they are not going to be updated.
- Parameters
-
init Caller structure to initialize. guide Source caller to use as a guide in initializing.
- Returns
- Nothing
Definition at line 1999 of file channel.c.
References ast_party_caller::ani, ast_party_caller::ani2, ast_party_id_set_init(), ast_party_caller::id, and ast_party_caller::priv.
Referenced by callerid_write(), dial_exec_full(), do_forward(), misdn_update_caller_id(), and ring_entry().
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.
Definition: channel.c:1780
◆ ast_party_connected_line_collect_caller()
| 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.
- Since
- 1.8
- Parameters
-
connected Collected caller information for the connected line caller Caller information.
- Returns
- Nothing
- Warning
- This is a shallow copy.
- DO NOT call ast_party_connected_line_free() on the filled in connected line structure!
Definition at line 2063 of file channel.c.
References ast_party_caller::ani, ast_party_connected_line::ani, ast_party_caller::ani2, ast_party_connected_line::ani2, AST_CONNECTED_LINE_UPDATE_SOURCE_UNKNOWN, ast_party_caller::id, ast_party_connected_line::id, ast_party_caller::priv, ast_party_connected_line::priv, and ast_party_connected_line::source.
◆ ast_party_connected_line_copy()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination connected line src Source connected line
- Returns
- Nothing
Definition at line 2031 of file channel.c.
References ast_party_connected_line::ani, ast_party_connected_line::ani2, ast_party_id_copy(), ast_party_connected_line::id, ast_party_connected_line::priv, and ast_party_connected_line::source.
Referenced by __ast_read(), after_bridge_move_channel(), agent_login_channel_config(), ast_call_forward(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_do_pickup(), attended_transfer_properties_alloc(), dial_exec_full(), do_forward(), indicate_connected_line(), recalling_enter(), retransfer_enter(), try_calling(), and wait_for_answer().
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.
Definition: channel.c:1765
◆ ast_party_connected_line_free()
| void ast_party_connected_line_free | ( | struct ast_party_connected_line * | doomed | ) |
Destroy the connected line information contents.
- Since
- 1.8
- Parameters
-
doomed The connected line information to destroy.
- Returns
- Nothing
Definition at line 2072 of file channel.c.
References ast_party_connected_line::ani, ast_party_id_free(), ast_party_connected_line::id, and ast_party_connected_line::priv.
Referenced by __ast_read(), after_bridge_move_channel(), agent_login_channel_config(), agent_pvt_destructor(), agent_request_exec(), app_exec(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_channel_destructor(), ast_do_pickup(), ast_dummy_channel_destructor(), attended_transfer_properties_destructor(), bridge_reconfigured_connected_line_update(), callattempt_free(), chanlist_free(), connectedline_write(), destroy_calling_node(), indicate_connected_line(), socket_process_helper(), update_connected_line_from_peer(), wait_for_answer(), and wait_for_winner().
void ast_party_id_free(struct ast_party_id *doomed)
Destroy the party id contents.
Definition: channel.c:1811
◆ ast_party_connected_line_init()
| void ast_party_connected_line_init | ( | struct ast_party_connected_line * | init | ) |
Initialize the given connected line structure.
- Since
- 1.8
- Parameters
-
init Connected line structure to initialize.
- Returns
- Nothing
Definition at line 2022 of file channel.c.
References ast_party_connected_line::ani, ast_party_connected_line::ani2, AST_CONNECTED_LINE_UPDATE_SOURCE_UNKNOWN, ast_party_id_init(), ast_party_connected_line::id, ast_party_connected_line::priv, and ast_party_connected_line::source.
Referenced by __ast_channel_alloc_ap(), __ast_read(), after_bridge_move_channel(), agent_login_channel_config(), agent_pvt_new(), agent_request_exec(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_do_pickup(), bridge_reconfigured_connected_line_update(), do_forward(), handle_request_invite(), handle_request_update(), handle_response_invite(), misdn_queue_connected_line_update(), onAlerting(), onCallEstablished(), onProgress(), queue_connected_line_update(), sip_call(), socket_process_helper(), update_connected_line_from_peer(), and update_initial_connected_line().
void ast_party_id_init(struct ast_party_id *init)
Initialize the given party id structure.
Definition: channel.c:1757
◆ ast_party_connected_line_set()
| 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.
- Since
- 1.8 This is similar to ast_party_connected_line_copy, except that NULL values for strings in the src parameter indicate not to update the corresponding dest values.
- Parameters
-
dest The connected line one wishes to update src The new connected line values to update the dest update What connected line information to update. NULL if all.
- Returns
- Nothing
Definition at line 2054 of file channel.c.
References ast_party_connected_line::ani, ast_set_party_connected_line::ani, ast_party_connected_line::ani2, ast_party_id_set(), ast_party_connected_line::id, ast_set_party_connected_line::id, NULL, ast_party_connected_line::priv, ast_set_party_connected_line::priv, and ast_party_connected_line::source.
Referenced by ast_channel_set_connected_line(), wait_for_answer(), and wait_for_winner().
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.
Definition: channel.c:1788
◆ ast_party_connected_line_set_init()
| 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.
- Since
- 1.8
The initialization is needed to allow a set operation to know if a value needs to be updated. Simple integers need the guide's original value in case the set operation is not trying to set a new value. String values are simply set to NULL pointers if they are not going to be updated.
- Parameters
-
init Connected line structure to initialize. guide Source connected line to use as a guide in initializing.
- Returns
- Nothing
Definition at line 2045 of file channel.c.
References ast_party_connected_line::ani, ast_party_connected_line::ani2, ast_party_id_set_init(), ast_party_connected_line::id, ast_party_connected_line::priv, and ast_party_connected_line::source.
Referenced by __ast_request_and_dial(), ari_channels_handle_originate_with_id(), connectedline_write(), dial_exec_full(), indicate_connected_line(), pbx_outgoing_attempt(), wait_for_answer(), and wait_for_winner().
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.
Definition: channel.c:1780
◆ ast_party_dialed_copy()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination dialed party src Source dialed party
- Returns
- Nothing
Definition at line 1936 of file channel.c.
References ast_free, ast_party_subaddress_copy(), ast_strdup, ast_party_dialed::number, ast_party_dialed::plan, ast_party_dialed::str, ast_party_dialed::subaddress, and ast_party_dialed::transit_network_select.
Referenced by ast_unreal_call_setup().
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. ...
Definition: channel.c:1705
◆ ast_party_dialed_free()
| void ast_party_dialed_free | ( | struct ast_party_dialed * | doomed | ) |
Destroy the dialed party contents.
- Since
- 1.8
- Parameters
-
doomed The dialed party to destroy.
- Returns
- Nothing
Definition at line 1971 of file channel.c.
References ast_free, ast_party_subaddress_free(), NULL, ast_party_dialed::number, ast_party_dialed::str, and ast_party_dialed::subaddress.
Referenced by ast_channel_destructor(), ast_dummy_channel_destructor(), and callerid_write().
void ast_party_subaddress_free(struct ast_party_subaddress *doomed)
Destroy the party subaddress contents.
Definition: channel.c:1744
◆ ast_party_dialed_init()
| void ast_party_dialed_init | ( | struct ast_party_dialed * | init | ) |
Initialize the given dialed structure.
- Since
- 1.8
- Parameters
-
init Dialed structure to initialize.
- Returns
- Nothing
Definition at line 1928 of file channel.c.
References ast_party_subaddress_init(), NULL, ast_party_dialed::number, ast_party_dialed::plan, ast_party_dialed::str, ast_party_dialed::subaddress, and ast_party_dialed::transit_network_select.
Referenced by __ast_channel_alloc_ap().
void ast_party_subaddress_init(struct ast_party_subaddress *init)
Initialize the given subaddress structure.
Definition: channel.c:1697
◆ ast_party_dialed_set()
| 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.
- Since
- 1.8
This is similar to ast_party_dialed_copy, except that NULL values for strings in the src parameter indicate not to update the corresponding dest values.
- Parameters
-
dest The dialed one wishes to update src The new dialed values to update the dest
- Returns
- Nada
Definition at line 1958 of file channel.c.
References ast_free, ast_party_subaddress_set(), ast_strdup, ast_party_dialed::number, ast_party_dialed::plan, ast_party_dialed::str, ast_party_dialed::subaddress, and ast_party_dialed::transit_network_select.
Referenced by callerid_write().
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.
Definition: channel.c:1727
◆ ast_party_dialed_set_init()
| 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.
- Since
- 1.8
The initialization is needed to allow a set operation to know if a value needs to be updated. Simple integers need the guide's original value in case the set operation is not trying to set a new value. String values are simply set to NULL pointers if they are not going to be updated.
- Parameters
-
init Caller structure to initialize. guide Source dialed to use as a guide in initializing.
- Returns
- Nothing
Definition at line 1950 of file channel.c.
References ast_party_subaddress_set_init(), NULL, ast_party_dialed::number, ast_party_dialed::plan, ast_party_dialed::str, ast_party_dialed::subaddress, and ast_party_dialed::transit_network_select.
Referenced by callerid_write().
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...
Definition: channel.c:1719
◆ ast_party_id_copy()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination party id src Source party id
- Returns
- Nothing
Definition at line 1765 of file channel.c.
References ast_free, ast_party_name_copy(), ast_party_number_copy(), ast_party_subaddress_copy(), ast_strdup, ast_party_id::name, ast_party_id::number, ast_party_id::subaddress, and ast_party_id::tag.
Referenced by ast_connected_line_copy_from_caller(), ast_connected_line_copy_to_caller(), ast_party_caller_copy(), ast_party_connected_line_copy(), ast_party_id_merge_copy(), ast_party_redirecting_copy(), ast_sip_session_create_outgoing(), caller_id_incoming_request(), caller_id_outgoing_request(), caller_id_outgoing_response(), chan_pjsip_new(), copy_redirecting_id(), queue_connected_line_update(), set_from_header(), and update_initial_connected_line().
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.
Definition: channel.c:1652
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. ...
Definition: channel.c:1705
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.
Definition: channel.c:1599
◆ ast_party_id_free()
| void ast_party_id_free | ( | struct ast_party_id * | doomed | ) |
Destroy the party id contents.
- Since
- 1.8
- Parameters
-
doomed The party id to destroy.
- Returns
- Nothing
Definition at line 1811 of file channel.c.
References ast_free, ast_party_name_free(), ast_party_number_free(), ast_party_subaddress_free(), ast_party_id::name, NULL, ast_party_id::number, ast_party_id::subaddress, and ast_party_id::tag.
Referenced by ast_party_caller_free(), ast_party_connected_line_free(), ast_party_id_reset(), ast_party_redirecting_free(), caller_id_outgoing_request(), caller_id_outgoing_response(), endpoint_destructor(), session_destructor(), set_from_header(), and update_incoming_connected_line().
void ast_party_number_free(struct ast_party_number *doomed)
Destroy the party number contents.
Definition: channel.c:1691
void ast_party_subaddress_free(struct ast_party_subaddress *doomed)
Destroy the party subaddress contents.
Definition: channel.c:1744
void ast_party_name_free(struct ast_party_name *doomed)
Destroy the party name contents.
Definition: channel.c:1638
◆ ast_party_id_init()
| void ast_party_id_init | ( | struct ast_party_id * | init | ) |
Initialize the given party id structure.
- Since
- 1.8
- Parameters
-
init Party id structure to initialize.
- Returns
- Nothing
Definition at line 1757 of file channel.c.
References ast_party_name_init(), ast_party_number_init(), ast_party_subaddress_init(), ast_party_id::name, NULL, ast_party_id::number, ast_party_id::subaddress, and ast_party_id::tag.
Referenced by ast_party_caller_init(), ast_party_connected_line_init(), ast_party_id_reset(), ast_party_redirecting_init(), ast_sip_endpoint_alloc(), ast_sip_session_alloc(), caller_id_outgoing_request(), caller_id_outgoing_response(), dial_exec_full(), set_from_header(), and update_incoming_connected_line().
void ast_party_name_init(struct ast_party_name *init)
Initialize the given name structure.
Definition: channel.c:1591
void ast_party_subaddress_init(struct ast_party_subaddress *init)
Initialize the given subaddress structure.
Definition: channel.c:1697
void ast_party_number_init(struct ast_party_number *init)
Initialize the given number structure.
Definition: channel.c:1644
◆ ast_party_id_invalidate()
| void ast_party_id_invalidate | ( | struct ast_party_id * | id | ) |
◆ ast_party_id_merge()
| 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.
- Since
- 11.0
This function will generate an effective party id.
Each party id component of the party id 'base' is overwritten by components of the party id 'overlay' if the overlay component is marked as valid. However the component 'tag' of the base party id remains untouched.
- Parameters
-
base The party id which is merged. overlay The party id which is used to merge into.
- Returns
- The merged party id as a struct, not as a pointer.
- Note
- The merged party id returned is a shallow copy and must not be freed.
Definition at line 1902 of file channel.c.
References ast_party_id::name.
Referenced by ast_channel_connected_effective_id(), ast_channel_redirecting_effective_from(), ast_channel_redirecting_effective_orig(), ast_channel_redirecting_effective_to(), and ast_party_id_merge_copy().
◆ ast_party_id_merge_copy()
| 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.
- Since
- 11.0
Each party id component of the party id 'base' is overwritten by components of the party id 'overlay' if the 'overlay' component is marked as valid. However the component 'tag' of the 'base' party id remains untouched. The result is copied into the given party id 'dest'.
- Note
- The resulting merged party id is a real copy and has to be freed.
- Parameters
-
dest The resulting merged party id. base The party id which is merged. overlay The party id which is used to merge into.
- Returns
- Nothing
Definition at line 1920 of file channel.c.
References ast_party_id_copy(), and ast_party_id_merge().
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.
Definition: channel.c:1902
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.
Definition: channel.c:1765
◆ ast_party_id_presentation()
| int ast_party_id_presentation | ( | const struct ast_party_id * | id | ) |
Determine the overall presentation value for the given party.
- Since
- 1.8
- Parameters
-
id Party to determine the overall presentation value.
- Returns
- Overall presentation value for the given party.
Definition at line 1821 of file channel.c.
References AST_PRES_ALLOWED, AST_PRES_NUMBER_NOT_AVAILABLE, AST_PRES_NUMBER_TYPE, AST_PRES_RESTRICTED, AST_PRES_RESTRICTION, AST_PRES_UNAVAILABLE, AST_PRES_USER_NUMBER_UNSCREENED, ast_party_id::name, ast_party_id::number, ast_party_name::valid, and ast_party_number::valid.
Referenced by add_id_headers(), add_privacy_header(), add_privacy_params(), add_rpid(), ast_json_party_id(), ast_str_retrieve_variable(), ast_var_channels_table(), channel_snapshot_caller_create(), iax2_call(), initreqprep(), is_colp_update_allowed(), my_on_hook(), party_id_build_data(), party_id_read(), push_callinfo(), redirecting_read(), send_callinfo(), set_from_header(), setsubstate(), setup_env(), sip_call(), and socket_process_helper().
◆ ast_party_id_reset()
| void ast_party_id_reset | ( | struct ast_party_id * | id | ) |
Destroy and initialize the given party id structure.
- Since
- 11.0
- Parameters
-
id The party id to reset.
- Returns
- Nothing
Definition at line 1896 of file channel.c.
References ast_party_id_free(), and ast_party_id_init().
Referenced by after_bridge_move_channel(), ast_do_pickup(), cb_events(), channel_do_masquerade(), misdn_facility_ie_handler(), and retransfer_enter().
void ast_party_id_free(struct ast_party_id *doomed)
Destroy the party id contents.
Definition: channel.c:1811
void ast_party_id_init(struct ast_party_id *init)
Initialize the given party id structure.
Definition: channel.c:1757
◆ ast_party_id_set()
| 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.
- Since
- 1.8
- Parameters
-
dest The id one wishes to update src The new id values to update the dest update What id information to update. NULL if all.
- Returns
- Nothing
Definition at line 1788 of file channel.c.
References ast_free, ast_party_name_set(), ast_party_number_set(), ast_party_subaddress_set(), ast_strdup, ast_party_id::name, ast_set_party_id::name, ast_party_id::number, ast_set_party_id::number, ast_party_id::subaddress, ast_set_party_id::subaddress, and ast_party_id::tag.
Referenced by ast_party_caller_set(), ast_party_connected_line_set(), and ast_party_redirecting_set().
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.
Definition: channel.c:1621
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.
Definition: channel.c:1727
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.
Definition: channel.c:1674
◆ ast_party_id_set_init()
| 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.
- Since
- 1.8
The initialization is needed to allow a set operation to know if a value needs to be updated. Simple integers need the guide's original value in case the set operation is not trying to set a new value. String values are simply set to NULL pointers if they are not going to be updated.
- Parameters
-
init Party id structure to initialize. guide Source party id to use as a guide in initializing.
- Returns
- Nothing
Definition at line 1780 of file channel.c.
References ast_party_name_set_init(), ast_party_number_set_init(), ast_party_subaddress_set_init(), ast_party_id::name, NULL, ast_party_id::number, ast_party_id::subaddress, and ast_party_id::tag.
Referenced by ast_party_caller_set_init(), ast_party_connected_line_set_init(), ast_party_redirecting_set_init(), and dial_exec_full().
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...
Definition: channel.c:1666
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...
Definition: channel.c:1719
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.
Definition: channel.c:1613
◆ ast_party_name_copy()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination party name src Source party name
- Returns
- Nothing
Definition at line 1599 of file channel.c.
References ast_free, ast_strdup, ast_party_name::char_set, ast_party_name::presentation, ast_party_name::str, and ast_party_name::valid.
Referenced by ast_party_id_copy().
◆ ast_party_name_free()
| void ast_party_name_free | ( | struct ast_party_name * | doomed | ) |
Destroy the party name contents.
- Since
- 1.8
- Parameters
-
doomed The party name to destroy.
- Returns
- Nothing
Definition at line 1638 of file channel.c.
References ast_free, NULL, and ast_party_name::str.
Referenced by __analog_ss_thread(), analog_ss_thread(), ast_party_id_free(), and skinny_newcall().
◆ ast_party_name_init()
| void ast_party_name_init | ( | struct ast_party_name * | init | ) |
Initialize the given name structure.
- Since
- 1.8
- Parameters
-
init Name structure to initialize.
- Returns
- Nothing
Definition at line 1591 of file channel.c.
References AST_PARTY_CHAR_SET_ISO8859_1, AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED, ast_party_name::char_set, NULL, ast_party_name::presentation, ast_party_name::str, and ast_party_name::valid.
Referenced by __analog_ss_thread(), analog_ss_thread(), ast_party_id_init(), and skinny_newcall().
#define AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED
Definition: callerid.h:329
Definition: channel.h:245
◆ ast_party_name_set()
| 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.
- Since
- 1.8
- Parameters
-
dest The name one wishes to update src The new name values to update the dest
- Returns
- Nothing
Definition at line 1621 of file channel.c.
References ast_free, ast_strdup, ast_party_name::char_set, ast_party_name::presentation, ast_party_name::str, and ast_party_name::valid.
Referenced by ast_party_id_set().
◆ ast_party_name_set_init()
| 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.
- Since
- 1.8
The initialization is needed to allow a set operation to know if a value needs to be updated. Simple integers need the guide's original value in case the set operation is not trying to set a new value. String values are simply set to NULL pointers if they are not going to be updated.
- Parameters
-
init Party name structure to initialize. guide Source party name to use as a guide in initializing.
- Returns
- Nothing
Definition at line 1613 of file channel.c.
References ast_party_name::char_set, NULL, ast_party_name::presentation, ast_party_name::str, and ast_party_name::valid.
Referenced by ast_party_id_set_init().
◆ ast_party_number_copy()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination party number src Source party number
- Returns
- Nothing
Definition at line 1652 of file channel.c.
References ast_free, ast_strdup, ast_party_number::plan, ast_party_number::presentation, ast_party_number::str, and ast_party_number::valid.
Referenced by ast_party_id_copy().
int presentation
Q.931 presentation-indicator and screening-indicator encoded fields.
Definition: channel.h:296
◆ ast_party_number_free()
| void ast_party_number_free | ( | struct ast_party_number * | doomed | ) |
Destroy the party number contents.
- Since
- 1.8
- Parameters
-
doomed The party number to destroy.
- Returns
- Nothing
Definition at line 1691 of file channel.c.
References ast_free, NULL, and ast_party_number::str.
Referenced by __analog_ss_thread(), analog_ss_thread(), ast_party_id_free(), do_forward(), skinny_newcall(), and wait_for_answer().
◆ ast_party_number_init()
| void ast_party_number_init | ( | struct ast_party_number * | init | ) |
Initialize the given number structure.
- Since
- 1.8
- Parameters
-
init Number structure to initialize.
- Returns
- Nothing
Definition at line 1644 of file channel.c.
References AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED, NULL, ast_party_number::plan, ast_party_number::presentation, ast_party_number::str, and ast_party_number::valid.
Referenced by __analog_ss_thread(), analog_ss_thread(), ast_party_id_init(), do_forward(), skinny_newcall(), and wait_for_answer().
int presentation
Q.931 presentation-indicator and screening-indicator encoded fields.
Definition: channel.h:296
#define AST_PRES_ALLOWED_USER_NUMBER_NOT_SCREENED
Definition: callerid.h:329
◆ ast_party_number_set()
| 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.
- Since
- 1.8
- Parameters
-
dest The number one wishes to update src The new number values to update the dest
- Returns
- Nothing
Definition at line 1674 of file channel.c.
References ast_free, ast_strdup, ast_party_number::plan, ast_party_number::presentation, ast_party_number::str, and ast_party_number::valid.
Referenced by ast_party_id_set().
int presentation
Q.931 presentation-indicator and screening-indicator encoded fields.
Definition: channel.h:296
◆ ast_party_number_set_init()
| 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.
- Since
- 1.8
The initialization is needed to allow a set operation to know if a value needs to be updated. Simple integers need the guide's original value in case the set operation is not trying to set a new value. String values are simply set to NULL pointers if they are not going to be updated.
- Parameters
-
init Party number structure to initialize. guide Source party number to use as a guide in initializing.
- Returns
- Nothing
Definition at line 1666 of file channel.c.
References NULL, ast_party_number::plan, ast_party_number::presentation, ast_party_number::str, and ast_party_number::valid.
Referenced by ast_party_id_set_init().
int presentation
Q.931 presentation-indicator and screening-indicator encoded fields.
Definition: channel.h:296
◆ ast_party_redirecting_copy()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination redirecting src Source redirecting
- Returns
- Nothing
Definition at line 2135 of file channel.c.
References ast_party_id_copy(), ast_party_redirecting_reason_copy(), ast_party_redirecting::count, ast_party_redirecting::from, ast_party_redirecting::orig, ast_party_redirecting::orig_reason, ast_party_redirecting::priv_from, ast_party_redirecting::priv_orig, ast_party_redirecting::priv_to, ast_party_redirecting::reason, and ast_party_redirecting::to.
Referenced by ast_ari_channels_dial(), ast_call_forward(), ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), ast_unreal_call_setup(), begin_dial_prerun(), call_forward_inherit(), cb_events(), dial_exec_full(), do_forward(), misdn_facility_ie_handler(), ring_entry(), and wait_for_answer().
struct ast_party_id priv_to
Call is redirecting to a new party (Sent to the caller) - private representation. ...
Definition: channel.h:540
struct ast_party_id priv_orig
Who originally redirected the call (Sent to the party the call is redirected toward) - private repres...
Definition: channel.h:534
struct ast_party_id from
Who is redirecting the call (Sent to the party the call is redirected toward)
Definition: channel.h:528
struct ast_party_id priv_from
Who is redirecting the call (Sent to the party the call is redirected toward) - private representatio...
Definition: channel.h:537
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.
Definition: channel.c:1765
struct ast_party_id orig
Who originally redirected the call (Sent to the party the call is redirected toward) ...
Definition: channel.h:525
struct ast_party_redirecting_reason orig_reason
Reason for the redirection by the original party.
Definition: channel.h:546
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.
Definition: channel.c:2085
struct ast_party_id to
Call is redirecting to a new party (Sent to the caller)
Definition: channel.h:531
◆ ast_party_redirecting_free()
| void ast_party_redirecting_free | ( | struct ast_party_redirecting * | doomed | ) |
Destroy the redirecting information contents.
- Since
- 1.8
- Parameters
-
doomed The redirecting information to destroy.
- Returns
- Nothing
Definition at line 2179 of file channel.c.
References ast_party_id_free(), ast_party_redirecting_reason_free(), ast_party_redirecting::from, ast_party_redirecting::orig, ast_party_redirecting::orig_reason, ast_party_redirecting::priv_from, ast_party_redirecting::priv_orig, ast_party_redirecting::priv_to, ast_party_redirecting::reason, and ast_party_redirecting::to.
Referenced by ast_channel_destructor(), ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), ast_dummy_channel_destructor(), call_forward_inherit(), cb_events(), do_forward(), handle_request_invite(), handle_request_refer(), handle_response(), handle_response_invite(), indicate_redirecting(), misdn_facility_ie_handler(), redirecting_write(), set_redirecting(), and wait_for_answer().
struct ast_party_id priv_to
Call is redirecting to a new party (Sent to the caller) - private representation. ...
Definition: channel.h:540
struct ast_party_id priv_orig
Who originally redirected the call (Sent to the party the call is redirected toward) - private repres...
Definition: channel.h:534
struct ast_party_id from
Who is redirecting the call (Sent to the party the call is redirected toward)
Definition: channel.h:528
struct ast_party_id priv_from
Who is redirecting the call (Sent to the party the call is redirected toward) - private representatio...
Definition: channel.h:537
void ast_party_id_free(struct ast_party_id *doomed)
Destroy the party id contents.
Definition: channel.c:1811
void ast_party_redirecting_reason_free(struct ast_party_redirecting_reason *doomed)
Destroy the redirecting reason contents.
Definition: channel.c:2116
struct ast_party_id orig
Who originally redirected the call (Sent to the party the call is redirected toward) ...
Definition: channel.h:525
struct ast_party_redirecting_reason orig_reason
Reason for the redirection by the original party.
Definition: channel.h:546
struct ast_party_id to
Call is redirecting to a new party (Sent to the caller)
Definition: channel.h:531
◆ ast_party_redirecting_init()
| void ast_party_redirecting_init | ( | struct ast_party_redirecting * | init | ) |
Initialize the given redirecting structure.
- Since
- 1.8
- Parameters
-
init Redirecting structure to initialize.
- Returns
- Nothing
Definition at line 2122 of file channel.c.
References ast_party_id_init(), ast_party_redirecting_reason_init(), ast_party_redirecting::count, ast_party_redirecting::from, ast_party_redirecting::orig, ast_party_redirecting::orig_reason, ast_party_redirecting::priv_from, ast_party_redirecting::priv_orig, ast_party_redirecting::priv_to, ast_party_redirecting::reason, and ast_party_redirecting::to.
Referenced by __ast_channel_alloc_ap(), ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), call_forward_inherit(), cb_events(), do_forward(), handle_request_invite(), handle_request_refer(), handle_response(), handle_response_invite(), misdn_facility_ie_handler(), set_redirecting(), and wait_for_answer().
struct ast_party_id priv_to
Call is redirecting to a new party (Sent to the caller) - private representation. ...
Definition: channel.h:540
struct ast_party_id priv_orig
Who originally redirected the call (Sent to the party the call is redirected toward) - private repres...
Definition: channel.h:534
struct ast_party_id from
Who is redirecting the call (Sent to the party the call is redirected toward)
Definition: channel.h:528
struct ast_party_id priv_from
Who is redirecting the call (Sent to the party the call is redirected toward) - private representatio...
Definition: channel.h:537
struct ast_party_id orig
Who originally redirected the call (Sent to the party the call is redirected toward) ...
Definition: channel.h:525
void ast_party_redirecting_reason_init(struct ast_party_redirecting_reason *init)
Initialize the given redirecting reason structure.
Definition: channel.c:2079
struct ast_party_redirecting_reason orig_reason
Reason for the redirection by the original party.
Definition: channel.h:546
struct ast_party_id to
Call is redirecting to a new party (Sent to the caller)
Definition: channel.h:531
void ast_party_id_init(struct ast_party_id *init)
Initialize the given party id structure.
Definition: channel.c:1757
◆ ast_party_redirecting_reason_copy()
| 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.
- Parameters
-
dest Destination redirecting reason src Source redirecting reason
- Returns
- Nothing
Definition at line 2085 of file channel.c.
References ast_free, ast_strdup, ast_party_redirecting_reason::code, and ast_party_redirecting_reason::str.
Referenced by ast_party_redirecting_copy().
◆ ast_party_redirecting_reason_free()
| void ast_party_redirecting_reason_free | ( | struct ast_party_redirecting_reason * | doomed | ) |
Destroy the redirecting reason contents.
- Parameters
-
doomed The redirecting reason to destroy.
- Returns
- Nothing
Definition at line 2116 of file channel.c.
References ast_free, and ast_party_redirecting_reason::str.
Referenced by ast_party_redirecting_free().
◆ ast_party_redirecting_reason_init()
| void ast_party_redirecting_reason_init | ( | struct ast_party_redirecting_reason * | init | ) |
Initialize the given redirecting reason structure.
- Parameters
-
init Redirecting reason structure to initialize
- Returns
- Nothing
Definition at line 2079 of file channel.c.
References AST_REDIRECTING_REASON_UNKNOWN, ast_party_redirecting_reason::code, NULL, and ast_party_redirecting_reason::str.
Referenced by ast_party_redirecting_init().
Definition: callerid.h:391
◆ ast_party_redirecting_reason_set()
| 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.
This is similar to ast_party_redirecting_reason_copy, except that NULL values for strings in the src parameter indicate not to update the corresponding dest values.
- Parameters
-
dest The redirecting reason one wishes to update src The new redirecting reason values to update the dest
- Returns
- Nothing
Definition at line 2102 of file channel.c.
References ast_free, ast_strdup, ast_party_redirecting_reason::code, and ast_party_redirecting_reason::str.
Referenced by ast_party_redirecting_set().
◆ ast_party_redirecting_reason_set_init()
| 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.
The initialization is needed to allow a set operation to know if a value needs to be updated. Simple integers need the guide's original value in case the set operation is not trying to set a new value. String values are simply set to NULL pointers if they are not going to be updated.
- Parameters
-
init Redirecting reason structure to initialize. guide Source redirecting reason to use as a guide in initializing.
- Returns
- Nothing
Definition at line 2096 of file channel.c.
References ast_party_redirecting_reason::code, NULL, and ast_party_redirecting_reason::str.
Referenced by ast_party_redirecting_set_init().
◆ ast_party_redirecting_set()
| 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.
- Since
- 1.8
This is similar to ast_party_redirecting_copy, except that NULL values for strings in the src parameter indicate not to update the corresponding dest values.
- Parameters
-
dest The redirecting one wishes to update src The new redirecting values to update the dest update What redirecting information to update. NULL if all.
- Returns
- Nothing
Definition at line 2166 of file channel.c.
References ast_party_id_set(), ast_party_redirecting_reason_set(), ast_party_redirecting::count, ast_party_redirecting::from, ast_set_party_redirecting::from, NULL, ast_party_redirecting::orig, ast_set_party_redirecting::orig, ast_party_redirecting::orig_reason, ast_party_redirecting::priv_from, ast_set_party_redirecting::priv_from, ast_party_redirecting::priv_orig, ast_set_party_redirecting::priv_orig, ast_party_redirecting::priv_to, ast_set_party_redirecting::priv_to, ast_party_redirecting::reason, ast_party_redirecting::to, and ast_set_party_redirecting::to.
Referenced by ast_channel_set_redirecting().
struct ast_party_id priv_to
Call is redirecting to a new party (Sent to the caller) - private representation. ...
Definition: channel.h:540
struct ast_party_id priv_orig
Who originally redirected the call (Sent to the party the call is redirected toward) - private repres...
Definition: channel.h:534
struct ast_party_id from
Who is redirecting the call (Sent to the party the call is redirected toward)
Definition: channel.h:528
struct ast_party_id priv_from
Who is redirecting the call (Sent to the party the call is redirected toward) - private representatio...
Definition: channel.h:537
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.
Definition: channel.c:2102
struct ast_party_id orig
Who originally redirected the call (Sent to the party the call is redirected toward) ...
Definition: channel.h:525
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.
Definition: channel.c:1788
struct ast_party_redirecting_reason orig_reason
Reason for the redirection by the original party.
Definition: channel.h:546
struct ast_party_id to
Call is redirecting to a new party (Sent to the caller)
Definition: channel.h:531
◆ ast_party_redirecting_set_init()
| 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.
- Since
- 1.8
The initialization is needed to allow a set operation to know if a value needs to be updated. Simple integers need the guide's original value in case the set operation is not trying to set a new value. String values are simply set to NULL pointers if they are not going to be updated.
- Parameters
-
init Redirecting id structure to initialize. guide Source redirecting id to use as a guide in initializing.
- Returns
- Nothing
Definition at line 2153 of file channel.c.
References ast_party_id_set_init(), ast_party_redirecting_reason_set_init(), ast_party_redirecting::count, ast_party_redirecting::from, ast_party_redirecting::orig, ast_party_redirecting::orig_reason, ast_party_redirecting::priv_from, ast_party_redirecting::priv_orig, ast_party_redirecting::priv_to, ast_party_redirecting::reason, and ast_party_redirecting::to.
Referenced by handle_response_invite(), indicate_redirecting(), misdn_copy_redirecting_to_ast(), and redirecting_write().
struct ast_party_id priv_to
Call is redirecting to a new party (Sent to the caller) - private representation. ...
Definition: channel.h:540
struct ast_party_id priv_orig
Who originally redirected the call (Sent to the party the call is redirected toward) - private repres...
Definition: channel.h:534
struct ast_party_id from
Who is redirecting the call (Sent to the party the call is redirected toward)
Definition: channel.h:528
struct ast_party_id priv_from
Who is redirecting the call (Sent to the party the call is redirected toward) - private representatio...
Definition: channel.h:537
struct ast_party_id orig
Who originally redirected the call (Sent to the party the call is redirected toward) ...
Definition: channel.h:525
struct ast_party_redirecting_reason orig_reason
Reason for the redirection by the original party.
Definition: channel.h:546
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...
Definition: channel.c:2096
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.
Definition: channel.c:1780
struct ast_party_id to
Call is redirecting to a new party (Sent to the caller)
Definition: channel.h:531
◆ ast_party_subaddress_copy()
| 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.
- Since
- 1.8
- Parameters
-
dest Destination party subaddress src Source party subaddress
- Returns
- Nothing
Definition at line 1705 of file channel.c.
References ast_free, ast_strdup, ast_party_subaddress::odd_even_indicator, ast_party_subaddress::str, ast_party_subaddress::type, and ast_party_subaddress::valid.
Referenced by ast_party_dialed_copy(), and ast_party_id_copy().
◆ ast_party_subaddress_free()
| void ast_party_subaddress_free | ( | struct ast_party_subaddress * | doomed | ) |
Destroy the party subaddress contents.
- Since
- 1.8
- Parameters
-
doomed The party subaddress to destroy.
- Returns
- Nothing
Definition at line 1744 of file channel.c.
References ast_free, NULL, and ast_party_subaddress::str.
Referenced by ast_party_dialed_free(), and ast_party_id_free().
◆ ast_party_subaddress_init()
| void ast_party_subaddress_init | ( | struct ast_party_subaddress * | init | ) |
Initialize the given subaddress structure.
- Since
- 1.8
- Parameters
-
init Subaddress structure to initialize.
- Returns
- Nothing
Definition at line 1697 of file channel.c.
References NULL, ast_party_subaddress::odd_even_indicator, ast_party_subaddress::str, ast_party_subaddress::type, and ast_party_subaddress::valid.
Referenced by ast_party_dialed_init(), and ast_party_id_init().
◆ ast_party_subaddress_set()
| 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.
- Since
- 1.8
- Parameters
-
dest The subaddress one wishes to update src The new subaddress values to update the dest
- Returns
- Nothing
Definition at line 1727 of file channel.c.
References ast_free, ast_strdup, ast_party_subaddress::odd_even_indicator, ast_party_subaddress::str, ast_party_subaddress::type, and ast_party_subaddress::valid.
Referenced by ast_party_dialed_set(), and ast_party_id_set().
◆ ast_party_subaddress_set_init()
| 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.
- Since
- 1.8
The initialization is needed to allow a set operation to know if a value needs to be updated. Simple integers need the guide's original value in case the set operation is not trying to set a new value. String values are simply set to NULL pointers if they are not going to be updated.
- Parameters
-
init Party subaddress structure to initialize. guide Source party subaddress to use as a guide in initializing.
- Returns
- Nothing
Definition at line 1719 of file channel.c.
References NULL, ast_party_subaddress::odd_even_indicator, ast_party_subaddress::str, ast_party_subaddress::type, and ast_party_subaddress::valid.
Referenced by ast_party_dialed_set_init(), and ast_party_id_set_init().
◆ ast_pre_call()
| int ast_pre_call | ( | struct ast_channel * | chan, |
| const char * | sub_args | ||
| ) |
Execute a Gosub call on the channel before a call is placed.
- Since
- 11.0
This is called between ast_request() and ast_call() to execute a predial routine on the newly created channel.
- Parameters
-
chan Channel to execute Gosub. sub_args Gosub application parameter string.
- Note
- Absolutely NO channel locks should be held before calling this function.
- Return values
-
0 on success. -1 on error.
Definition at line 6536 of file channel.c.
References ast_app_exec_sub(), ast_channel_lock, ast_channel_tech(), ast_channel_unlock, chanlist::chan, NULL, and ast_channel_tech::pre_call.
Referenced by begin_dial_prerun(), dial_exec_full(), findmeexec(), and ring_entry().
int(* pre_call)(struct ast_channel *chan, const char *sub_args)
Execute a Gosub call on the channel in a technology specific way before a call is placed...
Definition: channel.h:842
int ast_app_exec_sub(struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const char *sub_args, int ignore_hangup)
Run a subroutine on a channel, placing an optional second channel into autoservice.
Definition: main/app.c:370
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_print_group()
| char* ast_print_group | ( | char * | buf, |
| int | buflen, | ||
| ast_group_t | group | ||
| ) |
Print call and pickup groups into buffer.
Print call and pickup groups into buffer.
Definition at line 8133 of file channel.c.
Referenced by _sip_show_peer(), _skinny_show_line(), callgroup_to_str(), func_channel_read(), function_sippeer(), misdn_cfg_get_config_string(), pickupgroup_to_str(), print_group(), read_config(), and serialize_showchan().
Definition: func_dialgroup.c:84
◆ ast_print_namedgroups()
| char* ast_print_namedgroups | ( | struct ast_str ** | buf, |
| struct ast_namedgroups * | groups | ||
| ) |
Print named call groups and named pickup groups.
Definition at line 8158 of file channel.c.
References ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_ref, ast_str_append(), ast_str_buffer(), first, and namedgroup_member::name.
Referenced by _sip_show_peer(), _skinny_show_line(), func_channel_read(), function_sippeer(), misdn_cfg_get_config_string(), named_callgroups_to_str(), named_pickupgroups_to_str(), print_named_groups(), and read_config().
char * ast_str_buffer(const struct ast_str *buf)
Returns the string buffer within the ast_str buf.
Definition: strings.h:714
int ast_str_append(struct ast_str **buf, ssize_t max_len, const char *fmt,...)
Append to a thread local dynamic string.
Definition: strings.h:1091
void ao2_iterator_destroy(struct ao2_iterator *iter)
Destroy a container iterator.
Definition: astobj2_container.c:534
Definition: func_dialgroup.c:84
When we need to walk through a container, we use an ao2_iterator to keep track of the current positio...
Definition: astobj2.h:1841
struct ao2_iterator ao2_iterator_init(struct ao2_container *c, int flags) attribute_warn_unused_result
Create an iterator for a container.
Definition: astobj2_container.c:485
◆ ast_prod()
| int ast_prod | ( | struct ast_channel * | chan | ) |
Send empty audio to prime a channel driver.
Definition at line 5045 of file channel.c.
References ast_channel_name(), ast_channel_rawwriteformat(), ast_debug, AST_FRAME_VOICE, AST_FRIENDLY_OFFSET, ast_log, AST_STATE_UP, ast_write(), ast_frame::data, ast_frame_subclass::format, LOG_WARNING, ast_frame::ptr, ast_frame::src, and ast_frame::subclass.
Referenced by ast_activate_generator().
Definition: include/asterisk/frame.h:101
Definition: channelstate.h:42
#define AST_FRIENDLY_OFFSET
Offset into a frame's data buffer.
Definition: include/asterisk/frame.h:229
int ast_write(struct ast_channel *chan, struct ast_frame *fr)
Write a frame to a channel This function writes the given frame to the indicated channel.
Definition: channel.c:5189
const char * ast_channel_name(const struct ast_channel *chan)
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
union ast_frame::@263 data
struct ast_format * ast_channel_rawwriteformat(struct ast_channel *chan)
Definition: channel_internal_api.c:852
◆ ast_queue_answer()
| int ast_queue_answer | ( | struct ast_channel * | chan, |
| const struct ast_stream_topology * | topology | ||
| ) |
Queue an ANSWER control frame with topology.
- Parameters
-
chan channel to queue frame onto topology topology to be passed through the core to the peer channel
- Return values
-
0 success non-zero failure
Definition at line 1246 of file channel.c.
References AST_CONTROL_ANSWER, AST_FRAME_CONTROL, and ast_queue_frame().
Definition: include/asterisk/frame.h:281
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
Definition: include/asterisk/frame.h:105
Definition: stream.c:123
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
◆ ast_queue_control()
| int ast_queue_control | ( | struct ast_channel * | chan, |
| enum ast_control_frame_type | control | ||
| ) |
Queue a control frame without payload.
- Parameters
-
chan channel to queue frame onto control type of control frame
- Note
- The channel does not need to be locked before calling this function.
- Return values
-
zero on success non-zero on failure
Queue a control frame without payload.
Definition at line 1231 of file channel.c.
References AST_FRAME_CONTROL, and ast_queue_frame().
Referenced by __analog_handle_event(), __ast_read(), analog_call(), analog_exception(), analog_hangup(), apply_negotiated_sdp_stream(), ast_do_pickup(), attempt_transfer(), audiosocket_call(), auto_congest(), cb_events(), chan_pjsip_incoming_ack(), chan_pjsip_incoming_response(), cli_console_answer(), cli_console_flash(), console_answer(), console_call(), console_sendtext(), controlplayback_manager(), handle_call_incoming(), handle_incoming(), handle_request_info(), handle_request_invite(), handle_response(), handle_response_invite(), handle_response_refer(), jingle_action_session_accept(), jingle_action_session_info(), jingle_outgoing_hook(), mbl_queue_control(), misdn_facility_ie_handler(), nbs_call(), on_topology_change_response(), onAlerting(), onCallEstablished(), onProgress(), pbx_outgoing_state_callback(), phone_call(), rtp_call(), send_cause2ast(), setsubstate(), skinny_call(), skinny_cfwd_cb(), skinny_transfer_attended(), skinny_transfer_blind(), stasis_app_control_queue_control(), unistim_call(), unreal_colp_stream_topology_request_change(), and video_info_incoming_request().
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
Definition: include/asterisk/frame.h:105
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
◆ ast_queue_control_data()
| int ast_queue_control_data | ( | struct ast_channel * | chan, |
| enum ast_control_frame_type | control, | ||
| const void * | data, | ||
| size_t | datalen | ||
| ) |
Queue a control frame with payload.
- Parameters
-
chan channel to queue frame onto control type of control frame data pointer to payload data to be included in frame datalen number of bytes of payload data
- Return values
-
0 success non-zero failure
The supplied payload data is copied into the frame, so the caller's copy is not modified nor freed, and the resulting frame will retain a copy of the data even if the caller frees their local copy.
- Note
- This method should be treated as a 'network transport'; in other words, your frames may be transferred across an IAX2 channel to another system, which may be a different endianness than yours. Because of this, you should ensure that either your frames will never be expected to work across systems, or that you always put your payload data into 'network byte order' before calling this function.
- The channel does not need to be locked before calling this function.
Definition at line 1238 of file channel.c.
References AST_FRAME_CONTROL, and ast_queue_frame().
Referenced by __analog_handle_event(), after_bridge_move_channel(), ast_channel_queue_connected_line_update(), ast_channel_queue_redirecting_update(), chan_pjsip_incoming_response_update_cause(), change_t38_state(), close_udptl_connection(), fax_gateway_indicate_t38(), handle_clear_alarms(), handle_incoming(), handle_request_notify(), handle_response_refer(), iax2_transfer(), interpret_t38_parameters(), jingle_action_session_terminate(), onModeChanged(), ooh323_indicate(), queue_read_action_payload(), setup_udptl_connection(), sip_sipredirect(), socket_process_helper(), t38_change_state(), t38_framehook(), t38_interpret_parameters(), transfer_redirect(), transfer_refer(), and xfer_client_on_evsub_state().
1241 struct ast_frame f = { AST_FRAME_CONTROL, .subclass.integer = control, .data.ptr = (void *) data, .datalen = datalen };
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
Definition: include/asterisk/frame.h:105
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
union ast_frame::@263 data
◆ ast_queue_frame()
| int ast_queue_frame | ( | struct ast_channel * | chan, |
| struct ast_frame * | f | ||
| ) |
Queue one or more frames to a channel's frame queue.
- Parameters
-
chan the channel to queue the frame(s) on f the frame(s) to queue. Note that the frame(s) will be duplicated by this function. It is the responsibility of the caller to handle freeing the memory associated with the frame(s) being passed if necessary.
- Return values
-
0 success non-zero failure
Definition at line 1139 of file channel.c.
References __ast_queue_frame(), and NULL.
Referenced by __ast_read(), action_atxfer(), action_cancel_atxfer(), alsa_call(), apply_negotiated_sdp_stream(), ast_channel_set_unbridged_nolock(), ast_channel_setwhentohangup_tv(), ast_channel_stream_topology_changed_externally(), ast_dsp_process(), ast_msg_data_queue_frame(), ast_queue_answer(), ast_queue_cc_frame(), ast_queue_control(), ast_queue_control_data(), ast_queue_hangup(), ast_queue_hangup_with_cause(), ast_queue_hold(), ast_queue_unhold(), ast_softhangup_nolock(), AST_TEST_DEFINE(), attended_transfer_exec(), bridge_channel_internal_push_full(), bridge_channel_poke(), cb_events(), channel_do_masquerade(), cli_console_dial(), cli_console_sendtext(), conf_stop_record(), console_dial(), console_do_answer(), console_flash(), console_sendtext(), dahdi_queue_frame(), dahdi_read(), dictate_exec(), do_immediate_setup(), dtmf_info_incoming_request(), handle_incoming_request(), handle_keypad_button_message(), handle_negotiated_sdp(), handle_request_info(), handle_request_invite(), handle_response_invite(), iax2_queue_frame(), keypad_cfg_read(), load_stream_readqueue(), manager_play_dtmf(), mgcp_queue_frame(), ooh323_onReceivedDigit(), oss_call(), process_sdp(), queue_dtmf_readq(), receive_message(), set_interval_hook(), stream_monitor(), stream_periodic_frames(), t38_tx_packet_handler(), unistim_do_senddigit(), unreal_queue_frame(), and wakeup_sub().
static int __ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin, int head, struct ast_frame *after)
Definition: channel.c:1015
◆ ast_queue_frame_head()
| 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.
- Parameters
-
chan the channel to queue the frame(s) on f the frame(s) to queue. Note that the frame(s) will be duplicated by this function. It is the responsibility of the caller to handle freeing the memory associated with the frame(s) being passed if necessary.
- Return values
-
0 success non-zero failure
Definition at line 1144 of file channel.c.
References __ast_queue_frame(), and NULL.
Referenced by __ast_answer(), __ast_read(), ast_autoservice_stop(), bridge_channel_queue_deferred_frames(), and safe_sleep_conditional().
static int __ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin, int head, struct ast_frame *after)
Definition: channel.c:1015
◆ ast_queue_hangup()
| int ast_queue_hangup | ( | struct ast_channel * | chan | ) |
Queue a hangup frame.
- Note
- The channel does not need to be locked before calling this function.
Queue a hangup frame.
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 1150 of file channel.c.
References ast_channel_hangup_request_type(), ast_channel_lock, ast_channel_publish_blob(), ast_channel_softhangup_internal_flag_add(), ast_channel_unlock, AST_CONTROL_HANGUP, AST_FRAME_CONTROL, ast_queue_frame(), AST_SOFTHANGUP_DEV, and NULL.
Referenced by ast_app_exec_macro(), ast_app_exec_sub(), ast_unreal_fixup(), call(), chan_pjsip_session_end(), cli_console_hangup(), close_call(), handle_request_bye(), iax2_destroy(), iax2_queue_hangup(), mbl_queue_hangup(), mgcp_queue_hangup(), refer_incoming_invite_request(), session_inv_on_media_update(), setsubstate(), and sip_queue_hangup_cause().
Definition: channel.h:1122
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
Definition: include/asterisk/frame.h:105
Definition: include/asterisk/frame.h:278
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
void ast_channel_softhangup_internal_flag_add(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:1005
void ast_channel_publish_blob(struct ast_channel *chan, struct stasis_message_type *type, struct ast_json *blob)
Publish a channel blob message.
Definition: stasis_channels.c:1135
struct stasis_message_type * ast_channel_hangup_request_type(void)
Message type for when a hangup is requested on a channel.
◆ ast_queue_hangup_with_cause()
| int ast_queue_hangup_with_cause | ( | struct ast_channel * | chan, |
| int | cause | ||
| ) |
Queue a hangup frame with hangupcause set.
- Note
- The channel does not need to be locked before calling this function.
- Parameters
-
[in] chan channel to queue frame onto [in] cause the hangup cause
- Returns
- 0 on success, -1 on error
- Since
- 1.6.1
Queue a hangup frame with hangupcause set.
Definition at line 1166 of file channel.c.
References ast_channel_hangup_request_type(), ast_channel_hangupcause(), ast_channel_lock, ast_channel_publish_blob(), ast_channel_softhangup_internal_flag_add(), ast_channel_unlock, AST_CONTROL_HANGUP, AST_FRAME_CONTROL, ast_json_pack(), ast_json_unref(), ast_log, ast_queue_frame(), AST_SOFTHANGUP_DEV, ast_frame::data, LOG_WARNING, NULL, RAII_VAR, and ast_frame::uint32.
Referenced by __analog_handle_event(), __sip_autodestruct(), ast_unreal_hangup(), chan_pjsip_session_end(), close_call(), close_client(), console_hangup(), dahdi_handle_event(), discard_call(), handle_call_outgoing(), handle_clear_alarms(), handle_request_bye(), handle_response(), handle_response_invite(), hangup_chan(), jingle_action_session_terminate(), jingle_queue_hangup_with_cause(), misdn_answer(), onCallCleared(), retrans_pkt(), sip_queue_hangup_cause(), and transfer_cancel_step2().
struct ast_json * ast_json_pack(char const *format,...)
Helper for creating complex JSON values.
Definition: json.c:591
void ast_json_unref(struct ast_json *value)
Decrease refcount on value. If refcount reaches zero, value is freed.
Definition: json.c:73
Definition: channel.h:1122
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:911
Definition: include/asterisk/frame.h:105
Definition: include/asterisk/frame.h:278
int ast_channel_hangupcause(const struct ast_channel *chan)
Definition: channel_internal_api.c:427
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
void ast_channel_softhangup_internal_flag_add(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:1005
Abstract JSON element (object, array, string, int, ...).
union ast_frame::@263 data
void ast_channel_publish_blob(struct ast_channel *chan, struct stasis_message_type *type, struct ast_json *blob)
Publish a channel blob message.
Definition: stasis_channels.c:1135
struct stasis_message_type * ast_channel_hangup_request_type(void)
Message type for when a hangup is requested on a channel.
◆ ast_queue_hold()
| int ast_queue_hold | ( | struct ast_channel * | chan, |
| const char * | musicclass | ||
| ) |
Queue a hold frame.
- Parameters
-
chan channel to queue frame onto musicclass The suggested musicclass for the other end to use
- Note
- The channel does not need to be locked before calling this function.
- Return values
-
zero on success non-zero on failure
Definition at line 1191 of file channel.c.
References ast_channel_hold_type(), ast_channel_lock, ast_channel_publish_blob(), ast_channel_unlock, AST_CONTROL_HOLD, AST_FRAME_CONTROL, ast_json_pack(), ast_json_unref(), ast_queue_frame(), ast_strlen_zero, ast_frame::data, ast_frame::datalen, NULL, and ast_frame::ptr.
Referenced by __analog_handle_event(), analog_hangup(), apply_negotiated_sdp_stream(), cb_events(), dahdi_handle_event(), dahdi_hangup(), handle_request(), iax2_queue_hold(), jingle_action_session_info(), process_sdp(), setsubstate(), sub_hold(), and transfer_call_step1().
struct stasis_message_type * ast_channel_hold_type(void)
Message type for when a channel is placed on hold.
Definition: include/asterisk/frame.h:293
struct ast_json * ast_json_pack(char const *format,...)
Helper for creating complex JSON values.
Definition: json.c:591
void ast_json_unref(struct ast_json *value)
Decrease refcount on value. If refcount reaches zero, value is freed.
Definition: json.c:73
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
Definition: include/asterisk/frame.h:105
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
Abstract JSON element (object, array, string, int, ...).
union ast_frame::@263 data
void ast_channel_publish_blob(struct ast_channel *chan, struct stasis_message_type *type, struct ast_json *blob)
Publish a channel blob message.
Definition: stasis_channels.c:1135
◆ ast_queue_unhold()
| int ast_queue_unhold | ( | struct ast_channel * | chan | ) |
Queue an unhold frame.
- Parameters
-
chan channel to queue frame onto
- Note
- The channel does not need to be locked before calling this function.
- Return values
-
zero on success non-zero on failure
Definition at line 1216 of file channel.c.
References ast_channel_lock, ast_channel_publish_blob(), ast_channel_unhold_type(), ast_channel_unlock, AST_CONTROL_UNHOLD, AST_FRAME_CONTROL, ast_queue_frame(), and NULL.
Referenced by __analog_handle_event(), __analog_ss_thread(), __dahdi_exception(), analog_exception(), analog_hangup(), analog_ss_thread(), apply_negotiated_sdp_stream(), attempt_transfer(), cb_events(), dahdi_handle_event(), dahdi_hangup(), handle_hd_hf(), handle_request(), handle_request_bye(), handle_request_invite(), iax2_queue_unhold(), jingle_action_session_info(), key_dial_page(), process_sdp(), session_inv_on_create_offer(), setsubstate(), sub_unhold(), transfer_cancel_step2(), and unistim_hangup().
struct stasis_message_type * ast_channel_unhold_type(void)
Message type for when a channel is removed from hold.
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
Definition: include/asterisk/frame.h:105
Definition: include/asterisk/frame.h:294
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
void ast_channel_publish_blob(struct ast_channel *chan, struct stasis_message_type *type, struct ast_json *blob)
Publish a channel blob message.
Definition: stasis_channels.c:1135
◆ ast_raw_answer()
| int ast_raw_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.
- Unlike ast_answer(), this function will not wait for media flow to begin. The caller should be careful before sending media to the channel before incoming media arrives, as the outgoing media may be lost.
- Return values
-
0 on success non-zero on failure
Definition at line 2699 of file channel.c.
References ast_raw_answer_with_stream_topology(), and NULL.
Referenced by __ast_answer(), app_control_answer(), handle_invite_replaces(), and refer_incoming_invite_request().
int ast_raw_answer_with_stream_topology(struct ast_channel *chan, struct ast_stream_topology *topology)
Answer a channel passing in a stream topology.
Definition: channel.c:2648
◆ ast_raw_answer_with_stream_topology()
| int ast_raw_answer_with_stream_topology | ( | struct ast_channel * | chan, |
| struct ast_stream_topology * | topology | ||
| ) |
Answer a channel passing in a stream topology.
- Since
- 18.0.0
- Parameters
-
chan channel to answer topology the peer's stream topology
This function answers a channel and handles all necessary call setup functions.
- Note
- The channel passed does not need to be locked, but is locked by the function when needed.
- Unlike ast_answer(), this function will not wait for media flow to begin. The caller should be careful before sending media to the channel before incoming media arrives, as the outgoing media may be lost.
- The topology is usually that of the peer channel and may be NULL.
- Return values
-
0 on success non-zero on failure
Definition at line 2648 of file channel.c.
References answer(), ast_channel_tech::answer, ast_channel_tech::answer_with_stream_topology, ast_channel_flags(), ast_channel_lock, ast_channel_name(), ast_channel_tech(), ast_channel_unlock, ast_check_hangup(), AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, ast_indicate(), ast_setstate(), AST_STATE_RING, AST_STATE_RINGING, AST_STATE_UP, ast_test_flag, SCOPE_TRACE, and set_channel_answer_time().
Referenced by ast_raw_answer(), and pre_bridge_setup().
int(*const answer_with_stream_topology)(struct ast_channel *chan, struct ast_stream_topology *topology)
Answer the channel with topology.
Definition: channel.h:721
Definition: channelstate.h:40
Definition: channelstate.h:42
static void set_channel_answer_time(struct ast_channel *chan)
Definition: channel.c:2637
int ast_indicate(struct ast_channel *chan, int condition)
Indicates condition of channel.
Definition: channel.c:4322
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
Definition: channelstate.h:41
Definition: channel.h:988
#define SCOPE_TRACE(level,...)
Print a trace message with details when a scope is entered or existed.
Definition: logger.h:749
Definition: channel.h:1000
const char * ast_channel_name(const struct ast_channel *chan)
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
int ast_setstate(struct ast_channel *chan, enum ast_channel_state state)
Change the state of a channel.
Definition: channel.c:7486
◆ ast_read()
| struct ast_frame* ast_read | ( | struct ast_channel * | chan | ) |
Reads a frame.
- Parameters
-
chan channel to read a frame from
- Returns
- Returns a frame, or NULL on error. If it returns NULL, you best just stop reading frames and assume the channel has been disconnected.
- Note
- This function will filter frames received from the channel so that only frames from the default stream for each media type are returned. All other media frames from other streams will be absorbed internally and a NULL frame returned instead.
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 4302 of file channel.c.
References __ast_read().
Referenced by __adsi_transmit_messages(), __analog_ss_thread(), __ast_answer(), __ast_play_and_record(), __ast_request_and_dial(), adsi_careful_send(), analog_ss_thread(), ast_recvtext(), AST_TEST_DEFINE(), ast_tonepair(), ast_transfer_protocol(), ast_waitfordigit_full(), async_agi_read_frame(), audiosocket_run(), autoservice_run(), background_detect_exec(), channel_spy(), conf_flush(), conf_run(), destroy_all_channels(), dial_exec_full(), dictate_exec(), disa_exec(), disable_t38(), do_waiting(), echo_exec(), eivr_comm(), find_cache(), generic_fax_exec(), handle_recordfile(), handle_speechrecognize(), iax2_key_rotate(), ices_exec(), isAnsweringMachine(), jack_exec(), measurenoise(), misdn_write(), moh_channel_thread(), monitor_dial(), mp3_exec(), NBScat_exec(), read_from_chan(), read_mf_digits(), read_sf_digits(), receive_dtmf_digits(), receivefax_t38_init(), record_exec(), recordthread(), run_agi(), safe_sleep_conditional(), send_waveform_to_channel(), sendfax_t38_init(), sendurl_exec(), sms_exec(), speech_background(), stasis_app_exec(), transmit_audio(), transmit_t38(), wait_exec(), wait_for_answer(), wait_for_hangup(), wait_for_winner(), waitforring_exec(), and waitstream_core().
static struct ast_frame * __ast_read(struct ast_channel *chan, int dropaudio, int dropnondefault)
Definition: channel.c:3529
◆ ast_read_noaudio()
| struct ast_frame* ast_read_noaudio | ( | struct ast_channel * | chan | ) |
Reads a frame, returning AST_FRAME_NULL frame if audio.
- Parameters
-
chan channel to read a frame from
- Returns
- Returns a frame, or NULL on error. If it returns NULL, you best just stop reading frames and assume the channel has been disconnected.
- Note
- Audio is replaced with AST_FRAME_NULL to avoid transcode when the resulting audio is not necessary.
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 4312 of file channel.c.
References __ast_read().
Referenced by ast_control_tone(), and conf_run().
static struct ast_frame * __ast_read(struct ast_channel *chan, int dropaudio, int dropnondefault)
Definition: channel.c:3529
◆ ast_read_stream()
| struct ast_frame* ast_read_stream | ( | struct ast_channel * | chan | ) |
Reads a frame, but does not filter to just the default streams.
- Parameters
-
chan channel to read a frame from
- Returns
- Returns a frame, or NULL on error. If it returns NULL, you best just stop reading frames and assume the channel has been disconnected.
- Note
- This function will not perform any filtering and will return media frames from all streams on the channel. To determine which stream a frame originated from the stream_num on it can be examined.
Definition at line 4307 of file channel.c.
References __ast_read().
Referenced by AST_TEST_DEFINE(), bridge_handle_trip(), read_from_chan(), and stream_echo_perform().
static struct ast_frame * __ast_read(struct ast_channel *chan, int dropaudio, int dropnondefault)
Definition: channel.c:3529
◆ ast_read_stream_noaudio()
| 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.
- Parameters
-
chan channel to read a frame from
- Returns
- Returns a frame, or NULL on error. If it returns NULL, you best just stop reading frames and assume the channel has been disconnected.
- Note
- This function will not perform any filtering and will return media frames from all streams on the channel. To determine which stream a frame originated from the stream_num on it can be examined.
- Audio is replaced with AST_FRAME_NULL to avoid transcode when the resulting audio is not necessary.
Definition at line 4317 of file channel.c.
References __ast_read().
Referenced by bridge_handle_trip().
static struct ast_frame * __ast_read(struct ast_channel *chan, int dropaudio, int dropnondefault)
Definition: channel.c:3529
◆ ast_readstring()
| int ast_readstring | ( | struct ast_channel * | c, |
| char * | s, | ||
| int | len, | ||
| int | timeout, | ||
| int | rtimeout, | ||
| char * | enders | ||
| ) |
Reads multiple digits.
- Parameters
-
c channel to read from s string to read in to. Must be at least the size of your length len how many digits to read (maximum) timeout how long to timeout between digits rtimeout timeout to wait on the first digit enders digits to end the string
Read in a digit string "s", max length "len", maximum timeout between digits "timeout" (-1 for none), terminated by anything in "enders". Give them rtimeout for the first digit.
- Returns
- Returns 0 on normal return, or 1 on a timeout. In the case of a timeout, any digits that were read before the timeout will still be available in s. RETURNS 2 in full version when ctrlfd is available, NOT 1
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 6655 of file channel.c.
References ast_readstring_full().
Referenced by __adsi_transmit_messages(), adsi_begin_download(), adsi_get_cpeinfo(), adsi_load_session(), app_exec(), ast_app_getdata(), dialout(), do_directory(), forward_message(), privacy_exec(), vm_authenticate(), vm_newuser_setup(), and vm_options().
int ast_readstring_full(struct ast_channel *c, char *s, int len, int timeout, int ftimeout, char *enders, int audiofd, int ctrlfd)
Definition: channel.c:6660
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
Definition: func_strings.c:1344
◆ ast_readstring_full()
| int ast_readstring_full | ( | struct ast_channel * | c, |
| char * | s, | ||
| int | len, | ||
| int | timeout, | ||
| int | rtimeout, | ||
| char * | enders, | ||
| int | audiofd, | ||
| int | ctrlfd | ||
| ) |
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 6660 of file channel.c.
References ast_channel_flags(), ast_channel_start_silence_generator(), ast_channel_stop_silence_generator(), ast_channel_stream(), ast_check_hangup(), AST_DIGIT_ANY, AST_FLAG_ZOMBIE, AST_GETDATA_COMPLETE, AST_GETDATA_EMPTY_END_TERMINATED, AST_GETDATA_FAILED, AST_GETDATA_INTERRUPTED, AST_GETDATA_TIMEOUT, ast_opt_transmit_silence, ast_stopstream(), ast_test_flag, ast_waitfordigit_full(), ast_waitstream_full(), d, NULL, and timeout.
Referenced by ast_app_getdata_full(), and ast_readstring().
Definition: include/asterisk/app.h:1156
Definition: channel.c:8262
struct ast_silence_generator * ast_channel_start_silence_generator(struct ast_channel *chan)
Starts a silence generator on the given channel.
Definition: channel.c:8266
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
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.
Definition: channel.c:8312
Definition: include/asterisk/app.h:1157
int ast_waitfordigit_full(struct ast_channel *c, int timeout_ms, const char *breakon, int audiofd, int cmdfd)
Wait for a digit Same as ast_waitfordigit() with audio fd for outputting read audio and ctrlfd to mon...
Definition: channel.c:3248
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
Definition: func_strings.c:1344
Definition: channel.h:988
struct ast_filestream * ast_channel_stream(const struct ast_channel *chan)
Definition: channel_internal_api.c:621
int ast_waitstream_full(struct ast_channel *c, const char *breakon, int audiofd, int monfd)
Definition: file.c:1785
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
Definition: include/asterisk/app.h:1155
◆ ast_recvchar()
| int ast_recvchar | ( | struct ast_channel * | chan, |
| int | timeout | ||
| ) |
Receives a text character from a channel.
- Parameters
-
chan channel to act upon timeout timeout in milliseconds (0 for infinite wait)
Read a char of text from a channel
- Returns
- 0 on success, -1 on failure
Definition at line 4751 of file channel.c.
References ast_free, ast_recvtext(), buf, c, and NULL.
Referenced by handle_recvchar().
char * ast_recvtext(struct ast_channel *chan, int timeout)
Receives a text string from a channel Read a string of text from a channel.
Definition: channel.c:4762
◆ ast_recvtext()
| char* ast_recvtext | ( | struct ast_channel * | chan, |
| int | timeout | ||
| ) |
Receives a text string from a channel Read a string of text from a channel.
- Parameters
-
chan channel to act upon timeout timeout in milliseconds (0 for infinite wait)
- Returns
- the received text, or NULL to signify failure.
Definition at line 4762 of file channel.c.
References ast_check_hangup(), AST_CONTROL_HANGUP, AST_FRAME_CONTROL, AST_FRAME_TEXT, ast_frfree, ast_read(), ast_remaining_ms(), ast_strndup, ast_tvnow(), ast_waitfor(), buf, ast_frame::data, ast_frame::datalen, ast_frame::frametype, ast_frame_subclass::integer, NULL, ast_frame::ptr, and ast_frame::subclass.
Referenced by ast_recvchar(), and handle_recvtext().
Definition: include/asterisk/frame.h:114
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
Definition: include/asterisk/frame.h:105
Definition: include/asterisk/frame.h:278
int ast_remaining_ms(struct timeval start, int max_ms)
Calculate remaining milliseconds given a starting timestamp and upper bound.
Definition: main/utils.c:2033
int ast_waitfor(struct ast_channel *c, int ms)
Wait for input on a channel.
Definition: channel.c:3171
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
union ast_frame::@263 data
◆ ast_redirecting_build_data()
| 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.
- Since
- 1.8
- Parameters
-
data Buffer to fill with the frame data datalen Size of the buffer to fill redirecting Redirecting id information update What redirecting information to build. NULL if all.
- Return values
-
-1 if error Amount of data buffer used
Definition at line 9363 of file channel.c.
References ast_log, AST_REDIRECTING_COUNT, AST_REDIRECTING_FROM_ID_PRESENTATION, AST_REDIRECTING_FROM_NAME, AST_REDIRECTING_FROM_NAME_CHAR_SET, AST_REDIRECTING_FROM_NAME_PRESENTATION, AST_REDIRECTING_FROM_NAME_VALID, AST_REDIRECTING_FROM_NUMBER, AST_REDIRECTING_FROM_NUMBER_PLAN, AST_REDIRECTING_FROM_NUMBER_PRESENTATION, AST_REDIRECTING_FROM_NUMBER_VALID, AST_REDIRECTING_FROM_SUBADDRESS, AST_REDIRECTING_FROM_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_FROM_SUBADDRESS_TYPE, AST_REDIRECTING_FROM_SUBADDRESS_VALID, AST_REDIRECTING_FROM_TAG, AST_REDIRECTING_ORIG_NAME, AST_REDIRECTING_ORIG_NAME_CHAR_SET, AST_REDIRECTING_ORIG_NAME_PRESENTATION, AST_REDIRECTING_ORIG_NAME_VALID, AST_REDIRECTING_ORIG_NUMBER, AST_REDIRECTING_ORIG_NUMBER_PLAN, AST_REDIRECTING_ORIG_NUMBER_PRESENTATION, AST_REDIRECTING_ORIG_NUMBER_VALID, AST_REDIRECTING_ORIG_REASON_CODE, AST_REDIRECTING_ORIG_REASON_STR, AST_REDIRECTING_ORIG_SUBADDRESS, AST_REDIRECTING_ORIG_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_ORIG_SUBADDRESS_TYPE, AST_REDIRECTING_ORIG_SUBADDRESS_VALID, AST_REDIRECTING_ORIG_TAG, AST_REDIRECTING_PRIV_FROM_NAME, AST_REDIRECTING_PRIV_FROM_NAME_CHAR_SET, AST_REDIRECTING_PRIV_FROM_NAME_PRESENTATION, AST_REDIRECTING_PRIV_FROM_NAME_VALID, AST_REDIRECTING_PRIV_FROM_NUMBER, AST_REDIRECTING_PRIV_FROM_NUMBER_PLAN, AST_REDIRECTING_PRIV_FROM_NUMBER_PRESENTATION, AST_REDIRECTING_PRIV_FROM_NUMBER_VALID, AST_REDIRECTING_PRIV_FROM_SUBADDRESS, AST_REDIRECTING_PRIV_FROM_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_PRIV_FROM_SUBADDRESS_TYPE, AST_REDIRECTING_PRIV_FROM_SUBADDRESS_VALID, AST_REDIRECTING_PRIV_FROM_TAG, AST_REDIRECTING_PRIV_ORIG_NAME, AST_REDIRECTING_PRIV_ORIG_NAME_CHAR_SET, AST_REDIRECTING_PRIV_ORIG_NAME_PRESENTATION, AST_REDIRECTING_PRIV_ORIG_NAME_VALID, AST_REDIRECTING_PRIV_ORIG_NUMBER, AST_REDIRECTING_PRIV_ORIG_NUMBER_PLAN, AST_REDIRECTING_PRIV_ORIG_NUMBER_PRESENTATION, AST_REDIRECTING_PRIV_ORIG_NUMBER_VALID, AST_REDIRECTING_PRIV_ORIG_SUBADDRESS, AST_REDIRECTING_PRIV_ORIG_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_PRIV_ORIG_SUBADDRESS_TYPE, AST_REDIRECTING_PRIV_ORIG_SUBADDRESS_VALID, AST_REDIRECTING_PRIV_ORIG_TAG, AST_REDIRECTING_PRIV_TO_NAME, AST_REDIRECTING_PRIV_TO_NAME_CHAR_SET, AST_REDIRECTING_PRIV_TO_NAME_PRESENTATION, AST_REDIRECTING_PRIV_TO_NAME_VALID, AST_REDIRECTING_PRIV_TO_NUMBER, AST_REDIRECTING_PRIV_TO_NUMBER_PLAN, AST_REDIRECTING_PRIV_TO_NUMBER_PRESENTATION, AST_REDIRECTING_PRIV_TO_NUMBER_VALID, AST_REDIRECTING_PRIV_TO_SUBADDRESS, AST_REDIRECTING_PRIV_TO_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_PRIV_TO_SUBADDRESS_TYPE, AST_REDIRECTING_PRIV_TO_SUBADDRESS_VALID, AST_REDIRECTING_PRIV_TO_TAG, AST_REDIRECTING_REASON_CODE, AST_REDIRECTING_REASON_STR, AST_REDIRECTING_TO_ID_PRESENTATION, AST_REDIRECTING_TO_NAME, AST_REDIRECTING_TO_NAME_CHAR_SET, AST_REDIRECTING_TO_NAME_PRESENTATION, AST_REDIRECTING_TO_NAME_VALID, AST_REDIRECTING_TO_NUMBER, AST_REDIRECTING_TO_NUMBER_PLAN, AST_REDIRECTING_TO_NUMBER_PRESENTATION, AST_REDIRECTING_TO_NUMBER_VALID, AST_REDIRECTING_TO_SUBADDRESS, AST_REDIRECTING_TO_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_TO_SUBADDRESS_TYPE, AST_REDIRECTING_TO_SUBADDRESS_VALID, AST_REDIRECTING_TO_TAG, AST_REDIRECTING_VERSION, ast_party_redirecting_reason_ies::code, ast_party_redirecting::count, ast_party_redirecting::from, ast_set_party_redirecting::from, LOG_WARNING, ast_party_id_ies::name, NULL, ast_party_redirecting::orig, ast_set_party_redirecting::orig, ast_party_redirecting::orig_reason, party_id_build_data(), ast_party_redirecting::priv_from, ast_set_party_redirecting::priv_from, ast_party_redirecting::priv_orig, ast_set_party_redirecting::priv_orig, ast_party_redirecting::priv_to, ast_set_party_redirecting::priv_to, ast_party_redirecting::reason, redirecting_reason_build_data(), ast_party_name_ies::str, ast_party_redirecting::to, ast_set_party_redirecting::to, and value.
Referenced by ast_channel_queue_redirecting_update(), ast_channel_update_redirecting(), and unreal_colp_redirect_indicate().
Definition: channel.c:9264
Definition: channel.c:9253
struct ast_party_id priv_to
Call is redirecting to a new party (Sent to the caller) - private representation. ...
Definition: channel.h:540
Definition: channel.c:9274
Definition: channel.c:9266
Definition: channel.c:9259
Definition: channel.c:9270
struct ast_party_id priv_orig
Who originally redirected the call (Sent to the party the call is redirected toward) - private repres...
Definition: channel.h:534
struct ast_party_id from
Who is redirecting the call (Sent to the party the call is redirected toward)
Definition: channel.h:528
Definition: channel.c:9251
Definition: channel.c:9280
Definition: channel.c:9241
struct ast_party_id priv_from
Who is redirecting the call (Sent to the party the call is redirected toward) - private representatio...
Definition: channel.h:537
Definition: channel.c:9239
Definition: channel.c:9240
Definition: channel.c:9235
Definition: channel.c:9233
Definition: channel.c:9272
Definition: channel.c:8642
struct ast_party_id orig
Who originally redirected the call (Sent to the party the call is redirected toward) ...
Definition: channel.h:525
static int redirecting_reason_build_data(unsigned char *data, size_t datalen, const struct ast_party_redirecting_reason *reason, const char *label, const struct ast_party_redirecting_reason_ies *ies)
Definition: channel.c:9330
Definition: channel.c:9320
Definition: channel.c:9273
struct ast_party_redirecting_reason orig_reason
Reason for the redirection by the original party.
Definition: channel.h:546
Definition: channel.c:9307
Definition: channel.c:9258
Definition: channel.c:9295
Definition: channel.c:9294
Definition: channel.c:9242
Definition: channel.c:9299
Definition: channel.c:9287
Definition: channel.c:9234
Definition: channel.c:9269
Definition: channel.c:9238
Definition: channel.c:9308
Definition: channel.c:9243
Definition: channel.c:9237
Definition: channel.c:9248
Definition: channel.c:9325
static int party_id_build_data(unsigned char *data, size_t datalen, const struct ast_party_id *id, const char *label, const struct ast_party_id_ies *ies, const struct ast_set_party_id *update)
Definition: channel.c:8673
Definition: channel.c:9261
Definition: channel.c:9282
Definition: channel.c:9312
Definition: channel.c:9263
struct ast_party_id to
Call is redirecting to a new party (Sent to the caller)
Definition: channel.h:531
Definition: channel.c:9322
Definition: channel.c:9276
Definition: channel.c:9321
Definition: channel.c:9247
Definition: channel.c:9290
Definition: channel.c:9286
Definition: channel.c:9281
Definition: channel.c:9268
Definition: channel.c:9252
◆ ast_redirecting_parse_data()
| int ast_redirecting_parse_data | ( | const unsigned char * | data, |
| size_t | datalen, | ||
| struct ast_party_redirecting * | redirecting | ||
| ) |
Parse redirecting indication frame data.
- Since
- 1.8
- Parameters
-
data Buffer with the frame data to parse datalen Size of the buffer redirecting Extracted redirecting id information
- Return values
-
0 on success. -1 on error.
- Note
- The filled in id structure needs to be initialized by ast_party_redirecting_set_init() before calling.
- The filled in id structure needs to be destroyed by ast_party_redirecting_free() when it is no longer needed.
Definition at line 9574 of file channel.c.
References ast_debug, ast_free, ast_log, ast_malloc, AST_PARTY_CHAR_SET_ISO8859_1, AST_REDIRECTING_COUNT, AST_REDIRECTING_FROM_ID_PRESENTATION, AST_REDIRECTING_FROM_NAME, AST_REDIRECTING_FROM_NAME_CHAR_SET, AST_REDIRECTING_FROM_NAME_PRESENTATION, AST_REDIRECTING_FROM_NAME_VALID, AST_REDIRECTING_FROM_NUMBER, AST_REDIRECTING_FROM_NUMBER_PLAN, AST_REDIRECTING_FROM_NUMBER_PRESENTATION, AST_REDIRECTING_FROM_NUMBER_VALID, AST_REDIRECTING_FROM_SUBADDRESS, AST_REDIRECTING_FROM_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_FROM_SUBADDRESS_TYPE, AST_REDIRECTING_FROM_SUBADDRESS_VALID, AST_REDIRECTING_FROM_TAG, AST_REDIRECTING_ORIG_NAME, AST_REDIRECTING_ORIG_NAME_CHAR_SET, AST_REDIRECTING_ORIG_NAME_PRESENTATION, AST_REDIRECTING_ORIG_NAME_VALID, AST_REDIRECTING_ORIG_NUMBER, AST_REDIRECTING_ORIG_NUMBER_PLAN, AST_REDIRECTING_ORIG_NUMBER_PRESENTATION, AST_REDIRECTING_ORIG_NUMBER_VALID, AST_REDIRECTING_ORIG_REASON_CODE, AST_REDIRECTING_ORIG_REASON_STR, AST_REDIRECTING_ORIG_SUBADDRESS, AST_REDIRECTING_ORIG_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_ORIG_SUBADDRESS_TYPE, AST_REDIRECTING_ORIG_SUBADDRESS_VALID, AST_REDIRECTING_ORIG_TAG, AST_REDIRECTING_PRIV_FROM_NAME, AST_REDIRECTING_PRIV_FROM_NAME_CHAR_SET, AST_REDIRECTING_PRIV_FROM_NAME_PRESENTATION, AST_REDIRECTING_PRIV_FROM_NAME_VALID, AST_REDIRECTING_PRIV_FROM_NUMBER, AST_REDIRECTING_PRIV_FROM_NUMBER_PLAN, AST_REDIRECTING_PRIV_FROM_NUMBER_PRESENTATION, AST_REDIRECTING_PRIV_FROM_NUMBER_VALID, AST_REDIRECTING_PRIV_FROM_SUBADDRESS, AST_REDIRECTING_PRIV_FROM_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_PRIV_FROM_SUBADDRESS_TYPE, AST_REDIRECTING_PRIV_FROM_SUBADDRESS_VALID, AST_REDIRECTING_PRIV_FROM_TAG, AST_REDIRECTING_PRIV_ORIG_NAME, AST_REDIRECTING_PRIV_ORIG_NAME_CHAR_SET, AST_REDIRECTING_PRIV_ORIG_NAME_PRESENTATION, AST_REDIRECTING_PRIV_ORIG_NAME_VALID, AST_REDIRECTING_PRIV_ORIG_NUMBER, AST_REDIRECTING_PRIV_ORIG_NUMBER_PLAN, AST_REDIRECTING_PRIV_ORIG_NUMBER_PRESENTATION, AST_REDIRECTING_PRIV_ORIG_NUMBER_VALID, AST_REDIRECTING_PRIV_ORIG_SUBADDRESS, AST_REDIRECTING_PRIV_ORIG_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_PRIV_ORIG_SUBADDRESS_TYPE, AST_REDIRECTING_PRIV_ORIG_SUBADDRESS_VALID, AST_REDIRECTING_PRIV_ORIG_TAG, AST_REDIRECTING_PRIV_TO_NAME, AST_REDIRECTING_PRIV_TO_NAME_CHAR_SET, AST_REDIRECTING_PRIV_TO_NAME_PRESENTATION, AST_REDIRECTING_PRIV_TO_NAME_VALID, AST_REDIRECTING_PRIV_TO_NUMBER, AST_REDIRECTING_PRIV_TO_NUMBER_PLAN, AST_REDIRECTING_PRIV_TO_NUMBER_PRESENTATION, AST_REDIRECTING_PRIV_TO_NUMBER_VALID, AST_REDIRECTING_PRIV_TO_SUBADDRESS, AST_REDIRECTING_PRIV_TO_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_PRIV_TO_SUBADDRESS_TYPE, AST_REDIRECTING_PRIV_TO_SUBADDRESS_VALID, AST_REDIRECTING_PRIV_TO_TAG, AST_REDIRECTING_REASON_CODE, AST_REDIRECTING_REASON_STR, AST_REDIRECTING_TO_ID_PRESENTATION, AST_REDIRECTING_TO_NAME, AST_REDIRECTING_TO_NAME_CHAR_SET, AST_REDIRECTING_TO_NAME_PRESENTATION, AST_REDIRECTING_TO_NAME_VALID, AST_REDIRECTING_TO_NUMBER, AST_REDIRECTING_TO_NUMBER_PLAN, AST_REDIRECTING_TO_NUMBER_PRESENTATION, AST_REDIRECTING_TO_NUMBER_VALID, AST_REDIRECTING_TO_SUBADDRESS, AST_REDIRECTING_TO_SUBADDRESS_ODD_EVEN, AST_REDIRECTING_TO_SUBADDRESS_TYPE, AST_REDIRECTING_TO_SUBADDRESS_VALID, AST_REDIRECTING_TO_TAG, AST_REDIRECTING_VERSION, ast_party_name::char_set, ast_party_redirecting_reason::code, ast_party_redirecting::count, ast_party_redirecting::from, LOG_WARNING, ast_party_id::name, ast_party_id::number, ast_party_subaddress::odd_even_indicator, ast_party_redirecting::orig, ast_party_redirecting::orig_reason, ast_party_number::plan, ast_party_name::presentation, ast_party_number::presentation, ast_party_redirecting::priv_from, ast_party_redirecting::priv_orig, ast_party_redirecting::priv_to, ast_party_redirecting::reason, ast_party_name::str, ast_party_number::str, ast_party_subaddress::str, ast_party_redirecting_reason::str, ast_party_id::subaddress, ast_party_id::tag, ast_party_redirecting::to, ast_party_subaddress::type, ast_party_name::valid, ast_party_number::valid, ast_party_subaddress::valid, and value.
Referenced by ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), and indicate_redirecting().
9582 int got_from_combined_presentation = 0;/* TRUE if got a combined name and number presentation value. */
9584 int got_to_combined_presentation = 0;/* TRUE if got a combined name and number presentation value. */
Definition: channel.c:9264
Definition: channel.c:9253
struct ast_party_id priv_to
Call is redirecting to a new party (Sent to the caller) - private representation. ...
Definition: channel.h:540
Definition: channel.c:9274
Definition: channel.c:9266
int presentation
Q.931 presentation-indicator and screening-indicator encoded fields.
Definition: channel.h:296
Definition: channel.c:9259
Definition: channel.c:9270
struct ast_party_id priv_orig
Who originally redirected the call (Sent to the party the call is redirected toward) - private repres...
Definition: channel.h:534
struct ast_party_id from
Who is redirecting the call (Sent to the party the call is redirected toward)
Definition: channel.h:528
Definition: channel.c:9251
Definition: channel.c:9280
Definition: channel.c:9241
struct ast_party_id priv_from
Who is redirecting the call (Sent to the party the call is redirected toward) - private representatio...
Definition: channel.h:537
Definition: channel.c:9239
Definition: channel.c:9240
Definition: channel.c:9235
Definition: channel.c:9233
Definition: channel.c:9272
struct ast_party_id orig
Who originally redirected the call (Sent to the party the call is redirected toward) ...
Definition: channel.h:525
Definition: channel.c:9320
Definition: channel.c:9273
struct ast_party_redirecting_reason orig_reason
Reason for the redirection by the original party.
Definition: channel.h:546
Definition: channel.c:9307
Definition: channel.c:9258
Definition: channel.c:9295
Definition: channel.c:9294
Definition: channel.c:9242
Definition: channel.c:9299
Definition: channel.c:9287
Definition: channel.c:9234
Definition: channel.c:9269
Definition: channel.c:9238
Definition: channel.c:9308
Definition: channel.c:9243
Definition: channel.c:9237
Definition: channel.c:9248
Definition: channel.c:9261
Definition: channel.c:9282
Definition: channel.c:9312
Definition: channel.c:9263
struct ast_party_id to
Call is redirecting to a new party (Sent to the caller)
Definition: channel.h:531
Definition: channel.c:9322
Definition: channel.c:9276
Definition: channel.c:9321
Definition: channel.c:9247
Definition: channel.c:9290
Definition: channel.c:9286
Definition: channel.c:9281
Definition: channel.c:9268
Definition: channel.h:245
Definition: channel.c:9252
◆ ast_ref_namedgroups()
| struct ast_namedgroups* ast_ref_namedgroups | ( | struct ast_namedgroups * | groups | ) |
Definition at line 7838 of file channel.c.
References ao2_ref, and groups.
Referenced by ast_channel_named_callgroups_set(), ast_channel_named_pickupgroups_set(), check_peer_ok(), create_addr_from_peer(), and mkintf().
Definition: main/app.c:123
static struct groups groups
◆ ast_request()
| 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.
- Parameters
-
type type of channel to request request_cap Format capabilities for requested channel assignedids Unique ID to create channel with requestor channel asking for data addr destination of the call cause Cause of failure
Request a channel of a given type, with addr as optional information used by the low level module
- Return values
-
NULL failure non-NULL channel on success
Definition at line 6444 of file channel.c.
References NULL, and request_channel().
Referenced by __ast_request_and_dial(), alloc_playback_chan(), ast_ari_channels_create(), ast_call_forward(), attended_transfer_bridge(), begin_dial_prerun(), blind_transfer_bridge(), build_conf(), chanavail_exec(), conf_run(), conf_start_record(), dial_transfer(), findmeexec(), meetme_menu_admin_extended(), park_local_transfer(), prepare_bridge_media_channel(), prepare_bridge_moh_channel(), retransfer_enter(), ring_entry(), and wait_for_answer().
static struct ast_channel * request_channel(const char *type, struct ast_format_cap *request_cap, struct ast_stream_topology *topology, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *addr, int *cause)
Definition: channel.c:6309
◆ 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 | ||
| ) |
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 asking for 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)
- 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 6264 of file channel.c.
References __ast_request_and_dial(), and NULL.
Referenced by generic_recall().
6266 return __ast_request_and_dial(type, cap, assignedids, requestor, addr, timeout, outstate, cidnum, cidname, NULL);
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 *outstate, const char *cid_num, const char *cid_name, struct outgoing_helper *oh)
Request a channel of a given type, with data as optional information used by the low level module and...
Definition: channel.c:6066
◆ ast_request_with_stream_topology()
| 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)
- Parameters
-
type type of channel to request topology Stream topology for requested channel assignedids Unique ID to create channel with requestor channel asking for data addr destination of the call cause Cause of failure
Request a channel of a given type, with addr as optional information used by the low level module
- Return values
-
NULL failure non-NULL channel on success
Definition at line 6449 of file channel.c.
References NULL, and request_channel().
Referenced by dial_exec_full(), and do_forward().
static struct ast_channel * request_channel(const char *type, struct ast_format_cap *request_cap, struct ast_stream_topology *topology, const struct ast_assigned_ids *assignedids, const struct ast_channel *requestor, const char *addr, int *cause)
Definition: channel.c:6309
◆ ast_safe_sleep()
| int ast_safe_sleep | ( | struct ast_channel * | chan, |
| int | ms | ||
| ) |
Wait for a specified amount of time, looking for hangups.
- Parameters
-
chan channel to wait for ms length of time in milliseconds to sleep. This should never be less than zero.
Waits for a specified amount of time, servicing the channel as required.
- Returns
- returns -1 on hangup, otherwise 0.
Wait for a specified amount of time, looking for hangups.
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 1574 of file channel.c.
References NULL, and safe_sleep_conditional().
Referenced by __analog_ss_thread(), adsi_transmit_message_full(), alarmreceiver_exec(), analog_ss_thread(), ast_senddigit(), ast_senddigit_mf(), conf_run(), destroy_all_channels(), dial_trunk(), dictate_exec(), disa_exec(), dtmf_no_bridge(), dtmf_stream(), flash_exec(), mf_stream(), mgcp_ss(), milliwatt_exec(), misdn_check_l2l1(), old_milliwatt_exec(), pbx_builtin_wait(), play_moh_exec(), playtone(), privacy_exec(), send_tone_burst(), testclient_exec(), testserver_exec(), try_calling(), wait_for_hangup(), waituntil_exec(), and zapateller_exec().
static int safe_sleep_conditional(struct ast_channel *chan, int timeout_ms, int(*cond)(void *), void *data, unsigned int generate_silence)
Wait, look for hangups and condition arg.
Definition: channel.c:1498
◆ ast_safe_sleep_conditional()
| int ast_safe_sleep_conditional | ( | struct ast_channel * | chan, |
| int | ms, | ||
| int(*)(void *) | cond, | ||
| void * | data | ||
| ) |
Wait for a specified amount of time, looking for hangups and a condition argument.
- Parameters
-
chan channel to wait for ms length of time in milliseconds to sleep. cond a function pointer for testing continue condition data argument to be passed to the condition test function
- Returns
- returns -1 on hangup, otherwise 0.
Waits for a specified amount of time, servicing the channel as required. If cond returns 0, this function returns.
Definition at line 1568 of file channel.c.
References cond, and safe_sleep_conditional().
Referenced by get_chan_by_ast_name().
static int safe_sleep_conditional(struct ast_channel *chan, int timeout_ms, int(*cond)(void *), void *data, unsigned int generate_silence)
Wait, look for hangups and condition arg.
Definition: channel.c:1498
◆ ast_safe_sleep_without_silence()
| 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.
- Parameters
-
chan channel to wait for ms length of time in milliseconds to sleep. This should never be less than zero.
Waits for a specified amount of time, servicing the channel as required.
- Returns
- returns -1 on hangup, otherwise 0.
- Note
- Unlike ast_safe_sleep this will not generate silence if Asterisk is configured to do so.
Definition at line 1579 of file channel.c.
References NULL, and safe_sleep_conditional().
static int safe_sleep_conditional(struct ast_channel *chan, int timeout_ms, int(*cond)(void *), void *data, unsigned int generate_silence)
Wait, look for hangups and condition arg.
Definition: channel.c:1498
◆ ast_senddigit()
| int ast_senddigit | ( | struct ast_channel * | chan, |
| char | digit, | ||
| unsigned int | duration | ||
| ) |
Send a DTMF digit to a channel.
- Parameters
-
chan channel to act upon digit the DTMF digit to send, encoded in ASCII duration the duration of the digit ending in ms
- Precondition
- This must only be called by the channel's media handler thread.
- Returns
- 0 on success, -1 on failure
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 5019 of file channel.c.
References ast_channel_tech(), AST_DEFAULT_EMULATE_DTMF_DURATION, ast_safe_sleep(), ast_senddigit_begin(), and ast_senddigit_end().
Referenced by dial_exec_full(), and dtmf_stream().
int ast_safe_sleep(struct ast_channel *chan, int ms)
Wait, look for hangups.
Definition: channel.c:1574
int ast_senddigit_begin(struct ast_channel *chan, char digit)
Send a DTMF digit to a channel.
Definition: channel.c:4919
int ast_senddigit_end(struct ast_channel *chan, char digit, unsigned int duration)
Send a DTMF digit to a channel.
Definition: channel.c:4969
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_senddigit_begin()
| int ast_senddigit_begin | ( | struct ast_channel * | chan, |
| char | digit | ||
| ) |
Send a DTMF digit to a channel.
- Parameters
-
chan channel to act upon digit the DTMF digit to send, encoded in ASCII
- Returns
- 0 on success, -1 on failure
Definition at line 4919 of file channel.c.
References ast_channel_lock, ast_channel_name(), ast_channel_sending_dtmf_digit_set(), ast_channel_sending_dtmf_tv_set(), ast_channel_tech(), ast_channel_unlock, ast_debug, ast_playtones_start(), and ast_tvnow().
Referenced by ast_senddigit(), ast_senddigit_external(), and ast_write_stream().
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
void ast_channel_sending_dtmf_tv_set(struct ast_channel *chan, struct timeval value)
Definition: channel_internal_api.c:401
const char * ast_channel_name(const struct ast_channel *chan)
int ast_playtones_start(struct ast_channel *chan, int vol, const char *tonelist, int interruptible)
Start playing a list of tones on a channel.
Definition: indications.c:302
void ast_channel_sending_dtmf_digit_set(struct ast_channel *chan, char value)
Definition: channel_internal_api.c:392
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_senddigit_end()
| int ast_senddigit_end | ( | struct ast_channel * | chan, |
| char | digit, | ||
| unsigned int | duration | ||
| ) |
Send a DTMF digit to a channel.
- Parameters
-
chan channel to act upon digit the DTMF digit to send, encoded in ASCII duration the duration of the digit ending in ms
- Returns
- Returns 0 on success, -1 on failure
Definition at line 4969 of file channel.c.
References ast_channel_generator(), ast_channel_lock, ast_channel_sending_dtmf_digit(), ast_channel_sending_dtmf_digit_set(), ast_channel_tech(), ast_channel_unlock, ast_playtones_stop(), and ast_channel_tech::send_digit_end.
Referenced by ast_channel_end_dtmf(), ast_senddigit(), ast_senddigit_external(), and ast_write_stream().
char ast_channel_sending_dtmf_digit(const struct ast_channel *chan)
Definition: channel_internal_api.c:388
int(*const send_digit_end)(struct ast_channel *chan, char digit, unsigned int duration)
Stop sending a literal DTMF digit.
Definition: channel.h:691
void ast_playtones_stop(struct ast_channel *chan)
Stop playing tones on a channel.
Definition: indications.c:393
struct ast_generator * ast_channel_generator(const struct ast_channel *chan)
Definition: channel_internal_api.c:713
void ast_channel_sending_dtmf_digit_set(struct ast_channel *chan, char value)
Definition: channel_internal_api.c:392
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_senddigit_external()
| int ast_senddigit_external | ( | struct ast_channel * | chan, |
| char | digit, | ||
| unsigned int | duration | ||
| ) |
Send a DTMF digit to a channel from an external thread.
- Parameters
-
chan channel to act upon digit the DTMF digit to send, encoded in ASCII duration the duration of the digit ending in ms
- Precondition
- This must only be called by threads that are not the channel's media handler thread.
- Returns
- 0 on success, -1 on failure
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 5032 of file channel.c.
References ast_channel_tech(), AST_DEFAULT_EMULATE_DTMF_DURATION, ast_senddigit_begin(), and ast_senddigit_end().
Referenced by dtmf_stream(), and manager_play_dtmf().
int ast_senddigit_begin(struct ast_channel *chan, char digit)
Send a DTMF digit to a channel.
Definition: channel.c:4919
int ast_senddigit_end(struct ast_channel *chan, char digit, unsigned int duration)
Send a DTMF digit to a channel.
Definition: channel.c:4969
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_senddigit_mf()
| 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.
- Parameters
-
chan channel to act upon digit the MF digit to send, encoded in ASCII duration the duration of a numeric digit ending in ms duration the duration of a KP digit ending in ms duration the duration of a ST, STP, ST2P, or ST3P digit ending in ms is_external 1 if called by a thread that is not the channel's media handler thread, 0 if called by the channel's media handler thread.
- Returns
- 0 on success, -1 on failure
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 4997 of file channel.c.
References ast_channel_tech(), ast_safe_sleep(), ast_senddigit_mf_begin(), ast_senddigit_mf_end(), and DEFAULT_EMULATE_MF_DURATION.
Referenced by mf_stream().
int ast_safe_sleep(struct ast_channel *chan, int ms)
Wait, look for hangups.
Definition: channel.c:1574
int ast_senddigit_mf_begin(struct ast_channel *chan, char digit)
Send an MF digit to a channel.
Definition: channel.c:4880
int ast_senddigit_mf_end(struct ast_channel *chan)
End sending an MF digit to a channel.
Definition: channel.c:4988
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_senddigit_mf_begin()
| int ast_senddigit_mf_begin | ( | struct ast_channel * | chan, |
| char | digit | ||
| ) |
Send an MF digit to a channel.
- Parameters
-
chan channel to act upon digit the MF digit to send, encoded in ASCII
- Returns
- 0 on success, -1 on failure
Definition at line 4880 of file channel.c.
References ast_channel_name(), ast_log, ast_playtones_start(), LOG_WARNING, and mf_tones.
Referenced by ast_senddigit_mf().
4914 ast_log(LOG_WARNING, "Unable to generate MF tone '%c' for '%s'\n", digit, ast_channel_name(chan));
const char * ast_channel_name(const struct ast_channel *chan)
int ast_playtones_start(struct ast_channel *chan, int vol, const char *tonelist, int interruptible)
Start playing a list of tones on a channel.
Definition: indications.c:302
◆ ast_senddigit_mf_end()
| int ast_senddigit_mf_end | ( | struct ast_channel * | chan | ) |
End sending an MF digit to a channel.
- Parameters
-
chan channel to act upon
- Returns
- Returns 0 on success, -1 on failure
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 4988 of file channel.c.
References ast_channel_generator(), and ast_playtones_stop().
Referenced by ast_senddigit_mf(), and mf_stream().
void ast_playtones_stop(struct ast_channel *chan)
Stop playing tones on a channel.
Definition: indications.c:393
struct ast_generator * ast_channel_generator(const struct ast_channel *chan)
Definition: channel_internal_api.c:713
◆ ast_sendtext()
| int ast_sendtext | ( | struct ast_channel * | chan, |
| const char * | text | ||
| ) |
Sends text to a channel.
- Parameters
-
chan channel to act upon text string of text to send on the channel
Write text to a display on a channel
- Note
- The channel does not need to be locked before calling this function.
- Return values
-
0 on success -1 on failure
Definition at line 4854 of file channel.c.
References ARRAY_LEN, ast_free, ast_msg_data_alloc(), AST_MSG_DATA_ATTR_BODY, AST_MSG_DATA_SOURCE_TYPE_UNKNOWN, ast_sendtext_data(), ast_strlen_zero, and ast_msg_data_attribute::type.
Referenced by __ast_read(), handle_sendtext(), sendtext_exec(), and sendtext_safe().
Definition: message.h:458
Definition: message.h:447
Structure used to transport a message through the frame core.
Definition: message.c:1406
struct ast_msg_data * ast_msg_data_alloc(enum ast_msg_data_source_type source, struct ast_msg_data_attribute attributes[], size_t count)
Allocates an ast_msg_data structure.
Definition: message.c:1418
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...
Definition: channel.c:4796
Definition: message.h:462
◆ ast_sendtext_data()
| 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.
- Since
- 13.22.0
- 15.5.0
- Parameters
-
chan channel to act upon msg ast_msg_data structure
Write text to a display on a channel. If the channel driver doesn't support the send_text_data callback. then the original send_text callback will be used if available.
- Note
- The channel does not need to be locked before calling this function.
- Return values
-
0 on success -1 on failure
Definition at line 4796 of file channel.c.
References ast_begins_with(), AST_CHAN_TP_SEND_TEXT_DATA, ast_channel_flags(), ast_channel_lock, ast_channel_name(), ast_channel_nativeformats(), ast_channel_tech(), ast_channel_unlock, ast_check_hangup(), ast_clear_flag, ast_debug, AST_FLAG_BLOCKING, AST_FLAG_ZOMBIE, ast_format_cap_has_type(), ast_format_t140, AST_FRAME_TEXT, ast_frfree, AST_MALLOCD_DATA, AST_MEDIA_TYPE_TEXT, AST_MSG_DATA_ATTR_BODY, AST_MSG_DATA_ATTR_CONTENT_TYPE, AST_MSG_DATA_ATTR_FROM, AST_MSG_DATA_ATTR_TO, ast_msg_data_get_attribute(), ast_strdup, ast_strlen_zero, ast_test_flag, CHECK_BLOCKING, ast_frame::data, ast_frame::datalen, ast_frame_subclass::format, ast_frame::frametype, ast_frame::mallocd, ast_frame::ptr, S_OR, ast_channel_tech::send_text, send_text(), ast_channel_tech::send_text_data, ast_frame::src, ast_frame::subclass, and ast_channel_tech::write_text.
Referenced by __ast_read(), ast_sendtext(), bridge_channel_handle_write(), and sendtext_exec().
4845 ast_debug(1, "Channel technology does not support sending content type '%s' on channel '%s'\n",
Definition: message.h:457
Definition: message.h:458
Channels have this property if they implement send_text_data.
Definition: channel.h:976
Definition: include/asterisk/frame.h:114
Definition: channel.h:986
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
int(*const write_text)(struct ast_channel *chan, struct ast_frame *frame)
Write a text frame, in standard format.
Definition: channel.h:790
Definition: message.h:455
int(*const send_text)(struct ast_channel *chan, const char *text)
Display or transmit text.
Definition: channel.h:757
Definition: message.h:456
const char * ast_msg_data_get_attribute(struct ast_msg_data *msg, enum ast_msg_data_attribute_type attribute_type)
Get attribute from ast_msg_data.
Definition: message.c:1533
Definition: channel.h:988
static void send_text(unsigned char pos, unsigned char inverse, struct unistimsession *pte, const char *text)
Definition: chan_unistim.c:1578
struct ast_format_cap * ast_channel_nativeformats(const struct ast_channel *chan)
Definition: channel_internal_api.c:637
#define S_OR(a, b)
returns the equivalent of logic or for strings: first one if not empty, otherwise second one...
Definition: strings.h:79
const char * ast_channel_name(const struct ast_channel *chan)
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
static int force_inline attribute_pure ast_begins_with(const char *str, const char *prefix)
Definition: strings.h:94
int(*const send_text_data)(struct ast_channel *chan, struct ast_msg_data *data)
Display or transmit text with data.
Definition: channel.h:845
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
Definition: codec.h:35
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
int ast_format_cap_has_type(const struct ast_format_cap *cap, enum ast_media_type type)
Find out if the capabilities structure has any formats of a specific type.
Definition: format_cap.c:615
◆ ast_set_callerid()
| 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.
- Note
- Use ast_channel_set_caller() and ast_channel_set_caller_event() instead.
- The channel does not need to be locked before calling this function.
Definition at line 7434 of file channel.c.
References ast_party_caller::ani, ast_channel_caller(), ast_channel_lock, ast_channel_publish_snapshot(), ast_channel_unlock, ast_free, ast_strdup, ast_party_caller::id, name, ast_party_id::name, ast_party_id::number, ast_party_name::str, ast_party_number::str, ast_party_name::valid, and ast_party_number::valid.
Referenced by __analog_ss_thread(), __ast_request_and_dial(), analog_ss_thread(), ari_channels_handle_originate_with_id(), cb_events(), disa_exec(), get_pai(), get_rpid(), handle_setcallerid(), mgcp_ss(), pbx_outgoing_attempt(), privacy_exec(), ring_entry(), skinny_newcall(), and socket_process_helper().
struct ast_party_caller * ast_channel_caller(struct ast_channel *chan)
Definition: channel_internal_api.c:888
void ast_channel_publish_snapshot(struct ast_channel *chan)
Publish a ast_channel_snapshot for a channel.
Definition: stasis_channels.c:1055
◆ ast_set_hangupsource()
| 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.
- Parameters
-
chan channel to set the field on source a string describing the source of the hangup for this channel force
- Note
- Absolutely NO channel locks should be held before calling this function.
- Since
- 1.8
Hangupsource is generally the channel name that caused the bridge to be hung up, but it can also be other things such as "dialplan/agi" This can then be logged in the CDR or CEL
Definition at line 2504 of file channel.c.
References ast_channel_bridge_peer(), ast_channel_cleanup, ast_channel_hangupsource(), ast_channel_lock, ast_channel_unlock, ast_strlen_zero, and RAII_VAR.
Referenced by __dahdi_exception(), analog_exception(), call(), chan_pjsip_session_end(), func_channel_write_real(), handle_hangup(), pbx_builtin_hangup(), session_inv_on_media_update(), set_hangup_source_and_cause(), and sip_queue_hangup_cause().
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:911
struct ast_channel * ast_channel_bridge_peer(struct ast_channel *chan)
Get the channel's bridge peer only if the bridge is two-party.
Definition: channel.c:10765
const char * ast_channel_hangupsource(const struct ast_channel *chan)
◆ ast_set_party_id_all()
| 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.
- Since
- 11.0
- Parameters
-
update_id The update marker for a corresponding party id.
- Returns
- Nothing
Definition at line 1750 of file channel.c.
References ast_set_party_id::name, ast_set_party_id::number, and ast_set_party_id::subaddress.
Referenced by handle_request_invite(), handle_request_update(), handle_response_invite(), misdn_queue_connected_line_update(), set_redirecting(), and sip_call().
◆ ast_set_read_format()
| int ast_set_read_format | ( | struct ast_channel * | chan, |
| struct ast_format * | format | ||
| ) |
Sets read format on channel chan.
- Parameters
-
chan channel to change format format to set for reading
- Returns
- Returns 0 on success, -1 on failure
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 5849 of file channel.c.
References ao2_cleanup, ast_assert, ast_format_cap_alloc, ast_format_cap_append, AST_FORMAT_CAP_FLAG_DEFAULT, NULL, and set_format().
Referenced by __ast_play_and_record(), adsi_transmit_message_full(), alarmreceiver_exec(), ast_bridge_channel_restore_formats(), ast_channel_make_compatible_helper(), audiosocket_exec(), background_detect_exec(), build_conf(), channel_do_masquerade(), conf_run(), dictate_exec(), do_waiting(), eagi_exec(), fax_detect_framehook(), fax_gateway_framehook(), generic_fax_exec(), handle_recordfile(), handle_speechrecognize(), holding_bridge_join(), ices_exec(), isAnsweringMachine(), jack_exec(), jingle_interpret_content(), jingle_read(), measurenoise(), meetme_menu_admin_extended(), mgcp_rtp_read(), old_milliwatt_exec(), ooh323_new(), ooh323_rtp_read(), ooh323_set_read_format(), ooh323_set_write_format(), process_sdp(), record_exec(), set_caps(), set_read_to_slin(), sip_rtp_read(), skinny_rtp_read(), sms_exec(), socket_process_helper(), speech_background(), transmit_audio(), and unistim_rtp_read().
static int set_format(struct ast_channel *chan, struct ast_format_cap *cap_set, const int direction, int interleaved_stereo)
Definition: channel.c:5680
#define ast_format_cap_append(cap, format, framing)
Definition: format_cap.h:103
Definition: format_cap.h:38
Format capabilities structure, holds formats + preference order + etc.
Definition: format_cap.c:54
◆ ast_set_read_format_from_cap()
| 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.
- Parameters
-
chan channel to change formats new formats to pick from for reading
- Returns
- Returns 0 on success, -1 on failure
Definition at line 5867 of file channel.c.
References set_format().
static int set_format(struct ast_channel *chan, struct ast_format_cap *cap_set, const int direction, int interleaved_stereo)
Definition: channel.c:5680
◆ ast_set_read_format_path()
| 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.
- Since
- 13.4.0
- Parameters
-
chan Channel to setup read path. raw_format Format to expect from the channel driver. core_format What the core wants to read.
- Precondition
- chan is locked
- Return values
-
0 on success. -1 on error.
Definition at line 5575 of file channel.c.
References ast_channel_name(), ast_channel_rawreadformat(), ast_channel_readformat(), ast_channel_readtrans(), ast_channel_readtrans_set(), ast_channel_set_rawreadformat(), ast_channel_set_readformat(), ast_debug, ast_format_cmp(), AST_FORMAT_CMP_EQUAL, ast_format_get_name(), ast_translator_build_path(), ast_translator_free_path(), and NULL.
Referenced by __ast_read(), chan_pjsip_read_stream(), set_softmix_bridge_data(), and softmix_bridge_write_voice().
Definition: format.h:36
void ast_channel_readtrans_set(struct ast_channel *chan, struct ast_trans_pvt *value)
Definition: channel_internal_api.c:757
const char * ast_format_get_name(const struct ast_format *format)
Get the name associated with a format.
Definition: format.c:334
struct ast_trans_pvt * ast_channel_readtrans(const struct ast_channel *chan)
Definition: channel_internal_api.c:753
struct ast_format * ast_channel_readformat(struct ast_channel *chan)
Definition: channel_internal_api.c:856
void ast_channel_set_rawreadformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:828
enum ast_format_cmp_res ast_format_cmp(const struct ast_format *format1, const struct ast_format *format2)
Compare two formats.
Definition: format.c:201
struct ast_trans_pvt * ast_translator_build_path(struct ast_format *dest, struct ast_format *source)
Builds a translator path Build a path (possibly NULL) from source to dest.
Definition: translate.c:485
void ast_channel_set_readformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:836
struct ast_format * ast_channel_rawreadformat(struct ast_channel *chan)
Definition: channel_internal_api.c:848
Default structure for translators, with the basic fields and buffers, all allocated as part of the sa...
Definition: translate.h:213
const char * ast_channel_name(const struct ast_channel *chan)
void ast_translator_free_path(struct ast_trans_pvt *tr)
Frees a translator path Frees the given translator path structure.
Definition: translate.c:475
◆ ast_set_variables()
| void ast_set_variables | ( | struct ast_channel * | chan, |
| struct ast_variable * | vars | ||
| ) |
adds a list of channel variables to a channel
- Parameters
-
chan the channel vars a linked list of variables
- Precondition
- chan is locked
Variable names can be for a regular channel variable or a dialplan function that has the ability to be written to.
Definition at line 8217 of file channel.c.
References ast_variable::name, ast_variable::next, pbx_builtin_setvar_helper(), and ast_variable::value.
Referenced by __ast_request_and_dial(), ari_channels_handle_originate_with_id(), ast_ari_channels_create(), ast_call_forward(), ast_pbx_outgoing_exten_predial(), and pbx_outgoing_attempt().
Structure for variables, used for configurations and for channel variables.
Definition: include/asterisk/config.h:83
int pbx_builtin_setvar_helper(struct ast_channel *chan, const char *name, const char *value)
Add a variable to the channel variable stack, removing the most recently set value for the same name...
Definition: pbx_variables.c:1071
◆ ast_set_write_format()
| int ast_set_write_format | ( | struct ast_channel * | chan, |
| struct ast_format * | format | ||
| ) |
Sets write format on channel chan.
- Parameters
-
chan channel to change format format to set for writing
- Returns
- Returns 0 on success, -1 on failure
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 5890 of file channel.c.
References ao2_cleanup, ast_assert, ast_format_cap_alloc, ast_format_cap_append, AST_FORMAT_CAP_FLAG_DEFAULT, NULL, and set_format().
Referenced by adsi_transmit_message_full(), alarmreceiver_exec(), ast_bridge_channel_restore_formats(), ast_channel_make_compatible_helper(), ast_channel_start_silence_generator(), ast_channel_stop_silence_generator(), ast_stopstream(), ast_write_stream(), audiosocket_exec(), build_conf(), channel_do_masquerade(), chanspy_exec(), conf_run(), dahdiscan_exec(), extenspy_exec(), fax_gateway_framehook(), generic_fax_exec(), handle_participant_join(), jack_exec(), jingle_interpret_content(), jingle_read(), linear_alloc(), linear_release(), meetme_menu_admin_extended(), mgcp_rtp_read(), moh_alloc(), moh_files_release(), moh_files_write_format_change(), moh_release(), mp3_exec(), NBScat_exec(), old_milliwatt_exec(), ooh323_new(), ooh323_rtp_read(), ooh323_set_write_format(), ooh323_write(), participant_reaction_announcer_join(), playtones_alloc(), playtones_release(), process_sdp(), send_waveform_to_channel(), set_caps(), set_softmix_bridge_data(), sip_rtp_read(), skinny_rtp_read(), sms_exec(), socket_process_helper(), tonepair_alloc(), tonepair_release(), transmit_audio(), and unistim_rtp_read().
static int set_format(struct ast_channel *chan, struct ast_format_cap *cap_set, const int direction, int interleaved_stereo)
Definition: channel.c:5680
#define ast_format_cap_append(cap, format, framing)
Definition: format_cap.h:103
Definition: format_cap.h:38
Format capabilities structure, holds formats + preference order + etc.
Definition: format_cap.c:54
◆ ast_set_write_format_from_cap()
| 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.
- Parameters
-
chan channel to change formats new formats to pick from for writing
- Returns
- Returns 0 on success, -1 on failure
Definition at line 5908 of file channel.c.
References set_format().
Referenced by ast_openstream_full().
static int set_format(struct ast_channel *chan, struct ast_format_cap *cap_set, const int direction, int interleaved_stereo)
Definition: channel.c:5680
◆ ast_set_write_format_interleaved_stereo()
| 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)
- Parameters
-
chan channel to change format format to set for writing
- Returns
- Returns 0 on success, -1 on failure
Definition at line 5872 of file channel.c.
References ao2_cleanup, ast_assert, ast_format_cap_alloc, ast_format_cap_append, AST_FORMAT_CAP_FLAG_DEFAULT, NULL, and set_format().
Referenced by set_softmix_bridge_data(), and softmix_bridge_unsuspend().
static int set_format(struct ast_channel *chan, struct ast_format_cap *cap_set, const int direction, int interleaved_stereo)
Definition: channel.c:5680
#define ast_format_cap_append(cap, format, framing)
Definition: format_cap.h:103
Definition: format_cap.h:38
Format capabilities structure, holds formats + preference order + etc.
Definition: format_cap.c:54
◆ ast_set_write_format_path()
| 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.
- Since
- 13.13.0
- Parameters
-
chan Channel to setup write path. core_format What the core wants to write. raw_format Raw write format.
- Precondition
- chan is locked
- Return values
-
0 on success. -1 on error.
Definition at line 5611 of file channel.c.
References ast_channel_name(), ast_channel_rawwriteformat(), ast_channel_set_rawwriteformat(), ast_channel_set_writeformat(), ast_channel_writeformat(), ast_channel_writetrans(), ast_channel_writetrans_set(), ast_debug, ast_format_cmp(), AST_FORMAT_CMP_EQUAL, ast_format_get_name(), ast_translator_build_path(), ast_translator_free_path(), and NULL.
Referenced by chan_pjsip_read_stream().
Definition: format.h:36
void ast_channel_set_writeformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:840
void ast_channel_set_rawwriteformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:832
const char * ast_format_get_name(const struct ast_format *format)
Get the name associated with a format.
Definition: format.c:334
void ast_channel_writetrans_set(struct ast_channel *chan, struct ast_trans_pvt *value)
Definition: channel_internal_api.c:765
enum ast_format_cmp_res ast_format_cmp(const struct ast_format *format1, const struct ast_format *format2)
Compare two formats.
Definition: format.c:201
struct ast_trans_pvt * ast_translator_build_path(struct ast_format *dest, struct ast_format *source)
Builds a translator path Build a path (possibly NULL) from source to dest.
Definition: translate.c:485
struct ast_trans_pvt * ast_channel_writetrans(const struct ast_channel *chan)
Definition: channel_internal_api.c:761
Default structure for translators, with the basic fields and buffers, all allocated as part of the sa...
Definition: translate.h:213
const char * ast_channel_name(const struct ast_channel *chan)
struct ast_format * ast_channel_writeformat(struct ast_channel *chan)
Definition: channel_internal_api.c:860
struct ast_format * ast_channel_rawwriteformat(struct ast_channel *chan)
Definition: channel_internal_api.c:852
void ast_translator_free_path(struct ast_trans_pvt *tr)
Frees a translator path Frees the given translator path structure.
Definition: translate.c:475
◆ ast_settimeout()
| int ast_settimeout | ( | struct ast_channel * | c, |
| unsigned int | rate, | ||
| int(*)(const void *data) | func, | ||
| void * | data | ||
| ) |
Enable or disable timer ticks for a channel.
- Parameters
-
c channel rate number of timer ticks per second func callback function data
If timers are supported, force a scheduled expiration on the timer fd, at which point we call the callback function / data
- Note
- Call this function with a rate of 0 to turn off the timer ticks
- Version
- 1.6.1 changed samples parameter to rate, accomodates new timing methods
Definition at line 3189 of file channel.c.
References ast_settimeout_full().
Referenced by ast_activate_generator(), ast_readaudio_callback(), deactivate_generator_nolock(), and filestream_close().
int ast_settimeout_full(struct ast_channel *c, unsigned int rate, int(*func)(const void *data), void *data, unsigned int is_ao2_obj)
Definition: channel.c:3194
◆ ast_settimeout_full()
| int ast_settimeout_full | ( | struct ast_channel * | c, |
| unsigned int | rate, | ||
| int(*)(const void *data) | func, | ||
| void * | data, | ||
| unsigned int | is_ao2_obj | ||
| ) |
Definition at line 3194 of file channel.c.
References ao2_ref, ast_channel_fdno(), ast_channel_fdno_set(), ast_channel_flags(), ast_channel_lock, ast_channel_timer(), ast_channel_timingdata(), ast_channel_timingdata_set(), ast_channel_timingfd(), ast_channel_timingfunc_set(), ast_channel_unlock, ast_clear_flag, ast_debug, AST_FLAG_TIMINGDATA_IS_AO2_OBJ, ast_set_flag, ast_test_flag, ast_timer_get_max_rate(), ast_timer_set_rate(), AST_TIMING_FD, and NULL.
Referenced by ast_readaudio_callback(), and ast_settimeout().
3215 ast_debug(1, "Scheduling timer at (%u requested / %u actual) timer ticks per second\n", rate, real_rate);
3219 if (ast_channel_timingdata(c) && ast_test_flag(ast_channel_flags(c), AST_FLAG_TIMINGDATA_IS_AO2_OBJ)) {
void ast_channel_fdno_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:423
void ast_channel_timingfunc_set(struct ast_channel *chan, ast_timing_func_t value)
Definition: channel_internal_api.c:1235
unsigned int ast_timer_get_max_rate(const struct ast_timer *handle)
Get maximum rate supported for a timer.
Definition: timing.c:191
Definition: channel.h:1055
void * ast_channel_timingdata(const struct ast_channel *chan)
Definition: channel_internal_api.c:573
int ast_channel_fdno(const struct ast_channel *chan)
Definition: channel_internal_api.c:419
void ast_channel_timingdata_set(struct ast_channel *chan, void *value)
Definition: channel_internal_api.c:577
int ast_channel_timingfd(const struct ast_channel *chan)
Definition: channel_internal_api.c:469
int ast_timer_set_rate(const struct ast_timer *handle, unsigned int rate)
Set the timing tick rate.
Definition: timing.c:166
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
struct ast_timer * ast_channel_timer(const struct ast_channel *chan)
Definition: channel_internal_api.c:737
◆ ast_softhangup()
| int ast_softhangup | ( | struct ast_channel * | chan, |
| int | cause | ||
| ) |
Softly hangup up a channel.
- Parameters
-
chan channel to be soft-hung-up reason an AST_SOFTHANGUP_* reason code
Call the protocol layer, but don't destroy the channel structure (use this if you are trying to safely hangup a channel managed by another thread.
- Note
- The channel passed to this function does not need to be locked.
- Returns
- Returns 0 regardless
Softly hangup up a channel.
Definition at line 2476 of file channel.c.
References ast_channel_hangup_request_type(), ast_channel_lock, ast_channel_publish_blob(), ast_channel_unlock, ast_json_pack(), ast_json_unref(), ast_softhangup_nolock(), NULL, and RAII_VAR.
Referenced by __analog_handle_event(), __ast_module_user_hangup_all(), __ast_pbx_run(), __unload_module(), after_bridge_move_channel(), after_bridge_move_channel_fail(), agent_logoff_request(), agents_sweep(), analog_attempt_transfer(), ast_ari_channels_hangup(), ast_bridge_transfer_attended(), ast_channel_softhangup_cb(), ast_dial_join(), attempt_transfer(), blond_nonfinal_exit(), bridge_channel_attended_transfer(), cc_generic_agent_stop_ringing(), conf_free(), dahdi_handle_event(), handle_hangup(), handle_softhangup(), hangup_channel(), mgcp_pktcgate_remove(), retransfer_exit(), rtp_check_timeout(), sla_handle_hold_event(), softhangup_exec(), stasis_app_bridge_moh_stop(), and unload_module().
struct ast_json * ast_json_pack(char const *format,...)
Helper for creating complex JSON values.
Definition: json.c:591
int ast_softhangup_nolock(struct ast_channel *chan, int cause)
Softly hangup a channel, don't lock.
Definition: channel.c:2463
void ast_json_unref(struct ast_json *value)
Decrease refcount on value. If refcount reaches zero, value is freed.
Definition: json.c:73
#define RAII_VAR(vartype, varname, initval, dtor)
Declare a variable that will call a destructor function when it goes out of scope.
Definition: utils.h:911
Abstract JSON element (object, array, string, int, ...).
void ast_channel_publish_blob(struct ast_channel *chan, struct stasis_message_type *type, struct ast_json *blob)
Publish a channel blob message.
Definition: stasis_channels.c:1135
struct stasis_message_type * ast_channel_hangup_request_type(void)
Message type for when a hangup is requested on a channel.
◆ ast_softhangup_all()
| void ast_softhangup_all | ( | void | ) |
Soft hangup all active channels.
- Since
- 13.3.0
- Returns
- Nothing
Definition at line 493 of file channel.c.
References ao2_callback, ast_channel_softhangup_cb(), NULL, OBJ_MULTIPLE, and OBJ_NODATA.
Referenced by can_safely_quit().
Definition: astobj2.h:1048
static int ast_channel_softhangup_cb(void *obj, void *arg, int flags)
Definition: channel.c:484
Definition: astobj2.h:1053
◆ ast_softhangup_nolock()
| int ast_softhangup_nolock | ( | struct ast_channel * | chan, |
| int | cause | ||
| ) |
Softly hangup up a channel (no channel lock)
- Parameters
-
chan channel to be soft-hung-up reason an AST_SOFTHANGUP_* reason code
Softly hangup up a channel (no channel lock)
Definition at line 2463 of file channel.c.
References ast_channel_blocker(), ast_channel_flags(), ast_channel_name(), ast_channel_softhangup_internal_flag_add(), ast_debug, AST_FLAG_BLOCKING, ast_null_frame, ast_queue_frame(), and ast_test_flag.
Referenced by __analog_handle_event(), app_control_dial(), ast_async_goto(), ast_bridge_join(), ast_channel_softhangup_withcause_locked(), ast_pbx_h_exten_run(), ast_pbx_hangup_handler_run(), ast_softhangup(), attempt_transfer(), check_pendings(), check_rtp_timeout(), dahdi_softhangup_all(), do_monitor(), gosub_run(), internal_bridge_after_cb(), jingle_indicate(), pbx_builtin_hangup(), proc_session_timer(), and sip_indicate().
2465 ast_debug(1, "Soft-Hanging (%#04x) up channel '%s'\n", (unsigned)cause, ast_channel_name(chan));
int ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin)
Queue one or more frames to a channel's frame queue.
Definition: channel.c:1139
Definition: channel.h:986
pthread_t ast_channel_blocker(const struct ast_channel *chan)
Definition: channel_internal_api.c:1213
const char * ast_channel_name(const struct ast_channel *chan)
void ast_channel_softhangup_internal_flag_add(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:1005
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ ast_state2str()
| const char* ast_state2str | ( | enum ast_channel_state | state | ) |
Gives the string form of a given channel state.
- Parameters
-
ast_channel_state state to get the name of
- Returns
- the text form of the binary state given
- Note
- This function is not reentrant.
- Parameters
-
state
Definition at line 642 of file channel.c.
References AST_STATE_BUSY, AST_STATE_DIALING, AST_STATE_DIALING_OFFHOOK, AST_STATE_DOWN, AST_STATE_MUTE, AST_STATE_OFFHOOK, AST_STATE_PRERING, AST_STATE_RESERVED, AST_STATE_RING, AST_STATE_RINGING, AST_STATE_UP, ast_threadstorage_get(), buf, STATE2STR_BUFSIZE, and state2str_threadbuf.
Referenced by ast_channel_snapshot_to_json(), ast_manager_build_channel_state_string_prefix(), cli_channel_print_body(), func_channel_read(), handle_chanlist(), handle_showchan(), mgcp_new(), serialize_showchan(), sip_hangup(), and update_connectedline().
void * ast_threadstorage_get(struct ast_threadstorage *ts, size_t init_size)
Retrieve thread storage.
Definition: threadstorage.h:197
Definition: channelstate.h:36
Definition: channelstate.h:40
Definition: channelstate.h:37
Definition: channelstate.h:47
Definition: channelstate.h:42
Definition: channelstate.h:44
Definition: channelstate.h:45
Definition: channelstate.h:41
Definition: localtime.c:158
Definition: channelstate.h:43
Definition: channelstate.h:39
Definition: channelstate.h:38
◆ ast_str2cause()
| int ast_str2cause | ( | const char * | name | ) |
Convert the string form of a cause code to a number.
- Parameters
-
name string form of the cause
- Returns
- the cause code
Convert the string form of a cause code to a number.
Definition at line 625 of file channel.c.
References ARRAY_LEN.
Referenced by dial_exec_full(), and pbx_builtin_hangup().
◆ ast_tonepair()
| int ast_tonepair | ( | struct ast_channel * | chan, |
| int | freq1, | ||
| int | freq2, | ||
| int | duration, | ||
| int | vol | ||
| ) |
Play a tone pair for a given amount of time
Definition at line 7700 of file channel.c.
References ast_channel_generatordata(), ast_frfree, ast_read(), ast_tonepair_start(), and ast_waitfor().
Referenced by zapateller_exec().
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
int ast_waitfor(struct ast_channel *c, int ms)
Wait for input on a channel.
Definition: channel.c:3171
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
int ast_tonepair_start(struct ast_channel *chan, int freq1, int freq2, int duration, int vol)
Definition: channel.c:7682
◆ ast_tonepair_start()
| int ast_tonepair_start | ( | struct ast_channel * | chan, |
| int | freq1, | ||
| int | freq2, | ||
| int | duration, | ||
| int | vol | ||
| ) |
Start a tone going
Definition at line 7682 of file channel.c.
References ast_activate_generator(), tonepair_def::duration, tonepair_def::freq1, tonepair_def::freq2, and tonepair_def::vol.
Referenced by ast_tonepair(), pbx_builtin_waitexten(), play_dialtone(), and sendnoise().
Definition: channel.c:7562
int ast_activate_generator(struct ast_channel *chan, struct ast_generator *gen, void *params)
Definition: channel.c:2960
◆ ast_tonepair_stop()
| void ast_tonepair_stop | ( | struct ast_channel * | chan | ) |
Stop a tone from playing
Definition at line 7695 of file channel.c.
References ast_deactivate_generator().
Referenced by sendnoise().
void ast_deactivate_generator(struct ast_channel *chan)
Definition: channel.c:2902
◆ ast_transfer()
| int ast_transfer | ( | struct ast_channel * | chan, |
| char * | dest | ||
| ) |
Transfer a channel (if supported).
- Return values
-
-1 on error 0 if not supported 1 if supported and requested
- Parameters
-
chan current channel dest destination extension for transfer
Transfer a channel (if supported).
Called by:
- app_transfer
- the manager interface
Definition at line 6577 of file channel.c.
References ast_transfer_protocol().
Referenced by app_control_redirect().
int ast_transfer_protocol(struct ast_channel *chan, char *dest, int *protocol)
Transfer a call to dest, if the channel supports transfer.
Definition: channel.c:6595
◆ ast_transfer_protocol()
| int ast_transfer_protocol | ( | struct ast_channel * | chan, |
| char * | dest, | ||
| int * | protocol | ||
| ) |
Transfer a channel (if supported) receieve protocol result.
- Return values
-
-1 on error 0 if not supported 1 if supported and requested
- Parameters
-
chan current channel dest destination extension for transfer protocol specific error code in case of failure Example, sip 0 success, else sip error code
Transfer a channel (if supported) receieve protocol result.
- Parameters
-
chan channel to transfer dest destination to transfer to protocol is the protocol result SIP example, 0=success, 3xx-6xx is SIP error code
Called by:
- app_transfer
- the manager interface
Definition at line 6595 of file channel.c.
References ast_channel_flags(), ast_channel_lock, ast_channel_tech(), ast_channel_unlock, ast_check_hangup(), AST_CONTROL_TRANSFER, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, ast_frfree, ast_read(), ast_test_flag, AST_TRANSFER_SUCCESS, ast_waitfor(), ast_frame::data, ast_frame::frametype, ast_frame_subclass::integer, ast_frame::ptr, ast_frame::subclass, transfer, and ast_channel_tech::transfer.
Referenced by ast_transfer(), and transfer_exec().
int(*const transfer)(struct ast_channel *chan, const char *newdest)
Blind transfer other side (see app_transfer.c and ast_transfer()
Definition: channel.h:784
Definition: manager.h:144
Definition: include/asterisk/frame.h:409
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
Definition: include/asterisk/frame.h:105
Definition: channel.h:988
Definition: include/asterisk/frame.h:298
int ast_waitfor(struct ast_channel *c, int ms)
Wait for input on a channel.
Definition: channel.c:3171
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
union ast_frame::@263 data
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ ast_transfercapability2str()
| char* ast_transfercapability2str | ( | int | transfercapability | ) | const |
Gives the string form of a given transfer capability.
- Parameters
-
transfercapability transfer capability to get the name of
- Returns
- the text form of the binary transfer capability
Definition at line 678 of file channel.c.
References AST_TRANS_CAP_3_1K_AUDIO, AST_TRANS_CAP_DIGITAL, AST_TRANS_CAP_DIGITAL_W_TONES, AST_TRANS_CAP_RESTRICTED_DIGITAL, AST_TRANS_CAP_SPEECH, and AST_TRANS_CAP_VIDEO.
Referenced by cb_events(), and misdn_call().
◆ ast_undestroyed_channels()
| int ast_undestroyed_channels | ( | void | ) |
- Returns
- the number of channels not yet destroyed
Definition at line 504 of file channel.c.
References ast_atomic_fetchadd_int(), and chancount.
Referenced by wait_for_channels_to_die().
int ast_atomic_fetchadd_int(volatile int *p, int v)
Atomically add v to *p and return the previous value of *p.
Definition: lock.h:755
◆ ast_unref_namedgroups()
| struct ast_namedgroups* ast_unref_namedgroups | ( | struct ast_namedgroups * | groups | ) |
Definition at line 7832 of file channel.c.
References ao2_cleanup, and NULL.
Referenced by _free_port_cfg(), ast_channel_named_callgroups_set(), ast_channel_named_pickupgroups_set(), build_peer(), check_peer_ok(), create_addr_from_peer(), destroy_dahdi_pvt(), endpoint_destructor(), func_channel_write_real(), mkintf(), named_groups_handler(), process_dahdi(), sip_destroy_peer(), sip_pvt_dtor(), and skinny_line_destroy().
Definition: main/app.c:123
◆ ast_waitfor()
| int ast_waitfor | ( | struct ast_channel * | chan, |
| int | ms | ||
| ) |
Wait for input on a channel.
- Parameters
-
chan channel to wait on ms length of time to wait on the channel
Wait for input on a channel for a given # of milliseconds (<0 for indefinite).
- Return values
-
< 0 on failure 0 if nothing ever arrived the # of ms remaining otherwise
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 3171 of file channel.c.
References ast_waitfor_nandfds(), and NULL.
Referenced by __adsi_transmit_messages(), __analog_ss_thread(), __ast_answer(), __ast_play_and_record(), __ast_request_and_dial(), adsi_careful_send(), analog_ss_thread(), ast_control_tone(), ast_recvtext(), ast_tonepair(), ast_transfer_protocol(), background_detect_exec(), channel_spy(), conf_flush(), destroy_all_channels(), dictate_exec(), disa_exec(), disable_t38(), do_waiting(), echo_exec(), handle_recordfile(), handle_speechrecognize(), ices_exec(), isAnsweringMachine(), jack_exec(), launch_asyncagi(), measurenoise(), moh_channel_thread(), mp3_exec(), NBScat_exec(), read_mf_digits(), read_sf_digits(), receive_dtmf_digits(), receivefax_t38_init(), record_exec(), recordthread(), safe_sleep_conditional(), send_waveform_to_channel(), sendfax_t38_init(), sendurl_exec(), sms_exec(), speech_background(), stasis_app_exec(), stream_echo_perform(), transmit_audio(), transmit_t38(), wait_exec(), wait_for_hangup(), waitforring_exec(), and waitstream_core().
struct ast_channel * ast_waitfor_nandfds(struct ast_channel **c, int n, int *fds, int nfds, int *exception, int *outfd, int *ms)
Wait for x amount of time on a file descriptor to have input.
Definition: channel.c:2997
◆ ast_waitfor_n()
| struct ast_channel* ast_waitfor_n | ( | struct ast_channel ** | chan, |
| int | n, | ||
| int * | ms | ||
| ) |
Waits for input on a group of channels Wait for input on an array of channels for a given # of milliseconds.
- Returns
- Return channel with activity, or NULL if none has activity.
- Parameters
-
chan an array of pointers to channels n number of channels that are to be waited upon ms time "ms" is modified in-place, if applicable
Definition at line 3166 of file channel.c.
References ast_waitfor_nandfds(), and NULL.
Referenced by autoservice_run(), dial_exec_full(), iax2_key_rotate(), misdn_write(), monitor_dial(), wait_for_answer(), and wait_for_winner().
struct ast_channel * ast_waitfor_nandfds(struct ast_channel **c, int n, int *fds, int nfds, int *exception, int *outfd, int *ms)
Wait for x amount of time on a file descriptor to have input.
Definition: channel.c:2997
◆ ast_waitfor_n_fd()
| int ast_waitfor_n_fd | ( | int * | fds, |
| int | n, | ||
| int * | ms, | ||
| int * | exception | ||
| ) |
Waits for input on an fd.
- Note
- This version works on fd's only. Be careful with it.
Waits for input on an fd.
Definition at line 2989 of file channel.c.
References ast_waitfor_nandfds(), and NULL.
Referenced by dundi_lookup_internal(), dundi_precache_internal(), rfcomm_wait(), and softmix_mixing_loop().
struct ast_channel * ast_waitfor_nandfds(struct ast_channel **c, int n, int *fds, int nfds, int *exception, int *outfd, int *ms)
Wait for x amount of time on a file descriptor to have input.
Definition: channel.c:2997
◆ ast_waitfor_nandfds()
| struct ast_channel* ast_waitfor_nandfds | ( | struct ast_channel ** | c, |
| int | n, | ||
| int * | fds, | ||
| int | nfds, | ||
| int * | exception, | ||
| int * | outfd, | ||
| int * | ms | ||
| ) |
Waits for activity on a group of channels.
- Parameters
-
chan an array of pointers to channels n number of channels that are to be waited upon fds an array of fds to wait upon nfds the number of fds to wait upon exception exception flag outfd fd that had activity on it ms how long the wait was
Big momma function here. Wait for activity on any of the n channels, or any of the nfds file descriptors.
- Returns
- Returns the channel with activity, or NULL on error or if an FD came first. If the FD came first, it will be returned in outfd, otherwise, outfd will be -1
Waits for activity on a group of channels.
Definition at line 2997 of file channel.c.
References ast_add_fd(), ast_alloca, ast_channel_fd(), ast_channel_fd_count(), ast_channel_fdno_set(), ast_channel_flags(), ast_channel_lock, ast_channel_name(), ast_channel_softhangup_internal_flag_add(), ast_channel_unlock, ast_channel_whentohangup(), ast_clear_flag, AST_FLAG_BLOCKING, AST_FLAG_EXCEPTION, ast_poll, ast_set_flag, AST_SOFTHANGUP_TIMEOUT, ast_test_suite_event_notify, ast_tvcmp(), ast_tvdiff_ms(), ast_tvnow(), ast_tvsub(), ast_tvzero(), chanlist::chan, CHECK_BLOCKING, errno, max, and NULL.
Referenced by ast_waitfor(), ast_waitfor_n(), ast_waitfor_n_fd(), ast_waitfordigit_full(), audiosocket_run(), bridge_channel_wait(), conf_run(), eivr_comm(), find_cache(), generic_fax_exec(), run_agi(), and waitstream_core().
3114 if (!ast_tvzero(*ast_channel_whentohangup(c[x])) && ast_tvcmp(*ast_channel_whentohangup(c[x]), now) <= 0) {
void ast_channel_fdno_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:423
static int ast_add_fd(struct pollfd *pfd, int fd)
if fd is a valid descriptor, set *pfd with the descriptor
Definition: channel.h:2842
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
int64_t ast_tvdiff_ms(struct timeval end, struct timeval start)
Computes the difference (in milliseconds) between two struct timeval instances.
Definition: time.h:98
struct timeval * ast_channel_whentohangup(struct ast_channel *chan)
Definition: channel_internal_api.c:928
Definition: channel.h:986
#define ast_alloca(size)
call __builtin_alloca to ensure we get gcc builtin semantics
Definition: astmm.h:290
int ast_tvcmp(struct timeval _a, struct timeval _b)
Compres two struct timeval instances returning -1, 0, 1 if the first arg is smaller, equal or greater to the second.
Definition: time.h:128
int errno
Definition: channel.h:1139
int ast_channel_fd(const struct ast_channel *chan, int which)
Definition: channel_internal_api.c:1186
const char * ast_channel_name(const struct ast_channel *chan)
int ast_channel_fd_count(const struct ast_channel *chan)
Retrieve the number of file decriptor positions present on the channel.
Definition: channel_internal_api.c:1195
void ast_channel_softhangup_internal_flag_add(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:1005
struct timeval ast_tvsub(struct timeval a, struct timeval b)
Returns the difference of two timevals a - b.
Definition: extconf.c:2298
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
Definition: channel.h:990
◆ ast_waitfordigit()
| int ast_waitfordigit | ( | struct ast_channel * | c, |
| int | ms | ||
| ) |
Waits for a digit.
- Parameters
-
c channel to wait for a digit on ms how many milliseconds to wait (<0 for indefinite).
- Returns
- Returns <0 on error, 0 on no entry, and the digit on success.
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 3184 of file channel.c.
References ast_waitfordigit_full(), and NULL.
Referenced by __analog_ss_thread(), _while_exec(), adsi_get_cpeid(), adsi_get_cpeinfo(), adsi_print(), adsi_read_encoded_dtmf(), adsi_transmit_message_full(), advanced_options(), analog_my_getsigstr(), analog_ss_thread(), ast_app_dtget(), ast_record_review(), collect_digits(), common_exec(), control_streamfile(), cpeid_exec(), dialout(), directory_exec(), forward_message(), get_folder(), get_folder_ja(), ivr_dispatch(), mgcp_ss(), my_getsigstr(), pbx_builtin_waitexten(), play_record_review(), read_exec(), read_newoption(), readexten_exec(), retrydial_exec(), select_item_menu(), select_item_pause(), select_item_seq(), sendnoise(), testclient_exec(), testserver_exec(), vm_execmain(), vm_forwardoptions(), vm_instructions_en(), vm_instructions_ja(), vm_options(), vm_tempgreeting(), wait_a_bit(), and wait_our_turn().
int ast_waitfordigit_full(struct ast_channel *c, int timeout_ms, const char *breakon, int audiofd, int cmdfd)
Wait for a digit Same as ast_waitfordigit() with audio fd for outputting read audio and ctrlfd to mon...
Definition: channel.c:3248
◆ ast_waitfordigit_full()
| 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.
- Parameters
-
c channel to wait for a digit on ms how many milliseconds to wait (<0 for indefinite). breakon string of DTMF digits to break upon or NULL for any. audiofd audio file descriptor to write to if audio frames are received ctrlfd control file descriptor to monitor for reading
- Returns
- Returns 1 if ctrlfd becomes available
Definition at line 3248 of file channel.c.
References ast_channel_clear_flag(), ast_channel_flags(), ast_channel_set_flag(), ast_check_hangup(), AST_CONTROL_ANSWER, AST_CONTROL_CONNECTED_LINE, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_PVT_CAUSE_CODE, AST_CONTROL_REDIRECTING, AST_CONTROL_RINGING, AST_CONTROL_SRCCHANGE, AST_CONTROL_SRCUPDATE, AST_CONTROL_STREAM_FORWARD, AST_CONTROL_STREAM_RESTART, AST_CONTROL_STREAM_REVERSE, AST_CONTROL_STREAM_STOP, AST_CONTROL_STREAM_SUSPEND, AST_CONTROL_UNHOLD, AST_CONTROL_UPDATE_RTP_PEER, AST_FLAG_END_DTMF_ONLY, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, AST_FRAME_VOICE, ast_frfree, ast_log, ast_read(), ast_remaining_ms(), ast_test_flag, ast_tvnow(), ast_waitfor_nandfds(), ast_frame::data, ast_frame::datalen, errno, ast_frame::frametype, ast_frame_subclass::integer, LOG_WARNING, NULL, ast_frame::ptr, and ast_frame::subclass.
Referenced by ast_readstring_full(), ast_waitfordigit(), handle_getoption(), handle_waitfordigit(), and pbx_builtin_waitdigit().
3281 ast_log(LOG_WARNING, "The FD we were waiting for has something waiting. Waitfordigit returning numeric 1\n");
Definition: include/asterisk/frame.h:293
Definition: channel.h:1008
Definition: include/asterisk/frame.h:286
Definition: include/asterisk/frame.h:281
Definition: include/asterisk/frame.h:101
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
struct ast_channel * ast_waitfor_nandfds(struct ast_channel **c, int n, int *fds, int nfds, int *exception, int *outfd, int *ms)
Wait for x amount of time on a file descriptor to have input.
Definition: channel.c:2997
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
void ast_channel_clear_flag(struct ast_channel *chan, unsigned int flag)
Definition: channel.c:11235
void ast_channel_set_flag(struct ast_channel *chan, unsigned int flag)
Set a flag on a channel.
Definition: channel.c:11228
Definition: include/asterisk/frame.h:105
Definition: include/asterisk/frame.h:99
Definition: include/asterisk/frame.h:278
int ast_remaining_ms(struct timeval start, int max_ms)
Calculate remaining milliseconds given a starting timestamp and upper bound.
Definition: main/utils.c:2033
int errno
Definition: channel.h:988
Definition: include/asterisk/frame.h:294
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
Definition: include/asterisk/frame.h:280
union ast_frame::@263 data
Definition: include/asterisk/frame.h:125
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ ast_write()
| int ast_write | ( | struct ast_channel * | chan, |
| struct ast_frame * | frame | ||
| ) |
Write a frame to a channel This function writes the given frame to the indicated channel.
- Parameters
-
chan destination channel of the frame frame frame that will be written
- Returns
- It returns 0 on success, -1 on failure.
- Examples:
- /usr/src/asterisk-18.5.0/main/app.c.
Definition at line 5189 of file channel.c.
References ast_write_stream().
Referenced by adsi_careful_send(), ast_prod(), ast_readaudio_callback(), ast_readvideo_callback(), AST_TEST_DEFINE(), ast_write_video(), audiosocket_run(), conf_queue_dtmf(), conf_run(), dictate_exec(), echo_exec(), fax_gateway_detect_v21(), fax_generator_generate(), gen_generate(), generic_fax_exec(), handle_jack_audio(), iax2_key_rotate(), jb_get_and_deliver(), linear_generator(), milliwatt_generate(), misdn_write(), moh_files_generator(), moh_generate(), mp3_exec(), NBScat_exec(), playtones_generator(), send_waveform_to_channel(), silence_generator_generate(), sms_generate(), spandsp_fax_gw_t30_gen(), spy_generate(), t38_tx_packet_handler(), tonepair_generator(), and wait_for_answer().
int ast_write_stream(struct ast_channel *chan, int stream_num, struct ast_frame *fr)
Write a frame to a stream This function writes the given frame to the indicated stream on the channel...
Definition: channel.c:5194
◆ ast_write_stream()
| 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.
- Parameters
-
chan destination channel of the frame stream_num destination stream on the channel frame frame that will be written
- Returns
- It returns 0 on success, -1 on failure.
- Note
- If -1 is provided as the stream number and a media frame is provided the function will write to the default stream of the type of media.
Definition at line 5194 of file channel.c.
References apply_plc(), ast_audiohook_detach_list(), AST_AUDIOHOOK_DIRECTION_WRITE, ast_audiohook_write_list(), ast_audiohook_write_list_empty(), ast_channel_audiohooks(), ast_channel_audiohooks_set(), ast_channel_flags(), ast_channel_fout(), ast_channel_fout_set(), ast_channel_framehooks(), ast_channel_generatordata(), ast_channel_get_default_stream(), ast_channel_get_stream_topology(), ast_channel_insmpl(), ast_channel_lock, ast_channel_monitor(), ast_channel_name(), ast_channel_nativeformats(), ast_channel_outsmpl(), ast_channel_outsmpl_set(), ast_channel_rawwriteformat(), ast_channel_softhangup_internal_flag_add(), ast_channel_tech(), ast_channel_trylock, ast_channel_unlock, ast_channel_writeformat(), ast_channel_writetrans(), ast_check_hangup(), ast_clear_flag, AST_CONTROL_UNHOLD, ast_deactivate_generator(), ast_debug, AST_FLAG_BLOCKING, AST_FLAG_WRITE_INT, AST_FLAG_ZOMBIE, ast_format_cache_is_slinear(), ast_format_cap_get_names(), AST_FORMAT_CAP_NAMES_LEN, ast_format_cmp(), AST_FORMAT_CMP_EQUAL, ast_format_get_name(), ast_format_get_sample_rate(), ast_format_get_type(), ast_format_slin, ast_format_t140, AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, ast_frame_dump(), AST_FRAME_HTML, AST_FRAME_IAX, AST_FRAME_MODEM, AST_FRAME_NULL, AST_FRAME_RTCP, AST_FRAME_TEXT, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_framehook_list_write_event(), ast_frfree, ast_frisolate, AST_LIST_NEXT, ast_log, AST_MEDIA_TYPE_IMAGE, AST_MEDIA_TYPE_UNKNOWN, AST_MONITOR_RUNNING, ast_opt_generic_plc, ast_seekstream(), ast_senddigit_begin(), ast_senddigit_end(), ast_set_write_format(), AST_SOFTHANGUP_DEV, ast_str_alloca, ast_stream_get_position(), ast_stream_get_type(), ast_stream_topology_get_count(), ast_stream_topology_get_stream(), ast_test_flag, ast_translate(), ast_writestream(), calc_monitor_jump(), CHECK_BLOCKING, ast_frame::data, ast_frame::datalen, DEBUGCHAN_FLAG, done, DTMF_SENT, ast_frame_subclass::format, FRAMECOUNT_INC, ast_frame::frametype, indicate_data_internal(), ast_frame_subclass::integer, ast_frame::len, LOG_WARNING, chanlist::next, NULL, ast_frame::ptr, ast_frame::samples, SEEK_FORCECUR, send_dtmf_begin_event(), send_dtmf_end_event(), ast_channel_tech::send_html, ast_channel_tech::send_text, ast_frame::src, ast_frame::subclass, tech_write(), type, ast_channel_tech::write, write_stream(), ast_channel_tech::write_stream, ast_channel_tech::write_text, and ast_channel_tech::write_video.
Referenced by AST_TEST_DEFINE(), ast_write(), bridge_channel_handle_write(), and stream_echo_write().
5226 } else if (fr->frametype == AST_FRAME_VOICE || fr->frametype == AST_FRAME_VIDEO || fr->frametype == AST_FRAME_MODEM) {
5243 if ((stream == default_stream) && !(fr = ast_framehook_list_write_event(ast_channel_framehooks(chan), fr))) {
5248 if (ast_channel_generatordata(chan) && (fr->frametype != AST_FRAME_RTCP) && (!fr->src || strcasecmp(fr->src, "ast_prod"))) {
5284 fr = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_WRITE, fr);
5297 new_frame = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_WRITE, fr);
5321 ast_channel_tech(chan)->send_html(chan, fr->subclass.integer, (char *) fr->data.ptr, fr->datalen);
5346 if (ast_opt_generic_plc && ast_format_cmp(fr->subclass.format, ast_format_slin) == AST_FORMAT_CMP_EQUAL) {
5359 f = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_WRITE, fr);
5363 /* If the frame is in the raw write format, then it's easy... just use the frame - otherwise we will have to translate */
5364 if ((stream == default_stream) && ast_format_cmp(fr->subclass.format, ast_channel_rawwriteformat(chan)) != AST_FORMAT_CMP_EQUAL) {
5365 if (ast_format_cmp(ast_channel_writeformat(chan), fr->subclass.format) != AST_FORMAT_CMP_EQUAL) {
5421 new_frame = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_WRITE, cur);
5458 if ((stream == default_stream) && ast_channel_monitor(chan) && ast_channel_monitor(chan)->write_stream) {
5470 ast_log(LOG_WARNING, "Failed to perform seek in monitoring write stream, synchronization between the files may be broken\n");
5472 ast_channel_outsmpl_set(chan, ast_channel_outsmpl(chan) + (ast_channel_insmpl(chan) - ast_channel_outsmpl(chan)) + cur->samples);
5481 if (ast_seekstream(ast_channel_monitor(chan)->write_stream, jump - cur->samples, SEEK_FORCECUR) == -1) {
5482 ast_log(LOG_WARNING, "Failed to perform seek in monitoring write stream, synchronization between the files may be broken\n");
5484 ast_channel_outsmpl_set(chan, ast_channel_outsmpl(chan) + ast_channel_insmpl(chan) - ast_channel_outsmpl(chan));
5537 /* RTCP information is on a per-stream basis and only available on multistream capable channels */
5566 if (ast_channel_audiohooks(chan) && ast_audiohook_write_list_empty(ast_channel_audiohooks(chan))) {
Definition: format.h:36
enum ast_media_type ast_format_get_type(const struct ast_format *format)
Get the media type of a format.
Definition: format.c:354
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
int(*const write_video)(struct ast_channel *chan, struct ast_frame *frame)
Write a frame, in standard format.
Definition: channel.h:787
struct ast_stream_topology * ast_channel_get_stream_topology(const struct ast_channel *chan)
Retrieve the topology of streams on a channel.
Definition: channel_internal_api.c:1583
Definition: include/asterisk/frame.h:114
static int calc_monitor_jump(int samples, int sample_rate, int seek_rate)
calculates the number of samples to jump forward with in a monitor stream.
Definition: channel.c:3516
int(*const write)(struct ast_channel *chan, struct ast_frame *frame)
Write a frame, in standard format (see frame.h)
Definition: channel.h:751
static void send_dtmf_begin_event(struct ast_channel *chan, enum DtmfDirection direction, const char digit)
Definition: channel.c:3378
unsigned int ast_channel_fout(const struct ast_channel *chan)
Definition: channel_internal_api.c:525
void ast_audiohook_detach_list(struct ast_audiohook_list *audiohook_list)
Detach audiohooks from list and destroy said list.
Definition: audiohook.c:594
int ast_audiohook_write_list_empty(struct ast_audiohook_list *audiohook_list)
Determine if a audiohook_list is empty or not.
Definition: audiohook.c:1112
enum ast_media_type ast_stream_get_type(const struct ast_stream *stream)
Get the media type of a stream.
Definition: stream.c:316
struct ast_framehook_list * ast_channel_framehooks(const struct ast_channel *chan)
Definition: channel_internal_api.c:705
unsigned long ast_channel_insmpl(const struct ast_channel *chan)
Definition: channel_internal_api.c:533
Definition: channel.h:4234
Definition: include/asterisk/frame.h:101
#define AST_LIST_NEXT(elm, field)
Returns the next entry in the list after the given entry.
Definition: linkedlists.h:438
static void write_stream(struct ogg_vorbis_desc *s, FILE *f)
Write out any pending encoded data.
Definition: format_ogg_vorbis.c:203
Definition: channel.h:1122
void ast_channel_audiohooks_set(struct ast_channel *chan, struct ast_audiohook_list *value)
Definition: channel_internal_api.c:585
void ast_frame_dump(const char *name, struct ast_frame *f, char *prefix)
Definition: main/frame.c:731
int ast_senddigit_begin(struct ast_channel *chan, char digit)
Send a DTMF digit to a channel.
Definition: channel.c:4919
struct ast_frame * ast_translate(struct ast_trans_pvt *tr, struct ast_frame *f, int consume)
translates one or more frames Apply an input frame into the translator and receive zero or one output...
Definition: translate.c:565
const char * ast_format_get_name(const struct ast_format *format)
Get the name associated with a format.
Definition: format.c:334
struct ast_stream * ast_stream_topology_get_stream(const struct ast_stream_topology *topology, unsigned int position)
Get a specific stream from the topology.
Definition: stream.c:788
Definition: channel.h:986
static int indicate_data_internal(struct ast_channel *chan, int _condition, const void *data, size_t datalen)
Definition: channel.c:4515
Definition: include/asterisk/frame.h:118
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
Definition: codec.h:34
enum ast_format_cmp_res ast_format_cmp(const struct ast_format *format1, const struct ast_format *format2)
Compare two formats.
Definition: format.c:201
int(*const send_html)(struct ast_channel *chan, int subclass, const char *data, int len)
Send HTML data.
Definition: channel.h:763
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.
Definition: channel_internal_api.c:1619
struct ast_trans_pvt * ast_channel_writetrans(const struct ast_channel *chan)
Definition: channel_internal_api.c:761
Definition: codec.h:31
int(*const write_text)(struct ast_channel *chan, struct ast_frame *frame)
Write a text frame, in standard format.
Definition: channel.h:790
static int tech_write(struct ast_channel *chan, struct ast_stream *stream, struct ast_stream *default_stream, struct ast_frame *frame)
Definition: channel.c:5177
int ast_senddigit_end(struct ast_channel *chan, char digit, unsigned int duration)
Send a DTMF digit to a channel.
Definition: channel.c:4969
int(*const send_text)(struct ast_channel *chan, const char *text)
Display or transmit text.
Definition: channel.h:757
Definition: include/asterisk/frame.h:135
static void apply_plc(struct ast_channel *chan, struct ast_frame *frame)
Definition: channel.c:5151
Definition: include/asterisk/frame.h:107
int ast_format_cache_is_slinear(struct ast_format *format)
Determines if a format is one of the cached slin formats.
Definition: format_cache.c:542
Definition: include/asterisk/frame.h:105
Definition: res_rtp_asterisk.c:590
Definition: include/asterisk/frame.h:123
struct ast_frame * ast_audiohook_write_list(struct ast_channel *chan, struct ast_audiohook_list *audiohook_list, enum ast_audiohook_direction direction, struct ast_frame *frame)
Pass a frame off to be handled by the audiohook core.
Definition: audiohook.c:1127
int(*const write_stream)(struct ast_channel *chan, int stream_num, struct ast_frame *frame)
Write a frame on a specific stream, in standard format (see frame.h)
Definition: channel.h:754
Definition: include/asterisk/frame.h:99
The descriptor of a dynamic string XXX storage will be optimized later if needed We use the ts field ...
Definition: strings.h:584
void ast_channel_fout_set(struct ast_channel *chan, unsigned int value)
Definition: channel_internal_api.c:529
const char * ast_format_cap_get_names(const struct ast_format_cap *cap, struct ast_str **buf)
Get the names of codecs of a set of formats.
Definition: format_cap.c:736
struct ast_frame * ast_framehook_list_write_event(struct ast_framehook_list *framehooks, struct ast_frame *frame)
This is used by the channel API push a frame write event to a channel's framehook list...
Definition: framehook.c:313
int ast_seekstream(struct ast_filestream *fs, off_t sample_offset, int whence)
Seeks into stream.
Definition: file.c:1038
Definition: channel.h:984
Definition: channel.h:988
#define ast_frisolate(fr)
Makes a frame independent of any static storage.
Definition: include/asterisk/frame.h:577
void ast_deactivate_generator(struct ast_channel *chan)
Definition: channel.c:2902
Definition: localtime.c:158
int ast_stream_topology_get_count(const struct ast_stream_topology *topology)
Get the number of streams in a topology.
Definition: stream.c:765
struct ast_format_cap * ast_channel_nativeformats(const struct ast_channel *chan)
Definition: channel_internal_api.c:637
Definition: include/asterisk/frame.h:294
static void send_dtmf_end_event(struct ast_channel *chan, enum DtmfDirection direction, const char digit, long duration_ms)
Definition: channel.c:3394
const char * ast_channel_name(const struct ast_channel *chan)
int ast_writestream(struct ast_filestream *fs, struct ast_frame *f)
Writes a frame to a stream.
Definition: file.c:209
Definition: stream.c:81
unsigned int ast_format_get_sample_rate(const struct ast_format *format)
Get the sample rate of a media format.
Definition: format.c:379
Definition: audiohook.h:50
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
void ast_channel_softhangup_internal_flag_add(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:1005
Definition: channel.c:3363
unsigned long ast_channel_outsmpl(const struct ast_channel *chan)
Definition: channel_internal_api.c:541
Definition: include/asterisk/frame.h:125
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
Definition: include/asterisk/frame.h:103
struct ast_audiohook_list * ast_channel_audiohooks(const struct ast_channel *chan)
Definition: channel_internal_api.c:581
int ast_stream_get_position(const struct ast_stream *stream)
Get the position of the stream in the topology.
Definition: stream.c:500
struct ast_format * ast_format_slin
Built-in cached signed linear 8kHz format.
Definition: format_cache.c:41
int ast_set_write_format(struct ast_channel *chan, struct ast_format *format)
Sets write format on channel chan.
Definition: channel.c:5890
struct ast_format * ast_channel_writeformat(struct ast_channel *chan)
Definition: channel_internal_api.c:860
struct ast_channel_monitor * ast_channel_monitor(const struct ast_channel *chan)
Definition: channel_internal_api.c:613
struct ast_format * ast_channel_rawwriteformat(struct ast_channel *chan)
Definition: channel_internal_api.c:852
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
void ast_channel_outsmpl_set(struct ast_channel *chan, unsigned long value)
Definition: channel_internal_api.c:545
Definition: include/asterisk/frame.h:109
◆ ast_write_text()
| 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.
- Parameters
-
chan destination channel of the frame frame frame that will be written
- Returns
- It returns 1 on success, 0 if not implemented, and -1 on failure.
◆ ast_write_video()
| int ast_write_video | ( | struct ast_channel * | chan, |
| struct ast_frame * | frame | ||
| ) |
Write video frame to a channel This function writes the given frame to the indicated channel.
- Parameters
-
chan destination channel of the frame frame frame that will be written
- Returns
- It returns 1 on success, 0 if not implemented, and -1 on failure.
Definition at line 5062 of file channel.c.
References ast_channel_tech(), and ast_write().
int ast_write(struct ast_channel *chan, struct ast_frame *fr)
Write a frame to a channel This function writes the given frame to the indicated channel.
Definition: channel.c:5189
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [1/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | name | ) |
The following string fields result in channel snapshot creation and should have the channel locked when called:
- language
- accountcode
- peeraccount
- linkedid
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [2/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | language | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [3/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | musicclass | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [4/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | latest_musicclass | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [5/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | accountcode | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [6/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | peeraccount | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [7/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | userfield | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [8/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | call_forward | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [9/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | uniqueid | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [10/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | linkedid | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [11/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | parkinglot | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [12/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | hangupsource | ) |
◆ DECLARE_STRINGFIELD_SETTERS_FOR() [13/13]
| DECLARE_STRINGFIELD_SETTERS_FOR | ( | dialcontext | ) |
Variable Documentation
◆ ast_kill_tech
| const struct ast_channel_tech ast_kill_tech |
◆ ast_stream_topology_changed_external
|
static |
Set as the change source reason when a channel stream topology has been changed externally as a result of the remote side renegotiating.
Definition at line 222 of file channel.h.
Referenced by ast_channel_stream_topology_changed_externally().
◆ global_fin
| unsigned long global_fin |
The current value of the debug flags is stored in the two variables global_fin and global_fout (declared in main/channel.c)
Definition at line 95 of file channel.c.
Referenced by __ast_channel_alloc_ap(), and handle_core_set_debug_channel().
◆ global_fout
| unsigned long global_fout |
Definition at line 95 of file channel.c.
Referenced by __ast_channel_alloc_ap(), and handle_core_set_debug_channel().
