pbx.h File Reference

Core PBX routines and definitions. More...

#include "asterisk/channel.h"
#include "asterisk/sched.h"
#include "asterisk/devicestate.h"
#include "asterisk/presencestate.h"
#include "asterisk/chanvars.h"
#include "asterisk/hashtab.h"
#include "asterisk/stringfields.h"
#include "asterisk/xmldoc.h"
#include "asterisk/format.h"

Include dependency graph for pbx.h:

Go to the source code of this file.

Data Structures
struct	ast_custom_function
	Data structure associated with a custom dialplan function. More...
struct	ast_device_state_info
struct	ast_pbx
struct	ast_pbx_args
	Options for ast_pbx_run() More...
struct	ast_state_cb_info
struct	ast_switch
struct	ast_timing
struct	pbx_find_info

Macros
#define	ast_custom_function_register(acf)   __ast_custom_function_register(acf, AST_MODULE_SELF)
	Register a custom function. More...
#define	ast_custom_function_register_escalating(acf, escalation)   __ast_custom_function_register_escalating(acf, escalation, AST_MODULE_SELF)
	Register a custom function which requires escalated privileges. More...
#define	AST_MAX_APP   32
#define	AST_PBX_GOTO_FAILED   -3
#define	AST_PBX_KEEP   0
#define	AST_PBX_MAX_STACK   512
#define	AST_PBX_REPLACE   1
#define	PRIORITY_HINT   -1
#define	STATUS_NO_CONTEXT   1
#define	STATUS_NO_EXTENSION   2
#define	STATUS_NO_LABEL   4
#define	STATUS_NO_PRIORITY   3
#define	STATUS_SUCCESS   5
#define	AST_PBX_ERROR   1
#define	AST_PBX_HANGUP   -1
	Special return values from applications to the PBX. More...
#define	AST_PBX_INCOMPLETE   12
#define	AST_PBX_OK   0

Typedefs
typedef void(*	ast_state_cb_destroy_type) (int id, void *data)
	Typedef for devicestate and hint callback removal indication callback. More...
typedef int(*	ast_state_cb_type) (const char *context, const char *exten, struct ast_state_cb_info *info, void *data)
	Typedef for devicestate and hint callbacks. More...
typedef int()	ast_switch_f(struct ast_channel *chan, const char *context, const char *exten, int priority, const char *callerid, const char *data)
	All switch functions have the same interface, so define a type for them. More...

Enumerations
enum	ast_custom_function_escalation { AST_CFE_NONE , AST_CFE_READ , AST_CFE_WRITE , AST_CFE_BOTH }
	Description of the ways in which a function may escalate privileges. More...
enum	ast_ext_matchcid_types { AST_EXT_MATCHCID_OFF = 0 , AST_EXT_MATCHCID_ON = 1 , AST_EXT_MATCHCID_ANY = 2 }
	extension matchcid types More...
enum	ast_extension_states {   AST_EXTENSION_REMOVED = -2 , AST_EXTENSION_DEACTIVATED = -1 , AST_EXTENSION_NOT_INUSE = 0 , AST_EXTENSION_INUSE = 1 << 0 ,   AST_EXTENSION_BUSY = 1 << 1 , AST_EXTENSION_UNAVAILABLE = 1 << 2 , AST_EXTENSION_RINGING = 1 << 3 , AST_EXTENSION_ONHOLD = 1 << 4 ,   AST_EXTENSION_REMOVED = -2 , AST_EXTENSION_DEACTIVATED = -1 , AST_EXTENSION_NOT_INUSE = 0 , AST_EXTENSION_INUSE = 1 << 0 ,   AST_EXTENSION_BUSY = 1 << 1 , AST_EXTENSION_UNAVAILABLE = 1 << 2 , AST_EXTENSION_RINGING = 1 << 3 , AST_EXTENSION_ONHOLD = 1 << 4 }
	Extension states. More...
enum	ast_pbx_outgoing_sync { AST_OUTGOING_NO_WAIT = 0 , AST_OUTGOING_WAIT = 1 , AST_OUTGOING_WAIT_COMPLETE = 2 }
enum	ast_pbx_result { AST_PBX_SUCCESS = 0 , AST_PBX_FAILED = -1 , AST_PBX_CALL_LIMIT = -2 }
	The result codes when starting the PBX on a channel with ast_pbx_start. More...
enum	ast_state_cb_update_reason { AST_HINT_UPDATE_DEVICE = 1 , AST_HINT_UPDATE_PRESENCE = 2 }
enum	ext_match_t {   E_MATCHMORE = 0x00 , E_CANMATCH = 0x01 , E_MATCH = 0x02 , E_MATCH_MASK = 0x03 ,   E_SPAWN = 0x12 , E_FINDLABEL = 0x22 , E_MATCHMORE = 0x00 , E_CANMATCH = 0x01 ,   E_MATCH = 0x02 , E_MATCH_MASK = 0x03 , E_SPAWN = 0x12 , E_FINDLABEL = 0x22 }

Functions
int	__ast_custom_function_register (struct ast_custom_function *acf, struct ast_module *mod)
	Register a custom function. More...
int	__ast_custom_function_register_escalating (struct ast_custom_function *acf, enum ast_custom_function_escalation escalation, struct ast_module *mod)
	Register a custom function which requires escalated privileges. More...
int	ast_active_calls (void)
	Retrieve the number of active calls. More...
int	ast_add_extension (const char *context, int replace, const char *extension, int priority, const char *label, const char *callerid, const char *application, void *data, void(*datad)(void *), const char *registrar)
	Add and extension to an extension context. More...
int	ast_add_extension2 (struct ast_context *con, int replace, const char *extension, int priority, const char *label, const char *callerid, const char *application, void *data, void(*datad)(void *), const char *registrar, const char *registrar_file, int registrar_line)
	Add an extension to an extension context, this time with an ast_context *. More...
int	ast_add_extension2_nolock (struct ast_context *con, int replace, const char *extension, int priority, const char *label, const char *callerid, const char *application, void *data, void(*datad)(void *), const char *registrar, const char *registrar_file, int registrar_line)
	Same as ast_add_extension2, but assumes you have already locked context. More...
int	ast_async_goto (struct ast_channel *chan, const char *context, const char *exten, int priority)
	Set the channel to next execute the specified dialplan location. More...
int	ast_async_goto_by_name (const char *chan, const char *context, const char *exten, int priority)
	Set the channel to next execute the specified dialplan location. More...
int	ast_async_goto_if_exists (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_async_parseable_goto (struct ast_channel *chan, const char *goto_string)
int	ast_build_timing (struct ast_timing *i, const char *info_in)
	Construct a timing bitmap, for use in time-based conditionals. More...
int	ast_canmatch_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Looks for a valid matching extension. More...
int	ast_check_timing (const struct ast_timing *i)
	Evaluate a pre-constructed bitmap as to whether the current time falls within the range specified. More...
int	ast_check_timing2 (const struct ast_timing *i, const struct timeval tv)
	Evaluate a pre-constructed bitmap as to whether a particular time falls within the range specified. More...
char *	ast_complete_applications (const char *line, const char *word, int state)
	Command completion for the list of installed applications. More...
int	ast_context_add_ignorepat (const char *context, const char *ignorepat, const char *registrar)
	Add an ignorepat. More...
int	ast_context_add_ignorepat2 (struct ast_context *con, const char *ignorepat, const char *registrar)
int	ast_context_add_include (const char *context, const char *include, const char *registrar)
	Add a context include. More...
int	ast_context_add_include2 (struct ast_context *con, const char *value, const char *registrar)
	Add a context include. More...
int	ast_context_add_switch (const char *context, const char *sw, const char *data, int eval, const char *registrar)
	Add a switch. More...
int	ast_context_add_switch2 (struct ast_context *con, const char *sw, const char *data, int eval, const char *registrar)
	Adds a switch (first param is a ast_context) More...
void	ast_context_destroy (struct ast_context *con, const char *registrar)
	Destroy a context (matches the specified context or ANY context if NULL) More...
int	ast_context_destroy_by_name (const char *context, const char *registrar)
	Destroy a context by name. More...
struct ast_context *	ast_context_find (const char *name)
	Find a context. More...
struct ast_context *	ast_context_find_or_create (struct ast_context **extcontexts, struct ast_hashtab *exttable, const char *name, const char *registrar)
	Register a new context or find an existing one. More...
int	ast_context_remove_ignorepat (const char *context, const char *ignorepat, const char *registrar)
	Remove an ignorepat. More...
int	ast_context_remove_ignorepat2 (struct ast_context *con, const char *ignorepat, const char *registrar)
int	ast_context_remove_include (const char *context, const char *include, const char *registrar)
	Remove a context include. More...
int	ast_context_remove_include2 (struct ast_context *con, const char *include, const char *registrar)
	Removes an include by an ast_context structure. More...
int	ast_context_remove_switch (const char *context, const char *sw, const char *data, const char *registrar)
	Remove a switch. More...
int	ast_context_remove_switch2 (struct ast_context *con, const char *sw, const char *data, const char *registrar)
	This function locks given context, removes switch, unlock context and return. More...
void	ast_context_set_autohints (struct ast_context *con, int enabled)
	Enable or disable autohints support on a context. More...
int	ast_context_verify_includes (struct ast_context *con)
	Verifies includes in an ast_contect structure. More...
struct ast_custom_function *	ast_custom_function_find (const char *name)
int	ast_custom_function_unregister (struct ast_custom_function *acf)
	Unregister a custom function. More...
int	ast_destroy_timing (struct ast_timing *i)
	Deallocates memory structures associated with a timing bitmap. More...
enum ast_extension_states	ast_devstate_to_extenstate (enum ast_device_state devstate)
	Map devstate to an extension state. More...
int	ast_exists_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Determine whether an extension exists. More...
int	ast_explicit_goto (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_extension_close (const char *pattern, const char *data, int needmore)
int	ast_extension_cmp (const char *a, const char *b)
	Determine if one extension should match before another. More...
int	ast_extension_match (const char *pattern, const char *extension)
	Determine if a given extension matches a given pattern (in NXX format) More...
int	ast_extension_patmatch (const char *pattern, const char *data)
int	ast_extension_state (struct ast_channel *c, const char *context, const char *exten)
	Uses hint and devicestate callback to get the state of an extension. More...
const char *	ast_extension_state2str (int extension_state)
	Return string representation of the state of an extension. More...
int	ast_extension_state_add (const char *context, const char *exten, ast_state_cb_type change_cb, void *data)
	Add watcher for extension states. More...
int	ast_extension_state_add_destroy (const char *context, const char *exten, ast_state_cb_type change_cb, ast_state_cb_destroy_type destroy_cb, void *data)
	Add watcher for extension states with destructor. More...
int	ast_extension_state_add_destroy_extended (const char *context, const char *exten, ast_state_cb_type change_cb, ast_state_cb_destroy_type destroy_cb, void *data)
	Add watcher for extended extension states with destructor. More...
int	ast_extension_state_add_extended (const char *context, const char *exten, ast_state_cb_type change_cb, void *data)
	Add watcher for extended extension states. More...
int	ast_extension_state_del (int id, ast_state_cb_type change_cb)
	Deletes a state change watcher by ID. More...
int	ast_extension_state_extended (struct ast_channel *c, const char *context, const char *exten, struct ao2_container **device_state_info)
	Uses hint and devicestate callback to get the extended state of an extension. More...
int	ast_findlabel_extension (struct ast_channel *c, const char *context, const char *exten, const char *label, const char *callerid)
	Find the priority of an extension that has the specified label. More...
int	ast_findlabel_extension2 (struct ast_channel *c, struct ast_context *con, const char *exten, const char *label, const char *callerid)
	Find the priority of an extension that has the specified label. More...
int	ast_func_read (struct ast_channel *chan, const char *function, char *workspace, size_t len)
	executes a read operation on a function More...
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 More...
int	ast_func_write (struct ast_channel *chan, const char *function, const char *value)
	executes a write operation on a function More...
const char *	ast_get_extension_registrar_file (struct ast_exten *e)
	Get name of configuration file used by registrar to register this extension. More...
int	ast_get_extension_registrar_line (struct ast_exten *e)
	Get line number of configuration file used by registrar to register this extension. More...
int	ast_get_hint (char *hint, int hintsize, char *name, int namesize, struct ast_channel *c, const char *context, const char *exten)
	If an extension hint exists, return non-zero. More...
int	ast_goto_if_exists (struct ast_channel *chan, const char *context, const char *exten, int priority)
int	ast_hint_presence_state (struct ast_channel *c, const char *context, const char *exten, char **subtype, char **message)
	Uses hint and presence state callback to get the presence state of an extension. More...
int	ast_ignore_pattern (const char *context, const char *pattern)
	Checks to see if a number should be ignored. More...
int	ast_matchmore_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid)
	Looks to see if adding anything to this extension might match something. (exists ^ canmatch) More...
void	ast_merge_contexts_and_delete (struct ast_context **extcontexts, struct ast_hashtab *exttable, const char *registrar)
	Merge the temporary contexts into a global contexts list and delete from the global list the ones that are being added. More...
int	ast_parseable_goto (struct ast_channel *chan, const char *goto_string)
int	ast_pbx_exec_application (struct ast_channel *chan, const char *app_name, const char *app_args)
	Execute an application. More...
void	ast_pbx_h_exten_run (struct ast_channel *chan, const char *context)
	Run the h exten from the given context. More...
void	ast_pbx_hangup_handler_destroy (struct ast_channel *chan)
	Destroy the hangup handler container on a channel. More...
void	ast_pbx_hangup_handler_init (struct ast_channel *chan)
	Init the hangup handler container on a channel. More...
int	ast_pbx_hangup_handler_pop (struct ast_channel *chan)
	Pop the top of the channel hangup handler stack. More...
void	ast_pbx_hangup_handler_push (struct ast_channel *chan, const char *handler)
	Push the given hangup handler onto the channel hangup handler stack. More...
int	ast_pbx_hangup_handler_run (struct ast_channel *chan)
	Run all hangup handlers on the channel. More...
int	ast_pbx_outgoing_app (const char *type, struct ast_format_cap *cap, const char *addr, int timeout, const char *app, const char *appdata, int *reason, int synchronous, const char *cid_num, const char *cid_name, struct ast_variable *vars, const char *account, struct ast_channel **locked_channel, const struct ast_assigned_ids *assignedids)
	Synchronously or asynchronously make an outbound call and execute an application on the channel. More...
int	ast_pbx_outgoing_app_predial (const char *type, struct ast_format_cap *cap, const char *addr, int timeout, const char *app, const char *appdata, int *reason, int synchronous, const char *cid_num, const char *cid_name, struct ast_variable *vars, const char *account, struct ast_channel **locked_channel, const struct ast_assigned_ids *assignedids, const char *predial_callee)
int	ast_pbx_outgoing_exten (const char *type, struct ast_format_cap *cap, const char *addr, int timeout, const char *context, const char *exten, int priority, int *reason, int synchronous, const char *cid_num, const char *cid_name, struct ast_variable *vars, const char *account, struct ast_channel **locked_channel, int early_media, const struct ast_assigned_ids *assignedids)
	Synchronously or asynchronously make an outbound call and send it to a particular extension. More...
int	ast_pbx_outgoing_exten_predial (const char *type, struct ast_format_cap *cap, const char *addr, int timeout, const char *context, const char *exten, int priority, int *reason, int synchronous, const char *cid_num, const char *cid_name, struct ast_variable *vars, const char *account, struct ast_channel **locked_channel, int early_media, const struct ast_assigned_ids *assignedids, const char *predial_callee)
enum ast_pbx_result	ast_pbx_run (struct ast_channel *c)
	Execute the PBX in the current thread. More...
enum ast_pbx_result	ast_pbx_run_args (struct ast_channel *c, struct ast_pbx_args *args)
	Execute the PBX in the current thread. More...
enum ast_pbx_result	ast_pbx_start (struct ast_channel *c)
	Create a new thread and start the PBX. More...
int	ast_processed_calls (void)
	Retrieve the total number of calls processed through the PBX since last restart. More...
int	ast_rdlock_context (struct ast_context *con)
	Read locks a given context. More...
int	ast_rdlock_contexts (void)
	Read locks the context list. More...
int	ast_register_switch (struct ast_switch *sw)
	Register an alternative dialplan switch. More...
int	ast_spawn_extension (struct ast_channel *c, const char *context, const char *exten, int priority, const char *callerid, int *found, int combined_find_spawn)
	Launch a new extension (i.e. new stack) More...
int	ast_str_get_hint (struct ast_str **hint, ssize_t hintsize, struct ast_str **name, ssize_t namesize, struct ast_channel *c, const char *context, const char *exten)
	If an extension hint exists, return non-zero. More...
int	ast_thread_inhibit_escalations (void)
	Inhibit (in the current thread) the execution of dialplan functions which cause privilege escalations. If pbx_live_dangerously() has been called, this function has no effect. More...
int	ast_thread_inhibit_escalations_swap (int inhibit)
	Swap the current thread escalation inhibit setting. More...
int	ast_unlock_context (struct ast_context *con)
int	ast_unlock_contexts (void)
	Unlocks contexts. More...
void	ast_unregister_switch (struct ast_switch *sw)
	Unregister an alternative switch. More...
int	ast_wrlock_context (struct ast_context *con)
	Write locks a given context. More...
int	ast_wrlock_contexts (void)
	Write locks the context list. More...
void	pbx_builtin_clear_globals (void)
const char *	pbx_builtin_getvar_helper (struct ast_channel *chan, const char *name)
	Return a pointer to the value of the corresponding channel variable. More...
void	pbx_builtin_pushvar_helper (struct ast_channel *chan, const char *name, const char *value)
	Add a variable to the channel variable stack, without removing any previously set value. More...
int	pbx_builtin_raise_exception (struct ast_channel *chan, const char *data)
int	pbx_builtin_serialize_variables (struct ast_channel *chan, struct ast_str **buf)
	Create a human-readable string, specifying all variables and their corresponding values. More...
int	pbx_builtin_setvar (struct ast_channel *chan, const char *data)
	Parse and set a single channel variable, where the name and value are separated with an '=' character. More...
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. More...
int	pbx_builtin_setvar_multiple (struct ast_channel *chan, const char *data)
	Parse and set multiple channel variables, where the pairs are separated by the ',' character, and name and value are separated with an '=' character. More...
int	pbx_checkcondition (const char *condition)
	Evaluate a condition. More...
int	pbx_exec (struct ast_channel *c, struct ast_app *app, const char *data)
	Execute an application. More...
struct ast_exten *	pbx_find_extension (struct ast_channel *chan, struct ast_context *bypass, struct pbx_find_info *q, const char *context, const char *exten, int priority, const char *label, const char *callerid, enum ext_match_t action)
struct ast_app *	pbx_findapp (const char *app)
	Look up an application. More...
void	pbx_live_dangerously (int new_live_dangerously)
	Enable/disable the execution of 'dangerous' functions from external protocols (AMI, etc.). More...
int	pbx_parse_location (struct ast_channel *chan, char **context, char **exten, char **pri, int *ipri, int *mode, char *rest)
	Parses a dialplan location into context, extension, priority. More...
void	pbx_retrieve_variable (struct ast_channel *c, const char *var, char **ret, char *workspace, int workspacelen, struct varshead *headp)
	Retrieve the value of a builtin variable or variable from the channel variable stack. More...
int	pbx_set_autofallthrough (int newval)
int	pbx_set_extenpatternmatchnew (int newval)
void	pbx_set_overrideswitch (const char *newval)
int	ast_context_remove_extension (const char *context, const char *extension, int priority, const char *registrar)
	Simply remove extension from context. More...
int	ast_context_remove_extension2 (struct ast_context *con, const char *extension, int priority, const char *registrar, int already_locked)
	This functionc locks given context, search for the right extension and fires out all peer in this extensions with given priority. If priority is set to 0, all peers are removed. After that, unlock context and return. More...
int	ast_context_remove_extension_callerid (const char *context, const char *extension, int priority, const char *callerid, int matchcid, const char *registrar)
int	ast_context_remove_extension_callerid2 (struct ast_context *con, const char *extension, int priority, const char *callerid, int matchcid, const char *registrar, int already_locked)
Functions for returning values from structures
const char *	ast_get_context_name (struct ast_context *con)
struct ast_context *	ast_get_extension_context (struct ast_exten *exten)
const char *	ast_get_extension_name (struct ast_exten *exten)
const char *	ast_get_ignorepat_name (const struct ast_ignorepat *ip)
const char *	ast_get_include_name (const struct ast_include *include)
const char *	ast_get_switch_data (const struct ast_sw *sw)
int	ast_get_switch_eval (const struct ast_sw *sw)
const char *	ast_get_switch_name (const struct ast_sw *sw)
Other Extension stuff
const char *	ast_get_extension_app (struct ast_exten *e)
void *	ast_get_extension_app_data (struct ast_exten *e)
const char *	ast_get_extension_cidmatch (struct ast_exten *e)
int	ast_get_extension_data (char *buf, int bufsize, struct ast_channel *c, const char *context, const char *exten, int priority)
	Fill a string buffer with the data at a dialplan extension. More...
const char *	ast_get_extension_label (struct ast_exten *e)
int	ast_get_extension_matchcid (struct ast_exten *e)
int	ast_get_extension_priority (struct ast_exten *exten)
Registrar info functions ...
const char *	ast_get_context_registrar (struct ast_context *c)
const char *	ast_get_extension_registrar (struct ast_exten *e)
const char *	ast_get_ignorepat_registrar (const struct ast_ignorepat *ip)
const char *	ast_get_include_registrar (const struct ast_include *i)
const char *	ast_get_switch_registrar (const struct ast_sw *sw)
Walking functions ...
struct ast_exten *	ast_walk_context_extensions (struct ast_context *con, struct ast_exten *priority)
const struct ast_ignorepat *	ast_walk_context_ignorepats (const struct ast_context *con, const struct ast_ignorepat *ip)
const struct ast_include *	ast_walk_context_includes (const struct ast_context *con, const struct ast_include *inc)
const struct ast_sw *	ast_walk_context_switches (const struct ast_context *con, const struct ast_sw *sw)
struct ast_context *	ast_walk_contexts (struct ast_context *con)
struct ast_exten *	ast_walk_extension_priorities (struct ast_exten *exten, struct ast_exten *priority)
Iterator functions ...
int	ast_context_ignorepats_count (const struct ast_context *con)
const struct ast_ignorepat *	ast_context_ignorepats_get (const struct ast_context *con, int idx)
int	ast_context_includes_count (const struct ast_context *con)
const struct ast_include *	ast_context_includes_get (const struct ast_context *con, int idx)
int	ast_context_switches_count (const struct ast_context *con)
const struct ast_sw *	ast_context_switches_get (const struct ast_context *con, int idx)
Substitution routines, using static string buffers
void	pbx_substitute_variables_helper (struct ast_channel *c, const char *cp1, char *cp2, int count)
void	pbx_substitute_variables_helper_full (struct ast_channel *c, struct varshead *headp, const char *cp1, char *cp2, int cp2_size, size_t *used)
void	pbx_substitute_variables_helper_full_location (struct ast_channel *c, struct varshead *headp, const char *cp1, char *cp2, int cp2_size, size_t *used, const char *context, const char *exten, int pri)
	Substitutes variables, similar to pbx_substitute_variables_helper_full, but allows passing the context, extension, and priority in. More...
void	pbx_substitute_variables_varshead (struct varshead *headp, const char *cp1, char *cp2, int count)
Substitution routines, using dynamic string buffers
const char *	ast_str_retrieve_variable (struct ast_str **buf, ssize_t maxlen, struct ast_channel *chan, struct varshead *headp, const char *var)
void	ast_str_substitute_variables (struct ast_str **buf, ssize_t maxlen, struct ast_channel *chan, const char *templ)
void	ast_str_substitute_variables_full (struct ast_str **buf, ssize_t maxlen, struct ast_channel *c, struct varshead *headp, const char *templ, size_t *used)
void	ast_str_substitute_variables_full2 (struct ast_str **buf, ssize_t maxlen, struct ast_channel *c, struct varshead *headp, const char *templ, size_t *used, int use_both)
	Perform variable/function/expression substitution on an ast_str. More...
void	ast_str_substitute_variables_varshead (struct ast_str **buf, ssize_t maxlen, struct varshead *headp, const char *templ)
int	ast_hashtab_compare_contexts (const void *ah_a, const void *ah_b)
	hashtable functions for contexts More...
unsigned int	ast_hashtab_hash_contexts (const void *obj)

Detailed Description

Core PBX routines and definitions.

Definition in file pbx.h.

Macro Definition Documentation

ast_custom_function_register

#define ast_custom_function_register

(

acf

)

__ast_custom_function_register(acf, AST_MODULE_SELF)

Register a custom function.

Definition at line 1562 of file pbx.h.

ast_custom_function_register_escalating

#define ast_custom_function_register_escalating	(		acf,
			escalation
	)		__ast_custom_function_register_escalating(acf, escalation, AST_MODULE_SELF)

Register a custom function which requires escalated privileges.

Examples would be SHELL() (for which a read needs permission to execute arbitrary code) or FILE() (for which write needs permission to change files on the filesystem).

Definition at line 1571 of file pbx.h.

AST_MAX_APP

#define AST_MAX_APP   32

Max length of an application

Definition at line 40 of file pbx.h.

AST_PBX_ERROR

#define AST_PBX_ERROR   1

Jump to the 'e' exten

Definition at line 50 of file pbx.h.

AST_PBX_GOTO_FAILED

#define AST_PBX_GOTO_FAILED   -3

Definition at line 42 of file pbx.h.

AST_PBX_HANGUP

#define AST_PBX_HANGUP   -1

Special return values from applications to the PBX.

Jump to the 'h' exten

Definition at line 48 of file pbx.h.

AST_PBX_INCOMPLETE

#define AST_PBX_INCOMPLETE   12

Return to PBX matching, allowing more digits for the extension

Definition at line 51 of file pbx.h.

AST_PBX_KEEP

#define AST_PBX_KEEP   0

Definition at line 43 of file pbx.h.

AST_PBX_MAX_STACK

#define AST_PBX_MAX_STACK   512

Definition at line 1667 of file pbx.h.

AST_PBX_OK

#define AST_PBX_OK   0

No errors

Definition at line 49 of file pbx.h.

AST_PBX_REPLACE

#define AST_PBX_REPLACE   1

Definition at line 44 of file pbx.h.

PRIORITY_HINT

#define PRIORITY_HINT   -1

Special Priority for a hint

Definition at line 54 of file pbx.h.

STATUS_NO_CONTEXT

#define STATUS_NO_CONTEXT   1

Definition at line 1658 of file pbx.h.

STATUS_NO_EXTENSION

#define STATUS_NO_EXTENSION   2

Definition at line 1659 of file pbx.h.

STATUS_NO_LABEL

#define STATUS_NO_LABEL   4

Definition at line 1661 of file pbx.h.

STATUS_NO_PRIORITY

#define STATUS_NO_PRIORITY   3

Definition at line 1660 of file pbx.h.

STATUS_SUCCESS

#define STATUS_SUCCESS   5

Definition at line 1662 of file pbx.h.

Typedef Documentation

ast_state_cb_destroy_type

typedef void(* ast_state_cb_destroy_type) (int id, void *data)

Typedef for devicestate and hint callback removal indication callback.

Definition at line 115 of file pbx.h.

ast_state_cb_type

typedef int(* ast_state_cb_type) (const char *context, const char *exten, struct ast_state_cb_info *info, void *data)

Typedef for devicestate and hint callbacks.

Definition at line 112 of file pbx.h.

ast_switch_f

typedef int() ast_switch_f(struct ast_channel *chan, const char *context, const char *exten, int priority, const char *callerid, const char *data)

All switch functions have the same interface, so define a type for them.

Data structure associated with an Asterisk switch

Definition at line 157 of file pbx.h.

Enumeration Type Documentation

ast_custom_function_escalation

enum ast_custom_function_escalation

Description of the ways in which a function may escalate privileges.

Enumerator
AST_CFE_NONE
AST_CFE_READ
AST_CFE_WRITE
AST_CFE_BOTH

Definition at line 1552 of file pbx.h.

                                    {
    AST_CFE_NONE,
    AST_CFE_READ,
    AST_CFE_WRITE,
    AST_CFE_BOTH,
};

ast_ext_matchcid_types

enum ast_ext_matchcid_types

extension matchcid types

Note

matchcid in ast_exten retains 0/1, this adds 3rd state for functions to specify all

See also

ast_context_remove_extension_callerid

Enumerator
AST_EXT_MATCHCID_OFF	Match only extensions with matchcid=0
AST_EXT_MATCHCID_ON	Match only extensions with matchcid=1 AND cidmatch matches
AST_EXT_MATCHCID_ANY	Match both - used only in functions manipulating ast_exten's

Definition at line 77 of file pbx.h.

                            {
    AST_EXT_MATCHCID_OFF = 0,   /*!< Match only extensions with matchcid=0 */
    AST_EXT_MATCHCID_ON = 1,    /*!< Match only extensions with matchcid=1 AND cidmatch matches */
    AST_EXT_MATCHCID_ANY = 2,   /*!< Match both - used only in functions manipulating ast_exten's */
};

ast_extension_states

enum ast_extension_states

Extension states.

Note

States can be combined Extension and device states in Asterisk

Enumerator
AST_EXTENSION_REMOVED	Extension removed
AST_EXTENSION_DEACTIVATED	Extension hint removed
AST_EXTENSION_NOT_INUSE	No device INUSE or BUSY
AST_EXTENSION_INUSE	One or more devices INUSE
AST_EXTENSION_BUSY	All devices BUSY
AST_EXTENSION_UNAVAILABLE	All devices UNAVAILABLE/UNREGISTERED
AST_EXTENSION_RINGING	All devices RINGING
AST_EXTENSION_ONHOLD	All devices ONHOLD
AST_EXTENSION_REMOVED	Extension removed
AST_EXTENSION_DEACTIVATED	Extension hint removed
AST_EXTENSION_NOT_INUSE	No device INUSE or BUSY
AST_EXTENSION_INUSE	One or more devices INUSE
AST_EXTENSION_BUSY	All devices BUSY
AST_EXTENSION_UNAVAILABLE	All devices UNAVAILABLE/UNREGISTERED
AST_EXTENSION_RINGING	All devices RINGING
AST_EXTENSION_ONHOLD	All devices ONHOLD

Definition at line 61 of file pbx.h.

                          {
    AST_EXTENSION_REMOVED = -2, /*!< Extension removed */
    AST_EXTENSION_DEACTIVATED = -1, /*!< Extension hint removed */
    AST_EXTENSION_NOT_INUSE = 0,    /*!< No device INUSE or BUSY  */
    AST_EXTENSION_INUSE = 1 << 0,   /*!< One or more devices INUSE */
    AST_EXTENSION_BUSY = 1 << 1,    /*!< All devices BUSY */
    AST_EXTENSION_UNAVAILABLE = 1 << 2, /*!< All devices UNAVAILABLE/UNREGISTERED */
    AST_EXTENSION_RINGING = 1 << 3, /*!< All devices RINGING */
    AST_EXTENSION_ONHOLD = 1 << 4,  /*!< All devices ONHOLD */
};

