int errno
Channel Management. More...
#include "asterisk.h"#include "asterisk/_private.h"#include <sys/time.h>#include <signal.h>#include <math.h>#include "asterisk/paths.h"#include "asterisk/pbx.h"#include "asterisk/frame.h"#include "asterisk/mod_format.h"#include "asterisk/sched.h"#include "asterisk/channel.h"#include "asterisk/musiconhold.h"#include "asterisk/say.h"#include "asterisk/file.h"#include "asterisk/cli.h"#include "asterisk/translate.h"#include "asterisk/manager.h"#include "asterisk/chanvars.h"#include "asterisk/linkedlists.h"#include "asterisk/indications.h"#include "asterisk/causes.h"#include "asterisk/callerid.h"#include "asterisk/utils.h"#include "asterisk/lock.h"#include "asterisk/app.h"#include "asterisk/transcap.h"#include "asterisk/devicestate.h"#include "asterisk/threadstorage.h"#include "asterisk/slinfactory.h"#include "asterisk/audiohook.h"#include "asterisk/framehook.h"#include "asterisk/timing.h"#include "asterisk/autochan.h"#include "asterisk/stringfields.h"#include "asterisk/global_datastores.h"#include "asterisk/channel_internal.h"#include "asterisk/features.h"#include "asterisk/bridge.h"#include "asterisk/test.h"#include "asterisk/stasis_channels.h"#include "asterisk/max_forwards.h"#include "asterisk/stream.h"#include "asterisk/message.h"
Include dependency graph for channel.c:
Go to the source code of this file.
Data Structures | |
| struct | ast_channel_iterator |
| struct | ast_party_id_ies |
| struct | ast_party_name_ies |
| struct | ast_party_number_ies |
| struct | ast_party_redirecting_reason_ies |
| struct | ast_party_subaddress_ies |
| struct | ast_silence_generator |
| struct | backends |
| the list of registered channel types More... | |
| struct | causes_map |
| map AST_CAUSE's to readable string representations More... | |
| struct | chanlist |
| List of channel drivers. More... | |
| struct | external_vars |
| struct | manager_channel_variable |
| List of channel variables to append to all channel-related events. More... | |
| struct | namedgroup_member |
| Named group member structure. More... | |
| struct | plc_ds |
| struct | set_format_access |
| struct | suppress_data |
| struct | tonepair_def |
| struct | tonepair_state |
Macros | |
| #define | AST_DEFAULT_EMULATE_DTMF_DURATION 100 |
| #define | AST_MIN_DTMF_GAP 45 |
| #define | DEFAULT_AMA_FLAGS AST_AMA_DOCUMENTATION |
| #define | DEFAULT_EMULATE_MF_DURATION 55 |
| #define | FORMAT "%-15.15s %-40.40s %-13.13s %-13.13s %-13.13s %-13.13s\n" |
| #define | STATE2STR_BUFSIZE 32 |
Functions | |
| int | __ast_answer (struct ast_channel *chan, unsigned int delay) |
| Answer a channel, with a selectable delay before returning. More... | |
| 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 and linking the channel from the ao2_container. This should only be used when the channel has already been unlinked from the ao2_container. 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... | |
| 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. More... | |
| struct ast_channel * | __ast_dummy_channel_alloc (const char *file, int line, const char *function) |
| static int | __ast_queue_frame (struct ast_channel *chan, struct ast_frame *fin, int head, struct ast_frame *after) |
| static struct ast_frame * | __ast_read (struct ast_channel *chan, int dropaudio, int dropnondefault) |
| 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 attempt to place a call on it. More... | |
| static void | __init_state2str_threadbuf (void) |
| static void | adjust_frame_for_plc (struct ast_channel *chan, struct ast_frame *frame, struct ast_datastore *datastore) |
| static void | apply_plc (struct ast_channel *chan, struct ast_frame *frame) |
| 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... | |
| 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... | |
| 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 cause) |
| Gives the string form of a given hangup cause. More... | |
| void | ast_change_name (struct ast_channel *chan, const char *newname) |
| Change channel name. More... | |
| const char * | ast_channel_amaflags2string (enum ama_flags flag) |
| Convert the enum representation of an AMA flag to a string representation. More... | |
| 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... | |
| static int | ast_channel_by_exten_cb (void *obj, void *arg, void *data, int flags) |
| static int | ast_channel_by_name_cb (void *obj, void *arg, void *data, int flags) |
| static int | ast_channel_by_uniqueid_cb (void *obj, void *arg, void *data, int flags) |
| 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... | |
| 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... | |
| 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... | |
| static int | ast_channel_cmp_cb (void *obj, void *arg, int flags) |
| int | ast_channel_cmpwhentohangup_tv (struct ast_channel *chan, struct timeval offset) |
| Compare a offset with when to hangup channel. More... | |
| int | ast_channel_connected_line_macro (struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const void *connected_info, int is_caller, int is_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 is_frame) |
| Run a connected line interception subroutine and update a channel's connected line information. More... | |
| 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... | |
| int | ast_channel_defer_dtmf (struct ast_channel *chan) |
| Set defer DTMF flag on channel. More... | |
| static void | ast_channel_destructor (void *obj) |
| Free a channel structure. More... | |
| int | ast_channel_early_bridge (struct ast_channel *c0, struct ast_channel *c1) |
| Bridge two channels together (early) More... | |
| 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... | |
| enum ast_channel_error | ast_channel_errno (void) |
| Get error code for latest channel operation. More... | |
| 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... | |
| 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... | |
| struct ast_channel * | ast_channel_get_by_exten (const char *exten, const char *context) |
| Find a channel by extension and context. 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... | |
| 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... | |
| 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... | |
| 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... | |
| 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... | |
| 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... | |
| static int | ast_channel_hash_cb (const void *obj, const int flags) |
| void | ast_channel_inherit_variables (const struct ast_channel *parent, struct ast_channel *child) |
| Inherits channel variable from parent to child channel. 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... | |
| struct ast_channel_iterator * | ast_channel_iterator_all_new (void) |
| Create a new 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_destroy (struct ast_channel_iterator *i) |
| Destroy a channel iterator. More... | |
| struct ast_channel * | ast_channel_iterator_next (struct ast_channel_iterator *i) |
| Get the next channel for a channel iterator. More... | |
| int | ast_channel_make_compatible (struct ast_channel *chan, struct ast_channel *peer) |
| Make the frame formats of two channels compatible. More... | |
| static int | ast_channel_make_compatible_helper (struct ast_channel *from, struct ast_channel *to) |
| Set up translation from one channel to another. More... | |
| 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_name_to_dial_string (char *channel_name) |
| Removes the trailing identifiers from a channel name string. More... | |
| int | ast_channel_queryoption (struct ast_channel *chan, 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... | |
| const char * | ast_channel_reason2str (int reason) |
| return an english explanation of the code returned thru __ast_request_and_dial's 'outstate' argument More... | |
| 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... | |
| 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 new telephony channel in Asterisk. 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_sendhtml (struct ast_channel *chan, int subclass, const char *data, int datalen) |
| Sends HTML on given channel Send HTML or URL on link. More... | |
| int | ast_channel_sendurl (struct ast_channel *chan, 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_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_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... | |
| int | ast_channel_setoption (struct ast_channel *chan, 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 hangup channel. More... | |
| static int | ast_channel_softhangup_cb (void *obj, void *arg, int flags) |
| 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... | |
| 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... | |
| 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... | |
| 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 *chan) |
| 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... | |
| void | ast_channel_undefer_dtmf (struct ast_channel *chan) |
| Unset defer DTMF flag on channel. More... | |
| 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 channel driver. 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... | |
| struct ast_channel * | ast_channel_yank (struct ast_channel *yankee) |
| Gain control of a channel in the system. More... | |
| int | ast_channels_init (void) |
| struct ast_variable * | ast_channeltype_list (void) |
| return an ast_variable list of channeltypes More... | |
| int | ast_check_hangup (struct ast_channel *chan) |
| Checks 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 void | ast_dummy_channel_destructor (void *obj) |
| Free a dummy channel structure. More... | |
| const struct ast_channel_tech * | ast_get_channel_tech (const char *name) |
| Get handle to channel driver based on 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) |
| Hangup 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... | |
| void | ast_install_music_functions (int(*start_ptr)(struct ast_channel *, const char *, const char *), void(*stop_ptr)(struct ast_channel *), void(*cleanup_ptr)(struct ast_channel *)) |
| int | ast_is_deferrable_frame (const struct ast_frame *frame) |
| Should we keep this frame for later? More... | |
| void | ast_moh_cleanup (struct ast_channel *chan) |
| int | ast_moh_start (struct ast_channel *chan, const char *mclass, const char *interpclass) |
| Turn on music on hold on a given channel. More... | |
| void | ast_moh_stop (struct ast_channel *chan) |
| Turn off music on hold on a given channel. 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 group and pickup group —. More... | |
| char * | ast_print_namedgroups (struct ast_str **buf, struct ast_namedgroups *group) |
| 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. 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 *fin) |
| Queue one or more frames to a channel's frame queue. More... | |
| 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. More... | |
| int | ast_queue_hangup (struct ast_channel *chan) |
| Queue a hangup frame for channel. More... | |
| int | ast_queue_hangup_with_cause (struct ast_channel *chan, int cause) |
| Queue a hangup frame for channel. 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... | |
| static void | ast_read_generator_actions (struct ast_channel *chan, struct ast_frame *f) |
| 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 ftimeout, char *enders) |
| Reads multiple digits. More... | |
| int | ast_readstring_full (struct ast_channel *c, char *s, int len, int timeout, int ftimeout, char *enders, int audiofd, int ctrlfd) |
| int | ast_recvchar (struct ast_channel *chan, int timeout) |
| Receives a text character from a channel. 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 *outstate, const char *cidnum, const char *cidname) |
| Request a channel of a given type, with data as optional information used by the low level module and attempt to place a call on it. 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, look for hangups. More... | |
| int | ast_safe_sleep_conditional (struct ast_channel *chan, int timeout_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_say_character_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang, enum ast_say_case_sensitivity sensitivity) |
| function to pronounce character and phonetic strings More... | |
| int | ast_say_digit_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang) |
| says digits of a string More... | |
| int | ast_say_digits (struct ast_channel *chan, int num, const char *ints, const char *lang) |
| says digits More... | |
| int | ast_say_digits_full (struct ast_channel *chan, int num, const char *ints, const char *lang, int audiofd, int ctrlfd) |
| Same as ast_say_digits() with audiofd for received audio and returns 1 on ctrlfd being readable. More... | |
| int | ast_say_enumeration (struct ast_channel *chan, int num, const char *ints, const char *language, const char *options) |
| says an enumeration More... | |
| int | ast_say_money_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang) |
| function to pronounce monetary amounts More... | |
| int | ast_say_number (struct ast_channel *chan, int num, const char *ints, const char *language, const char *options) |
| says a number More... | |
| int | ast_say_phonetic_str (struct ast_channel *chan, const char *str, const char *ints, const char *lang) |
| int | ast_senddigit (struct ast_channel *chan, char digit, unsigned int duration) |
| Send a DTMF digit to a channel. 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 *cap) |
| 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 *cap) |
| 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_setstate (struct ast_channel *chan, enum ast_channel_state state) |
| Change the state of a 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 cause) |
| Softly hangup a channel, lock. More... | |
| void | ast_softhangup_all (void) |
| Soft hangup all active channels. More... | |
| int | ast_softhangup_nolock (struct ast_channel *chan, int cause) |
| Softly hangup a channel, don't lock. More... | |
| const char * | ast_state2str (enum ast_channel_state state) |
| Gives the string form of a given channel state. More... | |
| int | ast_str2cause (const char *name) |
| Convert a symbolic hangup cause to number. More... | |
| AST_THREADSTORAGE_RAW (in_intercept_routine) | |
| 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 call to dest, if the channel supports transfer. More... | |
| int | ast_transfer_protocol (struct ast_channel *chan, char *dest, int *protocol) |
| Transfer a call to dest, if the channel supports transfer. More... | |
| char * | ast_transfercapability2str (int transfercapability) |
| Gives the string form of a given transfer capability. More... | |
| int | ast_undestroyed_channels (void) |
| void | ast_uninstall_music_functions (void) |
| struct ast_namedgroups * | ast_unref_namedgroups (struct ast_namedgroups *groups) |
| int | ast_waitfor (struct ast_channel *c, int ms) |
| Wait for input on a channel. More... | |
| struct ast_channel * | ast_waitfor_n (struct ast_channel **c, int n, int *ms) |
| Waits for input on a group of channels Wait for input on an array of channels for a given # of milliseconds. More... | |
| int | ast_waitfor_n_fd (int *fds, int n, int *ms, int *exception) |
| Wait for x amount of time on a file descriptor to have input. More... | |
| 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. More... | |
| int | ast_waitfordigit (struct ast_channel *c, int ms) |
| Waits for a digit. More... | |
| 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 monitor for reading. More... | |
| 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. More... | |
| 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. More... | |
| int | ast_write_video (struct ast_channel *chan, struct ast_frame *fr) |
| Write video frame to a channel This function writes the given frame to the indicated channel. More... | |
| 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. More... | |
| static void | call_forward_inherit (struct ast_channel *new_chan, struct ast_channel *parent, struct ast_channel *orig) |
| static void * | channel_cc_params_copy (void *data) |
| static void | channel_cc_params_destroy (void *data) |
| static void | channel_do_masquerade (struct ast_channel *original, struct ast_channel *clonechan) |
| Masquerade a channel. More... | |
| static int | channel_feature_hooks_set_full (struct ast_channel *chan, struct ast_bridge_features *features, int replace) |
| static struct varshead * | channel_get_external_vars (struct external_vars *channelvars, struct ast_channel *chan) |
| static int | channel_has_external_vars (struct external_vars *channelvars) |
| static void | channel_req_accountcodes (struct ast_channel *chan, const struct ast_channel *requestor, enum ast_channel_requestor_relationship relationship, int precious) |
| static void | channel_set_external_vars (struct external_vars *channelvars, size_t varc, char **vars) |
| static void | channel_set_intercept_mode (int in_intercept_mode) |
| static void | channels_shutdown (void) |
| static void | clone_variables (struct ast_channel *original, struct ast_channel *clonechan) |
| Clone channel variables from 'clone' channel into 'original' channel. More... | |
| static char * | complete_channeltypes (struct ast_cli_args *a) |
| static void | deactivate_generator_nolock (struct ast_channel *chan) |
| static int | deactivate_silence_generator (struct ast_channel *chan) |
| static void | destroy_hooks (struct ast_channel *chan) |
| static int | does_id_conflict (const char *uniqueid) |
| static const char * | dtmf_direction_to_string (enum DtmfDirection direction) |
| static void | features_destroy (void *obj) |
| static void | free_external_channelvars (struct external_vars *channelvars) |
| static void | free_translation (struct ast_channel *clonechan) |
| static int | generator_force (const void *data) |
| static void | generator_write_format_change (struct ast_channel *chan) |
| static void | handle_cause (int cause, int *outstate) |
| static char * | handle_cli_core_show_channeltype (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a) |
| Show details about a channel driver - CLI command. More... | |
| static char * | handle_cli_core_show_channeltypes (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a) |
| Show channel types - CLI command. More... | |
| static int | indicate_connected_line (struct ast_channel *chan, const void *data, size_t datalen) |
| static int | indicate_data_internal (struct ast_channel *chan, int _condition, const void *data, size_t datalen) |
| static int | indicate_redirecting (struct ast_channel *chan, const void *data, size_t datalen) |
| static int attribute_const | is_visible_indication (enum ast_control_frame_type condition) |
| static struct ast_frame * | kill_exception (struct ast_channel *chan) |
| static int | kill_fixup (struct ast_channel *oldchan, struct ast_channel *newchan) |
| static int | kill_hangup (struct ast_channel *chan) |
| static struct ast_frame * | kill_read (struct ast_channel *chan) |
| static int | kill_write (struct ast_channel *chan, struct ast_frame *frame) |
| static int | namedgroup_cmp_cb (void *obj, void *arg, int flags) |
| Comparison function used for named group container. More... | |
| static int | namedgroup_hash_cb (const void *obj, const int flags) |
| Hashing function used for named group container. More... | |
| static int | namedgroup_match (void *obj, void *arg, int flags) |
| 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) |
| static int | party_name_build_data (unsigned char *data, size_t datalen, const struct ast_party_name *name, const char *label, const struct ast_party_name_ies *ies) |
| static int | party_number_build_data (unsigned char *data, size_t datalen, const struct ast_party_number *number, const char *label, const struct ast_party_number_ies *ies) |
| static int | party_subaddress_build_data (unsigned char *data, size_t datalen, const struct ast_party_subaddress *subaddress, const char *label, const struct ast_party_subaddress_ies *ies) |
| static void | plc_ds_destroy (void *data) |
| static void | prnt_channel_key (void *v_obj, void *where, ao2_prnt_fn *prnt) |
| static void | queue_dtmf_readq (struct ast_channel *chan, struct ast_frame *f) |
| 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) |
| 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) |
| 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. More... | |
| static void | send_dtmf_begin_event (struct ast_channel *chan, enum DtmfDirection direction, const char digit) |
| static void | send_dtmf_end_event (struct ast_channel *chan, enum DtmfDirection direction, const char digit, long duration_ms) |
| static void | send_flash_event (struct ast_channel *chan) |
| static void | set_channel_answer_time (struct ast_channel *chan) |
| static int | set_format (struct ast_channel *chan, struct ast_format_cap *cap_set, const int direction, int interleaved_stereo) |
| static int | set_security_requirements (const struct ast_channel *requestor, struct ast_channel *out) |
| static int | should_skip_dtmf (struct ast_channel *chan) |
| Determine whether or not we should ignore DTMF in the readq. More... | |
| 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 no voice frames are received during dtmf processing (direct media or muted sender case using SIP INFO) More... | |
| static void * | silence_generator_alloc (struct ast_channel *chan, void *data) |
| static int | silence_generator_generate (struct ast_channel *chan, void *data, int len, int samples) |
| static void | silence_generator_release (struct ast_channel *chan, void *data) |
| static void | suppress_datastore_destroy_cb (void *data) |
| static void | suppress_framehook_destroy_cb (void *data) |
| static struct ast_frame * | suppress_framehook_event_cb (struct ast_channel *chan, struct ast_frame *frame, enum ast_framehook_event event, void *data) |
| static void | suppress_framehook_fixup_cb (void *data, int framehook_id, struct ast_channel *old_chan, struct ast_channel *new_chan) |
| static const struct ast_datastore_info * | suppress_get_datastore_information (enum ast_frame_type frametype) |
| static int | tech_write (struct ast_channel *chan, struct ast_stream *stream, struct ast_stream *default_stream, struct ast_frame *frame) |
| static void * | tonepair_alloc (struct ast_channel *chan, void *params) |
| static int | tonepair_generator (struct ast_channel *chan, void *data, int len, int samples) |
| static void | tonepair_release (struct ast_channel *chan, void *params) |
| static void | varshead_dtor (void *obj) |
| Destructor for lists of variables. More... | |
Variables | |
| static struct external_vars | ami_vars |
| static struct external_vars | ari_vars |
| const struct ast_channel_tech | ast_kill_tech |
| Kill the channel channel driver technology descriptor. More... | |
| static void(* | ast_moh_cleanup_ptr )(struct ast_channel *) = NULL |
| static int(* | ast_moh_start_ptr )(struct ast_channel *, const char *, const char *) = NULL |
| static void(* | ast_moh_stop_ptr )(struct ast_channel *) = NULL |
| static struct backends | backends = { .first = NULL, .last = NULL, .lock = { PTHREAD_RWLOCK_INITIALIZER , NULL, {1, 0} } , } |
| static const struct ast_datastore_info | bridge_features_info |
| static const struct causes_map | causes [] |
| static const struct ast_datastore_info | cc_channel_datastore_info |
| static int | chancount |
| static ast_mutex_t | channel_move_lock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} } |
| static struct ao2_container * | channels |
| All active channels on the system. More... | |
| static struct ast_cli_entry | cli_channel [] |
| unsigned long | global_fin |
| unsigned long | global_fout |
| static const struct ast_channel_tech | null_tech |
| static const struct ast_datastore_info | plc_ds_info |
| static const struct set_format_access | set_format_access_read |
| static const struct set_format_access | set_format_access_write |
| static struct ast_generator | silence_generator |
| static struct ast_threadstorage | state2str_threadbuf = { .once = PTHREAD_ONCE_INIT , .key_init = __init_state2str_threadbuf , .custom_init = NULL , } |
| static const struct ast_datastore_info | suppress_datastore_voice |
| static const struct ast_channel_tech | surrogate_tech |
| Channel technology used to extract a channel from a running application. The channel created with this technology will be immediately hung up - most external applications won't ever want to see this. More... | |
| static struct ast_generator | tonepair |
Detailed Description
Channel Management.
Definition in file channel.c.
Macro Definition Documentation
◆ AST_DEFAULT_EMULATE_DTMF_DURATION
| #define AST_DEFAULT_EMULATE_DTMF_DURATION 100 |
Default amount of time to use when emulating a DTMF digit as a begin and end 100ms
Definition at line 102 of file channel.c.
Referenced by __ast_read(), ast_senddigit(), and ast_senddigit_external().
◆ AST_MIN_DTMF_GAP
| #define AST_MIN_DTMF_GAP 45 |
Minimum amount of time between the end of the last digit and the beginning of a new one - 45ms
Definition at line 112 of file channel.c.
Referenced by __ast_read(), should_skip_dtmf(), and should_trigger_dtmf_emulating().
◆ DEFAULT_AMA_FLAGS
| #define DEFAULT_AMA_FLAGS AST_AMA_DOCUMENTATION |
Definition at line 108 of file channel.c.
Referenced by __ast_channel_alloc_ap(), and ast_channel_string2amaflag().
◆ DEFAULT_EMULATE_MF_DURATION
| #define DEFAULT_EMULATE_MF_DURATION 55 |
Default amount of time to use when emulating an MF digit as a begin and end 55ms
Definition at line 106 of file channel.c.
Referenced by ast_senddigit_mf().
◆ FORMAT
| #define FORMAT "%-15.15s %-40.40s %-13.13s %-13.13s %-13.13s %-13.13s\n" |
Referenced by handle_cli_core_show_channeltypes().
◆ STATE2STR_BUFSIZE
| #define STATE2STR_BUFSIZE 32 |
Definition at line 98 of file channel.c.
Referenced by ast_state2str().
Enumeration Type Documentation
◆ anonymous enum
| anonymous enum |
Element identifiers for connected line indication frame data.
- Note
- Only add to the end of this enum.
Definition at line 8757 of file channel.c.
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: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
◆ anonymous enum
| anonymous enum |
Element identifiers for redirecting indication frame data.
- Note
- Only add to the end of this enum.
Definition at line 9232 of file channel.c.
Definition: channel.c:9264
Definition: channel.c:9253
Definition: channel.c:9274
Definition: channel.c:9266
Definition: channel.c:9259
Definition: channel.c:9270
Definition: channel.c:9251
Definition: channel.c:9280
Definition: channel.c:9241
Definition: channel.c:9239
Definition: channel.c:9240
Definition: channel.c:9235
Definition: channel.c:9233
Definition: channel.c:9272
Definition: channel.c:9320
Definition: channel.c:9273
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
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
◆ DtmfDirection
| enum DtmfDirection |
| Enumerator | |
|---|---|
| DTMF_RECEIVED | |
| DTMF_SENT | |
Definition at line 3361 of file channel.c.
Definition: channel.c:3362
Definition: channel.c:3363
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_change_name_nolink()
|
static |
this function simply changes the name of the channel and issues a manager_event with out unlinking and linking the channel from the ao2_container. This should only be used when the channel has already been unlinked from the ao2_container.
Definition at line 6839 of file channel.c.
References ast_channel_name(), ast_channel_name_set(), ast_channel_uniqueid(), ast_manager_event, and EVENT_FLAG_CALL.
Referenced by ast_change_name().
#define ast_manager_event(chan, category, event, contents,...)
Definition: manager.h:250
const char * ast_channel_uniqueid(const struct ast_channel *chan)
Definition: channel_internal_api.c:305
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.
◆ __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_channel_alloc_ap()
|
static |
Create a new channel structure.
Definition at line 739 of file channel.c.
References __ast_channel_internal_alloc(), ao2_link_flags, ao2_lock, ao2_ref, ao2_unlock, AST_ALERT_FD, AST_AMA_NONE, ast_atomic_fetchadd_int(), ast_channel_amaflags_set(), ast_channel_autochans(), ast_channel_caller(), ast_channel_connected(), ast_channel_connected_indicated(), ast_channel_context_set(), ast_channel_creationtime_set(), ast_channel_datastores(), ast_channel_destructor(), ast_channel_dialed(), AST_CHANNEL_ERROR_ID_EXISTS, ast_channel_exten_set(), ast_channel_fin_set(), ast_channel_fout_set(), ast_channel_hold_state_set(), ast_channel_internal_alert_readfd(), ast_channel_internal_alertpipe_clear(), ast_channel_internal_alertpipe_init(), ast_channel_internal_errno_set(), ast_channel_internal_fd_clear_all(), ast_channel_internal_finalize(), ast_channel_internal_set_stream_topology(), ast_channel_internal_setup_topics(), ast_channel_lock, ast_channel_name(), ast_channel_name_set(), ast_channel_nativeformats_set(), ast_channel_priority_set(), ast_channel_redirecting(), ast_channel_sched_set(), ast_channel_set_fd(), ast_channel_set_rawreadformat(), ast_channel_set_rawwriteformat(), ast_channel_set_readformat(), ast_channel_set_writeformat(), ast_channel_stage_snapshot(), ast_channel_stage_snapshot_done(), ast_channel_state_set(), ast_channel_streamid_set(), ast_channel_tech_set(), ast_channel_timer(), ast_channel_timer_set(), ast_channel_timingfd(), ast_channel_timingfd_set(), ast_channel_unlock, ast_channel_unref, ast_channel_varshead(), ast_channel_vstreamid_set(), AST_CONTROL_UNHOLD, ast_debug, ast_defaultlanguage, ast_endpoint_add_channel(), ast_format_cap_alloc, ast_format_cap_append, AST_FORMAT_CAP_FLAG_DEFAULT, ast_format_none, ast_get_channel_tech(), AST_LIST_HEAD_INIT_NOLOCK, ast_log, ast_party_caller_init(), ast_party_connected_line_init(), ast_party_dialed_init(), ast_party_redirecting_init(), ast_pbx_hangup_handler_init(), ast_sched_context_create(), ast_shutting_down(), ast_strdup, ast_strdupa, ast_stream_topology_alloc(), ast_strlen_zero, ast_timer_fd(), ast_timer_get_name(), ast_timer_open(), AST_TIMING_FD, ast_tvnow(), chancount, cid_name, cid_num, context, DEFAULT_AMA_FLAGS, does_id_conflict(), exten, make_ari_stubs::file, global_fin, global_fout, ast_party_caller::id, LOG_WARNING, name, ast_party_id::name, NULL, ast_party_id::number, OBJ_NOLOCK, S_OR, ast_party_name::str, ast_party_number::str, chanlist::tech, timer, tmp(), ast_party_name::valid, and ast_party_number::valid.
Referenced by __ast_channel_alloc().
867 /* Almost every channel is calling this function, and setting the name via the ast_string_field_build() call.
869 * This means, to set the name here, we have to accept variable args, and call the string_field_build from here.
871 * uses them to build the string, instead of forming the va_lists internally from the vararg ... list.
930 if (assignedids && (does_id_conflict(assignedids->uniqueid) || does_id_conflict(assignedids->uniqueid2))) {
Definition: channel.h:1179
struct ast_party_caller * ast_channel_caller(struct ast_channel *chan)
Definition: channel_internal_api.c:888
void ast_channel_internal_alertpipe_clear(struct ast_channel *chan)
Definition: channel_internal_api.c:1135
void ast_party_caller_init(struct ast_party_caller *init)
Initialize the given caller structure.
Definition: channel.c:1978
void ast_channel_timer_set(struct ast_channel *chan, struct ast_timer *value)
Definition: channel_internal_api.c:741
int ast_channel_internal_alert_readfd(struct ast_channel *chan)
Definition: channel_internal_api.c:1150
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
void ast_pbx_hangup_handler_init(struct ast_channel *chan)
Init the hangup handler container on a channel.
Definition: pbx_hangup_handler.c:95
void ast_party_connected_line_init(struct ast_party_connected_line *init)
Initialize the given connected line structure.
Definition: channel.c:2022
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
void ast_channel_internal_errno_set(enum ast_channel_error error)
Definition: channel_internal_api.c:1563
struct varshead * ast_channel_varshead(struct ast_channel *chan)
Definition: channel_internal_api.c:932
Definition: timing.c:54
void ast_channel_internal_fd_clear_all(struct ast_channel *chan)
Definition: channel_internal_api.c:1182
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
void ast_party_dialed_init(struct ast_party_dialed *init)
Initialize the given dialed structure.
Definition: channel.c:1928
Definition: channel.h:5024
void ast_channel_tech_set(struct ast_channel *chan, const struct ast_channel_tech *value)
Definition: channel_internal_api.c:773
void ast_channel_set_rawreadformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:828
void ast_channel_nativeformats_set(struct ast_channel *chan, struct ast_format_cap *value)
Definition: channel_internal_api.c:677
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_readformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:836
struct ast_datastore_list * ast_channel_datastores(struct ast_channel *chan)
Definition: channel_internal_api.c:868
#define ast_format_cap_append(cap, format, framing)
Definition: format_cap.h:103
void ast_channel_amaflags_set(struct ast_channel *chan, enum ama_flags value)
Definition: channel_internal_api.c:411
Definition: sched.c:109
Structure to describe a channel "technology", ie a channel driver See for examples: ...
Definition: channel.h:629
int ast_endpoint_add_channel(struct ast_endpoint *endpoint, struct ast_channel *chan)
Adds a channel to the given endpoint.
Definition: main/endpoints.c:164
Definition: format_cap.h:38
struct ast_sched_context * ast_sched_context_create(void)
Create a scheduler context.
Definition: sched.c:236
Definition: stream.c:123
int ast_channel_timingfd(const struct ast_channel *chan)
Definition: channel_internal_api.c:469
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_party_redirecting_init(struct ast_party_redirecting *init)
Initialize the given redirecting structure.
Definition: channel.c:2122
Format capabilities structure, holds formats + preference order + etc.
Definition: format_cap.c:54
int ast_channel_internal_alertpipe_init(struct ast_channel *chan)
Definition: channel_internal_api.c:1145
struct ast_stream_topology * ast_stream_topology_alloc(void)
Create a stream topology.
Definition: stream.c:650
void ast_channel_streamid_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:465
Definition: chanvars.h:34
struct ast_party_dialed * ast_channel_dialed(struct ast_channel *chan)
Definition: channel_internal_api.c:904
void ast_channel_fout_set(struct ast_channel *chan, unsigned int value)
Definition: channel_internal_api.c:529
const struct ast_channel_tech * ast_get_channel_tech(const char *name)
Get handle to channel driver based on name.
Definition: channel.c:592
struct ast_autochan_list * ast_channel_autochans(struct ast_channel *chan)
Definition: channel_internal_api.c:872
void ast_channel_timingfd_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:473
Definition: localtime.c:158
int ast_timer_fd(const struct ast_timer *handle)
Get a poll()-able file descriptor for a timer.
Definition: timing.c:161
struct ast_party_redirecting * ast_channel_redirecting(struct ast_channel *chan)
Definition: channel_internal_api.c:908
void ast_channel_exten_set(struct ast_channel *chan, const char *value)
Definition: channel_internal_api.c:357
void ast_channel_creationtime_set(struct ast_channel *chan, struct timeval *value)
Definition: channel_internal_api.c:980
#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_context_set(struct ast_channel *chan, const char *value)
Definition: channel_internal_api.c:348
#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_state_set(struct ast_channel *chan, enum ast_channel_state)
Definition: channel_internal_api.c:820
void ast_channel_sched_set(struct ast_channel *chan, struct ast_sched_context *value)
Definition: channel_internal_api.c:733
void ast_channel_hold_state_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:489
void ast_channel_fin_set(struct ast_channel *chan, unsigned int value)
Definition: channel_internal_api.c:521
const char * ast_timer_get_name(const struct ast_timer *handle)
Get name of timer in use.
Definition: timing.c:196
void ast_channel_name_set(struct ast_channel *chan, const char *name)
Set the channel name.
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
void ast_channel_priority_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:448
struct ast_party_connected_line * ast_channel_connected_indicated(struct ast_channel *chan)
Definition: channel_internal_api.c:896
void ast_channel_internal_finalize(struct ast_channel *chan)
Definition: channel_internal_api.c:1492
void ast_channel_vstreamid_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:497
void ast_channel_set_fd(struct ast_channel *chan, int which, int fd)
Definition: channel.c:2431
struct ast_timer * ast_channel_timer(const struct ast_channel *chan)
Definition: channel_internal_api.c:737
void ast_channel_internal_set_stream_topology(struct ast_channel *chan, struct ast_stream_topology *topology)
Definition: channel_internal_api.c:658
◆ __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_queue_frame()
|
static |
Definition at line 1015 of file channel.c.
References ast_channel_alert_writable(), ast_channel_alert_write(), ast_channel_blocker(), ast_channel_flags(), ast_channel_internal_alert_read(), ast_channel_lock, ast_channel_name(), ast_channel_readq(), ast_channel_timer(), ast_channel_timingfd(), ast_channel_unlock, AST_CONTROL_END_OF_Q, AST_CONTROL_HANGUP, AST_FLAG_BLOCKING, AST_FRAME_CONTROL, AST_FRAME_NULL, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_frdup, ast_frfree, AST_LIST_APPEND_LIST, AST_LIST_FIRST, AST_LIST_HEAD_INIT_NOLOCK, AST_LIST_HEAD_NOLOCK(), AST_LIST_INSERT_LIST_AFTER, AST_LIST_INSERT_TAIL, AST_LIST_LAST, AST_LIST_NEXT, AST_LIST_REMOVE, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_log, ast_test_flag, ast_timer_enable_continuous(), errno, frames, ast_frame::frametype, ast_frame_subclass::integer, LOG_WARNING, NULL, and ast_frame::subclass.
Referenced by __ast_read(), ast_queue_frame(), and ast_queue_frame_head().
1090 ast_log(LOG_WARNING, "Exceptionally long %squeue length queuing to %s\n", queued_frames + new_frames > 128 ? "" : "voice ", ast_channel_name(chan));
1095 } else if (cur->frametype == AST_FRAME_VOICE || cur->frametype == AST_FRAME_VIDEO || cur->frametype == AST_FRAME_NULL) {
#define AST_LIST_INSERT_LIST_AFTER(head, list, elm, field)
Inserts a whole list after a specific entry in a list.
Definition: linkedlists.h:811
#define AST_LIST_FIRST(head)
Returns the first entry contained in a list.
Definition: linkedlists.h:420
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
#define AST_LIST_REMOVE(head, elm, field)
Removes a specific entry from a list.
Definition: linkedlists.h:855
Definition: include/asterisk/frame.h:306
Definition: channel.h:986
struct ast_readq_list * ast_channel_readq(struct ast_channel *chan)
Definition: channel_internal_api.c:876
#define AST_LIST_REMOVE_CURRENT(field)
Removes the current entry from a list during a traversal.
Definition: linkedlists.h:556
ast_alert_status_t ast_channel_internal_alert_read(struct ast_channel *chan)
Definition: channel_internal_api.c:1120
AST_LIST_HEAD_NOLOCK(contactliststruct, contact)
Definition: include/asterisk/frame.h:107
Definition: include/asterisk/frame.h:105
Definition: res_rtp_asterisk.c:590
int ast_channel_timingfd(const struct ast_channel *chan)
Definition: channel_internal_api.c:469
#define AST_LIST_INSERT_TAIL(head, elm, field)
Appends a list entry to the tail of a list.
Definition: linkedlists.h:730
Definition: include/asterisk/frame.h:278
int errno
pthread_t ast_channel_blocker(const struct ast_channel *chan)
Definition: channel_internal_api.c:1213
#define AST_LIST_LAST(head)
Returns the last entry contained in a list.
Definition: linkedlists.h:428
#define AST_LIST_TRAVERSE(head, var, field)
Loops over (traverses) the entries in a list.
Definition: linkedlists.h:490
int ast_timer_enable_continuous(const struct ast_timer *handle)
Enable continuous mode.
Definition: timing.c:176
#define AST_LIST_HEAD_INIT_NOLOCK(head)
Initializes a list head structure.
Definition: linkedlists.h:680
const char * ast_channel_name(const struct ast_channel *chan)
int ast_channel_alert_writable(struct ast_channel *chan)
Definition: channel_internal_api.c:1125
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
#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
Definition: include/asterisk/frame.h:103
int ast_channel_alert_write(struct ast_channel *chan)
Definition: channel_internal_api.c:1110
struct ast_timer * ast_channel_timer(const struct ast_channel *chan)
Definition: channel_internal_api.c:737
#define AST_LIST_APPEND_LIST(head, list, field)
Appends a whole list to the tail of a list.
Definition: linkedlists.h:782
◆ __ast_read()
|
static |
- Todo:
- XXX It is possible to write a digit to the audiohook twice if the digit was originally read while the channel was in autoservice.
Definition at line 3529 of file channel.c.
References __ast_queue_frame(), ast_control_read_action_payload::action, ao2_ref, AST_ALERT_READ_FATAL, ast_audiohook_detach_list(), AST_AUDIOHOOK_DIRECTION_READ, ast_audiohook_write_list(), ast_audiohook_write_list_empty(), ast_channel_alert_write(), ast_channel_audiohooks(), ast_channel_audiohooks_set(), ast_channel_connected(), ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_channel_dtmf_digit_to_emulate(), ast_channel_dtmf_digit_to_emulate_set(), ast_channel_dtmf_tv(), ast_channel_dtmf_tv_set(), ast_channel_dtmff(), ast_channel_emulate_dtmf_duration(), ast_channel_emulate_dtmf_duration_set(), ast_channel_fd_isset(), ast_channel_fdno(), ast_channel_fdno_set(), ast_channel_fin(), ast_channel_fin_set(), ast_channel_flags(), ast_channel_framehooks(), ast_channel_generator(), ast_channel_generatordata(), ast_channel_generatordata_set(), ast_channel_get_default_stream(), ast_channel_get_stream_topology(), ast_channel_hangupcause_set(), ast_channel_insmpl(), ast_channel_insmpl_set(), ast_channel_internal_alert_read(), ast_channel_is_bridged(), ast_channel_lock, ast_channel_monitor(), ast_channel_music_state(), ast_channel_name(), ast_channel_outsmpl(), ast_channel_rawreadformat(), ast_channel_readformat(), ast_channel_readq(), ast_channel_readtrans(), ast_channel_softhangup_internal_flag(), ast_channel_softhangup_internal_flag_add(), ast_channel_stream_topology_changed(), ast_channel_tech(), ast_channel_timer(), ast_channel_timingdata(), ast_channel_timingfd(), ast_channel_timingfunc(), ast_channel_unlock, ast_channel_writetrans(), ast_check_hangup(), ast_clear_flag, ast_connected_line_parse_data(), AST_CONTROL_ANSWER, AST_CONTROL_CONNECTED_LINE, AST_CONTROL_END_OF_Q, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_READ_ACTION, AST_CONTROL_STREAM_TOPOLOGY_CHANGED, AST_CONTROL_STREAM_TOPOLOGY_REQUEST_CHANGE, ast_deactivate_generator(), ast_debug, AST_DEFAULT_EMULATE_DTMF_DURATION, AST_FLAG_DEFER_DTMF, AST_FLAG_EMULATE_DTMF, AST_FLAG_END_DTMF_ONLY, AST_FLAG_EXCEPTION, AST_FLAG_IN_DTMF, AST_FLAG_TIMINGDATA_IS_AO2_OBJ, AST_FLAG_ZOMBIE, ast_format_cache_is_slinear(), ast_format_cmp(), AST_FORMAT_CMP_EQUAL, ast_format_get_sample_rate(), ast_format_get_type(), AST_FRAME_CONTROL, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, ast_frame_dump(), AST_FRAME_NULL, AST_FRAME_READ_ACTION_CONNECTED_LINE_MACRO, AST_FRAME_READ_ACTION_SEND_TEXT, AST_FRAME_READ_ACTION_SEND_TEXT_DATA, AST_FRAME_RTCP, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_framehook_list_read_event(), AST_FRFLAG_REQUEUED, ast_frfree, AST_GENERATOR_FD, ast_indicate_data(), AST_JITTERBUFFER_FD, AST_LIST_EMPTY, AST_LIST_FIRST, AST_LIST_LAST, AST_LIST_NEXT, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_log, AST_MIN_DTMF_GAP, AST_MONITOR_RUNNING, ast_null_frame, ast_party_connected_line_copy(), ast_party_connected_line_free(), ast_party_connected_line_init(), ast_queue_control(), ast_queue_frame(), ast_queue_frame_head(), ast_read_generator_actions(), ast_seekstream(), ast_sendtext(), ast_sendtext_data(), ast_set_flag, ast_set_read_format_path(), ast_setstate(), AST_SOFTHANGUP_DEV, AST_STATE_UP, ast_stream_get_position(), ast_stream_topology_get_stream(), ast_test_flag, ast_timer_ack(), ast_timer_disable_continuous(), ast_timer_get_event(), ast_timer_set_rate(), AST_TIMING_EVENT_CONTINUOUS, AST_TIMING_EVENT_EXPIRED, AST_TIMING_FD, ast_translate(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), ast_writestream(), calc_monitor_jump(), ast_frame::data, DEBUGCHAN_FLAG, digit, ast_generator::digit, done, DTMF_RECEIVED, ast_channel_tech::exception, ast_frame_subclass::format, ast_channel_monitor::format, FRAMECOUNT_INC, ast_frame::frametype, ast_generator::generate, ast_frame_subclass::integer, ast_frame::len, LOG_DTMF, LOG_ERROR, LOG_WARNING, NULL, option_dtmfminduration, ast_control_read_action_payload::payload, ast_control_read_action_payload::payload_size, ast_frame::ptr, queue_dtmf_readq(), ast_channel_tech::read, ast_channel_tech::read_stream, ast_frame::samples, SEEK_FORCECUR, send_dtmf_begin_event(), send_dtmf_end_event(), send_flash_event(), set_channel_answer_time(), should_skip_dtmf(), should_trigger_dtmf_emulating(), ast_frame::stream_num, ast_frame::subclass, and ast_frame::uint32.
Referenced by ast_read(), ast_read_noaudio(), ast_read_stream(), and ast_read_stream_noaudio().
3648 } else if (ast_channel_fd_isset(chan, AST_GENERATOR_FD) && ast_channel_fdno(chan) == AST_GENERATOR_FD) {
3659 } else if (ast_channel_fd_isset(chan, AST_JITTERBUFFER_FD) && ast_channel_fdno(chan) == AST_JITTERBUFFER_FD) {
3680 if ( (f->frametype == AST_FRAME_DTMF_BEGIN || f->frametype == AST_FRAME_DTMF_END) && skip_dtmf) {
3726 default_stream = ast_channel_get_default_stream(chan, ast_format_get_type(f->subclass.format));
3728 /* Since this channel driver does not support multistream determine the default stream this frame
3731 stream = default_stream = ast_channel_get_default_stream(chan, ast_format_get_type(f->subclass.format));
3732 /* In order to allow media to be passed up the underlying media type has to have a format negotiated on
3733 * the channel itself. In cases where this hasn't happened the channel driver is incorrectly passing up
3734 * a frame for a format that has not been negotiated. If this occurs just drop the frame as we have no
3750 ast_log(LOG_WARNING, "Exception flag set on '%s', but no exception handler\n", ast_channel_name(chan));
3764 default_stream = ast_channel_get_default_stream(chan, ast_format_get_type(f->subclass.format));
3769 /* Since this channel driver does not support multistream determine the default stream this frame
3773 stream = default_stream = ast_channel_get_default_stream(chan, ast_format_get_type(f->subclass.format));
3815 /* If the frame originates from a non-default stream and the caller can not handle other streams
3872 } else if (f->subclass.integer == AST_CONTROL_STREAM_TOPOLOGY_REQUEST_CHANGE && dropnondefault) {
3873 /* The caller of this function is incapable of handling streams so we don't accept the change request
3880 /* The caller of this function is incapable of handling streams so we absorb the notification that the
3891 ast_log(LOG_DTMF, "DTMF end '%c' received on %s, duration %ld ms\n", f->subclass.integer, ast_channel_name(chan), f->len);
3893 if (ast_test_flag(ast_channel_flags(chan), AST_FLAG_DEFER_DTMF) || ast_test_flag(ast_channel_flags(chan), AST_FLAG_EMULATE_DTMF)) {
3897 } else if (!ast_test_flag(ast_channel_flags(chan), AST_FLAG_IN_DTMF | AST_FLAG_END_DTMF_ONLY)) {
3918 ast_log(LOG_DTMF, "DTMF begin emulation of '%c' with duration %u queued on %s\n", f->subclass.integer, ast_channel_emulate_dtmf_duration(chan), ast_channel_name(chan));
3935 f = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_READ, f);
3942 ast_log(LOG_DTMF, "DTMF end accepted with begin '%c' on %s\n", f->subclass.integer, ast_channel_name(chan));
3957 ast_log(LOG_DTMF, "DTMF end '%c' detected to have actual duration %ld on the wire, emulation will be triggered on %s\n", f->subclass.integer, f->len, ast_channel_name(chan));
3960 ast_log(LOG_DTMF, "DTMF end accepted without begin '%c' on %s\n", f->subclass.integer, ast_channel_name(chan));
3963 if (f->len < option_dtmfminduration && !ast_test_flag(ast_channel_flags(chan), AST_FLAG_END_DTMF_ONLY)) {
3964 ast_log(LOG_DTMF, "DTMF end '%c' has duration %ld but want minimum %u, emulating on %s\n", f->subclass.integer, f->len, option_dtmfminduration, ast_channel_name(chan));
3980 ast_log(LOG_DTMF, "DTMF end passthrough '%c' on %s\n", f->subclass.integer, ast_channel_name(chan));
3997 f = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_READ, f);
4005 ast_log(LOG_DTMF, "DTMF begin '%c' received on %s\n", f->subclass.integer, ast_channel_name(chan));
4006 if (ast_test_flag(ast_channel_flags(chan), AST_FLAG_DEFER_DTMF | AST_FLAG_END_DTMF_ONLY | AST_FLAG_EMULATE_DTMF) ||
4009 ast_log(LOG_DTMF, "DTMF begin ignored '%c' on %s\n", f->subclass.integer, ast_channel_name(chan));
4016 ast_log(LOG_DTMF, "DTMF begin passthrough '%c' on %s\n", f->subclass.integer, ast_channel_name(chan));
4029 } else if (ast_tvdiff_ms(now, *ast_channel_dtmf_tv(chan)) >= ast_channel_emulate_dtmf_duration(chan)) {
4039 ast_log(LOG_DTMF, "DTMF end emulation of '%c' queued on %s\n", f->subclass.integer, ast_channel_name(chan));
4042 f = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_READ, f);
4060 /* If media was received from a non-default stream don't perform any actions, let it just go through */
4069 if (ast_test_flag(ast_channel_flags(chan), AST_FLAG_EMULATE_DTMF) && !ast_channel_emulate_dtmf_duration(chan)) {
4083 if (ast_test_flag(ast_channel_flags(chan), AST_FLAG_EMULATE_DTMF) && !ast_test_flag(ast_channel_flags(chan), AST_FLAG_IN_DTMF)) {
4086 if (ast_tvdiff_ms(now, *ast_channel_dtmf_tv(chan)) >= ast_channel_emulate_dtmf_duration(chan)) {
4096 f = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_READ, f);
4100 ast_log(LOG_DTMF, "DTMF end emulation of '%c' queued on %s\n", f->subclass.integer, ast_channel_name(chan));
4112 if (ast_format_cmp(f->subclass.format, ast_channel_rawreadformat(chan)) != AST_FORMAT_CMP_EQUAL
4171 f = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_READ, f);
4186 ast_log(LOG_WARNING, "Failed to perform seek in monitoring read stream, synchronization between the files may be broken\n");
4188 ast_channel_insmpl_set(chan, ast_channel_insmpl(chan) + (ast_channel_outsmpl(chan) - ast_channel_insmpl(chan)) + f->samples);
4197 if (ast_seekstream(ast_channel_monitor(chan)->read_stream, jump - f->samples, SEEK_FORCECUR) == -1) {
4198 ast_log(LOG_WARNING, "Failed to perform seek in monitoring read stream, synchronization between the files may be broken\n");
4213 && ast_format_cmp(f->subclass.format, ast_channel_rawreadformat(chan)) == AST_FORMAT_CMP_EQUAL) {
4223 f = ast_audiohook_write_list(chan, ast_channel_audiohooks(chan), AST_AUDIOHOOK_DIRECTION_READ, f);
4289 if (ast_channel_music_state(chan) && ast_channel_generator(chan) && ast_channel_generator(chan)->digit && f && f->frametype == AST_FRAME_DTMF_END) {
4293 if (ast_channel_audiohooks(chan) && ast_audiohook_write_list_empty(ast_channel_audiohooks(chan))) {
Definition: channel.c:3362
void ast_channel_dtmf_digit_to_emulate_set(struct ast_channel *chan, char value)
Definition: channel_internal_api.c:383
void ast_channel_fdno_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:423
int ast_queue_control(struct ast_channel *chan, enum ast_control_frame_type control)
Queue a control frame.
Definition: channel.c:1231
int ast_channel_fd_isset(const struct ast_channel *chan, int which)
Definition: channel_internal_api.c:1190
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
Definition: channel.h:1008
#define AST_LIST_FIRST(head)
Returns the first entry contained in a list.
Definition: linkedlists.h:420
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
static int __ast_queue_frame(struct ast_channel *chan, struct ast_frame *fin, int head, struct ast_frame *after)
Definition: channel.c:1015
Definition: include/asterisk/frame.h:286
void ast_channel_insmpl_set(struct ast_channel *chan, unsigned long value)
Definition: channel_internal_api.c:537
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
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
static void send_dtmf_begin_event(struct ast_channel *chan, enum DtmfDirection direction, const char digit)
Definition: channel.c:3378
void ast_audiohook_detach_list(struct ast_audiohook_list *audiohook_list)
Detach audiohooks from list and destroy said list.
Definition: audiohook.c:594
void ast_channel_hangupcause_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:431
Definition: timing.h:58
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
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
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
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.
Definition: channel.c:11197
Definition: include/asterisk/frame.h:281
Definition: channel.h:4234
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
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
Structure used to transport a message through the frame core.
Definition: message.c:1406
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
void ast_party_connected_line_init(struct ast_party_connected_line *init)
Initialize the given connected line structure.
Definition: channel.c:2022
int ast_channel_connected_line_macro(struct ast_channel *autoservice_chan, struct ast_channel *macro_chan, const void *connected_info, int is_caller, int is_frame)
Run a connected line interception macro and update a channel's connected line information.
Definition: channel.c:10435
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
static int should_skip_dtmf(struct ast_channel *chan)
Determine whether or not we should ignore DTMF in the readq.
Definition: channel.c:3489
int(* generate)(struct ast_channel *chan, void *data, int len, int samples)
Definition: channel.h:234
#define AST_LIST_EMPTY(head)
Checks whether the specified list contains any entries.
Definition: linkedlists.h:449
Definition: channelstate.h:42
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
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 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
static void set_channel_answer_time(struct ast_channel *chan)
Definition: channel.c:2637
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_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:1055
Definition: include/asterisk/frame.h:306
Definition: include/asterisk/frame.h:145
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
Definition: audiohook.h:49
struct ast_readq_list * ast_channel_readq(struct ast_channel *chan)
Definition: channel_internal_api.c:876
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
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
unsigned int ast_channel_emulate_dtmf_duration(const struct ast_channel *chan)
Definition: channel_internal_api.c:509
unsigned int ast_channel_fin(const struct ast_channel *chan)
Definition: channel_internal_api.c:517
void ast_party_connected_line_free(struct ast_party_connected_line *doomed)
Destroy the connected line information contents.
Definition: channel.c:2072
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_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
void ast_channel_generatordata_set(struct ast_channel *chan, void *value)
Definition: channel_internal_api.c:553
size_t payload_size
Definition: include/asterisk/frame.h:364
struct ast_trans_pvt * ast_channel_writetrans(const struct ast_channel *chan)
Definition: channel_internal_api.c:761
struct ast_party_connected_line * ast_channel_connected(struct ast_channel *chan)
Definition: channel_internal_api.c:892
int ast_timer_disable_continuous(const struct ast_timer *handle)
Disable continuous mode.
Definition: timing.c:181
#define AST_LIST_REMOVE_CURRENT(field)
Removes the current entry from a list during a traversal.
Definition: linkedlists.h:556
ast_alert_status_t ast_channel_internal_alert_read(struct ast_channel *chan)
Definition: channel_internal_api.c:1120
Definition: channel.h:982
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
void * ast_channel_timingdata(const struct ast_channel *chan)
Definition: channel_internal_api.c:573
Definition: include/asterisk/frame.h:135
Definition: alertpipe.h:28
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
void ast_channel_dtmf_tv_set(struct ast_channel *chan, struct timeval *value)
Definition: channel_internal_api.c:964
Definition: include/asterisk/frame.h:105
int ast_channel_fdno(const struct ast_channel *chan)
Definition: channel_internal_api.c:419
Definition: res_rtp_asterisk.c:590
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_channel_timingfd(const struct ast_channel *chan)
Definition: channel_internal_api.c:469
int ast_timer_ack(const struct ast_timer *handle, unsigned int quantity)
Acknowledge a timer event.
Definition: timing.c:171
struct ast_format * ast_channel_rawreadformat(struct ast_channel *chan)
Definition: channel_internal_api.c:848
int ast_sendtext(struct ast_channel *chan, const char *text)
Sends text to a channel.
Definition: channel.c:4854
struct ast_generator * ast_channel_generator(const struct ast_channel *chan)
Definition: channel_internal_api.c:713
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
Definition: include/asterisk/frame.h:99
struct timeval * ast_channel_dtmf_tv(struct ast_channel *chan)
Definition: channel_internal_api.c:924
Definition: include/asterisk/frame.h:278
Definition: channel.h:1002
Definition: timing.h:59
Definition: channel.h:1005
enum ast_frame_read_action action
Definition: include/asterisk/frame.h:361
#define AST_LIST_LAST(head)
Returns the last entry contained in a list.
Definition: linkedlists.h:428
int ast_seekstream(struct ast_filestream *fs, off_t sample_offset, int whence)
Seeks into stream.
Definition: file.c:1038
struct ast_frame *(*const exception)(struct ast_channel *chan)
Handle an exception, reading a frame.
Definition: channel.h:766
Definition: channel.h:988
void ast_deactivate_generator(struct ast_channel *chan)
Definition: channel.c:2902
Definition: localtime.c:158
int ast_timer_set_rate(const struct ast_timer *handle, unsigned int rate)
Set the timing tick rate.
Definition: timing.c:166
struct ast_frame *(*const read)(struct ast_channel *chan)
Read a frame (or chain of frames from the same stream), in standard format (see frame.h)
Definition: channel.h:735
char ast_channel_dtmf_digit_to_emulate(const struct ast_channel *chan)
Definition: channel_internal_api.c:379
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.
Definition: channel.c:5575
int ast_channel_softhangup_internal_flag(struct ast_channel *chan)
Definition: channel_internal_api.c:997
static void send_dtmf_end_event(struct ast_channel *chan, enum DtmfDirection direction, const char digit, long duration_ms)
Definition: channel.c:3394
int ast_channel_is_bridged(const struct ast_channel *chan)
Determine if a channel is in a bridge.
Definition: channel.c:10746
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
void * ast_channel_music_state(const struct ast_channel *chan)
Definition: channel_internal_api.c:557
unsigned int ast_format_get_sample_rate(const struct ast_format *format)
Get the sample rate of a media format.
Definition: format.c:379
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
void ast_channel_emulate_dtmf_duration_set(struct ast_channel *chan, unsigned int value)
Definition: channel_internal_api.c:513
void ast_channel_softhangup_internal_flag_add(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:1005
unsigned long ast_channel_outsmpl(const struct ast_channel *chan)
Definition: channel_internal_api.c:541
union ast_frame::@263 data
#define AST_LIST_TRAVERSE_SAFE_BEGIN(head, var, field)
Loops safely over (traverses) the entries in a list.
Definition: linkedlists.h:528
Definition: include/asterisk/frame.h:125
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
unsigned char payload[0]
Definition: include/asterisk/frame.h:367
void ast_channel_fin_set(struct ast_channel *chan, unsigned int value)
Definition: channel_internal_api.c:521
Definition: include/asterisk/frame.h:103
static void queue_dtmf_readq(struct ast_channel *chan, struct ast_frame *f)
Definition: channel.c:3470
struct ast_audiohook_list * ast_channel_audiohooks(const struct ast_channel *chan)
Definition: channel_internal_api.c:581
enum ast_timer_event ast_timer_get_event(const struct ast_timer *handle)
Retrieve timing event.
Definition: timing.c:186
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_channel_monitor * ast_channel_monitor(const struct ast_channel *chan)
Definition: channel_internal_api.c:613
ast_timing_func_t ast_channel_timingfunc(const struct ast_channel *chan)
Definition: channel_internal_api.c:1231
struct ast_frame * ast_channel_dtmff(struct ast_channel *chan)
Definition: channel_internal_api.c:880
Definition: channel.h:990
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
static void ast_read_generator_actions(struct ast_channel *chan, struct ast_frame *f)
Definition: channel.c:3416
struct ast_frame * ast_framehook_list_read_event(struct ast_framehook_list *framehooks, struct ast_frame *frame)
This is used by the channel API push a frame read event to a channel's framehook list.
Definition: framehook.c:318
int ast_setstate(struct ast_channel *chan, enum ast_channel_state state)
Change the state of a channel.
Definition: channel.c:7486
int ast_channel_connected_line_sub(struct ast_channel *autoservice_chan, struct ast_channel *sub_chan, const void *connected_info, int is_frame)
Run a connected line interception subroutine and update a channel's connected line information...
Definition: channel.c:10539
int ast_channel_alert_write(struct ast_channel *chan)
Definition: channel_internal_api.c:1110
struct ast_timer * ast_channel_timer(const struct ast_channel *chan)
Definition: channel_internal_api.c:737
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_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
◆ __init_state2str_threadbuf()
|
static |
◆ adjust_frame_for_plc()
|
static |
Definition at line 5098 of file channel.c.
References ast_calloc, ast_channel_datastore_remove(), ast_datastore_free(), ast_free, AST_FRIENDLY_OFFSET, ast_datastore::data, ast_frame::data, ast_frame::datalen, plc_ds::num_samples, ast_frame::offset, plc_fillin(), plc_rx(), plc_ds::plc_state, ast_frame::ptr, ast_frame::samples, and plc_ds::samples_buf.
Referenced by apply_plc().
5132 plc->samples_buf = ast_calloc(1, (num_new_samples * sizeof(*plc->samples_buf)) + (AST_FRIENDLY_OFFSET * 2));
int plc_fillin(plc_state_t *s, int16_t amp[], int len)
Fill-in a block of missing audio samples.
Definition: plc.c:175
int ast_datastore_free(struct ast_datastore *datastore)
Free a data store object.
Definition: datastore.c:68
Definition: channel.c:5073
int ast_channel_datastore_remove(struct ast_channel *chan, struct ast_datastore *datastore)
Remove a datastore from a channel.
Definition: channel.c:2399
#define AST_FRIENDLY_OFFSET
Offset into a frame's data buffer.
Definition: include/asterisk/frame.h:229
int plc_rx(plc_state_t *s, int16_t amp[], int len)
Process a block of received audio samples.
Definition: plc.c:132
union ast_frame::@263 data
◆ apply_plc()
|
static |
Definition at line 5151 of file channel.c.
References adjust_frame_for_plc(), ast_calloc, ast_channel_datastore_add(), ast_channel_datastore_find(), ast_datastore_alloc, ast_datastore_free(), ast_datastore::data, and NULL.
Referenced by ast_write_stream().
static void adjust_frame_for_plc(struct ast_channel *chan, struct ast_frame *frame, struct ast_datastore *datastore)
Definition: channel.c:5098
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_datastore_free(struct ast_datastore *datastore)
Free a data store object.
Definition: datastore.c:68
Definition: channel.c:5073
int ast_channel_datastore_add(struct ast_channel *chan, struct ast_datastore *datastore)
Add a datastore to a channel.
Definition: channel.c:2390
◆ ast_activate_generator()
| int ast_activate_generator | ( | struct ast_channel * | chan, |
| struct ast_generator * | gen, | ||
| void * | params | ||
| ) |
Activate a given generator
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_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_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 hangup cause.
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_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_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_by_exten_cb()
|
static |
Definition at line 1306 of file channel.c.
References ast_channel_context(), ast_channel_exten(), ast_channel_lock, ast_channel_macrocontext(), ast_channel_macroexten(), ast_channel_unlock, ast_log, ast_strlen_zero, chanlist::chan, CMP_MATCH, CMP_STOP, context, ast_channel::data, exten, and LOG_ERROR.
Referenced by ast_channel_get_by_exten(), and ast_channel_iterator_by_exten_new().
1319 if (strcasecmp(ast_channel_context(chan), context) && strcasecmp(ast_channel_macrocontext(chan), context)) {
1321 } else if (strcasecmp(ast_channel_exten(chan), exten) && strcasecmp(ast_channel_macroexten(chan), exten)) {
Definition: astobj2.h:1032
Definition: astobj2.h:1031
const char * ast_channel_exten(const struct ast_channel *chan)
Definition: channel_internal_api.c:353
const char * ast_channel_context(const struct ast_channel *chan)
Definition: channel_internal_api.c:344
const char * ast_channel_macrocontext(const struct ast_channel *chan)
Definition: channel_internal_api.c:362
const char * ast_channel_macroexten(const struct ast_channel *chan)
Definition: channel_internal_api.c:370
◆ ast_channel_by_name_cb()
|
static |
Definition at line 1284 of file channel.c.
References ast_channel_lock, ast_channel_name(), ast_channel_unlock, ast_log, ast_strlen_zero, chanlist::chan, CMP_MATCH, CMP_STOP, LOG_ERROR, and name.
Referenced by ast_channel_get_by_name_prefix(), and ast_channel_iterator_by_name_new().
Definition: astobj2.h:1032
Definition: astobj2.h:1031
const char * ast_channel_name(const struct ast_channel *chan)
◆ ast_channel_by_uniqueid_cb()
|
static |
Definition at line 1329 of file channel.c.
References ast_channel_lock, ast_channel_uniqueid(), ast_channel_unlock, ast_log, ast_strlen_zero, chanlist::chan, CMP_MATCH, CMP_STOP, LOG_ERROR, and ast_channel::uniqueid.
Referenced by ast_channel_get_by_name_prefix(), and does_id_conflict().
Definition: astobj2.h:1032
Definition: astobj2.h:1031
const char * ast_channel_uniqueid(const struct ast_channel *chan)
Definition: channel_internal_api.c:305
◆ 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_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_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_cmp_cb()
|
static |
Definition at line 1428 of file channel.c.
References ast_log, CMP_STOP, and LOG_ERROR.
Referenced by ast_channels_init().
Definition: astobj2.h:1032
◆ ast_channel_cmpwhentohangup_tv()
| int ast_channel_cmpwhentohangup_tv | ( | struct ast_channel * | chan, |
| struct timeval | offset | ||
| ) |
Compare a offset with when to hangup channel.
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_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_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_defer_dtmf()
| int ast_channel_defer_dtmf | ( | struct ast_channel * | chan | ) |
Set defer DTMF flag on channel.
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_destructor()
|
static |
Free a channel structure.
Definition at line 2192 of file channel.c.
References ast_app_group_discard(), ast_assert, ast_atomic_fetchadd_int(), ast_cdr_free(), ast_channel_caller(), ast_channel_callid(), ast_channel_callid_cleanup(), ast_channel_cdr(), ast_channel_cdr_set(), ast_channel_connected(), ast_channel_connected_indicated(), ast_channel_datastores(), ast_channel_dialed(), ast_channel_flags(), ast_channel_internal_alertpipe_close(), ast_channel_internal_cleanup(), ast_channel_internal_is_finalized(), ast_channel_lock, ast_channel_monitor(), ast_channel_music_state(), AST_CHANNEL_NAME, ast_channel_name(), ast_channel_named_callgroups_set(), ast_channel_named_pickupgroups_set(), ast_channel_nativeformats_set(), ast_channel_pbx(), ast_channel_publish_final_snapshot(), ast_channel_readq(), ast_channel_readtrans(), ast_channel_redirecting(), ast_channel_sched(), ast_channel_set_oldwriteformat(), ast_channel_set_rawreadformat(), ast_channel_set_rawwriteformat(), ast_channel_set_readformat(), ast_channel_set_writeformat(), ast_channel_tech_pvt(), ast_channel_timer(), ast_channel_timer_set(), ast_channel_unlock, ast_channel_varshead(), ast_channel_writetrans(), ast_channel_zone(), ast_channel_zone_set(), ast_copy_string(), ast_datastore_free(), ast_debug, AST_DEVICE_UNKNOWN, AST_DEVSTATE_CACHABLE, ast_devstate_changed_literal(), AST_DEVSTATE_NOT_CACHABLE, AST_FLAG_DEAD, AST_FLAG_DISABLE_DEVSTATE_CACHE, AST_FLAG_SNAPSHOT_STAGE, ast_free, ast_frfree, ast_jb_destroy(), AST_LIST_REMOVE_HEAD, ast_log_callid(), ast_moh_cleanup(), ast_party_caller_free(), ast_party_connected_line_free(), ast_party_dialed_free(), ast_party_redirecting_free(), ast_pbx_hangup_handler_destroy(), ast_sched_context_destroy(), ast_set_flag, ast_test_flag, ast_timer_close(), ast_tone_zone_unref(), ast_translator_free_path(), ast_var_delete(), chancount, LOG_WARNING, NULL, and ast_channel_monitor::stop.
Referenced by __ast_channel_alloc_ap().
2235 /* While the channel is locked, take the reference to its callid while we tear down the call. */
2247 ast_log_callid(LOG_WARNING, callid, "Channel '%s' may not have been hung up properly\n", ast_channel_name(chan));
2272 ast_log_callid(LOG_WARNING, callid, "PBX may not have been terminated properly on '%s'\n", ast_channel_name(chan));
2326 ast_devstate_changed_literal(AST_DEVICE_UNKNOWN, (ast_test_flag(ast_channel_flags(chan), AST_FLAG_DISABLE_DEVSTATE_CACHE) ? AST_DEVSTATE_NOT_CACHABLE : AST_DEVSTATE_CACHABLE), device_name);
struct ast_party_caller * ast_channel_caller(struct ast_channel *chan)
Definition: channel_internal_api.c:888
void ast_channel_timer_set(struct ast_channel *chan, struct ast_timer *value)
Definition: channel_internal_api.c:741
static struct ast_tone_zone * ast_tone_zone_unref(struct ast_tone_zone *tz)
Release a reference to an ast_tone_zone.
Definition: indications.h:205
struct ast_cdr * ast_channel_cdr(const struct ast_channel *chan)
Definition: channel_internal_api.c:589
void ast_channel_set_writeformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:840
void ast_channel_set_oldwriteformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:824
int(* stop)(struct ast_channel *chan, int need_lock)
Definition: channel.h:4250
void ast_log_callid(int level, const char *file, int line, const char *function, ast_callid callid, const char *fmt,...)
Used for sending a log message with a known call_id This is a modified logger function which is funct...
Definition: logger.c:2149
void * ast_channel_tech_pvt(const struct ast_channel *chan)
Definition: channel_internal_api.c:565
void ast_channel_set_rawwriteformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:832
struct ast_tone_zone * ast_channel_zone(const struct ast_channel *chan)
Definition: channel_internal_api.c:745
void ast_timer_close(struct ast_timer *handle)
Close an opened timing handle.
Definition: timing.c:154
void ast_channel_named_pickupgroups_set(struct ast_channel *chan, struct ast_namedgroups *value)
Definition: channel_internal_api.c:1103
void ast_channel_internal_alertpipe_close(struct ast_channel *chan)
Definition: channel_internal_api.c:1140
struct varshead * ast_channel_varshead(struct ast_channel *chan)
Definition: channel_internal_api.c:932
void ast_channel_zone_set(struct ast_channel *chan, struct ast_tone_zone *value)
Definition: channel_internal_api.c:749
struct ast_trans_pvt * ast_channel_readtrans(const struct ast_channel *chan)
Definition: channel_internal_api.c:753
void ast_channel_callid_cleanup(struct ast_channel *chan)
Definition: channel_internal_api.c:1068
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
int ast_datastore_free(struct ast_datastore *datastore)
Free a data store object.
Definition: datastore.c:68
void ast_party_caller_free(struct ast_party_caller *doomed)
Destroy the caller party contents.
Definition: channel.c:2015
struct ast_readq_list * ast_channel_readq(struct ast_channel *chan)
Definition: channel_internal_api.c:876
void ast_channel_set_rawreadformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:828
void ast_channel_cdr_set(struct ast_channel *chan, struct ast_cdr *value)
Definition: channel_internal_api.c:593
void ast_party_connected_line_free(struct ast_party_connected_line *doomed)
Destroy the connected line information contents.
Definition: channel.c:2072
Definition: channel.h:1051
void ast_channel_nativeformats_set(struct ast_channel *chan, struct ast_format_cap *value)
Definition: channel_internal_api.c:677
struct ast_trans_pvt * ast_channel_writetrans(const struct ast_channel *chan)
Definition: channel_internal_api.c:761
struct ast_party_connected_line * ast_channel_connected(struct ast_channel *chan)
Definition: channel_internal_api.c:892
struct ast_pbx * ast_channel_pbx(const struct ast_channel *chan)
Definition: channel_internal_api.c:721
Definition: devicestate.h:53
void ast_channel_set_readformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:836
void ast_jb_destroy(struct ast_channel *chan)
Destroys jitterbuffer on a channel.
Definition: abstract_jb.c:502
struct ast_datastore_list * ast_channel_datastores(struct ast_channel *chan)
Definition: channel_internal_api.c:868
void ast_channel_internal_cleanup(struct ast_channel *chan)
Definition: channel_internal_api.c:1471
#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
void ast_party_redirecting_free(struct ast_party_redirecting *doomed)
Destroy the redirecting information contents.
Definition: channel.c:2179
Definition: channel.h:1046
struct ast_sched_context * ast_channel_sched(const struct ast_channel *chan)
Definition: channel_internal_api.c:729
Definition: chanvars.h:28
void ast_channel_named_callgroups_set(struct ast_channel *chan, struct ast_namedgroups *value)
Definition: channel_internal_api.c:1094
void ast_channel_publish_final_snapshot(struct ast_channel *chan)
Send the final channel snapshot for a channel, thus removing it from cache.
Definition: stasis_channels.c:917
Definition: chanvars.h:34
struct ast_party_dialed * ast_channel_dialed(struct ast_channel *chan)
Definition: channel_internal_api.c:904
Definition: channel.h:1030
Definition: devicestate.h:70
struct ast_party_redirecting * ast_channel_redirecting(struct ast_channel *chan)
Definition: channel_internal_api.c:908
int ast_channel_internal_is_finalized(struct ast_channel *chan)
Definition: channel_internal_api.c:1497
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)
void ast_party_dialed_free(struct ast_party_dialed *doomed)
Destroy the dialed party contents.
Definition: channel.c:1971
void * ast_channel_music_state(const struct ast_channel *chan)
Definition: channel_internal_api.c:557
void ast_pbx_hangup_handler_destroy(struct ast_channel *chan)
Destroy the hangup handler container on a channel.
Definition: pbx_hangup_handler.c:103
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
Definition: search.h:40
Definition: devicestate.h:69
int ast_app_group_discard(struct ast_channel *chan)
Discard all group counting for a channel.
Definition: main/app.c:2162
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
int ast_devstate_changed_literal(enum ast_device_state state, enum ast_devstate_cache cachable, const char *device)
Tells Asterisk the State for Device is changed.
Definition: devicestate.c:471
struct ast_party_connected_line * ast_channel_connected_indicated(struct ast_channel *chan)
Definition: channel_internal_api.c:896
struct ast_channel_monitor * ast_channel_monitor(const struct ast_channel *chan)
Definition: channel_internal_api.c:613
ast_callid ast_channel_callid(const struct ast_channel *chan)
Definition: channel_internal_api.c:793
void ast_sched_context_destroy(struct ast_sched_context *c)
destroys a schedule context
Definition: sched.c:269
void ast_translator_free_path(struct ast_trans_pvt *tr)
Frees a translator path Frees the given translator path structure.
Definition: translate.c:475
struct ast_timer * ast_channel_timer(const struct ast_channel *chan)
Definition: channel_internal_api.c:737
◆ 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_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_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_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_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_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_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_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_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_hash_cb()
|
static |
Definition at line 7888 of file channel.c.
References ast_channel_name(), ast_str_case_hash(), ast_strlen_zero, name, and OBJ_KEY.
Referenced by ast_channels_init().
const char * ast_channel_name(const struct ast_channel *chan)
static force_inline int attribute_pure ast_str_case_hash(const char *str)
Compute a hash value on a case-insensitive string.
Definition: strings.h:1250
◆ 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_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_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_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_make_compatible_helper()
|
static |
Set up translation from one channel to another.
Definition at line 6738 of file channel.c.
References ao2_cleanup, ao2_replace, ast_channel_lock_both, ast_channel_name(), ast_channel_nativeformats(), ast_channel_unlock, ast_format_cache_get_slin_by_rate(), ast_format_cache_is_slinear(), ast_format_cap_has_type(), ast_format_cmp(), AST_FORMAT_CMP_NOT_EQUAL, ast_format_get_name(), ast_format_get_sample_rate(), ast_log, AST_MEDIA_TYPE_AUDIO, ast_opt_generic_plc, ast_opt_generic_plc_on_equal_codecs, ast_opt_transcode_via_slin, ast_set_read_format(), ast_set_write_format(), ast_translate_path_steps(), ast_translator_best_choice(), LOG_WARNING, NULL, and RAII_VAR.
Referenced by ast_channel_make_compatible().
6796 int best_sample_rate = (ast_format_get_sample_rate(best_src_fmt) > ast_format_get_sample_rate(best_dst_fmt)) ?
int ast_set_read_format(struct ast_channel *chan, struct ast_format *format)
Sets read format on channel chan.
Definition: channel.c:5849
const char * ast_format_get_name(const struct ast_format *format)
Get the name associated with a format.
Definition: format.c:334
int ast_translator_best_choice(struct ast_format_cap *dst_cap, struct ast_format_cap *src_cap, struct ast_format **dst_fmt_out, struct ast_format **src_fmt_out)
Chooses the best translation path.
Definition: translate.c:1385
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
Definition: format.h:38
#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
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
Format capabilities structure, holds formats + preference order + etc.
Definition: format_cap.c:54
Definition: codec.h:32
#define ast_opt_generic_plc_on_equal_codecs
Definition: options.h:136
struct ast_format_cap * ast_channel_nativeformats(const struct ast_channel *chan)
Definition: channel_internal_api.c:637
const char * ast_channel_name(const struct ast_channel *chan)
unsigned int ast_format_get_sample_rate(const struct ast_format *format)
Get the sample rate of a media format.
Definition: format.c:379
unsigned int ast_translate_path_steps(struct ast_format *dest, struct ast_format *src)
Returns the number of steps required to convert from 'src' to 'dest'.
Definition: translate.c:1491
int ast_set_write_format(struct ast_channel *chan, struct ast_format *format)
Sets write format on channel chan.
Definition: channel.c:5890
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
struct ast_format * ast_format_cache_get_slin_by_rate(unsigned int rate)
Retrieve the best signed linear format given a sample rate.
Definition: format_cache.c:520
◆ 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_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_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_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_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_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 new telephony channel in Asterisk.
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_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_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_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_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_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 hangup channel.
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_softhangup_cb()
|
static |
Definition at line 484 of file channel.c.
References ast_softhangup(), AST_SOFTHANGUP_SHUTDOWN, and chanlist::chan.
Referenced by ast_softhangup_all().
Definition: channel.h:1132
int ast_softhangup(struct ast_channel *chan, int cause)
Softly hangup a channel, lock.
Definition: channel.c:2476
◆ 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.
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_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.
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_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_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_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_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 channel driver.
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_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_channels_init()
| int ast_channels_init | ( | void | ) |
Provided by channel.c
Definition at line 8109 of file channel.c.
References ami_vars, AO2_ALLOC_OPT_LOCK_MUTEX, ao2_container_alloc_hash, ao2_container_register(), ari_vars, ARRAY_LEN, ast_channel_cmp_cb(), ast_channel_hash_cb(), ast_channel_register(), ast_cli_register_multiple, AST_NUM_CHANNEL_BUCKETS, ast_register_cleanup(), AST_RWLIST_HEAD_INIT, ast_stasis_channels_init(), channels_shutdown(), NULL, and prnt_channel_key().
Referenced by asterisk_daemon().
#define AST_RWLIST_HEAD_INIT(head)
Initializes an rwlist head structure.
Definition: linkedlists.h:638
static int ast_channel_hash_cb(const void *obj, const int flags)
Definition: channel.c:7888
static const struct ast_channel_tech surrogate_tech
Channel technology used to extract a channel from a running application. The channel created with thi...
Definition: channel.c:702
int ao2_container_register(const char *name, struct ao2_container *self, ao2_prnt_obj_fn *prnt_obj)
Register a container for CLI stats and integrity check.
Definition: astobj2_container.c:958
int ast_register_cleanup(void(*func)(void))
Register a function to be executed before Asterisk gracefully exits.
Definition: clicompat.c:19
static int ast_channel_cmp_cb(void *obj, void *arg, int flags)
Definition: channel.c:1428
Definition: astobj2.h:365
#define ao2_container_alloc_hash(ao2_options, container_options, n_buckets, hash_fn, sort_fn, cmp_fn)
Definition: astobj2.h:1310
int ast_stasis_channels_init(void)
Initialize the stasis channel topic and message types.
Definition: stasis_channels.c:1666
int ast_channel_register(const struct ast_channel_tech *tech)
Register a new telephony channel in Asterisk.
Definition: channel.c:539
static void prnt_channel_key(void *v_obj, void *where, ao2_prnt_fn *prnt)
Definition: channel.c:7912
◆ 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 | ) |
Checks to see if a channel is needing hang up.
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 | ) |
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_dummy_channel_destructor()
|
static |
Free a dummy channel structure.
Definition at line 2338 of file channel.c.
References ast_cdr_free(), ast_channel_caller(), ast_channel_cdr(), ast_channel_cdr_set(), ast_channel_connected(), ast_channel_connected_indicated(), ast_channel_datastores(), ast_channel_dialed(), ast_channel_internal_cleanup(), ast_channel_redirecting(), ast_channel_varshead(), ast_datastore_free(), AST_LIST_REMOVE_HEAD, ast_party_caller_free(), ast_party_connected_line_free(), ast_party_dialed_free(), ast_party_redirecting_free(), ast_pbx_hangup_handler_destroy(), ast_var_delete(), and NULL.
Referenced by __ast_dummy_channel_alloc().
struct ast_party_caller * ast_channel_caller(struct ast_channel *chan)
Definition: channel_internal_api.c:888
struct ast_cdr * ast_channel_cdr(const struct ast_channel *chan)
Definition: channel_internal_api.c:589
struct varshead * ast_channel_varshead(struct ast_channel *chan)
Definition: channel_internal_api.c:932
int ast_datastore_free(struct ast_datastore *datastore)
Free a data store object.
Definition: datastore.c:68
void ast_party_caller_free(struct ast_party_caller *doomed)
Destroy the caller party contents.
Definition: channel.c:2015
void ast_channel_cdr_set(struct ast_channel *chan, struct ast_cdr *value)
Definition: channel_internal_api.c:593
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
struct ast_datastore_list * ast_channel_datastores(struct ast_channel *chan)
Definition: channel_internal_api.c:868
void ast_channel_internal_cleanup(struct ast_channel *chan)
Definition: channel_internal_api.c:1471
#define AST_LIST_REMOVE_HEAD(head, field)
Removes and returns the head entry from a list.
Definition: linkedlists.h:832
void ast_party_redirecting_free(struct ast_party_redirecting *doomed)
Destroy the redirecting information contents.
Definition: channel.c:2179
Definition: chanvars.h:28
Definition: chanvars.h:34
struct ast_party_dialed * ast_channel_dialed(struct ast_channel *chan)
Definition: channel_internal_api.c:904
struct ast_party_redirecting * ast_channel_redirecting(struct ast_channel *chan)
Definition: channel_internal_api.c:908
void ast_party_dialed_free(struct ast_party_dialed *doomed)
Destroy the dialed party contents.
Definition: channel.c:1971
void ast_pbx_hangup_handler_destroy(struct ast_channel *chan)
Destroy the hangup handler container on a channel.
Definition: pbx_hangup_handler.c:103
Definition: search.h:40
struct ast_party_connected_line * ast_channel_connected_indicated(struct ast_channel *chan)
Definition: channel_internal_api.c:896
◆ ast_get_channel_tech()
| const struct ast_channel_tech* ast_get_channel_tech | ( | const char * | name | ) |
Get handle to channel driver based on name.
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 | ) |
Hangup a channel.
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
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_install_music_functions()
| void ast_install_music_functions | ( | int(*)(struct ast_channel *, const char *, const char *) | start_ptr, |
| void(*)(struct ast_channel *) | stop_ptr, | ||
| void(*)(struct ast_channel *) | cleanup_ptr | ||
| ) |
Definition at line 7850 of file channel.c.
References ast_moh_cleanup_ptr, ast_moh_start_ptr, and ast_moh_stop_ptr.
Referenced by load_module(), and reload().
static int(* ast_moh_start_ptr)(struct ast_channel *, const char *, const char *)
Definition: channel.c:7846
static void(* ast_moh_cleanup_ptr)(struct ast_channel *)
Definition: channel.c:7848
◆ 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_moh_cleanup()
| void ast_moh_cleanup | ( | struct ast_channel * | chan | ) |
Definition at line 7882 of file channel.c.
References ast_moh_cleanup_ptr.
Referenced by ast_channel_destructor().
static void(* ast_moh_cleanup_ptr)(struct ast_channel *)
Definition: channel.c:7848
◆ ast_moh_start()
| int ast_moh_start | ( | struct ast_channel * | chan, |
| const char * | mclass, | ||
| const char * | interpclass | ||
| ) |
Turn on music on hold on a given channel.
- Parameters
-
chan The channel structure that will get music on hold mclass The class to use if the musicclass is not currently set on the channel structure. NULL and the empty string are equivalent. interpclass The class to use if the musicclass is not currently set on the channel structure or in the mclass argument. NULL and the empty string are equivalent.
- Return values
-
Zero on success non-zero on failure
Definition at line 7866 of file channel.c.
References ast_moh_start_ptr, and ast_verb.
Referenced by alsa_indicate(), app_control_moh_start(), app_exec(), ast_ari_bridges_start_moh(), ast_bridge_channel_playfile(), ast_unreal_indicate(), chan_pjsip_indicate(), channel_do_masquerade(), conf_moh_start(), conf_moh_unsuspend(), conf_start_moh(), console_indicate(), dahdi_indicate(), dial_exec_full(), handle_setmusic(), iax2_indicate(), jingle_indicate(), limits_interval_playback(), mgcp_indicate(), misdn_indication(), moh_handle_digit(), monitor_dial(), ooh323_indicate(), oss_indicate(), participant_entertainment_start(), phone_indicate(), play_moh_exec(), queue_exec(), retrydial_exec(), rna(), say_periodic_announcement(), say_position(), sip_indicate(), skinny_indicate(), start_moh_exec(), unistim_indicate(), and valid_priv_reply().
7871 ast_verb(3, "Music class %s requested but no musiconhold loaded.\n", mclass ? mclass : (interpclass ? interpclass : "default"));
static int(* ast_moh_start_ptr)(struct ast_channel *, const char *, const char *)
Definition: channel.c:7846
◆ ast_moh_stop()
| void ast_moh_stop | ( | struct ast_channel * | chan | ) |
Turn off music on hold on a given channel.
Definition at line 7876 of file channel.c.
References ast_moh_stop_ptr.
Referenced by alsa_indicate(), app_control_moh_stop(), app_exec(), ast_bridge_add_channel(), ast_unreal_indicate(), chan_pjsip_indicate(), channel_do_masquerade(), conf_moh_stop(), conf_moh_suspend(), conf_run(), console_indicate(), dahdi_indicate(), dial_exec_full(), handle_setmusic(), iax2_indicate(), jingle_indicate(), mgcp_indicate(), misdn_indication(), moh_channel_thread(), moh_handle_digit(), monitor_dial(), ooh323_indicate(), oss_indicate(), participant_entertainment_stop(), phone_indicate(), play_moh_exec(), queue_exec(), retrydial_exec(), say_periodic_announcement(), say_position(), sip_indicate(), skinny_indicate(), stasis_app_bridge_moh_stop(), stop_moh_exec(), try_calling(), unistim_indicate(), valid_priv_reply(), and wait_for_answer().
◆ 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 group and pickup group —.
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 * | group | ||
| ) |
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.
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 for channel.
Queue a hangup frame.
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 for channel.
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.
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_generator_actions()
|
static |
Definition at line 3416 of file channel.c.
References ast_channel_generator(), ast_channel_generatordata(), ast_channel_generatordata_set(), ast_channel_lock, ast_channel_timingfunc(), ast_channel_unlock, ast_channel_writeformat(), ast_deactivate_generator(), ast_debug, ast_format_cmp(), AST_FORMAT_CMP_NOT_EQUAL, ast_format_get_sample_rate(), AST_FRAME_VOICE, ast_frame::datalen, ast_frame_subclass::format, ast_frame::frametype, ast_generator::generate, generator, NULL, ast_frame::samples, and ast_frame::subclass.
Referenced by __ast_read().
3436 if (ast_format_cmp(f->subclass.format, ast_channel_writeformat(chan)) == AST_FORMAT_CMP_NOT_EQUAL) {
3438 factor = ((float) ast_format_get_sample_rate(ast_channel_writeformat(chan))) / ((float) ast_format_get_sample_rate(f->subclass.format));
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
Definition: channel.h:226
Definition: include/asterisk/frame.h:101
int(* generate)(struct ast_channel *chan, void *data, int len, int samples)
Definition: channel.h:234
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
Definition: format.h:38
void ast_channel_generatordata_set(struct ast_channel *chan, void *value)
Definition: channel_internal_api.c:553
struct ast_generator * ast_channel_generator(const struct ast_channel *chan)
Definition: channel_internal_api.c:713
void ast_deactivate_generator(struct ast_channel *chan)
Definition: channel.c:2902
unsigned int ast_format_get_sample_rate(const struct ast_format *format)
Get the sample rate of a media format.
Definition: format.c:379
struct ast_format * ast_channel_writeformat(struct ast_channel *chan)
Definition: channel_internal_api.c:860
ast_timing_func_t ast_channel_timingfunc(const struct ast_channel *chan)
Definition: channel_internal_api.c:1231
◆ 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.
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
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 | ftimeout, | ||
| char * | enders, | ||
| int | audiofd, | ||
| int | ctrlfd | ||
| ) |
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, look for hangups.
Wait for a specified amount of time, looking for hangups.
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_say_character_str()
| int ast_say_character_str | ( | struct ast_channel * | chan, |
| const char * | str, | ||
| const char * | ints, | ||
| const char * | lang, | ||
| enum ast_say_case_sensitivity | sensitivity | ||
| ) |
function to pronounce character and phonetic strings
Definition at line 8367 of file channel.c.
References ast_say_character_str_full.
Referenced by common_exec(), pbx_builtin_saycharacters(), pbx_builtin_saycharacters_case(), play_mailbox_owner(), play_on_channel(), and vmsayname_exec().
SAY_EXTERN int(* ast_say_character_str_full)(struct ast_channel *chan, const char *num, const char *ints, const char *lang, enum ast_say_case_sensitivity sensitivity, int audiofd, int ctrlfd) SAY_INIT(ast_say_character_str_full)
Definition: say.h:175
◆ ast_say_digit_str()
| int ast_say_digit_str | ( | struct ast_channel * | chan, |
| const char * | num, | ||
| const char * | ints, | ||
| const char * | lang | ||
| ) |
says digits of a string
- Parameters
-
chan channel to act upon num string to speak ints which dtmf to interrupt on lang language to speak in
Vocally says the digits of a given string
- Return values
-
0 on succes DTMF if interrupted -1 on failure
Definition at line 8355 of file channel.c.
References ast_say_digit_str_full.
Referenced by __analog_ss_thread(), forward_message(), invent_message(), mgcp_ss(), pbx_builtin_saydigits(), play_message_callerid(), and play_on_channel().
SAY_EXTERN int(* ast_say_digit_str_full)(struct ast_channel *chan, const char *num, const char *ints, const char *lang, int audiofd, int ctrlfd) SAY_INIT(ast_say_digit_str_full)
Same as ast_say_digit_str() with audiofd for received audio and returns 1 on ctrlfd being readable...
Definition: say.h:143
◆ ast_say_digits()
| int ast_say_digits | ( | struct ast_channel * | chan, |
| int | num, | ||
| const char * | ints, | ||
| const char * | lang | ||
| ) |
says digits
- Parameters
-
chan channel to act upon num number to speak ints which dtmf to interrupt on lang language to speak
Vocally says digits of a given number
- Return values
-
0 on success DTMF if interrupted -1 on failure
Definition at line 8349 of file channel.c.
References ast_say_digits_full().
Referenced by announce_to_dial(), common_exec(), conf_exec(), conf_run(), and say_parking_space().
int ast_say_digits_full(struct ast_channel *chan, int num, const char *ints, const char *lang, int audiofd, int ctrlfd)
Same as ast_say_digits() with audiofd for received audio and returns 1 on ctrlfd being readable...
Definition: channel.c:8379
◆ ast_say_digits_full()
| int ast_say_digits_full | ( | struct ast_channel * | chan, |
| int | num, | ||
| const char * | ints, | ||
| const char * | lang, | ||
| int | audiofd, | ||
| int | ctrlfd | ||
| ) |
Same as ast_say_digits() with audiofd for received audio and returns 1 on ctrlfd being readable.
Definition at line 8379 of file channel.c.
References ast_say_digit_str_full, and buf.
Referenced by ast_say_digits(), ast_say_enumeration_full_da(), ast_say_enumeration_full_de(), ast_say_enumeration_full_is(), ast_say_number_full_cs(), ast_say_number_full_da(), ast_say_number_full_de(), ast_say_number_full_en_GB(), ast_say_number_full_es(), ast_say_number_full_fr(), ast_say_number_full_he(), ast_say_number_full_hu(), ast_say_number_full_is(), ast_say_number_full_it(), ast_say_number_full_ja(), ast_say_number_full_ka(), ast_say_number_full_nl(), ast_say_number_full_no(), ast_say_number_full_pt(), ast_say_number_full_ru(), ast_say_number_full_se(), ast_say_number_full_th(), ast_say_number_full_ur(), ast_say_number_full_vi(), ast_say_number_full_zh(), and say_init_mode().
SAY_EXTERN int(* ast_say_digit_str_full)(struct ast_channel *chan, const char *num, const char *ints, const char *lang, int audiofd, int ctrlfd) SAY_INIT(ast_say_digit_str_full)
Same as ast_say_digit_str() with audiofd for received audio and returns 1 on ctrlfd being readable...
Definition: say.h:143
◆ ast_say_enumeration()
| int ast_say_enumeration | ( | struct ast_channel * | chan, |
| int | num, | ||
| const char * | ints, | ||
| const char * | lang, | ||
| const char * | options | ||
| ) |
says an enumeration
- Parameters
-
chan channel to say them enumeration on num number to say on the channel ints which dtmf to interrupt on lang language to speak the enumeration options set to 'f' for female, 'm' for male, 'c' for commune, 'n' for neuter
Vocally says an enumeration on a given channel (first, sencond, third, forth, thirtyfirst, hundredth, ....) Especially useful for dates and messages. Says 'last' if num equals to INT_MAX
- Return values
-
0 on success DTMF digit on interrupt -1 on failure
Definition at line 8343 of file channel.c.
References ast_say_enumeration_full.
Referenced by ast_say_date_da(), ast_say_date_de(), ast_say_date_is(), ast_say_date_with_format_da(), ast_say_date_with_format_de(), ast_say_date_with_format_en(), ast_say_date_with_format_is(), ast_say_date_with_format_pl(), and ast_say_date_with_format_vi().
SAY_EXTERN int(* ast_say_enumeration_full)(struct ast_channel *chan, int num, const char *ints, const char *lang, const char *options, int audiofd, int ctrlfd) SAY_INIT(ast_say_enumeration_full)
Same as ast_say_enumeration() with audiofd for received audio and returns 1 on ctrlfd being readable...
Definition: say.h:106
◆ ast_say_money_str()
| int ast_say_money_str | ( | struct ast_channel * | chan, |
| const char * | str, | ||
| const char * | ints, | ||
| const char * | lang | ||
| ) |
function to pronounce monetary amounts
Definition at line 8361 of file channel.c.
References ast_say_money_str_full.
Referenced by pbx_builtin_saymoney().
SAY_EXTERN int(* ast_say_money_str_full)(struct ast_channel *chan, const char *num, const char *ints, const char *lang, int audiofd, int ctrlfd) SAY_INIT(ast_say_money_str_full)
Definition: say.h:151
◆ ast_say_number()
| int ast_say_number | ( | struct ast_channel * | chan, |
| int | num, | ||
| const char * | ints, | ||
| const char * | lang, | ||
| const char * | options | ||
| ) |
says a number
- Parameters
-
chan channel to say them number on num number to say on the channel ints which dtmf to interrupt on lang language to speak the number options set to 'f' for female, 'm' for male, 'c' for commune, 'n' for neuter
Vocally says a number on a given channel
- Return values
-
0 on success DTMF digit on interrupt -1 on failure
Definition at line 8337 of file channel.c.
References ast_say_number_full.
Referenced by announce_user_count(), app_exec(), ast_say_date_da(), ast_say_date_de(), ast_say_date_en(), ast_say_date_fr(), ast_say_date_gr(), ast_say_date_he(), ast_say_date_hu(), ast_say_date_is(), ast_say_date_ja(), ast_say_date_ka(), ast_say_date_nl(), ast_say_date_pt(), ast_say_date_th(), ast_say_date_with_format_da(), ast_say_date_with_format_de(), ast_say_date_with_format_en(), ast_say_date_with_format_es(), ast_say_date_with_format_fr(), ast_say_date_with_format_is(), ast_say_date_with_format_it(), ast_say_date_with_format_nl(), ast_say_date_with_format_pl(), ast_say_date_with_format_pt(), ast_say_date_with_format_th(), ast_say_date_with_format_vi(), ast_say_datetime_en(), ast_say_datetime_fr(), ast_say_datetime_from_now_en(), ast_say_datetime_from_now_fr(), ast_say_datetime_from_now_he(), ast_say_datetime_from_now_ka(), ast_say_datetime_from_now_pt(), ast_say_datetime_he(), ast_say_datetime_ja(), ast_say_datetime_pt(), ast_say_datetime_th(), ast_say_datetime_zh(), ast_say_time_de(), ast_say_time_en(), ast_say_time_fr(), ast_say_time_gr(), ast_say_time_hu(), ast_say_time_ja(), ast_say_time_ka(), ast_say_time_nl(), ast_say_time_pt(), ast_say_time_pt_BR(), ast_say_time_th(), ast_say_time_zh(), conf_run(), count_exec(), dictate_exec(), get_folder(), get_folder_ja(), gr_say_number_female(), limits_interval_playback(), meetme_menu_admin_extended(), pbx_builtin_saynumber(), play_message(), play_message_duration(), play_on_channel(), playback_common(), say_and_wait(), say_position(), try_calling(), vm_intro_gr(), vm_intro_he(), vm_intro_multilang(), vm_intro_pt(), and vm_intro_pt_BR().
SAY_EXTERN int(* ast_say_number_full)(struct ast_channel *chan, int num, const char *ints, const char *lang, const char *options, int audiofd, int ctrlfd) SAY_INIT(ast_say_number_full)
Same as ast_say_number() with audiofd for received audio and returns 1 on ctrlfd being readable...
Definition: say.h:86
◆ ast_say_phonetic_str()
| int ast_say_phonetic_str | ( | struct ast_channel * | chan, |
| const char * | str, | ||
| const char * | ints, | ||
| const char * | lang | ||
| ) |
Definition at line 8373 of file channel.c.
References ast_say_phonetic_str_full.
Referenced by pbx_builtin_sayphonetic().
SAY_EXTERN int(* ast_say_phonetic_str_full)(struct ast_channel *chan, const char *num, const char *ints, const char *lang, int audiofd, int ctrlfd) SAY_INIT(ast_say_phonetic_str_full)
Definition: say.h:180
◆ 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
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
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
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
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
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
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_setstate()
| int ast_setstate | ( | struct ast_channel * | chan, |
| enum | ast_channel_state | ||
| ) |
Change the state of a channel.
- Precondition
- chan is locked
Definition at line 7486 of file channel.c.
References ast_channel_flags(), AST_CHANNEL_NAME, ast_channel_name(), ast_channel_publish_snapshot(), ast_channel_state_set(), ast_copy_string(), AST_DEVICE_UNKNOWN, AST_DEVSTATE_CACHABLE, ast_devstate_changed_literal(), AST_DEVSTATE_NOT_CACHABLE, AST_FLAG_DISABLE_DEVSTATE_CACHE, ast_test_flag, and name.
Referenced by __analog_handle_event(), __analog_ss_thread(), __ast_read(), __dahdi_exception(), alsa_answer(), analog_answer(), analog_call(), analog_exception(), analog_ss_thread(), ast_raw_answer_with_stream_topology(), AST_TEST_DEFINE(), cb_events(), chan_pjsip_answer(), chan_pjsip_incoming_response(), console_answer(), dahdi_answer(), dahdi_call(), dahdi_handle_event(), dahdi_indicate(), dahdi_read(), handle_invite_replaces(), handle_request_invite(), handle_response_ciev(), handle_response_invite(), iax2_call(), indicate_busy(), indicate_congestion(), jingle_action_session_info(), jingle_action_session_initiate(), jingle_call(), mbl_hangup(), mgcp_answer(), mgcp_call(), mgcp_ss(), misdn_call(), misdn_indication(), my_set_waitingfordt(), nbs_call(), nbs_hangup(), onAlerting(), onProgress(), ooh323_answer(), ooh323_new(), oss_answer(), phone_answer(), phone_call(), phone_exception(), phone_hangup(), phone_write(), refer_incoming_invite_request(), release_chan(), release_chan_early(), setsubstate(), sip_answer(), skinny_newcall(), unistim_answer(), unistim_call(), unistim_new(), unistim_ss(), and unreal_queue_frame().
7503 /* We have to pass AST_DEVICE_UNKNOWN here because it is entirely possible that the channel driver
7504 * for this channel is using the callback method for device state. If we pass in an actual state here
7506 ast_devstate_changed_literal(AST_DEVICE_UNKNOWN, (ast_test_flag(ast_channel_flags(chan), AST_FLAG_DISABLE_DEVSTATE_CACHE) ? AST_DEVSTATE_NOT_CACHABLE : AST_DEVSTATE_CACHABLE), name);
Definition: devicestate.h:53
Definition: channel.h:1030
Definition: devicestate.h:70
Definition: localtime.c:158
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)
void ast_channel_state_set(struct ast_channel *chan, enum ast_channel_state)
Definition: channel_internal_api.c:820
void ast_channel_publish_snapshot(struct ast_channel *chan)
Publish a ast_channel_snapshot for a channel.
Definition: stasis_channels.c:1055
Definition: devicestate.h:69
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
int ast_devstate_changed_literal(enum ast_device_state state, enum ast_devstate_cache cachable, const char *device)
Tells Asterisk the State for Device is changed.
Definition: devicestate.c:471
◆ 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 a channel, lock.
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 a channel, don't lock.
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.
- 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 a symbolic hangup cause to number.
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_THREADSTORAGE_RAW()
| AST_THREADSTORAGE_RAW | ( | in_intercept_routine | ) |
Storage to determine if the current thread is running an intercept dialplan routine.
Referenced by ast_channel_queue_redirecting_update().
◆ 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 call to dest, if the channel supports 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 call to dest, if the channel supports transfer.
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_uninstall_music_functions()
| void ast_uninstall_music_functions | ( | void | ) |
Definition at line 7859 of file channel.c.
References ast_moh_cleanup_ptr, ast_moh_start_ptr, ast_moh_stop_ptr, and NULL.
Referenced by unload_module().
static int(* ast_moh_start_ptr)(struct ast_channel *, const char *, const char *)
Definition: channel.c:7846
static void(* ast_moh_cleanup_ptr)(struct ast_channel *)
Definition: channel.c:7848
◆ 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
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 | ||
| ) |
Wait for x amount of time on a file descriptor to have input.
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 | ||
| ) |
Wait for x amount of time on a file descriptor to have input.
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.
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.
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
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
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_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
◆ calc_monitor_jump()
|
inlinestatic |
calculates the number of samples to jump forward with in a monitor stream.
- Note
- When using ast_seekstream() with the read and write streams of a monitor, the number of samples to seek forward must be of the same sample rate as the stream or else the jump will not be calculated correctly.
- Return values
-
number of samples to seek forward after rate conversion.
Definition at line 3516 of file channel.c.
References ast_frame::samples.
Referenced by __ast_read(), and ast_write_stream().
◆ call_forward_inherit()
|
static |
Definition at line 5959 of file channel.c.
References ast_channel_datastore_inherit(), ast_channel_flags(), ast_channel_inherit_variables(), ast_channel_lock, ast_channel_lock_both, ast_channel_redirecting(), ast_channel_redirecting_macro(), ast_channel_redirecting_sub(), ast_channel_unlock, ast_channel_update_redirecting(), ast_check_hangup(), AST_FLAG_ZOMBIE, ast_max_forwards_decrement(), ast_party_redirecting_copy(), ast_party_redirecting_free(), ast_party_redirecting_init(), ast_test_flag, and NULL.
Referenced by ast_call_forward().
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
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
int ast_check_hangup(struct ast_channel *chan)
Checks to see if a channel is needing hang up.
Definition: channel.c:445
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.
Definition: channel.c:10584
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
Definition: channel.h:988
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
int ast_max_forwards_decrement(struct ast_channel *chan)
Decrement the max forwards count for a particular channel.
Definition: max_forwards.c:135
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.
Definition: channel.c:10487
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ channel_cc_params_copy()
|
static |
Definition at line 10629 of file channel.c.
References ast_cc_config_params_init, ast_cc_copy_config_params(), and NULL.
#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
◆ channel_cc_params_destroy()
|
static |
Definition at line 10640 of file channel.c.
References ast_cc_config_params_destroy().
void ast_cc_config_params_destroy(struct ast_cc_config_params *params)
Free memory from CCSS configuration params.
Definition: ccss.c:693
Definition: ccss.c:161
◆ channel_do_masquerade()
|
static |
Masquerade a channel.
- Note
- Assumes NO channels and NO channel pvt's are locked. If a channel is locked while calling this function, it invalidates our channel container locking order. All channels must be unlocked before it is permissible to lock the channels' ao2 container.
Definition at line 6952 of file channel.c.
References ao2_bump, ao2_cleanup, ao2_link, ao2_lock, ao2_ref, ao2_unlink, ao2_unlock, ast_app_group_update(), ast_audiohook_move_all(), ast_autochan_new_channel(), ast_bridge_notify_masquerade(), ast_channel_accountcode(), ast_channel_adsicpe_set(), ast_channel_alert_write(), ast_channel_blocker(), ast_channel_bridge_peer(), ast_channel_caller(), ast_channel_caller_set(), ast_channel_connected(), ast_channel_connected_set(), ast_channel_datastores(), ast_channel_dialed(), ast_channel_dialed_set(), ast_channel_end_dtmf(), ast_channel_fd(), ast_channel_fd_count(), ast_channel_fdno(), ast_channel_fdno_set(), ast_channel_flags(), ast_channel_hangup_handlers(), ast_channel_hold_state(), ast_channel_internal_alertpipe_swap(), ast_channel_internal_fd_clear_all(), ast_channel_internal_swap_endpoint_forward(), ast_channel_internal_swap_snapshots(), ast_channel_internal_swap_stream_topology(), ast_channel_internal_swap_topics(), ast_channel_internal_swap_uniqueid_and_linkedid(), ast_channel_language(), ast_channel_latest_musicclass(), ast_channel_lock, ast_channel_lock_both, ast_channel_masq_set(), ast_channel_masqr_set(), ast_channel_monitor(), ast_channel_monitor_set(), ast_channel_musicclass(), AST_CHANNEL_NAME, ast_channel_name(), ast_channel_name_set(), ast_channel_nativeformats(), ast_channel_nativeformats_set(), ast_channel_parkinglot(), ast_channel_publish_snapshot(), ast_channel_rawreadformat(), ast_channel_rawwriteformat(), ast_channel_readformat(), ast_channel_readq(), ast_channel_redirecting(), ast_channel_redirecting_set(), ast_channel_ref, ast_channel_sending_dtmf_digit(), ast_channel_sending_dtmf_tv(), ast_channel_set_fd(), ast_channel_set_rawreadformat(), ast_channel_set_rawwriteformat(), ast_channel_snapshot_segment_flags(), ast_channel_softhangup_internal_flag_set(), ast_channel_state_set(), ast_channel_tech(), ast_channel_tech_pvt(), ast_channel_tech_pvt_set(), ast_channel_tech_set(), ast_channel_timingfd(), ast_channel_unlock, ast_channel_unref, ast_channel_visible_indication(), ast_channel_writeformat(), ast_clear_flag, AST_CONTROL_HOLD, AST_CONTROL_MASQUERADE_NOTIFY, AST_CONTROL_SRCCHANGE, AST_CONTROL_UNHOLD, ast_copy_string(), ast_debug, AST_FLAG_BLOCKING, AST_FLAG_DISABLE_DEVSTATE_CACHE, AST_FLAG_EXCEPTION, AST_FLAG_MOH, AST_FLAG_OUTGOING, AST_FLAG_ZOMBIE, AST_FLAGS_ALL, ast_format_cap_alloc, ast_format_cap_append_from_cap(), AST_FORMAT_CAP_FLAG_DEFAULT, ast_format_get_name(), ast_framehook_list_fixup(), AST_GENERATOR_FD, ast_indicate(), ast_indicate_data(), AST_LIST_APPEND_LIST, AST_LIST_FIRST, AST_LIST_HEAD_INIT_NOLOCK, AST_LIST_HEAD_NOLOCK(), AST_LIST_INSERT_TAIL, AST_LIST_REMOVE_HEAD, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_log, AST_MEDIA_TYPE_UNKNOWN, ast_moh_start(), ast_moh_stop(), ast_null_frame, ast_party_id_reset(), ast_queue_frame(), ast_set_flag, ast_set_read_format(), ast_set_write_format(), AST_SOFTHANGUP_DEV, ast_strdupa, ast_strlen_zero, ast_test_flag, AST_TIMING_FD, ast_channel::caller, ast_datastore_info::chan_breakdown, ast_datastore_info::chan_fixup, clone_variables(), ast_channel::connected, ast_datastore::data, ast_channel::dialed, errno, free_translation(), ast_datastore::info, len(), LOG_WARNING, NULL, ast_channel::redirecting, S_OR, and type.
Referenced by ast_channel_move().
7140 orig_disablestatecache = ast_test_flag(ast_channel_flags(original), AST_FLAG_DISABLE_DEVSTATE_CACHE);
7141 clone_disablestatecache = ast_test_flag(ast_channel_flags(clonechan), AST_FLAG_DISABLE_DEVSTATE_CACHE);
7211 AST_LIST_APPEND_LIST(ast_channel_datastores(original), ast_channel_datastores(clonechan), entry);
7230 ast_set_flag(ast_channel_flags(original), ast_test_flag(ast_channel_flags(clonechan), AST_FLAG_EXCEPTION | AST_FLAG_OUTGOING));
7280 ast_format_cap_append_from_cap(tmp_cap, ast_channel_nativeformats(clonechan), AST_MEDIA_TYPE_UNKNOWN);
7304 if (ast_channel_tech(original)->fixup && ast_channel_tech(original)->fixup(clonechan, original)) {
7305 ast_log(LOG_WARNING, "Channel type '%s' could not fixup channel %s, strange things may happen. (clonechan)\n",
7310 if (ast_channel_tech(clonechan)->fixup && ast_channel_tech(clonechan)->fixup(original, clonechan)) {
7311 ast_log(LOG_WARNING, "Channel type '%s' could not fixup channel %s, strange things may happen. (original)\n",
7404 ast_debug(1, "Done Masquerading %s (%u)\n", ast_channel_name(original), ast_channel_state(original));
struct ast_party_caller * ast_channel_caller(struct ast_channel *chan)
Definition: channel_internal_api.c:888
Definition: include/asterisk/frame.h:293
void ast_channel_fdno_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:423
int ast_set_read_format(struct ast_channel *chan, struct ast_format *format)
Sets read format on channel chan.
Definition: channel.c:5849
int ast_channel_hold_state(const struct ast_channel *chan)
Definition: channel_internal_api.c:485
struct ast_party_connected_line connected
Channel Connected Line ID information.
Definition: channel_internal_api.c:140
#define AST_LIST_FIRST(head)
Returns the first entry contained in a list.
Definition: linkedlists.h:420
void(* chan_breakdown)(void *data, struct ast_channel *old_chan, struct ast_channel *new_chan)
Fix up channel references on the channel being masqueraded into.
Definition: datastore.h:64
void * ast_channel_tech_pvt(const struct ast_channel *chan)
Definition: channel_internal_api.c:565
void ast_audiohook_move_all(struct ast_channel *old_chan, struct ast_channel *new_chan)
Move all audiohooks from one channel to another.
Definition: audiohook.c:700
char ast_channel_sending_dtmf_digit(const struct ast_channel *chan)
Definition: channel_internal_api.c:388
static void free_translation(struct ast_channel *clonechan)
Definition: channel.c:2492
void ast_channel_set_rawwriteformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:832
void ast_channel_dialed_set(struct ast_channel *chan, struct ast_party_dialed *value)
Definition: channel_internal_api.c:954
void ast_moh_stop(struct ast_channel *chan)
Turn off music on hold on a given channel.
Definition: channel.c:7876
Definition: channel.h:992
struct ast_party_redirecting redirecting
Redirecting/Diversion information.
Definition: channel_internal_api.c:148
Definition: channel.h:1122
static void clone_variables(struct ast_channel *original, struct ast_channel *clonechan)
Clone channel variables from 'clone' channel into 'original' channel.
Definition: channel.c:6917
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_softhangup_internal_flag_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:1001
void ast_channel_internal_fd_clear_all(struct ast_channel *chan)
Definition: channel_internal_api.c:1182
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
void ast_channel_internal_swap_stream_topology(struct ast_channel *chan1, struct ast_channel *chan2)
Definition: channel_internal_api.c:1628
int ast_app_group_update(struct ast_channel *oldchan, struct ast_channel *newchan)
Update all group counting for a channel to a new one.
Definition: main/app.c:2143
int ast_indicate(struct ast_channel *chan, int condition)
Indicates condition of channel.
Definition: channel.c:4322
struct ast_format * ast_channel_readformat(struct ast_channel *chan)
Definition: channel_internal_api.c:856
Definition: channel.h:986
void ast_channel_tech_set(struct ast_channel *chan, const struct ast_channel_tech *value)
Definition: channel_internal_api.c:773
void ast_channel_internal_alertpipe_swap(struct ast_channel *chan1, struct ast_channel *chan2)
Swap the interal alertpipe between two channels.
Definition: channel_internal_api.c:1155
int ast_moh_start(struct ast_channel *chan, const char *mclass, const char *interpclass)
Turn on music on hold on a given channel.
Definition: channel.c:7866
struct ast_readq_list * ast_channel_readq(struct ast_channel *chan)
Definition: channel_internal_api.c:876
void ast_channel_internal_swap_endpoint_forward(struct ast_channel *a, struct ast_channel *b)
Swap endpoint_forward between two channels.
Definition: channel_internal_api.c:1447
void(* chan_fixup)(void *data, struct ast_channel *old_chan, struct ast_channel *new_chan)
Fix up channel references on the masquerading channel.
Definition: datastore.h:50
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
void ast_channel_masq_set(struct ast_channel *chan, struct ast_channel *value)
Definition: channel_internal_api.c:601
void ast_channel_set_rawreadformat(struct ast_channel *chan, struct ast_format *format)
Definition: channel_internal_api.c:828
void ast_channel_internal_swap_topics(struct ast_channel *a, struct ast_channel *b)
Swap topics beteween two channels.
Definition: channel_internal_api.c:1433
const char * ast_channel_latest_musicclass(const struct ast_channel *chan)
const char * ast_channel_accountcode(const struct ast_channel *chan)
void ast_channel_nativeformats_set(struct ast_channel *chan, struct ast_format_cap *value)
Definition: channel_internal_api.c:677
struct ast_party_connected_line * ast_channel_connected(struct ast_channel *chan)
Definition: channel_internal_api.c:892
int ast_channel_visible_indication(const struct ast_channel *chan)
Definition: channel_internal_api.c:477
Definition: codec.h:31
struct ast_datastore_list * ast_channel_datastores(struct ast_channel *chan)
Definition: channel_internal_api.c:868
void ast_channel_internal_swap_uniqueid_and_linkedid(struct ast_channel *a, struct ast_channel *b)
Swap uniqueid and linkedid beteween two channels.
Definition: channel_internal_api.c:1416
#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)
void ast_party_id_reset(struct ast_party_id *id)
Destroy and initialize the given party id structure.
Definition: channel.c:1896
void ast_channel_caller_set(struct ast_channel *chan, struct ast_party_caller *value)
Definition: channel_internal_api.c:944
Structure to describe a channel "technology", ie a channel driver See for examples: ...
Definition: channel.h:629
void ast_channel_adsicpe_set(struct ast_channel *chan, enum ast_channel_adsicpe value)
Definition: channel_internal_api.c:785
Definition: format_cap.h:38
int ast_channel_fdno(const struct ast_channel *chan)
Definition: channel_internal_api.c:419
void ast_channel_masqr_set(struct ast_channel *chan, struct ast_channel *value)
Definition: channel_internal_api.c:609
Definition: res_rtp_asterisk.c:590
int ast_channel_timingfd(const struct ast_channel *chan)
Definition: channel_internal_api.c:469
void ast_framehook_list_fixup(struct ast_channel *old_chan, struct ast_channel *new_chan)
This is used by the channel API during a masquerade operation to move all mobile framehooks from the ...
Definition: framehook.c:223
struct ast_format * ast_channel_rawreadformat(struct ast_channel *chan)
Definition: channel_internal_api.c:848
#define AST_LIST_INSERT_TAIL(head, elm, field)
Appends a list entry to the tail of a list.
Definition: linkedlists.h:730
Format capabilities structure, holds formats + preference order + etc.
Definition: format_cap.c:54
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
Definition: func_strings.c:1344
int errno
pthread_t ast_channel_blocker(const struct ast_channel *chan)
Definition: channel_internal_api.c:1213
struct ast_party_dialed * ast_channel_dialed(struct ast_channel *chan)
Definition: channel_internal_api.c:904
int(*const fixup)(struct ast_channel *oldchan, struct ast_channel *newchan)
Fix up a channel: If a channel is consumed, this is called. Basically update any ->owner links...
Definition: channel.h:775
Redirecting Line information. RDNIS (Redirecting Directory Number Information Service) Where a call d...
Definition: channel.h:523
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.
Definition: channel.c:11070
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
struct ast_hangup_handler_list * ast_channel_hangup_handlers(struct ast_channel *chan)
Definition: channel_internal_api.c:864
void ast_autochan_new_channel(struct ast_channel *old_chan, struct ast_channel *new_chan)
Switch what channel autochans point to.
Definition: autochan.c:86
Definition: channel.h:988
void ast_bridge_notify_masquerade(struct ast_channel *chan)
Notify bridging that this channel was just masqueraded.
Definition: bridge.c:1482
Definition: channel.h:1030
struct ast_party_redirecting * ast_channel_redirecting(struct ast_channel *chan)
Definition: channel_internal_api.c:908
struct ast_format_cap * ast_channel_nativeformats(const struct ast_channel *chan)
Definition: channel_internal_api.c:637
struct timeval ast_channel_sending_dtmf_tv(const struct ast_channel *chan)
Definition: channel_internal_api.c:397
int ast_channel_fd(const struct ast_channel *chan, int which)
Definition: channel_internal_api.c:1186
#define AST_LIST_HEAD_INIT_NOLOCK(head)
Initializes a list head structure.
Definition: linkedlists.h:680
Definition: include/asterisk/frame.h:294
Definition: channel.h:1000
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)
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_state_set(struct ast_channel *chan, enum ast_channel_state)
Definition: channel_internal_api.c:820
void ast_channel_connected_set(struct ast_channel *chan, struct ast_party_connected_line *value)
Definition: channel_internal_api.c:949
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
const char * ast_channel_language(const struct ast_channel *chan)
struct ast_flags * ast_channel_snapshot_segment_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1659
Definition: search.h:40
void ast_channel_publish_snapshot(struct ast_channel *chan)
Publish a ast_channel_snapshot for a channel.
Definition: stasis_channels.c:1055
#define AST_LIST_TRAVERSE_SAFE_BEGIN(head, var, field)
Loops safely over (traverses) the entries in a list.
Definition: linkedlists.h:528
int ast_format_cap_append_from_cap(struct ast_format_cap *dst, const struct ast_format_cap *src, enum ast_media_type type)
Append the formats of provided type in src to dst.
Definition: format_cap.c:269
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
void ast_channel_internal_swap_snapshots(struct ast_channel *a, struct ast_channel *b)
Swap snapshots beteween two channels.
Definition: channel_internal_api.c:1456
void ast_channel_name_set(struct ast_channel *chan, const char *name)
Set the channel name.
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
Definition: channel.h:990
void ast_channel_tech_pvt_set(struct ast_channel *chan, void *value)
Definition: channel_internal_api.c:569
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
const char * ast_channel_parkinglot(const struct ast_channel *chan)
void ast_channel_set_fd(struct ast_channel *chan, int which, int fd)
Definition: channel.c:2431
int ast_channel_alert_write(struct ast_channel *chan)
Definition: channel_internal_api.c:1110
const char * ast_channel_musicclass(const struct ast_channel *chan)
void ast_channel_redirecting_set(struct ast_channel *chan, struct ast_party_redirecting *value)
Definition: channel_internal_api.c:959
void ast_channel_monitor_set(struct ast_channel *chan, struct ast_channel_monitor *value)
Definition: channel_internal_api.c:617
Definition: channel.h:895
#define AST_LIST_APPEND_LIST(head, list, field)
Appends a whole list to the tail of a list.
Definition: linkedlists.h:782
◆ channel_feature_hooks_set_full()
|
static |
Definition at line 11115 of file channel.c.
References ast_bridge_features_cleanup(), ast_bridge_features_init(), ast_bridge_features_merge(), ast_bridge_features_new(), ast_channel_datastore_add(), ast_channel_datastore_find(), ast_datastore_alloc, ast_datastore_free(), ast_datastore::data, and NULL.
Referenced by ast_channel_feature_hooks_append(), and ast_channel_feature_hooks_replace().
void ast_bridge_features_cleanup(struct ast_bridge_features *features)
Clean up the contents of a bridge features structure.
Definition: bridge.c:3720
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_bridge_features_init(struct ast_bridge_features *features)
Initialize bridge features structure.
Definition: bridge.c:3687
int ast_datastore_free(struct ast_datastore *datastore)
Free a data store object.
Definition: datastore.c:68
void ast_bridge_features_merge(struct ast_bridge_features *into, const struct ast_bridge_features *from)
Merge one ast_bridge_features into another.
Definition: bridge.c:3662
static int replace(struct ast_channel *chan, const char *cmd, char *data, struct ast_str **buf, ssize_t len)
Definition: func_strings.c:790
struct ast_bridge_features * ast_bridge_features_new(void)
Allocate a new bridge features struct.
Definition: bridge.c:3750
int ast_channel_datastore_add(struct ast_channel *chan, struct ast_datastore *datastore)
Add a datastore to a channel.
Definition: channel.c:2390
static const struct ast_datastore_info bridge_features_info
Definition: channel.c:11099
◆ channel_get_external_vars()
|
static |
Definition at line 8038 of file channel.c.
References ao2_alloc, ao2_cleanup, ao2_ref, ast_free, ast_func_read2(), AST_LIST_EMPTY, AST_LIST_TRAVERSE, ast_log, AST_RWLIST_INSERT_TAIL, AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, ast_str_buffer(), ast_str_create, ast_var_assign, ast_var_t::entries, manager_channel_variable::isfunc, lock, LOG_ERROR, manager_channel_variable::name, NULL, pbx_builtin_getvar_helper(), RAII_VAR, SCOPED_LOCK, var, and varshead_dtor().
Referenced by ast_channel_get_ari_vars(), and ast_channel_get_manager_vars().
Definition: ast_expr2.c:325
int ast_func_read2(struct ast_channel *chan, const char *function, struct ast_str **str, ssize_t maxlen)
executes a read operation on a function
Definition: pbx_functions.c:642
char * ast_str_buffer(const struct ast_str *buf)
Returns the string buffer within the ast_str buf.
Definition: strings.h:714
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
#define AST_LIST_EMPTY(head)
Checks whether the specified list contains any entries.
Definition: linkedlists.h:449
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
List of channel variables to append to all channel-related events.
Definition: channel.c:7925
#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
The descriptor of a dynamic string XXX storage will be optimized later if needed We use the ts field ...
Definition: strings.h:584
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
Definition: search.h:40
#define ast_str_create(init_len)
Create a malloc'ed dynamic length string.
Definition: strings.h:620
◆ channel_has_external_vars()
|
static |
Definition at line 7946 of file channel.c.
References AST_LIST_EMPTY, AST_RWLIST_RDLOCK, and AST_RWLIST_UNLOCK.
Referenced by ast_channel_has_ari_vars(), and ast_channel_has_manager_vars().
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
#define AST_LIST_EMPTY(head)
Checks whether the specified list contains any entries.
Definition: linkedlists.h:449
◆ channel_req_accountcodes()
|
static |
Definition at line 6468 of file channel.c.
References ast_channel_accountcode(), ast_channel_peeraccount(), AST_CHANNEL_REQUESTOR_BRIDGE_PEER, AST_CHANNEL_REQUESTOR_REPLACEMENT, and ast_strlen_zero.
Referenced by ast_channel_req_accountcodes(), and ast_channel_req_accountcodes_precious().
Definition: channel.h:1479
const char * ast_channel_accountcode(const struct ast_channel *chan)
const char * ast_channel_peeraccount(const struct ast_channel *chan)
Definition: channel.h:1481
◆ channel_set_external_vars()
|
static |
Definition at line 7967 of file channel.c.
References ast_calloc, AST_RWLIST_INSERT_TAIL, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, free_external_channelvars(), manager_channel_variable::isfunc, manager_channel_variable::name, and var.
Referenced by ast_channel_set_ari_vars(), and ast_channel_set_manager_vars().
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
List of channel variables to append to all channel-related events.
Definition: channel.c:7925
Definition: search.h:40
static void free_external_channelvars(struct external_vars *channelvars)
Definition: channel.c:7936
◆ channel_set_intercept_mode()
|
static |
Definition at line 10419 of file channel.c.
References ast_log, ast_threadstorage_set_ptr(), LOG_ERROR, and status.
Referenced by ast_channel_connected_line_macro(), ast_channel_connected_line_sub(), ast_channel_redirecting_macro(), and ast_channel_redirecting_sub().
int ast_threadstorage_set_ptr(struct ast_threadstorage *ts, void *ptr)
Set a raw pointer from threadstorage.
Definition: threadstorage.h:260
◆ channels_shutdown()
|
static |
Definition at line 8095 of file channel.c.
References ami_vars, ao2_container_unregister(), ao2_ref, ari_vars, ARRAY_LEN, ast_channel_unregister(), ast_cli_unregister_multiple(), free_external_channelvars(), and NULL.
Referenced by ast_channels_init().
int ast_cli_unregister_multiple(struct ast_cli_entry *e, int len)
Unregister multiple commands.
Definition: clicompat.c:30
void ast_channel_unregister(const struct ast_channel_tech *tech)
Unregister channel driver.
Definition: channel.c:570
static const struct ast_channel_tech surrogate_tech
Channel technology used to extract a channel from a running application. The channel created with thi...
Definition: channel.c:702
void ao2_container_unregister(const char *name)
Unregister a container for CLI stats and integrity check.
Definition: astobj2_container.c:985
static void free_external_channelvars(struct external_vars *channelvars)
Definition: channel.c:7936
◆ clone_variables()
|
static |
Clone channel variables from 'clone' channel into 'original' channel.
All variables except those related to app_groupcount are cloned. Variables are actually removed from 'clone' channel, presumably because it will subsequently be destroyed.
- Note
- Assumes locks will be in place on both channels when called.
Definition at line 6917 of file channel.c.
References ast_channel_varshead(), AST_LIST_APPEND_LIST, AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_var_assign, ast_var_t::entries, ast_var_t::name, and ast_var_t::value.
Referenced by channel_do_masquerade().
6922 AST_LIST_APPEND_LIST(ast_channel_varshead(original), ast_channel_varshead(clonechan), entries);
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
#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
#define AST_LIST_APPEND_LIST(head, list, field)
Appends a whole list to the tail of a list.
Definition: linkedlists.h:782
◆ complete_channeltypes()
|
static |
Definition at line 303 of file channel.c.
References ast_cli_completion_add(), AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strdup, chanlist::list, NULL, ast_cli_args::pos, chanlist::tech, and ast_cli_args::word.
Referenced by handle_cli_core_show_channeltype().
struct chanlist::@369 list
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
int ast_cli_completion_add(char *value)
Add a result to a request for completion options.
Definition: main/cli.c:2726
◆ deactivate_generator_nolock()
|
static |
Definition at line 2886 of file channel.c.
References ast_channel_flags(), ast_channel_generator(), ast_channel_generator_set(), ast_channel_generatordata(), ast_channel_generatordata_set(), ast_channel_set_fd(), ast_clear_flag, AST_FLAG_WRITE_INT, AST_GENERATOR_FD, ast_settimeout(), generator, NULL, and ast_generator::release.
Referenced by ast_deactivate_generator(), and deactivate_silence_generator().
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
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
Definition: channel.h:984
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
void ast_channel_set_fd(struct ast_channel *chan, int which, int fd)
Definition: channel.c:2431
◆ deactivate_silence_generator()
|
static |
Definition at line 8289 of file channel.c.
References ast_channel_generator(), ast_channel_generatordata(), ast_channel_lock, ast_channel_name(), ast_channel_unlock, ast_debug, and deactivate_generator_nolock().
Referenced by ast_channel_stop_silence_generator().
8300 ast_debug(1, "Trying to stop silence generator when it is not the current generator on '%s'\n",
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
struct ast_generator * ast_channel_generator(const struct ast_channel *chan)
Definition: channel_internal_api.c:713
const char * ast_channel_name(const struct ast_channel *chan)
static void deactivate_generator_nolock(struct ast_channel *chan)
Definition: channel.c:2886
◆ destroy_hooks()
|
static |
Definition at line 2537 of file channel.c.
References ast_audiohook_detach_list(), ast_channel_audiohooks(), ast_channel_audiohooks_set(), ast_framehook_list_destroy(), and NULL.
Referenced by ast_hangup().
void ast_audiohook_detach_list(struct ast_audiohook_list *audiohook_list)
Detach audiohooks from list and destroy said list.
Definition: audiohook.c:594
void ast_channel_audiohooks_set(struct ast_channel *chan, struct ast_audiohook_list *value)
Definition: channel_internal_api.c:585
int ast_framehook_list_destroy(struct ast_channel *chan)
This is used by the channel API to detach and destroy all framehooks on a channel during channel dest...
Definition: framehook.c:206
struct ast_audiohook_list * ast_channel_audiohooks(const struct ast_channel *chan)
Definition: channel_internal_api.c:581
◆ does_id_conflict()
|
static |
Definition at line 717 of file channel.c.
References ast_channel_by_uniqueid_cb(), ast_channel_callback(), ast_channel_name(), ast_channel_unref, ast_log, ast_strlen_zero, format, LOG_ERROR, and OBJ_NOLOCK.
Referenced by __ast_channel_alloc_ap().
726 conflict = ast_channel_callback(ast_channel_by_uniqueid_cb, (char *) uniqueid, &length, OBJ_NOLOCK);
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
const char * ast_channel_name(const struct ast_channel *chan)
◆ dtmf_direction_to_string()
|
static |
Definition at line 3366 of file channel.c.
References DTMF_RECEIVED, and DTMF_SENT.
Referenced by send_dtmf_begin_event(), and send_dtmf_end_event().
Definition: channel.c:3362
Definition: channel.c:3363
◆ features_destroy()
|
static |
Definition at line 11094 of file channel.c.
References ast_bridge_features_destroy().
void ast_bridge_features_destroy(struct ast_bridge_features *features)
Destroy an allocated bridge features struct.
Definition: bridge.c:3741
◆ free_external_channelvars()
|
static |
Definition at line 7936 of file channel.c.
References ast_free, AST_RWLIST_REMOVE_HEAD, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, and var.
Referenced by channel_set_external_vars(), and channels_shutdown().
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
List of channel variables to append to all channel-related events.
Definition: channel.c:7925
Definition: search.h:40
◆ free_translation()
|
static |
Definition at line 2492 of file channel.c.
References ast_channel_readtrans(), ast_channel_readtrans_set(), ast_channel_writetrans(), ast_channel_writetrans_set(), ast_translator_free_path(), and NULL.
Referenced by ast_hangup(), and channel_do_masquerade().
void ast_channel_readtrans_set(struct ast_channel *chan, struct ast_trans_pvt *value)
Definition: channel_internal_api.c:757
struct ast_trans_pvt * ast_channel_readtrans(const struct ast_channel *chan)
Definition: channel_internal_api.c:753
void ast_channel_writetrans_set(struct ast_channel *chan, struct ast_trans_pvt *value)
Definition: channel_internal_api.c:765
struct ast_trans_pvt * ast_channel_writetrans(const struct ast_channel *chan)
Definition: channel_internal_api.c:761
void ast_translator_free_path(struct ast_trans_pvt *tr)
Frees a translator path Frees the given translator path structure.
Definition: translate.c:475
◆ generator_force()
|
static |
Definition at line 2925 of file channel.c.
References ast_channel_generator(), ast_channel_generatordata(), ast_channel_generatordata_set(), ast_channel_lock, ast_channel_unlock, ast_channel_writeformat(), ast_deactivate_generator(), ast_debug, ast_format_get_sample_rate(), chanlist::chan, ast_generator::generate, NULL, and tmp().
Referenced by ast_activate_generator().
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
int(* generate)(struct ast_channel *chan, void *data, int len, int samples)
Definition: channel.h:234
void ast_channel_generatordata_set(struct ast_channel *chan, void *value)
Definition: channel_internal_api.c:553
struct ast_generator * ast_channel_generator(const struct ast_channel *chan)
Definition: channel_internal_api.c:713
void ast_deactivate_generator(struct ast_channel *chan)
Definition: channel.c:2902
unsigned int ast_format_get_sample_rate(const struct ast_format *format)
Get the sample rate of a media format.
Definition: format.c:379
struct ast_format * ast_channel_writeformat(struct ast_channel *chan)
Definition: channel_internal_api.c:860
◆ generator_write_format_change()
|
static |
Definition at line 2913 of file channel.c.
References ast_channel_generator(), ast_channel_generatordata(), ast_channel_lock, ast_channel_unlock, generator, and ast_generator::write_format_change.
Referenced by set_format().
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
Definition: channel.h:226
void(* write_format_change)(struct ast_channel *chan, void *data)
Definition: channel.h:239
struct ast_generator * ast_channel_generator(const struct ast_channel *chan)
Definition: channel_internal_api.c:713
◆ handle_cause()
|
static |
Definition at line 5936 of file channel.c.
References AST_CAUSE_BUSY, AST_CAUSE_CONGESTION, AST_CONTROL_BUSY, and AST_CONTROL_CONGESTION.
Referenced by __ast_request_and_dial(), and ast_call_forward().
Definition: include/asterisk/frame.h:282
◆ handle_cli_core_show_channeltype()
|
static |
Show details about a channel driver - CLI command.
Definition at line 326 of file channel.c.
References ast_cli_args::argc, ast_cli_args::argv, ast_cli(), ast_format_cap_get_names(), AST_FORMAT_CAP_NAMES_LEN, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_str_alloca, CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, complete_channeltypes(), ast_cli_args::fd, chanlist::list, NULL, chanlist::tech, and ast_cli_entry::usage.
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
The descriptor of a dynamic string XXX storage will be optimized later if needed We use the ts field ...
Definition: strings.h:584
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
static char * complete_channeltypes(struct ast_cli_args *a)
Definition: channel.c:303
Definition: cli.h:153
◆ handle_cli_core_show_channeltypes()
|
static |
Show channel types - CLI command.
Definition at line 261 of file channel.c.
References ast_cli_args::argc, ast_cli(), AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_cli_args::fd, FORMAT, chanlist::list, NULL, chanlist::tech, and ast_cli_entry::usage.
282 ast_cli(a->fd, FORMAT, "Type", "Description", "Devicestate", "Presencestate", "Indications", "Transfer");
283 ast_cli(a->fd, FORMAT, "-------------", "-------------", "-------------", "-------------", "-------------", "-------------");
struct chanlist::@369 list
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
#define FORMAT
Definition: cli.h:153
◆ indicate_connected_line()
|
static |
Definition at line 4446 of file channel.c.
References ast_channel_connected(), ast_channel_connected_indicated(), ast_channel_name(), ast_channel_set_connected_line(), ast_connected_line_build_data(), ast_connected_line_parse_data(), ast_debug, ast_party_connected_line_copy(), ast_party_connected_line_free(), ast_party_connected_line_set_init(), ast_party_connected_line::id, ast_party_id::name, NULL, ast_party_id::number, S_COR, ast_party_name::str, ast_party_number::str, ast_party_name::valid, and ast_party_number::valid.
Referenced by indicate_data_internal().
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
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_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
#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
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
const char * ast_channel_name(const 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.
Definition: channel.c:8793
struct ast_party_connected_line * ast_channel_connected_indicated(struct ast_channel *chan)
Definition: channel_internal_api.c:896
◆ indicate_data_internal()
|
static |
- Note
- If we compare the enumeration type, which does not have any negative constants, the compiler may optimize this code away. Therefore, we must perform an integer comparison here.
Definition at line 4515 of file channel.c.
References _XXX_AST_CONTROL_T38, ast_channel_hangupcause_hash_set(), ast_channel_hold_state_set(), ast_channel_name(), ast_channel_set_is_t38_active_nolock(), ast_channel_tech(), ast_channel_visible_indication_set(), ast_channel_zone(), AST_CONTROL_ANSWER, AST_CONTROL_AOC, AST_CONTROL_BUSY, AST_CONTROL_CC, AST_CONTROL_CONGESTION, AST_CONTROL_CONNECTED_LINE, AST_CONTROL_END_OF_Q, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_INCOMPLETE, AST_CONTROL_MASQUERADE_NOTIFY, AST_CONTROL_MCID, AST_CONTROL_OFFHOOK, AST_CONTROL_OPTION, AST_CONTROL_PROCEEDING, AST_CONTROL_PROGRESS, AST_CONTROL_PVT_CAUSE_CODE, AST_CONTROL_RADIO_KEY, AST_CONTROL_RADIO_UNKEY, AST_CONTROL_READ_ACTION, AST_CONTROL_RECORD_CANCEL, AST_CONTROL_RECORD_MUTE, AST_CONTROL_RECORD_STOP, AST_CONTROL_RECORD_SUSPEND, AST_CONTROL_REDIRECTING, AST_CONTROL_RING, 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_STREAM_TOPOLOGY_CHANGED, AST_CONTROL_STREAM_TOPOLOGY_REQUEST_CHANGE, AST_CONTROL_STREAM_TOPOLOGY_SOURCE_CHANGED, AST_CONTROL_T38_PARAMETERS, AST_CONTROL_TAKEOFFHOOK, AST_CONTROL_TRANSFER, AST_CONTROL_UNHOLD, AST_CONTROL_UPDATE_RTP_PEER, AST_CONTROL_VIDUPDATE, AST_CONTROL_WINK, ast_debug, ast_get_indication_tone(), ast_log, ast_playtones_start(), ast_playtones_stop(), AST_STATE_UP, AST_T38_NEGOTIATED, AST_T38_REFUSED, AST_T38_REQUEST_NEGOTIATE, AST_T38_REQUEST_TERMINATE, AST_T38_TERMINATED, ast_test_suite_event_notify, ast_tone_zone_sound_unref(), ast_tone_zone_sound::data, ast_channel_tech::indicate, indicate(), indicate_connected_line(), indicate_redirecting(), is_visible_indication(), LOG_WARNING, NULL, and ast_control_t38_parameters::request_response.
Referenced by ast_indicate_data(), and ast_write_stream().
4680 ast_debug(1, "Driver for channel '%s' does not support indication %u, emulating it\n", ast_channel_name(chan), condition);
4692 ast_log(LOG_WARNING, "Unable to handle indication %u for '%s'\n", condition, ast_channel_name(chan));
Definition: include/asterisk/frame.h:293
void ast_channel_visible_indication_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:481
Definition: include/asterisk/frame.h:286
static int attribute_const is_visible_indication(enum ast_control_frame_type condition)
Definition: channel.c:4327
Definition: include/asterisk/frame.h:281
Definition: include/asterisk/frame.h:279
struct ast_tone_zone * ast_channel_zone(const struct ast_channel *chan)
Definition: channel_internal_api.c:745
enum ast_control_t38 request_response
Definition: include/asterisk/frame.h:398
ast_control_frame_type
Internal control frame subtype field values.
Definition: include/asterisk/frame.h:277
Definition: include/asterisk/frame.h:282
Definition: channelstate.h:42
Definition: include/asterisk/frame.h:296
void ast_playtones_stop(struct ast_channel *chan)
Stop playing tones on a channel.
Definition: indications.c:393
Definition: include/asterisk/frame.h:287
Definition: include/asterisk/frame.h:306
Definition: include/asterisk/frame.h:284
Definition: include/asterisk/frame.h:302
Definition: include/asterisk/frame.h:375
static int indicate_connected_line(struct ast_channel *chan, const void *data, size_t datalen)
Definition: channel.c:4446
static struct ast_tone_zone_sound * ast_tone_zone_sound_unref(struct ast_tone_zone_sound *ts)
Release a reference to an ast_tone_zone_sound.
Definition: indications.h:227
Definition: include/asterisk/frame.h:278
struct ast_tone_zone_sound * ast_get_indication_tone(const struct ast_tone_zone *zone, const char *indication)
Locate a tone zone sound.
Definition: indications.c:455
Definition: include/asterisk/frame.h:308
Definition: include/asterisk/frame.h:288
Definition: include/asterisk/frame.h:305
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
Definition: include/asterisk/frame.h:298
Definition: include/asterisk/frame.h:373
Definition: include/asterisk/frame.h:294
const char * ast_channel_name(const struct ast_channel *chan)
Definition: include/asterisk/frame.h:374
Definition: include/asterisk/frame.h:280
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_hold_state_set(struct ast_channel *chan, int value)
Definition: channel_internal_api.c:489
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
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
static int indicate_redirecting(struct ast_channel *chan, const void *data, size_t datalen)
Definition: channel.c:4501
◆ indicate_redirecting()
|
static |
Definition at line 4501 of file channel.c.
References ast_channel_redirecting(), ast_channel_set_redirecting(), ast_party_redirecting_free(), ast_party_redirecting_set_init(), ast_redirecting_parse_data(), and NULL.
Referenced by indicate_data_internal().
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
Redirecting Line information. RDNIS (Redirecting Directory Number Information Service) Where a call d...
Definition: channel.h:523
struct ast_party_redirecting * ast_channel_redirecting(struct ast_channel *chan)
Definition: channel_internal_api.c:908
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.
Definition: channel.c:9215
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...
Definition: channel.c:2153
◆ is_visible_indication()
|
static |
Definition at line 4327 of file channel.c.
References _XXX_AST_CONTROL_T38, AST_CONTROL_ANSWER, AST_CONTROL_AOC, AST_CONTROL_BUSY, AST_CONTROL_CC, AST_CONTROL_CONGESTION, AST_CONTROL_CONNECTED_LINE, AST_CONTROL_END_OF_Q, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_INCOMPLETE, AST_CONTROL_MASQUERADE_NOTIFY, AST_CONTROL_MCID, AST_CONTROL_OFFHOOK, AST_CONTROL_OPTION, AST_CONTROL_PROCEEDING, AST_CONTROL_PROGRESS, AST_CONTROL_PVT_CAUSE_CODE, AST_CONTROL_RADIO_KEY, AST_CONTROL_RADIO_UNKEY, AST_CONTROL_READ_ACTION, AST_CONTROL_RECORD_CANCEL, AST_CONTROL_RECORD_MUTE, AST_CONTROL_RECORD_STOP, AST_CONTROL_RECORD_SUSPEND, AST_CONTROL_REDIRECTING, AST_CONTROL_RING, 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_STREAM_TOPOLOGY_CHANGED, AST_CONTROL_STREAM_TOPOLOGY_REQUEST_CHANGE, AST_CONTROL_STREAM_TOPOLOGY_SOURCE_CHANGED, AST_CONTROL_T38_PARAMETERS, AST_CONTROL_TAKEOFFHOOK, AST_CONTROL_TRANSFER, AST_CONTROL_UNHOLD, AST_CONTROL_UPDATE_RTP_PEER, AST_CONTROL_VIDUPDATE, and AST_CONTROL_WINK.
Referenced by indicate_data_internal().
Definition: include/asterisk/frame.h:293
Definition: include/asterisk/frame.h:286
Definition: include/asterisk/frame.h:281
Definition: include/asterisk/frame.h:279
Definition: include/asterisk/frame.h:282
Definition: include/asterisk/frame.h:296
Definition: include/asterisk/frame.h:287
Definition: include/asterisk/frame.h:306
Definition: include/asterisk/frame.h:284
Definition: include/asterisk/frame.h:302
Definition: include/asterisk/frame.h:278
Definition: include/asterisk/frame.h:308
Definition: include/asterisk/frame.h:288
Definition: include/asterisk/frame.h:305
Definition: include/asterisk/frame.h:291
Definition: include/asterisk/frame.h:298
Definition: include/asterisk/frame.h:294
Definition: include/asterisk/frame.h:280
◆ kill_exception()
|
static |
◆ kill_fixup()
|
static |
◆ kill_hangup()
|
static |
Definition at line 419 of file channel.c.
References ast_channel_tech_pvt_set(), and NULL.
void ast_channel_tech_pvt_set(struct ast_channel *chan, void *value)
Definition: channel_internal_api.c:569
◆ kill_read()
|
static |
◆ kill_write()
|
static |
◆ namedgroup_cmp_cb()
|
static |
Comparison function used for named group container.
Definition at line 7759 of file channel.c.
References CMP_MATCH, CMP_STOP, and namedgroup_member::name.
Referenced by ast_get_namedgroups().
Definition: astobj2.h:1032
Definition: astobj2.h:1031
◆ namedgroup_hash_cb()
|
static |
Hashing function used for named group container.
Definition at line 7768 of file channel.c.
References namedgroup_member::hash.
Referenced by ast_get_namedgroups().
Definition: app_queue.c:1592
◆ namedgroup_match()
|
static |
Definition at line 8182 of file channel.c.
References ao2_cleanup, ao2_find, CMP_MATCH, CMP_STOP, match(), and OBJ_POINTER.
Referenced by ast_namedgroups_intersect().
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
Definition: astobj2.h:1032
Definition: astobj2.h:1031
◆ party_id_build_data()
|
static |
Definition at line 8673 of file channel.c.
References ast_log, ast_party_id_presentation(), ast_party_id_ies::combined_presentation, LOG_WARNING, ast_party_id::name, ast_set_party_id::name, ast_party_id_ies::name, ast_party_id::number, ast_set_party_id::number, ast_party_id_ies::number, party_name_build_data(), party_number_build_data(), party_subaddress_build_data(), ast_party_id::subaddress, ast_set_party_id::subaddress, ast_party_id_ies::subaddress, ast_party_id::tag, and ast_party_id_ies::tag.
Referenced by ast_connected_line_build_data(), and ast_redirecting_build_data().
int ast_party_id_presentation(const struct ast_party_id *id)
Determine the overall presentation value for the given party.
Definition: channel.c:1821
static int party_number_build_data(unsigned char *data, size_t datalen, const struct ast_party_number *number, const char *label, const struct ast_party_number_ies *ies)
Definition: channel.c:8518
static int party_name_build_data(unsigned char *data, size_t datalen, const struct ast_party_name *name, const char *label, const struct ast_party_name_ies *ies)
Definition: channel.c:8444
static int party_subaddress_build_data(unsigned char *data, size_t datalen, const struct ast_party_subaddress *subaddress, const char *label, const struct ast_party_subaddress_ies *ies)
Definition: channel.c:8592
◆ party_name_build_data()
|
static |
Definition at line 8444 of file channel.c.
References ast_log, ast_party_name::char_set, ast_party_name_ies::char_set, LOG_WARNING, ast_party_name::presentation, ast_party_name_ies::presentation, ast_party_name::str, ast_party_name_ies::str, ast_party_name::valid, and ast_party_name_ies::valid.
Referenced by party_id_build_data().
◆ party_number_build_data()
|
static |
Definition at line 8518 of file channel.c.
References ast_log, LOG_WARNING, ast_party_number::plan, ast_party_number_ies::plan, ast_party_number::presentation, ast_party_number_ies::presentation, ast_party_number::str, ast_party_number_ies::str, ast_party_number::valid, and ast_party_number_ies::valid.
Referenced by party_id_build_data().
int presentation
Q.931 presentation-indicator and screening-indicator encoded fields.
Definition: channel.h:296
◆ party_subaddress_build_data()
|
static |
Definition at line 8592 of file channel.c.
References ast_log, LOG_WARNING, ast_party_subaddress::odd_even_indicator, ast_party_subaddress_ies::odd_even_indicator, ast_party_subaddress::str, ast_party_subaddress_ies::str, ast_party_subaddress::type, ast_party_subaddress_ies::type, ast_party_subaddress::valid, and ast_party_subaddress_ies::valid.
Referenced by party_id_build_data().
◆ plc_ds_destroy()
|
static |
Definition at line 5086 of file channel.c.
References ast_free, and plc_ds::samples_buf.
Definition: channel.c:5073
◆ prnt_channel_key()
|
static |
Definition at line 7912 of file channel.c.
References ast_channel_name().
Referenced by ast_channels_init().
const char * ast_channel_name(const struct ast_channel *chan)
◆ queue_dtmf_readq()
|
inlinestatic |
Definition at line 3470 of file channel.c.
References ast_channel_dtmff(), AST_FRAME_DTMF_END, ast_log, ast_queue_frame(), ast_frame::frametype, ast_frame_subclass::integer, ast_frame::len, LOG_WARNING, and ast_frame::subclass.
Referenced by __ast_read().
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:99
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
struct ast_frame * ast_channel_dtmff(struct ast_channel *chan)
Definition: channel_internal_api.c:880
◆ redirecting_reason_build_data()
|
static |
Definition at line 9330 of file channel.c.
References ast_log, ast_party_redirecting_reason::code, ast_party_redirecting_reason_ies::code, LOG_WARNING, ast_party_redirecting_reason::str, ast_party_redirecting_reason_ies::str, and value.
Referenced by ast_redirecting_build_data().
union ast_frame::@263 data
◆ request_channel()
|
static |
Definition at line 6309 of file channel.c.
References ao2_cleanup, ao2_ref, AST_CAUSE_BEARERCAPABILITY_NOTAVAIL, AST_CAUSE_NOSUCHDRIVER, AST_CAUSE_NOTDEFINED, ast_channel_callid(), ast_channel_callid_set(), ast_channel_lock_both, ast_channel_unlock, ast_format_cap_alloc, ast_format_cap_append, ast_format_cap_append_from_cap(), ast_format_cap_empty(), AST_FORMAT_CAP_FLAG_DEFAULT, ast_format_cap_get_names(), AST_FORMAT_CAP_NAMES_LEN, ast_format_cap_remove_by_type(), ast_hangup(), ast_log, AST_MEDIA_TYPE_AUDIO, AST_MEDIA_TYPE_UNKNOWN, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_str_alloca, ast_stream_topology_create_from_format_cap(), ast_stream_topology_free(), ast_stream_topology_get_formats(), ast_translator_best_choice(), c, chanlist::chan, chanlist::list, LOG_WARNING, NULL, RAII_VAR, set_security_requirements(), and chanlist::tech.
Referenced by ast_request(), and ast_request_with_stream_topology().
6351 c = chan->tech->requester_with_stream_topology(type, topology, assignedids, requestor, addr, cause);
6378 res = ast_translator_best_choice(tmp_cap, chan->tech->capabilities, &tmp_fmt, &best_audio_fmt);
6384 ast_log(LOG_WARNING, "No translator path exists for channel type %s (native %s) to %s\n", type,
struct ast_format_cap * ast_stream_topology_get_formats(struct ast_stream_topology *topology)
Create a format capabilities structure representing the topology.
Definition: stream.c:930
#define AST_RWLIST_UNLOCK(head)
Attempts to unlock a read/write based list.
Definition: linkedlists.h:150
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_translator_best_choice(struct ast_format_cap *dst_cap, struct ast_format_cap *src_cap, struct ast_format **dst_fmt_out, struct ast_format **src_fmt_out)
Chooses the best translation path.
Definition: translate.c:1385
static int set_security_requirements(const struct ast_channel *requestor, struct ast_channel *out)
Definition: channel.c:6269
#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: codec.h:31
#define ast_format_cap_append(cap, format, framing)
Definition: format_cap.h:103
Definition: format_cap.h:38
void ast_format_cap_remove_by_type(struct ast_format_cap *cap, enum ast_media_type type)
Remove all formats matching a specific format type.
Definition: format_cap.c:525
Definition: stream.c:123
The descriptor of a dynamic string XXX storage will be optimized later if needed We use the ts field ...
Definition: strings.h:584
Format capabilities structure, holds formats + preference order + etc.
Definition: format_cap.c:54
Definition: codec.h:32
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
void ast_channel_callid_set(struct ast_channel *chan, ast_callid value)
Definition: channel_internal_api.c:797
int ast_format_cap_empty(const struct ast_format_cap *cap)
Determine if a format cap has no formats in it.
Definition: format_cap.c:746
int ast_format_cap_append_from_cap(struct ast_format_cap *dst, const struct ast_format_cap *src, enum ast_media_type type)
Append the formats of provided type in src to dst.
Definition: format_cap.c:269
void ast_stream_topology_free(struct ast_stream_topology *topology)
Unreference and destroy a stream topology.
Definition: stream.c:743
#define AST_CAUSE_BEARERCAPABILITY_NOTAVAIL
Definition: causes.h:129
ast_callid ast_channel_callid(const struct ast_channel *chan)
Definition: channel_internal_api.c:793
◆ safe_sleep_conditional()
|
static |
Wait, look for hangups and condition arg.
Definition at line 1498 of file channel.c.
References ast_channel_generatordata(), ast_channel_lock, ast_channel_start_silence_generator(), ast_channel_stop_silence_generator(), ast_channel_unlock, ast_frfree, ast_frisolate, ast_is_deferrable_frame(), AST_LIST_HEAD_INIT_NOLOCK, AST_LIST_HEAD_NOLOCK(), AST_LIST_INSERT_HEAD, AST_LIST_REMOVE_HEAD, ast_opt_transmit_silence, ast_queue_frame_head(), ast_read(), ast_remaining_ms(), ast_tvnow(), ast_waitfor(), cond, and NULL.
Referenced by ast_safe_sleep(), ast_safe_sleep_conditional(), and ast_safe_sleep_without_silence().
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
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
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
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
#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: res_rtp_asterisk.c:590
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
#define AST_LIST_INSERT_HEAD(head, elm, field)
Inserts a list entry at the head of a list.
Definition: linkedlists.h:710
int ast_is_deferrable_frame(const struct ast_frame *frame)
Should we keep this frame for later?
Definition: channel.c:1467
#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
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
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
◆ send_dtmf_begin_event()
|
static |
Definition at line 3378 of file channel.c.
References ast_channel_dtmf_begin_type(), ast_channel_publish_blob(), ast_json_pack(), ast_json_unref(), digit, dtmf_direction_to_string(), NULL, and RAII_VAR.
Referenced by __ast_read(), and ast_write_stream().
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
#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 stasis_message_type * ast_channel_dtmf_begin_type(void)
Message type for when DTMF begins on a channel.
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
static const char * dtmf_direction_to_string(enum DtmfDirection direction)
Definition: channel.c:3366
◆ send_dtmf_end_event()
|
static |
Definition at line 3394 of file channel.c.
References ast_channel_dtmf_end_type(), ast_channel_publish_blob(), ast_json_pack(), ast_json_unref(), digit, dtmf_direction_to_string(), NULL, and RAII_VAR.
Referenced by __ast_read(), and ast_write_stream().
struct stasis_message_type * ast_channel_dtmf_end_type(void)
Message type for when DTMF ends on a channel.
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
AST_JSON_INT_T ast_json_int_t
Primarily used to cast when packing to an "I" type.
Definition: json.h:87
#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
static const char * dtmf_direction_to_string(enum DtmfDirection direction)
Definition: channel.c:3366
◆ send_flash_event()
|
static |
Definition at line 3411 of file channel.c.
References ast_channel_flash_type(), ast_channel_publish_blob(), and NULL.
Referenced by __ast_read().
struct stasis_message_type * ast_channel_flash_type(void)
Message type for when a hook flash occurs on a channel.
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
◆ set_channel_answer_time()
|
static |
Definition at line 2637 of file channel.c.
References ast_channel_answertime(), ast_channel_answertime_set(), ast_tvnow(), and ast_tvzero().
Referenced by __ast_read(), and ast_raw_answer_with_stream_topology().
struct timeval ast_channel_answertime(struct ast_channel *chan)
Definition: channel_internal_api.c:986
void ast_channel_answertime_set(struct ast_channel *chan, struct timeval *value)
Definition: channel_internal_api.c:991
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:150
◆ set_format()
|
static |
Definition at line 5680 of file channel.c.
References ao2_cleanup, ast_assert, ast_channel_generatordata(), ast_channel_lock, ast_channel_name(), ast_channel_nativeformats(), ast_channel_nativeformats_set(), ast_channel_setoption(), ast_channel_unlock, ast_debug, ast_format_cap_alloc, ast_format_cap_append, ast_format_cap_empty(), AST_FORMAT_CAP_FLAG_DEFAULT, ast_format_cap_get_best_by_type(), ast_format_cap_get_names(), AST_FORMAT_CAP_NAMES_LEN, ast_format_cmp(), AST_FORMAT_CMP_NOT_EQUAL, ast_format_get_name(), ast_log, AST_MEDIA_TYPE_AUDIO, ast_str_alloca, ast_str_buffer(), ast_translator_best_choice(), ast_translator_build_path(), ast_translator_free_path(), set_format_access::direction, format, generator_write_format_change(), set_format_access::get_format, set_format_access::get_rawformat, set_format_access::get_trans, ast_trans_pvt::interleaved_stereo, LOG_ERROR, LOG_WARNING, NULL, RAII_VAR, set_format_access::set_format, set_format_access_read, set_format_access_write, set_format_access::set_rawformat, set_format_access::set_trans, and set_format_access::setoption.
Referenced by ast_set_read_format(), ast_set_read_format_from_cap(), ast_set_write_format(), ast_set_write_format_from_cap(), and ast_set_write_format_interleaved_stereo().
5785 ((ast_format_cmp(rawformat, format) != AST_FORMAT_CMP_NOT_EQUAL) || access->get_trans(chan))) {
5786 /* the channel is already in these formats, so nothing to do, unless the interleaved format is not set correctly */
void(* set_trans)(struct ast_channel *chan, struct ast_trans_pvt *value)
Definition: channel.c:5650
static const struct set_format_access set_format_access_write
Definition: channel.c:5669
struct ast_format *(* get_rawformat)(struct ast_channel *chan)
Definition: channel.c:5653
void * ast_channel_generatordata(const struct ast_channel *chan)
Definition: channel_internal_api.c:549
char * ast_str_buffer(const struct ast_str *buf)
Returns the string buffer within the ast_str buf.
Definition: strings.h:714
void(* set_format)(struct ast_channel *chan, struct ast_format *format)
Definition: channel.c:5652
struct ast_format *(* get_format)(struct ast_channel *chan)
Definition: channel.c:5651
struct ast_format * ast_format_cap_get_best_by_type(const struct ast_format_cap *cap, enum ast_media_type type)
Get the most preferred format for a particular media type.
Definition: format_cap.c:417
Definition: channel.c:5647
const char * ast_format_get_name(const struct ast_format *format)
Get the name associated with a format.
Definition: format.c:334
int ast_translator_best_choice(struct ast_format_cap *dst_cap, struct ast_format_cap *src_cap, struct ast_format **dst_fmt_out, struct ast_format **src_fmt_out)
Chooses the best translation path.
Definition: translate.c:1385
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
Definition: format.h:38
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
static const struct set_format_access set_format_access_read
Definition: channel.c:5658
#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_nativeformats_set(struct ast_channel *chan, struct ast_format_cap *value)
Definition: channel_internal_api.c:677
#define ast_format_cap_append(cap, format, framing)
Definition: format_cap.h:103
Definition: format_cap.h:38
The descriptor of a dynamic string XXX storage will be optimized later if needed We use the ts field ...
Definition: strings.h:584
Format capabilities structure, holds formats + preference order + etc.
Definition: format_cap.c:54
Default structure for translators, with the basic fields and buffers, all allocated as part of the sa...
Definition: translate.h:213
Definition: codec.h:32
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
int ast_channel_setoption(struct ast_channel *chan, int option, void *data, int datalen, int block)
Sets an option on a channel.
Definition: channel.c:7522
static void generator_write_format_change(struct ast_channel *chan)
Definition: channel.c:2913
struct ast_format_cap * ast_channel_nativeformats(const struct ast_channel *chan)
Definition: channel_internal_api.c:637
const char * ast_channel_name(const struct ast_channel *chan)
void(* set_rawformat)(struct ast_channel *chan, struct ast_format *format)
Definition: channel.c:5654
int ast_format_cap_empty(const struct ast_format_cap *cap)
Determine if a format cap has no formats in it.
Definition: format_cap.c:746
struct ast_trans_pvt *(* get_trans)(const struct ast_channel *chan)
Definition: channel.c:5649
void ast_translator_free_path(struct ast_trans_pvt *tr)
Frees a translator path Frees the given translator path structure.
Definition: translate.c:475
◆ set_security_requirements()
|
static |
Definition at line 6269 of file channel.c.
References ast_channel_datastore_find(), ast_channel_lock, ast_channel_setoption(), ast_channel_unlock, AST_OPTION_SECURE_MEDIA, AST_OPTION_SECURE_SIGNALING, ast_datastore::data, ast_secure_call_store::media, NULL, secure_call_info, and ast_secure_call_store::signaling.
Referenced by request_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
#define AST_OPTION_SECURE_SIGNALING
Definition: include/asterisk/frame.h:514
int ast_channel_setoption(struct ast_channel *chan, int option, void *data, int datalen, int block)
Sets an option on a channel.
Definition: channel.c:7522
Definition: global_datastores.h:31
◆ should_skip_dtmf()
|
inlinestatic |
Determine whether or not we should ignore DTMF in the readq.
Definition at line 3489 of file channel.c.
References ast_channel_dtmf_tv(), ast_channel_flags(), AST_FLAG_DEFER_DTMF, AST_FLAG_EMULATE_DTMF, AST_MIN_DTMF_GAP, ast_test_flag, ast_tvdiff_ms(), ast_tvnow(), and ast_tvzero().
Referenced by __ast_read().
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
Definition: channel.h:982
struct timeval * ast_channel_dtmf_tv(struct ast_channel *chan)
Definition: channel_internal_api.c:924
Definition: channel.h:1005
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ should_trigger_dtmf_emulating()
|
inlinestatic |
Determine whether or not we have to trigger dtmf emulating using 50 fps timer events especially when no voice frames are received during dtmf processing (direct media or muted sender case using SIP INFO)
Definition at line 2864 of file channel.c.
References ast_channel_dtmf_tv(), ast_channel_flags(), AST_FLAG_DEFER_DTMF, AST_FLAG_EMULATE_DTMF, AST_MIN_DTMF_GAP, ast_test_flag, ast_tvdiff_ms(), ast_tvnow(), and ast_tvzero().
Referenced by __ast_read(), and ast_deactivate_generator().
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
Definition: channel.h:982
struct timeval * ast_channel_dtmf_tv(struct ast_channel *chan)
Definition: channel_internal_api.c:924
Definition: channel.h:1005
struct ast_flags * ast_channel_flags(struct ast_channel *chan)
Definition: channel_internal_api.c:1260
◆ silence_generator_alloc()
|
static |
◆ silence_generator_generate()
|
static |
Definition at line 8237 of file channel.c.
References ast_format_slin, AST_FRAME_VOICE, ast_write(), buf, ast_frame_subclass::format, ast_frame::frametype, ast_frame::samples, and ast_frame::subclass.
Definition: include/asterisk/frame.h:101
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
Data structure associated with a single frame of data.
Definition: include/asterisk/frame.h:165
struct ast_format * ast_format_slin
Built-in cached signed linear 8kHz format.
Definition: format_cache.c:41
◆ silence_generator_release()
|
static |
◆ suppress_datastore_destroy_cb()
|
static |
◆ suppress_framehook_destroy_cb()
|
static |
Definition at line 10915 of file channel.c.
References ao2_cleanup.
Referenced by ast_channel_suppress().
union ast_frame::@263 data
◆ suppress_framehook_event_cb()
|
static |
Definition at line 10933 of file channel.c.
References AST_FRAME_VOICE, AST_FRAMEHOOK_EVENT_READ, AST_FRAMEHOOK_EVENT_WRITE, ast_frfree, AST_MUTE_DIRECTION_READ, AST_MUTE_DIRECTION_WRITE, ast_null_frame, suppress_data::direction, ast_frame::frametype, suppress_data::frametype, and NULL.
Referenced by ast_channel_suppress().
10948 } else if (event == AST_FRAMEHOOK_EVENT_WRITE && (suppress->direction & AST_MUTE_DIRECTION_WRITE)) {
Definition: include/asterisk/frame.h:101
Definition: astman.c:222
Definition: channel.c:10920
Definition: framehook.h:153
Definition: framehook.h:152
◆ suppress_framehook_fixup_cb()
|
static |
Definition at line 10926 of file channel.c.
References suppress_data::framehook_id.
Referenced by ast_channel_suppress().
Definition: channel.c:10920
◆ suppress_get_datastore_information()
|
static |
Definition at line 10968 of file channel.c.
References AST_FRAME_VOICE, NULL, and suppress_datastore_voice.
Referenced by ast_channel_suppress(), and ast_channel_unsuppress().
Definition: include/asterisk/frame.h:101
static const struct ast_datastore_info suppress_datastore_voice
Definition: channel.c:10910
◆ tech_write()
|
static |
Definition at line 5177 of file channel.c.
References ast_channel_tech(), ast_stream_get_position(), ast_channel_tech::write, write_stream(), and ast_channel_tech::write_stream.
Referenced by ast_write_stream().
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 write_stream(struct ogg_vorbis_desc *s, FILE *f)
Write out any pending encoded data.
Definition: format_ogg_vorbis.c:203
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
int ast_stream_get_position(const struct ast_stream *stream)
Get the position of the stream in the topology.
Definition: stream.c:500
const struct ast_channel_tech * ast_channel_tech(const struct ast_channel *chan)
Definition: channel_internal_api.c:769
◆ tonepair_alloc()
|
static |
Definition at line 7598 of file channel.c.
References ao2_bump, ast_calloc, ast_channel_flags(), ast_channel_name(), ast_channel_writeformat(), AST_FLAG_WRITE_INT, ast_format_slin, ast_log, ast_set_flag, ast_set_write_format(), cos, tonepair_def::duration, tonepair_state::duration, tonepair_state::fac1, tonepair_state::fac2, tonepair_def::freq1, tonepair_def::freq2, LOG_WARNING, M_PI, tonepair_state::modulate, NULL, tonepair_state::origwfmt, tonepair_release(), tonepair_state::v1_1, tonepair_state::v2_1, tonepair_state::v2_2, tonepair_state::v3_1, tonepair_state::v3_2, and tonepair_def::vol.
7609 ast_log(LOG_WARNING, "Unable to set '%s' to signed linear format (write)\n", ast_channel_name(chan));
Definition: channel.c:7562
Definition: channel.c:7569
Definition: channel.h:984
static void tonepair_release(struct ast_channel *chan, void *params)
Definition: channel.c:7587
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
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
◆ tonepair_generator()
|
static |
Definition at line 7629 of file channel.c.
References ast_format_slin, AST_FRAME_VOICE, AST_FRIENDLY_OFFSET, ast_log, ast_write(), ast_frame::data, tonepair_state::data, ast_frame::datalen, tonepair_state::duration, tonepair_state::f, tonepair_state::fac1, tonepair_state::fac2, ast_frame_subclass::format, ast_frame::frametype, len(), LOG_WARNING, tonepair_state::modulate, ast_frame::offset, tonepair_state::pos, ast_frame::ptr, ast_frame::samples, ast_frame::subclass, tonepair_state::v1_1, tonepair_state::v1_2, tonepair_state::v2_1, tonepair_state::v2_2, tonepair_state::v3_1, and tonepair_state::v3_2.
Definition: include/asterisk/frame.h:101
#define AST_FRIENDLY_OFFSET
Offset into a frame's data buffer.
Definition: include/asterisk/frame.h:229
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
Definition: func_strings.c:1344
Definition: channel.c:7569
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
union ast_frame::@263 data
struct ast_format * ast_format_slin
Built-in cached signed linear 8kHz format.
Definition: format_cache.c:41
◆ tonepair_release()
|
static |
Definition at line 7587 of file channel.c.
References ao2_cleanup, ast_free, ast_set_write_format(), and tonepair_state::origwfmt.
Referenced by tonepair_alloc().
Definition: channel.c:7569
int ast_set_write_format(struct ast_channel *chan, struct ast_format *format)
Sets write format on channel chan.
Definition: channel.c:5890
◆ varshead_dtor()
|
static |
Destructor for lists of variables.
- Parameters
-
obj AO2 object.
Definition at line 8003 of file channel.c.
References AST_RWLIST_REMOVE_HEAD, ast_var_delete(), ast_var_t::entries, and var.
Referenced by ast_channel_get_vars(), and channel_get_external_vars().
Variable Documentation
◆ ami_vars
|
static |
Definition at line 7933 of file channel.c.
Referenced by ast_channel_get_manager_vars(), ast_channel_has_manager_vars(), ast_channel_set_manager_vars(), ast_channels_init(), and channels_shutdown().
◆ ari_vars
|
static |
Definition at line 7934 of file channel.c.
Referenced by ast_channel_get_ari_vars(), ast_channel_has_ari_vars(), ast_channel_set_ari_vars(), ast_channels_init(), and channels_shutdown().
◆ ast_kill_tech
| const struct ast_channel_tech ast_kill_tech |
◆ ast_moh_cleanup_ptr
|
static |
Definition at line 7848 of file channel.c.
Referenced by ast_install_music_functions(), ast_moh_cleanup(), and ast_uninstall_music_functions().
◆ ast_moh_start_ptr
|
static |
Definition at line 7846 of file channel.c.
Referenced by ast_install_music_functions(), ast_moh_start(), and ast_uninstall_music_functions().
◆ ast_moh_stop_ptr
|
static |
Definition at line 7847 of file channel.c.
Referenced by ast_install_music_functions(), ast_moh_stop(), and ast_uninstall_music_functions().
◆ backends
|
static |
◆ bridge_features_info
|
static |
Initial value:
◆ causes
|
static |
Definition at line 136 of file channel.c.
Referenced by dump_cause().
◆ cc_channel_datastore_info
|
static |
Initial value:
= {
.type = "Call Completion",
.duplicate = channel_cc_params_copy,
.destroy = channel_cc_params_destroy,
}
static void channel_cc_params_destroy(void *data)
Definition: channel.c:10640
◆ chancount
|
static |
Definition at line 93 of file channel.c.
Referenced by __ast_channel_alloc_ap(), __manager_event_sessions_va(), ast_channel_destructor(), ast_undestroyed_channels(), and generic_fax_exec().
◆ channel_move_lock
|
static |
Mutex that prevents multiple ast_channel_move() operations from occurring simultaneously. This is necessary since the involved channels have to be locked and unlocked throughout the move operation.
The most important data being protected are the masq and masqr data on channels. We don't want them getting criss-crossed due to multiple moves mucking with them.
Definition at line 10865 of file channel.c.
Referenced by ast_channel_move().
◆ channels
|
static |
◆ cli_channel
|
static |
Initial value:
= {
{ .handler = handle_cli_core_show_channeltypes , .summary = "List available channel types" ,},
{ .handler = handle_cli_core_show_channeltype , .summary = "Give more details on that channel type" ,}
}
static char * handle_cli_core_show_channeltype(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
Show details about a channel driver - CLI command.
Definition: channel.c:326
static char * handle_cli_core_show_channeltypes(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
Show channel types - CLI command.
Definition: channel.c:261
◆ 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().
◆ null_tech
|
static |
◆ plc_ds_info
|
static |
Initial value:
◆ set_format_access_read
|
static |
Definition at line 5658 of file channel.c.
Referenced by set_format().
◆ set_format_access_write
|
static |
Definition at line 5669 of file channel.c.
Referenced by set_format().
◆ silence_generator
|
static |
Initial value:
= {
.alloc = silence_generator_alloc,
.release = silence_generator_release,
.generate = silence_generator_generate,
}
static void silence_generator_release(struct ast_channel *chan, void *data)
Definition: channel.c:8232
static int silence_generator_generate(struct ast_channel *chan, void *data, int len, int samples)
Definition: channel.c:8237
static void * silence_generator_alloc(struct ast_channel *chan, void *data)
Definition: channel.c:8226
◆ state2str_threadbuf
|
static |
Definition at line 97 of file channel.c.
Referenced by ast_state2str().
◆ suppress_datastore_voice
|
static |
Initial value:
= {
.type = "suppressvoice",
.destroy = suppress_datastore_destroy_cb
}
static void suppress_datastore_destroy_cb(void *data)
Definition: channel.c:10905
Definition at line 10910 of file channel.c.
Referenced by suppress_get_datastore_information().
◆ surrogate_tech
|
static |
Initial value:
= {
.type = "Surrogate",
.description = "Surrogate channel used to pull channel from an application",
.properties = AST_CHAN_TP_INTERNAL,
}
Channels with this particular technology are an implementation detail of Asterisk and should generall...
Definition: channel.h:972
Channel technology used to extract a channel from a running application. The channel created with this technology will be immediately hung up - most external applications won't ever want to see this.
◆ tonepair
|
static |
Initial value:
= {
.alloc = tonepair_alloc,
.release = tonepair_release,
.generate = tonepair_generator,
}
static void * tonepair_alloc(struct ast_channel *chan, void *params)
Definition: channel.c:7598
static int tonepair_generator(struct ast_channel *chan, void *data, int len, int samples)
Definition: channel.c:7629
static void tonepair_release(struct ast_channel *chan, void *params)
Definition: channel.c:7587