ast_pbx_outgoing_sync

enum ast_pbx_outgoing_sync

Enumerator
AST_OUTGOING_NO_WAIT	Don't wait for originated call to answer
AST_OUTGOING_WAIT	Wait for originated call to answer
AST_OUTGOING_WAIT_COMPLETE	Wait for originated call to answer and hangup

Definition at line 1142 of file pbx.h.

                           {
    AST_OUTGOING_NO_WAIT = 0,       /*!< Don't wait for originated call to answer */
    AST_OUTGOING_WAIT = 1,          /*!< Wait for originated call to answer */
    AST_OUTGOING_WAIT_COMPLETE = 2, /*!< Wait for originated call to answer and hangup */
};

ast_pbx_result

enum ast_pbx_result

The result codes when starting the PBX on a channel with ast_pbx_start.

Note

AST_PBX_CALL_LIMIT refers to the maxcalls call limit in asterisk.conf

See also

ast_pbx_start

Enumerator
AST_PBX_SUCCESS
AST_PBX_FAILED
AST_PBX_CALL_LIMIT

Definition at line 371 of file pbx.h.

                    {
    AST_PBX_SUCCESS = 0,
    AST_PBX_FAILED = -1,
    AST_PBX_CALL_LIMIT = -2,
};

ast_state_cb_update_reason

enum ast_state_cb_update_reason

Enumerator
AST_HINT_UPDATE_DEVICE	The extension state update is a result of a device state changing on the extension.
AST_HINT_UPDATE_PRESENCE	The extension state update is a result of presence state changing on the extension.

Definition at line 89 of file pbx.h.

                                {
    /*! The extension state update is a result of a device state changing on the extension. */
    AST_HINT_UPDATE_DEVICE = 1,
    /*! The extension state update is a result of presence state changing on the extension. */
    AST_HINT_UPDATE_PRESENCE = 2,
};

ext_match_t

enum ext_match_t

When looking up extensions, we can have different requests identified by the 'action' argument, as follows.

Note

that the coding is such that the low 4 bits are the third argument to extension_match_core.

Enumerator
E_MATCHMORE
E_CANMATCH
E_MATCH
E_MATCH_MASK
E_SPAWN
E_FINDLABEL
E_MATCHMORE
E_CANMATCH
E_MATCH
E_MATCH_MASK
E_SPAWN
E_FINDLABEL

Definition at line 1649 of file pbx.h.

                 {
    E_MATCHMORE =   0x00,   /* extension can match but only with more 'digits' */
    E_CANMATCH =    0x01,   /* extension can match with or without more 'digits' */
    E_MATCH =   0x02,   /* extension is an exact match */
    E_MATCH_MASK =  0x03,   /* mask for the argument to extension_match_core() */
    E_SPAWN =   0x12,   /* want to spawn an extension. Requires exact match */
    E_FINDLABEL =   0x22    /* returns the priority for a given label. Requires exact match */
};

Function Documentation

__ast_custom_function_register()

int __ast_custom_function_register	(	struct ast_custom_function *	acf,
		struct ast_module *	mod
	)

Register a custom function.

Definition at line 372 of file pbx_functions.c.

{
    struct ast_custom_function *cur;
 
    if (!acf) {
        return -1;
    }
 
    acf->mod = mod;
#ifdef AST_XML_DOCS
    acf->docsrc = AST_STATIC_DOC;
#endif
 
    if (acf_retrieve_docs(acf)) {
        return -1;
    }
 
    AST_RWLIST_WRLOCK(&acf_root);
 
    cur = ast_custom_function_find_nolock(acf->name);
    if (cur) {
        ast_log(LOG_ERROR, "Function %s already registered.\n", acf->name);
        AST_RWLIST_UNLOCK(&acf_root);
        return -1;
    }
 
    /* Store in alphabetical order */
    AST_RWLIST_TRAVERSE_SAFE_BEGIN(&acf_root, cur, acflist) {
        if (strcmp(acf->name, cur->name) < 0) {
            AST_RWLIST_INSERT_BEFORE_CURRENT(acf, acflist);
            break;
        }
    }
    AST_RWLIST_TRAVERSE_SAFE_END;
    if (!cur) {
        AST_RWLIST_INSERT_TAIL(&acf_root, acf, acflist);
    }
 
    AST_RWLIST_UNLOCK(&acf_root);
 
    ast_verb(5, "Registered custom function '" COLORIZE_FMT "'\n", COLORIZE(COLOR_BRCYAN, 0, acf->name));
 
    return 0;
}

References acf_retrieve_docs(), ast_custom_function_find_nolock(), ast_log, AST_RWLIST_INSERT_BEFORE_CURRENT, AST_RWLIST_INSERT_TAIL, AST_RWLIST_TRAVERSE_SAFE_BEGIN, AST_RWLIST_TRAVERSE_SAFE_END, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, AST_STATIC_DOC, ast_verb, COLOR_BRCYAN, COLORIZE, COLORIZE_FMT, ast_custom_function::docsrc, LOG_ERROR, ast_custom_function::mod, and ast_custom_function::name.

Referenced by __ast_custom_function_register_escalating(), __init_manager(), ast_msg_init(), load_features_config(), and load_pbx().

__ast_custom_function_register_escalating()

int __ast_custom_function_register_escalating	(	struct ast_custom_function *	acf,
		enum ast_custom_function_escalation	escalation,
		struct ast_module *	mod
	)

Register a custom function which requires escalated privileges.

Examples would be SHELL() (for which a read needs permission to execute arbitrary code) or FILE() (for which write needs permission to change files on the filesystem).

Definition at line 417 of file pbx_functions.c.

{
    int res;
 
    res = __ast_custom_function_register(acf, mod);
    if (res != 0) {
        return -1;
    }
 
    switch (escalation) {
    case AST_CFE_NONE:
        break;
    case AST_CFE_READ:
        acf->read_escalates = 1;
        break;
    case AST_CFE_WRITE:
        acf->write_escalates = 1;
        break;
    case AST_CFE_BOTH:
        acf->read_escalates = 1;
        acf->write_escalates = 1;
        break;
    }
 
    return 0;
}

References __ast_custom_function_register(), AST_CFE_BOTH, AST_CFE_NONE, AST_CFE_READ, AST_CFE_WRITE, ast_custom_function::mod, ast_custom_function::read_escalates, and ast_custom_function::write_escalates.

ast_active_calls()

int ast_active_calls

(

void

)

Retrieve the number of active calls.

Definition at line 4781 of file pbx.c.

{
    return countcalls;
}

References countcalls.

Referenced by ast_var_Config(), get_current_call_count(), handle_chanlist(), handle_showcalls(), and sysinfo_helper().

ast_add_extension()

int ast_add_extension	(	const char *	context,
		int	replace,
		const char *	extension,
		int	priority,
		const char *	label,
		const char *	callerid,
		const char *	application,
		void *	data,
		void(*)(void *)	datad,
		const char *	registrar
	)

Add and extension to an extension context.

Parameters

context	context to add the extension to
replace
extension	extension to add
priority	priority level of extension addition
label	extension label
callerid	pattern to match CallerID, or NULL to match any CallerID
application	application to run on the extension with that priority level
data	data to pass to the application
datad	a pointer to a function that will deallocate data when needed or NULL if data does not need to be freed.
registrar	who registered the extension

Note

On any failure, the function pointed to by datap will be called and passed the data pointer.

Return values

0	success
-1	failure

Definition at line 6949 of file pbx.c.

{
    int ret = -1;
    struct ast_context *c;
 
    c = find_context_locked(context);
    if (c) {
        ret = ast_add_extension2(c, replace, extension, priority, label, callerid,
            application, data, datad, registrar, NULL, 0);
        ast_unlock_contexts();
    }
 
    return ret;
}

References ast_add_extension2(), ast_unlock_contexts(), c, voicemailpwcheck::context, ast_context::data, find_context_locked(), NULL, priority, registrar, and replace().

Referenced by add_to_regcontext(), app_create(), ast_hint_presence_state(), ast_sip_persistent_endpoint_update_state(), AST_TEST_DEFINE(), create_test_dialplan(), device_state_cb(), extension_state_add_destroy(), handle_cli_dialplan_add_extension(), internal_extension_state_extended(), join_conference_bridge(), load_module(), register_extension(), register_peer_exten(), session_register_apps(), sla_build_station(), and sla_build_trunk().

ast_add_extension2()

int ast_add_extension2	(	struct ast_context *	con,
		int	replace,
		const char *	extension,
		int	priority,
		const char *	label,
		const char *	callerid,
		const char *	application,
		void *	data,
		void(*)(void *)	datad,
		const char *	registrar,
		const char *	registrar_file,
		int	registrar_line
	)

Add an extension to an extension context, this time with an ast_context *.

Parameters

con	context to add the extension to
replace
extension	extension to add
priority	priority level of extension addition
label	extension label
callerid	pattern to match CallerID, or NULL to match any CallerID
application	application to run on the extension with that priority level
data	data to pass to the application
datad	a pointer to a function that will deallocate data when needed or NULL if data does not need to be freed.
registrar	who registered the extension
registrar_file	optional configuration file that defines this extension
registrar_line	optional line number of configuration file that defines extension

Note

On any failure, the function pointed to by datap will be called and passed the data pointer.

Return values

0	success
-1	failure

Add an extension to an extension context, this time with an ast_context *.

We sort extensions in order of matching preference, so that we can stop the search as soon as we find a suitable match. This ordering also takes care of wildcards such as '.' (meaning "one or more of any character") and '!' (which is 'earlymatch', meaning "zero or more of any character" but also impacts the return value from CANMATCH and EARLYMATCH.

The extension match rules defined in the devmeeting 2006.05.05 are quite simple: WE SELECT THE LONGEST MATCH. In detail, "longest" means the number of matched characters in the extension. In case of ties (e.g. _XXX and 333) in the length of a pattern, we give priority to entries with the smallest cardinality (e.g, [5-9] comes before [2-8] before the former has only 5 elements, while the latter has 7, etc. In case of same cardinality, the first element in the range counts. If we still have a tie, any final '!' will make this as a possibly less specific pattern.

EBUSY - can't lock EEXIST - extension with the same priority exist and no replace is set

Definition at line 7282 of file pbx.c.

{
    return ast_add_extension2_lockopt(con, replace, extension, priority, label, callerid,
        application, data, datad, registrar, registrar_file, registrar_line, 1);
}

References ast_add_extension2_lockopt(), priority, registrar, and replace().

Referenced by add_extensions(), ast_add_extension(), context_merge(), lua_register_hints(), manager_dialplan_extension_add(), and pbx_load_config().

ast_add_extension2_nolock()

int ast_add_extension2_nolock	(	struct ast_context *	con,
		int	replace,
		const char *	extension,
		int	priority,
		const char *	label,
		const char *	callerid,
		const char *	application,
		void *	data,
		void(*)(void *)	datad,
		const char *	registrar,
		const char *	registrar_file,
		int	registrar_line
	)

Same as ast_add_extension2, but assumes you have already locked context.

Since

12.0.0

Note

con must be write locked prior to calling. For details about the arguments, check ast_add_extension()

Definition at line 7291 of file pbx.c.

{
    return ast_add_extension2_lockopt(con, replace, extension, priority, label, callerid,
        application, data, datad, registrar, registrar_file, registrar_line, 0);
}

References ast_add_extension2_lockopt(), priority, registrar, and replace().

Referenced by add_extension(), parking_add_extension(), and parking_duration_callback().

ast_async_goto()

int ast_async_goto	(	struct ast_channel *	chan,
		const char *	context,
		const char *	exten,
		int	priority
	)

Set the channel to next execute the specified dialplan location.

See also

ast_async_parseable_goto, ast_async_goto_if_exists

Note

If the AST_SOFTHANGUP_ASYNCGOTO flag is set, it can prevent the dialplan location from being overwritten by ast_explicit_goto.

Do NOT hold any channel locks when calling this function.

Definition at line 6994 of file pbx.c.

{
    struct ast_channel *newchan;
 
    ast_channel_lock(chan);
    /* Channels in a bridge or running a PBX can be sent directly to the specified destination */
    if (ast_channel_is_bridged(chan) || ast_channel_pbx(chan)) {
        if (ast_test_flag(ast_channel_flags(chan), AST_FLAG_IN_AUTOLOOP)) {
            priority += 1;
        }
        ast_explicit_goto(chan, context, exten, priority);
        ast_softhangup_nolock(chan, AST_SOFTHANGUP_ASYNCGOTO);
        ast_channel_unlock(chan);
        return 0;
    }
    ast_channel_unlock(chan);
 
    /* Otherwise, we need to gain control of the channel first */
    newchan = ast_channel_yank(chan);
    if (!newchan) {
        ast_log(LOG_WARNING, "Unable to gain control of channel %s\n", ast_channel_name(chan));
        return -1;
    }
    ast_explicit_goto(newchan, context, exten, priority);
    if (ast_pbx_start(newchan)) {
        ast_hangup(newchan);
        ast_log(LOG_WARNING, "Unable to start PBX on %s\n", ast_channel_name(newchan));
        return -1;
    }
 
    return 0;
}

References ast_channel_flags(), ast_channel_is_bridged(), ast_channel_lock, ast_channel_name(), ast_channel_pbx(), ast_channel_unlock, ast_channel_yank(), ast_explicit_goto(), AST_FLAG_IN_AUTOLOOP, ast_hangup(), ast_log, ast_pbx_start(), AST_SOFTHANGUP_ASYNCGOTO, ast_softhangup_nolock(), ast_test_flag, voicemailpwcheck::context, ast_channel::exten, LOG_WARNING, and priority.

Referenced by __ast_goto_if_exists(), ast_async_goto_by_name(), async_goto_with_discard_bridge_after(), bridge_channel_blind_transfer(), chan_pjsip_cng_tone_detected(), comeback_goto(), dahdi_handle_dtmf(), fax_detect_framehook(), my_handle_dtmf(), onModeChanged(), ooh323_rtp_read(), and pbx_parseable_goto().

ast_async_goto_by_name()

int ast_async_goto_by_name	(	const char *	chan,
		const char *	context,
		const char *	exten,
		int	priority
	)

Set the channel to next execute the specified dialplan location.

Definition at line 7027 of file pbx.c.

{
    struct ast_channel *chan;
    int res = -1;
 
    if ((chan = ast_channel_get_by_name(channame))) {
        res = ast_async_goto(chan, context, exten, priority);
        chan = ast_channel_unref(chan);
    }
 
    return res;
}

References ast_async_goto(), ast_channel_get_by_name(), ast_channel_unref, voicemailpwcheck::context, ast_channel::exten, and priority.

ast_async_goto_if_exists()

int ast_async_goto_if_exists	(	struct ast_channel *	chan,
		const char *	context,
		const char *	exten,
		int	priority
	)

Note

This function will handle locking the channel as needed.

Definition at line 8811 of file pbx.c.

{
    return __ast_goto_if_exists(chan, context, exten, priority, 1);
}

References __ast_goto_if_exists(), voicemailpwcheck::context, ast_channel::exten, and priority.

ast_async_parseable_goto()

int ast_async_parseable_goto	(	struct ast_channel *	chan,
		const char *	goto_string
	)

Note

This function will handle locking the channel as needed.

Definition at line 8896 of file pbx.c.

{
    return pbx_parseable_goto(chan, goto_string, 1);
}

References pbx_parseable_goto().

Referenced by asyncgoto_exec(), detect_callback(), handle_redirect(), and parking_duration_callback().

ast_build_timing()

int ast_build_timing	(	struct ast_timing *	i,
		const char *	info_in
	)

Construct a timing bitmap, for use in time-based conditionals.

Parameters

i	Pointer to an ast_timing structure.
info_in	Standard string containing a timerange, weekday range, monthday range, and month range, as well as an optional timezone.

Return values

1	on success.
0	on failure.

Definition at line 3804 of file extconf.c.

{
    char *info;
    int j, num_fields, last_sep = -1;
 
    i->timezone = NULL;
 
    /* Check for empty just in case */
    if (ast_strlen_zero(info_in)) {
        return 0;
    }
 
    /* make a copy just in case we were passed a static string */
    info = ast_strdupa(info_in);
 
    /* count the number of fields in the timespec */
    for (j = 0, num_fields = 1; info[j] != '\0'; j++) {
        if (info[j] == '|' || info[j] == ',') {
            last_sep = j;
            num_fields++;
        }
    }
 
    /* save the timezone, if it is specified */
    if (num_fields == 5) {
        i->timezone = ast_strdup(info + last_sep + 1);
    }
 
    /* Assume everything except time */
    i->monthmask = 0xfff;   /* 12 bits */
    i->daymask = 0x7fffffffU; /* 31 bits */
    i->dowmask = 0x7f; /* 7 bits */
    /* on each call, use strsep() to move info to the next argument */
    get_timerange(i, strsep(&info, "|,"));
    if (info)
        i->dowmask = get_range(strsep(&info, "|,"), 7, days, "day of week");
    if (info)
        i->daymask = get_range(strsep(&info, "|,"), 31, NULL, "day");
    if (info)
        i->monthmask = get_range(strsep(&info, "|,"), 12, months, "month");
    return 1;
}

References ast_strdup, ast_strdupa, ast_strlen_zero(), ast_timing::daymask, days, ast_timing::dowmask, get_range(), get_timerange(), sip_to_pjsip::info(), ast_timing::monthmask, months, NULL, strsep(), and ast_timing::timezone.

Referenced by ast_context_add_include2(), iftime(), include_alloc(), pbx_builtin_execiftime(), and pbx_builtin_gotoiftime().

ast_canmatch_extension()

int ast_canmatch_extension	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten,
		int	priority,
		const char *	callerid
	)

Looks for a valid matching extension.

Parameters

c	not really important
context	context to search within
exten	extension to check
priority	priority of extension path
callerid	callerid of extension being searched for

Note

It is possible for autoservice to be started and stopped on c during this function call, it is important that c is not locked prior to calling this. Otherwise a deadlock may occur

Returns

If "exten" could be a valid extension in this context with or without some more digits, return non-zero. Basically, when this returns 0, no matter what you add to exten, it's not going to be a valid extension anymore

Definition at line 4211 of file pbx.c.

{
    return pbx_extension_helper(c, NULL, context, exten, priority, NULL, callerid, E_CANMATCH, 0, 0);
}

References c, voicemailpwcheck::context, E_CANMATCH, ast_exten::exten, NULL, pbx_extension_helper(), and priority.

Referenced by __analog_ss_thread(), analog_ss_thread(), background_detect_exec(), dp_lookup(), dundi_lookup_local(), get_destination(), leave_voicemail(), loopback_canmatch(), pbx_builtin_background(), test_exten(), and valid_exit().

ast_check_timing()

int ast_check_timing

(

const struct ast_timing *

i

)

Evaluate a pre-constructed bitmap as to whether the current time falls within the range specified.

Parameters

i	Pointer to an ast_timing structure.

Return values

1	if the time matches.
0	if the current time falls outside of the specified range.

Definition at line 3998 of file extconf.c.

{
    /* sorry, but this feature will NOT be available
       in the standalone version */
    return 0;
}

References ast_check_timing2(), and ast_tvnow().

Referenced by iftime(), include_valid(), and pbx_builtin_execiftime().

ast_check_timing2()

int ast_check_timing2	(	const struct ast_timing *	i,
		const struct timeval	tv
	)

Evaluate a pre-constructed bitmap as to whether a particular time falls within the range specified.

Parameters

i	Pointer to an ast_timing structure.
tv	Specified time

Return values

1	if the time matches.
0	if the time falls outside of the specified range.

Definition at line 245 of file pbx_timing.c.

{
    struct ast_tm tm;
 
    ast_localtime(&tv, &tm, i->timezone);
 
    /* If it's not the right month, return */
    if (!(i->monthmask & (1 << tm.tm_mon)))
        return 0;
 
    /* If it's not that time of the month.... */
    /* Warning, tm_mday has range 1..31! */
    if (!(i->daymask & (1 << (tm.tm_mday-1))))
        return 0;
 
    /* If it's not the right day of the week */
    if (!(i->dowmask & (1 << tm.tm_wday)))
        return 0;
 
    /* Sanity check the hour just to be safe */
    if ((tm.tm_hour < 0) || (tm.tm_hour > 23)) {
        ast_log(LOG_WARNING, "Insane time...\n");
        return 0;
    }
 
    /* Now the tough part, we calculate if it fits
       in the right time based on min/hour */
    if (!(i->minmask[tm.tm_hour * 2 + (tm.tm_min >= 30 ? 1 : 0)] & (1 << (tm.tm_min >= 30 ? tm.tm_min - 30 : tm.tm_min))))
        return 0;
 
    /* If we got this far, then we're good */
    return 1;
}

References ast_localtime(), ast_log, ast_timing::daymask, ast_timing::dowmask, LOG_WARNING, ast_timing::minmask, ast_timing::monthmask, ast_timing::timezone, ast_tm::tm_hour, ast_tm::tm_mday, ast_tm::tm_min, ast_tm::tm_mon, and ast_tm::tm_wday.

Referenced by ast_check_timing(), and pbx_builtin_gotoiftime().

ast_complete_applications()

char * ast_complete_applications	(	const char *	line,
		const char *	word,
		int	state
	)

Command completion for the list of installed applications.

This can be called from a CLI command completion function that wants to complete from the list of available applications.

Definition at line 429 of file pbx_app.c.

{
    struct ast_app *app;
    int which = 0;
    int cmp;
    char *ret = NULL;
    size_t wordlen = strlen(word);
 
    AST_RWLIST_RDLOCK(&apps);
    AST_RWLIST_TRAVERSE(&apps, app, list) {
        cmp = strncasecmp(word, app->name, wordlen);
        if (cmp < 0) {
            /* No more matches. */
            break;
        } else if (!cmp) {
            /* Found match. */
            if (state != -1) {
                if (++which <= state) {
                    /* Not enough matches. */
                    continue;
                }
                ret = ast_strdup(app->name);
                break;
            }
            if (ast_cli_completion_add(ast_strdup(app->name))) {
                break;
            }
        }
    }
    AST_RWLIST_UNLOCK(&apps);
 
    return ret;
}

References app, ast_cli_completion_add(), AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_strdup, and NULL.

Referenced by handle_orig(), and handle_show_application().

ast_context_add_ignorepat()

int ast_context_add_ignorepat	(	const char *	context,
		const char *	ignorepat,
		const char *	registrar
	)

Add an ignorepat.

Parameters

context	which context to add the ignorepattern to
ignorepat	ignorepattern to set up for the extension
registrar	registrar of the ignore pattern

Adds an ignore pattern to a particular context.

Return values

0	on success
-1	on failure

Definition at line 6856 of file pbx.c.

{
    int ret = -1;
    struct ast_context *c;
 
    c = find_context_locked(context);
    if (c) {
        ret = ast_context_add_ignorepat2(c, value, registrar);
        ast_unlock_contexts();
    }
    return ret;
}

References ast_context_add_ignorepat2(), ast_unlock_contexts(), c, voicemailpwcheck::context, find_context_locked(), registrar, and value.

Referenced by handle_cli_dialplan_add_ignorepat().

ast_context_add_ignorepat2()

static int ast_context_add_ignorepat2	(	struct ast_context *	con,
		const char *	ignorepat,
		const char *	registrar
	)

Definition at line 348 of file ael_main.c.

{
    if(!no_comp)
        printf("Executed ast_context_add_ignorepat2(con, value=%s, registrar=%s);\n", value, registrar);
    if( dump_extensions ) {
        struct namelist *x;
        x = create_name(value);
        ADD_LAST(con->ignorepats,x);
    }
}

References ADD_LAST, ast_context_ignorepats_count(), ast_context_ignorepats_get(), ast_get_ignorepat_name(), ast_unlock_context(), AST_VECTOR_APPEND, ast_wrlock_context(), create_name(), dump_extensions, errno, ignorepat_alloc(), ignorepat_free(), ast_context::ignorepats, no_comp, registrar, and value.

Referenced by ast_compile_ael2(), ast_context_add_ignorepat(), context_merge_incls_swits_igps_other_registrars(), and pbx_load_config().

ast_context_add_include()

int ast_context_add_include	(	const char *	context,
		const char *	include,
		const char *	registrar
	)

Add a context include.

Parameters

context	context to add include to
include	new include to add
registrar	who's registering it

Adds an include taking a char * string as the context parameter

Return values

0	on success
-1	on error

Definition at line 6685 of file pbx.c.

{
    int ret = -1;
    struct ast_context *c;
 
    c = find_context_locked(context);
    if (c) {
        ret = ast_context_add_include2(c, include, registrar);
        ast_unlock_contexts();
    }
    return ret;
}

References ast_context_add_include2(), ast_unlock_contexts(), c, voicemailpwcheck::context, find_context_locked(), and registrar.

Referenced by AST_TEST_DEFINE(), and handle_cli_dialplan_add_include().

ast_context_add_include2()

static int ast_context_add_include2	(	struct ast_context *	con,
		const char *	value,
		const char *	registrar
	)

Add a context include.

Adds an include taking a struct ast_context as the first parameter

Note

See ast_context_add_include for information on arguments

Definition at line 359 of file ael_main.c.

{
    if(!no_comp)
        printf("Executed ast_context_add_include2(con, value=%s, registrar=%s);\n", value, registrar);
    if( dump_extensions ) {
        struct namelist *x;
        x = create_name((char*)value);
        ADD_LAST(con->includes,x);
    }
}

References ADD_LAST, ast_context_includes_count(), ast_context_includes_get(), ast_debug, ast_get_context_name(), ast_get_include_name(), ast_unlock_context(), AST_VECTOR_APPEND, ast_wrlock_context(), create_name(), dump_extensions, errno, include_alloc(), include_free(), ast_context::includes, no_comp, registrar, and value.

Referenced by ast_compile_ael2(), ast_context_add_include(), context_merge_incls_swits_igps_other_registrars(), and pbx_load_config().

ast_context_add_switch()

int ast_context_add_switch	(	const char *	context,
		const char *	sw,
		const char *	data,
		int	eval,
		const char *	registrar
	)

Add a switch.

Parameters

context	context to which to add the switch
sw	switch to add
data	data to pass to switch
eval	whether to evaluate variables when running switch
registrar	whoever registered the switch

This function registers a switch with the asterisk switch architecture

Return values

0	on success
-1	on failure

Definition at line 6750 of file pbx.c.

{
    int ret = -1;
    struct ast_context *c;
 
    c = find_context_locked(context);
    if (c) { /* found, add switch to this context */
        ret = ast_context_add_switch2(c, sw, data, eval, registrar);
        ast_unlock_contexts();
    }
    return ret;
}

References ast_context_add_switch2(), ast_unlock_contexts(), c, voicemailpwcheck::context, ast_context::data, find_context_locked(), and registrar.

ast_context_add_switch2()

static int ast_context_add_switch2	(	struct ast_context *	con,
		const char *	sw,
		const char *	data,
		int	eval,
		const char *	registrar
	)

Adds a switch (first param is a ast_context)

Note

See ast_context_add_switch() for argument information, with the exception of the first argument. In this case, it's a pointer to an ast_context structure as opposed to the name.

Definition at line 370 of file ael_main.c.

{
    if(!no_comp)
        printf("Executed ast_context_add_switch2(con, value=%s, data=%s, eval=%d, registrar=%s);\n", value, data, eval, registrar);
    if( dump_extensions ) {
        struct namelist *x;
        x = create_name((char*)value);
        strncpy(x->name2, data, 99);
        if( eval ) {
 
            ADD_LAST(con->switches,x);
 
        } else {
 
            ADD_LAST(con->eswitches,x);
        }
    }
}

References ADD_LAST, ast_context::alts, ast_context_switches_count(), ast_context_switches_get(), ast_get_context_name(), ast_get_switch_data(), ast_get_switch_name(), ast_unlock_context(), AST_VECTOR_APPEND, ast_verb, ast_wrlock_context(), create_name(), ast_sw::data, dump_extensions, errno, ast_context::eswitches, ast_sw::eval, namelist::name2, no_comp, registrar, sw_alloc(), sw_free(), ast_context::switches, and value.

Referenced by ast_compile_ael2(), ast_context_add_switch(), context_merge_incls_swits_igps_other_registrars(), lua_register_switches(), and pbx_load_config().

ast_context_destroy()

void ast_context_destroy	(	struct ast_context *	con,
		const char *	registrar
	)

Destroy a context (matches the specified context or ANY context if NULL)

Parameters

con	context to destroy
registrar	who registered it

You can optionally leave out either parameter. It will find it based on either the ast_context or the registrar name.

Definition at line 8246 of file pbx.c.

{
    ast_wrlock_contexts();
    __ast_context_destroy(contexts, contexts_table, con,registrar);
    ast_unlock_contexts();
}

References __ast_context_destroy(), ast_unlock_contexts(), ast_wrlock_contexts(), contexts, contexts_table, and registrar.

Referenced by ast_context_destroy_by_name(), AST_TEST_DEFINE(), parking_lot_cfg_remove_extensions(), remove_all_configured_parking_lot_extensions(), remove_pending_parking_lot_extensions(), sla_destroy(), and unload_module().

ast_context_destroy_by_name()

int ast_context_destroy_by_name	(	const char *	context,
		const char *	registrar
	)

Destroy a context by name.

Parameters

context	Name of the context to destroy
registrar	who registered it

You can optionally leave out the registrar parameter. It will find it based on the context name.

Return values

-1	context not found
0	Success

Definition at line 8230 of file pbx.c.

{
    struct ast_context *con;
    int ret = -1;
 
    ast_wrlock_contexts();
    con = ast_context_find(context);
    if (con) {
        ast_context_destroy(con, registrar);
        ret = 0;
    }
    ast_unlock_contexts();
 
    return ret;
}

References ast_context_destroy(), ast_context_find(), ast_unlock_contexts(), ast_wrlock_contexts(), voicemailpwcheck::context, and registrar.

Referenced by __unload_module(), app_dtor(), ast_sip_destroy_sorcery_global(), check_regcontext(), handle_cli_dialplan_remove_context(), and session_unregister_app_cb().

ast_context_find()

static struct ast_context * ast_context_find

(

const char *

name

)

Find a context.

Parameters

name	name of the context to find

Will search for the context with the given name.

Returns

the ast_context on success, NULL on failure.

Definition at line 4170 of file extconf.c.

{
    struct ast_context *tmp = NULL;
    while ( (tmp = ast_walk_contexts(tmp)) ) {
        if (!name || !strcasecmp(name, tmp->name))
            break;
    }
    return tmp;
}

References ast_hashtab_lookup(), ast_rdlock_contexts(), ast_unlock_contexts(), ast_walk_contexts(), contexts_table, item, name, aco_type::name, ast_context::name, and NULL.

Referenced by app_create(), ast_context_destroy_by_name(), ast_context_verify_includes(), ast_ignore_pattern(), context_included(), handle_cli_dialplan_add_extension(), handle_cli_dialplan_add_include(), isexten_function_read(), and session_register_apps().

ast_context_find_or_create()

struct ast_context * ast_context_find_or_create	(	struct ast_context **	extcontexts,
		struct ast_hashtab *	exttable,
		const char *	name,
		const char *	registrar
	)

Register a new context or find an existing one.

Parameters

extcontexts	pointer to the ast_context structure pointer
exttable	pointer to the hashtable that contains all the elements in extcontexts
name	name of the new context
registrar	registrar of the context

This function allows you to play in two environments: the global contexts (active dialplan) or an external context set of your choosing. To act on the external set, make sure extcontexts and exttable are set; for the globals, make sure both extcontexts and exttable are NULL.

This will first search for a context with your name. If it exists already, it will not create a new one. If it does not exist, it will create a new one with the given name and registrar.

Returns

NULL on failure, and an ast_context structure on success

Definition at line 6170 of file pbx.c.

{
    struct ast_context *tmp, **local_contexts;
    struct ast_context search = {
        .name = name,
    };
    size_t name_bytes = strlen(name);
    size_t registrar_bytes = strlen(registrar);
    int length = sizeof(struct ast_context) + name_bytes + registrar_bytes + 2;
 
    if (!contexts_table) {
        /* Protect creation of contexts_table from reentrancy. */
        ast_wrlock_contexts();
        if (!contexts_table) {
            contexts_table = ast_hashtab_create(17,
                ast_hashtab_compare_contexts,
                ast_hashtab_resize_java,
                ast_hashtab_newsize_java,
                ast_hashtab_hash_contexts,
                0);
        }
        ast_unlock_contexts();
    }
 
    if (!extcontexts) {
        ast_rdlock_contexts();
        local_contexts = &contexts;
        tmp = ast_hashtab_lookup(contexts_table, &search);
        if (tmp) {
            tmp->refcount++;
            ast_unlock_contexts();
            return tmp;
        }
    } else { /* local contexts just in a linked list; search there for the new context; slow, linear search, but not frequent */
        local_contexts = extcontexts;
        tmp = ast_hashtab_lookup(exttable, &search);
        if (tmp) {
            tmp->refcount++;
            return tmp;
        }
    }
 
    if ((tmp = ast_calloc(1, length))) {
        ast_rwlock_init(&tmp->lock);
        tmp->name = memcpy(&tmp->data[0], name, name_bytes);
        tmp->registrar = memcpy(&tmp->data[name_bytes + 1], registrar, registrar_bytes);
        tmp->root = NULL;
        tmp->root_table = NULL;
        AST_VECTOR_INIT(&tmp->includes, 0);
        AST_VECTOR_INIT(&tmp->ignorepats, 0);
        AST_VECTOR_INIT(&tmp->alts, 0);
        tmp->refcount = 1;
 
        /* The context 'name' must be stored at the beginning of 'data.' The
         * order of subsequent strings (currently only 'registrar') is not
         * relevant. */
        ast_assert(tmp->name == &tmp->data[0]);
    } else {
        ast_log(LOG_ERROR, "Danger! We failed to allocate a context for %s!\n", name);
        if (!extcontexts) {
            ast_unlock_contexts();
        }
        return NULL;
    }
 
    if (!extcontexts) {
        tmp->next = *local_contexts;
        *local_contexts = tmp;
        ast_hashtab_insert_safe(contexts_table, tmp); /*put this context into the tree */
        ast_unlock_contexts();
    } else {
        tmp->next = *local_contexts;
        if (exttable)
            ast_hashtab_insert_immediate(exttable, tmp); /*put this context into the tree */
 
        *local_contexts = tmp;
    }
    ast_debug(1, "Registered extension context '%s'; registrar: %s\n", tmp->name, registrar);
    return tmp;
}

References ast_context::alts, ast_assert, ast_calloc, ast_debug, ast_hashtab_compare_contexts(), ast_hashtab_create, ast_hashtab_hash_contexts(), ast_hashtab_insert_immediate, ast_hashtab_insert_safe, ast_hashtab_lookup(), ast_hashtab_newsize_java(), ast_hashtab_resize_java(), ast_log, ast_rdlock_contexts(), ast_rwlock_init, ast_unlock_contexts(), AST_VECTOR_INIT, ast_wrlock_contexts(), contexts, contexts_table, ast_context::data, ast_context::ignorepats, ast_context::includes, local_contexts, ast_context::lock, LOG_ERROR, name, ast_context::name, ast_context::next, NULL, ast_context::refcount, ast_context::registrar, registrar, ast_context::root, and ast_context::root_table.

Referenced by add_hints(), app_create(), ast_compile_ael2(), ast_sip_persistent_endpoint_add_to_regcontext(), AST_TEST_DEFINE(), context_merge(), create_test_dialplan(), handle_cli_dialplan_add_extension(), handle_cli_dialplan_add_include(), load_module(), lua_register_hints(), lua_register_switches(), manager_dialplan_extension_add(), parking_duration_callback(), parking_lot_cfg_create_extensions(), pbx_load_config(), session_register_apps(), set_config(), sla_build_station(), and sla_build_trunk().

ast_context_ignorepats_count()

int ast_context_ignorepats_count

(

const struct ast_context *

con

)

Definition at line 8747 of file pbx.c.

{
    return AST_VECTOR_SIZE(&con->ignorepats);
}

References AST_VECTOR_SIZE, and ast_context::ignorepats.

Referenced by __ast_context_destroy(), ast_context_add_ignorepat2(), ast_context_remove_ignorepat2(), ast_ignore_pattern(), ast_walk_context_ignorepats(), complete_dialplan_remove_ignorepat(), context_merge_incls_swits_igps_other_registrars(), context_used(), handle_cli_dialplan_save(), lookup_c_ip(), manager_show_dialplan_helper(), and show_dialplan_helper().

ast_context_ignorepats_get()

const struct ast_ignorepat * ast_context_ignorepats_get	(	const struct ast_context *	con,
		int	idx
	)

Definition at line 8752 of file pbx.c.

{
    return AST_VECTOR_GET(&con->ignorepats, idx);
}

References AST_VECTOR_GET, and ast_context::ignorepats.

Referenced by ast_context_add_ignorepat2(), ast_ignore_pattern(), ast_walk_context_ignorepats(), complete_dialplan_remove_ignorepat(), context_merge_incls_swits_igps_other_registrars(), handle_cli_dialplan_save(), lookup_c_ip(), manager_show_dialplan_helper(), and show_dialplan_helper().

ast_context_includes_count()

int ast_context_includes_count

(

const struct ast_context *

con

)

Definition at line 8704 of file pbx.c.

{
    return AST_VECTOR_SIZE(&con->includes);
}

References AST_VECTOR_SIZE, and ast_context::includes.

Referenced by __ast_context_destroy(), ast_context_add_include2(), ast_context_remove_include2(), ast_context_verify_includes(), ast_walk_context_includes(), complete_dialplan_remove_include(), context_merge_incls_swits_igps_other_registrars(), context_used(), find_matching_priority(), handle_cli_dialplan_save(), lookup_ci(), manager_show_dialplan_helper(), pbx_find_extension(), and show_dialplan_helper().

ast_context_includes_get()

const struct ast_include * ast_context_includes_get	(	const struct ast_context *	con,
		int	idx
	)

Definition at line 8709 of file pbx.c.

{
    return AST_VECTOR_GET(&con->includes, idx);
}

References AST_VECTOR_GET, and ast_context::includes.

Referenced by ast_context_add_include2(), ast_context_verify_includes(), ast_walk_context_includes(), complete_dialplan_remove_include(), context_merge_incls_swits_igps_other_registrars(), find_matching_priority(), handle_cli_dialplan_save(), lookup_ci(), manager_show_dialplan_helper(), pbx_find_extension(), and show_dialplan_helper().

ast_context_remove_extension()

int ast_context_remove_extension	(	const char *	context,
		const char *	extension,
		int	priority,
		const char *	registrar
	)

Simply remove extension from context.

Parameters

context	context to remove extension from
extension	which extension to remove
priority	priority of extension to remove (0 to remove all)
registrar	registrar of the extension

This function removes an extension from a given context.

Return values

0	on success
-1	on failure

Note

This function will lock conlock.

Definition at line 4969 of file pbx.c.

{
    return ast_context_remove_extension_callerid(context, extension, priority, NULL, AST_EXT_MATCHCID_ANY, registrar);
}

References ast_context_remove_extension_callerid(), AST_EXT_MATCHCID_ANY, voicemailpwcheck::context, NULL, priority, and registrar.

Referenced by ast_sip_persistent_endpoint_update_state(), AST_TEST_DEFINE(), conf_ended(), delete_extens(), register_peer_exten(), sla_station_destructor(), sla_trunk_destructor(), and unregister_extension().

ast_context_remove_extension2()

int ast_context_remove_extension2	(	struct ast_context *	con,
		const char *	extension,
		int	priority,
		const char *	registrar,
		int	already_locked
	)

This functionc locks given context, search for the right extension and fires out all peer in this extensions with given priority. If priority is set to 0, all peers are removed. After that, unlock context and return.

Note

When do you want to call this function, make sure that &conlock is locked, because some process can handle with your *con context before you lock it.

Definition at line 4999 of file pbx.c.

{
    return ast_context_remove_extension_callerid2(con, extension, priority, NULL, AST_EXT_MATCHCID_ANY, registrar, already_locked);
}

References ast_context_remove_extension_callerid2(), AST_EXT_MATCHCID_ANY, NULL, priority, and registrar.

Referenced by add_extension(), and add_hints().

ast_context_remove_extension_callerid()

int ast_context_remove_extension_callerid	(	const char *	context,
		const char *	extension,
		int	priority,
		const char *	callerid,
		int	matchcid,
		const char *	registrar
	)

Definition at line 4974 of file pbx.c.

{
    int ret = -1; /* default error return */
    struct ast_context *c;
 
    c = find_context_locked(context);
    if (c) { /* ... remove extension ... */
        ret = ast_context_remove_extension_callerid2(c, extension, priority, callerid,
            matchcallerid, registrar, 0);
        ast_unlock_contexts();
    }
 
    return ret;
}

References ast_context_remove_extension_callerid2(), ast_unlock_contexts(), c, voicemailpwcheck::context, find_context_locked(), priority, and registrar.

Referenced by ast_context_remove_extension(), handle_cli_dialplan_remove_extension(), and manager_dialplan_extension_remove().

ast_context_remove_extension_callerid2()

int ast_context_remove_extension_callerid2	(	struct ast_context *	con,
		const char *	extension,
		int	priority,
		const char *	callerid,
		int	matchcid,
		const char *	registrar,
		int	already_locked
	)

Definition at line 5004 of file pbx.c.

{
    struct ast_exten *exten, *prev_exten = NULL;
    struct ast_exten *peer;
    struct ast_exten ex, *exten2, *exten3;
    char dummy_name[1024];
    char dummy_cid[1024];
    struct ast_exten *previous_peer = NULL;
    struct ast_exten *next_peer = NULL;
    int found = 0;
 
    if (!already_locked)
        ast_wrlock_context(con);
 
#ifdef NEED_DEBUG
    ast_verb(3,"Removing %s/%s/%d%s%s from trees, registrar=%s\n", con->name, extension, priority, matchcallerid ? "/" : "", matchcallerid ? callerid : "", registrar);
#endif
#ifdef CONTEXT_DEBUG
    check_contexts(__FILE__, __LINE__);
#endif
    /* find this particular extension */
    ex.exten = dummy_name;
    ext_strncpy(dummy_name, extension, sizeof(dummy_name), 1);
    ex.matchcid = matchcallerid;
    if (callerid) {
        ex.cidmatch = dummy_cid;
        ext_strncpy(dummy_cid, callerid, sizeof(dummy_cid), 1);
    } else {
        ex.cidmatch = NULL;
    }
    exten = ast_hashtab_lookup(con->root_table, &ex);
    if (exten) {
        if (priority == 0) {
            exten2 = ast_hashtab_remove_this_object(con->root_table, exten);
            if (!exten2)
                ast_log(LOG_ERROR,"Trying to delete the exten %s from context %s, but could not remove from the root_table\n", extension, con->name);
            if (con->pattern_tree) {
                struct match_char *x = add_exten_to_pattern_tree(con, exten, 1);
 
                if (x->exten) { /* this test for safety purposes */
                    x->deleted = 1; /* with this marked as deleted, it will never show up in the scoreboard, and therefore never be found */
                    x->exten = 0; /* get rid of what will become a bad pointer */
                } else {
                    ast_log(LOG_WARNING,"Trying to delete an exten from a context, but the pattern tree node returned isn't a full extension\n");
                }
            }
        } else {
            ex.priority = priority;
            exten2 = ast_hashtab_lookup(exten->peer_table, &ex);
            if (exten2) {
                if (exten2->label) { /* if this exten has a label, remove that, too */
                    exten3 = ast_hashtab_remove_this_object(exten->peer_label_table,exten2);
                    if (!exten3) {
                        ast_log(LOG_ERROR, "Did not remove this priority label (%d/%s) "
                            "from the peer_label_table of context %s, extension %s!\n",
                            priority, exten2->label, con->name, exten2->name);
                    }
                }
 
                exten3 = ast_hashtab_remove_this_object(exten->peer_table, exten2);
                if (!exten3) {
                    ast_log(LOG_ERROR, "Did not remove this priority (%d) from the "
                        "peer_table of context %s, extension %s!\n",
                        priority, con->name, exten2->name);
                }
                if (exten2 == exten && exten2->peer) {
                    exten2 = ast_hashtab_remove_this_object(con->root_table, exten);
                    ast_hashtab_insert_immediate(con->root_table, exten2->peer);
                }
                if (ast_hashtab_size(exten->peer_table) == 0) {
                    /* well, if the last priority of an exten is to be removed,
                       then, the extension is removed, too! */
                    exten3 = ast_hashtab_remove_this_object(con->root_table, exten);
                    if (!exten3) {
                        ast_log(LOG_ERROR, "Did not remove this exten (%s) from the "
                            "context root_table (%s) (priority %d)\n",
                            exten->name, con->name, priority);
                    }
                    if (con->pattern_tree) {
                        struct match_char *x = add_exten_to_pattern_tree(con, exten, 1);
                        if (x->exten) { /* this test for safety purposes */
                            x->deleted = 1; /* with this marked as deleted, it will never show up in the scoreboard, and therefore never be found */
                            x->exten = 0; /* get rid of what will become a bad pointer */
                        }
                    }
                }
            } else {
                ast_debug(3,"Could not find priority %d of exten %s in context %s!\n",
                        priority, exten->name, con->name);
            }
        }
    } else {
        /* hmmm? this exten is not in this pattern tree? */
        ast_log(LOG_WARNING,"Cannot find extension %s in root_table in context %s\n",
                extension, con->name);
    }
#ifdef NEED_DEBUG
    if (con->pattern_tree) {
        ast_log(LOG_NOTICE,"match char tree after exten removal:\n");
        log_match_char_tree(con->pattern_tree, " ");
    }
#endif
 
    /* scan the extension list to find first matching extension-registrar */
    for (exten = con->root; exten; prev_exten = exten, exten = exten->next) {
        if (!strcmp(exten->exten, ex.exten) &&
            (!matchcallerid ||
                (!ast_strlen_zero(ex.cidmatch) && !ast_strlen_zero(exten->cidmatch) && !strcmp(exten->cidmatch, ex.cidmatch)) ||
                (ast_strlen_zero(ex.cidmatch) && ast_strlen_zero(exten->cidmatch)))) {
            break;
        }
    }
    if (!exten) {
        /* we can't find right extension */
        if (!already_locked)
            ast_unlock_context(con);
        return -1;
    }
 
    /* scan the priority list to remove extension with exten->priority == priority */
    for (peer = exten, next_peer = exten->peer ? exten->peer : exten->next;
         peer && !strcmp(peer->exten, ex.exten) &&
            (!callerid || (!matchcallerid && !peer->matchcid) || (matchcallerid && peer->matchcid && !strcmp(peer->cidmatch, ex.cidmatch))) ;
            peer = next_peer, next_peer = next_peer ? (next_peer->peer ? next_peer->peer : next_peer->next) : NULL) {
 
        if ((priority == 0 || peer->priority == priority) &&
                (!registrar || !strcmp(peer->registrar, registrar) )) {
            found = 1;
 
            /* we are first priority extension? */
            if (!previous_peer) {
                /*
                 * We are first in the priority chain, so must update the extension chain.
                 * The next node is either the next priority or the next extension
                 */
                struct ast_exten *next_node = peer->peer ? peer->peer : peer->next;
                if (peer->peer) {
                    /* move the peer_table and peer_label_table down to the next peer, if
                       it is there */
                    peer->peer->peer_table = peer->peer_table;
                    peer->peer->peer_label_table = peer->peer_label_table;
                    peer->peer_table = NULL;
                    peer->peer_label_table = NULL;
                }
                if (!prev_exten) {  /* change the root... */
                    con->root = next_node;
                } else {
                    prev_exten->next = next_node; /* unlink */
                }
                if (peer->peer) { /* update the new head of the pri list */
                    peer->peer->next = peer->next;
                }
            } else { /* easy, we are not first priority in extension */
                previous_peer->peer = peer->peer;
            }
 
 
            /* now, free whole priority extension */
            destroy_exten(peer);
        } else {
            previous_peer = peer;
        }
    }
    if (!already_locked)
        ast_unlock_context(con);
    return found ? 0 : -1;
}

References add_exten_to_pattern_tree(), ast_debug, ast_hashtab_insert_immediate, ast_hashtab_lookup(), ast_hashtab_remove_this_object(), ast_hashtab_size(), ast_log, ast_strlen_zero(), ast_unlock_context(), ast_verb, ast_wrlock_context(), ast_exten::cidmatch, destroy_exten(), ext_strncpy(), ast_exten::exten, match_char::exten, ast_exten::label, LOG_ERROR, LOG_NOTICE, LOG_WARNING, ast_exten::matchcid, ast_exten::name, ast_context::name, ast_exten::next, NULL, ast_context::pattern_tree, ast_exten::peer, ast_exten::peer_label_table, ast_exten::peer_table, priority, ast_exten::priority, ast_exten::registrar, registrar, ast_context::root, ast_context::root_table, and match_char::x.

Referenced by __ast_context_destroy(), ast_context_remove_extension2(), and ast_context_remove_extension_callerid().

ast_context_remove_ignorepat()

int ast_context_remove_ignorepat	(	const char *	context,
		const char *	ignorepat,
		const char *	registrar
	)

Remove an ignorepat.

Parameters

context	context from which to remove the pattern
ignorepat	the pattern to remove
registrar	the registrar of the ignore pattern

This removes the given ignorepattern

Return values

0	on success
-1	on failure

Definition at line 6816 of file pbx.c.

{
    int ret = -1;
    struct ast_context *c;
 
    c = find_context_locked(context);
    if (c) {
        ret = ast_context_remove_ignorepat2(c, ignorepat, registrar);
        ast_unlock_contexts();
    }
    return ret;
}

References ast_context_remove_ignorepat2(), ast_unlock_contexts(), c, voicemailpwcheck::context, find_context_locked(), and registrar.

Referenced by handle_cli_dialplan_remove_ignorepat().

ast_context_remove_ignorepat2()

int ast_context_remove_ignorepat2	(	struct ast_context *	con,
		const char *	ignorepat,
		const char *	registrar
	)

Definition at line 6829 of file pbx.c.

{
    int idx;
 
    ast_wrlock_context(con);
 
    for (idx = 0; idx < ast_context_ignorepats_count(con); idx++) {
        struct ast_ignorepat *ip = AST_VECTOR_GET(&con->ignorepats, idx);
 
        if (!strcmp(ast_get_ignorepat_name(ip), ignorepat) &&
            (!registrar || (registrar == ast_get_ignorepat_registrar(ip)))) {
            AST_VECTOR_REMOVE_ORDERED(&con->ignorepats, idx);
            ignorepat_free(ip);
            ast_unlock_context(con);
            return 0;
        }
    }
 
    ast_unlock_context(con);
    errno = EINVAL;
    return -1;
}

References ast_context_ignorepats_count(), ast_get_ignorepat_name(), ast_get_ignorepat_registrar(), ast_unlock_context(), AST_VECTOR_GET, AST_VECTOR_REMOVE_ORDERED, ast_wrlock_context(), errno, ignorepat_free(), ast_context::ignorepats, and registrar.

Referenced by ast_context_remove_ignorepat().

ast_context_remove_include()

int ast_context_remove_include	(	const char *	context,
		const char *	include,
		const char *	registrar
	)

Remove a context include.

Note

See ast_context_add_include for information on arguments

Remove a context include.

Definition at line 4857 of file pbx.c.

{
    int ret = -1;
    struct ast_context *c;
 
    c = find_context_locked(context);
    if (c) {
        /* found, remove include from this context ... */
        ret = ast_context_remove_include2(c, include, registrar);
        ast_unlock_contexts();
    }
    return ret;
}

References ast_context_remove_include2(), ast_unlock_contexts(), c, voicemailpwcheck::context, find_context_locked(), and registrar.

Referenced by handle_cli_dialplan_remove_include().

ast_context_remove_include2()

int ast_context_remove_include2	(	struct ast_context *	con,
		const char *	include,
		const char *	registrar
	)

Removes an include by an ast_context structure.

Note

See ast_context_add_include for information on arguments

Removes an include by an ast_context structure.

Return values

0	on success.
-1	on failure.

Definition at line 4880 of file pbx.c.

{
    int ret = -1;
    int idx;
 
    ast_wrlock_context(con);
 
    /* find our include */
    for (idx = 0; idx < ast_context_includes_count(con); idx++) {
        struct ast_include *i = AST_VECTOR_GET(&con->includes, idx);
 
        if (!strcmp(ast_get_include_name(i), include) &&
                (!registrar || !strcmp(ast_get_include_registrar(i), registrar))) {
 
            /* remove from list */
            ast_verb(3, "Removing inclusion of context '%s' in context '%s; registrar=%s'\n", include, ast_get_context_name(con), registrar);
            AST_VECTOR_REMOVE_ORDERED(&con->includes, idx);
 
            /* free include and return */
            include_free(i);
            ret = 0;
            break;
        }
    }
 
    ast_unlock_context(con);
 
    return ret;
}

References ast_context_includes_count(), ast_get_context_name(), ast_get_include_name(), ast_get_include_registrar(), ast_unlock_context(), AST_VECTOR_GET, AST_VECTOR_REMOVE_ORDERED, ast_verb, ast_wrlock_context(), include_free(), ast_context::includes, and registrar.

Referenced by ast_context_remove_include().

ast_context_remove_switch()

int ast_context_remove_switch	(	const char *	context,
		const char *	sw,
		const char *	data,
		const char *	registrar
	)

Remove a switch.

Removes a switch with the given parameters

Return values

0	on success
-1	on failure

Note

This function locks contexts list by &conlist, search for the right context structure, leave context list locked and call ast_context_remove_switch2 which removes switch, unlock contexts list and return ...

Definition at line 4915 of file pbx.c.

{
    int ret = -1; /* default error return */
    struct ast_context *c;
 
    c = find_context_locked(context);
    if (c) {
        /* remove switch from this context ... */
        ret = ast_context_remove_switch2(c, sw, data, registrar);
        ast_unlock_contexts();
    }
    return ret;
}

References ast_context_remove_switch2(), ast_unlock_contexts(), c, voicemailpwcheck::context, ast_context::data, find_context_locked(), and registrar.

ast_context_remove_switch2()

int ast_context_remove_switch2	(	struct ast_context *	con,
		const char *	sw,
		const char *	data,
		const char *	registrar
	)

This function locks given context, removes switch, unlock context and return.

Note

When we call this function, &conlock lock must be locked, because when we giving *con argument, some process can remove/change this context and after that there can be segfault.

Definition at line 4937 of file pbx.c.

{
    int idx;
    int ret = -1;
 
    ast_wrlock_context(con);
 
    /* walk switches */
    for (idx = 0; idx < ast_context_switches_count(con); idx++) {
        struct ast_sw *i = AST_VECTOR_GET(&con->alts, idx);
 
        if (!strcmp(ast_get_switch_name(i), sw) &&
            !strcmp(ast_get_switch_data(i), data) &&
            (!registrar || !strcmp(ast_get_switch_registrar(i), registrar))) {
 
            /* found, remove from list */
            ast_verb(3, "Removing switch '%s' from context '%s; registrar=%s'\n", sw, ast_get_context_name(con), registrar);
            AST_VECTOR_REMOVE_ORDERED(&con->alts, idx);
 
            /* free switch and return */
            sw_free(i);
            ret = 0;
            break;
        }
    }
 
    ast_unlock_context(con);
 
    return ret;
}

References ast_context::alts, ast_context_switches_count(), ast_get_context_name(), ast_get_switch_data(), ast_get_switch_name(), ast_get_switch_registrar(), ast_unlock_context(), AST_VECTOR_GET, AST_VECTOR_REMOVE_ORDERED, ast_verb, ast_wrlock_context(), ast_sw::data, registrar, and sw_free().

Referenced by ast_context_remove_switch().

ast_context_set_autohints()

void ast_context_set_autohints	(	struct ast_context *	con,
		int	enabled
	)

Enable or disable autohints support on a context.

Parameters

con	pointer to the context
enabled	whether autohints are enabled

Definition at line 6251 of file pbx.c.

{
    con->autohints = enabled;
}

References ast_context::autohints, and enabled.

Referenced by pbx_load_config().

ast_context_switches_count()

int ast_context_switches_count

(

const struct ast_context *

con

)

Definition at line 8659 of file pbx.c.

{
    return AST_VECTOR_SIZE(&con->alts);
}

References ast_context::alts, and AST_VECTOR_SIZE.

Referenced by __ast_context_destroy(), ast_context_add_switch2(), ast_context_remove_switch2(), ast_walk_context_switches(), context_merge_incls_swits_igps_other_registrars(), context_used(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), pbx_find_extension(), and show_dialplan_helper().

ast_context_switches_get()

const struct ast_sw * ast_context_switches_get	(	const struct ast_context *	con,
		int	idx
	)

Definition at line 8664 of file pbx.c.

{
    return AST_VECTOR_GET(&con->alts, idx);
}

References ast_context::alts, and AST_VECTOR_GET.

Referenced by ast_context_add_switch2(), ast_walk_context_switches(), context_merge_incls_swits_igps_other_registrars(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), pbx_find_extension(), and show_dialplan_helper().

ast_context_verify_includes()

int ast_context_verify_includes

(

struct ast_context *

con

)

Verifies includes in an ast_contect structure.

Parameters

con	context in which to verify the includes

Return values

0	if no problems found
-1	if there were any missing context

Definition at line 8757 of file pbx.c.

{
    int idx;
    int res = 0;
    int includecount = ast_context_includes_count(con);
 
    if (includecount >= AST_PBX_MAX_STACK) {
        ast_log(LOG_WARNING, "Context %s contains too many includes (%d). Maximum is %d.\n",
            ast_get_context_name(con), includecount, AST_PBX_MAX_STACK);
    }
 
    for (idx = 0; idx < includecount; idx++) {
        const struct ast_include *inc = ast_context_includes_get(con, idx);
 
        if (ast_context_find(include_rname(inc))) {
            continue;
        }
 
        res = -1;
        ast_log(LOG_WARNING, "Context '%s' tries to include nonexistent context '%s'\n",
            ast_get_context_name(con), include_rname(inc));
        break;
    }
 
    return res;
}

References ast_context_find(), ast_context_includes_count(), ast_context_includes_get(), ast_get_context_name(), ast_log, AST_PBX_MAX_STACK, include_rname(), and LOG_WARNING.

Referenced by pbx_load_module().

ast_custom_function_find()

struct ast_custom_function * ast_custom_function_find

(

const char *

name

)

Definition at line 173 of file ael_main.c.

{
    return 0; /* in "standalone" mode, functions are just not avail */
}

References ast_custom_function_find_nolock(), AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, and name.

Referenced by ast_compile_ael2(), ast_func_read(), ast_func_read2(), ast_func_write(), AST_TEST_DEFINE(), chanavail_exec(), config_curl(), destroy_curl(), handle_show_function(), op_func(), realtime_curl(), realtime_multi_curl(), require_curl(), store_curl(), update2_curl(), and update_curl().

ast_custom_function_unregister()

int ast_custom_function_unregister

(

struct ast_custom_function *

acf

)

Unregister a custom function.

Definition at line 262 of file pbx_functions.c.

{
    struct ast_custom_function *cur;
 
    if (!acf) {
        return -1;
    }
 
    AST_RWLIST_WRLOCK(&acf_root);
    cur = AST_RWLIST_REMOVE(&acf_root, acf, acflist);
    if (cur) {
#ifdef AST_XML_DOCS
        if (cur->docsrc == AST_XML_DOC) {
            ast_string_field_free_memory(acf);
        }
#endif
        ast_verb(5, "Unregistered custom function %s\n", cur->name);
    }
    AST_RWLIST_UNLOCK(&acf_root);
 
    return cur ? 0 : -1;
}

References AST_RWLIST_REMOVE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_string_field_free_memory, ast_verb, AST_XML_DOC, ast_custom_function::docsrc, and ast_custom_function::name.

Referenced by __unload_module(), close_logger(), geoloc_dialplan_unload(), load_module(), manager_shutdown(), message_shutdown(), reload(), unload_features_config(), unload_module(), unload_parking_bridge_features(), and unload_pbx().

ast_destroy_timing()

int ast_destroy_timing

(

struct ast_timing *

i

)

Deallocates memory structures associated with a timing bitmap.

Parameters

i	Pointer to an ast_timing structure.

Return values

0	success
non-zero	failure (number suitable to pass to

See also

strerror)

Definition at line 279 of file pbx_timing.c.

{
    if (i->timezone) {
        ast_free(i->timezone);
        i->timezone = NULL;
    }
    return 0;
}

References ast_free, NULL, and ast_timing::timezone.

Referenced by iftime(), include_free(), pbx_builtin_execiftime(), and pbx_builtin_gotoiftime().

ast_devstate_to_extenstate()

enum ast_extension_states ast_devstate_to_extenstate

(

enum ast_device_state

devstate

)

Map devstate to an extension state.

Parameters

[in]

devstate

device state

Returns

the extension state mapping.

Definition at line 3027 of file pbx.c.

{
    switch (devstate) {
    case AST_DEVICE_ONHOLD:
        return AST_EXTENSION_ONHOLD;
    case AST_DEVICE_BUSY:
        return AST_EXTENSION_BUSY;
    case AST_DEVICE_UNKNOWN:
        return AST_EXTENSION_NOT_INUSE;
    case AST_DEVICE_UNAVAILABLE:
    case AST_DEVICE_INVALID:
        return AST_EXTENSION_UNAVAILABLE;
    case AST_DEVICE_RINGINUSE:
        return (AST_EXTENSION_INUSE | AST_EXTENSION_RINGING);
    case AST_DEVICE_RINGING:
        return AST_EXTENSION_RINGING;
    case AST_DEVICE_INUSE:
        return AST_EXTENSION_INUSE;
    case AST_DEVICE_NOT_INUSE:
        return AST_EXTENSION_NOT_INUSE;
    case AST_DEVICE_TOTAL: /* not a device state, included for completeness */
        break;
    }
 
    return AST_EXTENSION_NOT_INUSE;
}

References AST_DEVICE_BUSY, AST_DEVICE_INUSE, AST_DEVICE_INVALID, AST_DEVICE_NOT_INUSE, AST_DEVICE_ONHOLD, AST_DEVICE_RINGING, AST_DEVICE_RINGINUSE, AST_DEVICE_TOTAL, AST_DEVICE_UNAVAILABLE, AST_DEVICE_UNKNOWN, AST_EXTENSION_BUSY, AST_EXTENSION_INUSE, AST_EXTENSION_NOT_INUSE, AST_EXTENSION_ONHOLD, AST_EXTENSION_RINGING, and AST_EXTENSION_UNAVAILABLE.

Referenced by ast_extension_state3(), and AST_TEST_DEFINE().

ast_exists_extension()

int ast_exists_extension	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten,
		int	priority,
		const char *	callerid
	)

Determine whether an extension exists.

Parameters

c	this is not important
context	which context to look in
exten	which extension to search for
priority	priority of the action within the extension
callerid	callerid to search for

Note

It is possible for autoservice to be started and stopped on c during this function call, it is important that c is not locked prior to calling this. Otherwise a deadlock may occur

Returns

If an extension within the given context(or callerid) with the given priority is found a non zero value will be returned. Otherwise, 0 is returned.

Definition at line 4196 of file pbx.c.

{
    return pbx_extension_helper(c, NULL, context, exten, priority, NULL, callerid, E_MATCH, 0, 0);
}

References c, voicemailpwcheck::context, E_MATCH, ast_exten::exten, NULL, pbx_extension_helper(), and priority.

Referenced by __analog_ss_thread(), __ast_goto_if_exists(), __ast_pbx_run(), action_originate(), add_to_regcontext(), analog_ss_thread(), ast_app_dtget(), ast_bridge_setup_after_goto(), ast_pbx_outgoing_exten_predial(), ast_sip_persistent_endpoint_update_state(), chan_pjsip_cng_tone_detected(), cli_console_dial(), comeback_goto(), conf_run(), dahdi_handle_dtmf(), dial_exec_full(), dialplan_has_destination_cb(), disa_exec(), dp_lookup(), dundi_lookup_local(), fax_detect_framehook(), findmeexec(), get_destination(), gosub_exec(), grab_transfer(), handle_gosub(), isexten_function_read(), jingle_new(), join_conference_bridge(), key_dial_page(), leave_voicemail(), local_call(), local_devicestate(), loopback_exists(), minivm_greet_exec(), my_handle_dtmf(), new_subscribe(), onModeChanged(), ooh323_rtp_read(), options_on_rx_request(), pbx_builtin_waitexten(), privacy_exec(), readexten_exec(), refer_incoming_attended_request(), refer_incoming_blind_request(), register_peer_exten(), show_debug_helper(), socket_process_helper(), try_calling(), vm_authenticate(), and waitstream_core().

ast_explicit_goto()

int ast_explicit_goto	(	struct ast_channel *	chan,
		const char *	context,
		const char *	exten,
		int	priority
	)

Note

This function will handle locking the channel as needed.

If the AST_SOFTHANGUP_ASYNCGOTO flag is set on the channel, this function will fail and return -1.

Definition at line 6966 of file pbx.c.

{
    if (!chan)
        return -1;
 
    ast_channel_lock(chan);
 
    if (ast_channel_softhangup_internal_flag(chan) & AST_SOFTHANGUP_ASYNCGOTO) {
        ast_channel_unlock(chan);
        return -1;
    }
    if (!ast_strlen_zero(context))
        ast_channel_context_set(chan, context);
    if (!ast_strlen_zero(exten))
        ast_channel_exten_set(chan, exten);
    if (priority > -1) {
        /* see flag description in channel.h for explanation */
        if (ast_test_flag(ast_channel_flags(chan), AST_FLAG_IN_AUTOLOOP)) {
            --priority;
        }
        ast_channel_priority_set(chan, priority);
    }
 
    ast_channel_unlock(chan);
 
    return 0;
}

References ast_channel_context_set(), ast_channel_exten_set(), ast_channel_flags(), ast_channel_lock, ast_channel_priority_set(), ast_channel_softhangup_internal_flag(), ast_channel_unlock, AST_FLAG_IN_AUTOLOOP, AST_SOFTHANGUP_ASYNCGOTO, ast_strlen_zero(), ast_test_flag, voicemailpwcheck::context, and priority.

Referenced by __ast_goto_if_exists(), app_control_continue(), ast_async_goto(), ast_bridge_setup_after_goto(), disa_exec(), handle_setpriority(), msg_route(), and pbx_parseable_goto().

ast_extension_close()

int ast_extension_close	(	const char *	pattern,
		const char *	data,
		int	needmore
	)

Definition at line 2447 of file pbx.c.

{
    if (needmore != E_MATCHMORE && needmore != E_CANMATCH)
        ast_log(LOG_WARNING, "invalid argument %d\n", needmore);
    return extension_match_core(pattern, data, needmore);
}

References ast_log, ast_exten::data, E_CANMATCH, E_MATCHMORE, extension_match_core(), and LOG_WARNING.

Referenced by lua_find_extension(), and realtime_switch_common().

ast_extension_cmp()

int ast_extension_cmp	(	const char *	a,
		const char *	b
	)

Determine if one extension should match before another.

Parameters

a	extension to compare with b
b	extension to compare with a

Checks whether or extension a should match before extension b

Return values

0	if the two extensions have equal matching priority
1	on a > b
-1	on a < b

Definition at line 2212 of file pbx.c.

{
    int cmp;
 
    cmp = ext_cmp(a, b);
    if (cmp < 0) {
        return -1;
    }
    if (cmp > 0) {
        return 1;
    }
    return 0;
}

References a, b, and ext_cmp().

Referenced by lua_extension_cmp().

ast_extension_match()

static int ast_extension_match	(	const char *	pattern,
		const char *	extension
	)

Determine if a given extension matches a given pattern (in NXX format)

Parameters

pattern	pattern to match
extension	extension to check against the pattern.

Checks whether or not the given extension matches the given pattern.

Return values

1	on match
0	on failure

Definition at line 4293 of file extconf.c.

{
    return extension_match_core(pattern, data, E_MATCH);
}

References ast_context::data, E_MATCH, and extension_match_core().

Referenced by ast_ignore_pattern(), do_say(), find_matching_priority(), load_module(), loopback_canmatch(), loopback_exists(), loopback_matchmore(), lua_find_extension(), manager_show_dialplan_helper(), matchcid(), realtime_switch_common(), reload(), and show_dialplan_helper().

ast_extension_patmatch()

int ast_extension_patmatch	(	const char *	pattern,
		const char *	data
	)

ast_extension_state()

int ast_extension_state	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten
	)

Uses hint and devicestate callback to get the state of an extension.

Parameters

c	this is not important
context	which context to look in
exten	which extension to get state

Returns

extension state as defined in the ast_extension_states enum

Uses hint and devicestate callback to get the state of an extension.

Definition at line 3191 of file pbx.c.

{
    return internal_extension_state_extended(c, context, exten, NULL);
}

References c, voicemailpwcheck::context, ast_exten::exten, internal_extension_state_extended(), and NULL.

Referenced by action_extensionstate(), extstate_read(), and get_queue_member_status().

ast_extension_state2str()

const char * ast_extension_state2str

(

int

extension_state

)

Return string representation of the state of an extension.

Parameters

extension_state

is the numerical state delivered by ast_extension_state

Returns

the state of an extension as string

Return string representation of the state of an extension.

Definition at line 3147 of file pbx.c.

{
    int i;
 
    for (i = 0; (i < ARRAY_LEN(extension_states)); i++) {
        if (extension_states[i].extension_state == extension_state)
            return extension_states[i].text;
    }
    return "Unknown";
}

References ARRAY_LEN, extension_states, and cfextension_states::text.

Referenced by action_extensionstate(), action_extensionstatelist(), AST_TEST_DEFINE(), exten_state_publisher_state_cb(), handle_show_hint(), handle_show_hints(), manager_state_cb(), and to_ami().

ast_extension_state_add()

int ast_extension_state_add	(	const char *	context,
		const char *	exten,
		ast_state_cb_type	change_cb,
		void *	data
	)

Add watcher for extension states.

Parameters

context	which context to look in
exten	which extension to get state
change_cb	callback to call if state changed
data	to pass to callback

Note

If context and exten are NULL then the added watcher is global. The change_cb is called for every extension's state change.

The change_cb is called if the state of an extension is changed.

Return values

-1	on failure
0	Global watcher added successfully
ID	on success

Definition at line 3844 of file pbx.c.

{
    return extension_state_add_destroy(context, exten, change_cb, NULL, data, 0);
}

References voicemailpwcheck::context, ast_exten::data, ast_exten::exten, extension_state_add_destroy(), and NULL.

Referenced by __init_manager(), create_queue_member(), and publisher_start().

ast_extension_state_add_destroy()

int ast_extension_state_add_destroy	(	const char *	context,
		const char *	exten,
		ast_state_cb_type	change_cb,
		ast_state_cb_destroy_type	destroy_cb,
		void *	data
	)

Add watcher for extension states with destructor.

Since

1.8.9

10.1.0

Parameters

context	which context to look in
exten	which extension to get state
change_cb	callback to call if state changed
destroy_cb	callback to call when the watcher is destroyed.
data	to pass to callbacks

Note

If context and exten are NULL then the added watcher is global. The change_cb is called for every extension's state change.

The change_cb is called if the state of an extension is changed.

The destroy_cb is called when the watcher is deleted so the watcher can release any associated resources.

Return values

-1	on failure
0	Global watcher added successfully
ID	on success

Definition at line 3838 of file pbx.c.

{
    return extension_state_add_destroy(context, exten, change_cb, destroy_cb, data, 0);
}

References voicemailpwcheck::context, ast_exten::data, ast_exten::exten, and extension_state_add_destroy().

ast_extension_state_add_destroy_extended()

int ast_extension_state_add_destroy_extended	(	const char *	context,
		const char *	exten,
		ast_state_cb_type	change_cb,
		ast_state_cb_destroy_type	destroy_cb,
		void *	data
	)

Add watcher for extended extension states with destructor.

Since

11

Parameters

context	which context to look in
exten	which extension to get state
change_cb	callback to call if state changed
destroy_cb	callback to call when the watcher is destroyed.
data	to pass to callbacks

Note

If context and exten are NULL then the added watcher is global. The change_cb is called for every extension's state change.

The change_cb is called if the state of an extension is changed. The extended state is passed to the callback in the device_state_info member of ast_state_cb_info.

The destroy_cb is called when the watcher is deleted so the watcher can release any associated resources.

Return values

-1	on failure
0	Global watcher added successfully
ID	on success

Definition at line 3850 of file pbx.c.

{
    return extension_state_add_destroy(context, exten, change_cb, destroy_cb, data, 1);
}

References voicemailpwcheck::context, ast_exten::data, ast_exten::exten, and extension_state_add_destroy().

Referenced by subscription_established().

ast_extension_state_add_extended()

int ast_extension_state_add_extended	(	const char *	context,
		const char *	exten,
		ast_state_cb_type	change_cb,
		void *	data
	)

Add watcher for extended extension states.

Since

11

Parameters

context	which context to look in
exten	which extension to get state
change_cb	callback to call if state changed
data	to pass to callback

Note

If context and exten are NULL then the added watcher is global. The change_cb is called for every extension's state change.

The change_cb is called if the state of an extension is changed. The extended state is passed to the callback in the device_state_info member of ast_state_cb_info.

Return values

-1	on failure
0	Global watcher added successfully
ID	on success

Definition at line 3856 of file pbx.c.

{
    return extension_state_add_destroy(context, exten, change_cb, NULL, data, 1);
}

References voicemailpwcheck::context, ast_exten::data, ast_exten::exten, extension_state_add_destroy(), and NULL.

ast_extension_state_del()

int ast_extension_state_del	(	int	id,
		ast_state_cb_type	change_cb
	)

Deletes a state change watcher by ID.

Parameters

id	of the state watcher to delete (0 for global watcher)
change_cb	callback to call if state changed (Used if id == 0 (global))

Return values

0	success
-1	failure

Definition at line 3877 of file pbx.c.

{
    struct ast_state_cb *p_cur;
    int ret = -1;
 
    if (!id) {  /* id == 0 is a callback without extension */
        if (!change_cb) {
            return ret;
        }
        p_cur = ao2_find(statecbs, change_cb, OBJ_UNLINK);
        if (p_cur) {
            ret = 0;
            ao2_ref(p_cur, -1);
        }
    } else { /* callback with extension, find the callback based on ID */
        struct ast_hint *hint;
 
        ao2_lock(hints);/* Locked to hold off ast_merge_contexts_and_delete */
        hint = ao2_callback(hints, 0, find_hint_by_cb_id, &id);
        if (hint) {
            p_cur = ao2_find(hint->callbacks, &id, OBJ_UNLINK);
            if (p_cur) {
                ret = 0;
                ao2_ref(p_cur, -1);
            }
            ao2_ref(hint, -1);
        }
        ao2_unlock(hints);
    }
 
    return ret;
}

References ao2_callback, ao2_find, ao2_lock, ao2_ref, ao2_unlock, ast_hint::callbacks, ast_state_cb::change_cb, find_hint_by_cb_id(), OBJ_UNLINK, and statecbs.

Referenced by destroy_queue_member_cb(), subscription_shutdown(), and unload_module().

ast_extension_state_extended()

int ast_extension_state_extended	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten,
		struct ao2_container **	device_state_info
	)

Uses hint and devicestate callback to get the extended state of an extension.

Since

11

Parameters

	c	this is not important
	context	which context to look in
	exten	which extension to get state
[out]	device_state_info	ptr to an ao2_container with extended state info, must be unref'd after use.

Returns

extension state as defined in the ast_extension_states enum

Uses hint and devicestate callback to get the extended state of an extension.

Definition at line 3197 of file pbx.c.

{
    struct ao2_container *container = NULL;
    int ret;
 
    if (device_state_info) {
        container = alloc_device_state_info();
    }
 
    ret = internal_extension_state_extended(c, context, exten, container);
    if (ret < 0 && container) {
        ao2_ref(container, -1);
        container = NULL;
    }
 
    if (device_state_info) {
        get_device_state_causing_channels(container);
        *device_state_info = container;
    }
 
    return ret;
}

References alloc_device_state_info(), ao2_ref, c, container, voicemailpwcheck::context, get_device_state_causing_channels(), internal_extension_state_extended(), and NULL.

Referenced by exten_state_data_alloc().

ast_findlabel_extension()

int ast_findlabel_extension	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten,
		const char *	label,
		const char *	callerid
	)

Find the priority of an extension that has the specified label.

Parameters

c	this is not important
context	which context to look in
exten	which extension to search for
label	label of the action within the extension to match to priority
callerid	callerid to search for

Note

It is possible for autoservice to be started and stopped on c during this function call, it is important that c is not locked prior to calling this. Otherwise a deadlock may occur

Return values

the	priority which matches the given label in the extension
-1	if not found.

Definition at line 4201 of file pbx.c.

{
    return pbx_extension_helper(c, NULL, context, exten, 0, label, callerid, E_FINDLABEL, 0, 0);
}

References c, voicemailpwcheck::context, E_FINDLABEL, ast_exten::exten, ast_exten::label, NULL, and pbx_extension_helper().

Referenced by action_originate(), action_redirect(), ari_channels_handle_originate_with_id(), ast_ari_channels_continue_in_dialplan(), handle_gosub(), handle_setpriority(), isexten_function_read(), and pbx_parse_location().

ast_findlabel_extension2()

static int ast_findlabel_extension2	(	struct ast_channel *	c,
		struct ast_context *	con,
		const char *	exten,
		const char *	label,
		const char *	callerid
	)

Find the priority of an extension that has the specified label.

Note

It is possible for autoservice to be started and stopped on c during this function call, it is important that c is not locked prior to calling this. Otherwise a deadlock may occur

This function is the same as ast_findlabel_extension, except that it accepts a pointer to an ast_context structure to specify the context instead of the name of the context. Otherwise, the functions behave the same.

Definition at line 4973 of file extconf.c.

{
    return pbx_extension_helper(c, con, NULL, exten, 0, label, callerid, E_FINDLABEL);
}

References c, E_FINDLABEL, ast_exten::exten, ast_exten::label, NULL, and pbx_extension_helper().

Referenced by pbx_load_config().

ast_func_read()

int ast_func_read	(	struct ast_channel *	chan,
		const char *	function,
		char *	workspace,
		size_t	len
	)

executes a read operation on a function

Parameters

chan	Channel to execute on
function	Data containing the function call string (will be modified)
workspace	A pointer to safe memory to use for a return value
len	the number of bytes in workspace

This application executes a function in read mode on a given channel.

Return values

0	success
non-zero	failure

Definition at line 598 of file pbx_functions.c.

{
    char *copy = ast_strdupa(function);
    char *args = func_args(copy);
    struct ast_custom_function *acfptr = ast_custom_function_find(copy);
    int res;
    struct ast_module_user *u = NULL;
 
    if (acfptr == NULL) {
        ast_log(LOG_ERROR, "Function %s not registered\n", copy);
    } else if (!acfptr->read && !acfptr->read2) {
        ast_log(LOG_ERROR, "Function %s cannot be read\n", copy);
    } else if (!is_read_allowed(acfptr)) {
        ast_log(LOG_ERROR, "Dangerous function %s read blocked\n", copy);
    } else if (acfptr->read) {
        if (acfptr->mod) {
            u = __ast_module_user_add(acfptr->mod, chan);
        }
        res = acfptr->read(chan, copy, args, workspace, len);
        if (acfptr->mod && u) {
            __ast_module_user_remove(acfptr->mod, u);
        }
 
        return res;
    } else {
        struct ast_str *str = ast_str_create(16);
 
        if (acfptr->mod) {
            u = __ast_module_user_add(acfptr->mod, chan);
        }
        res = acfptr->read2(chan, copy, args, &str, 0);
        if (acfptr->mod && u) {
            __ast_module_user_remove(acfptr->mod, u);
        }
        ast_copy_string(workspace, ast_str_buffer(str), len > ast_str_size(str) ? ast_str_size(str) : len);
        ast_free(str);
 
        return res;
    }
 
    return -1;
}

References __ast_module_user_add(), __ast_module_user_remove(), args, ast_copy_string(), ast_custom_function_find(), ast_free, ast_log, ast_str_buffer(), ast_str_create, ast_str_size(), ast_strdupa, ast_module_user::chan, copy(), func_args(), is_read_allowed(), len(), LOG_ERROR, ast_custom_function::mod, NULL, ast_custom_function::read, ast_custom_function::read2, and str.

Referenced by action_getvar(), assign_uuid(), fetch_access_token(), fetch_google_access_token(), generate_status(), handle_eval_function(), handle_getvariable(), lua_get_variable_value(), and pbx_substitute_variables_helper_full_location().

ast_func_read2()

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

Parameters

chan	Channel to execute on
function	Data containing the function call string (will be modified)
str	A dynamic string buffer into which to place the result.
maxlen	<0 if the dynamic buffer should not grow; >0 if the dynamic buffer should be limited to that number of bytes; 0 if the dynamic buffer has no upper limit

This application executes a function in read mode on a given channel.

Return values

0	success
non-zero	failure

Definition at line 641 of file pbx_functions.c.

{
    char *copy = ast_strdupa(function);
    char *args = func_args(copy);
    struct ast_custom_function *acfptr = ast_custom_function_find(copy);
    int res;
    struct ast_module_user *u = NULL;
 
    if (acfptr == NULL) {
        ast_log(LOG_ERROR, "Function %s not registered\n", copy);
    } else if (!acfptr->read && !acfptr->read2) {
        ast_log(LOG_ERROR, "Function %s cannot be read\n", copy);
    } else if (!is_read_allowed(acfptr)) {
        ast_log(LOG_ERROR, "Dangerous function %s read blocked\n", copy);
    } else {
        if (acfptr->mod) {
            u = __ast_module_user_add(acfptr->mod, chan);
        }
        ast_str_reset(*str);
        if (acfptr->read2) {
            /* ast_str enabled */
            res = acfptr->read2(chan, copy, args, str, maxlen);
        } else {
            /* Legacy function pointer, allocate buffer for result */
            int maxsize = ast_str_size(*str);
 
            if (maxlen > -1) {
                if (maxlen == 0) {
                    if (acfptr->read_max) {
                        maxsize = acfptr->read_max;
                    } else {
                        maxsize = VAR_BUF_SIZE;
                    }
                } else {
                    maxsize = maxlen;
                }
                ast_str_make_space(str, maxsize);
            }
            res = acfptr->read(chan, copy, args, ast_str_buffer(*str), maxsize);
            ast_str_update(*str); /* Manually set the string length */
        }
        if (acfptr->mod && u) {
            __ast_module_user_remove(acfptr->mod, u);
        }
 
        return res;
    }
 
    return -1;
}

References __ast_module_user_add(), __ast_module_user_remove(), args, ast_custom_function_find(), ast_log, ast_str_buffer(), ast_str_make_space, ast_str_reset(), ast_str_size(), ast_str_update(), ast_strdupa, ast_module_user::chan, copy(), func_args(), is_read_allowed(), LOG_ERROR, maxsize, ast_custom_function::mod, NULL, ast_custom_function::read, ast_custom_function::read2, ast_custom_function::read_max, str, and VAR_BUF_SIZE.

Referenced by ast_ari_channels_get_channel_var(), ast_str_substitute_variables_full2(), AST_TEST_DEFINE(), and channel_get_external_vars().

ast_func_write()

int ast_func_write	(	struct ast_channel *	chan,
		const char *	function,
		const char *	value
	)

executes a write operation on a function

Parameters

chan	Channel to execute on
function	Data containing the function call string (will be modified)
value	A value parameter to pass for writing

This application executes a function in write mode on a given channel.

Return values

0	success
non-zero	failure

Definition at line 692 of file pbx_functions.c.

{
    char *copy = ast_strdupa(function);
    char *args = func_args(copy);
    struct ast_custom_function *acfptr = ast_custom_function_find(copy);
 
    if (acfptr == NULL) {
        ast_log(LOG_ERROR, "Function %s not registered\n", copy);
    } else if (!acfptr->write) {
        ast_log(LOG_ERROR, "Function %s cannot be written to\n", copy);
    } else if (!is_write_allowed(acfptr)) {
        ast_log(LOG_ERROR, "Dangerous function %s write blocked\n", copy);
    } else {
        int res;
        struct ast_module_user *u = NULL;
 
        if (acfptr->mod) {
            u = __ast_module_user_add(acfptr->mod, chan);
        }
        res = acfptr->write(chan, copy, args, value);
        if (acfptr->mod && u) {
            __ast_module_user_remove(acfptr->mod, u);
        }
 
        return res;
    }
 
    return -1;
}

References __ast_module_user_add(), __ast_module_user_remove(), args, ast_custom_function_find(), ast_log, ast_strdupa, ast_module_user::chan, copy(), func_args(), is_write_allowed(), LOG_ERROR, ast_custom_function::mod, NULL, value, and ast_custom_function::write.

Referenced by ast_channel_hangupcause_hash_set(), AST_TEST_DEFINE(), chanavail_exec(), conf_run(), confbridge_exec(), fetch_google_access_token(), pbx_builtin_pushvar_helper(), pbx_builtin_setvar_helper(), setup_profile_bridge(), setup_profile_caller(), and setup_profile_paged().

ast_get_context_name()

static const char * ast_get_context_name

(

struct ast_context *

con

)

Definition at line 421 of file ael_main.c.

{
    return con ? con->name : NULL;
}

References ast_context::name, and NULL.

Referenced by add_extension(), ast_add_hint(), ast_change_hint(), ast_compile_ael2(), ast_context_add_include2(), ast_context_add_switch2(), ast_context_remove_include2(), ast_context_remove_switch2(), ast_context_verify_includes(), ast_remove_hint(), complete_dialplan_add_extension(), complete_dialplan_add_ignorepat(), complete_dialplan_add_include(), complete_dialplan_remove_context(), complete_dialplan_remove_extension(), complete_dialplan_remove_ignorepat(), complete_dialplan_remove_include(), complete_show_dialplan_context(), context_included(), context_merge_incls_swits_igps_other_registrars(), device_state_notify_callbacks(), dundi_precache_full(), extension_is_compatible(), find_matching_endif(), find_matching_endwhile(), find_matching_priority(), handle_cli_dialplan_save(), handle_show_hint(), handle_show_hints(), manager_show_dialplan_helper(), presence_state_notify_callbacks(), print_hintdevices_key(), print_hints_key(), show_debug_helper(), and show_dialplan_helper().

ast_get_context_registrar()

const char * ast_get_context_registrar

(

struct ast_context *

c

)

Definition at line 8552 of file pbx.c.

{
    return c ? c->registrar : NULL;
}

References c, and NULL.

Referenced by handle_cli_dialplan_save(), show_debug_helper(), and show_dialplan_helper().

ast_get_extension_app()

const char * ast_get_extension_app

(

struct ast_exten *

e

)

Definition at line 8582 of file pbx.c.

{
    return e ? e->app : NULL;
}

References ast_exten::app, and NULL.

Referenced by add_extension(), ast_add_hint(), ast_change_hint(), ast_extension_state2(), ast_get_hint(), ast_str_get_hint(), device_state_notify_callbacks(), extension_is_compatible(), extension_presence_state_helper(), find_matching_endif(), find_matching_endwhile(), handle_cli_dialplan_save(), handle_show_hint(), handle_show_hints(), manager_show_dialplan_helper(), parking_is_exten_park(), presence_state_notify_callbacks(), and print_ext().

ast_get_extension_app_data()

void * ast_get_extension_app_data

(

struct ast_exten *

e

)

Definition at line 8587 of file pbx.c.

{
    return e ? e->data : NULL;
}

References ast_exten::data, and NULL.

Referenced by add_extension(), ast_get_extension_data(), ast_get_hint(), ast_str_get_hint(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), parking_blind_transfer_park(), and print_ext().

ast_get_extension_cidmatch()

const char * ast_get_extension_cidmatch

(

struct ast_exten *

e

)

Definition at line 8577 of file pbx.c.

{
    return e ? e->cidmatch_display : NULL;
}

References ast_exten::cidmatch_display, and NULL.

Referenced by complete_dialplan_remove_extension(), find_matching_priority(), handle_cli_dialplan_save(), and test_exten().

ast_get_extension_context()

struct ast_context * ast_get_extension_context

(

struct ast_exten *

exten

)

Definition at line 8529 of file pbx.c.

{
    return exten ? exten->parent : NULL;
}

References NULL, and ast_exten::parent.

Referenced by ast_add_hint(), ast_change_hint(), ast_remove_hint(), device_state_notify_callbacks(), extension_is_compatible(), handle_show_hint(), handle_show_hints(), presence_state_notify_callbacks(), print_hintdevices_key(), and print_hints_key().

ast_get_extension_data()

int ast_get_extension_data	(	char *	buf,
		int	bufsize,
		struct ast_channel *	c,
		const char *	context,
		const char *	exten,
		int	priority
	)

Fill a string buffer with the data at a dialplan extension.

Parameters

buf	String buffer
bufsize	Size of buf
c	Channel
context	Dialplan context
exten	Dialplan extension
priority	Dialplan priority

Return values

-1	Failed to obtain extension data
0	Successfully obtained extension data

Definition at line 8592 of file pbx.c.

{
    struct ast_exten *e;
    struct pbx_find_info q = { .stacklen = 0 }; /* the rest is set in pbx_find_context */
    ast_rdlock_contexts();
    e = pbx_find_extension(c, NULL, &q, context, exten, priority, NULL, "", E_MATCH);
    if (e) {
        if (buf) {
            const char *tmp = ast_get_extension_app_data(e);
            if (tmp) {
                ast_copy_string(buf, tmp, bufsize);
            }
        }
        ast_unlock_contexts();
        return 0;
    }
    ast_unlock_contexts();
    return -1;
}

References ast_copy_string(), ast_get_extension_app_data(), ast_rdlock_contexts(), ast_unlock_contexts(), buf, c, voicemailpwcheck::context, E_MATCH, NULL, pbx_find_extension(), priority, and pbx_find_info::stacklen.

Referenced by eval_exten_read().

ast_get_extension_label()

const char * ast_get_extension_label

(

struct ast_exten *

e

)

Definition at line 8539 of file pbx.c.

{
    return exten ? exten->label : NULL;
}

References ast_exten::label, and NULL.

Referenced by handle_cli_dialplan_save(), manager_show_dialplan_helper(), and show_dialplan_helper().

ast_get_extension_matchcid()

int ast_get_extension_matchcid

(

struct ast_exten *

e

)

Definition at line 8572 of file pbx.c.

{
    return e ? e->matchcid : 0;
}

References ast_exten::matchcid.

Referenced by complete_dialplan_remove_extension(), find_matching_priority(), and handle_cli_dialplan_save().

ast_get_extension_name()

const char * ast_get_extension_name

(

struct ast_exten *

exten

)

Definition at line 8534 of file pbx.c.

{
    return exten ? exten->name : NULL;
}

References ast_exten::name, and NULL.

Referenced by ast_add_hint(), ast_change_hint(), ast_remove_hint(), complete_core_show_hint(), complete_dialplan_remove_extension(), device_state_notify_callbacks(), dundi_precache_full(), extension_is_compatible(), find_matching_priority(), handle_cli_dialplan_save(), handle_show_hint(), handle_show_hints(), hint_hash(), manager_show_dialplan_helper(), presence_state_notify_callbacks(), print_hintdevices_key(), print_hints_key(), show_dialplan_helper(), and test_exten().

ast_get_extension_priority()

int ast_get_extension_priority

(

struct ast_exten *

exten

)

Definition at line 8544 of file pbx.c.

{
    return exten ? exten->priority : -1;
}

References ast_exten::priority.

Referenced by complete_dialplan_remove_extension(), find_matching_priority(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), and print_ext().

ast_get_extension_registrar()

const char * ast_get_extension_registrar

(

struct ast_exten *

e

)

Definition at line 8557 of file pbx.c.

{
    return e ? e->registrar : NULL;
}

References NULL, and ast_exten::registrar.

Referenced by extension_is_compatible(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), parking_duration_callback(), parking_lot_cfg_create_extensions(), and show_dialplan_helper_extension_output().

ast_get_extension_registrar_file()

const char * ast_get_extension_registrar_file

(

struct ast_exten *

e

)

Get name of configuration file used by registrar to register this extension.

Return values

NULL	if registrar did not indicate config file when registering the extension
name	of the file used to register the extension

Definition at line 8562 of file pbx.c.

{
    return e ? e->registrar_file : NULL;
}

References NULL, and ast_exten::registrar_file.

Referenced by show_dialplan_helper_extension_output().

ast_get_extension_registrar_line()

int ast_get_extension_registrar_line

(

struct ast_exten *

e

)

Get line number of configuration file used by registrar to register this extension.

Return values

0	if the line wasn't indicated when the extension was registered
positive	integer indicating what line in the config file was responsible for registering the extension.

Definition at line 8567 of file pbx.c.

{
    return e ? e->registrar_line : 0;
}

References ast_exten::registrar_line.

Referenced by show_dialplan_helper_extension_output().

ast_get_hint()

int ast_get_hint	(	char *	hint,
		int	hintsize,
		char *	name,
		int	namesize,
		struct ast_channel *	c,
		const char *	context,
		const char *	exten
	)

If an extension hint exists, return non-zero.

Parameters

hint	buffer for hint
hintsize	size of hint buffer, in bytes
name	buffer for name portion of hint
namesize	size of name buffer
c	Channel from which to return the hint. This is only important when the hint or name contains an expression to be expanded.
context	which context to look in
exten	which extension to search for

Returns

If an extension within the given context with the priority PRIORITY_HINT is found, a non zero value will be returned. Otherwise, 0 is returned.

If an extension hint exists, return non-zero.

Definition at line 4158 of file pbx.c.

{
    struct ast_exten *e = ast_hint_extension(c, context, exten);
 
    if (e) {
        if (hint)
            ast_copy_string(hint, ast_get_extension_app(e), hintsize);
        if (name) {
            const char *tmp = ast_get_extension_app_data(e);
            if (tmp)
                ast_copy_string(name, tmp, namesize);
        }
        return -1;
    }
    return 0;
}

References ast_copy_string(), ast_get_extension_app(), ast_get_extension_app_data(), ast_hint_extension(), c, voicemailpwcheck::context, ast_exten::exten, and name.

Referenced by action_extensionstate(), device_state_cb(), get_cid_name(), get_resource_display_name(), hint_read(), and manager_state_cb().

ast_get_ignorepat_name()

const char * ast_get_ignorepat_name

(

const struct ast_ignorepat *

ip

)

Definition at line 42 of file pbx_ignorepat.c.

{
    return ip ? ip->pattern : NULL;
}

References NULL, and ast_ignorepat::pattern.

Referenced by ast_context_add_ignorepat2(), ast_context_remove_ignorepat2(), ast_ignore_pattern(), complete_dialplan_remove_ignorepat(), context_merge_incls_swits_igps_other_registrars(), handle_cli_dialplan_save(), lookup_c_ip(), manager_show_dialplan_helper(), and show_dialplan_helper().

ast_get_ignorepat_registrar()

const char * ast_get_ignorepat_registrar

(

const struct ast_ignorepat *

ip

)

Definition at line 47 of file pbx_ignorepat.c.

{
    return ip ? ip->registrar : NULL;
}

References NULL, and ast_ignorepat::registrar.

Referenced by __ast_context_destroy(), ast_context_remove_ignorepat2(), context_merge_incls_swits_igps_other_registrars(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), and show_dialplan_helper().

ast_get_include_name()

const char * ast_get_include_name

(

const struct ast_include *

include

)

Definition at line 50 of file pbx_include.c.

{
    return inc ? inc->name : NULL;
}

References ast_include::name, and NULL.

Referenced by ast_context_add_include2(), ast_context_remove_include2(), complete_dialplan_remove_include(), context_included(), context_merge_incls_swits_igps_other_registrars(), find_matching_priority(), handle_cli_dialplan_save(), lookup_ci(), manager_show_dialplan_helper(), and show_dialplan_helper().

ast_get_include_registrar()

const char * ast_get_include_registrar

(

const struct ast_include *

i

)

Definition at line 60 of file pbx_include.c.

{
    return inc ? inc->registrar : NULL;
}

References NULL, and ast_include::registrar.

Referenced by __ast_context_destroy(), ast_context_remove_include2(), context_merge_incls_swits_igps_other_registrars(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), and show_dialplan_helper().

ast_get_switch_data()

const char * ast_get_switch_data

(

const struct ast_sw *

sw

)

Definition at line 53 of file pbx_sw.c.

{
    return sw ? sw->data : NULL;
}

References ast_sw::data, and NULL.

Referenced by ast_context_add_switch2(), ast_context_remove_switch2(), context_merge_incls_swits_igps_other_registrars(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), pbx_find_extension(), and show_dialplan_helper().

ast_get_switch_eval()

int ast_get_switch_eval

(

const struct ast_sw *

sw

)

Definition at line 58 of file pbx_sw.c.

{
    return sw->eval;
}

References ast_sw::eval.

Referenced by context_merge_incls_swits_igps_other_registrars(), and pbx_find_extension().

ast_get_switch_name()

const char * ast_get_switch_name

(

const struct ast_sw *

sw

)

Definition at line 48 of file pbx_sw.c.

{
    return sw ? sw->name : NULL;
}

References ast_sw::name, and NULL.

Referenced by ast_context_add_switch2(), ast_context_remove_switch2(), context_merge_incls_swits_igps_other_registrars(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), pbx_find_extension(), and show_dialplan_helper().

ast_get_switch_registrar()

const char * ast_get_switch_registrar

(

const struct ast_sw *

sw

)

Definition at line 63 of file pbx_sw.c.

{
    return sw ? sw->registrar : NULL;
}

References NULL, and ast_sw::registrar.

Referenced by __ast_context_destroy(), ast_context_remove_switch2(), context_merge_incls_swits_igps_other_registrars(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), and show_dialplan_helper().

ast_goto_if_exists()

int ast_goto_if_exists	(	struct ast_channel *	chan,
		const char *	context,
		const char *	exten,
		int	priority
	)

Note

This function will handle locking the channel as needed.

Definition at line 8806 of file pbx.c.

{
    return __ast_goto_if_exists(chan, context, exten, priority, 0);
}

References __ast_goto_if_exists(), voicemailpwcheck::context, ast_channel::exten, and priority.

Referenced by ast_bridge_setup_after_goto(), background_detect_exec(), channel_spy(), common_exec(), conf_run(), goto_exten(), onedigit_goto(), select_entry(), valid_exit(), vm_execmain(), and vmauthenticate().

ast_hashtab_compare_contexts()

int ast_hashtab_compare_contexts	(	const void *	ah_a,
		const void *	ah_b
	)

hashtable functions for contexts

Definition at line 589 of file ael_main.c.

{
    return 0;
}

References bc, and ast_context::name.

Referenced by ast_context_find_or_create(), lua_register_hints(), lua_register_switches(), and pbx_load_module().

ast_hashtab_hash_contexts()

unsigned int ast_hashtab_hash_contexts

(

const void *

obj

)

Definition at line 596 of file ael_main.c.

{
    return 0;
}

References ast_hashtab_hash_string(), and ast_context::name.

Referenced by ast_context_find_or_create(), lua_register_hints(), lua_register_switches(), and pbx_load_module().

ast_hint_presence_state()

int ast_hint_presence_state	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten,
		char **	subtype,
		char **	message
	)

Uses hint and presence state callback to get the presence state of an extension.

Parameters

	c	this is not important
	context	which context to look in
	exten	which extension to get state
[out]	subtype	Further information regarding the presence returned
[out]	message	Custom message further describing current presence

Note

The subtype and message are dynamically allocated and must be freed by the caller of this function.

Returns

returns the presence state value.

Definition at line 3247 of file pbx.c.

{
    struct ast_exten *e;
 
    if (!(e = ast_hint_extension(c, context, exten))) {  /* Do we have a hint for this extension ? */
        return -1;                   /* No hint, return -1 */
    }
 
    if (e->exten[0] == '_') {
        /* Create this hint on-the-fly */
        ao2_lock(hints);
        ast_add_extension(e->parent->name, 0, exten, e->priority, e->label,
            e->matchcid ? e->cidmatch : NULL, e->app, ast_strdup(e->data), ast_free_ptr,
            e->registrar);
        ao2_unlock(hints);
        if (!(e = ast_hint_extension(c, context, exten))) {
            /* Improbable, but not impossible */
            return -1;
        }
    }
 
    return extension_presence_state_helper(e, subtype, message);
}

References ao2_lock, ao2_unlock, ast_exten::app, ast_add_extension(), ast_free_ptr(), ast_hint_extension(), ast_strdup, c, ast_exten::cidmatch, voicemailpwcheck::context, ast_exten::data, ast_exten::exten, extension_presence_state_helper(), ast_exten::label, ast_exten::matchcid, ast_context::name, NULL, ast_exten::parent, ast_exten::priority, and ast_exten::registrar.

Referenced by exten_state_data_alloc().

ast_ignore_pattern()

int ast_ignore_pattern	(	const char *	context,
		const char *	pattern
	)

Checks to see if a number should be ignored.

Parameters

context	context to search within
pattern	to check whether it should be ignored or not

Check if a number should be ignored with respect to dialtone cancellation.

Return values

0	if the pattern should not be ignored
non-zero	if the pattern should be ignored

Definition at line 6900 of file pbx.c.

{
    int ret = 0;
    struct ast_context *con;
 
    ast_rdlock_contexts();
    con = ast_context_find(context);
    if (con) {
        int idx;
 
        for (idx = 0; idx < ast_context_ignorepats_count(con); idx++) {
            const struct ast_ignorepat *pat = ast_context_ignorepats_get(con, idx);
 
            if (ast_extension_match(ast_get_ignorepat_name(pat), pattern)) {
                ret = 1;
                break;
            }
        }
    }
    ast_unlock_contexts();
 
    return ret;
}

References ast_context_find(), ast_context_ignorepats_count(), ast_context_ignorepats_get(), ast_extension_match(), ast_get_ignorepat_name(), ast_rdlock_contexts(), ast_unlock_contexts(), voicemailpwcheck::context, and ast_ignorepat::pattern.

Referenced by __analog_ss_thread(), analog_ss_thread(), ast_app_dtget(), disa_exec(), dp_lookup(), and dundi_lookup_local().

ast_matchmore_extension()

int ast_matchmore_extension	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten,
		int	priority,
		const char *	callerid
	)

Looks to see if adding anything to this extension might match something. (exists ^ canmatch)

Parameters

c	not really important XXX
context	context to search within
exten	extension to check
priority	priority of extension path
callerid	callerid of extension being searched for

Note

It is possible for autoservice to be started and stopped on c during this function call, it is important that c is not locked prior to calling this. Otherwise a deadlock may occur

Returns

If "exten" could match a valid extension in this context with some more digits, return non-zero. Does NOT return non-zero if this is an exact-match only. Basically, when this returns 0, no matter what you add to exten, it's not going to be a valid extension anymore

Definition at line 4216 of file pbx.c.

{
    return pbx_extension_helper(c, NULL, context, exten, priority, NULL, callerid, E_MATCHMORE, 0, 0);
}

References c, voicemailpwcheck::context, E_MATCHMORE, ast_exten::exten, NULL, pbx_extension_helper(), and priority.

Referenced by __analog_ss_thread(), __ast_pbx_run(), analog_ss_thread(), ast_app_dtget(), collect_digits(), disa_exec(), dp_lookup(), dundi_lookup_local(), key_dial_page(), loopback_matchmore(), pbx_builtin_background(), and readexten_exec().

ast_merge_contexts_and_delete()

void ast_merge_contexts_and_delete	(	struct ast_context **	extcontexts,
		struct ast_hashtab *	exttable,
		const char *	registrar
	)

Merge the temporary contexts into a global contexts list and delete from the global list the ones that are being added.

Parameters

extcontexts	pointer to the ast_context structure
exttable	pointer to the ast_hashtab structure that contains all the elements in extcontexts
registrar	of the context; if it's set the routine will delete all contexts that belong to that registrar; if NULL only the contexts that are specified in extcontexts

Definition at line 6447 of file pbx.c.

{
    double ft;
    struct ast_context *tmp;
    struct ast_context *oldcontextslist;
    struct ast_hashtab *oldtable;
    struct store_hints hints_stored = AST_LIST_HEAD_NOLOCK_INIT_VALUE;
    struct store_hints hints_removed = AST_LIST_HEAD_NOLOCK_INIT_VALUE;
    struct store_hint *saved_hint;
    struct ast_hint *hint;
    struct ast_exten *exten;
    int length;
    struct ast_state_cb *thiscb;
    struct ast_hashtab_iter *iter;
    struct ao2_iterator i;
    int ctx_count = 0;
    struct timeval begintime;
    struct timeval writelocktime;
    struct timeval endlocktime;
    struct timeval enddeltime;
 
    /*
     * It is very important that this function hold the hints
     * container lock _and_ the conlock during its operation; not
     * only do we need to ensure that the list of contexts and
     * extensions does not change, but also that no hint callbacks
     * (watchers) are added or removed during the merge/delete
     * process
     *
     * In addition, the locks _must_ be taken in this order, because
     * there are already other code paths that use this order
     */
 
    begintime = ast_tvnow();
    ast_mutex_lock(&context_merge_lock);/* Serialize ast_merge_contexts_and_delete */
    ast_wrlock_contexts();
 
    if (!contexts_table) {
        /* Create any autohint contexts */
        context_table_create_autohints(exttable);
 
        /* Well, that's odd. There are no contexts. */
        contexts_table = exttable;
        contexts = *extcontexts;
        ast_unlock_contexts();
        ast_mutex_unlock(&context_merge_lock);
        return;
    }
 
    iter = ast_hashtab_start_traversal(contexts_table);
    while ((tmp = ast_hashtab_next(iter))) {
        ++ctx_count;
        context_merge(extcontexts, exttable, tmp, registrar);
    }
    ast_hashtab_end_traversal(iter);
 
    ao2_lock(hints);
    writelocktime = ast_tvnow();
 
    /* preserve all watchers for hints */
    i = ao2_iterator_init(hints, AO2_ITERATOR_DONTLOCK);
    for (; (hint = ao2_iterator_next(&i)); ao2_ref(hint, -1)) {
        if (ao2_container_count(hint->callbacks)) {
            size_t exten_len;
 
            ao2_lock(hint);
            if (!hint->exten) {
                /* The extension has already been destroyed. (Should never happen here) */
                ao2_unlock(hint);
                continue;
            }
 
            exten_len = strlen(hint->exten->exten) + 1;
            length = exten_len + strlen(hint->exten->parent->name) + 1
                + sizeof(*saved_hint);
            if (!(saved_hint = ast_calloc(1, length))) {
                ao2_unlock(hint);
                continue;
            }
 
            /* This removes all the callbacks from the hint into saved_hint. */
            while ((thiscb = ao2_callback(hint->callbacks, OBJ_UNLINK, NULL, NULL))) {
                AST_LIST_INSERT_TAIL(&saved_hint->callbacks, thiscb, entry);
                /*
                 * We intentionally do not unref thiscb to account for the
                 * non-ao2 reference in saved_hint->callbacks
                 */
            }
 
            saved_hint->laststate = hint->laststate;
            saved_hint->context = saved_hint->data;
            strcpy(saved_hint->data, hint->exten->parent->name);
            saved_hint->exten = saved_hint->data + strlen(saved_hint->context) + 1;
            ast_copy_string(saved_hint->exten, hint->exten->exten, exten_len);
            if (hint->last_presence_subtype) {
                saved_hint->last_presence_subtype = ast_strdup(hint->last_presence_subtype);
            }
            if (hint->last_presence_message) {
                saved_hint->last_presence_message = ast_strdup(hint->last_presence_message);
            }
            saved_hint->last_presence_state = hint->last_presence_state;
            ao2_unlock(hint);
            AST_LIST_INSERT_HEAD(&hints_stored, saved_hint, list);
        }
    }
    ao2_iterator_destroy(&i);
 
    /* save the old table and list */
    oldtable = contexts_table;
    oldcontextslist = contexts;
 
    /* move in the new table and list */
    contexts_table = exttable;
    contexts = *extcontexts;
 
    /*
     * Restore the watchers for hints that can be found; notify
     * those that cannot be restored.
     */
    while ((saved_hint = AST_LIST_REMOVE_HEAD(&hints_stored, list))) {
        struct pbx_find_info q = { .stacklen = 0 };
 
        exten = pbx_find_extension(NULL, NULL, &q, saved_hint->context, saved_hint->exten,
            PRIORITY_HINT, NULL, "", E_MATCH);
        /*
         * If this is a pattern, dynamically create a new extension for this
         * particular match.  Note that this will only happen once for each
         * individual extension, because the pattern will no longer match first.
         */
        if (exten && exten->exten[0] == '_') {
            ast_add_extension_nolock(exten->parent->name, 0, saved_hint->exten,
                PRIORITY_HINT, NULL, 0, exten->app, ast_strdup(exten->data), ast_free_ptr,
                exten->registrar);
            /* rwlocks are not recursive locks */
            exten = ast_hint_extension_nolock(NULL, saved_hint->context,
                saved_hint->exten);
        }
 
        /* Find the hint in the hints container */
        hint = exten ? ao2_find(hints, exten, 0) : NULL;
        if (!hint) {
            /*
             * Notify watchers of this removed hint later when we aren't
             * encumbered by so many locks.
             */
            AST_LIST_INSERT_HEAD(&hints_removed, saved_hint, list);
        } else {
            ao2_lock(hint);
            while ((thiscb = AST_LIST_REMOVE_HEAD(&saved_hint->callbacks, entry))) {
                ao2_link(hint->callbacks, thiscb);
                /* Ref that we added when putting into saved_hint->callbacks */
                ao2_ref(thiscb, -1);
            }
            hint->laststate = saved_hint->laststate;
            hint->last_presence_state = saved_hint->last_presence_state;
            hint->last_presence_subtype = saved_hint->last_presence_subtype;
            hint->last_presence_message = saved_hint->last_presence_message;
            ao2_unlock(hint);
            ao2_ref(hint, -1);
            /*
             * The free of saved_hint->last_presence_subtype and
             * saved_hint->last_presence_message is not necessary here.
             */
            ast_free(saved_hint);
        }
    }
 
    /* Create all applicable autohint contexts */
    context_table_create_autohints(contexts_table);
 
    ao2_unlock(hints);
    ast_unlock_contexts();
 
    /*
     * Notify watchers of all removed hints with the same lock
     * environment as device_state_cb().
     */
    while ((saved_hint = AST_LIST_REMOVE_HEAD(&hints_removed, list))) {
        /* this hint has been removed, notify the watchers */
        while ((thiscb = AST_LIST_REMOVE_HEAD(&saved_hint->callbacks, entry))) {
            execute_state_callback(thiscb->change_cb,
                saved_hint->context,
                saved_hint->exten,
                thiscb->data,
                AST_HINT_UPDATE_DEVICE,
                NULL,
                NULL);
            /* Ref that we added when putting into saved_hint->callbacks */
            ao2_ref(thiscb, -1);
        }
        ast_free(saved_hint->last_presence_subtype);
        ast_free(saved_hint->last_presence_message);
        ast_free(saved_hint);
    }
 
    ast_mutex_unlock(&context_merge_lock);
    endlocktime = ast_tvnow();
 
    /*
     * The old list and hashtab no longer are relevant, delete them
     * while the rest of asterisk is now freely using the new stuff
     * instead.
     */
 
    ast_hashtab_destroy(oldtable, NULL);
 
    for (tmp = oldcontextslist; tmp; ) {
        struct ast_context *next;   /* next starting point */
 
        next = tmp->next;
        __ast_internal_context_destroy(tmp);
        tmp = next;
    }
    enddeltime = ast_tvnow();
 
    ft = ast_tvdiff_us(writelocktime, begintime);
    ft /= 1000000.0;
    ast_verb(5,"Time to scan old dialplan and merge leftovers back into the new: %8.6f sec\n", ft);
 
    ft = ast_tvdiff_us(endlocktime, writelocktime);
    ft /= 1000000.0;
    ast_verb(5,"Time to restore hints and swap in new dialplan: %8.6f sec\n", ft);
 
    ft = ast_tvdiff_us(enddeltime, endlocktime);
    ft /= 1000000.0;
    ast_verb(5,"Time to delete the old dialplan: %8.6f sec\n", ft);
 
    ft = ast_tvdiff_us(enddeltime, begintime);
    ft /= 1000000.0;
    ast_verb(5,"Total time merge_contexts_delete: %8.6f sec\n", ft);
    ast_verb(5, "%s successfully loaded %d contexts (enable debug for details).\n", registrar, ctx_count);
}

References __ast_internal_context_destroy(), ao2_callback, ao2_container_count(), ao2_find, ao2_iterator_destroy(), AO2_ITERATOR_DONTLOCK, ao2_iterator_init(), ao2_iterator_next, ao2_link, ao2_lock, ao2_ref, ao2_unlock, ast_exten::app, ast_add_extension_nolock(), ast_calloc, ast_copy_string(), ast_free, ast_free_ptr(), ast_hashtab_destroy(), ast_hashtab_end_traversal(), ast_hashtab_next(), ast_hashtab_start_traversal, ast_hint_extension_nolock(), AST_HINT_UPDATE_DEVICE, AST_LIST_HEAD_NOLOCK_INIT_VALUE, AST_LIST_INSERT_HEAD, AST_LIST_INSERT_TAIL, AST_LIST_REMOVE_HEAD, ast_mutex_lock, ast_mutex_unlock, ast_strdup, ast_tvdiff_us(), ast_tvnow(), ast_unlock_contexts(), ast_verb, ast_wrlock_contexts(), ast_hint::callbacks, store_hint::callbacks, ast_state_cb::change_cb, store_hint::context, context_merge(), context_merge_lock, context_table_create_autohints(), contexts, contexts_table, ast_exten::data, ast_state_cb::data, E_MATCH, execute_state_callback(), ast_exten::exten, ast_hint::exten, store_hint::exten, ast_hint::last_presence_message, store_hint::last_presence_message, ast_hint::last_presence_state, store_hint::last_presence_state, ast_hint::last_presence_subtype, store_hint::last_presence_subtype, ast_hint::laststate, store_hint::laststate, ast_context::name, ast_context::next, NULL, OBJ_UNLINK, ast_exten::parent, pbx_find_extension(), PRIORITY_HINT, ast_exten::registrar, registrar, and pbx_find_info::stacklen.

Referenced by lua_reload_extensions(), and pbx_load_module().

ast_parseable_goto()

int ast_parseable_goto	(	struct ast_channel *	chan,
		const char *	goto_string
	)

Note

This function will handle locking the channel as needed.

Definition at line 8891 of file pbx.c.

{
    return pbx_parseable_goto(chan, goto_string, 0);
}

References pbx_parseable_goto().

Referenced by _while_exec(), ast_bridge_setup_after_goto(), dial_exec_full(), gosub_exec(), if_helper(), ivr_dispatch(), pbx_builtin_goto(), and while_continue_exec().

ast_pbx_exec_application()

int ast_pbx_exec_application	(	struct ast_channel *	chan,
		const char *	app_name,
		const char *	app_args
	)

Execute an application.

Parameters

chan	channel to execute on
app_name	name of app to execute
app_args	the data passed into the app

This application executes an application by name on a given channel. It is a wrapper around pbx_exec that will perform variable substitution and then execute the application if it exists. If the application is not found, a warning is logged.

Return values

0	success
-1	failure (including application not found)

Definition at line 501 of file pbx_app.c.

{
    int res = -1;
    struct ast_app *app;
 
    app = pbx_findapp(app_name);
    if (!app) {
        ast_log(LOG_WARNING, "Could not find application (%s)\n", app_name);
    } else {
        struct ast_str *substituted_args = NULL;
 
        if (!ast_strlen_zero(app_args) && (substituted_args = ast_str_create(16))) {
            ast_str_substitute_variables(&substituted_args, 0, chan, app_args);
            res = pbx_exec(chan, app, ast_str_buffer(substituted_args));
            ast_free(substituted_args);
        } else {
            if (!ast_strlen_zero(app_args)) {
                ast_log(LOG_WARNING, "Could not substitute application argument variables for %s\n", app_name);
            }
            res = pbx_exec(chan, app, app_args);
        }
        /* Manually make a snapshot now, since pbx_exec won't necessarily get called again immediately. */
        ast_channel_publish_snapshot(chan);
    }
    return res;
}

References app, app_name(), ast_channel_publish_snapshot(), ast_free, ast_log, ast_str_buffer(), ast_str_create, ast_str_substitute_variables(), ast_strlen_zero(), LOG_WARNING, NULL, pbx_exec(), and pbx_findapp().

Referenced by answer_exec_run(), conf_kick_all(), conf_run(), disa_exec(), dundi_exec(), pbx_builtin_execiftime(), run_app_helper(), and snoop_stasis_thread().

ast_pbx_h_exten_run()

void ast_pbx_h_exten_run	(	struct ast_channel *	chan,
		const char *	context
	)

Run the h exten from the given context.

Since

11.0

Parameters

chan	Channel to run the h exten on.
context	Context the h exten is in.

Definition at line 4226 of file pbx.c.

{
    int autoloopflag;
    int found;
    int spawn_error;
 
    ast_channel_lock(chan);
 
    /*
     * Make sure that the channel is marked as hungup since we are
     * going to run the h exten on it.
     */
    ast_softhangup_nolock(chan, AST_SOFTHANGUP_HANGUP_EXEC);
 
    /* Set h exten location */
    if (context != ast_channel_context(chan)) {
        ast_channel_context_set(chan, context);
    }
    ast_channel_exten_set(chan, "h");
    ast_channel_priority_set(chan, 1);
 
    /* Save autoloop flag */
    autoloopflag = ast_test_flag(ast_channel_flags(chan), AST_FLAG_IN_AUTOLOOP);
    ast_set_flag(ast_channel_flags(chan), AST_FLAG_IN_AUTOLOOP);
    ast_channel_unlock(chan);
 
    for (;;) {
        spawn_error = ast_spawn_extension(chan, ast_channel_context(chan),
            ast_channel_exten(chan), ast_channel_priority(chan),
            S_COR(ast_channel_caller(chan)->id.number.valid,
                ast_channel_caller(chan)->id.number.str, NULL), &found, 1);
 
        ast_channel_lock(chan);
        if (spawn_error) {
            /* The code after the loop needs the channel locked. */
            break;
        }
        ast_channel_priority_set(chan, ast_channel_priority(chan) + 1);
        ast_channel_unlock(chan);
    }
    if (found && spawn_error) {
        /* Something bad happened, or a hangup has been requested. */
        ast_debug(1, "Spawn extension (%s,%s,%d) exited non-zero on '%s'\n",
            ast_channel_context(chan), ast_channel_exten(chan),
            ast_channel_priority(chan), ast_channel_name(chan));
        ast_verb(2, "Spawn extension (%s, %s, %d) exited non-zero on '%s'\n",
            ast_channel_context(chan), ast_channel_exten(chan),
            ast_channel_priority(chan), ast_channel_name(chan));
    }
 
    /* An "h" exten has been run, so indicate that one has been run. */
    ast_set_flag(ast_channel_flags(chan), AST_FLAG_BRIDGE_HANGUP_RUN);
 
    /* Restore autoloop flag */
    ast_set2_flag(ast_channel_flags(chan), autoloopflag, AST_FLAG_IN_AUTOLOOP);
    ast_channel_unlock(chan);
}

References ast_channel_caller(), ast_channel_context(), ast_channel_context_set(), ast_channel_exten(), ast_channel_exten_set(), ast_channel_flags(), ast_channel_lock, ast_channel_name(), ast_channel_priority(), ast_channel_priority_set(), ast_channel_unlock, ast_debug, AST_FLAG_BRIDGE_HANGUP_RUN, AST_FLAG_IN_AUTOLOOP, ast_set2_flag, ast_set_flag, AST_SOFTHANGUP_HANGUP_EXEC, ast_softhangup_nolock(), ast_spawn_extension(), ast_test_flag, ast_verb, voicemailpwcheck::context, NULL, and S_COR.

Referenced by __ast_pbx_run(), and ast_bridge_setup_after_goto().

ast_pbx_hangup_handler_destroy()

void ast_pbx_hangup_handler_destroy

(

struct ast_channel *

chan

)

Destroy the hangup handler container on a channel.

Since

11.0

Parameters

chan	Channel to destroy the hangup handler container on.

Definition at line 103 of file pbx_hangup_handler.c.

{
    struct ast_hangup_handler_list *handlers;
    struct ast_hangup_handler *h_handler;
 
    ast_channel_lock(chan);
 
    /* Get rid of each of the hangup handlers on the channel */
    handlers = ast_channel_hangup_handlers(chan);
    while ((h_handler = AST_LIST_REMOVE_HEAD(handlers, node))) {
        ast_free(h_handler);
    }
 
    ast_channel_unlock(chan);
}

References ast_channel_hangup_handlers(), ast_channel_lock, ast_channel_unlock, ast_free, AST_LIST_REMOVE_HEAD, and handlers.

Referenced by ast_channel_destructor(), and ast_dummy_channel_destructor().

ast_pbx_hangup_handler_init()

void ast_pbx_hangup_handler_init

(

struct ast_channel *

chan

)

Init the hangup handler container on a channel.

Since

11.0

Parameters

chan	Channel to init the hangup handler container on.

Definition at line 95 of file pbx_hangup_handler.c.

{
    struct ast_hangup_handler_list *handlers;
 
    handlers = ast_channel_hangup_handlers(chan);
    AST_LIST_HEAD_INIT_NOLOCK(handlers);
}

References ast_channel_hangup_handlers(), AST_LIST_HEAD_INIT_NOLOCK, and handlers.

Referenced by __ast_channel_alloc_ap(), and __ast_dummy_channel_alloc().

ast_pbx_hangup_handler_pop()

int ast_pbx_hangup_handler_pop

(

struct ast_channel *

chan

)

Pop the top of the channel hangup handler stack.

Since

11.0

Parameters

chan	Channel to push the hangup handler onto.

Return values

TRUE	if a handler was popped off of the stack.

Definition at line 119 of file pbx_hangup_handler.c.

{
    struct ast_hangup_handler_list *handlers;
    struct ast_hangup_handler *h_handler;
 
    ast_channel_lock(chan);
    handlers = ast_channel_hangup_handlers(chan);
    h_handler = AST_LIST_REMOVE_HEAD(handlers, node);
    if (h_handler) {
        publish_hangup_handler_message("pop", chan, h_handler->args);
    }
    ast_channel_unlock(chan);
    if (h_handler) {
        ast_free(h_handler);
        return 1;
    }
    return 0;
}

References ast_hangup_handler::args, ast_channel_hangup_handlers(), ast_channel_lock, ast_channel_unlock, ast_free, AST_LIST_REMOVE_HEAD, handlers, and publish_hangup_handler_message().

Referenced by func_channel_write_real().

ast_pbx_hangup_handler_push()

void ast_pbx_hangup_handler_push	(	struct ast_channel *	chan,
		const char *	handler
	)

Push the given hangup handler onto the channel hangup handler stack.

Since

11.0

Parameters

chan	Channel to push the hangup handler onto.
handler	Gosub application parameter string.

Definition at line 138 of file pbx_hangup_handler.c.

{
    struct ast_hangup_handler_list *handlers;
    struct ast_hangup_handler *h_handler;
    const char *expanded_handler;
 
    if (ast_strlen_zero(handler)) {
        return;
    }
 
    expanded_handler = ast_app_expand_sub_args(chan, handler);
    if (!expanded_handler) {
        return;
    }
    h_handler = ast_malloc(sizeof(*h_handler) + 1 + strlen(expanded_handler));
    if (!h_handler) {
        ast_free((char *) expanded_handler);
        return;
    }
    strcpy(h_handler->args, expanded_handler);/* Safe */
    ast_free((char *) expanded_handler);
 
    ast_channel_lock(chan);
 
    handlers = ast_channel_hangup_handlers(chan);
    AST_LIST_INSERT_HEAD(handlers, h_handler, node);
    publish_hangup_handler_message("push", chan, h_handler->args);
    ast_channel_unlock(chan);
}

References ast_hangup_handler::args, ast_app_expand_sub_args(), ast_channel_hangup_handlers(), ast_channel_lock, ast_channel_unlock, ast_free, AST_LIST_INSERT_HEAD, ast_malloc, ast_strlen_zero(), handler(), handlers, and publish_hangup_handler_message().

Referenced by func_channel_write_real().

ast_pbx_hangup_handler_run()

int ast_pbx_hangup_handler_run

(

struct ast_channel *

chan

)

Run all hangup handlers on the channel.

Since

11.0

Parameters

chan	Channel to run the hangup handlers on.

Note

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

Return values

Zero	if no hangup handlers run.
non-zero	if hangup handlers were run.

Definition at line 58 of file pbx_hangup_handler.c.

{
    struct ast_hangup_handler_list *handlers;
    struct ast_hangup_handler *h_handler;
 
    ast_channel_lock(chan);
    handlers = ast_channel_hangup_handlers(chan);
    if (AST_LIST_EMPTY(handlers)) {
        ast_channel_unlock(chan);
        return 0;
    }
 
    /*
     * Make sure that the channel is marked as hungup since we are
     * going to run the hangup handlers on it.
     */
    ast_softhangup_nolock(chan, AST_SOFTHANGUP_HANGUP_EXEC);
 
    for (;;) {
        handlers = ast_channel_hangup_handlers(chan);
        h_handler = AST_LIST_REMOVE_HEAD(handlers, node);
        if (!h_handler) {
            break;
        }
 
        publish_hangup_handler_message("run", chan, h_handler->args);
        ast_channel_unlock(chan);
 
        ast_app_exec_sub(NULL, chan, h_handler->args, 1);
        ast_free(h_handler);
 
        ast_channel_lock(chan);
    }
    ast_channel_unlock(chan);
    return 1;
}

References ast_hangup_handler::args, ast_app_exec_sub(), ast_channel_hangup_handlers(), ast_channel_lock, ast_channel_unlock, ast_free, AST_LIST_EMPTY, AST_LIST_REMOVE_HEAD, AST_SOFTHANGUP_HANGUP_EXEC, ast_softhangup_nolock(), handlers, NULL, and publish_hangup_handler_message().

Referenced by __ast_pbx_run(), and ast_hangup().

ast_pbx_outgoing_app()

int ast_pbx_outgoing_app	(	const char *	type,
		struct ast_format_cap *	cap,
		const char *	addr,
		int	timeout,
		const char *	app,
		const char *	appdata,
		int *	reason,
		int	synchronous,
		const char *	cid_num,
		const char *	cid_name,
		struct ast_variable *	vars,
		const char *	account,
		struct ast_channel **	locked_channel,
		const struct ast_assigned_ids *	assignedids
	)

Synchronously or asynchronously make an outbound call and execute an application on the channel.

Note that when the application stops executing, the channel is hungup.

Parameters

type	The channel technology to create
cap	The format capabilities for the channel
addr	Address data to pass to the channel technology driver
timeout	How long we should attempt to dial the outbound channel
app	The name of the application to execute
appdata	Data to pass to the application
reason	Optional. If provided, the dialed status of the outgoing channel. Codes are AST_CONTROL_xxx values. Valid only if synchronous is non-zero.
synchronous	defined by the ast_pbx_outgoing_sync enum. If AST_OUTGOING_NO_WAIT then don't wait for anything. If AST_OUTGOING_WAIT then block until the outbound channel answers or the call fails. If AST_OUTGOING_WAIT_COMPLETE then wait for the call to complete or fail.
cid_num	The caller ID number to set on the outbound channel
cid_name	The caller ID name to set on the outbound channel
vars	Variables to set on the outbound channel
account	The accountcode for the outbound channel
locked_channel	Optional. The outbound channel that was created if success is returned. Otherwise it is set to NULL. This is returned both locked and reference bumped.
assignedids	Optional. The uniqueid(s) to assign the channel(s) that are created.

Return values

0	on success
-1	on failure

Definition at line 8005 of file pbx.c.

{
    return ast_pbx_outgoing_app_predial(type, cap, addr, timeout, app, appdata, reason, synchronous,
        cid_num, cid_name, vars, account, locked_channel, assignedids, NULL);
}

References app, ast_pbx_outgoing_app_predial(), NULL, and type.

Referenced by action_originate(), attempt_thread(), fast_originate(), and orig_app().

ast_pbx_outgoing_app_predial()

int ast_pbx_outgoing_app_predial	(	const char *	type,
		struct ast_format_cap *	cap,
		const char *	addr,
		int	timeout,
		const char *	app,
		const char *	appdata,
		int *	reason,
		int	synchronous,
		const char *	cid_num,
		const char *	cid_name,
		struct ast_variable *	vars,
		const char *	account,
		struct ast_channel **	locked_channel,
		const struct ast_assigned_ids *	assignedids,
		const char *	predial_callee
	)

Definition at line 8015 of file pbx.c.

{
    if (reason) {
        *reason = 0;
    }
    if (locked_channel) {
        *locked_channel = NULL;
    }
    if (ast_strlen_zero(app)) {
        return -1;
    }
 
    return pbx_outgoing_attempt(type, cap, addr, timeout, NULL, NULL, 0, app, appdata,
        reason, synchronous, cid_num, cid_name, vars, account, locked_channel, 0,
        assignedids, predial_callee);
}

References app, ast_strlen_zero(), NULL, pbx_outgoing_attempt(), and type.

Referenced by ast_pbx_outgoing_app(), and originate_exec().

ast_pbx_outgoing_exten()

int ast_pbx_outgoing_exten	(	const char *	type,
		struct ast_format_cap *	cap,
		const char *	addr,
		int	timeout,
		const char *	context,
		const char *	exten,
		int	priority,
		int *	reason,
		int	synchronous,
		const char *	cid_num,
		const char *	cid_name,
		struct ast_variable *	vars,
		const char *	account,
		struct ast_channel **	locked_channel,
		int	early_media,
		const struct ast_assigned_ids *	assignedids
	)

Synchronously or asynchronously make an outbound call and send it to a particular extension.

Parameters

type	The channel technology to create
cap	The format capabilities for the channel
addr	Address data to pass to the channel technology driver
timeout	How long we should attempt to dial the outbound channel
context	The destination context for the outbound channel
exten	The destination extension for the outbound channel
priority	The destination priority for the outbound channel
reason	Optional. If provided, the dialed status of the outgoing channel. Codes are AST_CONTROL_xxx values. Valid only if synchronous is non-zero.
synchronous	defined by the ast_pbx_outgoing_sync enum. If AST_OUTGOING_NO_WAIT then don't wait for anything. If AST_OUTGOING_WAIT then block until the outbound channel answers or the call fails. If AST_OUTGOING_WAIT_COMPLETE then wait for the call to complete or fail. If AST_OUTGOING_WAIT or AST_OUTGOING_WAIT_COMPLETE is specified, the call doesn't answer, and failed@context exists then run a channel named OutgoingSpoolFailed at failed@context.
cid_num	The caller ID number to set on the outbound channel
cid_name	The caller ID name to set on the outbound channel
vars	Variables to set on the outbound channel
account	The accountcode for the outbound channel
locked_channel	Optional. The outbound channel that was created if success is returned. Otherwise it is set to NULL. This is returned both locked and reference bumped.
early_media	If non-zero the channel "answers" when progress is indicated.
assignedids	Optional. The uniqueid(s) to assign the channel(s) that are created.

Return values

0	on success
-1	on failure

Definition at line 7941 of file pbx.c.

{
    return ast_pbx_outgoing_exten_predial(type, cap, addr, timeout, context, exten, priority, reason,
        synchronous, cid_num, cid_name, vars, account, locked_channel, early_media, assignedids, NULL);
}

References ast_pbx_outgoing_exten_predial(), voicemailpwcheck::context, NULL, priority, and type.

Referenced by attempt_thread(), fast_originate(), hook_launch_thread(), and orig_exten().

ast_pbx_outgoing_exten_predial()

int ast_pbx_outgoing_exten_predial	(	const char *	type,
		struct ast_format_cap *	cap,
		const char *	addr,
		int	timeout,
		const char *	context,
		const char *	exten,
		int	priority,
		int *	reason,
		int	synchronous,
		const char *	cid_num,
		const char *	cid_name,
		struct ast_variable *	vars,
		const char *	account,
		struct ast_channel **	locked_channel,
		int	early_media,
		const struct ast_assigned_ids *	assignedids,
		const char *	predial_callee
	)

Todo:

XXX Not good. The channel name is not unique if more than one originate fails at a time.

Definition at line 7951 of file pbx.c.

{
    int res;
    int my_reason;
 
    if (!reason) {
        reason = &my_reason;
    }
    *reason = 0;
    if (locked_channel) {
        *locked_channel = NULL;
    }
 
    res = pbx_outgoing_attempt(type, cap, addr, timeout, context, exten, priority,
        NULL, NULL, reason, synchronous, cid_num, cid_name, vars, account, locked_channel,
        early_media, assignedids, predial_callee);
 
    if (res < 0 /* Call failed to get connected for some reason. */
        && 0 < synchronous
        && ast_exists_extension(NULL, context, "failed", 1, NULL)) {
        struct ast_channel *failed;
 
        /* We do not have to worry about a locked_channel if dialing failed. */
        ast_assert(!locked_channel || !*locked_channel);
 
        /*!
         * \todo XXX Not good.  The channel name is not unique if more than
         * one originate fails at a time.
         */
        failed = ast_channel_alloc(0, AST_STATE_DOWN, cid_num, cid_name, account,
            "failed", context, NULL, NULL, 0, "OutgoingSpoolFailed");
        if (failed) {
            char failed_reason[12];
 
            ast_set_variables(failed, vars);
            snprintf(failed_reason, sizeof(failed_reason), "%d", *reason);
            pbx_builtin_setvar_helper(failed, "REASON", failed_reason);
            ast_channel_unlock(failed);
 
            if (ast_pbx_run(failed)) {
                ast_log(LOG_ERROR, "Unable to run PBX on '%s'\n",
                    ast_channel_name(failed));
                ast_hangup(failed);
            }
        }
    }
 
    return res;
}

References ast_assert, ast_channel_alloc, ast_channel_name(), ast_channel_unlock, ast_exists_extension(), ast_hangup(), ast_log, ast_pbx_run(), ast_set_variables(), AST_STATE_DOWN, voicemailpwcheck::context, LOG_ERROR, NULL, pbx_builtin_setvar_helper(), pbx_outgoing_attempt(), priority, and type.

Referenced by action_originate(), ast_pbx_outgoing_exten(), and originate_exec().

ast_pbx_run()

enum ast_pbx_result ast_pbx_run

(

struct ast_channel *

c

)

Execute the PBX in the current thread.

Parameters

c	channel to run the pbx on

This executes the PBX on a given channel. It allocates a new PBX structure for the channel, and provides all PBX functionality. See ast_pbx_start for an asynchronous function to run the PBX in a new thread as opposed to the current one.

Return values

Zero	on success
non-zero	on failure

Definition at line 4776 of file pbx.c.

{
    return ast_pbx_run_args(c, NULL);
}

References ast_pbx_run_args(), c, and NULL.

Referenced by __analog_ss_thread(), analog_ss_thread(), ari_originate_dial(), ast_bridge_run_after_goto(), ast_pbx_outgoing_exten_predial(), do_notify(), pbx_outgoing_exec(), and unistim_ss().

ast_pbx_run_args()

enum ast_pbx_result ast_pbx_run_args	(	struct ast_channel *	c,
		struct ast_pbx_args *	args
	)

Execute the PBX in the current thread.

Parameters

c	channel to run the pbx on
args	options for the pbx

This executes the PBX on a given channel. It allocates a new PBX structure for the channel, and provides all PBX functionality. See ast_pbx_start for an asynchronous function to run the PBX in a new thread as opposed to the current one.

Return values

Zero	on success
non-zero	on failure

Definition at line 4756 of file pbx.c.

{
    enum ast_pbx_result res = AST_PBX_SUCCESS;
 
    if (!ast_fully_booted) {
        ast_log(LOG_WARNING, "PBX requires Asterisk to be fully booted\n");
        return AST_PBX_FAILED;
    }
 
    if (increase_call_count(c)) {
        return AST_PBX_CALL_LIMIT;
    }
 
    res = __ast_pbx_run(c, args);
 
    decrease_call_count();
 
    return res;
}

References __ast_pbx_run(), args, ast_fully_booted, ast_log, AST_PBX_CALL_LIMIT, AST_PBX_FAILED, AST_PBX_SUCCESS, c, decrease_call_count(), increase_call_count(), and LOG_WARNING.

Referenced by action_dialplan_exec(), ast_pbx_run(), handle_gosub(), msg_route(), and stasis_app_exec().

ast_pbx_start()

enum ast_pbx_result ast_pbx_start

(

struct ast_channel *

c

)

Create a new thread and start the PBX.

Parameters

c	channel to start the pbx on

See also

ast_pbx_run for a synchronous function to run the PBX in the current thread, as opposed to starting a new one.

Return values

Zero	on success
non-zero	on failure

Definition at line 4729 of file pbx.c.

{
    pthread_t t;
 
    if (!c) {
        ast_log(LOG_WARNING, "Asked to start thread on NULL channel?\n");
        return AST_PBX_FAILED;
    }
 
    if (!ast_fully_booted) {
        ast_log(LOG_WARNING, "PBX requires Asterisk to be fully booted\n");
        return AST_PBX_FAILED;
    }
 
    if (increase_call_count(c))
        return AST_PBX_CALL_LIMIT;
 
    /* Start a new thread, and get something handling this channel. */
    if (ast_pthread_create_detached(&t, NULL, pbx_thread, c)) {
        ast_log(LOG_WARNING, "Failed to create new channel thread\n");
        decrease_call_count();
        return AST_PBX_FAILED;
    }
 
    return AST_PBX_SUCCESS;
}

References ast_fully_booted, ast_log, AST_PBX_CALL_LIMIT, AST_PBX_FAILED, AST_PBX_SUCCESS, ast_pthread_create_detached, c, decrease_call_count(), increase_call_count(), LOG_WARNING, NULL, and pbx_thread().

Referenced by ast_async_goto(), ast_iax2_new(), bridge_failed_peer_goto(), console_new(), dahdi_new(), dial_exec_full(), do_monitor_headset(), generic_recall(), handle_response_clip(), handle_response_cmgr(), jingle_action_session_initiate(), local_call(), ooh323_new(), pbx_start_incoming_request(), and unistim_new().

ast_processed_calls()

int ast_processed_calls

(

void

)

Retrieve the total number of calls processed through the PBX since last restart.

Definition at line 4786 of file pbx.c.

{
    return totalcalls;
}

References totalcalls.

Referenced by action_corestatus(), ast_var_Config(), get_total_call_count(), handle_chanlist(), and handle_showcalls().

ast_rdlock_context()

int ast_rdlock_context

(

struct ast_context *

con

)

Read locks a given context.

Parameters

con	context to lock

Return values

0	on success
-1	on failure

Definition at line 8511 of file pbx.c.

{
    return ast_rwlock_rdlock(&con->lock);
}

References ast_rwlock_rdlock, and ast_context::lock.

Referenced by complete_dialplan_remove_ignorepat(), complete_dialplan_remove_include(), dundi_precache_full(), find_matching_endif(), find_matching_endwhile(), handle_cli_dialplan_save(), lookup_c_ip(), lookup_ci(), manager_show_dialplan_helper(), show_debug_helper(), and show_dialplan_helper().

ast_rdlock_contexts()

int ast_rdlock_contexts

(

void

)

Read locks the context list.

Return values

0	on success
-1	on error

Definition at line 8493 of file pbx.c.

{
    return ast_mutex_lock(&conlock);
}

References ast_mutex_lock, and conlock.

Referenced by ast_context_find(), ast_context_find_or_create(), ast_get_extension_data(), ast_hint_extension(), ast_ignore_pattern(), ast_unregister_application(), complete_dialplan_add_extension(), complete_dialplan_add_ignorepat(), complete_dialplan_add_include(), complete_dialplan_remove_context(), complete_dialplan_remove_extension(), complete_dialplan_remove_ignorepat(), complete_dialplan_remove_include(), complete_show_dialplan_context(), dundi_precache_full(), find_context_locked(), find_matching_endif(), find_matching_endwhile(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), pbx_extension_helper(), show_debug_helper(), show_dialplan_helper(), and unreference_cached_app().

ast_register_switch()

int ast_register_switch

(

struct ast_switch *

sw

)

Register an alternative dialplan switch.

Parameters

sw	switch to register

This function registers a populated ast_switch structure with the asterisk switching architecture.

Return values

0	success
non-zero	failure

Definition at line 58 of file pbx_switch.c.

{
    struct ast_switch *tmp;
 
    AST_RWLIST_WRLOCK(&switches);
    AST_RWLIST_TRAVERSE(&switches, tmp, list) {
        if (!strcasecmp(tmp->name, sw->name)) {
            AST_RWLIST_UNLOCK(&switches);
            ast_log(LOG_WARNING, "Switch '%s' already found\n", sw->name);
            return -1;
        }
    }
    AST_RWLIST_INSERT_TAIL(&switches, sw, list);
    AST_RWLIST_UNLOCK(&switches);
 
    return 0;
}

References ast_log, AST_RWLIST_INSERT_TAIL, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_switch::list, LOG_WARNING, and ast_switch::name.

Referenced by load_module().

ast_spawn_extension()

int ast_spawn_extension	(	struct ast_channel *	c,
		const char *	context,
		const char *	exten,
		int	priority,
		const char *	callerid,
		int *	found,
		int	combined_find_spawn
	)

Launch a new extension (i.e. new stack)

Parameters

c	not important
context	which context to generate the extension within
exten	new extension to add
priority	priority of new extension
callerid	callerid of extension
found
combined_find_spawn

This adds a new extension to the asterisk extension list.

Note

It is possible for autoservice to be started and stopped on c during this function call, it is important that c is not locked prior to calling this. Otherwise a deadlock may occur

Return values

0	on success
-1	on failure.

Definition at line 4221 of file pbx.c.

{
    return pbx_extension_helper(c, NULL, context, exten, priority, NULL, callerid, E_SPAWN, found, combined_find_spawn);
}

References c, voicemailpwcheck::context, E_SPAWN, ast_exten::exten, NULL, pbx_extension_helper(), and priority.

Referenced by __ast_pbx_run(), ast_pbx_h_exten_run(), gosub_run(), and loopback_exec().

ast_str_get_hint()

int ast_str_get_hint	(	struct ast_str **	hint,
		ssize_t	hintsize,
		struct ast_str **	name,
		ssize_t	namesize,
		struct ast_channel *	c,
		const char *	context,
		const char *	exten
	)

If an extension hint exists, return non-zero.

Parameters

hint	buffer for hint
hintsize	Maximum size of hint buffer (<0 to prevent growth, >0 to limit growth to that number of bytes, or 0 for unlimited growth)
name	buffer for name portion of hint
namesize	Maximum size of name buffer (<0 to prevent growth, >0 to limit growth to that number of bytes, or 0 for unlimited growth)
c	Channel from which to return the hint. This is only important when the hint or name contains an expression to be expanded.
context	which context to look in
exten	which extension to search for

Returns

If an extension within the given context with the priority PRIORITY_HINT is found, a non zero value will be returned. Otherwise, 0 is returned.

If an extension hint exists, return non-zero.

Definition at line 4176 of file pbx.c.

{
    struct ast_exten *e = ast_hint_extension(c, context, exten);
 
    if (!e) {
        return 0;
    }
 
    if (hint) {
        ast_str_set(hint, hintsize, "%s", ast_get_extension_app(e));
    }
    if (name) {
        const char *tmp = ast_get_extension_app_data(e);
        if (tmp) {
            ast_str_set(name, namesize, "%s", tmp);
        }
    }
    return -1;
}

References ast_get_extension_app(), ast_get_extension_app_data(), ast_hint_extension(), ast_str_set(), c, voicemailpwcheck::context, ast_exten::exten, and name.

Referenced by ast_str_retrieve_variable().

ast_str_retrieve_variable()

const char * ast_str_retrieve_variable	(	struct ast_str **	buf,
		ssize_t	maxlen,
		struct ast_channel *	chan,
		struct varshead *	headp,
		const char *	var
	)

Parameters

buf	Result will be placed in this buffer.
maxlen	-1 if the buffer should not grow, 0 if the buffer may grow to any size, and >0 if the buffer should grow only to that number of bytes.
chan	Channel variables from which to extract values, and channel to pass to any dialplan functions.
headp	If no channel is specified, a channel list from which to extract variable values
var	Variable name to retrieve.

Definition at line 257 of file pbx_variables.c.

{
    const char not_found = '\0';
    char *tmpvar;
    const char *ret;
    const char *s;  /* the result */
    int offset, length;
    int i, need_substring;
    struct varshead *places[2] = { headp, &globals };   /* list of places where we may look */
    char workspace[20];
 
    if (c) {
        ast_channel_lock(c);
        places[0] = ast_channel_varshead(c);
    }
    /*
     * Make a copy of var because parse_variable_name() modifies the string.
     * Then if called directly, we might need to run substring() on the result;
     * remember this for later in 'need_substring', 'offset' and 'length'
     */
    tmpvar = ast_strdupa(var);  /* parse_variable_name modifies the string */
    need_substring = parse_variable_name(tmpvar, &offset, &length, &i /* ignored */);
 
    /*
     * Look first into predefined variables, then into variable lists.
     * Variable 's' points to the result, according to the following rules:
     * s == &not_found (set at the beginning) means that we did not find a
     *  matching variable and need to look into more places.
     * If s != &not_found, s is a valid result string as follows:
     * s = NULL if the variable does not have a value;
     *  you typically do this when looking for an unset predefined variable.
     * s = workspace if the result has been assembled there;
     *  typically done when the result is built e.g. with an snprintf(),
     *  so we don't need to do an additional copy.
     * s != workspace in case we have a string, that needs to be copied
     *  (the ast_copy_string is done once for all at the end).
     *  Typically done when the result is already available in some string.
     */
    s = &not_found; /* default value */
    if (c) {    /* This group requires a valid channel */
        /* Names with common parts are looked up a piece at a time using strncmp. */
        if (!strncmp(var, "CALL", 4)) {
            if (!strncmp(var + 4, "ING", 3)) {
                if (!strcmp(var + 7, "PRES")) {         /* CALLINGPRES */
                    ast_str_set(str, maxlen, "%d",
                        ast_party_id_presentation(&ast_channel_caller(c)->id));
                    s = ast_str_buffer(*str);
                } else if (!strcmp(var + 7, "ANI2")) {      /* CALLINGANI2 */
                    ast_str_set(str, maxlen, "%d", ast_channel_caller(c)->ani2);
                    s = ast_str_buffer(*str);
                } else if (!strcmp(var + 7, "TON")) {       /* CALLINGTON */
                    ast_str_set(str, maxlen, "%d", ast_channel_caller(c)->id.number.plan);
                    s = ast_str_buffer(*str);
                } else if (!strcmp(var + 7, "TNS")) {       /* CALLINGTNS */
                    ast_str_set(str, maxlen, "%d", ast_channel_dialed(c)->transit_network_select);
                    s = ast_str_buffer(*str);
                }
            }
        } else if (!strcmp(var, "HINT")) {
            s = ast_str_get_hint(str, maxlen, NULL, 0, c, ast_channel_context(c), ast_channel_exten(c)) ? ast_str_buffer(*str) : NULL;
        } else if (!strcmp(var, "HINTNAME")) {
            s = ast_str_get_hint(NULL, 0, str, maxlen, c, ast_channel_context(c), ast_channel_exten(c)) ? ast_str_buffer(*str) : NULL;
        } else if (!strcmp(var, "EXTEN")) {
            s = ast_channel_exten(c);
        } else if (!strcmp(var, "CONTEXT")) {
            s = ast_channel_context(c);
        } else if (!strcmp(var, "PRIORITY")) {
            ast_str_set(str, maxlen, "%d", ast_channel_priority(c));
            s = ast_str_buffer(*str);
        } else if (!strcmp(var, "CHANNEL")) {
            s = ast_channel_name(c);
        } else if (!strcmp(var, "UNIQUEID")) {
            s = ast_channel_uniqueid(c);
        } else if (!strcmp(var, "HANGUPCAUSE")) {
            ast_str_set(str, maxlen, "%d", ast_channel_hangupcause(c));
            s = ast_str_buffer(*str);
        }
    }
    if (s == &not_found) { /* look for more */
        if (!strcmp(var, "EPOCH")) {
            ast_str_set(str, maxlen, "%d", (int) time(NULL));
            s = ast_str_buffer(*str);
        } else if (!strcmp(var, "SYSTEMNAME")) {
            s = ast_config_AST_SYSTEM_NAME;
        } else if (!strcmp(var, "ASTCACHEDIR")) {
            s = ast_config_AST_CACHE_DIR;
        } else if (!strcmp(var, "ASTETCDIR")) {
            s = ast_config_AST_CONFIG_DIR;
        } else if (!strcmp(var, "ASTMODDIR")) {
            s = ast_config_AST_MODULE_DIR;
        } else if (!strcmp(var, "ASTVARLIBDIR")) {
            s = ast_config_AST_VAR_DIR;
        } else if (!strcmp(var, "ASTDBDIR")) {
            s = ast_config_AST_DB;
        } else if (!strcmp(var, "ASTKEYDIR")) {
            s = ast_config_AST_KEY_DIR;
        } else if (!strcmp(var, "ASTDATADIR")) {
            s = ast_config_AST_DATA_DIR;
        } else if (!strcmp(var, "ASTAGIDIR")) {
            s = ast_config_AST_AGI_DIR;
        } else if (!strcmp(var, "ASTSPOOLDIR")) {
            s = ast_config_AST_SPOOL_DIR;
        } else if (!strcmp(var, "ASTRUNDIR")) {
            s = ast_config_AST_RUN_DIR;
        } else if (!strcmp(var, "ASTLOGDIR")) {
            s = ast_config_AST_LOG_DIR;
        } else if (!strcmp(var, "ASTSBINDIR")) {
            s = ast_config_AST_SBIN_DIR;
        } else if (!strcmp(var, "ENTITYID")) {
            ast_eid_to_str(workspace, sizeof(workspace), &ast_eid_default);
            s = workspace;
        }
    }
    /* if not found, look into chanvars or global vars */
    for (i = 0; s == &not_found && i < ARRAY_LEN(places); i++) {
        struct ast_var_t *variables;
        if (!places[i])
            continue;
        if (places[i] == &globals)
            ast_rwlock_rdlock(&globalslock);
        AST_LIST_TRAVERSE(places[i], variables, entries) {
            if (!strcmp(ast_var_name(variables), var)) {
                s = ast_var_value(variables);
                break;
            }
        }
        if (places[i] == &globals)
            ast_rwlock_unlock(&globalslock);
    }
    if (s == &not_found || s == NULL) {
        ast_debug(5, "Result of '%s' is NULL\n", var);
        ret = NULL;
    } else {
        ast_debug(5, "Result of '%s' is '%s'\n", var, s);
        if (s != ast_str_buffer(*str)) {
            ast_str_set(str, maxlen, "%s", s);
        }
        ret = ast_str_buffer(*str);
        if (need_substring) {
            ret = ast_str_substring(*str, offset, length);
            ast_debug(2, "Final result of '%s' is '%s'\n", var, ret);
        }
    }
 
    if (c) {
        ast_channel_unlock(c);
    }
    return ret;
}

References ARRAY_LEN, ast_channel_caller(), ast_channel_context(), ast_channel_dialed(), ast_channel_exten(), ast_channel_hangupcause(), ast_channel_lock, ast_channel_name(), ast_channel_priority(), ast_channel_uniqueid(), ast_channel_unlock, ast_channel_varshead(), ast_config_AST_AGI_DIR, ast_config_AST_CACHE_DIR, ast_config_AST_CONFIG_DIR, ast_config_AST_DATA_DIR, ast_config_AST_DB, ast_config_AST_KEY_DIR, ast_config_AST_LOG_DIR, ast_config_AST_MODULE_DIR, ast_config_AST_RUN_DIR, ast_config_AST_SBIN_DIR, ast_config_AST_SPOOL_DIR, ast_config_AST_SYSTEM_NAME, ast_config_AST_VAR_DIR, ast_debug, ast_eid_default, ast_eid_to_str(), AST_LIST_TRAVERSE, ast_party_id_presentation(), ast_rwlock_rdlock, ast_rwlock_unlock, ast_str_buffer(), ast_str_get_hint(), ast_str_set(), ast_str_substring(), ast_strdupa, ast_var_name(), ast_var_value(), c, ast_var_t::entries, globals, globalslock, NULL, parse_variable_name(), str, and var.

Referenced by ast_ari_asterisk_get_global_var(), ast_ari_channels_get_channel_var(), ast_str_substitute_variables_full2(), and pbx_retrieve_variable().

ast_str_substitute_variables()

void ast_str_substitute_variables	(	struct ast_str **	buf,
		ssize_t	maxlen,
		struct ast_channel *	chan,
		const char *	templ
	)

Parameters

buf	Result will be placed in this buffer.
maxlen	-1 if the buffer should not grow, 0 if the buffer may grow to any size, and >0 if the buffer should grow only to that number of bytes.
chan	Channel variables from which to extract values, and channel to pass to any dialplan functions.
templ	Variable template to expand.

Definition at line 657 of file pbx_variables.c.

{
    ast_str_substitute_variables_full(buf, maxlen, chan, NULL, templ, NULL);
}

References ast_str_substitute_variables_full(), buf, and NULL.

Referenced by acf_odbc_read(), acf_odbc_write(), ast_pbx_exec_application(), AST_TEST_DEFINE(), cli_odbc_read(), cli_odbc_write(), config_curl(), custom_log(), cut_internal(), destroy_curl(), do_notify(), exec_exec(), func_mchan_read(), function_eval2(), function_fieldnum_helper(), function_fieldqty_helper(), handle_exec(), handle_getvariablefull(), import_helper(), json_decode_read(), listfilter(), make_email_file(), realtime_curl(), realtime_multi_curl(), replace(), require_curl(), sendmail(), sendpage(), shift_pop(), store_curl(), strbetween(), strreplace(), test_2way_function(), test_chan_function(), test_chan_integer(), test_chan_integer_accessor(), test_chan_string(), test_chan_variable(), test_expected_result(), tryexec_exec(), unshift_push(), update2_curl(), and update_curl().

ast_str_substitute_variables_full()

void ast_str_substitute_variables_full	(	struct ast_str **	buf,
		ssize_t	maxlen,
		struct ast_channel *	c,
		struct varshead *	headp,
		const char *	templ,
		size_t *	used
	)

Parameters

buf	Result will be placed in this buffer.
maxlen	-1 if the buffer should not grow, 0 if the buffer may grow to any size, and >0 if the buffer should grow only to that number of bytes.
c	Channel variables from which to extract values, and channel to pass to any dialplan functions.
headp	If no channel is specified, a channel list from which to extract variable values
templ	Variable template to expand.
used	Number of bytes read from the template. (May be NULL)

Definition at line 651 of file pbx_variables.c.

{
    ast_str_substitute_variables_full2(buf, maxlen, chan, headp, templ, used, 0);
}

References ast_str_substitute_variables_full2(), and buf.

Referenced by ast_str_substitute_variables(), and ast_str_substitute_variables_varshead().

ast_str_substitute_variables_full2()

void ast_str_substitute_variables_full2	(	struct ast_str **	buf,
		ssize_t	maxlen,
		struct ast_channel *	c,
		struct varshead *	headp,
		const char *	templ,
		size_t *	used,
		int	use_both
	)

Perform variable/function/expression substitution on an ast_str.

Parameters

buf	Result will be placed in this buffer.
maxlen	-1 if the buffer should not grow, 0 if the buffer may grow to any size, and >0 if the buffer should grow only to that number of bytes.
c	A channel from which to extract values, and to pass to any dialplan functions.
headp	A channel variables list to also search for variables.
templ	Variable template to expand.
used	Number of bytes read from the template. (May be NULL)
use_both	Normally, if a channel is specified, headp is ignored. If this parameter is set to 1 and both a channel and headp are specified, the channel will be searched for variables first and any not found will be searched for in headp.

Definition at line 407 of file pbx_variables.c.

{
    /* Substitutes variables into buf, based on string templ */
    const char *whereweare;
    struct ast_str *substr1 = ast_str_create(16);
    struct ast_str *substr2 = NULL;
    struct ast_str *substr3 = ast_str_create(16);
 
    ast_str_reset(*buf);
 
    if (!substr1 || !substr3) {
        if (used) {
            *used = ast_str_strlen(*buf);
        }
        ast_free(substr1);
        ast_free(substr3);
        return;
    }
 
    whereweare = templ;
    while (!ast_strlen_zero(whereweare)) {
        const char *nextvar = NULL;
        const char *nextexp = NULL;
        const char *nextthing;
        const char *vars;
        const char *vare;
        char *finalvars;
        int pos;
        int brackets;
        int needsub;
        int len;
 
        /* reset our buffer */
        ast_str_reset(substr3);
 
        /* Determine how much simply needs to be copied to the output buf. */
        nextthing = strchr(whereweare, '$');
        if (nextthing) {
            pos = nextthing - whereweare;
            switch (nextthing[1]) {
            case '{':
                /* Variable substitution */
                nextvar = nextthing;
                break;
            case '[':
                /* Expression substitution */
                nextexp = nextthing;
                break;
            default:
                /* '$' is not part of a substitution so include it too. */
                ++pos;
                break;
            }
        } else {
            /* We're copying the whole remaining string */
            pos = strlen(whereweare);
        }
 
        if (pos) {
            /* Copy that many bytes */
            ast_str_append_substr(buf, maxlen, whereweare, pos);
 
            whereweare += pos;
        }
 
        if (nextvar) {
            int offset;
            int offset2;
            int isfunction;
            int res;
 
            /* We have a variable.  Find the start and end, and determine
               if we are going to have to recursively call ourselves on the
               contents */
            vars = vare = nextvar + 2;
            brackets = 1;
            needsub = 0;
 
            /* Find the end of it */
            while (brackets && *vare) {
                if ((vare[0] == '$') && (vare[1] == '{')) {
                    needsub++;
                    brackets++;
                    vare++;
                } else if (vare[0] == '{') {
                    brackets++;
                } else if (vare[0] == '}') {
                    brackets--;
                } else if ((vare[0] == '$') && (vare[1] == '[')) {
                    needsub++;
                    vare++;
                }
                vare++;
            }
            len = vare - vars;
            if (brackets) {
                ast_log(LOG_WARNING, "Error in extension logic (missing '}')\n");
            } else {
                /* Don't count the closing '}' in the length. */
                --len;
            }
 
            /* Skip totally over variable string */
            whereweare = vare;
 
            /* Store variable name expression to lookup. */
            ast_str_set_substr(&substr1, 0, vars, len);
            ast_debug(5, "Evaluating '%s' (from '%s' len %d)\n",
                ast_str_buffer(substr1), vars, len);
 
            /* Substitute if necessary */
            if (needsub) {
                if (!substr2) {
                    substr2 = ast_str_create(16);
                    if (!substr2) {
                        continue;
                    }
                }
                ast_str_substitute_variables_full2(&substr2, 0, c, headp,
                    ast_str_buffer(substr1), NULL, use_both);
                finalvars = ast_str_buffer(substr2);
            } else {
                finalvars = ast_str_buffer(substr1);
            }
 
            parse_variable_name(finalvars, &offset, &offset2, &isfunction);
            if (isfunction) {
                /* Evaluate function */
                res = -1;
                if (c) {
                    res = ast_func_read2(c, finalvars, &substr3, 0);
                    ast_debug(2, "Function %s result is '%s' from channel\n",
                        finalvars, res ? "" : ast_str_buffer(substr3));
                }
                if (!c || (c && res < 0 && use_both)) {
                    struct varshead old;
                    struct ast_channel *bogus;
 
                    bogus = ast_dummy_channel_alloc();
                    if (bogus) {
                        old = *ast_channel_varshead(bogus);
                        if (headp) {
                            *ast_channel_varshead(bogus) = *headp;
                        }
                        res = ast_func_read2(bogus, finalvars, &substr3, 0);
                        /* Don't deallocate the varshead that was passed in */
                        if (headp) {
                            *ast_channel_varshead(bogus) = old;
                        }
                        ast_channel_unref(bogus);
                    } else {
                        ast_log(LOG_ERROR, "Unable to allocate bogus channel for function value substitution.\n");
                        res = -1;
                    }
                    ast_debug(2, "Function %s result is '%s' from headp\n",
                        finalvars, res ? "" : ast_str_buffer(substr3));
                }
            } else {
                const char *result;
                if (c) {
                    result = ast_str_retrieve_variable(&substr3, 0, c, NULL, finalvars);
                    ast_debug(2, "Variable %s result is '%s' from channel\n",
                        finalvars, S_OR(result, ""));
                }
                if (!c || (c && !result && use_both)) {
                    result = ast_str_retrieve_variable(&substr3, 0, NULL, headp, finalvars);
                    ast_debug(2, "Variable %s result is '%s' from headp\n",
                        finalvars, S_OR(result, ""));
                }
                res = (result ? 0 : -1);
            }
            if (!res) {
                ast_str_substring(substr3, offset, offset2);
                ast_str_append(buf, maxlen, "%s", ast_str_buffer(substr3));
            }
        } else if (nextexp) {
            /* We have an expression.  Find the start and end, and determine
               if we are going to have to recursively call ourselves on the
               contents */
            vars = vare = nextexp + 2;
            brackets = 1;
            needsub = 0;
 
            /* Find the end of it */
            while (brackets && *vare) {
                if ((vare[0] == '$') && (vare[1] == '[')) {
                    needsub++;
                    brackets++;
                    vare++;
                } else if (vare[0] == '[') {
                    brackets++;
                } else if (vare[0] == ']') {
                    brackets--;
                } else if ((vare[0] == '$') && (vare[1] == '{')) {
                    needsub++;
                    vare++;
                }
                vare++;
            }
            len = vare - vars;
            if (brackets) {
                ast_log(LOG_WARNING, "Error in extension logic (missing ']')\n");
            } else {
                /* Don't count the closing ']' in the length. */
                --len;
            }
 
            /* Skip totally over expression */
            whereweare = vare;
 
            /* Store expression to evaluate. */
            ast_str_set_substr(&substr1, 0, vars, len);
 
            /* Substitute if necessary */
            if (needsub) {
                if (!substr2) {
                    substr2 = ast_str_create(16);
                    if (!substr2) {
                        continue;
                    }
                }
                ast_str_substitute_variables_full2(&substr2, 0, c, headp,
                    ast_str_buffer(substr1), NULL, use_both);
                finalvars = ast_str_buffer(substr2);
            } else {
                finalvars = ast_str_buffer(substr1);
            }
 
            if (ast_str_expr(&substr3, 0, c, finalvars)) {
                ast_debug(2, "Expression result is '%s'\n", ast_str_buffer(substr3));
            }
            ast_str_append(buf, maxlen, "%s", ast_str_buffer(substr3));
        }
    }
    if (used) {
        *used = ast_str_strlen(*buf);
    }
    ast_free(substr1);
    ast_free(substr2);
    ast_free(substr3);
}

References ast_channel_unref, ast_channel_varshead(), ast_debug, ast_dummy_channel_alloc, ast_free, ast_func_read2(), ast_log, ast_str_append(), ast_str_append_substr(), ast_str_buffer(), ast_str_create, ast_str_expr(), ast_str_reset(), ast_str_retrieve_variable(), ast_str_set_substr(), ast_str_strlen(), ast_str_substitute_variables_full2(), ast_str_substring(), ast_strlen_zero(), buf, c, len(), LOG_ERROR, LOG_WARNING, NULL, parse_variable_name(), result, and S_OR.

Referenced by ast_str_substitute_variables_full(), ast_str_substitute_variables_full2(), and geoloc_eprofile_resolve_varlist().

ast_str_substitute_variables_varshead()

void ast_str_substitute_variables_varshead	(	struct ast_str **	buf,
		ssize_t	maxlen,
		struct varshead *	headp,
		const char *	templ
	)

Parameters

buf	Result will be placed in this buffer.
maxlen	-1 if the buffer should not grow, 0 if the buffer may grow to any size, and >0 if the buffer should grow only to that number of bytes.
headp	If no channel is specified, a channel list from which to extract variable values
templ	Variable template to expand.

Definition at line 662 of file pbx_variables.c.

{
    ast_str_substitute_variables_full(buf, maxlen, NULL, headp, templ, NULL);
}

References ast_str_substitute_variables_full(), buf, and NULL.

Referenced by add_user_extension(), build_user_routes(), handle_aor(), handle_registrations(), phoneprov_callback(), pp_each_extension_helper(), and pp_each_user_helper().

ast_thread_inhibit_escalations()

int ast_thread_inhibit_escalations

(

void

)

Inhibit (in the current thread) the execution of dialplan functions which cause privilege escalations. If pbx_live_dangerously() has been called, this function has no effect.

Returns

0 if successfuly marked current thread.

Non-zero if marking current thread failed.

Definition at line 478 of file pbx_functions.c.

{
    int *thread_inhibit_escalations;
 
    thread_inhibit_escalations = ast_threadstorage_get(
        &thread_inhibit_escalations_tl, sizeof(*thread_inhibit_escalations));
    if (thread_inhibit_escalations == NULL) {
        ast_log(LOG_ERROR, "Error inhibiting privilege escalations for current thread\n");
        return -1;
    }
 
    *thread_inhibit_escalations = 1;
    return 0;
}

References ast_log, ast_threadstorage_get(), LOG_ERROR, NULL, and thread_inhibit_escalations_tl.

Referenced by ast_add_extension2_lockopt(), and handle_tcptls_connection().

ast_thread_inhibit_escalations_swap()

int ast_thread_inhibit_escalations_swap

(

int

inhibit

)

Swap the current thread escalation inhibit setting.

Since

11.24.0

Parameters

inhibit

New setting. Non-zero to inhibit.

Return values

1	if dangerous function execution was inhibited.
0	if dangerous function execution was allowed.
-1	on error.

Definition at line 493 of file pbx_functions.c.

{
    int *thread_inhibit_escalations;
    int orig;
 
    thread_inhibit_escalations = ast_threadstorage_get(
        &thread_inhibit_escalations_tl, sizeof(*thread_inhibit_escalations));
    if (thread_inhibit_escalations == NULL) {
        ast_log(LOG_ERROR, "Error swapping privilege escalations inhibit for current thread\n");
        return -1;
    }
 
    orig = *thread_inhibit_escalations;
    *thread_inhibit_escalations = !!inhibit;
    return orig;
}

References ast_log, ast_threadstorage_get(), LOG_ERROR, NULL, and thread_inhibit_escalations_tl.

Referenced by ast_add_extension2_lockopt().

ast_unlock_context()

int ast_unlock_context

(

struct ast_context *

con

)

Return values

Unlocks

the given context

Parameters

con	context to unlock

Return values

0	on success
-1	on failure

Definition at line 8516 of file pbx.c.

{
    return ast_rwlock_unlock(&con->lock);
}

References ast_rwlock_unlock, and ast_context::lock.

Referenced by __ast_context_destroy(), add_hints(), ast_add_extension2_lockopt(), ast_context_add_ignorepat2(), ast_context_add_include2(), ast_context_add_switch2(), ast_context_remove_extension_callerid2(), ast_context_remove_ignorepat2(), ast_context_remove_include2(), ast_context_remove_switch2(), complete_dialplan_remove_ignorepat(), complete_dialplan_remove_include(), dundi_precache_full(), find_matching_endif(), find_matching_endwhile(), handle_cli_dialplan_save(), lookup_c_ip(), lookup_ci(), manager_show_dialplan_helper(), parking_duration_callback(), parking_lot_cfg_create_extensions(), show_debug_helper(), and show_dialplan_helper().

ast_unlock_contexts()

int ast_unlock_contexts

(

void

)

Unlocks contexts.

Return values

0	on success
-1	on failure

Definition at line 8498 of file pbx.c.

{
    return ast_mutex_unlock(&conlock);
}

References ast_mutex_unlock, and conlock.

Referenced by add_hints(), ast_add_extension(), ast_context_add_ignorepat(), ast_context_add_include(), ast_context_add_switch(), ast_context_destroy(), ast_context_destroy_by_name(), ast_context_find(), ast_context_find_or_create(), ast_context_remove_extension_callerid(), ast_context_remove_ignorepat(), ast_context_remove_include(), ast_context_remove_switch(), ast_get_extension_data(), ast_hint_extension(), ast_ignore_pattern(), ast_merge_contexts_and_delete(), ast_unregister_application(), complete_dialplan_add_extension(), complete_dialplan_add_ignorepat(), complete_dialplan_add_include(), complete_dialplan_remove_context(), complete_dialplan_remove_extension(), complete_dialplan_remove_ignorepat(), complete_dialplan_remove_include(), complete_show_dialplan_context(), dundi_precache_full(), find_context_locked(), find_matching_endif(), find_matching_endwhile(), handle_cli_dialplan_save(), manager_dialplan_extension_add(), manager_show_dialplan_helper(), parking_duration_callback(), parking_lot_cfg_create_extensions(), pbx_extension_helper(), show_debug_helper(), show_dialplan_helper(), and unreference_cached_app().

ast_unregister_switch()

void ast_unregister_switch

(

struct ast_switch *

sw

)

Unregister an alternative switch.

Parameters

sw	switch to unregister

Unregisters a switch from asterisk.

Definition at line 76 of file pbx_switch.c.

{
    AST_RWLIST_WRLOCK(&switches);
    AST_RWLIST_REMOVE(&switches, sw, list);
    AST_RWLIST_UNLOCK(&switches);
}

References AST_RWLIST_REMOVE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, and ast_switch::list.

Referenced by __unload_module(), and unload_module().

ast_walk_context_extensions()

static struct ast_exten * ast_walk_context_extensions	(	struct ast_context *	con,
		struct ast_exten *	priority
	)

Definition at line 427 of file ael_main.c.

{
    return NULL;
}

References ast_exten::exten, NULL, and ast_context::root.

Referenced by complete_dialplan_remove_extension(), context_used(), dundi_precache_full(), find_matching_priority(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), pbx_find_extension(), show_dialplan_helper(), and unreference_cached_app().

ast_walk_context_ignorepats()

const struct ast_ignorepat * ast_walk_context_ignorepats	(	const struct ast_context *	con,
		const struct ast_ignorepat *	ip
	)

Definition at line 8714 of file pbx.c.

{
    if (!con) {
        return NULL;
    }
 
    if (ip) {
        int idx;
        int next = 0;
 
        for (idx = 0; idx < ast_context_ignorepats_count(con); idx++) {
            const struct ast_ignorepat *i = ast_context_ignorepats_get(con, idx);
 
            if (next) {
                return i;
            }
 
            if (ip == i) {
                next = 1;
            }
        }
 
        return NULL;
    }
 
    if (!ast_context_ignorepats_count(con)) {
        return NULL;
    }
 
    return ast_context_ignorepats_get(con, 0);
}

References ast_context_ignorepats_count(), ast_context_ignorepats_get(), ast_ignorepat::next, and NULL.

ast_walk_context_includes()

const struct ast_include * ast_walk_context_includes	(	const struct ast_context *	con,
		const struct ast_include *	inc
	)

Definition at line 8675 of file pbx.c.

{
    if (inc) {
        int idx;
        int next = 0;
 
        for (idx = 0; idx < ast_context_includes_count(con); idx++) {
            const struct ast_include *include = AST_VECTOR_GET(&con->includes, idx);
 
            if (next) {
                return include;
            }
 
            if (inc == include) {
                next = 1;
            }
        }
 
        return NULL;
    }
 
    if (!ast_context_includes_count(con)) {
        return NULL;
    }
 
    return ast_context_includes_get(con, 0);
}

References ast_context_includes_count(), ast_context_includes_get(), AST_VECTOR_GET, ast_context::includes, ast_include::next, and NULL.

Referenced by context_included().

ast_walk_context_switches()

const struct ast_sw * ast_walk_context_switches	(	const struct ast_context *	con,
		const struct ast_sw *	sw
	)

Definition at line 8630 of file pbx.c.

{
    if (sw) {
        int idx;
        int next = 0;
 
        for (idx = 0; idx < ast_context_switches_count(con); idx++) {
            const struct ast_sw *s = ast_context_switches_get(con, idx);
 
            if (next) {
                return s;
            }
 
            if (sw == s) {
                next = 1;
            }
        }
 
        return NULL;
    }
 
    if (!ast_context_switches_count(con)) {
        return NULL;
    }
 
    return ast_context_switches_get(con, 0);
}

References ast_context_switches_count(), ast_context_switches_get(), ast_sw::next, and NULL.

ast_walk_contexts()

static struct ast_context * ast_walk_contexts

(

struct ast_context *

con

)

Definition at line 4022 of file extconf.c.

{
    return con ? con->next : contexts;
}

References contexts, and ast_context::next.

Referenced by ast_context_find(), complete_dialplan_add_extension(), complete_dialplan_add_ignorepat(), complete_dialplan_add_include(), complete_dialplan_remove_context(), complete_dialplan_remove_extension(), complete_dialplan_remove_ignorepat(), complete_dialplan_remove_include(), complete_show_dialplan_context(), dundi_precache_full(), find_matching_endif(), find_matching_endwhile(), find_matching_priority(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), pbx_load_module(), show_debug_helper(), show_dialplan_helper(), and unreference_cached_app().

ast_walk_extension_priorities()

static struct ast_exten * ast_walk_extension_priorities	(	struct ast_exten *	exten,
		struct ast_exten *	priority
	)

Definition at line 4059 of file extconf.c.

{
    return priority ? priority->peer : exten;
}

References ast_exten::exten, and priority.

Referenced by complete_dialplan_remove_extension(), find_matching_priority(), handle_cli_dialplan_save(), manager_show_dialplan_helper(), show_dialplan_helper(), and unreference_cached_app().

ast_wrlock_context()

int ast_wrlock_context

(

struct ast_context *

con

)

Write locks a given context.

Parameters

con	context to lock

Return values

0	on success
-1	on failure

Definition at line 8506 of file pbx.c.

{
    return ast_rwlock_wrlock(&con->lock);
}

References ast_rwlock_wrlock, and ast_context::lock.

Referenced by __ast_context_destroy(), add_hints(), ast_add_extension2_lockopt(), ast_context_add_ignorepat2(), ast_context_add_include2(), ast_context_add_switch2(), ast_context_remove_extension_callerid2(), ast_context_remove_ignorepat2(), ast_context_remove_include2(), ast_context_remove_switch2(), parking_duration_callback(), and parking_lot_cfg_create_extensions().

ast_wrlock_contexts()

int ast_wrlock_contexts

(

void

)

Write locks the context list.

Return values

0	on success
-1	on error

Definition at line 8488 of file pbx.c.

{
    return ast_mutex_lock(&conlock);
}

References ast_mutex_lock, and conlock.

Referenced by add_hints(), ast_context_destroy(), ast_context_destroy_by_name(), ast_context_find_or_create(), ast_merge_contexts_and_delete(), complete_dialplan_remove_include(), manager_dialplan_extension_add(), parking_duration_callback(), and parking_lot_cfg_create_extensions().

pbx_builtin_clear_globals()

void pbx_builtin_clear_globals

(

void

)

Definition at line 1353 of file pbx_variables.c.

{
    struct ast_var_t *vardata;
 
    ast_rwlock_wrlock(&globalslock);
    while ((vardata = AST_LIST_REMOVE_HEAD(&globals, entries)))
        ast_var_delete(vardata);
    ast_rwlock_unlock(&globalslock);
}

References AST_LIST_REMOVE_HEAD, ast_rwlock_unlock, ast_rwlock_wrlock, ast_var_delete(), ast_var_t::entries, globals, and globalslock.

Referenced by handle_cli_dialplan_reload(), reload(), and unload_pbx_variables().

pbx_builtin_getvar_helper()

const char * pbx_builtin_getvar_helper	(	struct ast_channel *	chan,
		const char *	name
	)

Return a pointer to the value of the corresponding channel variable.

Note

Will lock the channel.

This function will return a pointer to the buffer inside the channel variable. This value should only be accessed with the channel locked. If the value needs to be kept around, it should be done by using the following thread-safe code:

const char *var;
 
ast_channel_lock(chan);
if ((var = pbx_builtin_getvar_helper(chan, "MYVAR"))) {
    var = ast_strdupa(var);
}
ast_channel_unlock(chan);

Definition at line 1162 of file pbx_variables.c.

{
    struct ast_var_t *variables;
    const char *ret = NULL;
    int i;
    struct varshead *places[2] = { NULL, &globals };
 
    if (!name)
        return NULL;
 
    if (chan) {
        ast_channel_lock(chan);
        places[0] = ast_channel_varshead(chan);
    }
 
    for (i = 0; i < 2; i++) {
        if (!places[i])
            continue;
        if (places[i] == &globals)
            ast_rwlock_rdlock(&globalslock);
        AST_LIST_TRAVERSE(places[i], variables, entries) {
            if (!strcmp(name, ast_var_name(variables))) {
                ret = ast_var_value(variables);
                break;
            }
        }
        if (places[i] == &globals)
            ast_rwlock_unlock(&globalslock);
        if (ret)
            break;
    }
 
    if (chan)
        ast_channel_unlock(chan);
 
    return ret;
}

References ast_channel_lock, ast_channel_unlock, ast_channel_varshead(), AST_LIST_TRAVERSE, ast_rwlock_rdlock, ast_rwlock_unlock, ast_var_name(), ast_var_value(), globals, globalslock, name, and NULL.

Referenced by __ast_pbx_run(), _while_exec(), action_agents(), add_header_from_channel_var(), agent_handle_show_specific(), agent_login_channel_config(), agent_request_exec(), agent_show_requested(), analog_call(), analog_callwaiting_deluxe(), array(), ast_bridge_add_channel(), ast_bridge_call_with_flags(), ast_bridge_timelimit(), ast_bridge_transfer_attended(), ast_call_forward(), ast_channel_connected_line_sub(), ast_channel_redirecting_sub(), ast_eivr_getvariable(), ast_get_chan_applicationmap(), ast_unreal_hangup(), attended_transfer_exec(), bridge_parking_push(), channel_get_external_vars(), check_bridge_play_sound(), common_exec(), conf_run(), create_dynamic_lot_full(), crement_function_read(), dahdi_hangup(), dial_exec_full(), do_forward(), dundi_exec(), eagi_exec(), eval_sub_read(), feature_automixmonitor(), feature_blind_transfer(), find_by_mark(), find_channel_parking_lot_name(), find_conf_realtime(), func_channel_read(), generate_parked_user(), generic_fax_exec(), get_index(), get_transfer_context(), get_transfer_exten(), global_exists_read(), global_read(), gosub_run(), handle_call_forward(), handle_exec(), handle_gosub(), handle_hangup(), hash_read(), iax2_call(), iax2_exec(), if_helper(), leave_voicemail(), local_read(), manager_mixmonitor(), meetme_menu_admin_extended(), minivm_delete_exec(), minivm_notify_exec(), morsecode_exec(), notify_new_message(), ooh323_call(), ooh323_hangup(), park_app_exec(), pbx_builtin_gotoiftime(), permit_dtmf_interrupt(), pjsip_acf_parse_uri_read(), pre_bridge_setup(), queue_exec(), receive_ademco_event(), refer_blind_callback(), report_receive_fax_status(), report_send_fax_status(), retrydial_exec(), run_agi(), sayunixtime_exec(), sendtext_exec(), set_from_header(), set_touch_variable(), set_transfer_variables_all(), setup_mixmonitor(), setup_park_common_datastore(), sla_trunk_exec(), speech_background(), transfer_refer(), try_calling(), variable_exists_read(), and wait_for_answer().

pbx_builtin_pushvar_helper()

void pbx_builtin_pushvar_helper	(	struct ast_channel *	chan,
		const char *	name,
		const char *	value
	)

Add a variable to the channel variable stack, without removing any previously set value.

Note

Will lock the channel.

Definition at line 1200 of file pbx_variables.c.

{
    struct ast_var_t *newvariable;
    struct varshead *headp;
 
    if (name[strlen(name)-1] == ')') {
        char *function = ast_strdupa(name);
 
        ast_log(LOG_WARNING, "Cannot push a value onto a function\n");
        ast_func_write(chan, function, value);
        return;
    }
 
    if (chan) {
        ast_channel_lock(chan);
        headp = ast_channel_varshead(chan);
    } else {
        ast_rwlock_wrlock(&globalslock);
        headp = &globals;
    }
 
    if (value && (newvariable = ast_var_assign(name, value))) {
        if (headp == &globals)
            ast_verb(2, "Setting global variable '%s' to '%s'\n", name, value);
        AST_LIST_INSERT_HEAD(headp, newvariable, entries);
    }
 
    if (chan)
        ast_channel_unlock(chan);
    else
        ast_rwlock_unlock(&globalslock);
}

References ast_channel_lock, ast_channel_unlock, ast_channel_varshead(), ast_func_write(), AST_LIST_INSERT_HEAD, ast_log, ast_rwlock_unlock, ast_rwlock_wrlock, ast_strdupa, ast_var_assign, ast_verb, globals, globalslock, LOG_WARNING, name, and value.

Referenced by acf_odbc_read(), acf_odbc_write(), cli_odbc_read(), cli_odbc_write(), and frame_set_var().

pbx_builtin_raise_exception()

int pbx_builtin_raise_exception	(	struct ast_channel *	chan,
		const char *	data
	)

Definition at line 810 of file pbx_builtins.c.

{
    /* Priority will become 1, next time through the AUTOLOOP */
    return raise_exception(chan, reason, 0);
}

References raise_exception().

pbx_builtin_serialize_variables()

int pbx_builtin_serialize_variables	(	struct ast_channel *	chan,
		struct ast_str **	buf
	)

Create a human-readable string, specifying all variables and their corresponding values.

Parameters

chan	Channel from which to read variables
buf	Dynamic string in which to place the result (should be allocated with ast_str_create).

See also

ast_str_create

Note

Will lock the channel.

Definition at line 1131 of file pbx_variables.c.

{
    struct ast_var_t *variables;
    const char *var, *val;
    int total = 0;
 
    if (!chan)
        return 0;
 
    ast_str_reset(*buf);
 
    ast_channel_lock(chan);
 
    AST_LIST_TRAVERSE(ast_channel_varshead(chan), variables, entries) {
        if ((var = ast_var_name(variables)) && (val = ast_var_value(variables))
           /* && !ast_strlen_zero(var) && !ast_strlen_zero(val) */
           ) {
            if (ast_str_append(buf, 0, "%s=%s\n", var, val) < 0) {
                ast_log(LOG_ERROR, "Data Buffer Size Exceeded!\n");
                break;
            } else
                total++;
        } else
            break;
    }
 
    ast_channel_unlock(chan);
 
    return total;
}

References ast_channel_lock, ast_channel_unlock, ast_channel_varshead(), AST_LIST_TRAVERSE, ast_log, ast_str_append(), ast_str_reset(), ast_var_name(), ast_var_value(), buf, ast_var_t::entries, LOG_ERROR, total, and var.

Referenced by ast_var_channels_table(), and dumpchan_exec().

pbx_builtin_setvar()

int pbx_builtin_setvar	(	struct ast_channel *	chan,
		const char *	data
	)

Parse and set a single channel variable, where the name and value are separated with an '=' character.

Note

Will lock the channel.

Definition at line 1291 of file pbx_variables.c.

{
    char *name, *value, *mydata;
 
    if (ast_strlen_zero(data)) {
        ast_log(LOG_WARNING, "Set requires one variable name/value pair.\n");
        return 0;
    }
 
    mydata = ast_strdupa(data);
    name = strsep(&mydata, "=");
    value = mydata;
    if (!value) {
        ast_log(LOG_WARNING, "Set requires an '=' to be a valid assignment.\n");
        return 0;
    }
 
    if (strchr(name, ' ')) {
        ast_log(LOG_WARNING, "Please avoid unnecessary spaces on variables as it may lead to unexpected results ('%s' set to '%s').\n", name, mydata);
    }
 
    pbx_builtin_setvar_helper(chan, name, value);
 
    return 0;
}

References ast_log, ast_strdupa, ast_strlen_zero(), LOG_WARNING, name, pbx_builtin_setvar_helper(), strsep(), and value.

Referenced by ast_compile_ael2(), and load_pbx_variables().

pbx_builtin_setvar_helper()

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.

Note

Will lock the channel. May also be used to set a channel dialplan function to a particular value.

See also

ast_func_write

Returns

-1 if the dialplan function fails to be set

Version

1.8 changed the function to return an error code

True if the old value was not an empty string.

Definition at line 1233 of file pbx_variables.c.

{
    struct ast_var_t *newvariable;
    struct varshead *headp;
    const char *nametail = name;
    /*! True if the old value was not an empty string. */
    int old_value_existed = 0;
 
    if (name[strlen(name) - 1] == ')') {
        char *function = ast_strdupa(name);
 
        return ast_func_write(chan, function, value);
    }
 
    if (chan) {
        ast_channel_lock(chan);
        headp = ast_channel_varshead(chan);
    } else {
        ast_rwlock_wrlock(&globalslock);
        headp = &globals;
    }
 
    /* For comparison purposes, we have to strip leading underscores */
    if (*nametail == '_') {
        nametail++;
        if (*nametail == '_')
            nametail++;
    }
 
    AST_LIST_TRAVERSE_SAFE_BEGIN(headp, newvariable, entries) {
        if (strcmp(ast_var_name(newvariable), nametail) == 0) {
            /* there is already such a variable, delete it */
            AST_LIST_REMOVE_CURRENT(entries);
            old_value_existed = !ast_strlen_zero(ast_var_value(newvariable));
            ast_var_delete(newvariable);
            break;
        }
    }
    AST_LIST_TRAVERSE_SAFE_END;
 
    if (value && (newvariable = ast_var_assign(name, value))) {
        if (headp == &globals) {
            ast_verb(2, "Setting global variable '%s' to '%s'\n", name, value);
        }
        AST_LIST_INSERT_HEAD(headp, newvariable, entries);
        ast_channel_publish_varset(chan, name, value);
    } else if (old_value_existed) {
        /* We just deleted a non-empty dialplan variable. */
        ast_channel_publish_varset(chan, name, "");
    }
 
    if (chan)
        ast_channel_unlock(chan);
    else
        ast_rwlock_unlock(&globalslock);
    return 0;
}

References ast_channel_lock, ast_channel_publish_varset(), ast_channel_unlock, ast_channel_varshead(), ast_func_write(), AST_LIST_INSERT_HEAD, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, ast_rwlock_unlock, ast_rwlock_wrlock, ast_strdupa, ast_strlen_zero(), ast_var_assign, ast_var_delete(), ast_var_name(), ast_var_value(), ast_verb, globals, globalslock, name, and value.

Referenced by __analog_ss_thread(), __ast_pbx_run(), _while_exec(), acf_curl_helper(), acf_fetch(), acf_odbc_read(), acf_odbc_write(), acf_transaction_write(), action_atxfer(), action_kick_last(), action_setvar(), admin_exec(), agent_login_exec(), agent_request_exec(), agi_exec_full(), analog_ss_thread(), app_control_set_channel_var(), app_exec(), aqm_exec(), array(), ast_ari_asterisk_set_global_var(), ast_bridge_set_transfer_variables(), ast_bridge_vars_set(), ast_call_forward(), ast_cc_agent_set_interfaces_chanvar(), ast_eivr_setvariable(), ast_iax2_new(), ast_pbx_outgoing_exten_predial(), ast_pickup_call(), ast_rtp_instance_set_stats_vars(), ast_set_cc_interfaces_chanvar(), ast_set_variables(), AST_TEST_DEFINE(), ast_unreal_hangup(), asyncgoto_exec(), attended_transfer_bridge(), attended_transfer_exec(), audiosocket_request(), background_detect_exec(), begin_dial_channel(), blind_transfer_bridge(), blind_transfer_exec(), bridge_channel_internal_push_full(), bridge_exec(), bridgeadd_exec(), calendar_write_exec(), caller_joined_bridge(), caller_safety_timeout(), cccancel_exec(), ccreq_exec(), chan_pjsip_cng_tone_detected(), chan_pjsip_new(), chanavail_exec(), channel_spy(), check_bridge_play_sound(), clear_agent_status(), commit_exec(), conf_run(), confbridge_exec(), confkick_exec(), controlplayback_exec(), count_exec(), crement_function_read(), dahdi_handle_dtmf(), dahdi_new(), delete_write(), dial_exec_full(), dial_transfer(), directory_exec(), disa_exec(), do_directory(), do_forward(), do_notify(), do_waiting(), dtmf_store_framehook(), dynamic_dtmf_hook_callback(), end_bridge_callback(), execute_menu_entry(), fax_detect_framehook(), frame_set_var(), func_export_write(), func_mchan_write(), function_db_delete(), function_db_exists(), function_db_read(), function_realtime_store(), generic_recall(), geoloc_profile_read(), geoloc_profile_write(), global_delete_write(), global_write(), gosub_release_frame(), gosub_run(), handle_controlstreamfile(), handle_gosub(), handle_incoming_request(), handle_outgoing_response(), handle_response_cmgr(), handle_set_chanvar(), handle_set_global(), handle_setvariable(), handle_streamfile(), hash_read(), hash_write(), if_helper(), isAnsweringMachine(), kick_conference_participant(), launch_monitor_thread(), leave_marked(), leave_queue(), leave_voicemail(), lua_set_variable(), lua_set_variable_value(), manager_park(), mbl_status_exec(), minivm_accmess_exec(), minivm_delete_exec(), minivm_greet_exec(), minivm_notify_exec(), minivm_record_exec(), mixmonitor_exec(), msg_send_exec(), my_get_callerid(), my_handle_dtmf(), onModeChanged(), ooh323_new(), ooh323_rtp_read(), originate_exec(), parking_duration_callback(), parking_timeout_set_caller_features(), pbx_builtin_background(), pbx_builtin_gotoiftime(), pbx_builtin_setvar(), pbx_builtin_setvar_multiple(), pbx_builtin_waitdigit(), pbx_load_config(), play_message_datetime(), playback_exec(), pqm_exec(), prep_email_sub_vars(), privacy_exec(), queue_exec(), read_exec(), read_mf_digits(), read_mf_exec(), read_sf_digits(), read_sf_exec(), readexten_exec(), realtimefield_read(), receivefax_exec(), record_abandoned(), record_exec(), recvtext_exec(), refer_blind_callback(), reload_exec(), reload_module(), return_exec(), ring_entry(), rollback_exec(), rotate_file(), rqm_exec(), scan_exec(), select_entry(), select_item_menu(), select_item_seq(), sendfax_exec(), sendtext_exec(), set(), set_channel_variables(), set_duration_var(), set_queue_result(), set_sipdomain_variable(), shift_pop(), signal_exec(), sla_calc_trunk_timeouts(), sla_station_exec(), sla_trunk_exec(), speech_create(), start_automixmonitor(), system_exec_helper(), test_chan_variable(), testtime_write(), transfer_exec(), tryexec_exec(), unicast_rtp_request(), unshift_push(), update_qe_rule(), upqm_exec(), user_timeout(), vm_exec(), vm_playmsgexec(), vmauthenticate(), wait_exec(), wait_for_answer(), wait_for_signal_or_hangup(), waitforcond_exec(), waitsignal_exec(), waituntil_exec(), and zapateller_exec().

pbx_builtin_setvar_multiple()

int pbx_builtin_setvar_multiple	(	struct ast_channel *	chan,
		const char *	data
	)

Parse and set multiple channel variables, where the pairs are separated by the ',' character, and name and value are separated with an '=' character.

Note

Will lock the channel.

Definition at line 1317 of file pbx_variables.c.

{
    char *data;
    int x;
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(pair)[99]; /* parse up to 99 variables */
    );
    AST_DECLARE_APP_ARGS(pair,
        AST_APP_ARG(name);
        AST_APP_ARG(value);
    );
 
    if (ast_strlen_zero(vdata)) {
        ast_log(LOG_WARNING, "MSet requires at least one variable name/value pair.\n");
        return 0;
    }
 
    data = ast_strdupa(vdata);
    AST_STANDARD_APP_ARGS(args, data);
 
    for (x = 0; x < args.argc; x++) {
        AST_NONSTANDARD_APP_ARGS(pair, args.pair[x], '=');
        if (pair.argc == 2) {
            pbx_builtin_setvar_helper(chan, pair.name, pair.value);
            if (strchr(pair.name, ' '))
                ast_log(LOG_WARNING, "Please avoid unnecessary spaces on variables as it may lead to unexpected results ('%s' set to '%s').\n", pair.name, pair.value);
        } else if (!chan) {
            ast_log(LOG_WARNING, "MSet: ignoring entry '%s' with no '='\n", pair.name);
        } else {
            ast_log(LOG_WARNING, "MSet: ignoring entry '%s' with no '=' (in %s@%s:%d\n", pair.name, ast_channel_exten(chan), ast_channel_context(chan), ast_channel_priority(chan));
        }
    }
 
    return 0;
}

References args, AST_APP_ARG, ast_channel_context(), ast_channel_exten(), ast_channel_priority(), AST_DECLARE_APP_ARGS, ast_log, AST_NONSTANDARD_APP_ARGS, AST_STANDARD_APP_ARGS, ast_strdupa, ast_strlen_zero(), LOG_WARNING, name, pair::name, pbx_builtin_setvar_helper(), and value.

Referenced by load_pbx_variables(), queue_function_var(), set_queue_variables(), and try_calling().

pbx_checkcondition()

int pbx_checkcondition

(

const char *

condition

)

Evaluate a condition.

Return values

0	if the condition is NULL or of zero length
int	If the string is an integer, the integer representation of the integer is returned
1	Any other non-empty string

Definition at line 8307 of file pbx.c.

{
    int res;
    if (ast_strlen_zero(condition)) {                /* NULL or empty strings are false */
        return 0;
    } else if (sscanf(condition, "%30d", &res) == 1) { /* Numbers are evaluated for truth */
        return res;
    } else {                                         /* Strings are true */
        return 1;
    }
}

References ast_strlen_zero().

Referenced by _while_exec(), acf_if(), execif_exec(), gosubif_exec(), if_helper(), pbx_builtin_gotoif(), testtime_write(), and waitforcond_exec().

pbx_exec()

int pbx_exec	(	struct ast_channel *	c,
		struct ast_app *	app,
		const char *	data
	)

Execute an application.

Parameters

c	channel to execute on
app	which app to execute
data	the data passed into the app

This application executes an application on a given channel. It saves the stack and executes the given application passing in the given data.

Return values

0	success
-1	failure

Note

This function is special. It saves the stack so that no matter how many times it is called, it returns to the same place

Parameters

c	Channel
app	Application
data	Data for execution

Definition at line 471 of file pbx_app.c.

{
    int res;
    struct ast_module_user *u = NULL;
    const char *saved_c_appl;
    const char *saved_c_data;
 
    /* save channel values */
    saved_c_appl= ast_channel_appl(c);
    saved_c_data= ast_channel_data(c);
 
    ast_channel_lock(c);
    ast_channel_appl_set(c, app->name);
    ast_channel_data_set(c, data);
    ast_channel_publish_snapshot(c);
    ast_channel_unlock(c);
 
    if (app->module)
        u = __ast_module_user_add(app->module, c);
    res = app->execute(c, S_OR(data, ""));
    if (app->module && u)
        __ast_module_user_remove(app->module, u);
    /* restore channel values */
    ast_channel_appl_set(c, saved_c_appl);
    ast_channel_data_set(c, saved_c_data);
    return res;
}

References __ast_module_user_add(), __ast_module_user_remove(), app, ast_channel_appl(), ast_channel_appl_set(), ast_channel_data(), ast_channel_data_set(), ast_channel_lock, ast_channel_publish_snapshot(), ast_channel_unlock, c, NULL, and S_OR.

Referenced by aelsub_exec(), ari_channel_thread(), ari_originate_dial(), ast_pbx_exec_application(), AST_TEST_DEFINE(), bridge_stasis_run_cb(), conf_run(), conf_start_record(), exec_exec(), execif_exec(), forward_message(), handle_exec(), iax2_exec(), lua_pbx_exec(), page_exec(), pbx_extension_helper(), pbx_outgoing_exec(), realtime_exec(), try_calling(), and tryexec_exec().

pbx_find_extension()

static struct ast_exten * pbx_find_extension	(	struct ast_channel *	chan,
		struct ast_context *	bypass,
		struct pbx_find_info *	q,
		const char *	context,
		const char *	exten,
		int	priority,
		const char *	label,
		const char *	callerid,
		enum ext_match_t	action
	)

Definition at line 152 of file ael_main.c.

{
    return localized_find_extension(bypass, q, context, exten, priority, label, callerid, action);
}

References ast_autoservice_start(), ast_autoservice_stop(), ast_context_includes_count(), ast_context_includes_get(), ast_context_switches_count(), ast_context_switches_get(), ast_debug, ast_get_switch_data(), ast_get_switch_eval(), ast_get_switch_name(), ast_hashtab_lookup(), ast_log, AST_PBX_MAX_STACK, ast_str_buffer(), ast_str_size(), ast_str_thread_get(), ast_strdupa, ast_strlen_zero(), ast_walk_context_extensions(), ast_switch::canmatch, scoreboard::canmatch_exten, voicemailpwcheck::context, create_match_char_tree(), pbx_find_info::data, ast_context::data, E_CANMATCH, E_FINDLABEL, E_MATCHMORE, ast_switch::exists, ast_exten::exten, scoreboard::exten, extenpatternmatchnew, extension_match_core(), find_context(), pbx_find_info::foundcontext, include_rname(), include_valid(), pbx_find_info::incstack, ast_exten::label, scoreboard::last_char, localized_find_extension(), LOG_NOTICE, LOG_WARNING, match(), matchcid(), ast_switch::matchmore, name, new_find_extension(), scoreboard::node, NULL, overrideswitch, ast_context::pattern_tree, pbx_find_extension(), pbx_findswitch(), pbx_substitute_variables_helper(), priority, ast_exten::priority, ast_context::root_table, pbx_find_info::stacklen, pbx_find_info::status, STATUS_NO_CONTEXT, STATUS_NO_EXTENSION, STATUS_NO_LABEL, STATUS_NO_PRIORITY, STATUS_SUCCESS, strsep(), switch_data, pbx_find_info::swo, scoreboard::total_length, scoreboard::total_specificity, and trie_find_next_match().

Referenced by add_extension(), ast_get_extension_data(), ast_hint_extension_nolock(), ast_merge_contexts_and_delete(), ast_sip_persistent_endpoint_update_state(), check_goto(), check_pval_item(), conf_ended(), delete_extens(), parking_blind_transfer_park(), parking_duration_callback(), parking_is_exten_park(), parking_lot_cfg_create_extensions(), pbx_extension_helper(), pbx_find_extension(), and test_exten().

pbx_findapp()

struct ast_app * pbx_findapp

(

const char *

app

)

Look up an application.

Parameters

app	name of the app

This function searches for the ast_app structure within the apps that are registered for the one with the name you passed in.

Returns

the ast_app structure that matches on success, or NULL on failure

Definition at line 165 of file ael_main.c.

{
    return (struct ast_app*)1; /* so as not to trigger an error */
}

References app, AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, and pbx_findapp_nolock().

Referenced by aelsub_exec(), ari_channel_thread(), ari_originate_dial(), ast_pbx_exec_application(), AST_TEST_DEFINE(), bridge_stasis_run_cb(), conf_run(), conf_start_record(), exec_exec(), execif_exec(), forward_message(), handle_exec(), iax2_exec(), lua_pbx_exec(), page_exec(), pbx_extension_helper(), pbx_outgoing_exec(), realtime_exec(), try_calling(), and tryexec_exec().

pbx_live_dangerously()

void pbx_live_dangerously

(

int

new_live_dangerously

)

Enable/disable the execution of 'dangerous' functions from external protocols (AMI, etc.).

These dialplan functions (such as SHELL) provide an opportunity for privilege escalation. They are okay to invoke from the dialplan, but external protocols with permission controls should not normally invoke them.

This function can globally enable/disable the execution of dangerous functions from external protocols.

Parameters

new_live_dangerously

If true, enable the execution of escalating functions from external protocols.

Definition at line 465 of file pbx_functions.c.

{
    if (new_live_dangerously && !live_dangerously) {
        ast_log(LOG_WARNING, "Privilege escalation protection disabled!\n"
            "See https://docs.asterisk.org/Configuration/Dialplan/Privilege-Escalations-with-Dialplan-Functions/ for more details.\n");
    }
 
    if (!new_live_dangerously && live_dangerously) {
        ast_log(LOG_NOTICE, "Privilege escalation protection enabled.\n");
    }
    live_dangerously = new_live_dangerously;
}

References ast_log, live_dangerously, LOG_NOTICE, and LOG_WARNING.

Referenced by load_asterisk_conf().

pbx_parse_location()

int pbx_parse_location	(	struct ast_channel *	chan,
		char **	context,
		char **	exten,
		char **	pri,
		int *	ipri,
		int *	mode,
		char *	rest
	)

Parses a dialplan location into context, extension, priority.

Parameters

chan	Channel to execute on
context	Pointer to initial value for context.
exten	Pointer to initial value for exten.
pri	Pointer to initial value for pri
ipri	Pointer to integer value of priority
mode	Pointer to mode (or NULL if mode is not used)
rest	Pointer to buffer to capture rest of parsing (or NULL if not used)

strsep should be used to initially populate context, exten, and pri prior to calling this function. All arguments are modified in place.

Return values

0	success
non-zero	failure

Definition at line 8816 of file pbx.c.

{
    char *context, *exten, *pri;
    /* do the strsep before here, so we don't have to alloc and free */
    if (!*extenp) {
        /* Only a priority in this one */
        *prip = *contextp;
        *extenp = NULL;
        *contextp = NULL;
    } else if (!*prip) {
        /* Only an extension and priority in this one */
        *prip = *extenp;
        *extenp = *contextp;
        *contextp = NULL;
    }
    context = *contextp;
    exten = *extenp;
    pri = *prip;
    if (mode) {
        if (*pri == '+') {
            *mode = 1;
            pri++;
        } else if (*pri == '-') {
            *mode = -1;
            pri++;
        }
    }
    if ((rest && sscanf(pri, "%30d%1s", ipri, rest) != 1) || sscanf(pri, "%30d", ipri) != 1) {
        *ipri = ast_findlabel_extension(chan, context ? context : ast_channel_context(chan),
            exten ? exten : ast_channel_exten(chan), pri,
            S_COR(ast_channel_caller(chan)->id.number.valid, ast_channel_caller(chan)->id.number.str, NULL));
        if (*ipri < 1) {
            ast_log(LOG_WARNING, "Priority '%s' must be a number > 0, or valid label\n", pri);
            return -1;
        } else if (mode) {
            *mode = 0;
        }
    }
    return 0;
}

References ast_channel_caller(), ast_channel_context(), ast_channel_exten(), ast_findlabel_extension(), ast_log, voicemailpwcheck::context, ast_channel::exten, LOG_WARNING, NULL, and S_COR.

Referenced by eval_exten_read(), and pbx_parseable_goto().

pbx_retrieve_variable()

void pbx_retrieve_variable	(	struct ast_channel *	c,
		const char *	var,
		char **	ret,
		char *	workspace,
		int	workspacelen,
		struct varshead *	headp
	)

Retrieve the value of a builtin variable or variable from the channel variable stack.

Note

Will lock the channel.

Retrieve the value of a builtin variable or variable from the channel variable stack.

Note

See also

• Globally predefined channel variables Channel variables
• Hangup Causes for Asterisk The HANGUPCAUSE variable

Definition at line 246 of file pbx_variables.c.

{
    struct ast_str *str = ast_str_create(16);
    const char *cret;
 
    cret = ast_str_retrieve_variable(&str, 0, c, headp, var);
    ast_copy_string(workspace, ast_str_buffer(str), workspacelen);
    *ret = cret ? workspace : NULL;
    ast_free(str);
}

References ast_copy_string(), ast_free, ast_str_buffer(), ast_str_create, ast_str_retrieve_variable(), c, NULL, str, and var.

Referenced by action_getvar(), generate_status(), handle_getvariable(), lua_get_variable(), lua_get_variable_value(), and pbx_substitute_variables_helper_full_location().

pbx_set_autofallthrough()

int pbx_set_autofallthrough

(

int

newval

)

Set "autofallthrough" flag, if newval is <0, does not actually set. If set to 1, sets to auto fall through. If newval set to 0, sets to no auto fall through (reads extension instead). Returns previous value.

Definition at line 4791 of file pbx.c.

{
    int oldval = autofallthrough;
    autofallthrough = newval;
    return oldval;
}

References autofallthrough.

Referenced by pbx_load_module().

pbx_set_extenpatternmatchnew()

int pbx_set_extenpatternmatchnew

(

int

newval

)

Set "extenpatternmatchnew" flag, if newval is <0, does not actually set. If set to 1, sets to use the new Trie-based pattern matcher. If newval set to 0, sets to use the old linear-search algorithm. Returns previous value.

Definition at line 4798 of file pbx.c.

{
    int oldval = extenpatternmatchnew;
    extenpatternmatchnew = newval;
    return oldval;
}

References extenpatternmatchnew.

Referenced by AST_TEST_DEFINE(), handle_set_extenpatternmatchnew(), handle_unset_extenpatternmatchnew(), and pbx_load_module().

pbx_set_overrideswitch()

void pbx_set_overrideswitch

(

const char *

newval

)

Set "overrideswitch" field. If set and of nonzero length, all contexts will be tried directly through the named switch prior to any other matching within that context.

Since

1.6.1

Definition at line 4805 of file pbx.c.

{
    if (overrideswitch) {
        ast_free(overrideswitch);
    }
    if (!ast_strlen_zero(newval)) {
        overrideswitch = ast_strdup(newval);
    } else {
        overrideswitch = NULL;
    }
}

References ast_free, ast_strdup, ast_strlen_zero(), NULL, and overrideswitch.

Referenced by pbx_load_module().

pbx_substitute_variables_helper()

static void pbx_substitute_variables_helper	(	struct ast_channel *	c,
		const char *	cp1,
		char *	cp2,
		int	count
	)

Definition at line 211 of file ael_main.c.

{
    if (cp1 && *cp1)
        strncpy(cp2,cp1,AST_MAX_EXTENSION); /* Right now, this routine is ONLY being called for
                                               a possible var substitution on extension names,
                                               so....! */
    else
        *cp2 = 0;
}

References ast_channel_varshead(), AST_MAX_EXTENSION, c, NULL, and pbx_substitute_variables_helper_full().

Referenced by add_extensions(), ast_add_extension2_lockopt(), dtmf_store_framehook(), escape_and_substitute(), function_eval(), get_mapping_weight(), handle_eval_function(), import_helper(), launch_monitor_thread(), manager_log(), pbx_extension_helper(), pbx_find_extension(), pbx_load_config(), realtime_exec(), rotate_file(), substituted(), test_chan_function(), test_chan_integer(), test_chan_integer_accessor(), test_chan_string(), test_chan_variable(), waitforcond_exec(), write_cdr(), and write_cel().

pbx_substitute_variables_helper_full()

void pbx_substitute_variables_helper_full	(	struct ast_channel *	c,
		struct varshead *	headp,
		const char *	cp1,
		char *	cp2,
		int	cp2_size,
		size_t *	used
	)

Definition at line 667 of file pbx_variables.c.

{
    pbx_substitute_variables_helper_full_location(c, headp, cp1, cp2, count, used, NULL, NULL, 0);
}

References c, NULL, and pbx_substitute_variables_helper_full_location().

Referenced by pbx_substitute_variables_helper(), and pbx_substitute_variables_varshead().

pbx_substitute_variables_helper_full_location()

void pbx_substitute_variables_helper_full_location	(	struct ast_channel *	c,
		struct varshead *	headp,
		const char *	cp1,
		char *	cp2,
		int	cp2_size,
		size_t *	used,
		const char *	context,
		const char *	exten,
		int	pri
	)

Substitutes variables, similar to pbx_substitute_variables_helper_full, but allows passing the context, extension, and priority in.

Definition at line 677 of file pbx_variables.c.

{
    /* Substitutes variables into cp2, based on string cp1, cp2 NO LONGER NEEDS TO BE ZEROED OUT!!!!  */
    const char *whereweare;
    const char *orig_cp2 = cp2;
    char ltmp[VAR_BUF_SIZE];
    char var[VAR_BUF_SIZE];
    int *recurse_depth;
 
    *cp2 = 0; /* just in case nothing ends up there */
 
    /* It is possible to craft dialplan that will recurse indefinitely and cause a stack overflow.
     * This is symptomatic of a dialplan bug, so abort substitution rather than crash. */
    recurse_depth = ast_threadstorage_get(&varsub_recurse_level, sizeof(*recurse_depth));
    if (!recurse_depth) {
        return;
    }
    if ((*recurse_depth)++ >= MAX_VARIABLE_SUB_RECURSE_DEPTH) {
        ast_log(LOG_ERROR, "Exceeded maximum variable substitution recursion depth (%d) - possible infinite recursion in dialplan?\n", MAX_VARIABLE_SUB_RECURSE_DEPTH);
        (*recurse_depth)--;
        return;
    }
 
    whereweare = cp1;
    while (!ast_strlen_zero(whereweare) && count) {
        char *nextvar = NULL;
        char *nextexp = NULL;
        char *nextthing;
        char *vars;
        char *vare;
        int length;
        int pos;
        int brackets;
        int needsub;
        int len;
 
        /* Determine how much simply needs to be copied to the output buf. */
        nextthing = strchr(whereweare, '$');
        if (nextthing) {
            pos = nextthing - whereweare;
            switch (nextthing[1]) {
            case '{':
                /* Variable substitution */
                nextvar = nextthing;
                break;
            case '[':
                /* Expression substitution */
                nextexp = nextthing;
                break;
            default:
                /* '$' is not part of a substitution so include it too. */
                ++pos;
                break;
            }
        } else {
            /* We're copying the whole remaining string */
            pos = strlen(whereweare);
        }
 
        if (pos) {
            /* Can't copy more than 'count' bytes */
            if (pos > count)
                pos = count;
 
            /* Copy that many bytes */
            memcpy(cp2, whereweare, pos);
 
            count -= pos;
            cp2 += pos;
            whereweare += pos;
            *cp2 = 0;
        }
 
        if (nextvar) {
            int offset;
            int offset2;
            int isfunction;
            char *cp4 = NULL;
            char workspace[VAR_BUF_SIZE] = "";
 
            /* We have a variable.  Find the start and end, and determine
               if we are going to have to recursively call ourselves on the
               contents */
            vars = vare = nextvar + 2;
            brackets = 1;
            needsub = 0;
 
            /* Find the end of it */
            while (brackets && *vare) {
                if ((vare[0] == '$') && (vare[1] == '{')) {
                    needsub++;
                    brackets++;
                    vare++;
                } else if (vare[0] == '{') {
                    brackets++;
                } else if (vare[0] == '}') {
                    brackets--;
                } else if ((vare[0] == '$') && (vare[1] == '[')) {
                    needsub++;
                    vare++;
                }
                vare++;
            }
            len = vare - vars;
            if (brackets) {
                ast_log(LOG_WARNING, "Error in extension logic (missing '}')\n");
            } else {
                /* Don't count the closing '}' in the length. */
                --len;
            }
 
            /* Skip totally over variable string */
            whereweare = vare;
 
            /* Store variable name expression to lookup (and truncate). */
            ast_copy_string(var, vars, len + 1);
 
            /* Substitute if necessary */
            if (needsub) {
                pbx_substitute_variables_helper_full_location(c, headp, var, ltmp, VAR_BUF_SIZE - 1, NULL, context, exten, pri);
                vars = ltmp;
            } else {
                vars = var;
            }
 
            parse_variable_name(vars, &offset, &offset2, &isfunction);
            if (isfunction) {
                /* Evaluate function */
                if (c || !headp)
                    cp4 = ast_func_read(c, vars, workspace, VAR_BUF_SIZE) ? NULL : workspace;
                else {
                    struct varshead old;
                    struct ast_channel *bogus;
 
                    bogus = ast_dummy_channel_alloc();
                    if (bogus) {
                        old = *ast_channel_varshead(bogus);
                        *ast_channel_varshead(bogus) = *headp;
                        cp4 = ast_func_read(bogus, vars, workspace, VAR_BUF_SIZE) ? NULL : workspace;
                        /* Don't deallocate the varshead that was passed in */
                        *ast_channel_varshead(bogus) = old;
                        ast_channel_unref(bogus);
                    } else {
                        ast_log(LOG_ERROR, "Unable to allocate bogus channel for function value substitution.\n");
                        cp4 = NULL;
                    }
                }
                ast_debug(2, "Function %s result is '%s'\n", vars, cp4 ? cp4 : "(null)");
            } else {
                /* Retrieve variable value */
                /* For dialplan location, if we were told what to substitute explicitly, use that instead */
                if (exten && !strcmp(vars, "EXTEN")) {
                    ast_copy_string(workspace, exten, VAR_BUF_SIZE);
                    cp4 = workspace;
                } else if (context && !strcmp(vars, "CONTEXT")) {
                    ast_copy_string(workspace, context, VAR_BUF_SIZE);
                    cp4 = workspace;
                } else if (pri && !strcmp(vars, "PRIORITY")) {
                    snprintf(workspace, VAR_BUF_SIZE, "%d", pri);
                    cp4 = workspace;
                } else {
                    pbx_retrieve_variable(c, vars, &cp4, workspace, VAR_BUF_SIZE, headp);
                }
            }
            if (cp4) {
                cp4 = substring(cp4, offset, offset2, workspace, VAR_BUF_SIZE);
 
                length = strlen(cp4);
                if (length > count)
                    length = count;
                memcpy(cp2, cp4, length);
                count -= length;
                cp2 += length;
                *cp2 = 0;
            }
        } else if (nextexp) {
            /* We have an expression.  Find the start and end, and determine
               if we are going to have to recursively call ourselves on the
               contents */
            vars = vare = nextexp + 2;
            brackets = 1;
            needsub = 0;
 
            /* Find the end of it */
            while (brackets && *vare) {
                if ((vare[0] == '$') && (vare[1] == '[')) {
                    needsub++;
                    brackets++;
                    vare++;
                } else if (vare[0] == '[') {
                    brackets++;
                } else if (vare[0] == ']') {
                    brackets--;
                } else if ((vare[0] == '$') && (vare[1] == '{')) {
                    needsub++;
                    vare++;
                }
                vare++;
            }
            len = vare - vars;
            if (brackets) {
                ast_log(LOG_WARNING, "Error in extension logic (missing ']')\n");
            } else {
                /* Don't count the closing ']' in the length. */
                --len;
            }
 
            /* Skip totally over expression */
            whereweare = vare;
 
            /* Store expression to evaluate (and truncate). */
            ast_copy_string(var, vars, len + 1);
 
            /* Substitute if necessary */
            if (needsub) {
                pbx_substitute_variables_helper_full_location(c, headp, var, ltmp, VAR_BUF_SIZE - 1, NULL, context, exten, pri);
                vars = ltmp;
            } else {
                vars = var;
            }
 
            length = ast_expr(vars, cp2, count, c);
            if (length) {
                ast_debug(1, "Expression result is '%s'\n", cp2);
                count -= length;
                cp2 += length;
                *cp2 = 0;
            }
        }
    }
    if (used) {
        *used = cp2 - orig_cp2;
    }
    (*recurse_depth)--;
}

References ast_channel_unref, ast_channel_varshead(), ast_copy_string(), ast_debug, ast_dummy_channel_alloc, ast_expr(), ast_func_read(), ast_log, ast_strlen_zero(), ast_threadstorage_get(), c, voicemailpwcheck::context, ast_channel::exten, len(), LOG_ERROR, LOG_WARNING, MAX_VARIABLE_SUB_RECURSE_DEPTH, NULL, parse_variable_name(), pbx_retrieve_variable(), pbx_substitute_variables_helper_full_location(), substring(), var, VAR_BUF_SIZE, and varsub_recurse_level.

Referenced by eval_exten_read(), pbx_substitute_variables_helper_full(), and pbx_substitute_variables_helper_full_location().

pbx_substitute_variables_varshead()

void pbx_substitute_variables_varshead	(	struct varshead *	headp,
		const char *	cp1,
		char *	cp2,
		int	count
	)

Definition at line 918 of file pbx_variables.c.

{
    pbx_substitute_variables_helper_full(NULL, headp, cp1, cp2, count, NULL);
}

References NULL, and pbx_substitute_variables_helper_full().

Referenced by do_say(), dundi_lookup_local(), get_mapping_weight(), and loopback_subst().